@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
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: configure-billing
3
- description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain. Use when the user says "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", "my provider is authored but the backend can't reach it", "provider not reachable on the backend", or "make <provider> work on the backend host". Covers the 5 config surfaces (engine capability activation, backend billing block, backend provider scope, per-env secrets, `wildo config sync` regen), the auto-registered webhook route, and the failure-reason → surface debugging map.
3
+ description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain, and write the application's billing catalogue — the plans and typed prices the backend sells and the public website lists. Use when the user says "enable billing", "turn on Stripe", "add a pricing plan", "set the plan prices", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", or "make <provider> work on the backend host". Covers the 5 config surfaces, the product catalogue (money in minor units; recommended, price disclosure and availability), the auto-registered webhook route, and the failure-reason → surface debugging map.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Configure Billing
@@ -48,6 +49,7 @@ narrow case only — a provider module your application itself ships.
48
49
  | Backend provider scope | `./wildo.saas.config.ts` (`providers.scopes.backend.providers.<ref>`) |
49
50
  | Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` (`providerEnv`) |
50
51
  | Generated artifact (do NOT hand-edit) | `./backend-api/src/generated/wildo-provider-runtime.generated.ts` |
52
+ | Billing catalogue — the plans and prices the backend sells and the website lists | `./shared-lib/src/engine/product.ts` (`CUSTOM_PRODUCT_CATALOG`) |
51
53
 
52
54
  ## When to Use
53
55
 
@@ -56,15 +58,40 @@ narrow case only — a provider module your application itself ships.
56
58
  - Making any provider that runs server-side (email, LLM, SMS, audit sink)
57
59
  reachable on the backend host
58
60
  - A provider "works in the frontend" but the backend can't resolve it
61
+ - Turning on a referral program, or choosing what the referrer and the referred customer receive
62
+ - Writing or changing the billing catalogue: a plan, its price, and whether it is recommended,
63
+ fully priced, or on sale yet
59
64
 
60
65
  ## When NOT to Use
61
66
 
62
67
  - Pure provider-scope authoring with no billing / backend-reachability angle →
63
68
  `config-saas` (owns `providers.scopes` generally)
64
- - Frontend-only SDK wiring (Checkout.js widget, file picker) → that is the
65
- `providers.scopes.frontendServices.<app>` surface, a different scope
69
+ - Browser-side provider code (a file picker, error monitoring, analytics) → that is the
70
+ `providers.scopes.frontendServices.<app>` surface, a different scope. Billing has
71
+ NO browser part: checkout and the customer portal are hosted redirects, and a
72
+ frontend module may not declare `BILLING` (it is refused when projected)
66
73
  - Editing environment topology / backing services → `infra-environment-config`
67
- - Authoring product tiers / feature entitlements → `engine-product-definitions`
74
+ - Authoring feature entitlements (feature identifiers, profiles, unavailability policy) →
75
+ `engine-product-definitions`. The catalogue's own entries — the plans and their prices — are this
76
+ skill's.
77
+
78
+ ## Authoring the catalogue
79
+
80
+ The catalogue is the ONE place a price lives. The backend syncs it to the billing provider, and the
81
+ public website reads it at build time for its pricing page, so a price written anywhere else (a
82
+ website file, a product specification's prose) is a copy that will disagree with it.
83
+
84
+ - **Each entry's `key` is a string literal** (`key: 'team'`), and when a build task produces the product it
85
+ is exactly the task's `productKey`: the build loop recognises a landed product by that literal, so a key
86
+ held in a constant or an enum member reads as not landed and the task is dispatched again.
87
+ - **Every entry is in the exported `CUSTOM_PRODUCT_CATALOG` array** — a plan declared and not listed there
88
+ is sold nowhere and shown nowhere.
89
+ - **Money is in MINOR units**: `$4` is `{ amount: 400n, decimals: 2, currency: 'USD' }`, never `4n`.
90
+ - **Per member or flat**: `PricingModel.PER_UNIT` for a per-seat price, `FLAT` for a whole price.
91
+ - **The three pricing-surface facts** — `isRecommended`, `priceDisclosure`, `availability` — say how
92
+ every pricing surface presents the plan; see `references/framework-product-catalog-api.md`.
93
+ - **Product specifications describe what a price MEANS** (monthly and yearly, a discount, a sub-cent
94
+ metered amount), never the amount itself.
68
95
 
69
96
  ## Workflow
70
97
 
@@ -126,9 +153,13 @@ declaration is not merely redundant but a source of disagreement.
126
153
 
127
154
  ### Step 6: Surface 4 — populate the secrets
128
155
 
129
- In `./infrastructure/<env>/secrets/secrets.json` → `providerEnv`, set the
130
- env-var-named keys the provider's `secretsContract` declares
131
- (`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`). Missing → `SECRET_MISSING`.
156
+ Set the env-var-named keys the provider's `secretsContract` declares
157
+ (`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`) with `wildo secrets set
158
+ STRIPE_SECRET_KEY` (a masked prompt; `--env <environment>` for a remote one).
159
+ It writes `./infrastructure/<env>/secrets/secrets.json` → `providerEnv`,
160
+ regenerates the runtimes' env files and restarts the backend, and refuses a
161
+ name no scoped provider declares — so run it after Step 5's scope is authored.
162
+ `wildo secrets list` shows which are still `needed`. Missing → `SECRET_MISSING`.
132
163
  See `references/example-backend-provider-module-shape.md` for where these
133
164
  names come from.
134
165
 
@@ -139,6 +170,9 @@ Run `wildo config sync` (apps-manager must be up). Confirm `<ref>` appears in
139
170
  boots without a billing-resolution fatal. The webhook route
140
171
  `POST /api/v1/webhooks/stripe/billing` is auto-registered from
141
172
  `WEBHOOK_ORIGINATOR`; forward local events with `stripe listen --forward-to`.
173
+ Each event is stored, retried for up to three days and replayable from the
174
+ inbound deliveries list — see "What happens to a billing event after it is
175
+ verified" in `references/config-chain-and-failure-map.md`.
142
176
 
143
177
  ## Worked Example
144
178
 
@@ -164,9 +198,11 @@ and `WEBHOOK_ORIGINATOR` is what registers the inbound route:
164
198
  // selection aligned with discovery prevents the provider from being
165
199
  // registered under a capability no runtime selects.
166
200
  // WEBHOOK_ORIGINATOR is required so the webhook auto-controller
167
- // registers POST /api/v1/webhooks/stripe/billing. The separate
168
- // `frontendServices.app.providers.stripe` entry is the Checkout.js
169
- // SDK surface — a distinct concern, kept as-is.
201
+ // registers POST /api/v1/webhooks/stripe/billing. This is the ONLY
202
+ // place Stripe is declared: checkout and the customer portal are
203
+ // hosted redirects, so no Stripe code runs in the browser and there
204
+ // is no frontend-scope entry to add. The billing components show the
205
+ // vendor's name from `billing.providerRef` (#1701).
170
206
  stripe: {
171
207
  engineCapabilities: [EngineCapability.BILLING],
172
208
  providerCapabilities: ['BILLING'],
@@ -174,14 +210,18 @@ and `WEBHOOK_ORIGINATOR` is what registers the inbound route:
174
210
  },
175
211
  ```
176
212
 
177
- Note the deliberate contrast the comment draws: the separate
178
- `frontendServices.app.providers.stripe` entry is the browser Checkout.js SDK —
179
- authoring only there is exactly the trap that leaves the backend unable to
180
- resolve the provider.
213
+ Note what the comment says: the backend scope is the ONLY place the billing
214
+ provider is declared. There is no frontend-scope entry for it — no Stripe code
215
+ runs in the browser, and the billing components (portal link, invoice history,
216
+ subscription status) show the vendor's name from `billing.providerRef` through
217
+ `useBilling().billingProviderRef` and the generated `providers.<ref>.displayName`
218
+ label. A billing ref authored under `frontendServices` is refused by discovery,
219
+ since no browser module contributes `BILLING`.
181
220
 
182
221
  ## References
183
222
  - `references/framework-billing-frontend-api.md` — `useBilling()`, `openCheckout`, `openCustomerPortal`: the frontend surface a bespoke purchase flow is built on
184
- - `references/framework-product-catalog-api.md` — source-backed catalogue vocabularies and sync results; local retirement versus provider retirement and subscriber migration
223
+ - `references/framework-product-catalog-api.md` — how to write the catalogue: money in minor units, the three pricing-surface facts (recommended, price disclosure, availability), source-backed vocabularies and sync results, local retirement versus provider retirement
224
+ - `references/framework-referral-program.md` — `billing.referrals`: issuing and redeeming referral codes, what each reward kind does and when it is delivered, and who may redeem
185
225
  - `references/framework-subscription-behavior-policy.md` — `behaviorPolicy` on a product: what trial, proration, cancellation and timing actually control, and the two fields that constrain nothing
186
226
  - `references/config-chain-and-failure-map.md` — the 6-surface checklist, the failure-reason → surface map, the webhook route, and the generalization to non-billing providers
187
227
  - `references/framework-backend-provider-reachability-api.md` — source: the backend registry catalog→artifact filter (why a mis-scoped provider is dropped)
@@ -211,13 +251,13 @@ Run from the app root (substitute `<ref>` / `<env>`):
211
251
  | **Ref authored in BACKEND scope** (must return a hit) | `rg -n "backend:\s*\{" -A80 wildo.saas.config.ts \| rg "<ref>:"` |
212
252
  | **No second declaration** (must return NOTHING for an engine-shipped or package-shipped provider) | `rg -n "<ref>" backend-api/src/provider-contributions.ts` |
213
253
  | Billing scope declares both protocols | `rg -n "'BILLING_PROVIDER'.*'WEBHOOK_ORIGINATOR'\|'WEBHOOK_ORIGINATOR'.*'BILLING_PROVIDER'" wildo.saas.config.ts` |
214
- | Secrets populated | `rg -n "STRIPE_SECRET_KEY\|STRIPE_WEBHOOK_SECRET" infrastructure/<env>/secrets/secrets.json` |
254
+ | Secrets populated (both listed under `SET`, none under `NEEDED`) | `wildo secrets list --env <env>` |
215
255
  | **Ref materialized in the artifact** (must return a hit after sync) | `rg -n "<ref>" backend-api/src/generated/wildo-provider-runtime.generated.ts` |
216
- | **Frontend-only trap** (a hit HERE with no backend-scope hit above = the bug) | `rg -n "frontendServices:" -A60 wildo.saas.config.ts \| rg "<ref>:"` |
256
+ | **No frontend-scope billing entry** (must return NOTHING — billing has no browser part) | `rg -n "frontendServices:" -A60 wildo.saas.config.ts \| rg "<ref>:"` |
217
257
 
218
258
  The high-signal pair: **"ref authored in BACKEND scope"** returning empty while
219
- **"frontend-only trap"** returns a hit is the exact billing crash-loop
220
- signature.
259
+ **"no frontend-scope billing entry"** returns a hit is the exact billing crash-loop
260
+ signature: the ref was declared where nothing can serve it.
221
261
 
222
262
  ## Common Rationalizations
223
263
 
@@ -225,7 +265,8 @@ signature.
225
265
  |-----------------|---------|
226
266
  | "I set `billing.enabled` + `providerRef` and the secret — that's everything." | That is only surfaces 2 and 4. Without engine activation (1), backend-scope authoring (3) and the regeneration that materializes it (5), exposure or provider resolution remains incomplete. |
227
267
  | "The engine ships the Stripe integration, so I don't need any npm package." | The engine ships the ADAPTER; it lazy-`require`s the provider's SDK at runtime. You must add the SDK package (`stripe`) to `backend-api/package.json` and install it. Missing SDK fails when the adapter instantiates — a require/module-not-found error, distinct from the classified billing-resolution fatals. |
228
- | "Stripe is already in `frontendServices` — the backend will find it." | Frontend scope is the browser SDK (Checkout.js), a DIFFERENT scope. The backend host reads only `providers.scopes.backend`. Same ref, two surfaces, two purposes. |
268
+ | "Stripe is already in `frontendServices` — the backend will find it." | Billing has no browser part: checkout and the portal are hosted redirects, and no frontend module contributes `BILLING`, so discovery refuses the frontend entry. The backend host reads only `providers.scopes.backend`. |
269
+ | "I need a frontend Stripe module so the billing screens can name the provider." | The name comes from the ref: `useBilling().billingProviderRef` (your `billing.providerRef`) and the generated `providers.<ref>.displayName` label. A browser module is for code that runs in the page. |
229
270
  | "The fatal says secret missing, so I'll rotate the key." | Only if the reason is `SECRET_MISSING`. `PROVIDER_NOT_REACHABLE_ON_BACKEND` looks similar but is a scope/contribution gap — read the classified reason before touching the secret. |
230
271
  | "Stripe is engine-shipped, so I still need to project it into `provider-contributions.ts`." | You do not, and doing so is a second declaration that can disagree with the engine. Discovery admits the engine's own provider package by name and reads its `./companion` barrel; the scope supplies the runtime target. Hand-author a contribution only for a provider module your application itself ships. |
231
272
  | "I'll edit the generated `wildo-provider-runtime.generated.ts` to add the ref." | Generated artifact — hand edits are overwritten on the next sync and mask the real authoring gap. Fix surfaces 3/4 and re-run `wildo config sync`. |
@@ -240,9 +281,8 @@ signature.
240
281
  - `billing.providerRef` set but no matching entry under
241
282
  `providers.scopes.backend` (catch with the **Ref authored in BACKEND scope**
242
283
  grep — must return a hit).
243
- - Ref under `frontendServices` only, absent from the backend scope (catch with
244
- the **Frontend-only trap** grep returning a hit while the backend-scope grep
245
- is empty).
284
+ - Ref under `frontendServices`, where no browser module can serve billing (catch
285
+ with the **No frontend-scope billing entry** grep returning a hit).
246
286
  - An engine- or package-shipped ref ALSO hand-authored in
247
287
  `backend-api/src/provider-contributions.ts` (catch with the **No second
248
288
  declaration** grep — must return nothing). Discovery already supplies it; the
@@ -262,5 +302,5 @@ signature.
262
302
  surface 5 lives beside
263
303
  - `local-environment-bootstrap` — drives `wildo config sync` and the local stack
264
304
  that materializes the authored truth
265
- - `engine-product-definitions` — billing product tiers / feature entitlements
305
+ - `engine-product-definitions` — feature entitlements the catalogue's products grant
266
306
  (the layer above provider wiring)
@@ -31,8 +31,9 @@ authored but the provider still cannot be constructed.
31
31
 
32
32
  Surface 3 is the **classic trap**: authoring the provider only in a frontend
33
33
  scope (`providers.scopes.frontendServices.<app>`) looks done, but that surface
34
- is the browser SDK (e.g. Stripe Checkout.js) — a DIFFERENT scope from the
35
- backend host that runs the billing SDK and verifies inbound webhooks. The
34
+ holds browser-side provider code, and billing has none — checkout and the
35
+ customer portal are hosted redirects, and a frontend module may not declare
36
+ `BILLING`. The backend host runs the billing SDK and verifies inbound webhooks. The
36
37
  backend registry only exposes refs authored under `providers.scopes.backend`.
37
38
 
38
39
  **There is no sixth surface projecting the provider into the backend package,
@@ -84,6 +85,38 @@ For local dev, forward Stripe events to the running backend:
84
85
  stripe listen --forward-to localhost:<backend-port>/api/v1/webhooks/stripe/billing
85
86
  ```
86
87
 
88
+ ### What happens to a billing event after it is verified
89
+
90
+ Billing events travel the framework's durable inbound path, the same one an
91
+ application's own inbound handlers use:
92
+
93
+ - **Stored once, answered `200`.** Each verified event is written to the
94
+ application's inbound deliveries (Settings → inbound deliveries) keyed by the
95
+ provider event id, and Stripe is answered `200` straight away. A redelivery of
96
+ the same event is recognised and not run again.
97
+ - **Run with a dedicated role.** The framework's billing handler writes the
98
+ subscription, invoice, credit-pool and billing-account records with a role that
99
+ grants exactly those writes, in the one organization (or, for personal billing,
100
+ the one person) the event's customer belongs to. No person, API key or OAuth
101
+ client can be given that role.
102
+ - **Retried for three days, then `DEAD`.** A failed attempt is retried with
103
+ growing delays (one minute, doubling to six hours) for up to three days — as
104
+ long as Stripe itself would have retried. After that the delivery is `DEAD`,
105
+ and an administrator can replay it with a written reason once the cause is
106
+ fixed. Replaying an event that already took effect does not take effect twice.
107
+ - **Events for one subscription run in order.** Events naming the same
108
+ subscription (or, without one, the same customer) run one at a time in the
109
+ order they arrived, and each subscription change is decided against a fresh
110
+ read of the subscription at Stripe.
111
+ - **An event whose customer matches no billing account is `UNROUTABLE`**: it is
112
+ recorded and answered `200`, never run, and never applied to the application
113
+ as a whole.
114
+
115
+ To test replay safely, use a test-mode key (`sk_test_…`) — the Stripe CLI uses
116
+ your live account unless told otherwise — and replay from the inbound deliveries
117
+ list rather than with `stripe events resend`, which only re-sends an event the
118
+ application already stored once.
119
+
87
120
  ## Generalizing beyond billing
88
121
 
89
122
  Surfaces 1 and 3 → 5 are provider-agnostic: they are how ANY backend-reachable
@@ -24,6 +24,20 @@ resolvable on the backend host.
24
24
  // To disable: set `enabled: false` (providerRef then becomes inert).
25
25
  enabled: true,
26
26
  providerRef: 'stripe',
27
+ /**
28
+ * The referral program. An organization owner issues a code from the organization's referrals page, a new
29
+ * customer redeems it on their billing account, and the customer's first paid invoice converts it and grants
30
+ * both rewards once.
31
+ *
32
+ * The referrer's credits go to a dedicated pool, created on the first grant and counted as granted rather
33
+ * than purchased. The new customer's reward is a coupon on their subscription: 20% off for three months.
34
+ */
35
+ referrals: {
36
+ enabled: true,
37
+ referrerReward: { type: ReferrerRewardType.CREDIT, credits: 500, creditPoolKey: 'referral_credits' },
38
+ referredReward: { type: ReferredRewardType.DISCOUNT, percentOff: 20, discountDuration: PromotionDuration.REPEATING, discountDurationInMonths: 3 },
39
+ codeValidityDays: 30,
40
+ },
27
41
  },
28
42
  ```
29
43
 
@@ -50,6 +50,9 @@ export const StripeBackendProvider: BackendProviderModule = {
50
50
  deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
51
51
  processingRegions: ['us-east-1', 'eu-west-1'],
52
52
  vendorLegalEntityName: 'Stripe, Inc.',
53
+ // Stripe keeps the customer and its payment records; the engine's billing subject-erasure effect deletes the
54
+ // customer and detaches its payment methods, and names this provider as the recipient it answers for (#1710).
55
+ subjectErasure: { stance: HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION },
53
56
  },
54
57
  providerCapabilities: [
55
58
  BUILTIN_PROVIDER_CAPABILITY.BILLING,
@@ -111,7 +111,16 @@ export interface BillingContextType {
111
111
  // ── Configuration ──
112
112
  isEnabled: boolean;
113
113
  billingConfiguration: BillingConfiguration | undefined;
114
- billingProvider: FrontendAppProviderModule | null;
114
+ /**
115
+ * The configured billing provider's REF (`billing.providerRef`), or null when billing is off or
116
+ * names none. Surfaces show the vendor's name from it (`providers.<ref>.displayName`, #1895).
117
+ *
118
+ * It used to be a frontend provider MODULE, resolved from the registry by ref or by the `BILLING`
119
+ * capability. The only such module was Stripe's, which loaded no Stripe code — checkout and the
120
+ * customer portal are hosted redirects — and existed only to carry that name (#1701). The ref is the
121
+ * fact the application configured; a module was a second place that had to agree with it.
122
+ */
123
+ billingProviderRef: string | null;
115
124
 
116
125
  // ── Billing State ──
117
126
  billingAccount: BillingAccount | null;
@@ -125,6 +134,15 @@ export interface BillingContextType {
125
134
  productDefinitions: ProductDefinition[];
126
135
  getPricesForProduct: (productId: string) => Price[];
127
136
  getProductByKey: (key: string) => Product | undefined;
137
+ /**
138
+ * May this product be bought, or moved onto, right now? Answered from the billing state's
139
+ * `acquirableProductKeys` — the set the backend derives with the SAME predicate its checkout,
140
+ * plan-change and add-on doors enforce — so a surface never re-derives it from `isActive` and can
141
+ * never offer a plan the backend refuses (a retired one, or an announced-but-upcoming one, #1835).
142
+ * Fails closed: a state that did not carry the set answers `false`, because an unknown answer must
143
+ * not offer a checkout.
144
+ */
145
+ isProductAcquirable: (key: string) => boolean;
128
146
 
129
147
  // ── Scope ──
130
148
  currentScope: ResourcePrimaryScope | null;
@@ -137,7 +155,7 @@ export interface BillingContextType {
137
155
 
138
156
  // ── Usage & Credits ──
139
157
  usage: UsageSummary;
140
- creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;
158
+ creditPools: Record<string, { available: number; totalPurchased: number; totalGranted: number; totalConsumed: number }>;
141
159
 
142
160
  // ── Actions ──
143
161
  openCheckout: (productKey: string, priceId: string, options?: {
@@ -150,6 +168,11 @@ export interface BillingContextType {
150
168
  previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;
151
169
  /** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */
152
170
  confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;
171
+ /**
172
+ * Withdraw the plan change pending at the end of the period (`subscription.pendingPlanChange`, #1868), so the subscription renews
173
+ * on its current plan. Successful withdrawal refreshes billing state.
174
+ */
175
+ cancelPendingPlanChange: () => Promise<void>;
153
176
 
154
177
  // ── State ──
155
178
  isLoading: boolean;
@@ -52,6 +52,25 @@ does not block a sync and does not reach the provider either.
52
52
  so any price authored at a scale other than the currency's synced at the wrong magnitude. Notes older
53
53
  than that describe the previous behaviour.)
54
54
 
55
+ ## What a pricing surface needs from a plan
56
+
57
+ Three optional fields decide how every pricing surface presents a product — the application's own
58
+ pricing table AND its public website, which reads this same catalogue at build time and never keeps a
59
+ copy of its prices. Set them here, and nowhere else:
60
+
61
+ | Field | Omitted means | Set it when |
62
+ |---|---|---|
63
+ | `isRecommended` | not recommended | the plan is the one you recommend to the audience the product is designed for. It is shown as a recommendation — never as "most popular", which nothing measured. Recommend at most one plan per audience |
64
+ | `priceDisclosure` (`ProductPriceDisclosure`) | `LISTED` — the prices are the whole offer | `STARTING_AT`: part of the total is quoted (a platform fee, a volume term), so the price reads "From …" and is not published as the offer. `ON_REQUEST`: no price is shown and the action leads to sales |
65
+ | `availability` (`ProductAvailability`) | `AVAILABLE` | `UPCOMING`: the plan is announced on pricing surfaces but cannot be bought yet — checkout, plan changes and add-on purchases refuse it with `BILLING_PRODUCT_NOT_YET_AVAILABLE`, and it is not created at the billing provider, until you put it on sale |
66
+
67
+ `priceDisclosure` changes only what is SHOWN: an on-request plan can still be checked out through a link
68
+ a salesperson sends. `availability` changes what can be BOUGHT. Retiring a plan is neither — remove it
69
+ from the array.
70
+
71
+ A plan still needs a real `prices` entry in every case, because the catalogue syncs to the billing
72
+ provider; the disclosure is how you say that price is not the public offer.
73
+
55
74
  ## `grantedLimits` composes, and the mode decides how
56
75
 
57
76
  A plan seeds its base limits from the declared grant values. For an add-on, `LimitGrantMode.ADD`
@@ -116,6 +135,10 @@ export enum ProductType {
116
135
  ITEM = 'item',
117
136
  }
118
137
 
138
+ // ProductPriceDisclosure / ProductAvailability: declared in `./public-pricing-catalog.shared.atoms`
139
+ // (#1835) — import-free so the website's browser bundle can name them through
140
+ // `@wildo-ai/saas-models/public-runtime`. Not re-exported here; the package root exports the atom.
141
+
119
142
  /**
120
143
  * Limit grant mode: how this product's limits compose with other products.
121
144
  * - SET: absolute value (replaces, used for PLAN base limits)
@@ -136,7 +159,9 @@ export enum LimitGrantMode {
136
159
  // request contract has to be able to name the type — see TaxDisplayMode for the same reasoning.
137
160
 
138
161
  /**
139
- * Billing timing: when to apply plan changes.
162
+ * Billing timing: when a cancellation takes effect (`behaviorPolicy.cancellation.defaultBehavior`), and when a plan
163
+ * change takes effect (`behaviorPolicy.upgrade.timing` / `downgrade.timing`, #1868). A plan change `at_period_end` is
164
+ * carried as the subscription's `pendingPlanChange` and applied at renewal through a provider subscription schedule.
140
165
  */
141
166
  export enum BillingTiming {
142
167
  IMMEDIATE = 'immediate',
@@ -144,6 +169,53 @@ export enum BillingTiming {
144
169
  }
145
170
  ```
146
171
 
172
+ ### Origin Package: `@wildo-ai/saas-models`
173
+
174
+ ```typescript
175
+ /**
176
+ * How much of a product's price a pricing surface may state.
177
+ *
178
+ * The catalogue always carries typed prices — a product cannot sync to the billing provider
179
+ * without one — but a commercial offer is not always fully decided by them. A plan sold as "per
180
+ * member, plus a platform fee we quote" has a real unit price and an unsettled total; an
181
+ * enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.
182
+ * Before this vocabulary existed, every pricing surface either printed that price as if it were
183
+ * the whole offer, or kept its own hand-written list of exceptions (#1835).
184
+ *
185
+ * This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout
186
+ * link for an on-request plan by a salesperson must still be able to pay it, for the same reason a
187
+ * private-but-active plan stays purchasable. Whether the product can
188
+ * be bought today is {@link ProductAvailability}'s question.
189
+ */
190
+ export enum ProductPriceDisclosure {
191
+ /** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */
192
+ LISTED = 'listed',
193
+ /**
194
+ * The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).
195
+ * A pricing page states it as a starting price, and structured data must not publish it as the
196
+ * price, because a search engine would show it as the whole offer.
197
+ */
198
+ STARTING_AT = 'starting_at',
199
+ /** No price is stated: the offer is quoted on request (a "contact sales" plan). */
200
+ ON_REQUEST = 'on_request',
201
+ }
202
+
203
+ /**
204
+ * Whether a product can be bought today.
205
+ *
206
+ * Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no
207
+ * longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is
208
+ * announced on pricing surfaces so a visitor can see where the product is going, and it cannot be
209
+ * bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.
210
+ */
211
+ export enum ProductAvailability {
212
+ /** On sale: the acquisition doors accept it (subject to retirement). */
213
+ AVAILABLE = 'available',
214
+ /** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */
215
+ UPCOMING = 'upcoming',
216
+ }
217
+ ```
218
+
147
219
  ## Complete synchronization result
148
220
 
149
221
  The backend result contract below is extracted from the owning synchronization service. It describes
@@ -0,0 +1,110 @@
1
+ # Framework Referral Program
2
+
3
+ `billing.referrals` in the backend config turns on a referral program: an organization issues a code,
4
+ a new customer redeems it, and when that customer pays its first invoice both sides receive the
5
+ rewards the application declared.
6
+
7
+ Read it before declaring a reward. A reward is a promise of money or access, and each kind is
8
+ delivered at a different moment.
9
+
10
+ ## The contract
11
+
12
+ ## Import Origins
13
+
14
+ - `@wildo-ai/saas-models`
15
+
16
+ ## Source Excerpts
17
+
18
+ ### Origin Package: `@wildo-ai/saas-models`
19
+
20
+ ```typescript
21
+ /**
22
+ * The referral program (#1802): whether organizations may issue referral codes, and what each side
23
+ * receives when a referral converts (the referred account's first paid invoice).
24
+ *
25
+ * The rewards are copied onto each referral when its code is issued, so changing them here affects
26
+ * codes issued afterwards and never re-prices a referral already made. A reward's `featureKey` must
27
+ * name a registered boolean feature; startup WARNS about one that does not, like every other feature
28
+ * reference, and a feature nobody registered grants nothing.
29
+ */
30
+ referrals: z.object({
31
+ /** Off by default: issuing codes that promise rewards is a commercial decision the application makes. */
32
+ enabled: z.boolean().default(false).describe('Whether organizations may issue referral codes. Redeeming and converting codes already issued keeps working when this is turned off.'),
33
+ referrerReward: ReferrerRewardSchema.optional().describe('What the referrer receives when a referral converts. Absent means nothing.'),
34
+ referredReward: ReferredRewardSchema.optional().describe('What the referred account receives. Absent means nothing.'),
35
+ codeValidityDays: z.number().int().min(1).default(30).describe('How many days a referral code can be redeemed after it is issued. Defaults to 30.'),
36
+ }).default(() => ({ enabled: false, codeValidityDays: 30 })),
37
+ ```
38
+
39
+ ### Origin Package: `@wildo-ai/saas-models`
40
+
41
+ ```typescript
42
+ /** What the referrer receives when the referral converts. */
43
+ export const ReferrerRewardSchema = z.object({
44
+ type: z.enum(ReferrerRewardType).systemEnum('ReferrerRewardType').describe('What the referrer receives: `credit`, `discount` or `feature`.'),
45
+ ...rewardFields,
46
+ }).superRefine(refineRewardShape);
47
+ export type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;
48
+
49
+ /** What the referred account receives. */
50
+ export const ReferredRewardSchema = z.object({
51
+ type: z.enum(ReferredRewardType).systemEnum('ReferredRewardType').describe('What the referred account receives: `credit`, `discount`, `feature` or `trial_extension`.'),
52
+ ...rewardFields,
53
+ trialExtensionDays: z.number().int().min(1).optional().describe('For a `trial_extension` reward: the days added to the trial of a subscription checkout the referred account opens while the referral is accepted.'),
54
+ }).superRefine(refineRewardShape);
55
+ export type ReferredReward = z.infer<typeof ReferredRewardSchema>;
56
+ ```
57
+
58
+ ## Declaring the program
59
+
60
+ ```ts
61
+ billing: {
62
+ // …
63
+ referrals: {
64
+ enabled: true,
65
+ referrerReward: { type: ReferrerRewardType.CREDIT, credits: 500, creditPoolKey: 'ai_tokens' },
66
+ referredReward: { type: ReferredRewardType.TRIAL_EXTENSION, trialExtensionDays: 14 },
67
+ codeValidityDays: 30,
68
+ },
69
+ }
70
+ ```
71
+
72
+ - **Off by default.** Issuing codes that promise rewards is the application's commercial decision.
73
+ - **Rewards are server policy.** Nobody can send a reward with a request. The rewards are copied onto
74
+ each referral when its code is issued, so a later change here applies to codes issued afterwards and
75
+ never re-prices a referral already made.
76
+ - **Each reward kind takes its own fields, and only those.** Startup refuses a `credit` reward without
77
+ `creditPoolKey`, and a `discount` reward carrying a `featureKey`. The table below lists the fields.
78
+ - **A `featureKey` must name a registered boolean feature.** Startup warns about one that does not,
79
+ and an unregistered feature grants nothing.
80
+ - Turning `enabled` off stops new codes. Codes already issued can still be redeemed and converted.
81
+
82
+ ## What each reward does, and when
83
+
84
+ | kind | fields | delivered |
85
+ |---|---|---|
86
+ | `credit` | `credits`, `creditPoolKey` | at conversion, as a credit-pool top-up counted in `totalGranted` (not `totalPurchased`). The pool is created if the account has none |
87
+ | `feature` | `featureKey`, `durationDays?` | from conversion, for `durationDays` (or for good when absent). It is derived rather than stored, and the hourly reconciliation run removes it within the hour after it lapses |
88
+ | `discount` | `percentOff`, `discountDuration`, `discountDurationInMonths` (for `repeating` only) | at conversion, as a provider coupon on the account's active subscription. An account with no active subscription keeps the reward waiting, and gets it as soon as a subscription appears. The discounts the subscription already carries are kept, and the subscription's `discounts` lists every one of them in the order the provider applies them, so a referral coupon added beside a promotion appears as a second entry |
89
+ | `trial_extension` | `trialExtensionDays` | referred side only. Added to the trial of every subscription checkout the account opens while its referral is accepted, so it has already been used by the time the account pays |
90
+
91
+ The referrer side has no `trial_extension`: the referrer is an existing customer.
92
+ There is no commission reward. The framework has no way to pay one out.
93
+
94
+ ## The lifecycle
95
+
96
+ | step | who | operation |
97
+ |---|---|---|
98
+ | issue a code | an owner of the referring organization | `ISSUE` on the organization's referrals |
99
+ | redeem it | the new customer's billing account (organization owner/admin, or the user) | `REDEEM_REFERRAL` on the billing account, body `{ referralCode }` |
100
+ | convert | the billing provider, through the first paid invoice with a total above zero | automatic |
101
+ | grant | the framework, once for each side, even when the provider sends the invoice again | automatic |
102
+ | cancel | an owner of the referring organization, while the referral is pending or accepted | `CANCEL` on the referral |
103
+
104
+ A redemption is refused (`BILLING_REFERRAL_CODE_INVALID`) for an unknown, used, cancelled or expired
105
+ code. It is refused (`BILLING_REFERRAL_ACCOUNT_NOT_ELIGIBLE`) when the account issued the code itself,
106
+ already has a subscription, has already paid an invoice, or has already been referred. A referral
107
+ program is for NEW customers, and each account can be referred once.
108
+
109
+ Only an organization can issue codes, because the referral row belongs to the referring organization.
110
+ The referred account can be an organization or a user.
@@ -3,8 +3,8 @@
3
3
  `behaviorPolicy` on a product definition — trial, upgrade, downgrade, cancellation — plus
4
4
  `billing.defaultBehaviorPolicy` in the backend config for the application-wide values.
5
5
 
6
- Read it before declaring one, because two of its fields do not do what their names promise, and
7
- money depends on the difference.
6
+ Read it before declaring one: a downgrade takes effect at the end of the period unless you say
7
+ otherwise, an upgrade takes effect at once, and money depends on knowing which.
8
8
 
9
9
  ```ts
10
10
  behaviorPolicy: {
@@ -19,7 +19,8 @@ behaviorPolicy: {
19
19
 
20
20
  | field | effect |
21
21
  |---|---|
22
- | `upgrade.proration` / `downgrade.proration` | passed to the provider as a request field. A downgrade declared `NONE` is not prorated |
22
+ | `upgrade.proration` / `downgrade.proration` | passed to the provider as a request field for an IMMEDIATE change. A downgrade declared `NONE` is not prorated |
23
+ | `upgrade.timing` / `downgrade.timing` | when the change takes effect. `immediate` applies it on confirmation; `at_period_end` schedules it at the provider and applies it at renewal. Defaults: upgrade `immediate`, downgrade `at_period_end` |
23
24
  | `cancellation.allowImmediate: false` | a **REFUSAL**. Effective immediate timing gets a `409`, whether requested explicitly or inherited from a default; it is never silently downgraded to period-end |
24
25
  | `cancellation.defaultBehavior` | decides the timing when the caller expresses NO preference (`cancelImmediately` absent) |
25
26
  | `trial.days` / `trial.requirePaymentMethod` | both reach the provider |
@@ -33,15 +34,29 @@ is permitted even when a default is immediate. Do not author `defaultBehavior: I
33
34
  contradiction. The runtime also protects previously stored or unparsed policies and application
34
35
  fallbacks.
35
36
 
36
- ## ⚠️ What is NOT honoured
37
-
38
- **`upgrade.timing` / `downgrade.timing` change nothing.** A provider's proration parameter says HOW a
39
- change settles, not WHEN it applies. Deferring a change to the period end needs a subscription
40
- schedule — a different call and a different mechanism the shipped adapter does not make. The timing
41
- travels as metadata so a connector that grows one can read it, and it is inert today.
42
-
43
- So a downgrade declared `AT_PERIOD_END` applies **immediately**, at the declared proration. If a
44
- product must not change mid-period, that has to be built; declaring it here does not do it.
37
+ ## When a plan change takes effect
38
+
39
+ The NEW plan's `timing` decides it, for the direction of the move: `upgrade.timing` for a move onto
40
+ this plan from a lower tier (or from no plan), `downgrade.timing` for a move from a higher or equal
41
+ tier.
42
+
43
+ - **`immediate`** (the upgrade default): the change applies on confirmation, and `proration` settles
44
+ the unused part of the period. For a downgrade, `NONE` gives the customer no credit for the higher
45
+ plan they paid for, and `CREATE_PRORATIONS` credits it on the next invoice.
46
+ - **`at_period_end`** (the downgrade default): confirming changes nothing now. The provider is given a
47
+ schedule, the subscription carries the change as `pendingPlanChange` (the plan, `effectiveAt`, the
48
+ lines it will then have), and renewal applies it: the items move, entitlements follow, and the
49
+ pending change is cleared. The preview shows the renewal invoice on the new plan, and says
50
+ `timing: at_period_end` with the `effectiveAt` date — show both to the customer.
51
+
52
+ While a change is pending, another plan change, an add-on change and a cancellation are refused
53
+ (`409 billing_subscription_plan_change_pending`). `CANCEL_PLAN_CHANGE` withdraws the pending change,
54
+ and the subscription then renews on its current plan — until five minutes before `effectiveAt`, after
55
+ which it is refused (`409 billing_subscription_plan_change_taking_effect`): the change is landing.
56
+ A deferred change is refused while a cancellation is pending
57
+ (`409 billing_plan_change_subscription_pending_cancellation`: resume first), and when the lines the
58
+ subscription would then carry do not share one billing interval
59
+ (`409 billing_plan_change_billing_interval_mismatch`: a yearly add-on beside a monthly plan).
45
60
 
46
61
  **`defaultCurrency` and `supportedCurrencies` constrain nothing.** No billing path reads either. The
47
62
  currency that reaches the provider is the one on the price's own money value, so an application can
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: configure-coding-agent
3
- description: Configure the autonomous coding agent that edits this application's own workspace — which agent runs, how much it may do without asking, and how much of the host's agent configuration it inherits. Use when the user says "set up the coding agent", "let the AI edit my app", "switch to Codex / OpenCode", "use a different model for coding tasks", "the coding agent can't start", "execution profile not found", "my coding run changed nothing", or "the agent asked for permission and there was nobody to answer", "the research step can't find its profile", or "config sync says the workspace-mutation lock is held". Covers authoring the ACP execution profile, choosing a ceiling that works for a dispatched run, and the per-agent limits you cannot configure away.
3
+ description: Configure the autonomous coding agent that edits this application's own workspace — which agent runs, how much it may do without asking, and how much of the host's agent configuration it inherits. Use when the user says "set up the coding agent", "let the AI edit my app", "switch to Codex / OpenCode", "use a different model for coding tasks", "the coding agent can't start", "the coding agent is not signed in", "execution profile not found", "my coding run changed nothing", or "the agent asked for permission and there was nobody to answer", "the research step can't find its profile", or "config sync says the workspace-mutation lock is held". Covers authoring the ACP execution profile, choosing a ceiling that works for a dispatched run, and the per-agent limits you cannot configure away.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Configuring the coding agent
@@ -54,7 +55,10 @@ three, because the others are self-explanatory and these are not.
54
55
  ### Step 1 — Decide whether you need to author anything
55
56
 
56
57
  A scaffolded application already has a working `claude-code-acp` profile. If you
57
- are not changing the agent, the model, or the autonomy, **stop here**.
58
+ are not changing the agent, the model, or the autonomy, **stop here** — after
59
+ checking that the agent is signed in on this machine: `wildo local doctor`
60
+ names the selected agent and fails when it is not (see
61
+ `references/agent-selection.md` for switching agents and signing in).
58
62
 
59
63
  ### Step 2 — Author the profile
60
64
 
@@ -211,6 +215,8 @@ read — evidence for a later step to work from, not a validated artifact.
211
215
 
212
216
  ## Verification
213
217
 
218
+ - [ ] The selected agent is signed in on this machine (`wildo local doctor`
219
+ passes its coding-agent line).
214
220
  - [ ] The profile's key is the ref the coding lane resolves (`claude-code-acp`
215
221
  unless you deliberately renamed it and updated the selection).
216
222
  - [ ] `allowedApplicationEnvironments` lists DEVELOPMENT only.
@@ -239,6 +245,9 @@ rg -U 'AGENT_CLIENT_PROTOCOL' -A 200 wildo.saas.config.ts | rg -c 'modelDestinat
239
245
 
240
246
  # The research steps resolve this exact profile ref. No match = every research step is refused.
241
247
  rg "'claude-code-acp-research':" wildo.saas.config.ts
248
+
249
+ # The selected agent is signed in on this machine (the coding-agent line must pass).
250
+ wildo local doctor
242
251
  ```
243
252
 
244
253
  ## Common Rationalizations