@wildo-ai/framework-knowledge 1.1.4 → 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 (848) 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 +227 -6
  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/framework-knowledge.schemas.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  11. package/dist/esm/index.d.ts.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  13. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  17. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  19. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  38. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  39. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  40. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  41. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  43. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  45. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  47. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  48. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  49. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  51. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  53. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  55. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  57. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  58. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  59. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  60. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  62. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  67. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  68. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  70. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  74. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  78. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  79. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  81. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  82. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  83. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  85. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  87. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  88. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  89. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  90. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  91. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  93. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  95. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  97. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  99. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  101. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  103. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  105. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  107. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  109. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  110. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  111. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  113. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  115. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  117. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  119. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  121. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  122. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  123. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  124. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  125. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  126. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  127. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  128. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  129. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  130. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  131. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  132. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  133. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  134. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  135. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  137. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  138. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  139. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  140. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  141. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  143. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  145. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  147. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  151. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  154. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  161. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  165. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  169. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  171. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  172. package/dist/knowledge/manifest.json +9 -8
  173. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  174. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  175. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  176. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  179. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  180. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  181. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  182. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  183. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  184. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  185. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  186. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  187. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  188. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  189. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  190. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  191. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  192. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  193. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  194. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  195. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  196. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  197. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  198. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  199. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  200. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  201. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  202. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  203. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  204. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  205. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  206. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  207. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  208. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  209. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  210. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  211. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  212. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  214. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  215. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  216. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  217. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  218. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  219. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  220. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  221. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  222. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  223. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  224. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  225. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  226. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  227. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  228. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  229. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  230. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  234. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  235. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  237. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  238. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  239. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  240. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  241. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  242. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  243. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  244. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  245. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  246. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  247. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  248. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  249. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  250. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  251. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  252. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  253. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  254. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  255. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  256. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  257. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  258. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  259. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  260. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  261. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  262. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  263. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  264. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  267. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  268. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  269. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  270. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  272. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  273. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  274. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  275. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  276. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  277. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  278. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  279. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  280. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  281. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  282. package/dist/knowledge/references/application-maturity.config.md +319 -0
  283. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  284. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  285. package/dist/knowledge/references/brand.asset.config.md +8 -16
  286. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  287. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  288. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  289. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  291. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  294. package/dist/knowledge/references/capability-composition.config.md +155 -0
  295. package/dist/knowledge/references/cli.market.utils.md +1 -0
  296. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  297. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  298. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  299. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  300. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  301. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  302. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  303. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  304. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  305. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  306. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  307. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  308. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  309. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  310. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  311. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  312. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  313. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  314. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  315. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  316. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  317. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  318. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  319. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  320. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  321. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  322. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  323. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  324. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  325. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  326. package/dist/knowledge/references/experience-plan.config.md +311 -0
  327. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  328. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  329. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  330. package/dist/knowledge/references/integration-plan.config.md +185 -0
  331. package/dist/knowledge/references/market.alternative.config.md +1 -1
  332. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  333. package/dist/knowledge/references/market.channel.config.md +3 -3
  334. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  335. package/dist/knowledge/references/market.gain.config.md +1 -1
  336. package/dist/knowledge/references/market.icp.config.md +2 -2
  337. package/dist/knowledge/references/market.job.config.md +1 -1
  338. package/dist/knowledge/references/market.message-template.config.md +2 -2
  339. package/dist/knowledge/references/market.objection.config.md +1 -1
  340. package/dist/knowledge/references/market.pain.config.md +1 -1
  341. package/dist/knowledge/references/market.persona.config.md +2 -2
  342. package/dist/knowledge/references/market.proof.config.md +1 -1
  343. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  345. package/dist/knowledge/references/market.trigger.config.md +1 -1
  346. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  347. package/dist/knowledge/references/placement-plan.config.md +369 -0
  348. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  349. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  350. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  351. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  352. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  353. package/dist/knowledge/references/platform.config.saas.md +261 -9
  354. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  355. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  356. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  357. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  358. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  359. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  361. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  362. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  363. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  364. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  365. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  366. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  367. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  368. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  369. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  370. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  371. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  372. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  373. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  374. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  375. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  376. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  377. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  378. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  379. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  380. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  381. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  382. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  384. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  385. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  386. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  387. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  388. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  389. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  390. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  391. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  392. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  393. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  395. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  396. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  397. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  398. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  399. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  400. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  401. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  402. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  403. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  404. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  405. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  406. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  407. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  408. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  409. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  410. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  411. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  412. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  413. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  414. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  415. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  416. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  417. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  418. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  419. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  420. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  421. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  422. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  423. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  425. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  428. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  429. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  430. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  431. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  432. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  433. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  434. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  435. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  436. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  437. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  438. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  439. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  440. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  441. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  442. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  443. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  444. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  445. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  446. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  447. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  448. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  449. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  450. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  451. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  452. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  453. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  458. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  459. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  460. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  461. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  465. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  466. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  469. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  470. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  472. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  473. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  474. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  475. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  476. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  477. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  478. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  479. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  480. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  481. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  482. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  483. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  484. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  485. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  486. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  487. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  488. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  489. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  490. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  491. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  492. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  493. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  494. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  495. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  496. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  497. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  498. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  499. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  500. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  501. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  502. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  503. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  504. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  505. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  506. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  507. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  508. package/dist/knowledge/references/website-plan.config.md +205 -0
  509. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  510. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  511. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  512. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  513. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  514. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  515. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  516. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  517. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  518. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  519. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  520. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  521. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  522. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  523. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  524. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  525. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  526. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  527. package/dist/knowledge/references/zod.factories.address.md +118 -0
  528. package/dist/knowledge/references/zod.factories.code.md +2 -0
  529. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  530. package/dist/knowledge/references/zod.factories.money.md +2 -0
  531. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  532. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  533. package/dist/knowledge/registries/framework-topics.json +1215 -11
  534. package/dist/knowledge/registries/playbooks.json +454 -50
  535. package/dist/knowledge/registries/source-tags.json +3153 -1043
  536. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  537. package/dist/knowledge/rules/live-context-door.md +108 -0
  538. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  539. package/dist/knowledge/skills/INDEX.md +46 -11
  540. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  541. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  542. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  543. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  544. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  545. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  546. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  547. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  548. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  549. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  550. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  551. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  552. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  553. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  554. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  555. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  556. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  557. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  558. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  559. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  560. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  561. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  562. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  563. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  564. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  565. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  566. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  567. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  568. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  569. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  570. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  571. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  572. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  573. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  574. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  575. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  576. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  577. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  578. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  579. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  580. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  581. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  582. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  583. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  584. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  585. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  586. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  589. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  590. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  591. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  592. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  593. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  594. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  595. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  596. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  597. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  598. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  599. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  600. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  601. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  602. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  603. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  604. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  605. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  606. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  607. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  608. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  609. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  610. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  611. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  612. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  613. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  614. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  615. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  616. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  617. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  618. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  619. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  620. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  621. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  622. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  623. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  624. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  625. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  626. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  627. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  628. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  629. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  630. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  631. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  632. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  633. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  634. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  635. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  636. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  637. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  638. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  639. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  640. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  641. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  642. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  643. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  644. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  645. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  646. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  647. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  648. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  649. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  650. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  651. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  652. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  653. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  654. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  655. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  656. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  657. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  658. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  659. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  660. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  661. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  662. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  663. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  664. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  665. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  666. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  667. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  668. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  669. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  670. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  671. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  672. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  673. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  674. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  675. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  676. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  677. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  678. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  679. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  680. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  681. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  682. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  683. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  684. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  685. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  686. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  687. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  688. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  689. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  690. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  691. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  692. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  693. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  694. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  695. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  696. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  697. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  698. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  699. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  700. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  701. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  702. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  703. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  704. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  705. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  706. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  707. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  708. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  709. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  710. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  711. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  712. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  713. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  714. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  715. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  716. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  717. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  718. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  719. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  720. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  721. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  722. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  723. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  724. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  725. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  726. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  727. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  728. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  736. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  737. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  738. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  739. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  740. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  741. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  742. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  743. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  744. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  745. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  746. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  747. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  748. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  749. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  750. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  751. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  752. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  753. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  754. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  755. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  756. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  757. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  758. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  759. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  760. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  762. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  763. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  765. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  766. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  767. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  768. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  769. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  770. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  771. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  772. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  773. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  774. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  775. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  776. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  777. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  778. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  779. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  780. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  781. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  782. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  783. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  784. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  785. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  786. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  787. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  788. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  789. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  790. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  791. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  792. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  793. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  794. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  795. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  796. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  797. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  798. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  799. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  800. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  801. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  802. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  803. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  804. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  805. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  806. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  807. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  808. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  809. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  810. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  811. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  812. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  813. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  814. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  815. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  816. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  817. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  818. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  819. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  820. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  821. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  822. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  823. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  824. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  825. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  826. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  827. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  828. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  829. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  830. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  831. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  832. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  833. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  834. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  835. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  836. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  837. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  838. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  839. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  840. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  841. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  842. package/dist/knowledge/topic-index.json +5335 -1010
  843. package/dist/tsconfig.build.tsbuildinfo +1 -1
  844. package/dist/tsconfig.tsbuildinfo +1 -1
  845. package/package.json +4 -4
  846. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  847. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  848. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -32,7 +32,6 @@ export enum BackingServiceKind {
32
32
  RABBITMQ = 'rabbitmq',
33
33
  S3 = 's3',
34
34
  POSTGRESQL = 'postgresql',
35
- GOTENBERG = 'gotenberg',
36
35
  CLAMAV = 'clamav',
37
36
  /**
38
37
  * immudb — an immutable, cryptographically-verifiable database used as a
@@ -40,11 +39,6 @@ export enum BackingServiceKind {
40
39
  * A stateful DB: a data volume in dev, self-hosted or immudb Vault in prod.
41
40
  */
42
41
  IMMUDB = 'immudb',
43
- /**
44
- * Metrics / telemetry sink (Prometheus, DataDog, OpenTelemetry, …).
45
- * Stateless base for now.
46
- */
47
- METRICS = 'metrics-telemetry',
48
42
  /**
49
43
  * Backup orchestration target. Stateless base for now.
50
44
  */
@@ -190,10 +184,6 @@ export const S3BackingServiceSchema = BackingServiceBaseSchema.extend({
190
184
  }).strict();
191
185
  export type S3BackingService = z.infer<typeof S3BackingServiceSchema>;
192
186
 
193
- /** Gotenberg PDF service. Stateless, no database/vhost/bucket. */
194
- export const GotenbergBackingServiceSchema = BackingServiceBaseSchema;
195
- export type GotenbergBackingService = z.infer<typeof GotenbergBackingServiceSchema>;
196
-
197
187
  /** ClamAV anti-virus daemon. Stateless, no database/vhost/bucket. */
198
188
  export const ClamAvBackingServiceSchema = BackingServiceBaseSchema;
199
189
  export type ClamAvBackingService = z.infer<typeof ClamAvBackingServiceSchema>;
@@ -225,13 +215,6 @@ export const ImmudbBackingServiceSchema = BackingServiceBaseSchema.extend({
225
215
  }).strict();
226
216
  export type ImmudbBackingService = z.infer<typeof ImmudbBackingServiceSchema>;
227
217
 
228
- /**
229
- * Metrics / telemetry sink (Prometheus / DataDog / OpenTelemetry / …).
230
- * Stateless base for now.
231
- */
232
- export const MetricsBackingServiceSchema = BackingServiceBaseSchema;
233
- export type MetricsBackingService = z.infer<typeof MetricsBackingServiceSchema>;
234
-
235
218
  /**
236
219
  * Backup orchestration target. Stateless base for now.
237
220
  */
@@ -251,10 +234,8 @@ export type BackingServiceEnvConfig =
251
234
  | PostgresBackingService
252
235
  | RabbitBackingService
253
236
  | S3BackingService
254
- | GotenbergBackingService
255
237
  | ClamAvBackingService
256
238
  | ImmudbBackingService
257
- | MetricsBackingService
258
239
  | BackupBackingService;
259
240
 
260
241
  /**
@@ -272,11 +253,183 @@ export const BackingServicesEnvConfigSchema = z.object({
272
253
  [BackingServiceKind.RABBITMQ]: RabbitBackingServiceSchema.optional(),
273
254
  [BackingServiceKind.S3]: S3BackingServiceSchema.optional(),
274
255
  [BackingServiceKind.POSTGRESQL]: PostgresBackingServiceSchema.optional(),
275
- [BackingServiceKind.GOTENBERG]: GotenbergBackingServiceSchema.optional(),
276
256
  [BackingServiceKind.CLAMAV]: ClamAvBackingServiceSchema.optional(),
277
257
  [BackingServiceKind.IMMUDB]: ImmudbBackingServiceSchema.optional(),
278
- [BackingServiceKind.METRICS]: MetricsBackingServiceSchema.optional(),
279
258
  [BackingServiceKind.BACKUP]: BackupBackingServiceSchema.optional(),
280
259
  }).strict();
281
260
  export type BackingServicesEnvConfig = z.infer<typeof BackingServicesEnvConfigSchema>;
282
261
  ```
262
+
263
+ ## Which `(kind, source, provider)` combinations actually resolve
264
+
265
+ The dispatch table the note above calls the canonical brand vocabulary, plus what happens to a
266
+ combination it does not cover.
267
+
268
+ ## Import Origins
269
+
270
+ - `@wildo-ai/platform-config-lib`
271
+
272
+ ## Source Excerpts
273
+
274
+ ### Origin Package: `@wildo-ai/platform-config-lib`
275
+
276
+ ```typescript
277
+ /**
278
+ * `BackingServiceKind` → `InfraCapability`. Every extension to `BackingServiceKind` MUST extend this
279
+ * map in the same commit, otherwise the planner cannot project the new kind to its capability slot.
280
+ *
281
+ * INJECTIVE, not bijective — and the difference is a real property of the model rather than a gap.
282
+ * A capability may be granted to a runtime without any environment declaring a backing service for
283
+ * it; see {@link RUNTIME_GRANTED_INFRA_CAPABILITIES} for the ones that are, and why.
284
+ */
285
+ export const BackingServiceKindToInfraCapability: Record<BackingServiceKind, InfraCapability> = {
286
+ [BackingServiceKind.MONGODB]: InfraCapability.DOCUMENT_DATABASE,
287
+ [BackingServiceKind.POSTGRESQL]: InfraCapability.RELATIONAL_DATABASE,
288
+ [BackingServiceKind.RABBITMQ]: InfraCapability.QUEUING_SYSTEM,
289
+ [BackingServiceKind.REDIS]: InfraCapability.CACHE_MANAGER,
290
+ [BackingServiceKind.S3]: InfraCapability.OBJECT_STORAGE,
291
+ [BackingServiceKind.CLAMAV]: InfraCapability.ANTIVIRUS_SCANNING,
292
+ [BackingServiceKind.IMMUDB]: InfraCapability.AUDIT_LOG_STORAGE,
293
+ [BackingServiceKind.BACKUP]: InfraCapability.BACKUP_MANAGER,
294
+ };
295
+
296
+ /**
297
+ * Project `(BackingServiceKind, source, provider?)` → `InfraProvider`.
298
+ *
299
+ * The three-axis dispatch (kind × hosting-model × brand) generalizes
300
+ * the source/brand split across all kinds (Slice 4.B.0, 2026-05-07
301
+ * — was source-only with Atlas as a special source value before).
302
+ *
303
+ * **Brand vocabulary** per kind (`provider` field on the authored
304
+ * `BackingService<X>Schema`):
305
+ *
306
+ * | Kind | source | provider | InfraProvider |
307
+ * |---|---|---|---|
308
+ * | `MONGODB` | `SELF` | (any) | `MONGODB_SELF` |
309
+ * | `MONGODB` | `MANAGED` | `'atlas'` | `MONGODB_ATLAS` |
310
+ * | `POSTGRESQL` | `SELF` | (any) | `POSTGRES_SELF` |
311
+ * | `POSTGRESQL` | `MANAGED` | `'aws-rds'` | `POSTGRES_AWS_RDS` |
312
+ * | `POSTGRESQL` | `MANAGED` | `'gcp-cloud-sql'` | `POSTGRES_GCP_CLOUD_SQL` |
313
+ * | `POSTGRESQL` | `MANAGED` | `'azure-database'` | `POSTGRES_AZURE_DATABASE` |
314
+ * | `POSTGRESQL` | `MANAGED` | `'supabase'` | `POSTGRES_SUPABASE` |
315
+ * | `POSTGRESQL` | `MANAGED` | `'neon'` | `POSTGRES_NEON` |
316
+ * | `POSTGRESQL` | `MANAGED` | `'render'` | `POSTGRES_RENDER` |
317
+ * | `POSTGRESQL` | `MANAGED` | unset or unrecognized | `POSTGRES_MANAGED` (generic fallback) |
318
+ * | `REDIS` | `SELF` | (any) | `REDIS_SELF` |
319
+ * | `RABBITMQ` | `SELF` | (any) | `RABBITMQ_SELF` |
320
+ * | `S3` | (either) | `'minio'` | `MINIO_SELF` |
321
+ * | `S3` | (either) | `'aws'` | `AWS_S3` |
322
+ * | `S3` | `SELF` | unset or unrecognized | `MINIO_SELF` |
323
+ * | `S3` | `MANAGED` | unset or unrecognized | `AWS_S3` |
324
+ * | `CLAMAV` | `SELF` | (any) | `CLAMAV_SELF` |
325
+ * | `IMMUDB` | `SELF` | (any) | `IMMUDB_SELF` |
326
+ *
327
+ * Returns `undefined` for combinations not in the table — for kinds
328
+ * whose `InfraProvider` catalog has no concrete entry yet (BACKUP)
329
+ * and for unrecognized managed Mongo brands. PostgreSQL has a generic
330
+ * managed fallback; S3 uses brand-first resolution, then source-based defaults. Callers decide whether `undefined` is fail-closed
331
+ * (planner running with unknown infra catalog) or accepted (lockfile
332
+ * pre-declaration).
333
+ *
334
+ * ## What this means when you author an environment
335
+ *
336
+ * **`MANAGED` does not reach every kind.** The table above is the whole of it: a managed vendor
337
+ * resolves for the relational database (six named brands plus a generic fallback), the document
338
+ * database (`'atlas'` only) and object storage. Declaring `{ source: MANAGED }` on the cache, the
339
+ * broker, the antivirus scanner, the audit store or the backup target resolves to NOTHING — those
340
+ * kinds are self-hosted only until their vendor catalogue is built.
341
+ *
342
+ * **And nothing tells you.** A kind that resolves to no provider is SKIPPED when the lockfile's infra
343
+ * section is materialised, silently, because recording an entry with no provider would lie. So a
344
+ * managed declaration the catalogue cannot serve looks exactly like a correct one: `wildo config
345
+ * sync` succeeds, the file says `MANAGED`, and the environment has no managed anything. Read the
346
+ * lockfile's infra section to see which of your declarations were actually resolved.
347
+ *
348
+ * **An unrecognised brand is not the same failure on every kind.** On the relational database it
349
+ * falls back to the generic managed entry, so a typo still resolves. On the document database,
350
+ * an unknown managed brand resolves to nothing. Object storage recognizes minio/aws first, then
351
+ * falls back by source: SELF to MinIO, MANAGED to AWS S3, including unrecognized brands.
352
+ *
353
+ * **Provider resolution and workload inclusion answer different questions.** Compose and Kubernetes
354
+ * both use the same per-kind inclusion policy, separately from catalogue resolution. Cache, broker
355
+ * and S3 default to self-hosted unless explicitly MANAGED; ClamAV and immudb require explicit SELF.
356
+ * MongoDB and PostgreSQL also include the platform database requirement: an application-level
357
+ * managed choice does not remove a self-hosted database still needed by the platform. Backup has
358
+ * no rendered workload. Do not infer workload inclusion from this provider resolver.
359
+ */
360
+ export function resolveInfraProvider(
361
+ kind: BackingServiceKind,
362
+ source: BackingServiceSource,
363
+ provider?: string,
364
+ ): InfraProvider | undefined {
365
+ switch (kind) {
366
+ case BackingServiceKind.MONGODB:
367
+ if (source === BackingServiceSource.SELF) return InfraProvider.MONGODB_SELF;
368
+ if (source === BackingServiceSource.MANAGED && provider === 'atlas') return InfraProvider.MONGODB_ATLAS;
369
+ // Other Mongo managed brands (e.g., AWS DocumentDB) — extend
370
+ // the `InfraProvider` enum + this branch in the same slice
371
+ // that adds the first concrete consumer.
372
+ return undefined;
373
+ case BackingServiceKind.POSTGRESQL:
374
+ if (source === BackingServiceSource.SELF) return InfraProvider.POSTGRES_SELF;
375
+ if (source === BackingServiceSource.MANAGED) {
376
+ switch (provider) {
377
+ case 'aws-rds': return InfraProvider.POSTGRES_AWS_RDS;
378
+ case 'gcp-cloud-sql': return InfraProvider.POSTGRES_GCP_CLOUD_SQL;
379
+ case 'azure-database': return InfraProvider.POSTGRES_AZURE_DATABASE;
380
+ case 'supabase': return InfraProvider.POSTGRES_SUPABASE;
381
+ case 'neon': return InfraProvider.POSTGRES_NEON;
382
+ case 'render': return InfraProvider.POSTGRES_RENDER;
383
+ // Generic fallback when the operator has authored
384
+ // `source: MANAGED` without naming a brand (or with an
385
+ // unrecognized brand). Acceptable while the brand catalog
386
+ // is incomplete — the lockfile records `POSTGRES_MANAGED`
387
+ // and the planner can still emit env vars + compose
388
+ // contributions; brand-specific runtime behavior is what
389
+ // the named-brand modules (Slice 4.B+) layer on top.
390
+ default: return InfraProvider.POSTGRES_MANAGED;
391
+ }
392
+ }
393
+ return undefined;
394
+ case BackingServiceKind.REDIS:
395
+ if (source === BackingServiceSource.SELF) return InfraProvider.REDIS_SELF;
396
+ // Managed Redis brands (ElastiCache, Upstash, Redis Cloud, …)
397
+ // — not catalogued yet; future expansion.
398
+ return undefined;
399
+ case BackingServiceKind.RABBITMQ:
400
+ if (source === BackingServiceSource.SELF) return InfraProvider.RABBITMQ_SELF;
401
+ // Managed RabbitMQ brands (CloudAMQP, AWS MQ, …) —
402
+ // not catalogued yet; future expansion.
403
+ return undefined;
404
+ case BackingServiceKind.S3:
405
+ // S3 dispatch is brand-first because the protocol is
406
+ // standardized (S3-compatible) and the same `source` can host
407
+ // multiple software stacks — `source: SELF` could be MinIO or
408
+ // a self-managed AWS S3 cluster (theoretically). The brand is
409
+ // the canonical disambiguator.
410
+ if (provider === 'minio') return InfraProvider.MINIO_SELF;
411
+ if (provider === 'aws') return InfraProvider.AWS_S3;
412
+ // Default source-based mapping for unbranded S3 — MinIO is
413
+ // the canonical self-hosted; AWS is the canonical managed.
414
+ if (source === BackingServiceSource.SELF) return InfraProvider.MINIO_SELF;
415
+ if (source === BackingServiceSource.MANAGED) return InfraProvider.AWS_S3;
416
+ return undefined;
417
+ case BackingServiceKind.CLAMAV:
418
+ if (source === BackingServiceSource.SELF) return InfraProvider.CLAMAV_SELF;
419
+ return undefined;
420
+ case BackingServiceKind.IMMUDB:
421
+ if (source === BackingServiceSource.SELF) return InfraProvider.IMMUDB_SELF;
422
+ // Managed immudb (immudb Vault) — not catalogued yet; future expansion.
423
+ return undefined;
424
+ case BackingServiceKind.BACKUP:
425
+ // No concrete `InfraProvider` declared yet for this kind. Extend the `InfraProvider` enum +
426
+ // this branch in the same slice that introduces the first concrete provider for it.
427
+ //
428
+ // `METRICS` was the other kind here and was WITHDRAWN 2026-09-09: telemetry is authored at
429
+ // `observability.telemetry` and its auth header derived from the selected
430
+ // `OBSERVABILITY_TELEMETRY` provider, so a backing-service kind was a third declaration
431
+ // surface that nothing read. See `RUNTIME_GRANTED_INFRA_CAPABILITIES`.
432
+ return undefined;
433
+ }
434
+ }
435
+ ```
@@ -53,10 +53,85 @@ export function isLocalEnvironmentId(environmentId: string): boolean {
53
53
  return environmentId === WildoEnvironment.LOCAL;
54
54
  }
55
55
 
56
+ /**
57
+ * Where a docker-compose backing service keeps its DATA.
58
+ *
59
+ * The two members are not a performance knob with a fast and a slow setting — they answer a
60
+ * question about ownership, and the cost follows from the answer:
61
+ *
62
+ * - `HOST_PATH` — the data lives at an explicit path on the host
63
+ * (`<saas-root>/.wildo-saas/local_data/<service>/`), bind-mounted into the container. The
64
+ * operator chooses the disk, backups target a known directory, and the tree is the same one the
65
+ * Kind k8s lane hostPath-mounts at `/mnt/local-data/<service>/`. That control is why it is the
66
+ * REMOTE default: a production operator who has provisioned a dedicated data volume must be able
67
+ * to put the database on it, and a named volume would silently land it under
68
+ * `/var/lib/docker/volumes/` on the root disk.
69
+ * - `DOCKER_VOLUME` — the data lives in a Docker named volume, inside the container runtime's own
70
+ * storage. Nobody outside Docker addresses it, which is exactly what makes it right for a
71
+ * disposable development stack.
72
+ *
73
+ * ## Why LOCAL defaults to `DOCKER_VOLUME`
74
+ *
75
+ * On Linux a bind mount is a native path and costs nothing. On macOS and Windows the container
76
+ * runtime is a VM, and a host bind mount crosses a filesystem bridge — VirtioFS on macOS, 9p/
77
+ * VirtioFS through WSL2 on Windows. Databases do small fsync'd random writes, so every one of them
78
+ * becomes a round trip out of the VM.
79
+ *
80
+ * Measured on macOS (Apple Virtualization, 6 vCPU) on 2026-09-22 with the eight self-hosted backing
81
+ * services bind-mounted: the VM process held **13,786 host file descriptors** open across 14,168
82
+ * files and burned **383% CPU** in Docker Desktop's file-sharing process — sustained, a 321%
83
+ * average over 2 days 5 hours — while the containers themselves used 0.7 of a core and container
84
+ * block-IO accounting stayed flat, because none of that traffic reaches the VM's own block device.
85
+ * Roughly four cores of pure filesystem translation for 0.7 of a core of database work.
86
+ *
87
+ * The default is uniform across all three development operating systems rather than "volumes on
88
+ * macOS and Windows, host paths on Linux", so every developer and CI run exercise the same stack
89
+ * and a bug reproduces the same way everywhere. It costs a Linux developer nothing: a named volume
90
+ * is a native directory there too.
91
+ *
92
+ * Both members are authorable per environment (`localDataStorage`), so a remote operator who wants
93
+ * volumes and a local developer who wants to read the files from their file manager each say so.
94
+ *
95
+ * NOTE this governs DATA directories only. The two small secret FILES compose mounts read-only —
96
+ * immudb's state-signing key and mongot's sync-source password — are materialized from
97
+ * `secrets.json` onto the host and stay host mounts under every mode. They are read once at
98
+ * startup, so they carry none of the cost above, and they have nowhere else to come from.
99
+ */
100
+ export enum WildoLocalDataStorage {
101
+ DOCKER_VOLUME = 'docker-volume',
102
+ HOST_PATH = 'host-path',
103
+ }
104
+
105
+ /**
106
+ * The `localDataStorage` an environment gets when it authors none.
107
+ *
108
+ * Total over {@link WildoLocationType} rather than a conditional on one member, so a location type
109
+ * added to the vocabulary tomorrow is a compile error here instead of silently inheriting whichever
110
+ * branch happened to be the `else`.
111
+ */
112
+ export function resolveDefaultLocalDataStorage(locationType: WildoLocationType): WildoLocalDataStorage {
113
+ switch (locationType) {
114
+ case WildoLocationType.LOCAL:
115
+ return WildoLocalDataStorage.DOCKER_VOLUME;
116
+ case WildoLocationType.REMOTE:
117
+ return WildoLocalDataStorage.HOST_PATH;
118
+ }
119
+ }
120
+
121
+ /**
122
+ * Ingress controller installed by Wildo's local and remote Kubernetes workflows.
123
+ * Import from `@wildo-ai/platform-config-lib`. Traefik owns both application
124
+ * routing and HTTP-01 challenge routing; selecting another controller is not
125
+ * supported by the generated installation contract.
126
+ */
127
+ export enum WildoKubernetesIngressClass {
128
+ TRAEFIK = 'traefik',
129
+ }
130
+
56
131
  /**
57
132
  * K8s-internal cluster topology. Holds ONLY values that are genuinely
58
- * specific to a Kubernetes deployment (the namespace and the optional
59
- * ingress class).
133
+ * specific to a Kubernetes deployment: namespace, ingress class and
134
+ * per-service workload replica counts.
60
135
  *
61
136
  * The external/public hostname (where browsers and reverse proxies hit
62
137
  * us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
@@ -67,7 +142,19 @@ export function isLocalEnvironmentId(environmentId: string): boolean {
67
142
  */
68
143
  export const WildoKubernetesConfigSchema = z.object({
69
144
  namespace: z.string().min(1),
70
- ingressClass: z.string().min(1).optional(),
145
+ /**
146
+ * Workload replica overrides keyed by authored SaaS service key (for example
147
+ * backendApi, app or website), never by generated image/deployment name.
148
+ * Platform service keys have their own renderer. Worker replicas remain in
149
+ * the worker declaration; a key without a generated application target is
150
+ * reported by application deployment generation rather than guessed.
151
+ */
152
+ services: z.record(z.string(), InfraServiceK8sSchema).optional(),
153
+ // Derive the literal from the named runtime vocabulary while accepting the
154
+ // natural authored spelling `ingressClass: 'traefik'` without an enum import.
155
+ ingressClass: z.literal(`${WildoKubernetesIngressClass.TRAEFIK}`, {
156
+ error: 'Wildo Kubernetes deployments support ingressClass traefik only; omit the field or select traefik.',
157
+ }).optional(),
71
158
  });
72
159
  export type WildoKubernetesConfig = z.infer<typeof WildoKubernetesConfigSchema>;
73
160
 
@@ -184,16 +271,18 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
184
271
  /**
185
272
  * Per-environment external-provider SELECTION override (2026-07-10).
186
273
  *
187
- * The app-wide primary/fallback selection for an `EngineCapability` lives in
274
+ * The app-wide primary/substitute selection for an `EngineCapability` lives in
188
275
  * `wildo.saas.config.ts` (`providers.scopes.backend.selection[capability]`) —
189
276
  * a single value shared by every environment. This block lets an environment
190
- * OVERRIDE that primary (and fallbacks) without touching the shared SaaS
277
+ * OVERRIDE that primary (and its substitutes) without touching the shared SaaS
191
278
  * config, so e.g. LOCAL can select the non-sending `email-preview` provider
192
279
  * for `EMAIL_TRANSACTIONAL` while staging/production keep `resend`.
193
280
  *
194
281
  * Semantics (mirrors the SaaS-side selection policy):
195
282
  * - `primary` — the ref that wins for this capability in this environment.
196
- * - `fallbacks` — ordered failover refs (optional).
283
+ * - `whenUnavailable` — ordered substitutes, used when a preceding ref is not AVAILABLE at
284
+ * resolution time (undeclared, disabled, unconfigured). NOT failover: nothing retries a
285
+ * second provider when a call to the first one fails.
197
286
  *
198
287
  * The referenced provider must still be DECLARED in
199
288
  * `providers.scopes.backend.providers` and available for the capability — the
@@ -201,7 +290,7 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
201
290
  * names an undeclared or capability-disabled provider resolves to nothing
202
291
  * (same fail-closed behaviour as an equivalent SaaS-side selection). FAN_OUT
203
292
  * capabilities ignore the override (every declared provider is active — a
204
- * primary/failover is meaningless), matching the SaaS-side rule.
293
+ * primary/substitute is meaningless), matching the SaaS-side rule.
205
294
  *
206
295
  * `env-vars-builder` serializes this block to the `WILDO_PROVIDER_SELECTION_OVERRIDES`
207
296
  * backend env var (JSON); `ExternalProvidersRegistryBackendService` reads it and
@@ -211,7 +300,7 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
211
300
  */
212
301
  export const WildoProviderSelectionOverrideEntrySchema = z.strictObject({
213
302
  primary: z.string().min(1),
214
- fallbacks: z.array(z.string().min(1)).optional(),
303
+ whenUnavailable: z.array(z.string().min(1)).optional(),
215
304
  });
216
305
  export type WildoProviderSelectionOverrideEntry = z.infer<typeof WildoProviderSelectionOverrideEntrySchema>;
217
306
 
@@ -221,11 +310,110 @@ export const WildoProviderSelectionOverridesSchema = z.partialRecord(
221
310
  );
222
311
  export type WildoProviderSelectionOverrides = z.infer<typeof WildoProviderSelectionOverridesSchema>;
223
312
 
313
+ /**
314
+ * Per-environment provider CONFIGURATION values — the half of `providerConfigurations` that exists once per
315
+ * DEPLOYMENT rather than once per application.
316
+ *
317
+ * `wildo.saas.config.ts > providerConfigurations` is authored once and reaches every environment. That is right for
318
+ * application POLICY a provider reads (an agent execution profile, which environments it may run in). It is wrong
319
+ * for an IDENTITY the vendor issued against one deployment: an OAuth client ID registered with the authorized
320
+ * redirect URIs of one environment, a frontend SDK DSN or site key, a picker `appId`. Authored in the SaaS config, the
321
+ * local development Google client — whose only redirect URI is `localhost` — would be the client staging and
322
+ * production send users to.
323
+ *
324
+ * This block carries those values for ONE environment, in exactly the SaaS block's
325
+ * `providerRef → protocolKind → key` shape, and {@link overlayEnvironmentProviderConfigurations} lays it over the
326
+ * SaaS block KEY BY KEY. An environment therefore states only what differs and inherits the rest, so the policy half
327
+ * is never restated per environment.
328
+ *
329
+ * It reaches both places a provider configuration is read, because the CLI applies the overlay where it knows the
330
+ * environment: the managed declaration each environment's apps-manager stores (backend readers — the OAuth2
331
+ * connection resolver, email/SMS senders, the provider registry) and the provider runtime artifacts a build bakes in
332
+ * (frontend `publicConfig`, the backend's generated provider module).
333
+ *
334
+ * NOT for secrets. This file is committed; a client secret, API key or signing secret stays in
335
+ * `secrets.json → providerEnv`. The CLI refuses a key named like one of the provider's declared secrets.
336
+ */
337
+ export const WildoEnvironmentProviderConfigurationsSchema = z.record(
338
+ z.string().min(1),
339
+ z.record(z.string().min(1), z.record(z.string().min(1), z.unknown())),
340
+ );
341
+ export type WildoEnvironmentProviderConfigurations = z.infer<typeof WildoEnvironmentProviderConfigurationsSchema>;
342
+
343
+ /**
344
+ * The provider configuration ONE environment runs with: the application-level `providerConfigurations`, with the
345
+ * environment's {@link WildoEnvironmentProviderConfigurationsSchema} values laid over it key by key.
346
+ *
347
+ * Precedence is per key inside one `providerRef → protocolKind` bag, and the environment wins — the more specific
348
+ * layer, as `secrets.json → providerEnv` wins over `observability.llmObservability.providerEnv`. A bag the
349
+ * environment does not mention is carried unchanged; a bag only the environment declares is added. Neither input is
350
+ * mutated.
351
+ *
352
+ * Rejected: replacing a whole provider or protocol bag. That would force an environment to restate every
353
+ * environment-invariant key it shares with the application (an agent execution profile beside a client ID), and a
354
+ * restated copy is one that drifts from the original.
355
+ *
356
+ * Throws when the application layer holds a non-object at a protocol key the environment overlays: there is no key
357
+ * to lay a value over, and silently replacing it would discard the application's value without saying so.
358
+ */
359
+ export function overlayEnvironmentProviderConfigurations(
360
+ applicationProviderConfigurations: Readonly<Record<string, Readonly<Record<string, unknown>> | undefined>> | undefined,
361
+ environmentProviderConfigurations: WildoEnvironmentProviderConfigurations | undefined,
362
+ ): Record<string, Record<string, unknown> | undefined> {
363
+ const resolved: Record<string, Record<string, unknown> | undefined> = {};
364
+ for (const [providerRef, protocols] of Object.entries(applicationProviderConfigurations ?? {})) {
365
+ resolved[providerRef] = protocols === undefined ? undefined : { ...protocols };
366
+ }
367
+ for (const [providerRef, environmentProtocols] of Object.entries(environmentProviderConfigurations ?? {})) {
368
+ const merged: Record<string, unknown> = { ...(resolved[providerRef] ?? {}) };
369
+ for (const [protocolKind, environmentValues] of Object.entries(environmentProtocols)) {
370
+ const applicationValues = merged[protocolKind];
371
+ if (applicationValues !== undefined && (applicationValues === null || typeof applicationValues !== 'object' || Array.isArray(applicationValues))) {
372
+ throw new Error(
373
+ `providerConfigurations.${providerRef}.${protocolKind} is not an object in wildo.saas.config.ts, so the `
374
+ + 'environment\'s values for it cannot be laid over it key by key.',
375
+ );
376
+ }
377
+ merged[protocolKind] = { ...(applicationValues as Record<string, unknown> | undefined), ...environmentValues };
378
+ }
379
+ resolved[providerRef] = merged;
380
+ }
381
+ return resolved;
382
+ }
383
+
224
384
  export enum DatabaseEngine {
225
385
  MONGODB = 'mongodb',
226
386
  POSTGRESQL = 'postgresql',
227
387
  }
228
388
 
389
+ /**
390
+ * The store an APPLICATION persists to when its environment authors no `applicationDatabase`.
391
+ *
392
+ * PostgreSQL — decided by Paul on 2026-09-24 (#1571), reversing 75cd1934f ("absence means MongoDB")
393
+ * and restoring the rule of 2e0194c41. This is the ONLY place the answer is written. Every reader of
394
+ * an application's engine goes through {@link resolveApplicationDatabaseEngine}, because the
395
+ * 2026-09-15 incident was two readers answering silence differently: provisioning chose PostgreSQL,
396
+ * the runtime chose MongoDB, Mongo provisioning was skipped, registration reported success, and the
397
+ * application died at boot with `Command update requires authentication`.
398
+ *
399
+ * Distinct from the PLATFORM's own store (`database` in the infra config) and from the engine's
400
+ * `DEFAULT_PERSISTENCE_ADAPTER` / `DATABASE_DEFAULT_ADAPTER` env default, which also governs
401
+ * platform services and is not what this decides. The application never falls through to that env
402
+ * default: the CLI writes the resolved adapter explicitly.
403
+ */
404
+ export const DEFAULT_APPLICATION_DATABASE_ENGINE: DatabaseEngine = DatabaseEngine.POSTGRESQL;
405
+
406
+ /**
407
+ * The engine an application persists to: its authored `applicationDatabase.engine`, or
408
+ * {@link DEFAULT_APPLICATION_DATABASE_ENGINE} when the environment authors none.
409
+ *
410
+ * Takes the declaration rather than a whole config so every carrier of it — the parsed infra config,
411
+ * `config.json`, a bootstrap request — answers through the same function.
412
+ */
413
+ export function resolveApplicationDatabaseEngine(applicationDatabase: { readonly engine?: DatabaseEngine } | undefined): DatabaseEngine {
414
+ return applicationDatabase?.engine ?? DEFAULT_APPLICATION_DATABASE_ENGINE;
415
+ }
416
+
229
417
  export enum WildoImageTagStrategy {
230
418
  COMMIT_SHA = 'commit-sha',
231
419
  BRANCH_NAME = 'branch-name',
@@ -235,27 +423,31 @@ export enum WildoImageTagStrategy {
235
423
  /**
236
424
  * Docker Compose deployment — no scaling, no K8s-specific fields.
237
425
  */
238
- export const DockerComposeDeploymentSchema = z.object({
426
+ export const DockerComposeDeploymentSchema = z.strictObject({
239
427
  branch: z.string().min(1),
240
428
  runtime: z.literal(WildoDeploymentRuntime.DOCKER_COMPOSE),
241
429
  imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
242
430
  });
243
431
 
244
432
  /**
245
- * Kubernetes deployment — includes registry, namespace, and scaling support.
433
+ * Kubernetes deployment — branch, namespace and tagging.
434
+ *
435
+ * No `registry`: an environment's images live at `remoteProvider.registryEndpoint`, the registry every deploy
436
+ * manifest pulls from and the deploy workflow pushes to. A separate field here could only repeat that value or
437
+ * contradict it — and it did contradict it, sending CI pushes to GHCR while the cluster pulled from the endpoint
438
+ * (#1165). Both deployment shapes are strict, so a leftover `registry` is refused rather than silently ignored.
246
439
  */
247
- export const KubernetesDeploymentSchema = z.object({
440
+ export const KubernetesDeploymentSchema = z.strictObject({
248
441
  branch: z.string().min(1),
249
442
  runtime: z.literal(WildoDeploymentRuntime.KUBERNETES),
250
- registry: z.string().min(1).optional(),
251
443
  namespace: z.string().min(1).optional(),
252
444
  imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
253
445
  });
254
446
 
255
447
  /**
256
448
  * Deployment configuration for CI/CD pipeline integration.
257
- * Discriminated on `runtime`: K8s-specific fields (`registry`, `namespace`)
258
- * are only available when `runtime` is `KUBERNETES`.
449
+ * Discriminated on `runtime`: the K8s-specific field (`namespace`)
450
+ * is only available when `runtime` is `KUBERNETES`.
259
451
  */
260
452
  export const WildoDeploymentConfigSchema = z.discriminatedUnion('runtime', [
261
453
  DockerComposeDeploymentSchema,
@@ -0,0 +1,95 @@
1
+ # `infrastructureHost` — running on another application's infrastructure
2
+
3
+ Read this when an environment of this application should share the platform and backing services of
4
+ another application instead of running its own, or when a descriptor authored with
5
+ `defineHostedInfraEnvConfig` is refused.
6
+
7
+ - which members a hosted descriptor may author, and which come from the host;
8
+ - why every store the application lists must be declared by the host;
9
+ - why a database, vhost or bucket name must differ from the host's.
10
+
11
+ ## Import Origins
12
+
13
+ - `@wildo-ai/platform-config-lib`
14
+
15
+ ## Source Excerpts
16
+
17
+ ### Origin Package: `@wildo-ai/platform-config-lib`
18
+
19
+ ```typescript
20
+ /**
21
+ * An environment descriptor for an application that runs on ANOTHER application's infrastructure.
22
+ *
23
+ * One application per environment owns the infrastructure — its platform services (apps-manager,
24
+ * module-registry, crontabs) and every backing service. Other applications declare that owner as their
25
+ * `infrastructureHost` and author only what is theirs: domain, CSP, provider choices, companion address,
26
+ * and their own database/vhost/bucket names on the host's servers. Everything else comes from the host's
27
+ * descriptor for the SAME environment when the descriptor is loaded, so the two cannot diverge — not in
28
+ * which stores exist, not in how they are reached, not between Docker Compose and Kubernetes.
29
+ *
30
+ * The link is per environment: author it in `wildo.infra.local.config.ts` to share a local platform while
31
+ * `staging` stays standalone, or in both.
32
+ *
33
+ * Refusals, all at load time, all naming both descriptors:
34
+ * - the host root holds no `wildo.saas.config.ts` — a hosted application needs its host's SOURCE checked
35
+ * out at that path;
36
+ * - the host has no descriptor for this environment, or is itself hosted;
37
+ * - a store this application lists is not declared by the host;
38
+ * - a database, vhost or bucket name equals the host's.
39
+ *
40
+ * @example Wonder CRM on Your Application' local platform.
41
+ * ```ts
42
+ * export default defineHostedInfraEnvConfig({
43
+ * environment: WildoEnvironment.LOCAL,
44
+ * infrastructureHost: { applicationRoot: '../your-app' },
45
+ * publicDomain: 'localhost',
46
+ * applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
47
+ * backingServices: {
48
+ * postgresql: { database: 'wonder-crm-db' },
49
+ * redis: { database: 0 },
50
+ * rabbitmq: { vhost: 'wonder-crm' },
51
+ * s3: { bucket: 'wonder-crm-local' },
52
+ * },
53
+ * devCompanion: { host: 'localhost', port: 4351 },
54
+ * });
55
+ * ```
56
+ */
57
+ export const WildoHostedInfraEnvConfigSchema = z.strictObject({
58
+ infrastructureHost: z.strictObject({
59
+ /**
60
+ * The host application's root — the directory holding its `wildo.saas.config.ts` — RELATIVE to this
61
+ * application's root. Relative because the descriptor is committed: an absolute path is one machine's
62
+ * checkout layout, and would break on every other.
63
+ */
64
+ applicationRoot: z.string().min(1).refine(
65
+ (value) => !ABSOLUTE_PATH_PATTERN.test(value),
66
+ 'infrastructureHost.applicationRoot must be relative to this application root (e.g. "../your-app"): the descriptor is committed, and an absolute path only exists on one machine.',
67
+ ),
68
+ }, refuseHostOwnedKeys('infrastructureHost')),
69
+ version: WILDO_INFRA_ENV_CONFIG_SHAPE.version,
70
+ environment: WILDO_INFRA_ENV_CONFIG_SHAPE.environment,
71
+ applicationDatabase: WILDO_INFRA_ENV_CONFIG_SHAPE.applicationDatabase,
72
+ publicDomain: WILDO_INFRA_ENV_CONFIG_SHAPE.publicDomain,
73
+ serviceHosts: WILDO_INFRA_ENV_CONFIG_SHAPE.serviceHosts,
74
+ kubernetes: z.strictObject({
75
+ services: WildoKubernetesConfigSchema.shape.services,
76
+ }, refuseHostOwnedKeys('kubernetes')).optional(),
77
+ deployment: z.strictObject({
78
+ branch: z.string().min(1),
79
+ imageTagStrategy: z.enum(WildoImageTagStrategy).optional(),
80
+ // No `registry`: images live at the host's `remoteProvider.registryEndpoint`, which its manifests pull from (#1165).
81
+ }, refuseHostOwnedKeys('deployment')).optional(),
82
+ backingServices: HostedBackingServicesEnvConfigSchema.optional(),
83
+ logging: WILDO_INFRA_ENV_CONFIG_SHAPE.logging,
84
+ observability: WILDO_INFRA_ENV_CONFIG_SHAPE.observability,
85
+ providerSelection: WILDO_INFRA_ENV_CONFIG_SHAPE.providerSelection,
86
+ providerConfigurations: WILDO_INFRA_ENV_CONFIG_SHAPE.providerConfigurations,
87
+ systemsOfRecord: WILDO_INFRA_ENV_CONFIG_SHAPE.systemsOfRecord,
88
+ documentationSite: WILDO_INFRA_ENV_CONFIG_SHAPE.documentationSite,
89
+ applicationCreationVerification: WILDO_INFRA_ENV_CONFIG_SHAPE.applicationCreationVerification,
90
+ serviceAuth: WILDO_INFRA_ENV_CONFIG_SHAPE.serviceAuth,
91
+ csp: WILDO_INFRA_ENV_CONFIG_SHAPE.csp,
92
+ cdn: WILDO_INFRA_ENV_CONFIG_SHAPE.cdn,
93
+ devCompanion: WILDO_INFRA_ENV_CONFIG_SHAPE.devCompanion,
94
+ }, refuseHostOwnedKeys('a hosted environment descriptor'));
95
+ ```