@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) 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 +180 -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 +30 -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 +87 -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 +55 -8
  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 +19 -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/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -279,7 +279,17 @@ export type InboundChatActingMember = Extract<InboundChatMember, { readonly stan
279
279
  * the decision notice's job (#2664 S5b), not the click's.
280
280
  */
281
281
  export type InboundChatDecisionAnswer =
282
- | { readonly member: InboundChatActingMember; readonly outcome: HumanDecision_ActOutcome }
282
+ | {
283
+ readonly member: InboundChatActingMember;
284
+ readonly outcome: HumanDecision_ActOutcome;
285
+ /**
286
+ * #2923: where the person answers this decision instead, when a chat answer cannot settle it (it requires a step-up,
287
+ * which a chat answer cannot carry, or its kind does not admit a chat answer): the decision's address in the
288
+ * application's inbox. Present exactly then, and when the application has a public address. A handler posts it as
289
+ * the message's link (`openInApplication`), never a refusal with nowhere to go.
290
+ */
291
+ readonly openInApplicationUrl?: string;
292
+ }
283
293
  | { readonly member: Exclude<InboundChatMember, InboundChatActingMember> };
284
294
 
285
295
  /**
@@ -353,6 +363,16 @@ export enum ChatConverseRefusal {
353
363
  BUSY_TOO_LONG = 'busy_too_long',
354
364
  /** The message said nothing once the bot's mention was removed. */
355
365
  EMPTY_MESSAGE = 'empty_message',
366
+ /**
367
+ * #2750: the message alone is larger than the chat agent's model can be sent, so it was refused rather than cut. Not
368
+ * kept; a shorter message is admitted.
369
+ */
370
+ MESSAGE_TOO_LONG = 'message_too_long',
371
+ /**
372
+ * The chosen agent's system is open only to the roles it declares (`config.accessControl[].roles`), and the linked
373
+ * member holds none of them in the organization (#2544 follow-up). Not kept; an administrator can give them a role.
374
+ */
375
+ SYSTEM_ROLE_NOT_HELD = 'system_role_not_held',
356
376
  }
357
377
 
358
378
  /** What a message waits for. */
@@ -635,6 +655,23 @@ export interface InboundHandlerDefinition<P = unknown> {
635
655
  readonly dedupKey?: (delivery: VerifiedInboundDelivery) => string;
636
656
  /** Deliveries sharing a non-null key run one at a time, in receive order. */
637
657
  readonly orderingKey?: (delivery: VerifiedInboundDelivery, payload: P) => string | null;
658
+ /**
659
+ * The people this delivery's payload names (#1642): each person's email address, LOWER-CASED, or their user id in
660
+ * this application. Computed once, at receipt, from the parsed payload, and stored on the delivery (`subjectKeys`).
661
+ *
662
+ * Declare it whenever the payload can name a person (a contact, a signer, a customer). The stored body cannot be
663
+ * searched, so these keys are the only way the delivery is found for that person: when they are erased, every stored
664
+ * delivery whose keys hold their user id or their email address is DELETED inside the erasure, and an administrator
665
+ * finds the deliveries for a person through the SEARCH filter `subjectKeys`. A delivery that names someone and
666
+ * declares nothing keeps them in its payload until its retention period ends.
667
+ *
668
+ * The receiver trims each key and drops duplicates and empty ones. More than 20 keys, or a key longer than 320
669
+ * characters, cannot be stored: the delivery is refused as malformed, like a dedup key that cannot be stored.
670
+ *
671
+ * @example
672
+ * subjectKeys: (_delivery, payload) => [payload.contact.email.toLowerCase()],
673
+ */
674
+ readonly subjectKeys?: (delivery: VerifiedInboundDelivery, payload: P) => readonly string[];
638
675
  readonly scopeMode: InboundHandlerScopeMode;
639
676
  /** Required for `ORGANIZATION_REQUIRED` and `RESOLVED_PER_DELIVERY`; refused for `APPLICATION`. */
640
677
  readonly resolveScope?: (delivery: VerifiedInboundDelivery, payload: P, lookups: InboundScopeLookups) => Promise<InboundResolvedScope>;
@@ -116,14 +116,53 @@ meanwhile.
116
116
 
117
117
  ## What a stored delivery keeps
118
118
 
119
- The raw payload, which can carry personal data. A person's erasure request does not yet reach the
120
- deliveries whose payload names them; they leave with the retention period below, or with their
121
- organization.
119
+ The raw payload, which can carry personal data, and the people that payload names as the handler declared
120
+ them (`subjectKeys`).
121
+
122
+ The body is stored base64, so nothing can search it: `subjectKeys` is the only way a delivery is found for
123
+ a person. Declare it on every handler whose payload can name someone:
124
+
125
+ ```ts
126
+ import { inboundSubjectKeyForEmailAddress, inboundSubjectKeyForPhoneNumber } from '@wildo-ai/saas-models';
127
+
128
+ subjectKeys: (_delivery, payload) => [
129
+ inboundSubjectKeyForEmailAddress(payload.contact.email),
130
+ inboundSubjectKeyForPhoneNumber(payload.contact.phone ?? ''),
131
+ ].filter((key): key is string => key !== undefined),
132
+ ```
133
+
134
+ - A key is one of three things: a person's email address, LOWER-CASED (`inboundSubjectKeyForEmailAddress`);
135
+ their phone number in E.164 form with its `+`, separators removed (`inboundSubjectKeyForPhoneNumber`,
136
+ which answers `undefined` for a national number, since nothing could match it); or their user id in this
137
+ application. The receiver trims the keys and drops empty and repeated ones; more than 20, or one longer
138
+ than 320 characters, refuses the delivery as malformed (`400`), like a dedup key that cannot be stored.
139
+ - When a person with an account is erased, every stored delivery whose keys hold their user id, their email
140
+ address, or a phone number on their profile or their sign-in credentials is DELETED inside the erasure, in
141
+ both delivery tables, unless a legal hold keeps it. The erasure receipt lists the deleted delivery ids
142
+ (`row_deleted`), never the payload.
143
+ - The engine keys its own deliveries the same way: an email received through the email channel by its
144
+ sender, recipients and copied addresses (cut to 20, sender first), an email provider's notification
145
+ likewise (a pushed message, or a fetched provider's notification, which names the sender and recipients
146
+ too), and an SMS provider notification by the number of the person it is about. The SMS report the
147
+ engine records from that notification carries the same key and is deleted with it.
148
+ - A person's access export reads the deliveries naming them by the same keys; a delivery that also names
149
+ someone else is handed without its payload.
150
+ - An administrator finds a person's deliveries with the SEARCH filter `subjectKeys` (an address or a user
151
+ id), for an access request or a person who has no account here.
152
+ - For a person with NO account here (a lead, a contact, someone who only wrote or texted), the scope's
153
+ administrator erases their deliveries with the `eraseForSubjectKey` operation: the person's email address,
154
+ phone number or a key your handler declared (`identifierKind` + `identifier`), and a written
155
+ `justification`. It deletes only that scope's deliveries (the application's also deletes the SMS reports
156
+ naming the person), keeps what a legal hold covers, and answers the deleted ids. Its audit event,
157
+ `INBOUND_DELIVERY_ERASED`, names the ids and a sha256 of the key, never the key.
158
+ - A delivery whose handler declares no keys keeps whoever it names until the retention period below ends,
159
+ or until its organization is purged. Declaring keys on a handler does not reach deliveries stored before
160
+ it did.
122
161
 
123
162
  ## Audit events
124
163
 
125
164
  `INBOUND_DELIVERY_REJECTED` · `_ACCEPTED` · `_UNROUTABLE` · `_PROCESSED` · `_FAILED` (each retry) ·
126
- `_DEAD` · `_REPLAYED`. None carries the payload; the stored delivery does.
165
+ `_DEAD` · `_REPLAYED` · `_ERASED`. None carries the payload; the stored delivery does.
127
166
 
128
167
  ## How long a delivery is kept
129
168
 
@@ -9,8 +9,8 @@ message gets to it.
9
9
 
10
10
  | Step | What happens | Fails closed how |
11
11
  |---|---|---|
12
- | Notification | The provider POSTs a small signed notification to `/api/v1/webhooks/<provider>/<endpoint>`; the engine verifies it and stores it once | Unsigned or forged → `401`, nothing stored |
13
- | Fetch | The engine fetches the message, its attachments and its raw bytes from the provider | Only from the provider's declared hosts, never following a redirect |
12
+ | Notification | The provider POSTs to `/api/v1/webhooks/<provider>/<endpoint>`: a small signed notification (Resend), or the whole message, attachments included (Postmark); the engine verifies it and stores it once | Unsigned, forged or wrong credentials → `401`, nothing stored; a pushed message over 10 MB of JSON → `413`, audited |
13
+ | Fetch | A notified provider: the engine fetches the message, its attachments and its raw bytes from it. A pushing provider: the engine reads them out of the body it verified, and empties that body once the message is stored | Only from the provider's declared hosts, never following a redirect; a pushed attachment the body lacks refuses the message |
14
14
  | Route | Each recipient address is routed to ONE organization (below) | An address no rule reaches is `UNROUTABLE` and audited, never guessed |
15
15
  | Store | One `inboundEmails` row per organization the message reached | A message over the size limit is kept as its envelope only (`REJECTED_LIMIT`) |
16
16
  | Scan | Every attachment, and the raw bytes, are scanned before anything may serve them | Infected, or unscannable (no scanner configured) → withheld, with the reason |
@@ -82,7 +82,19 @@ Three declarations, all required:
82
82
 
83
83
  3. **The secrets** in each environment: the provider's API key and its webhook signing secret
84
84
  (`wildo secrets list` names them; for Resend, `RESEND_API_KEY` and `RESEND_WEBHOOK_SECRET`). Then register
85
- the notification URL with the provider for the `email.received` event.
85
+ the notification URL with the provider for the `email.received` event. For Postmark (the registry provider,
86
+ `wildo registry add wildo/providers/postmark`), the secret is `POSTMARK_INBOUND_WEBHOOK_CREDENTIAL`, a
87
+ `user-id:password` you generate, and the URL you give the Postmark server's inbound webhook carries it:
88
+ `https://<user-id>:<password>@<api host>/api/v1/webhooks/postmark/inbound-email`. Postmark receives on ONE inbound
89
+ domain per server: make it the shared domain. For Mailgun (`wildo registry add wildo/providers/mailgun`), the
90
+ secrets are `MAILGUN_API_KEY` (it also hosts organizations' domains) and `MAILGUN_WEBHOOK_SIGNING_KEY`, the
91
+ account's webhook signing key (Settings, API Security; not the API key). Create a route whose `forward()` URL is
92
+ `https://<api host>/api/v1/webhooks/mailgun/inbound-email-json`: only a URL ending in `json` makes Mailgun post the
93
+ message as JSON with its signature in headers; any other URL posts a form, which is refused (`415`).
94
+
95
+ A provider that receives on one domain for the whole application (Postmark) hosts no organization's own domain: a
96
+ `claim` is refused with `EMAIL_DOMAIN_SINGLE_INBOUND_DOMAIN`, and organizations receive at their address on the
97
+ shared domain. It also reports no SPF, DKIM or DMARC result, so its senders are identified as unverified.
86
98
 
87
99
  `email.inbound` also takes `rawMimeRetention` (`KEEP` by default: only the original bytes can be re-verified),
88
100
  `organizationSendingDomainUse` (below) and `maxMessageSizeBytes` (25 MB by default).
@@ -0,0 +1,93 @@
1
+ # The SMS channel — texts people send to the application's numbers
2
+
3
+ Read this when people should be able to text the application (booking changes, a reply to a reminder, a short
4
+ request) and the text should reach code you write, or be answered by text.
5
+
6
+ ## What reaches your handler, and what never does
7
+
8
+ The SMS provider posts every text it receives to its notification endpoint. The engine verifies it, records it
9
+ (the `smsProviderEvents` row), and reads it for the carrier keywords first:
10
+
11
+ | the text | what happens |
12
+ |---|---|
13
+ | `STOP` (and the other opt-out words), `START`/`UNSTOP`, `HELP`/`INFO` — as the WHOLE message | a CONTROL message: the opt-out list moves (or the vendor answers HELP). It never reaches a handler |
14
+ | anything else, sent to a number the application gave an organization | admitted to that organization's SMS channel handler |
15
+ | anything else, sent to any other number (the application's own sender number, a withdrawn number, a short code) | stored as an UNROUTABLE inbound delivery, audited, run by nobody |
16
+
17
+ "Stop by tomorrow?" is a message, not a STOP: only the whole message counts as a keyword.
18
+
19
+ An application that declares no SMS channel handler still receives texts: they are recorded and read for STOP and
20
+ START, nothing more.
21
+
22
+ ## Which organization a text belongs to
23
+
24
+ A text has no sub-address, so the number it was sent TO is the only thing that says whose it is. The application's
25
+ super-administrator gives each organization a number it holds at its SMS provider, as an `smsNumberAssignments` row
26
+ (`phoneNumber` in E.164 with its `+`, `assignedOrganizationId`). One number belongs to one organization.
27
+
28
+ - An organization cannot claim a number itself. Every number sits in the application's own provider account, so no
29
+ organization can prove a number is its own, and a self-claim would let one tenant take another's texts.
30
+ - The application's own sender number (`providerConfigurations.<sms provider>.SMS_PROVIDER.fromNumber`) is never
31
+ assigned: sign-in codes and notifications go out from it, and the answers to them belong to no organization.
32
+ - Withdrawing a number (DELETE) stops routing at once; the next text to it is UNROUTABLE.
33
+
34
+ ## Who sent it — the SMS ladder
35
+
36
+ | level | means |
37
+ |---|---|
38
+ | `UNVERIFIED` | nothing is known about the number |
39
+ | `KNOWN_CONTACT` | your handler's `contactResolver` recognised the number (it is asked with the number, in E.164) |
40
+ | `VERIFIED_MEMBER_NUMBER` | the number is the VERIFIED phone number of exactly one active member of the organization; `message.sender.memberUserId` names them |
41
+
42
+ Two members holding the same number identify nobody. And SMS has no sender authentication at all (caller ID can be
43
+ spoofed onto a text), so every level IDENTIFIES and none authenticates: the handler's `actingRoles` are the same for
44
+ every sender. Choose `minimumSenderAssurance` for what the handler does, exactly as for email; a text below it goes
45
+ to your `belowMinimumHandlerRef`, or is stored and audited.
46
+
47
+ **A text never authorizes anything.** Not a payment change, not an approval, not a new recipient, not a cancellation
48
+ of something that costs money — record the request and have a person confirm it through a trusted channel.
49
+
50
+ ## Routing between handlers
51
+
52
+ One handler per channel declares `isDefault: true`. Another may declare a `routeTag`: a text whose FIRST WORD is
53
+ that tag goes to it (`CANCEL my 3pm` → `routeTag: 'cancel'`), with the tag in `message.payload.routeTag`. A first
54
+ word no handler claims goes to the default. Once you declare any SMS handler, the default is required (startup
55
+ refuses otherwise), so an untagged text always has an owner.
56
+
57
+ ## Threads
58
+
59
+ A thread is one exchange between the organization's number and the person's number: the next text of the same pair
60
+ joins the newest OPEN thread, another number or a closed thread starts a new one. `message.thread` and
61
+ `ctx.thread.link` work as for email; the thread's `counterpartAddress` is the person's number. A text carries no
62
+ attachments (MMS is not received).
63
+
64
+ ## Replying by text
65
+
66
+ Declare `replyMode: InboundReplyMode.THREAD`, then:
67
+
68
+ ```ts
69
+ await ctx.reply({ text: 'Friday at 10 works. Reply STOP to stop these messages.' });
70
+ ```
71
+
72
+ - The words are yours: no template. At most 1600 characters; longer, empty or not a string is refused (VALIDATION)
73
+ and nothing is queued.
74
+ - The reply goes FROM the number the text was sent to, TO the person who texted, and only while the thread is OPEN.
75
+ - It goes through the application's SMS send, so a number that replied STOP is never texted: the reply settles
76
+ FAILED with `recipient_opted_out`.
77
+ - Calling `ctx.reply` twice with the same text in one delivery queues one reply.
78
+ - A text reply is sent AT MOST ONCE. SMS vendors take no idempotency key, so a send whose answer was lost is never
79
+ retried (it would text twice): the reply row settles FAILED, `InboundReplySmsOutcomeUnknown`, and the operator sees
80
+ that the text may or may not have gone.
81
+ - A reply answers the person's own message. It does not imply consent to any other text: notifications still need
82
+ their recorded SMS consent.
83
+
84
+ ## Enabling it
85
+
86
+ 1. The SMS capability with a provider that declares a notification half (Twilio; Telnyx, `provider-telnyx`), on
87
+ the backend scope with `SMS_PROVIDER` and `WEBHOOK_ORIGINATOR`, its notification endpoint enabled, and the public
88
+ API URL set so the provider can reach it. Without the endpoint served, an SMS channel handler refuses startup.
89
+ 2. Give each organization its number: Settings → Administration → SMS numbers (the `application-sms-numbers`
90
+ destination, shown where the SMS capability is enabled), or `POST` on `smsNumberAssignments` — both as the
91
+ application's super-administrator.
92
+ 3. Declare the handler with `defineInboundChannelHandler`, `source: { kind: InboundSourceKind.CHANNEL, channel:
93
+ InboundChannelKind.SMS, isDefault: true }`, and list it in the module's `inboundHandlers`.
@@ -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`, which `wildo local dev` starts on that port with that key; without a service
491
+ * answering there, the guarded agents answer that their content could not be screened or checked.
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
@@ -922,6 +964,29 @@ provider.
922
964
 
923
965
  Read `references/framework-platform-key-management-api.md` for the source-backed contract and the policies.
924
966
 
967
+ ## Agents in an environment without a content classifier
968
+
969
+ An agent that declares `contentGuardrails.promptInjection` or `.outputModeration` refuses every turn in an environment
970
+ where no classifier for that guardrail is present: no `AI_CONTENT_SAFETY` provider is declared, the selected one does
971
+ not offer it (`openai-moderation` does not screen), or its credentials are not authored in that environment's
972
+ `secrets.json → providerEnv`. The classifier is declared once for the application, so leaving its key out of staging is
973
+ how staging runs without it while production has it. To run the agent there anyway, on purpose, the environment says
974
+ so, with why:
975
+
976
+ ```ts
977
+ agentContentGuardrails: {
978
+ withoutClassifier: AgentContentGuardrailsWithoutClassifier.RUN_UNGUARDED, // from '@wildo-ai/saas-models'
979
+ reason: 'Staging has no Azure Content Safety key; production authors one.',
980
+ },
981
+ ```
982
+
983
+ Read `references/framework-agent-content-guardrails-environment-api.md` for the contract. It waives only a guardrail no
984
+ classifier is present for: a classifier that is there and cannot be used (declared and not loaded, a category it does
985
+ not assess) still refuses the turn, and one that fails at call time (a key set and refused, an outage) still withholds
986
+ the output. The backend names each agent it runs unguarded at startup, `wildo local doctor` reports the environment as
987
+ running it unguarded, and outside a local environment `wildo context launch-blockers` lists it. The guardrails
988
+ themselves are the `flows-actors-chat-assistant` skill's.
989
+
925
990
  ## Running on another application's infrastructure
926
991
 
927
992
  Several applications can share one environment's platform. One application OWNS the
@@ -961,6 +1026,7 @@ Read `references/framework-infrastructure-host-api.md` for the source-backed con
961
1026
  ## References
962
1027
 
963
1028
  - `references/framework-infrastructure-host-api.md` — source-backed `infrastructureHost` / hosted descriptor contract
1029
+ - `references/framework-agent-content-guardrails-environment-api.md` — source-backed `agentContentGuardrails`: what the environment does with agents' classifier-backed guardrails when no classifier is selected
964
1030
  - `references/framework-platform-key-management-api.md` — source-backed `platformKeyManagement` contract, the Vault policies and the cloud KMS grants
965
1031
  - `references/framework-application-database-api.md` — source-backed `applicationDatabase` contract
966
1032
 
@@ -976,6 +1042,7 @@ Read `references/framework-infrastructure-host-api.md` for the source-backed con
976
1042
  - [ ] Every backing service the app uses is declared with a valid `source`
977
1043
  - [ ] 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
1044
  - [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
1045
+ - [ ] 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
1046
  - [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
980
1047
  - [ ] 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
1048
  - [ ] Local `devCompanion` is optional; remote environments declare `runtimeEnvironment`; remote Kubernetes also requires `remoteProvider`; optional `deployment` matches the chosen workflow
@@ -995,6 +1062,7 @@ Run from the app root, substituting `<env>`:
995
1062
  | Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
996
1063
  | 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
1064
  | 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` |
1065
+ | 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
1066
  | **No secrets** in infra file (must be empty) | see the commands below the table |
999
1067
  | Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
1000
1068
  | Optional local companion binding is deliberate | Inspect `devCompanion` when present; omission is schema-valid. |
@@ -1032,6 +1100,10 @@ runtime/source enums. Keep secret values outside authored infrastructure.
1032
1100
  - `source: BackingServiceSource.MANAGED` on anything but `mongodb`
1033
1101
  with `provider: 'atlas'` (catch with the **Every `MANAGED`
1034
1102
  declaration is MongoDB Atlas** grep above)
1103
+ - `serviceProfile: SMALL` on an environment whose application requires
1104
+ file scanning, enables `COMPLIANCE_AUDIT_TRAIL` with no external
1105
+ audit store, or keeps `.ragSource()` fields on MongoDB (the backend
1106
+ refuses to start; catch with the **reduced service profile** grep)
1035
1107
  - `devCompanion` declared in a remote config (the field is local-only;
1036
1108
  the typed factory may accept it but the companion won't bind correctly)
1037
1109
  - `remoteProvider` or `deployment` declared in a local config (same