@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -118,6 +118,11 @@ export. The typed shape carries:
118
118
  `BackingServiceSource.ATLAS` value no longer exists — it was
119
119
  replaced by the two-axis `(source, provider?)` shape, so Atlas is
120
120
  now `source: MANAGED, provider: 'atlas'`
121
+ - `serviceProfile` (optional) — `EnvironmentServiceProfile.FULL` (the
122
+ default) or `SMALL`: which optional services the environment runs.
123
+ `SMALL` runs no ClamAV, no immudb and no mongot, and one database
124
+ family. See "A smaller footprint: `serviceProfile`" below for what
125
+ each one costs you
121
126
  - `logging` — `{ level, formattedConsoleErrors }` projected to the
122
127
  process env as `LOG_LEVEL` / `LOG_FORMATTED_CONSOLE_ERRORS` by
123
128
  `env-vars-builder` and consumed at boot by
@@ -132,8 +137,7 @@ export. The typed shape carries:
132
137
  semantics. There
133
138
  is intentionally no top-level `domain` field either — the canonical
134
139
  seam is `publicDomain`. Both `domain` and `kubernetes.baseDomain`
135
- are strict-rejected by the schema (pinned by
136
- `define-infra-env-config.unimplemented.test.ts`).
140
+ are strict-rejected by the schema.
137
141
  - `serviceHosts` (optional) — maps a `services.<key>` from
138
142
  `wildo.saas.config.ts` to the subdomain chain under `publicDomain` where
139
143
  that service is reachable in this environment; `''` mounts it at the apex.
@@ -282,8 +286,8 @@ export default defineInfraEnvConfig({
282
286
  // `{ accessTokenExpirationMinutes: 60, refreshTokenExpirationDays: 30 }`
283
287
  // \u2014 byte-for-byte equal to the THEN-CURRENT `WildoAuthConfigSchema`
284
288
  // defaults, which is author-noise per the framework-mindset principle
285
- // documented on `production/wildo.infra.remote.config.ts`. With Auth-
286
- // hardening Slice A Step 5 lowering the access-token default to 15 min,
289
+ // documented on `production/wildo.infra.remote.config.ts`. With the
290
+ // access-token default lowered to 15 min (2026-04-13),
287
291
  // local dev now inherits the tighter posture too: an XSS bug in dev only
288
292
  // exposes a 15-min access-token window (the refresh loop rotates
289
293
  // transparently via the `__wildo_refresh` cookie, so developers see no
@@ -391,7 +395,7 @@ export default defineInfraEnvConfig({
391
395
  },
392
396
 
393
397
  /**
394
- * OTLP telemetry (Slice 2 Phase 5) — local verification against the in-compose
398
+ * OTLP telemetry — local verification against the in-compose
395
399
  * `otel-collector` (published on `localhost:4318`). `enabled` → `OTEL_ENABLED` + the
396
400
  * `--import @wildo-ai/saas-backend-lib/otel-preload` wiring; `endpoint` →
397
401
  * `OTEL_EXPORTER_OTLP_ENDPOINT`. No provider auth here — the local collector needs none
@@ -424,12 +428,14 @@ export default defineInfraEnvConfig({
424
428
  },
425
429
 
426
430
  /**
427
- * Env-layer docs CSP override (`auth-hardening.md` B-2C).
431
+ * Env-layer CSP additions, one block per frontend (`app`, `docs`, `website`).
428
432
  *
429
- * This is the per-env origin the docs frontend is allowed to fetch for
430
- * auth handoff + OpenAPI runtime calls. The app-static posture
431
- * (`enabled`, `reportOnly`) lives in `technical-doc/wildo.tech-doc.config.ts`;
432
- * this env layer only supplies the local backend origin.
433
+ * Each admits the local backend origin in `connect-src`: the app calls its
434
+ * API, the docs site fetches it for auth handoff and OpenAPI runtime calls,
435
+ * and the website posts its forms to it. The static posture (`enabled`,
436
+ * `reportOnly`) lives with each frontend: the app's in `wildo.saas.config.ts`,
437
+ * the docs site's in `technical-doc/wildo.tech-doc.config.ts`, the website's in
438
+ * `website/wildo.website.config.ts`. This env layer only supplies origins.
433
439
  */
434
440
  csp: {
435
441
  app: {
@@ -480,9 +486,9 @@ export default defineInfraEnvConfig({
480
486
  * The content-safety classifier is `azure-content-safety` pointed at the provider-simulators double on this machine
481
487
  * (#2991): its host slot `AZURE_CONTENT_SAFETY_HOST` holds `127.0.0.1:18309` and its key the double's own, both in
482
488
  * `secrets.json`, never here. The engine reaches a loopback host only in a development or test environment, so this
483
- * selection cannot carry the double's address anywhere else. Run the double with
484
- * `CONTENT_SAFETY_MOCK_PORT=18309 pnpm -C ../../platform/testing/provider-simulators mock:content-safety`; without it,
485
- * the guarded agents answer that their content could not be screened.
489
+ * selection cannot carry the double's address anywhere else. The double is the content-safety simulator of
490
+ * `@wildo-ai/provider-simulators`, listening on that port; without a service answering there, the guarded agents
491
+ * answer that their content could not be screened.
486
492
  */
487
493
  [EngineCapability.AI_CONTENT_SAFETY]: {
488
494
  primary: 'azure-content-safety',
@@ -533,61 +539,6 @@ export default defineInfraEnvConfig({
533
539
  silent: false,
534
540
  },
535
541
 
536
- /**
537
- * WHERE each declared system of record is, in THIS environment (#1055).
538
- *
539
- * `odoo` is declared ABSENT, and that is the true statement: this machine has no Odoo. Every read
540
- * of `billableServices` answers **409 `SYSTEM_OF_RECORD_UNAVAILABLE_IN_ENVIRONMENT`** — a code a
541
- * client can branch on — rather than a transport error against an address nobody is listening on.
542
- *
543
- * ## It carried the E2E double's address for one day, and why it does not any more
544
- *
545
- * `a4c48797d` (2026-09-21) pointed this at `127.0.0.1:18069`, the read-through lane's own double.
546
- * That was the ONLY way the lane could run past its preflight: a lane driving an ALREADY-RUNNING
547
- * application cannot set deployment configuration, so the address had to be committed. It worked —
548
- * #590 ran end to end for the first time, and #1058's partition confinement was proven on a real
549
- * stack (`e7f2ab6ff`).
550
- *
551
- * It is reverted because of what it cost everyone else. The dependency splits in two and only one
552
- * half is on demand:
553
- *
554
- * - `billableServices` is READ-THROUGH, so it needs Odoo only while a read happens — and the lane
555
- * spawns its own double and reaps it. Self-sufficient.
556
- * - `externalCustomers` is a PIPELINE with `scheduleCron: '0 * * * *'`, so it dialled this address
557
- * every hour whether or not anyone was testing. Measured at `11:00:00.779Z` on 2026-09-22:
558
- * `pipeline 'externalCustomers' failed: HTTP-API network failure … fetch failed`, and it would
559
- * have repeated identically forever, on every developer's machine.
560
- *
561
- * An hourly failure for a condition nobody intends to fix is a warning people learn to skip, and
562
- * they take that habit to the warnings that matter. Decided in #1476; the engine-side
563
- * miscalibration (warn hourly rather than back off) is #1475.
564
- *
565
- * ## What this does NOT change
566
- *
567
- * `partition: true` stays on the INSTANCE in `wildo.saas.config.ts`, and that is the D2 split
568
- * working rather than a leftover: how a deployment's data is shaped is a property of the
569
- * declaration (WHAT), and whether this machine can reach it is a property of the environment
570
- * (WHERE). A machine with no Odoo still knows its Odoo is partitioned by company.
571
- *
572
- * An absent declaration is still refused at boot. "No access here" and "somebody forgot to author
573
- * the address" need opposite behaviours and silence cannot be either — so a machine that genuinely
574
- * has no Odoo writes `{ enabled: false }`, rather than deleting the key.
575
- *
576
- * ## To run the read-through lane, or to use a REAL Odoo
577
- *
578
- * For the LANE: put the double's address back — `baseUrl: 'http://127.0.0.1:18069'`,
579
- * `database: 'wildo_e2e'`, `login: 'e2e@wildo.test'` (`ODOO_SIMULATOR_CREDENTIALS` from
580
- * `@wildo-ai/engine-behavior-e2e`) — then `wildo config sync --local --domain env-files` and
581
- * restart. Expect the hourly pipeline failure above for as long as it is there.
582
- *
583
- * For a REAL Odoo: the same three values pointed at that instance, with its key in `secrets.json`
584
- * under `systemsOfRecordEnv.WILDO_SOR_ODOO__API_KEY`. The derived environment variable names
585
- * (`WILDO_SOR_ODOO__BASE_URL` and siblings) are never authored — they come from the instance name.
586
- */
587
- systemsOfRecord: {
588
- odoo: { enabled: false },
589
- },
590
-
591
542
  devCompanion: {
592
543
  // Loopback ONLY (meta-workflows P-29): the companion API hosts
593
544
  // endpoints that spend money and execute code (coding-agent dispatch),
@@ -626,11 +577,11 @@ What earns its place:
626
577
  lifetime policy threaded into every per-app
627
578
  `Wildo_Application_Config.jwt` at apps-manager init time. The
628
579
  actual JWT signing keys live in the secrets store, **never** in
629
- this file. Algorithm selection is not authored here \u2014 it is
580
+ this file. Algorithm selection is not authored here — it is
630
581
  fixed by the per-service key convention at sign time. The
631
582
  `15 / 30` shown above matches the schema defaults exactly
632
- (Auth-hardening Slice A Step 5, 2026-04-13 \u2014 prior to that
633
- the access-token default was 60 min); per the framework-mindset
583
+ (since 2026-04-13; before that the access-token default was
584
+ 60 min); per the framework-mindset
634
585
  principle, **do not author values byte-for-byte equal to the
635
586
  schema defaults** (creates author-noise, masks future default
636
587
  shifts). Author `serviceAuth` only when you genuinely deviate
@@ -651,11 +602,11 @@ What earns its place:
651
602
  params (host, port, vhost, bucket, endpoint). A remote config may
652
603
  swap to `source: BackingServiceSource.MANAGED` only where the platform
653
604
  serves it — today that is MongoDB Atlas alone (`provider: 'atlas'`);
654
- see "What each kind can be declared as today". The pre-Slice-4.B.0
605
+ see "What each kind can be declared as today". The former
655
606
  `BackingServiceSource.ATLAS` enum value was removed on 2026-05-07 —
656
607
  Atlas is a brand under the managed source, not its own source axis.
657
608
  - `logging: { level: 'debug', formattedConsoleErrors: true }` —
658
- per-environment log posture. Wired end-to-end by Slice 3.5:
609
+ per-environment log posture. Wired end-to-end:
659
610
  persisted into `PlatformEnvConfigJson.logging`, projected by
660
611
  `env-vars-builder.emitLoggingEnv` to `LOG_LEVEL` /
661
612
  `LOG_FORMATTED_CONSOLE_ERRORS`, and consumed at boot by every
@@ -845,7 +796,85 @@ receives. No application receives it.
845
796
  (`docker exec -it wildo-immudb immuadmin user changepassword immudb`
846
797
  locally), or start from a fresh data directory. This alters a credential
847
798
  the platform does not hold, so it is the operator's step. The same holds
848
- after rotating `immudb.adminPassword`.
799
+ for an environment whose `immudb.adminPassword` was rotated by an older
800
+ CLI. Today `wildo config sync --rotate-secrets` leaves
801
+ `immudb.adminPassword` unchanged and says so (`Not rotated: …`), because
802
+ the running server would not take a new value.
803
+
804
+ ## A smaller footprint: `serviceProfile`
805
+
806
+ A small internal tool for one team does not need every service the full
807
+ platform runs. `serviceProfile: EnvironmentServiceProfile.SMALL` (import
808
+ it from `@wildo-ai/platform-config-lib`) keeps the services the platform
809
+ cannot run without (one database, the cache, the broker and the object
810
+ store) and drops three optional ones:
811
+
812
+ | Service the profile drops | Capability it backs | What happens if the application declares the capability anyway |
813
+ |---|---|---|
814
+ | ClamAV | Antivirus scanning of uploads (`z_file({ scanPolicy: 'required' })`) | The backend refuses to start, naming the profile and the fields. A field that only PREFERS a scan still uploads, unscanned, exactly as with no scanner |
815
+ | immudb | The tamper-evident store of `COMPLIANCE_AUDIT_TRAIL` | The backend refuses to start when the capability is enabled and no audit provider resolves. The database audit trail (Layer 1) always runs |
816
+ | mongot | Vector and text search for `.ragSource()` fields on a **MongoDB**-persisted resource | The backend refuses to start, naming the profile and the resources. On **PostgreSQL** nothing changes: pgvector runs inside the database |
817
+
818
+ The refusals are the point. A capability that looks enabled and does
819
+ nothing is worse than one that is refused: an upload certified "clean"
820
+ with no scanner, or chunk copies of personal text in a store nothing
821
+ can search or erase.
822
+
823
+ What to choose instead, when one of these is refused:
824
+
825
+ - **Antivirus:** remove `scanPolicy: 'required'` from the fields, or
826
+ use the full profile with `backingServices.clamav: { source: SELF }`.
827
+ - **Audit store:** disable `COMPLIANCE_AUDIT_TRAIL` (the database audit
828
+ trail stays), point the immudb audit provider at an immudb you run
829
+ elsewhere through `IMMUDB_HOST` in the provider secrets, or use the
830
+ full profile with `backingServices.immudb: { source: SELF }`.
831
+ - **Vector search:** move the resources to PostgreSQL, remove the
832
+ `.ragSource()` declarations, or use the full profile.
833
+
834
+ `SMALL` also runs **one database family**: the platform's store and the
835
+ application's are the same engine, and only that store is declared in
836
+ `backingServices`. Either engine works; pick the one your application
837
+ needs:
838
+
839
+ | One family | `database.engine` | `applicationDatabase.engine` | `backingServices` holds |
840
+ |---|---|---|---|
841
+ | PostgreSQL (vector search included, through pgvector) | `POSTGRESQL` | `POSTGRESQL` (or omitted: it is the default) | `postgresql`, no `mongodb` |
842
+ | MongoDB | `MONGODB` | `MONGODB` | `mongodb`, no `postgresql` |
843
+
844
+ Rules the descriptor enforces when the file is parsed:
845
+
846
+ - `SMALL` beside `backingServices.clamav` or `.immudb` with
847
+ `source: SELF` is refused. The two statements contradict each other;
848
+ remove one.
849
+ - `SMALL` with two database families is refused, and the message names
850
+ the declarations that bring each one in: a second store in
851
+ `backingServices`, a platform `database.engine` that differs from the
852
+ application's, or an application left on its PostgreSQL default
853
+ beside a MongoDB platform.
854
+ - A hosted application (`infrastructureHost`) cannot author it: it runs
855
+ on its host's containers, so it gets its host's profile. Every store a
856
+ hosted application uses is declared by its host, so the host's own
857
+ one-family rule covers it.
858
+
859
+ Both lanes render the profile. On Docker Compose the dropped services are
860
+ not in the generated compose file. On Kubernetes their workloads,
861
+ secrets and persistent volumes are not rendered, and mongod is started
862
+ without its search routing. Both lanes refuse again at render time a
863
+ record that contradicts the profile, for an environment whose
864
+ `config.json` was written before the profile was authored: run
865
+ `wildo config sync` after changing the descriptor.
866
+
867
+ What `SMALL` does not drop yet: **RabbitMQ**. The platform's scheduler
868
+ delivers scheduled work to the application's queue from another process,
869
+ and no queue that survives a restart runs on the cache or the database
870
+ today, so the broker stays under every profile.
871
+
872
+ Moving between profiles migrates no data. Going to `SMALL`, the next
873
+ `wildo local dev` / `wildo local up` stops the dropped containers and
874
+ keeps their data volumes. Going back to `FULL`, each service starts
875
+ from what it kept or from empty: mongot rebuilds its indexes from the
876
+ collections, and a new immudb holds no earlier audit history (the
877
+ database audit trail does).
849
878
 
850
879
  ## Choosing the application's store — and what it obliges
851
880
 
@@ -858,6 +887,9 @@ you about: a resource's table is built by a MIGRATION, not by first write, so
858
887
  from then on every schema change owes an artifact. Follow
859
888
  `application-database-migrations` — and read
860
889
  `references/framework-application-database-api.md` for the contract itself.
890
+ Which framework features run on PostgreSQL (all of them, with a short list of
891
+ observable differences) is in that skill's
892
+ `references/postgresql-supported-surfaces.md`.
861
893
 
862
894
  ## Where the platform keeps the keys it holds
863
895
 
@@ -887,7 +919,9 @@ It is a PLATFORM declaration, like `platformStorage`: a hosted application canno
887
919
 
888
920
  For a key a vendor HSM generates and keeps, declare a cloud KMS in the same block: `awsKms`, `googleCloudKms` or
889
921
  `azureKeyVault`. Bindings then name the `aws-kms`, `google-cloud-kms` or `azure-key-vault` provider. These keys are
890
- generated inside the vendor's HSM and never leave it, so they meet a hardware floor. A Google key ring declared
922
+ generated inside the vendor's HSM and never leave it, so they meet a hardware floor that accepts the vendor's claim
923
+ (`protectionEvidence: 'provider_claim'`): the HSM level is what the vendor's API reports, and no provider verifies an
924
+ HSM's signed attestation yet, so a floor demanding `verified_hardware_attestation` refuses them. A Google key ring declared
891
925
  `protectionLevel: SOFTWARE`, or an Azure vault declared `hsm: false`, makes software keys, and a hardware floor refuses
892
926
  them. apps-manager authenticates with its workload identity, so nothing goes in `secrets.json`. Each block names two
893
927
  identities, a signer that only signs and an operator for the key's lifecycle, and the source-backed reference lists the
@@ -909,11 +943,19 @@ The last two wait until the hour is six hours old, because vendor logs arrive la
909
943
  provider's quota and cost. AWS, for example, allows 1,000 P-256 signs per second per account and region, and
910
944
  apps-manager keeps its own signing under 80% of that.
911
945
 
912
- For a dedicated HSM, declare `pkcs11: { modulePath, tokenLabel, hardwareTokenModels }`. This covers Thales Luna,
946
+ For a dedicated HSM, declare `pkcs11: { modulePath, tokenLabel, hardwareTokenModels, clientFiles, environment }`. This covers Thales Luna,
913
947
  Entrust nShield, AWS CloudHSM, Azure Cloud HSM, an appliance, or SoftHSM2 for a test. Bindings then name the `pkcs11`
914
948
  provider.
915
949
  - `modulePath` is the vendor's PKCS#11 library inside apps-manager's container. The platform image carries SoftHSM2 at
916
- `/usr/lib/softhsm/libsofthsm2.so`; for a real HSM, mount its module.
950
+ `/usr/lib/softhsm/libsofthsm2.so` and nothing else.
951
+ - For a real HSM, list the vendor client's files in `clientFiles: [{ hostPath, containerPath }]` (the module, its
952
+ configuration, its certificates) and point `modulePath` inside one of them. The CLI mounts each one read-only into
953
+ both apps-manager services: a bind mount in compose, a `hostPath` volume in Kubernetes (so the client must be installed
954
+ on every node that may run apps-manager). Do not edit the generated manifests by hand; they are regenerated.
955
+ - Put the vendor's own variables (a Luna client's `ChrystokiConfigurationPath`, for example) in `environment`. They are
956
+ written in plain text into the manifests, so never a credential, and they may not name a variable Wildo sets.
957
+ - A `modulePath` that is neither SoftHSM2 nor under a `containerPath` is refused, naming the environment: at load when
958
+ `clientFiles` is declared, and otherwise when compose or Kubernetes renders apps-manager.
917
959
  - Put the token's user PIN in `secrets.json` under `platformKeyPkcs11: { pin }`, never in the infra file. Use a long
918
960
  PIN: apps-manager guards it out of every application environment only from 12 characters up.
919
961
  - A key counts as HARDWARE only when the token reports a hardware slot AND its model is listed in
@@ -976,6 +1018,7 @@ Read `references/framework-infrastructure-host-api.md` for the source-backed con
976
1018
  - [ ] Every backing service the app uses is declared with a valid `source`
977
1019
  - [ ] Every declaration is one the platform can serve (see "What each kind can be declared as today") — `wildo config validate --domain config` reports no `names no infrastructure provider` / `which no provider module can serve yet` finding
978
1020
  - [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
1021
+ - [ ] A `SMALL` `serviceProfile` declares no `clamav` / `immudb` with `source: SELF`, runs one database family (one of `mongodb` / `postgresql` in `backingServices`, and `database.engine` equal to `applicationDatabase.engine`), and the application declares none of the capabilities the profile drops (or accepts the boot refusal as the reminder) — see "A smaller footprint"
979
1022
  - [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
980
1023
  - [ ] Every vendor identifier issued per deployment (OAuth client ID, frontend SDK DSN or site key) is authored in THIS file's `providerConfigurations`, and none is authored in `wildo.saas.config.ts`
981
1024
  - [ ] Local `devCompanion` is optional; remote environments declare `runtimeEnvironment`; remote Kubernetes also requires `remoteProvider`; optional `deployment` matches the chosen workflow
@@ -995,6 +1038,7 @@ Run from the app root, substituting `<env>`:
995
1038
  | Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
996
1039
  | Every `MANAGED` declaration is MongoDB Atlas (anything else is refused) | `rg -n "BackingServiceSource\.MANAGED" infrastructure/*/wildo.infra.*.config.ts` — every hit must be `mongodb` with `provider: 'atlas'` |
997
1040
  | Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
1041
+ | Which environments run a reduced service profile | `rg -n "serviceProfile" infrastructure/*/wildo.infra.*.config.ts`, then check each hit against the "A smaller footprint" table |
998
1042
  | **No secrets** in infra file (must be empty) | see the commands below the table |
999
1043
  | Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
1000
1044
  | Optional local companion binding is deliberate | Inspect `devCompanion` when present; omission is schema-valid. |
@@ -1032,6 +1076,10 @@ runtime/source enums. Keep secret values outside authored infrastructure.
1032
1076
  - `source: BackingServiceSource.MANAGED` on anything but `mongodb`
1033
1077
  with `provider: 'atlas'` (catch with the **Every `MANAGED`
1034
1078
  declaration is MongoDB Atlas** grep above)
1079
+ - `serviceProfile: SMALL` on an environment whose application requires
1080
+ file scanning, enables `COMPLIANCE_AUDIT_TRAIL` with no external
1081
+ audit store, or keeps `.ragSource()` fields on MongoDB (the backend
1082
+ refuses to start; catch with the **reduced service profile** grep)
1035
1083
  - `devCompanion` declared in a remote config (the field is local-only;
1036
1084
  the typed factory may accept it but the companion won't bind correctly)
1037
1085
  - `remoteProvider` or `deployment` declared in a local config (same
@@ -43,7 +43,8 @@ export enum BackingServiceKind {
43
43
  /**
44
44
  * immudb — an immutable, cryptographically-verifiable database used as a
45
45
  * tamper-evident audit-log store (fills the `AUDIT_LOG_STORAGE` capability).
46
- * A stateful DB: a data volume in dev, self-hosted or immudb Vault in prod.
46
+ * A stateful DB: a data volume in dev, self-hosted in prod. (Codenotary no longer offers its hosted
47
+ * immudb Vault, so there is no managed form to choose.)
47
48
  */
48
49
  IMMUDB = 'immudb',
49
50
  /*
@@ -66,11 +67,9 @@ export enum BackingServiceKind {
66
67
  * vendor names (e.g. `'atlas'` for MongoDB Atlas, `'aws-rds'` for
67
68
  * AWS RDS, `'supabase'` for Supabase Postgres, `'aws'` for AWS S3).
68
69
  *
69
- * **Slice 4.B.0 reshape (2026-05-07)**: the `ATLAS` value was removed.
70
- * Pre-reshape `source: ATLAS` becomes `source: MANAGED, provider:
71
- * 'atlas'`. The reshape generalizes from "Mongo + S3 are the only
72
- * brand-aware kinds" to "every kind can be brand-aware when the
73
- * managed market has multiple vendors" — Postgres in particular
70
+ * There is no `ATLAS` source (removed 2026-05-07): MongoDB Atlas is
71
+ * `source: MANAGED, provider: 'atlas'`. Any kind can be brand-aware
72
+ * when the managed market has multiple vendors — Postgres in particular
74
73
  * (RDS / GCP Cloud SQL / Supabase / Neon / Render / Azure).
75
74
  */
76
75
  export enum BackingServiceSource {
@@ -82,7 +81,7 @@ export enum BackingServiceSource {
82
81
  * Common fields every backing-service entry shares.
83
82
  *
84
83
  * Per-kind extensions add the fields that are SEMANTICALLY meaningful
85
- * for that kind only. Slice 3 closeout (M-4 + L-5): the previous shared
84
+ * for that kind only. The previous shared
86
85
  * `BackingServiceEnvConfigSchema` collapsed `database` into a
87
86
  * `union(int, string)` and put `name` only on Mongo; both compromised
88
87
  * the framework-mindset rule that "every field must carry its semantic
@@ -111,8 +110,7 @@ const BackingServiceBaseSchema = z.object({
111
110
  * `<KIND>_SELF` entry where one exists, otherwise return
112
111
  * `undefined`).
113
112
  *
114
- * Slice 4.B.0 (2026-05-07) generalized this from "S3-only" to
115
- * every brand-aware kind.
113
+ * Since 2026-05-07 this applies to every brand-aware kind, not only S3.
116
114
  */
117
115
  provider: z.string().min(1).optional(),
118
116
  /**
@@ -135,8 +133,8 @@ const BackingServiceBaseSchema = z.object({
135
133
  * MongoDB backing service. `database` is the database NAME (string).
136
134
  *
137
135
  * Mongo's connection URL has the shape `mongodb://host:port/<database>`
138
- * — this string corresponds to the path segment. Pre-3 the field was
139
- * `name`; renamed to `database` in Slice 3 closeout (L-5) so all
136
+ * — this string corresponds to the path segment. The field was once
137
+ * `name`; it is `database` so all
140
138
  * data-store kinds use the same property name for the same concept
141
139
  * (vs. Postgres which already used `database`).
142
140
  */
@@ -305,8 +303,8 @@ export const BackingServiceKindToInfraCapability: Record<BackingServiceKind, Inf
305
303
  * Project `(BackingServiceKind, source, provider?)` → `InfraProvider`.
306
304
  *
307
305
  * The three-axis dispatch (kind × hosting-model × brand) generalizes
308
- * the source/brand split across all kinds (Slice 4.B.0, 2026-05-07
309
- * — was source-only with Atlas as a special source value before).
306
+ * the source/brand split across all kinds (since 2026-05-07;
307
+ * before that it was source-only, with Atlas as a special source value).
310
308
  *
311
309
  * **Brand vocabulary** per kind (`provider` field on the authored
312
310
  * `BackingService<X>Schema`):
@@ -437,7 +435,7 @@ export function resolveInfraProvider(
437
435
  return undefined;
438
436
  case BackingServiceKind.IMMUDB:
439
437
  if (source === BackingServiceSource.SELF) return InfraProvider.IMMUDB_SELF;
440
- // Managed immudb (immudb Vault) — not catalogued yet; future expansion.
438
+ // No managed immudb: Codenotary no longer offers its hosted immudb Vault (re-researched 2026-11-06, #2518).
441
439
  return undefined;
442
440
  }
443
441
  }
@@ -118,6 +118,129 @@ export function resolveDefaultLocalDataStorage(locationType: WildoLocationType):
118
118
  }
119
119
  }
120
120
 
121
+ /**
122
+ * Which set of OPTIONAL backing services an environment runs — the deployment footprint (#2303).
123
+ *
124
+ * An environment always runs the services the platform cannot live without (a database, a cache, a
125
+ * broker, an object store). On top of those, the full platform runs three services that each back ONE
126
+ * engine capability: ClamAV (antivirus scanning of uploaded files), immudb (the tamper-evident audit
127
+ * store) and mongot (MongoDB Search / Vector Search). A small internal tool for one team rarely needs any
128
+ * of them, and they are the heaviest containers in the stack (mongot alone is a JVM holding Lucene
129
+ * indexes). A profile states, per environment, whether they run at all.
130
+ *
131
+ * ## Named "service profile", not "runtime profile"
132
+ *
133
+ * `ApplicationRuntimeProfile` (`@wildo-ai/saas-backend-lib`) already names WHICH RUNTIME boots the
134
+ * application lifecycle (the backend or a minion). This vocabulary answers a different question, about
135
+ * the ENVIRONMENT's footprint, and must not be confused with it.
136
+ *
137
+ * ## What a profile does NOT do
138
+ *
139
+ * It never degrades a capability in silence. Each capability that depends on a service the profile omits
140
+ * is REFUSED at the application's boot when the application declares it, by a message naming the profile
141
+ * and the remedy (`describeServiceOmittedByEnvironmentServiceProfile`). And a declaration that would run
142
+ * an omitted service (`backingServices.clamav: { source: SELF }` under `SMALL`) is refused when the
143
+ * environment descriptor is parsed: the two statements contradict each other.
144
+ *
145
+ * ## One database family
146
+ *
147
+ * `SMALL` also runs ONE database family (`environmentServiceProfileRunsOneDatabaseFamily`): the platform's store and
148
+ * the application's are the same engine, and only that store is declared. Which engine is the author's choice (both a
149
+ * MongoDB and a PostgreSQL environment run in one family); the descriptor derives the families it runs from what it
150
+ * declares and refuses two, naming the declarations that bring each.
151
+ *
152
+ * ## Lanes
153
+ *
154
+ * Both lanes render a profile: the Docker Compose generator, and the Kubernetes manifests (workloads, the mongod
155
+ * routing parameters, secrets, persistent volumes and readiness) since #2303's second slice.
156
+ *
157
+ * ## What it does not change yet
158
+ *
159
+ * The broker. RabbitMQ stays a platform dependency under every profile: the platform scheduler publishes onto the
160
+ * application's queue from another process, and no durable queue runs on the cache or the database
161
+ * (`QueueAdapterType.MEMORY` is in-process only). Tracked by #2303.
162
+ */
163
+ export enum EnvironmentServiceProfile {
164
+ /** Every service the environment's declarations ask for. The default when nothing is authored. */
165
+ FULL = 'full',
166
+ /**
167
+ * The footprint for a small deployment: no ClamAV, no immudb, no mongot
168
+ * ({@link servicesOmittedByEnvironmentServiceProfile}). Vector search remains available on PostgreSQL
169
+ * (pgvector is part of the PostgreSQL image, not a separate service).
170
+ */
171
+ SMALL = 'small',
172
+ }
173
+
174
+ /** The profile an environment gets when it authors none. */
175
+ export const DEFAULT_ENVIRONMENT_SERVICE_PROFILE: EnvironmentServiceProfile = EnvironmentServiceProfile.FULL;
176
+
177
+ /**
178
+ * The optional services a {@link EnvironmentServiceProfile} can omit. A closed vocabulary of its own rather
179
+ * than `BackingServiceKind`, because mongot is not a backing-service kind an environment declares: it is a
180
+ * sidecar of a self-hosted MongoDB. Values are the compose service names.
181
+ */
182
+ export enum EnvironmentServiceProfileOptionalService {
183
+ /** The ClamAV daemon that scans uploaded files (`z_file({ scanPolicy: 'required' })`). */
184
+ ANTIVIRUS_SCANNER = 'clamav',
185
+ /** immudb, the tamper-evident store of the `COMPLIANCE_AUDIT_TRAIL` capability's Layer-2 fan-out. */
186
+ IMMUTABLE_AUDIT_STORE = 'immudb',
187
+ /** mongot, which serves `$search` / `$vectorSearch` for MongoDB-persisted `.ragSource()` fields. */
188
+ MONGODB_SEARCH = 'mongot',
189
+ }
190
+
191
+ /**
192
+ * The services a profile omits. Total over {@link EnvironmentServiceProfile} (a member added tomorrow fails
193
+ * the build here until somebody decides what it omits), and the ONE place the answer lives: the compose
194
+ * generator, the descriptor refinement and the application's boot refusals all read it.
195
+ */
196
+ export function servicesOmittedByEnvironmentServiceProfile(
197
+ profile: EnvironmentServiceProfile,
198
+ ): readonly EnvironmentServiceProfileOptionalService[] {
199
+ switch (profile) {
200
+ case EnvironmentServiceProfile.FULL:
201
+ return [];
202
+ case EnvironmentServiceProfile.SMALL:
203
+ return [
204
+ EnvironmentServiceProfileOptionalService.ANTIVIRUS_SCANNER,
205
+ EnvironmentServiceProfileOptionalService.IMMUTABLE_AUDIT_STORE,
206
+ EnvironmentServiceProfileOptionalService.MONGODB_SEARCH,
207
+ ];
208
+ }
209
+ }
210
+
211
+ /**
212
+ * Whether `profile` requires the environment to run ONE database family (#2303). Total over
213
+ * {@link EnvironmentServiceProfile}: a member added tomorrow fails the build until somebody decides.
214
+ */
215
+ export function environmentServiceProfileRunsOneDatabaseFamily(profile: EnvironmentServiceProfile): boolean {
216
+ switch (profile) {
217
+ case EnvironmentServiceProfile.FULL:
218
+ return false;
219
+ case EnvironmentServiceProfile.SMALL:
220
+ return true;
221
+ }
222
+ }
223
+
224
+ /** Whether `profile` omits `service`. Absent profile ⇒ {@link DEFAULT_ENVIRONMENT_SERVICE_PROFILE}. */
225
+ export function environmentServiceProfileOmits(
226
+ profile: EnvironmentServiceProfile | undefined,
227
+ service: EnvironmentServiceProfileOptionalService,
228
+ ): boolean {
229
+ return servicesOmittedByEnvironmentServiceProfile(profile ?? DEFAULT_ENVIRONMENT_SERVICE_PROFILE).includes(service);
230
+ }
231
+
232
+ /**
233
+ * The sentence every refusal caused by a profile starts with, so the CLI and the application's boot name
234
+ * the profile and the omitted service the same way. Callers append the capability-specific remedy.
235
+ */
236
+ export function describeServiceOmittedByEnvironmentServiceProfile(
237
+ profile: EnvironmentServiceProfile,
238
+ service: EnvironmentServiceProfileOptionalService,
239
+ ): string {
240
+ return `This environment runs the '${profile}' service profile (\`serviceProfile\` in wildo.infra.<env>.config.ts), `
241
+ + `which does not run ${service}.`;
242
+ }
243
+
121
244
  /**
122
245
  * Ingress controller installed by Wildo's local and remote Kubernetes workflows.
123
246
  * Import from `@wildo-ai/platform-config-lib`. Traefik owns both application
@@ -136,9 +259,8 @@ export enum WildoKubernetesIngressClass {
136
259
  * The external/public hostname (where browsers and reverse proxies hit
137
260
  * us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
138
261
  * as `publicDomain` because it applies to BOTH `KUBERNETES` and
139
- * `DOCKER_COMPOSE` runtimes. See `external-public-domain-rename.md`
140
- * for the rationale (the previous `baseDomain` field on this object
141
- * conflated K8s-internal and reverse-proxy concerns).
262
+ * `DOCKER_COMPOSE` runtimes. It replaced a `baseDomain` field on this
263
+ * object, which conflated K8s-internal and reverse-proxy concerns.
142
264
  */
143
265
  export const WildoKubernetesConfigSchema = z.object({
144
266
  namespace: z.string().min(1),
@@ -205,7 +327,7 @@ export const WildoLoggingConfigSchema = z.object({
205
327
  export type WildoLoggingConfig = z.infer<typeof WildoLoggingConfigSchema>;
206
328
 
207
329
  /**
208
- * Per-environment OTLP telemetry (traces + metrics + logs) posture (Slice 2 Phase 5).
330
+ * Per-environment OTLP telemetry (traces + metrics + logs) posture.
209
331
  *
210
332
  * `env-vars-builder` projects this block onto the standard `OTEL_*` env vars that the
211
333
  * `otel-preload.ts` SDK (in `saas-backend-lib`) reads BEFORE app code:
@@ -281,8 +403,10 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
281
403
  * Semantics (mirrors the SaaS-side selection policy):
282
404
  * - `primary` — the ref that wins for this capability in this environment.
283
405
  * - `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.
406
+ * resolution time (undeclared, disabled, unconfigured). NOT failover: a substitute is never
407
+ * asked because a call to the provider before it failed. Call-time failover is the SaaS-side
408
+ * selection's own `failover` list (#2301), which this override does not carry and does not
409
+ * replace: the application's declared failover providers stay in force under it.
286
410
  *
287
411
  * The referenced provider must still be DECLARED in
288
412
  * `providers.scopes.backend.providers` and available for the capability — the
@@ -344,8 +468,9 @@ export const WildoEnvironmentProviderConfigurationsSchema = z.record(
344
468
  z.string().min(1),
345
469
  z.record(z.string().min(1), z.record(z.string().min(1), z.unknown())),
346
470
  // Never a provider module's own keys (#2995): an environment cannot rewrite where a provider sends its credential any
347
- // more than the application can. A local double is reached through the environment-gated loopback host instead.
348
- ).superRefine(refuseModuleOwnedProviderConfigurationKeys);
471
+ // more than the application can. A local double is reached through the environment-gated loopback host instead. And
472
+ // never a key the protocol's reader does not read (#3003), the same refusal the application's own block gets.
473
+ ).superRefine(refuseUnreadProviderConfigurationValues);
349
474
  export type WildoEnvironmentProviderConfigurations = z.infer<typeof WildoEnvironmentProviderConfigurationsSchema>;
350
475
 
351
476
  /**
@@ -66,7 +66,6 @@ export const WildoHostedInfraEnvConfigSchema = z.strictObject({
66
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
67
  ),
68
68
  }, refuseHostOwnedKeys('infrastructureHost')),
69
- version: WILDO_INFRA_ENV_CONFIG_SHAPE.version,
70
69
  environment: WILDO_INFRA_ENV_CONFIG_SHAPE.environment,
71
70
  applicationDatabase: WILDO_INFRA_ENV_CONFIG_SHAPE.applicationDatabase,
72
71
  publicDomain: WILDO_INFRA_ENV_CONFIG_SHAPE.publicDomain,