@wildo-ai/framework-knowledge 1.1.5 → 1.1.7

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 (837) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +321 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  338. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  339. package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
  340. package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
  341. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  342. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  343. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  344. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  345. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  346. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  347. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  348. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  349. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  354. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  355. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  356. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  357. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  358. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  359. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  360. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  361. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  362. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  363. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  364. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
  365. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  366. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  367. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  368. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  369. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  370. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  371. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  372. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  373. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  374. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  375. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  376. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  377. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  378. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  379. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  380. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  382. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  383. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  384. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  385. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  386. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  387. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  388. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  389. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  390. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  391. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  392. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  393. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  394. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  395. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  396. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  397. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  398. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  399. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  400. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  401. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  406. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  407. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  408. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  409. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  410. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  411. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  412. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  413. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  414. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  415. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  416. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  417. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  418. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  419. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  420. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  421. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  422. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  426. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  427. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  428. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  431. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  432. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  433. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  435. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  437. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  438. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  439. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  440. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  441. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  442. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  443. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  445. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  446. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  448. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  450. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  451. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  452. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  453. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  454. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  455. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  460. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  461. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  462. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  463. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  464. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  466. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  467. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  468. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  469. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  470. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  471. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  472. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  473. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  474. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  475. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  476. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  477. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  478. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  479. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  480. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  481. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  482. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  483. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  484. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  485. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  486. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  487. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  488. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  489. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  490. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  491. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  492. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  493. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  494. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  495. package/dist/knowledge/references/website-plan.config.md +39 -6
  496. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  497. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  498. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  500. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  501. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  502. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  503. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  504. package/dist/knowledge/references/zod.factories.address.md +7 -7
  505. package/dist/knowledge/references/zod.factories.code.md +2 -2
  506. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  507. package/dist/knowledge/references/zod.factories.money.md +3 -3
  508. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  509. package/dist/knowledge/registries/framework-topics.json +1248 -54
  510. package/dist/knowledge/registries/playbooks.json +81 -109
  511. package/dist/knowledge/registries/source-tags.json +3201 -1118
  512. package/dist/knowledge/rules/live-context-door.md +29 -0
  513. package/dist/knowledge/skills/INDEX.md +27 -24
  514. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  522. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  526. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  528. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  529. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  530. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  531. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  532. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  533. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  540. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  541. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  543. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
  544. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  545. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  546. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  547. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  551. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  552. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  553. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  554. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  555. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  556. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  557. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  558. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  559. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  560. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  561. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  562. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  564. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  565. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  566. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  568. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  569. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  570. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  571. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  572. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  573. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  574. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  575. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  576. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  577. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  578. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  579. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  581. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  582. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  587. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  595. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  596. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  599. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  600. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  602. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  604. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  605. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  607. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  608. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  609. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  612. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  613. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  614. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  615. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  616. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  617. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  624. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
  625. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  626. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  627. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  628. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  629. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  630. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  631. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  632. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  633. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  634. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  635. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  636. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  637. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  638. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  639. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  640. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  642. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  644. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  645. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  646. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  647. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  648. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  649. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  650. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  651. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  652. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  653. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  657. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  658. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  659. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  660. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  661. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  662. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  663. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  664. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  665. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  666. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  667. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  670. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  671. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  672. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  677. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  678. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  682. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  683. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  684. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  685. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  686. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  687. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  688. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  693. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  694. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  695. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  696. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  697. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  698. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  699. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  700. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  701. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  702. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  703. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  710. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  711. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  712. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  713. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  714. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  715. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  716. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  717. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  718. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  719. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  720. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  721. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  722. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  723. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  724. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  725. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  726. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  727. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  728. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  729. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  730. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  731. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  732. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  733. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  734. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  739. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  740. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  741. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  742. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  743. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  747. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  748. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  749. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  755. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  756. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  757. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  758. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  759. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  763. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  764. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  765. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  766. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  767. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  768. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  769. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  770. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  771. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  773. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  774. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  775. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  776. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  777. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  778. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  779. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  780. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  781. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  782. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  783. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  784. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  785. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  786. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  787. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  788. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  789. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  790. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  791. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  792. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  793. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  794. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  795. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  796. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  797. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  798. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  799. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  800. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  801. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  802. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  803. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  804. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  805. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  807. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  809. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  811. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  813. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  815. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  817. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  819. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  820. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  821. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  822. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  823. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  824. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  825. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  826. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  827. package/dist/knowledge/topic-index.json +5957 -1729
  828. package/dist/tsconfig.build.tsbuildinfo +1 -1
  829. package/dist/tsconfig.tsbuildinfo +1 -1
  830. package/package.json +4 -4
  831. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  832. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  833. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  834. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  835. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  836. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  837. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,297 @@
1
+ # Receiving email — addresses, domains and what arrives
2
+
3
+ Read this when an application must RECEIVE email: configuring the receiving provider, deciding which
4
+ addresses reach which organization, letting an organization use its own domain, or reading what a stored
5
+ message carries. `email-channel.md` is about what a handler does with a message; this is about how the
6
+ message gets to it.
7
+
8
+ ## What the engine does before your handler runs
9
+
10
+ | Step | What happens | Fails closed how |
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 |
14
+ | Route | Each recipient address is routed to ONE organization (below) | An address no rule reaches is `UNROUTABLE` and audited, never guessed |
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
+ | Scan | Every attachment, and the raw bytes, are scanned before anything may serve them | Infected, or unscannable (no scanner configured) → withheld, with the reason |
17
+ | Admit | The message joins its thread and reaches the handler if the sender meets its minimum | Below the minimum → stored and audited (`email-channel.md`) |
18
+
19
+ ## Which address reaches which organization
20
+
21
+ Routing reads the ENVELOPE recipients, never what the sender wrote in the body, and tries four rules in
22
+ order. The first that matches decides; nothing falls through to a guess.
23
+
24
+ | Route kind | Address | Reaches |
25
+ |---|---|---|
26
+ | `REPLY_TOKEN` | `{local}+r-{token}@{domain}` — the Reply-To of an answer your application sent | The thread the token was issued for. The rest of the address must route to the SAME organization the token belongs to, or the message is unroutable. |
27
+ | `CLIENT_MAILBOX` | an exact address a firm keeps on its own domain for a client it serves | The CLIENT organization, only while its service-provider relationship with the firm is ACTIVE, re-checked on every message |
28
+ | `ORGANIZATION_DOMAIN` | any address on an organization's VERIFIED receiving domain | That organization; `local+tag` carries `tag` as the route tag |
29
+ | `SHARED_DOMAIN` | `{slug}[+tag]@{sharedDomain}` | The organization with that slug — the address every organization has with no setup |
30
+
31
+ A slug once held by a DELETED organization is tombstoned: `{slug}@{sharedDomain}` never reaches a later
32
+ organization that reuses it, which answers at `{slug}.{shortOrgId}` instead (the last eight characters of its
33
+ id). So mail written to the old organization can never land in the new one.
34
+
35
+ ## Configuring receiving
36
+
37
+ Three declarations, all required:
38
+
39
+ 1. **The capability and the provider** in `wildo.saas.config.ts`: enable `EngineCapability.EMAIL_INBOUND`,
40
+ declare it on the provider's BACKEND scope with both receiving protocols, and select it. The provider's
41
+ sending protocol can stay beside it:
42
+
43
+
44
+ ## Usage Example
45
+
46
+ ```typescript
47
+ // Resend both sends and RECEIVES (#1600). Receiving needs two protocols: EMAIL_INBOUND_PROVIDER, how the
48
+ // engine fetches a message, its attachments and its raw bytes and manages an organization's domains; and
49
+ // WEBHOOK_ORIGINATOR, which mounts `POST /api/v1/webhooks/resend/inbound-email` — Resend's
50
+ // `email.received` notification, Svix-signed with `RESEND_WEBHOOK_SECRET`.
51
+ resend: {
52
+ engineCapabilities: [EngineCapability.EMAIL_TRANSACTIONAL, EngineCapability.EMAIL_INBOUND],
53
+ providerCapabilities: ['EMAIL_TRANSACTIONAL', 'EMAIL_INBOUND'],
54
+ protocols: ['EMAIL_PROVIDER', 'EMAIL_INBOUND_PROVIDER', 'WEBHOOK_ORIGINATOR'],
55
+ },
56
+ ```
57
+
58
+ 2. **The shared domain** in `backend-api/src/saas-config.backend.ts` (`email.inbound`). Its MX record points at
59
+ the receiving provider. Leave it out and only organization domains and client mailboxes receive mail:
60
+
61
+
62
+ ## Usage Example
63
+
64
+ ```typescript
65
+ // Receiving email (#1600). Every organization is reachable at `{slug}@{sharedDomain}` with no setup; an
66
+ // organization may add its own domain (Settings → Email domains) and client mailboxes on it. The shared
67
+ // domain's MX points at the receiving provider (`EMAIL_INBOUND` is selected in `wildo.saas.config.ts`).
68
+ // `.test` locally: the fake-provider lane stands in for the provider, so nothing here is a real address.
69
+ inbound: {
70
+ sharedDomain: 'inbox.your-app.test',
71
+ },
72
+ ```
73
+
74
+ 3. **The secrets** in each environment: the provider's API key and its webhook signing secret
75
+ (`wildo secrets list` names them; for Resend, `RESEND_API_KEY` and `RESEND_WEBHOOK_SECRET`). Then register
76
+ the notification URL with the provider for the `email.received` event.
77
+
78
+ `email.inbound` also takes `rawMimeRetention` (`KEEP` by default: only the original bytes can be re-verified),
79
+ `organizationSendingDomainUse` (below) and `maxMessageSizeBytes` (25 MB by default).
80
+
81
+ ## An organization's own domain
82
+
83
+ An organization administrator adds `inbox.firm.example` in four steps, each an operation on
84
+ `organizationEmailDomains`:
85
+
86
+ 1. **`claim`** returns the DNS TXT record to publish at `_wildo-verification.{domain}`. Nothing is created
87
+ at the provider yet. A pending claim is inert: it routes nothing and blocks nobody, and several
88
+ organizations may claim the same name. The application's own domains cannot be claimed (the shared
89
+ domain, and the domain of `email.from`).
90
+ 2. **`verify_ownership`** — the engine reads the TXT record from public DNS. The FIRST organization to prove
91
+ ownership wins; only then is the domain created at the provider, and every other claim is refused from then
92
+ on. The row now lists the provider's DNS records (MX, DKIM, …) to publish.
93
+ 3. **`verify`** — asks the provider to check those records. The provider answers asynchronously, so this may
94
+ stay `PROVIDER_PENDING` for a while; a scheduled re-check settles it.
95
+ 4. **`VERIFIED`** — the domain receives, and (when claimed for sending) sends the organization's thread replies.
96
+
97
+ If the ownership record or the provider's records disappear, the re-check (or the next `verify`) SUSPENDS the
98
+ domain: mail stops routing and sending stops at once. **`remove`** deletes the domain at the provider and then
99
+ the row; deleting the organization does the same for every domain it held.
100
+
101
+ ## Client mailboxes on a firm's domain
102
+
103
+ A firm that serves clients (a service-provider relationship, `service-provider-relationships`) can give each
104
+ client an address on the FIRM's domain. The firm's administrator creates a `clientMailboxes` row
105
+ (`acme@inbox.firm.example`) that names its own verified receiving domain and the relationship. The row belongs
106
+ to the firm, because the domain owner decides what each of its addresses does, and a client can create none.
107
+ Mail to the address reaches the client's organization, never the firm's. It stops the moment the client suspends
108
+ or ends the relationship. Creating and removing a mailbox is recorded in both organizations' audit trails.
109
+
110
+ ## The answer's From
111
+
112
+ A handler's answer (`ctx.reply`) leaves the way the thread arrived, so the sender's mail program keeps it in
113
+ the conversation:
114
+
115
+ | The thread arrived by | The answer is from | Its Reply-To (with the token) |
116
+ |---|---|---|
117
+ | the shared domain | `{slug}@{sharedDomain}` | `{slug}+r-{token}@{sharedDomain}` |
118
+ | an organization domain | the same local part on the organization's VERIFIED sending domain (the arrival domain when it sends) | on the arrival domain |
119
+ | a client mailbox | the mailbox, while its relationship is still ACTIVE | on the mailbox's address |
120
+
121
+ When none applies — the domain stopped routing, the relationship ended — the answer falls back to the shared
122
+ address, or to the application's configured sender when there is no shared domain.
123
+
124
+ `organizationSendingDomainUse: ALL_ORGANIZATION_MAIL` extends an organization's verified sending domain to all
125
+ of its mail, not only thread replies. A domain claimed but not verified is never used as a sender.
126
+
127
+ If DNS cannot be asked (a timeout or an unreachable resolver), nothing changes: `verify_ownership` and `verify`
128
+ answer 502, and the re-check tries again on its next run. Only an answer that the record does not exist suspends
129
+ a domain.
130
+
131
+ ## What a stored message carries
132
+
133
+ `inboundEmails` holds the addressing, the subject, the text and the HTML, the kept headers, the authentication
134
+ verdicts and the sender assurance, the route kind and tag, the attachments with what the sender declared, the ones
135
+ withheld with their reason, and the raw MIME's SHA-256. The HTML is rendered with `StringDisplayMode.UNTRUSTED_HTML`:
136
+ in a sandboxed frame that runs nothing and loads nothing remote. The CLEAN files are LINKED to the message
137
+ (`attachmentFiles`, `rawMimeFile`). That keeps them for the message's retention, serves them to whoever may read the
138
+ message through the ordinary file routes, and erases them when the message is impersonalized. A withheld file is
139
+ never linked, and never served.
140
+ Members of the organization can read it; nobody can edit it. It is business correspondence, kept for the
141
+ `BUSINESS_RECORDS` period from the end of its calendar year, and its personal content is impersonalized — not
142
+ deleted — when its subject is erased.
143
+
144
+ ## Worked example
145
+
146
+ A task application turns an email into a todo. The default address creates it in the list the tag names and answers
147
+ on the thread; `+screened` hands a sender whose domain failed DMARC to a handler that files it as an
148
+ unconfirmed todo and never answers; a follow-up on a linked thread becomes a checklist line on the SAME todo:
149
+
150
+
151
+ ## Usage Example
152
+
153
+ ```typescript
154
+ /** The template the answer is rendered from — `emails/resources/todos/email-intake.received/`. */
155
+ export const TODO_EMAIL_RECEIVED_TEMPLATE_REF = 'email.todos.email-intake.received';
156
+
157
+ /** The route tag of the screened address, `acme+screened@…`. */
158
+ export const TODO_EMAIL_SCREENED_ROUTE_TAG = 'screened';
159
+
160
+ const EMAIL_INTAKE_REF = inboundHandlerRef('todos.email-intake');
161
+ const EMAIL_SCREENED_REF = inboundHandlerRef('todos.email-screened');
162
+ const EMAIL_SCREENING_REF = inboundHandlerRef('todos.email-screening');
163
+
164
+ /** The most a todo title may hold (`Todos.title` is 1–200 characters). */
165
+ const TITLE_MAX = 200;
166
+ /** The most a todo description may hold. */
167
+ const DESCRIPTION_MAX = 1000;
168
+ /** The most a checklist line may hold. */
169
+ const CHECKLIST_LABEL_MAX = 200;
170
+
171
+ /** Where the todo goes: the list the tag names, else one of the organization's active lists. */
172
+ async function resolveTargetList(ctx: InboundChannelHandlerContextBase, routeTag: string | undefined): Promise<TodoLists> {
173
+ if (routeTag && routeTag !== TODO_EMAIL_SCREENED_ROUTE_TAG) {
174
+ const named = await ctx.resources.read<TodoLists>(TasksManager_ResourceType.TODO_LISTS, routeTag);
175
+ if (named?.status !== TodoLists_Status.ACTIVE) {
176
+ throw Object.assign(new Error('The address names no active todo list of this organization'), { name: 'TodoListNotAcceptingTodos' });
177
+ }
178
+ return named;
179
+ }
180
+ const page = await ctx.resources.list<TodoLists>(TasksManager_ResourceType.TODO_LISTS, { status: TodoLists_Status.ACTIVE }, { page: 1, limit: 1 });
181
+ const first = (Array.isArray(page) ? page : page.data)[0];
182
+ if (!first) throw Object.assign(new Error('The organization has no active todo list'), { name: 'TodoListNotAcceptingTodos' });
183
+ return first;
184
+ }
185
+
186
+ /** The message's own words, and what it carried: kept on the todo so whoever opens it sees the request. */
187
+ function describeMessage(message: InboundMessage<InboundChannelKind.EMAIL>, unconfirmedSender: boolean): string {
188
+ const lines = [
189
+ unconfirmedSender ? `From ${message.sender.address} (sender NOT confirmed — its domain did not pass DMARC)` : `From ${message.sender.address}`,
190
+ '',
191
+ (message.strippedReply ?? message.text).trim(),
192
+ ];
193
+ if (message.attachments.length > 0) lines.push('', `Attachments: ${message.attachments.map((attachment) => attachment.filename).join(', ')}`);
194
+ if (message.withheldAttachments.length > 0) {
195
+ lines.push('', `Withheld: ${message.withheldAttachments.map((withheld) => `${withheld.filename} (${withheld.reason})`).join(', ')}`);
196
+ }
197
+ return lines.join('\n').slice(0, DESCRIPTION_MAX);
198
+ }
199
+
200
+ /** Create the todo for one delivery, once. Returns its id, whether this run created it or an earlier one did. */
201
+ async function createTodoOnce(ctx: InboundChannelHandlerContextBase, list: TodoLists, message: InboundMessage<InboundChannelKind.EMAIL>, unconfirmedSender: boolean): Promise<string> {
202
+ const externalRef = `email:${ctx.delivery.id}`;
203
+ try {
204
+ const created = await ctx.resources.create<Todos>(TasksManager_ResourceType.TODOS, {
205
+ todoListId: list._id,
206
+ title: (message.payload.subject.trim() || '(no subject)').slice(0, TITLE_MAX),
207
+ description: describeMessage(message, unconfirmedSender),
208
+ externalRef,
209
+ // The schema-family discriminator: a `.default()` alone does not select a union branch.
210
+ recurringType: Todos_RecurrenceType.ONE_TIME,
211
+ ...(unconfirmedSender ? { tags: ['unconfirmed-sender'] } : {}),
212
+ });
213
+ return created._id;
214
+ } catch (error) {
215
+ // `externalRef` is the only unique field on a todo, so a CONFLICT means this delivery already created it.
216
+ if (!(isWildoBackendError(error) && error.type === ErrorType.CONFLICT)) throw error;
217
+ const page = await ctx.resources.list<Todos>(TasksManager_ResourceType.TODOS, { externalRef }, { page: 1, limit: 1 });
218
+ const existing = (Array.isArray(page) ? page : page.data)[0];
219
+ if (!existing) throw error;
220
+ return existing._id;
221
+ }
222
+ }
223
+
224
+ /** A follow-up on a linked thread becomes one checklist line on its todo, once per delivery. */
225
+ async function addFollowUpOnce(ctx: InboundChannelHandlerContextBase, todoId: string, message: InboundMessage<InboundChannelKind.EMAIL>): Promise<void> {
226
+ const todo = await ctx.resources.read<Todos>(TasksManager_ResourceType.TODOS, todoId);
227
+ if (!todo) throw Object.assign(new Error('The todo this thread is about no longer exists'), { name: 'TodoNotFound' });
228
+ const marker = `[${ctx.delivery.id}]`;
229
+ const checklist = todo.checklist ?? [];
230
+ if (checklist.some((item) => item.label.endsWith(marker))) return;
231
+ const words = (message.strippedReply ?? message.text).trim().replace(/\s+/g, ' ');
232
+ const label = `${message.sender.address}: ${words}`.slice(0, CHECKLIST_LABEL_MAX - marker.length - 1);
233
+ await ctx.resources.update(TasksManager_ResourceType.TODOS, todoId, { checklist: [...checklist, { label: `${label} ${marker}`, done: false }] });
234
+ }
235
+
236
+ /**
237
+ * What both answering handlers do: a message on a thread already linked to a todo is a follow-up; any other
238
+ * becomes a new todo, the thread is linked to it, and the sender is answered.
239
+ */
240
+ async function intake(
241
+ ctx: InboundChannelHandlerContext<InboundReplyMode.THREAD>,
242
+ message: InboundMessage<InboundChannelKind.EMAIL>,
243
+ ): Promise<void> {
244
+ const linked = message.thread.linkedResource;
245
+ if (linked?.resourceType === TasksManager_ResourceType.TODOS) {
246
+ await addFollowUpOnce(ctx, linked.resourceId, message);
247
+ return;
248
+ }
249
+ const list = await resolveTargetList(ctx, message.payload.routeTag);
250
+ const todoId = await createTodoOnce(ctx, list, message, false);
251
+ await ctx.thread.link({ resourceType: TasksManager_ResourceType.TODOS, resourceId: todoId });
252
+ await ctx.reply({
253
+ templateRef: TODO_EMAIL_RECEIVED_TEMPLATE_REF,
254
+ variables: { todoTitle: message.payload.subject, todoListName: list.name, attachmentCount: message.attachments.length },
255
+ });
256
+ }
257
+
258
+ /** The organization's address: every message no tag claims. */
259
+ export const todoEmailIntakeHandler = defineInboundChannelHandler({
260
+ ref: EMAIL_INTAKE_REF,
261
+ source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL, isDefault: true },
262
+ replyMode: InboundReplyMode.THREAD,
263
+ // Only a sender whose domain passes DMARC creates work here. Below that the message is stored and audited
264
+ // and dispatched to nobody: this address has no below-minimum handler.
265
+ minimumSenderAssurance: InboundSenderAssurance.DOMAIN_ALIGNED,
266
+ // The whole authority of the handler, whoever the sender is: what a member creating a todo has.
267
+ actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
268
+ handle: (ctx, message) => intake(ctx, message),
269
+ });
270
+
271
+ /** `+screened`: the same intake, with a place for what it turns away. */
272
+ export const todoEmailScreenedHandler = defineInboundChannelHandler({
273
+ ref: EMAIL_SCREENED_REF,
274
+ source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL, routeTag: TODO_EMAIL_SCREENED_ROUTE_TAG },
275
+ replyMode: InboundReplyMode.THREAD,
276
+ minimumSenderAssurance: InboundSenderAssurance.DOMAIN_ALIGNED,
277
+ belowMinimumHandlerRef: EMAIL_SCREENING_REF,
278
+ actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
279
+ handle: (ctx, message) => intake(ctx, message),
280
+ });
281
+
282
+ /**
283
+ * What `+screened` turns away: filed as a todo tagged `unconfirmed-sender`, and never answered. It has neither
284
+ * a tag nor the default, so no address reaches it directly.
285
+ */
286
+ export const todoEmailScreeningHandler = defineInboundChannelHandler({
287
+ ref: EMAIL_SCREENING_REF,
288
+ source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL },
289
+ replyMode: InboundReplyMode.NONE,
290
+ minimumSenderAssurance: InboundSenderAssurance.UNVERIFIED,
291
+ actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
292
+ handle: async (ctx, message) => {
293
+ const list = await resolveTargetList(ctx, undefined);
294
+ await createTodoOnce(ctx, list, message, true);
295
+ },
296
+ });
297
+ ```
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: infra-environment-config
3
3
  description: Edit infrastructure environment configuration for local and deployed targets — the typed `defineInfraEnvConfig({...})` files declaring `environment`, `runtime`, `publicDomain` (required external hostname), `serviceAuth`, `backingServices` (the `BackingServiceKind` map, each with `BackingServiceSource.SELF | MANAGED` plus an orthogonal `provider: '<brand>'`, e.g. `provider: 'atlas'` for MongoDB Atlas), `logging`, `devCompanion`, `kubernetes` (namespace, optional ingressClass and per-service replica settings), and (for remote) `remoteProvider` + `deployment`. Use when the user says "wire up a new external service endpoint", "rotate the staging mongodb to Atlas", "fix the local docker-compose port collision", "add a new environment", "the dev stack can't reach Redis", "where do audit logs get stored", "config sync warns my env has no audit store", or any change that adjusts environment-specific infrastructure wiring.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Infra Environment Config
@@ -111,8 +112,9 @@ export. The typed shape carries:
111
112
  kind list and per-kind entry shape** — it is extracted from the
112
113
  schema, so unlike a prose list it cannot drift as kinds are added.
113
114
  Each entry carries `source: BackingServiceSource.SELF | MANAGED`
114
- plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'aws-rds'`,
115
- `'minio'`) and per-source connection params. The legacy
115
+ plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'minio'`)
116
+ and per-source connection params — but only the combinations listed in
117
+ "What each kind can be declared as today" below are accepted. The legacy
116
118
  `BackingServiceSource.ATLAS` value no longer exists — it was
117
119
  replaced by the two-axis `(source, provider?)` shape, so Atlas is
118
120
  now `source: MANAGED, provider: 'atlas'`
@@ -275,18 +277,20 @@ export default defineInfraEnvConfig({
275
277
 
276
278
  /**
277
279
  * The PLATFORM's own store (apps-manager + module-registry: users, organizations, applications,
278
- * sessions, API keys). Declared rather than inferred — the backing-service derivation resolves
279
- * `postgresql && mongodb` to MongoDB, so this dual-store state cannot be expressed any other way.
280
+ * sessions, API keys). Declared rather than inferred: it is the selection, and
281
+ * `backingServices.postgresql` below is the substrate.
280
282
  *
281
- * MongoDB below is no longer REQUIRED by the platform (2026-08-28): the six `persistenceAdapter:
282
- * MONGODB` bootstrap pins retired, crontabs-batches-manager was ported, and apps-manager's
283
- * `MONGO_CONNECT_URL` became engine-conditional — so neither `defineInfraEnvConfig` nor
284
- * `env-vars-builder` refuses this block without it any more.
283
+ * The platform has not REQUIRED a MongoDB since 2026-08-28: the six `persistenceAdapter: MONGODB`
284
+ * bootstrap pins retired, crontabs-batches-manager was ported, and apps-manager's
285
+ * `MONGO_CONNECT_URL` became engine-conditional.
285
286
  *
286
- * It is kept here DELIBERATELY, and the reason is now an application one rather than a platform
287
- * one: this environment also runs mongot beside it, and any Mongo-backed application hosted on
288
- * this platform lives in that server. Removing it is a decision about what this environment hosts,
289
- * not a box the framework still ticks for you.
287
+ * `backingServices.mongodb` was REMOVED 2026-09-24, by decision: this environment hosts no Mongo-backed application (Wonder
288
+ * Todos, Wonder CRM and every scratch application declare `applicationDatabase: POSTGRESQL`; RAG
289
+ * lives in pgvector). The block used to be kept "for any Mongo-backed application hosted here",
290
+ * and that hosting cost the whole platform on the day its mongod's WiredTiger journal corrupted:
291
+ * apps-manager, module-registry and the companion all died on `ECONNRESET` while every platform
292
+ * row sat in PostgreSQL. A future Mongo-backed application re-declares `backingServices.mongodb`
293
+ * (which also brings mongot back).
290
294
  */
291
295
  database: { engine: DatabaseEngine.POSTGRESQL, source: BackingServiceSource.SELF },
292
296
 
@@ -304,12 +308,6 @@ export default defineInfraEnvConfig({
304
308
  applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
305
309
 
306
310
  backingServices: {
307
- mongodb: {
308
- source: BackingServiceSource.SELF,
309
- database: 'your-app-db',
310
- host: 'localhost',
311
- port: 27017,
312
- },
313
311
  redis: {
314
312
  source: BackingServiceSource.SELF,
315
313
  host: 'localhost',
@@ -323,25 +321,13 @@ export default defineInfraEnvConfig({
323
321
  vhost: 'your-app',
324
322
  },
325
323
  /**
326
- * Self-hosted PostgreSQL, declared ALONGSIDE MongoDB rather than instead of it.
324
+ * Self-hosted PostgreSQL: the only data store this environment runs, for the platform and for
325
+ * every hosted application alike.
327
326
  *
328
327
  * This names the APPLICATION's own database, and is distinct from the PLATFORM's engine
329
328
  * declared by `database` above. The two are separate axes: `database.engine` decides where the
330
329
  * platform's own tables live, while an application's resources move only when that
331
330
  * application's backend selects `DATABASE_DEFAULT_ADAPTER`.
332
- *
333
- * ⚠️ CORRECTED 2026-08-19. This comment used to warn that flipping `database.engine` to
334
- * PostgreSQL "would delete MongoDB from the rendered compose file and take the whole platform
335
- * down with it", and instructed authors to declare PostgreSQL only here. That exclusivity was
336
- * real when written — `needsLocalMongoDB` was `engine === MONGODB && source === SELF` — and it
337
- * is now gone: `database.engine` IS PostgreSQL on line 36, and `defineInfraEnvConfig`'s
338
- * superRefine used to REQUIRE `backingServices.mongodb: SELF` whenever the engine is PostgreSQL.
339
- * It no longer does (2026-08-28): the six bootstrap resources that were pinned to MongoDB
340
- * (`wildoApplication`, `wildoApplicationConfig`, `wildoApplicationSecrets`,
341
- * `platformApplications`, `platformApplicationsConfig`, `platformApplicationsSecrets`) had their
342
- * pins retired on 2026-08-22 and now follow the platform's configured engine like every other
343
- * platform resource. Both stores are still declared above and both are still rendered — by
344
- * choice now, not by obligation.
345
331
  */
346
332
  postgresql: {
347
333
  source: BackingServiceSource.SELF,
@@ -622,14 +608,12 @@ What earns its place:
622
608
  app's enabled engine capabilities depend on (see "Capability-driven
623
609
  backing services" below). Each entry carries `source: BackingServiceSource.SELF`
624
610
  (locally hosted by docker-compose) plus per-source connection
625
- params (host, port, vhost, bucket, endpoint). Remote configs swap
626
- to `source: BackingServiceSource.MANAGED` for cloud-provider-managed
627
- services, with the brand recorded separately as `provider: '<brand>'`
628
- (e.g. `provider: 'atlas'` for MongoDB Atlas, `provider: 'aws-rds'` /
629
- `'gcp-cloud-sql'` / `'supabase'` / `'neon'` / `'render'` /
630
- `'azure-database'` for Postgres). The pre-Slice-4.B.0 `BackingServiceSource.ATLAS`
631
- enum value was removed on 2026-05-07 — Atlas is a brand under the
632
- managed source, not its own source axis.
611
+ params (host, port, vhost, bucket, endpoint). A remote config may
612
+ swap to `source: BackingServiceSource.MANAGED` only where the platform
613
+ serves it — today that is MongoDB Atlas alone (`provider: 'atlas'`);
614
+ see "What each kind can be declared as today". The pre-Slice-4.B.0
615
+ `BackingServiceSource.ATLAS` enum value was removed on 2026-05-07 —
616
+ Atlas is a brand under the managed source, not its own source axis.
633
617
  - `logging: { level: 'debug', formattedConsoleErrors: true }` —
634
618
  per-environment log posture. Wired end-to-end by Slice 3.5:
635
619
  persisted into `PlatformEnvConfigJson.logging`, projected by
@@ -660,10 +644,85 @@ The sibling staging config
660
644
  the same shape with `WildoEnvironment.STAGING` +
661
645
  `WildoLocationType.REMOTE` + `remoteProvider` (registry endpoint,
662
646
  region) + `deployment` (branch, runtime). Backing-service `source`
663
- swaps to `MANAGED` as appropriate, with `provider: '<brand>'`
664
- naming the cloud variant (`'atlas'` for MongoDB Atlas,
665
- `'aws-rds'` / `'gcp-cloud-sql'` / `'supabase'` / `'neon'` /
666
- `'render'` / `'azure-database'` for Postgres).
647
+ swaps to `MANAGED` only where the platform serves it (MongoDB Atlas,
648
+ `provider: 'atlas'`).
649
+
650
+ ## What each kind can be declared as today
651
+
652
+ A declaration is accepted only when the platform can SERVE it: it must
653
+ resolve to an infrastructure provider, and that provider must have a
654
+ provider module able to deliver the application's connection. Anything
655
+ else is refused — by `wildo config validate`, `wildo config sync` and
656
+ `wildo lock check` alike — with a message naming the environment, the
657
+ kind, what you declared, and what that kind CAN be declared as.
658
+
659
+ | Kind | Accepted declarations |
660
+ |---|---|
661
+ | `mongodb` | `{ source: SELF }` · `{ source: MANAGED, provider: 'atlas' }` |
662
+ | `postgresql` | `{ source: SELF }` |
663
+ | `redis` | `{ source: SELF }` |
664
+ | `rabbitmq` | `{ source: SELF }` |
665
+ | `s3` | `{ source: SELF }` (MinIO; `provider: 'minio'` is accepted and redundant) |
666
+ | `clamav` | `{ source: SELF }` |
667
+ | `immudb` | `{ source: SELF }` |
668
+
669
+ What this refuses, and why it is not a formality:
670
+
671
+ - **A managed cache, broker, scanner or audit store** — `redis: { source:
672
+ MANAGED }` and the like — names no provider at all.
673
+ - **Managed PostgreSQL** (`'aws-rds'`, `'gcp-cloud-sql'`, `'azure-database'`,
674
+ `'supabase'`, `'neon'`, `'render'`, or unbranded) and **managed S3** (AWS)
675
+ name catalogue entries the platform cannot serve yet.
676
+ - Before this was refused, such a declaration passed in silence: the stack
677
+ was generated WITHOUT the self-hosted service, and the platform still
678
+ minted the application's credential on its OWN server — a credential for a
679
+ server the application never connects to.
680
+
681
+ There is no opt-out flag. A kind becomes declarable as `MANAGED` in the same
682
+ framework release that adds the provider module serving it. `backup` is not
683
+ a kind: it was withdrawn because nothing read it, and a `backup:` key now
684
+ fails to parse.
685
+
686
+ The authoritative resolution table, with the "Servable today" column, is in
687
+ `references/framework-backing-services-api.md`.
688
+
689
+ ### Your declaration decides where credentials are minted
690
+
691
+ Every registration (`wildo local init`, every `wildo local dev` start) sends
692
+ apps-manager the `(source, provider)` pair of each kind the environment
693
+ declares. apps-manager mints the application's cache, broker and database
694
+ credentials on exactly that provider, through the same provider catalogue —
695
+ never on another one because it happens to hold a client for it. A kind the
696
+ environment does not declare keeps the platform's own choice: its self-hosted
697
+ server, or for MongoDB, Atlas whenever the platform holds an Atlas API key.
698
+
699
+ So moving `mongodb` from `{ source: SELF }` to
700
+ `{ source: MANAGED, provider: 'atlas' }` and registering again changes where
701
+ the database user is minted, with no apps-manager edit — provided the
702
+ platform already serves Atlas. A declaration change reaches apps-manager at
703
+ the next registration, not at `wildo config sync` or
704
+ `wildo config reapply-declaration`.
705
+
706
+ Which providers a platform can serve is PLATFORM configuration: an Atlas
707
+ declaration needs apps-manager to hold an Atlas API key, a self-hosted
708
+ PostgreSQL declaration needs a platform PostgreSQL. apps-manager refuses a
709
+ registration whose declared provider it cannot serve, before provisioning
710
+ anything, naming the kind, what you declared and what the platform serves
711
+ instead. Only the kinds the application actually stores in are checked
712
+ against the platform's credentials: a declared MongoDB that a PostgreSQL
713
+ application never uses does not need an Atlas key.
714
+
715
+ Minion confinement holds on MongoDB Atlas exactly as on a self-hosted MongoDB.
716
+ Each minion of an application whose database store is declared on Atlas gets its
717
+ OWN Atlas database user, never the application's: that user holds one custom
718
+ role granting only the collections the minion's `resourceAccess` declares plus
719
+ the execution-history records every minion needs, and it can reach only the
720
+ application's cluster. Removing the minion deletes its user and role and leaves
721
+ the application's user untouched. Each minion takes one database user and one
722
+ custom role from the Atlas project's limits (100 of each by default). When
723
+ apps-manager can read those limits, a minion that would exceed one is refused
724
+ before anything is created, naming the limit; otherwise Atlas's own refusal
725
+ of the create is what stops it.
667
726
 
668
727
  ## Capability-driven backing services
669
728
 
@@ -707,6 +766,47 @@ there is no secret for you to create. If a backend log says
707
766
  answer is a `wildo config sync` (which provisions and re-renders), never a
708
767
  hand-written key.
709
768
 
769
+ **Nor do you author the audit store's credentials.** A self-hosted store's
770
+ credentials are MINTED, never authored. Each application gets its OWN immudb
771
+ database and its OWN user, which can write that database and nothing else;
772
+ the platform creates both when the application registers and delivers them to
773
+ the application with its other platform secrets. The server's administrator
774
+ password is a platform secret that only the platform's own apps-manager
775
+ receives. No application receives it.
776
+
777
+ - `IMMUDB_USER`, `IMMUDB_PASSWORD` and `IMMUDB_DATABASE` in your provider
778
+ secrets decide nothing on a self-hosted store. The minted values win.
779
+ Where they differ, the backend logs a warning naming each variable (never
780
+ its value). Remove them with `wildo secrets unset <NAME>`. They matter
781
+ only for a MANAGED immudb.
782
+ - Withdrawing the application (`wildo local deregister`) deactivates its
783
+ audit user and revokes its permission. The database and its events are
784
+ kept, because an audit history must outlive the credential that wrote it.
785
+ `wildo local restore` re-activates the same user.
786
+ - The first boot on the new per-application database records a DELIBERATE
787
+ trust-anchor reset in the backend log, instead of a tamper alarm. The
788
+ verified history now starts there, and the previous database's anchor
789
+ file is kept.
790
+ - An immudb data directory initialised before this change keeps its old
791
+ administrator password. When that password is immudb's packaged default
792
+ (the usual case: nothing set it), apps-manager changes it to
793
+ `immudb.adminPassword` at its first administrator login, logs a warning
794
+ and records `immudb_admin_credential_adopted` on the registration's
795
+ audit event. Nothing is asked of you, with one consequence: another
796
+ application on the same platform that was registered before this change
797
+ still logs in as that administrator, so from then on its audit writes
798
+ are refused (its backend logs a warning). Re-register it
799
+ (`wildo local init`) and it gets its own database and user.
800
+ - When the old password is a real secret (an `IMMUDB_PASSWORD` you authored
801
+ before this change), the platform cannot log in and registration fails;
802
+ apps-manager's log names the cause. Set the server's administrator
803
+ password, once, to the value of `immudb.adminPassword` in the
804
+ environment's `secrets.json`
805
+ (`docker exec -it wildo-immudb immuadmin user changepassword immudb`
806
+ locally), or start from a fresh data directory. This alters a credential
807
+ the platform does not hold, so it is the operator's step. The same holds
808
+ after rotating `immudb.adminPassword`.
809
+
710
810
  ## Choosing the application's store — and what it obliges
711
811
 
712
812
  `applicationDatabase` selects where THIS application's resources persist, and it
@@ -769,6 +869,7 @@ Read `references/framework-infrastructure-host-api.md` for the source-backed con
769
869
  - [ ] Infra file is a single `defineInfraEnvConfig({...})` default export
770
870
  - [ ] Environment uses a common named ID or a valid custom slug; runtime and backing-service source use their typed enums
771
871
  - [ ] Every backing service the app uses is declared with a valid `source`
872
+ - [ ] 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
772
873
  - [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
773
874
  - [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
774
875
  - [ ] 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`
@@ -787,6 +888,7 @@ Run from the app root, substituting `<env>`:
787
888
  | Environment identifier matches its directory and passes `WildoEnvironmentIdSchema` | Inspect `environment` in the authored file; custom remote slugs are supported. |
788
889
  | Typed `WildoDeploymentRuntime` enum used | `rg -n "runtime:\s*WildoDeploymentRuntime\." infrastructure/<env>/wildo.infra.*.config.ts` |
789
890
  | Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
891
+ | 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'` |
790
892
  | 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` |
791
893
  | **No secrets** in infra file (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
792
894
  | Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
@@ -804,6 +906,7 @@ runtime/source enums. Keep secret values outside authored infrastructure.
804
906
  | "Drop the password into the config for now, I'll move it later" | Secrets in git are an outage waiting to happen. Use the secrets store from the first commit; "later" never arrives. |
805
907
  | "Every environment ID must be a `WildoEnvironment` member" | The enum supplies common names; custom validated slugs are supported. Only `local` selects local behavior, so ensure a custom name is intentional. |
806
908
  | "Skip declaring `clamav` — we don't use virus scanning yet" | If the app's bootstrap initializes the service, the infra config must declare it. Missing entries fail bootstrap with cryptic `undefined` errors. |
909
+ | "Declare the managed Postgres / Redis we plan to use now, and wire it up later" | A declaration the platform cannot serve is refused outright, and before that refusal existed it silently produced a credential for the wrong server. Declare `SELF` until the framework release that serves the managed option; there is no flag that accepts it early. |
807
910
  | "Copy production URL into the example config to keep them in sync" | Production URLs in non-production configs are catastrophic when accidentally promoted. Keep production values exclusively in production config + secrets. |
808
911
 
809
912
  ## Red Flags
@@ -816,6 +919,9 @@ runtime/source enums. Keep secret values outside authored infrastructure.
816
919
  environment stored under the local filename
817
920
  - Backing service used by the app but not declared in the infra
818
921
  config (bootstrap fails with `undefined` connection params)
922
+ - `source: BackingServiceSource.MANAGED` on anything but `mongodb`
923
+ with `provider: 'atlas'` (catch with the **Every `MANAGED`
924
+ declaration is MongoDB Atlas** grep above)
819
925
  - `devCompanion` declared in a remote config (the field is local-only;
820
926
  the typed factory may accept it but the companion won't bind correctly)
821
927
  - `remoteProvider` or `deployment` declared in a local config (same