@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
@@ -21,6 +21,67 @@ policies. A selected transition preference alone does not guarantee the final pa
21
21
  **A higher tier silently outranks a lower one.** If a layout change appears to do nothing, look UP the
22
22
  chain before doubting the layout: an operation-level override answers before any zone map does.
23
23
 
24
+ **Tier 5 has a fallback, so `fromOverlay` is optional.** An overlay is not a structural zone, and a
25
+ structural navigation out of one lands in PRIMARY — so when `fromOverlay` does not answer (it is not
26
+ declared, or it names other operations), the verb AND the appearance come from PRIMARY's own
27
+ declarations rather than from the framework default. Declare `fromOverlay` only when leaving an
28
+ overlay should differ from an ordinary click on the page. Before this, a layout that carefully
29
+ declared `READ: SPLIT` on primary and nothing about overlays sent every link out of a dialog to the
30
+ framework fallback `PUSH`, taking the whole page.
31
+
32
+ ## Which tier answered is RECORDED — stop guessing it
33
+
34
+ Every tier can answer `PUSH`, so the outcome alone never tells you which one spoke. The resolution
35
+ carries the answer:
36
+
37
+ ```ts
38
+ resolution.provenance.transitionSource // 'operation-override' | 'authored-action-presentation'
39
+ // | 'relationship' | 'viewport-override'
40
+ // | 'source-transitions' | 'overlay-fallback-to-primary'
41
+ // | 'derived-action-presentation' | 'framework-default'
42
+ resolution.provenance.authoredTransition // the verb that tier produced, BEFORE any adjustment
43
+ resolution.provenance.adjustments // what changed it afterwards, in order
44
+ ```
45
+
46
+ The navigation controller logs all three (`decidedBy`, `authoredAs`, `adjustments`), so turning its
47
+ debug channel on answers "why did it land there" directly instead of by re-deriving the chain against
48
+ the layout.
49
+
50
+ **`framework-default` is the one to look for.** It means NOTHING you declared answered for that
51
+ operation — usually a transitions map that names `read` and says nothing about the operation you are
52
+ debugging, or an override whose `fromZone` did not match.
53
+
54
+ `adjustments` names the things that overrule an authored verb, each of which is otherwise invisible:
55
+
56
+ | adjustment | what happened |
57
+ |---|---|
58
+ | `split-opened-free-pane` | the pane was empty and the split opened it |
59
+ | `split-replaced-occupied-pane` | the pane was taken, and its content was replaced — correct for a list/detail application, and worth seeing |
60
+ | `split-escalated-no-adjacent-zone` | you declared `SPLIT` and the layout declares no pane, so it became a dialog |
61
+ | `embedded-coerced-to-overlay` | an `EMBEDDED` view was headed for a structural zone and was escalated, because a zone is not a host |
62
+ | `responsive-collapse-push` / `responsive-collapse-overlay` | the target zone is collapsed at this viewport |
63
+ | `depth-ceiling-escalated-to-overlay` | the push would have passed `maxDepth` |
64
+ | `persistent-split-escalated-no-companion` | a `persistent` split targets the COMPANION only, and the layout declares none — so it became a dialog. Declaring a `secondary` does not help here |
65
+ | `inplace-degraded-to-overlay` | an `INPLACE` transition had no element to transform in place, so the operation opened as an overlay with its own presentation |
66
+
67
+ ## The layout is CHECKED at boot, and four mistakes now say so
68
+
69
+ An authored layout is read at application start and anything it declares that the runtime will
70
+ silently do differently is logged with its remedy — `error` for a wrong outcome, `warn` for a
71
+ declaration that does nothing. Non-fatal always: a split that renders as a dialog must never stop an
72
+ application from booting.
73
+
74
+ | reported | meaning |
75
+ |---|---|
76
+ | `split-without-adjacent-zone` | a `SPLIT` anywhere in the layout, and no `zones.secondary` or `zones.companion`. Every one of those splits is a dialog |
77
+ | `persistent-split-without-companion` | a `persistent` split targets `companion` SPECIFICALLY and does not fall back to `secondary`, so it escalates even in a layout that declares a pane |
78
+ | `inert-primary-zone-field` | `minWidth`, `maxWidth`, `onEmpty` or `responsiveCollapse` on `zones.primary`, where all four do nothing — primary never collapses, never empties, and takes the space the others leave |
79
+ | `zone-width-bounds-inverted` | `minWidth` greater than `maxWidth` |
80
+
81
+ What it deliberately does NOT report: a `secondary` zone that no layout transition splits into. That
82
+ is a perfectly good configuration — the split can come from a resource's own `navigationOverrides`,
83
+ which the layout cannot see.
84
+
24
85
  ## Where each verb puts the content
25
86
 
26
87
  | verb | lands in | keeps the source visible |
@@ -28,12 +89,27 @@ chain before doubting the layout: an operation-level override answers before any
28
89
  | `push` / `replace` | the SAME zone | no — one item is visible at a time |
29
90
  | `split` | the first adjacent zone (secondary, else companion) | yes — this is the list-detail pattern |
30
91
  | `overlay` | the overlay layer | yes, visually; interactivity depends on the overlay's behaviour |
31
- | `promote` | PRIMARY, clearing secondary and companion | no — it abandons the current context deliberately |
92
+ | `promote` | PRIMARY, clearing secondary and companion — except a pane placed by a `persistent` split | no — it abandons the current context deliberately |
32
93
  | `inplace` | nowhere — it transforms an element and changes no zone | |
33
94
 
34
95
  `split` needs an adjacent zone to exist in the layout. If none is declared it escalates to an overlay
35
96
  rather than failing, so a layout that "does not split" is usually a layout with one zone.
36
97
 
98
+ ## Two rules about the OVERLAY layer that are not in the tier list
99
+
100
+ **An EMBEDDED read is coerced out of the structural zones — EXCEPT into a FREE pane.** An operation
101
+ declared `EMBEDDED` has no route of its own, so it opens in a HOST rather than as the page. The one
102
+ exemption is a `SPLIT` whose target pane is currently EMPTY: that is a drill-in host rather than a
103
+ surface being taken over, so the content opens IN the pane. The consequence for an author is that
104
+ **the same click is a pane or a popup depending on what is already open** — an aspect clicked while
105
+ the pane is free fills the pane; the same aspect clicked while the pane holds a record opens as an
106
+ overlay. That is deliberate, and it means "this shows a popup" is a statement about STATE. An
107
+ operation that must ALWAYS be a popup says so with its own `OVERLAY` override.
108
+
109
+ **An overlay opened FROM an overlay STACKS.** Opening one from the page replaces an empty stack;
110
+ opening one from inside an overlay pushes, so Back returns to the one beneath and a graph of
111
+ references is walkable popup to popup and walkable back out. Nothing to declare.
112
+
37
113
  ## The URL contract, which decides more than it looks like it does
38
114
 
39
115
  **Structural zones are URL-addressed. The overlay layer is not.**
@@ -54,6 +130,16 @@ restores both; browser back closes the pane; the host's own query params (`?sect
54
130
  while the pane is open. Nothing to declare: the split transition on the zone is enough, and the
55
131
  composition is chosen from what primary holds at the moment of the click.
56
132
 
133
+ That hosting has three limits, all following from the reload path, which rebuilds `?pane=` by
134
+ resolving it as a RESOURCE route:
135
+
136
+ - **Only resource records are hosted.** A composite view, chart or custom view opened in the pane
137
+ keeps its own URL, which replaces the host's; a reload then shows that view rather than the board.
138
+ - **Only `secondary` is hosted.** A companion opened beside a hosted pane gets no address of its own:
139
+ the URL keeps the host and `?pane=`, and a reload restores those two. Writing the companion's own
140
+ URL would drop `?pane=`, and the pane reconciler would close the pane.
141
+ - **The host needs a URL.** A primary with no address has nothing for the pane to ride on.
142
+
57
143
  **Query params that are not addresses are view state.** Route ownership compares destinations, not
58
144
  URL strings: a view that writes `?section=` or `?dataMode=` onto its own URL keeps its zone entry (no
59
145
  rebuild, no remount). Only the framework's context params (`composite_ctx_*`, `chart_ctx_*`,
@@ -81,19 +167,33 @@ inert, it is stale.
81
167
 
82
168
  - **`ZoneConfig.contentModel: TABBED` renders parallel tabs.** Every entry in the zone is a tab, all
83
169
  stay mounted (so switching refetches nothing), the tab bar is visible, and the ACTIVE tab shows
84
- rather than the top of the stack. A tabbed zone is FLAT: depth navigation from inside a tab goes to
85
- the next zone or to an overlay. Only the active tab is URL-addressable today, so a refresh restores
86
- one tab.
170
+ rather than the top of the stack. The content model changes RENDERING, not resolution: every
171
+ navigation that lands in the zone — including one from inside a tab — opens a new tab and makes it
172
+ active, and an already-open record is not de-duplicated. Only the active tab is URL-addressable
173
+ today, so a refresh restores one tab.
87
174
  - **`NavigationLayout.maxDepth` caps push depth.** When the target zone's depth REACHES it, the push
88
175
  becomes an overlay. A relationship's own `maxDepth` overrides the layout's for that chain. The
89
176
  ceiling is measured against the zone the content actually lands in — so a split that collapsed into
90
177
  primary answers to primary's ceiling.
91
178
  - **`ZoneConfig.responsiveCollapse` places content.** Below the breakpoint a secondary or companion
92
179
  zone's content goes into PRIMARY (`PUSH`) or over it (`OVERLAY`), and it remembers which zone it
93
- came from. **Declaring nothing means `PUSH`**: the content areas render a single zone on a phone, so
180
+ came from. That applies to content ALREADY in the pane as well as to new navigations: narrow the
181
+ window and the pane's whole history moves into primary (a tabbed pane's tabs too, the one on
182
+ screen on top); widen it and what is still on top of primary goes home. What the reader navigated
183
+ past at the narrow width stays where it is. **Declaring nothing means `PUSH`**: the content areas render a single zone on a phone, so
94
184
  an undeclared zone would silently swallow anything routed to it. Collapse applies only at a known
95
185
  narrow breakpoint — an unmeasured viewport is not a narrow one.
96
186
 
187
+ **It has a SECOND trigger: the content area cannot carry the split.** A breakpoint measures the
188
+ WINDOW, and the panes live in the content area, which is narrower by the sidebar, narrower again
189
+ when another pane is open, and whatever an embedded shell gives the application. A split needs the
190
+ pane's floor plus primary's 25%, so a zone declaring `minWidth: W` needs a content area of
191
+ `W / 0.75`; below that it escalates to the same `responsiveCollapse` mode even at a desktop
192
+ breakpoint, instead of squeezing both panes below their declared floors. An unmeasured width never
193
+ escalates. It is reachable on an ordinary desktop window: a 1024px window with a 256px sidebar
194
+ leaves a 768px content area, so any `minWidth` above 576px escalates there — and `minWidth` does
195
+ this whether or not the split is `resizable`.
196
+
97
197
  ## Three behaviours that read backwards from their field names
98
198
 
99
199
  - **`orientation` names the DIVIDER.** `VERTICAL` is a vertical divider, so the panes sit SIDE BY SIDE;
@@ -135,6 +235,13 @@ is a question nobody has answered.
135
235
  known; until then no structure changes. A zone that HAS content still shows it immediately — having
136
236
  content is a fact about the zone, not a decision owned by primary.
137
237
 
238
+ **`onEmpty` also decides whether the pane can be CLOSED.** A zone that collapses when empty carries a
239
+ close control, because closing it returns the width; a zone declaring `EMPTY_STATE` does not, because
240
+ "closing" it would swap a record for a placeholder and give no room back. There is no second flag,
241
+ and a close button added in the view is how the two drift. Closing clears the zone's whole stack —
242
+ it is not Back, which pops one entry — and writes the address of what remains, so a reload does not
243
+ reopen the pane.
244
+
138
245
  The consequence for an application: `onEmpty: EMPTY_STATE` on a zone whose destinations override it
139
246
  with `COLLAPSE` no longer flashes a reserved pane on every navigation. Measured before the fix on a
140
247
  2400px window: the primary content area went 2312 → 1294 → 2312 within ~25ms on each tab click, so the
@@ -20,11 +20,11 @@ Read `how-navigation-resolves.md` for the precedence between them. This file is
20
20
  | field | what it decides | status |
21
21
  |---|---|---|
22
22
  | `zones.primary` | the always-present zone. Required. | live |
23
- | `zones.secondary` | the first adjacent zone. Declaring it is what makes `split` possible at all. | live |
23
+ | `zones.secondary` | the first adjacent zone. Declaring it is what makes `split` possible at all — **a `split` in a layout without one silently becomes a dialog**, and is reported at boot as `split-without-adjacent-zone`. | live |
24
24
  | `zones.companion` | a second adjacent zone for persistent side content. | live |
25
25
  | `appLevel.transitions` | what a SIDEBAR / command-palette / hotkey navigation does. App-level navigation is a layout reset. | live |
26
26
  | `appLevel.appearance` | appearance for app-level transitions. | live |
27
- | `fromOverlay.transitions` | what a navigation STARTED INSIDE an overlay does. | live |
27
+ | `fromOverlay.transitions` | what a navigation STARTED INSIDE an overlay does. **Optional** — an operation it does not answer falls back to PRIMARY's map (verb and appearance), because an overlay is not a structural zone and that navigation lands in primary. Declare it only when leaving an overlay should differ from an ordinary click on the page. | live |
28
28
  | `split` | inter-zone geometry — see §3. | live |
29
29
  | `backAffordanceOwner` | `SURFACE` (the back control sits in the surface's own header) or `SHELL` (one fixed control in the app shell). One application-wide decision, so the duplication is unrepresentable. | live |
30
30
  | `maxDepth` | the push ceiling. When a zone's stack depth REACHES it, the next push opens an overlay instead. A relationship's own `maxDepth` overrides it for that chain. | live |
@@ -35,11 +35,11 @@ Read `how-navigation-resolves.md` for the precedence between them. This file is
35
35
  | field | what it decides | status |
36
36
  |---|---|---|
37
37
  | `transitions` | operation → verb, FROM this zone. The ordinary way navigation is configured. | live |
38
- | `appearance.split` / `appearance.overlay` | which shape a `split` or `overlay` from this zone takes (`PANEL`/`DRAWER`, `DIALOG`/`SHEET`/`DRAWER`). Viewport-discriminable. | live |
39
- | `onEmpty` | `COLLAPSE` (zone hides, neighbours expand) or `EMPTY_STATE` (zone stays with a placeholder). Adjacent zones only. | live |
40
- | `minWidth` / `maxWidth` | drag bounds in pixels, converted to a share of the content area and clamped to 5–70%. Only meaningful on a resizable zone — `split.resizable` for secondary, `split.companion.resizable` for companion. **Omitting one is not "unbounded"**: an undeclared `minWidth` is a 25% floor (or the zone's ratio share, if smaller) and an undeclared `maxWidth` leaves primary 25%. No pane collapses on a drag — see `how-navigation-resolves.md`. | live |
41
- | `responsiveCollapse` | below the breakpoint, does this zone's content `PUSH` into primary or `OVERLAY` on top. Viewport-discriminable. **Omitting it means `PUSH`** — the content areas render one zone on a phone, so a zone that declares nothing would swallow anything routed to it. | live |
42
- | `contentModel` | `SINGLE` (top of the stack is visible, back pops) or `TABBED` (every entry is a parallel tab, tab bar visible, the ACTIVE one shows). A tabbed zone is FLAT: depth navigation from inside a tab goes to the next zone or an overlay. | live |
38
+ | `appearance.overlay` | which shape an `overlay` opened from this zone takes (`DIALOG`/`SHEET`/`DRAWER`). Viewport-discriminable. There is no `appearance.split`: a pane's shape is `split.orientation`, and the earlier `SplitAppearance` was removed because nothing read it. | live |
39
+ | `onEmpty` | `COLLAPSE` (zone hides, neighbours expand) or `EMPTY_STATE` (zone stays with a placeholder). Adjacent zones only. **Also decides whether the pane can be CLOSED**: a collapsing zone carries a close control, because closing returns the width; an `EMPTY_STATE` zone does not. No second flag, and a close button in the view is how the two drift. | live |
40
+ | `minWidth` / `maxWidth` | drag bounds in pixels, converted to a share of the content area and clamped to 5–70%, on a resizable zone — `split.resizable` for secondary, `split.companion.resizable` for companion. **`minWidth` has a second meaning on EVERY zone, resizable or not**: it is a collapse trigger (see `responsiveCollapse` below), so a floor on a static pane can stop the split on a desktop window. **Omitting one is not "unbounded"**: an undeclared `minWidth` is a 25% floor (or the zone's ratio share, if smaller) and an undeclared `maxWidth` leaves primary 25%. No pane collapses on a drag — see `how-navigation-resolves.md`. | live |
41
+ | `responsiveCollapse` | below the breakpoint, does this zone's content `PUSH` into primary or `OVERLAY` on top. Viewport-discriminable. **Omitting it means `PUSH`** — the content areas render one zone on a phone, so a zone that declares nothing would swallow anything routed to it. It also fires when the CONTENT AREA cannot carry the split: a zone declaring `minWidth: W` needs `W / 0.75` of content width beside primary's 25%, and below that escalates rather than squeezing both panes under their floors. | live |
42
+ | `contentModel` | `SINGLE` (top of the stack is visible, back pops) or `TABBED` (every entry is a parallel tab, tab bar visible, the ACTIVE one shows). It changes RENDERING only: every navigation landing in a tabbed zone — including one from inside a tab — opens a new, active tab, with no de-duplication. To send a link from inside a tab elsewhere, declare it in the zone's `transitions`. | live |
43
43
 
44
44
  Every field above is read by the runtime. `defaultVisible` was on this table as **NOT READ** and was
45
45
  removed from the schema in #211 — what it reached for is `onEmpty`, which is live and which every
@@ -49,9 +49,9 @@ current layout uses.
49
49
 
50
50
  | field | what it decides | status |
51
51
  |---|---|---|
52
- | `ratio` | `[primary, adjacent]` percentages at open. | live |
52
+ | `ratio` | the ADJACENT pane's opening share, as `ratio[1]` (a percentage). `ratio[0]` is not read: primary takes whatever is left, so `[40, 30]` opens primary at 70%. | live |
53
53
  | `orientation` | the DIVIDER's orientation: `VERTICAL` → side by side, `HORIZONTAL` → the second pane below. | live |
54
- | `resizable` | whether the divider can be dragged. **`false` also makes `minWidth`/`maxWidth` inert**, because a static split has no drag to bound. | live |
54
+ | `resizable` | whether the divider can be dragged. `false` makes `minWidth`/`maxWidth` inert AS DRAG BOUNDS, because a static split has no drag — but `minWidth` still decides whether the pane collapses at this content width. | live |
55
55
  | `companion` | `ratio` and `resizable` again, for the companion zone. It does NOT take its own `orientation`: all zones share one panel group, whose direction comes from `split.orientation`. | live |
56
56
 
57
57
  Every field above is read by the runtime. Two were removed from the schema in #211 because nothing
@@ -76,7 +76,7 @@ In `resourceUIBehavior(...)`, on a `views` entry:
76
76
 
77
77
  | field | what it decides |
78
78
  |---|---|
79
- | `surface` | `ADDRESSABLE` (a routable page — required for a URL), `EMBEDDED` (renders inside a host, no route of its own), `API_ONLY` (headless). Navigation cannot address an operation that is not `ADDRESSABLE`. |
79
+ | `surface` | `ADDRESSABLE` (a routable page — required for a URL), `EMBEDDED` (renders inside a host, no route of its own), `API_ONLY` (headless). Navigation cannot address an operation that is not `ADDRESSABLE`. An `EMBEDDED` read is coerced out of the structural zones EXCEPT into a FREE pane — so the same click is a pane when the pane is empty and a popup when it is taken. Declare an `OVERLAY` override when it must always be a popup. |
80
80
  | `navigationOverrides[]` | the EXCEPTION. `transition`, `appearance`, `overlayBehavior`, narrowed by `fromZone` and `viewport`. First match wins, resolved ahead of the zone's map. |
81
81
  | `adjacentZoneOnEmpty` / `zoneContentMaxWidth` / `zoneContentFillsHeight` | as §4, for a resource operation rather than a view. |
82
82
 
@@ -1,5 +1,5 @@
1
1
  # Navigation Layout
2
2
 
3
- - Zones (sidebar, launcher, overlays) transition via framework navigation types.
3
+ - The navigation zones are `primary`, `secondary` and `companion`; an overlay is a LAYER above them, not a zone. The sidebar, menubar and launchers are app-shell chrome — they START navigations, they are not zones (`choosing-a-navigation-shape.md`, "The sidebar is NOT a zone").
4
4
  - Changing zone behavior impacts `resource-ui-behavior` operation views and deep links.
5
5
  - Keep navigation config typed — import from `@wildo-ai/saas-frontend-lib` patterns used locally.
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: config-saas
3
3
  description: Edit `wildo.saas.config.ts` for modules, services, engineCapabilities, provider scopes, providerConfigurations, bootstrap, data-service prefixes, and the application's compliance declarations. Use when the user says "add the <module-name> module", "wire a new minion/worker", "enable the <capability> capability", "switch the email provider to <x>", "turn on billing/organizations", "record our legal entity", "declare which jurisdictions we operate in", "set the retention schedule", or any change at the SaaS root that re-shapes app composition or states what is legally true of the application.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Config SaaS
@@ -195,7 +196,8 @@ What is **not** in this block (and shouldn't be):
195
196
  - `references/framework-content-security-policy-api.md` — the `csp` block on any frontend: opt-in by absence, the generated artifact is the only one read, and why report-only without a collector does nothing
196
197
  - `references/framework-value-moments-api.md` — `analytics.valueMoments`: why `role` changes three things at once, and why a declared moment with analytics off is evaluated by nothing
197
198
  - `references/framework-audit-trail-config-api.md` — the `auditTrail` block: why `archiveAfterDays` is the opt-in and why setting it never shrinks the primary store
198
- - `references/framework-systems-of-record-api.md` — `systemsOfRecord`: declaring a deployment your application reads its OWN rows out of, why it is not a provider, and the three files its name, address and credential live in
199
+ - `references/framework-systems-of-record-api.md` — `systemsOfRecord`: declaring a deployment your application reads its OWN rows out of, why it is not a provider, and the three files its name, address and credential live in; an instance's `facetAugmentations` opts it into packages that ADD a partition or a credential kind to its vendor's facet — see `resource-external-data`'s `references/facet-augmentations.md`
200
+ - `providers.packages` — the provider packages discovery does not walk by name (another scope's, or an own-scope one not named `provider-*`) that the application admits to discovery; listing activates nothing, and `wildo config sync` refuses a listing that admits nothing — see `provider-backend-package`'s `references/framework-provider-package-allow-list-api.md`
199
201
  - `references/saas-config-scope.md` — what belongs in root SaaS config
200
202
  - `references/framework-wildo-saas-config-api.md` — `WildoSaasConfigSchema` / inferred types
201
203
  - `references/framework-provider-capabilities-api.md` — engine slots and provider capability vocabulary, including durable email selection
@@ -114,6 +114,11 @@ answer must never be inferred from a currency, a language or a customer address.
114
114
 
115
115
  - **`dataRetention`** — a schedule per record kind. This is the source a retention clause quotes; an
116
116
  absent schedule means the notice says retention is not established, not that data is kept forever.
117
+ It is also what the engine ENFORCES: run `wildo config data-retention` after changing it so the
118
+ running application carries it (`compliance.dataRetention`), and bind resources to a class with
119
+ `retentionBinding` (skill `resource-retention-binding`). Two older settings derive from it and are
120
+ refused if they disagree: `tenantTeardown.retentionWindowDays` (from `RESOURCE_DATA`) and
121
+ `auditTrail.archiveAfterDays` (from `AUDIT_LOGS`) — leave both unset.
117
122
  - **`aiUsePosture`** — what AI features do with application data. Absent means uninventoried; if the
118
123
  application declares an AI capability and no posture, a notice must say the question is open.
119
124
  - **`clientStorage`** — per frontend surface, what is stored on the device. Here an **empty array is a
@@ -122,6 +127,8 @@ answer must never be inferred from a currency, a language or a customer address.
122
127
  - **`providerComplianceChoices`** — per configured provider, who runs it and where it processes. The
123
128
  provider declares what is POSSIBLE; this is the operator's CHOICE among those. Without it a produced
124
129
  notice would call an audit ledger you host yourself a third-party recipient.
130
+ `purposeRefs` names the lawful-basis purposes (`lawfulBases[].purposeRef`) sending data to it serves,
131
+ so a notice can say what each recipient is used for.
125
132
 
126
133
  ## Where these are read
127
134
 
@@ -5,8 +5,12 @@ ways to misread it.
5
5
 
6
6
  ## `archiveAfterDays` is the opt-in, and it deletes nothing
7
7
 
8
- **Unset**, the archival job still runs and does nothing. Every audit record stays in the primary store
9
- indefinitely — an application that has never set this is accumulating, not rotating.
8
+ **Unset**, the horizon is the application's declared `dataRetention[AUDIT_LOGS]` period — the audit
9
+ trail's live-store horizon — so one number answers "how long is the audit trail kept". Setting both to
10
+ different values is refused at startup; leave this unset and declare the class. With neither, the
11
+ archival job does nothing and every audit record stays in the primary store indefinitely — an application
12
+ that has decided nothing is accumulating, not rotating. The 365-day production floor applies to the
13
+ derived value exactly as to an authored one.
10
14
 
11
15
  **Set**, it still does not shrink the primary store. `AUDIT_LOGS` is immutable by invariant: it has no
12
16
  UPDATE and no DELETE. Records older than the horizon are COPIED to durable archival artifacts in file
@@ -37,9 +41,12 @@ is a smaller primary store, this is not the mechanism.
37
41
  * `AuditTrailConfig` — application-level operator-tunable configuration for the
38
42
  * compliance audit-trail subsystem.
39
43
  *
40
- * ⚠️ **`archiveAfterDays` IS the opt-in, and it never deletes anything.** While it is unset the
41
- * archival job still runs and does nothing, and every audit record stays in the primary store
42
- * indefinitely — so an application that has never set it is accumulating, not rotating.
44
+ * ⚠️ **The archival horizon comes from ONE of two places, and it never deletes anything.** It is
45
+ * `archiveAfterDays` when set, otherwise the declared `dataRetention[AUDIT_LOGS]` period (#1613,
46
+ * `resolveAuditArchiveAfterDays`); an application that declares both with different values is refused at
47
+ * startup, so the two cannot disagree. With NEITHER, the archival job still runs and does nothing, and every
48
+ * audit record stays in the primary store indefinitely — accumulating, not rotating. Declaring the
49
+ * `AUDIT_LOGS` period therefore turns archival ON.
43
50
  *
44
51
  * Setting it does not shrink the primary store either. `AUDIT_LOGS` is immutable by invariant: it
45
52
  * has no UPDATE and no DELETE, so records older than the horizon are COPIED to durable archival
@@ -75,9 +82,7 @@ is a smaller primary store, this is not the mechanism.
75
82
  * remain in the always-on `AUDIT_LOGS` store (and, when configured, in the
76
83
  * append-only immudb tamper-proof ledger). This is why the field is named
77
84
  * `archiveAfterDays` and not `retentionDays`: nothing is retained-then-deleted;
78
- * the value is purely the ARCHIVAL HORIZON. (The distinction mirrors the
79
- * `archiveAfterDays` vs `retentionDays` split in the general
80
- * `DataRetentionPolicySchema`.)
85
+ * the value is purely the ARCHIVAL HORIZON.
81
86
  *
82
87
  * --------------------------------------------------------------------------
83
88
  * Why the config lives in `saas-models` (not next to the batch)
@@ -128,9 +133,14 @@ export const AuditTrailConfigSchema = z.object({
128
133
  * archival horizon only (see the block-level JSDoc on why the field is
129
134
  * `archiveAfterDays`, not `retentionDays`).
130
135
  *
131
- * OPTIONAL — when omitted (`undefined`), NO archival runs and audit records
132
- * are retained in the primary store indefinitely. This is the compliance-safe
133
- * default: an operator must explicitly opt in before any archival happens.
136
+ * OPTIONAL, and **single-sourced to the retention schedule (#1613)**: when
137
+ * omitted, the horizon is the application's declared
138
+ * `dataRetention[AUDIT_LOGS].retentionDays` — the period the audit trail is
139
+ * kept in the live store before it is archived — so one number answers "how
140
+ * long is the audit trail kept" instead of two that drift. Setting both to
141
+ * DIFFERENT values is refused at startup. With neither declared, NO archival
142
+ * runs and audit records stay in the primary store indefinitely. Resolve it
143
+ * through {@link resolveAuditArchiveAfterDays}, never by reading this field.
134
144
  *
135
145
  * Bounds: min 1 / max 2555 (≈ 7 years), mirroring the SSO
136
146
  * `auditConfig.retentionDays` precedent. A production floor of 365 days is
@@ -106,7 +106,7 @@ trying one of them teaches the wrong rule.
106
106
  * application ENABLES them — the engine-level MAIN floor (#328).
107
107
  *
108
108
  * The asymmetry is the thing to carry away: **enabling a capability with nothing serving it fails at
109
- * BOOT for these three and at the point of USE for every other slot.** So an author who tries one
109
+ * BOOT for these four and at the point of USE for every other slot.** So an author who tries one
110
110
  * unserved slot, sees the application come up, and concludes that an unserved capability degrades
111
111
  * gracefully has learned the wrong rule from the larger half of the vocabulary.
112
112
  *
@@ -121,6 +121,9 @@ trying one of them teaches the wrong rule.
121
121
  * - `BILLING` — `initializeBillingServices` already fails loud with no
122
122
  * provider; the floor names it in the same place as the others.
123
123
  * - `SMS` — phone verification and MFA-by-SMS are engine flows.
124
+ * - `EMAIL_INBOUND` — enabling it declares that work arrives by email; with no
125
+ * provider nothing hosts the receiving domain, so every message is lost
126
+ * before the engine sees it and nothing anywhere records that it was (#1630).
124
127
  *
125
128
  * DELIBERATELY ABSENT, with the reason each would need to overturn:
126
129
  * - the `AI_*` slots — consumed per feature (an agent, the logo generator)
@@ -149,5 +152,6 @@ export const ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED: ReadonlySet<
149
152
  EngineCapability.EMAIL_TRANSACTIONAL,
150
153
  EngineCapability.BILLING,
151
154
  EngineCapability.SMS,
155
+ EngineCapability.EMAIL_INBOUND,
152
156
  ]);
153
157
  ```
@@ -42,6 +42,32 @@ try an `ORGANIZATION` target, and on the refusal call again with an `APPLICATION
42
42
  your own code, where the substitution is visible to whoever reads it next. An engine that did it
43
43
  underneath would hide the one fact the call is about.
44
44
 
45
+ ## Which stored row a call spends: the connection, not the ref
46
+
47
+ A tenant's or a person's stored credential is keyed `(owner, connectionRef, secretSlug)`. The
48
+ resolution below asks the registry for the ref's ADDRESS — the connection it belongs to and the slot's
49
+ contract key — and reads that row. An undeclared ref is its own connection, so a call through ref `slack` spends the
50
+ row stored for connection `slack`. Refs listed together under `providers.sharedConnections` spend ONE grant: a call
51
+ through a member spends the row stored for the connection's BASE ref, and a person connects that vendor once,
52
+ through any of them. The connection is never yours to pass: you name the ref, the framework resolves the rest, and
53
+ the audit trail records both.
54
+
55
+ ```ts
56
+ // wildo.saas.config.ts — three Microsoft refs, one Microsoft connection per owner
57
+ providers: defineSaaSProviders({
58
+ scopes: { backend: { providers: { microsoft: {}, 'microsoft-teams': {}, 'microsoft-dataverse': {} } } },
59
+ sharedConnections: { microsoft: { refs: ['microsoft-teams', 'microsoft-dataverse'] } },
60
+ }),
61
+ ```
62
+
63
+ What a person sees follows the declaration: the connected-accounts settings screen offers ONE Microsoft
64
+ connection to connect and, once connected, shows ONE Microsoft row naming Teams and Dataverse among the features
65
+ it serves, with one Disconnect that ends access for all of them.
66
+
67
+ `providers.sharedConnections` is not `providers.connections`: that one narrows which owners may connect a ref.
68
+ The base's rules — who owns the OAuth client, the resource audiences, what config sync refuses — are in the
69
+ `provider-backend-package` skill's `framework-provider-shared-connection-api.md`.
70
+
45
71
  ## Import Origins
46
72
 
47
73
  - `@wildo-ai/saas-backend-lib`
@@ -108,6 +134,13 @@ underneath would hide the one fact the call is about.
108
134
  providerRef: string,
109
135
  protocolKind: ExternalProvider_ExchangeProtocol_Kind,
110
136
  secretRef: string,
137
+ /**
138
+ * A resource AUDIENCE other than the grant's primary (#1725): the token is minted from the stored grant's
139
+ * refresh token for these scopes (or read from the audience cache), never the stored primary token. Absent:
140
+ * the stored credential, as always. Meaningless for an APPLICATION target, which holds no grant to mint from,
141
+ * and refused there.
142
+ */
143
+ options?: { readonly audience?: ProviderOAuth2RefreshAudience },
111
144
  ): Promise<{
112
145
  value: string;
113
146
  source: ProviderCredentialResolutionSource;
@@ -151,7 +184,9 @@ underneath would hide the one fact the call is about.
151
184
  + 'This is a wiring fault rather than a missing credential.',
152
185
  );
153
186
  }
154
- const userSecretSlug = this.canonicalCredentialSlug(providerRef, secretRef);
187
+ // The row's ADDRESS: the connection the ref belongs to (#1670) and the contract KEY of the slot,
188
+ // never the env-var spelling a rename can move (#624). One answer for every read path.
189
+ const { connectionRef: userConnectionRef, secretSlug: userSecretSlug } = this.resolveCredentialAddress(providerRef, secretRef);
155
190
  // A name the provider no longer declares is never sent to the store: its row would still open,
156
191
  // because the seal binds the name it was stored under, and spend a credential this subsystem
157
192
  // reports as unusable (#624). The miss path below then names that row as retired.
@@ -159,16 +194,19 @@ underneath would hide the one fact the call is about.
159
194
  const ownedByUser = userSlotRetired ? undefined : await userResolver.resolveUserCredential({
160
195
  userId: target.ownerId!,
161
196
  providerRef,
162
- // The store is keyed on the contract KEY, never the env-var spelling a rename can move.
163
- // See `canonicalCredentialSlug` (#624).
197
+ connectionRef: userConnectionRef,
164
198
  secretSlug: userSecretSlug,
199
+ ...(options?.audience === undefined ? {} : { audience: options.audience }),
165
200
  });
166
201
  if (!ownedByUser) {
167
202
  const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, userSlotRetired ? undefined : userSecretSlug, ExternalProvider_Connection_OwnerScope.USER, () =>
168
- userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef }));
203
+ userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef, connectionRef: userConnectionRef }));
204
+ const storedBeforeJoining = await this.describeRowStoredBeforeJoining(providerRef, userConnectionRef, () =>
205
+ userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef, connectionRef: providerRef }));
169
206
  throw this.buildConnectionRefusal(
170
207
  providerRef,
171
- (retiredSlots.length === 0
208
+ storedBeforeJoining
209
+ + (retiredSlots.length === 0
172
210
  ? `user '${target.ownerId}' has not connected '${secretRef}'. `
173
211
  : `user '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
174
212
  + `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
@@ -186,6 +224,13 @@ underneath would hide the one fact the call is about.
186
224
  }
187
225
 
188
226
  if (target.ownerScope === ExternalProvider_Connection_OwnerScope.APPLICATION) {
227
+ if (options?.audience !== undefined) {
228
+ throw this.buildConnectionRefusal(
229
+ providerRef,
230
+ `the application's own credential cannot serve the '${options.audience.id}' audience: a token for another resource `
231
+ + 'is minted from a connected account\'s refresh token, and the deployment\'s credential is a pasted token with none.',
232
+ );
233
+ }
189
234
  const fromEnvironment = this.getProviderSecret(providerRef, protocolKind, secretRef);
190
235
  if (fromEnvironment) {
191
236
  return { value: fromEnvironment, source: ProviderCredentialResolutionSource.DEPLOYMENT_ENVIRONMENT };
@@ -208,21 +253,26 @@ underneath would hide the one fact the call is about.
208
253
  + 'This is a wiring fault rather than a missing credential.',
209
254
  );
210
255
  }
211
- const organizationSecretSlug = this.canonicalCredentialSlug(providerRef, secretRef);
256
+ // The row's ADDRESS — connection and contract KEY — see the USER branch above (#1670, #624).
257
+ const { connectionRef: organizationConnectionRef, secretSlug: organizationSecretSlug } = this.resolveCredentialAddress(providerRef, secretRef);
212
258
  // Never sends a RETIRED name to the store — see the USER branch above (#624).
213
259
  const organizationSlotRetired = this.classifyStoredCredentialSlot(providerRef, organizationSecretSlug) === StoredCredentialSlotStanding.RETIRED;
214
260
  const owned = organizationSlotRetired ? undefined : await resolver.resolveOrganizationCredential({
215
261
  organizationId: target.ownerId!,
216
262
  providerRef,
217
- // Keyed on the contract KEY — see `canonicalCredentialSlug` (#624).
263
+ connectionRef: organizationConnectionRef,
218
264
  secretSlug: organizationSecretSlug,
265
+ ...(options?.audience === undefined ? {} : { audience: options.audience }),
219
266
  });
220
267
  if (!owned) {
221
268
  const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, organizationSlotRetired ? undefined : organizationSecretSlug, ExternalProvider_Connection_OwnerScope.ORGANIZATION, () =>
222
- resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef }));
269
+ resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef, connectionRef: organizationConnectionRef }));
270
+ const storedBeforeJoining = await this.describeRowStoredBeforeJoining(providerRef, organizationConnectionRef, () =>
271
+ resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef, connectionRef: providerRef }));
223
272
  throw this.buildConnectionRefusal(
224
273
  providerRef,
225
- (retiredSlots.length === 0
274
+ storedBeforeJoining
275
+ + (retiredSlots.length === 0
226
276
  ? `organization '${target.ownerId}' has no credential for '${secretRef}'. `
227
277
  : `organization '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
228
278
  + `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
@@ -64,6 +64,18 @@ export enum EngineCapability {
64
64
 
65
65
  EMAIL_TRANSACTIONAL = 'EMAIL_TRANSACTIONAL',
66
66
  EMAIL_MARKETING = 'EMAIL_MARKETING',
67
+ /**
68
+ * The application RECEIVES email: work arrives as messages to an address the application routes to
69
+ * an organization, and a channel handler decides what each message causes (#1630). The selected
70
+ * provider hosts the receiving domain, signs a notification per message and serves the message on
71
+ * request; the engine owns verification, deduplication, sender assurance, threads and replies.
72
+ *
73
+ * What it does NOT mean: a verified sender is identification, never authentication. A message's
74
+ * sender assurance gates what a handler accepts and grants no authority — the handler acts with
75
+ * the roles it declares, whoever wrote. Replies go out through `EMAIL_TRANSACTIONAL`, so the two
76
+ * slots may be served by different vendors.
77
+ */
78
+ EMAIL_INBOUND = 'EMAIL_INBOUND',
67
79
  SMS = 'SMS',
68
80
 
69
81
  AI_LLM = 'AI_LLM',
@@ -225,6 +237,18 @@ export enum EngineCapability {
225
237
  export const BUILTIN_PROVIDER_CAPABILITY = {
226
238
  EMAIL_TRANSACTIONAL: 'EMAIL_TRANSACTIONAL',
227
239
  EMAIL_MARKETING: 'EMAIL_MARKETING',
240
+ /**
241
+ * Provider RECEIVES email for the application: it hosts the MX for a receiving domain, notifies the
242
+ * application of each message through a signed webhook, and serves the message (bodies,
243
+ * authentication results, attachments) on request. Maps to `EngineCapability.EMAIL_INBOUND`.
244
+ *
245
+ * A token of its own rather than a reading of `EMAIL_TRANSACTIONAL`, because sending and receiving
246
+ * are separate procurement decisions: one vendor may send and another receive, and threading only
247
+ * needs standard headers, so the two never have to agree (#1630). Delivery of the notification is
248
+ * NOT this capability — like billing's, it rides the `WEBHOOK_ORIGINATOR` protocol through an
249
+ * endpoint whose `capability` names this token.
250
+ */
251
+ EMAIL_INBOUND: 'EMAIL_INBOUND',
228
252
  SMS: 'SMS',
229
253
  /**
230
254
  * Single billing-engagement capability covering everything from
@@ -272,9 +296,31 @@ export const BUILTIN_PROVIDER_CAPABILITY = {
272
296
  IMAGE_GENERATION: 'IMAGE_GENERATION',
273
297
  FRONTEND_ERROR_MONITORING: 'FRONTEND_ERROR_MONITORING',
274
298
  FRONTEND_PRODUCT_ANALYTICS: 'FRONTEND_PRODUCT_ANALYTICS',
299
+ /**
300
+ * A hosted search a browser module brings to a surface. The engine ships no provider for it since #1737
301
+ * (Algolia DocSearch loaded nothing; the documentation site searches its own generated index). Kept
302
+ * because an application or package module may still declare one, and the consent classification and the
303
+ * privacy disclosure map both answer for it.
304
+ */
275
305
  FRONTEND_SEARCH: 'FRONTEND_SEARCH',
276
306
  FRONTEND_FILE_PICKER: 'FRONTEND_FILE_PICKER',
277
307
  FRONTEND_CAPTCHA: 'FRONTEND_CAPTCHA',
308
+ /**
309
+ * A browser component that turns what a person types into a STRUCTURED postal address — the
310
+ * `z_address()` value — optionally with the vendor's own identifier for the place it matched (#1702,
311
+ * consumed by the address field of #561).
312
+ *
313
+ * The component's contract is `ProviderAddressLookupProps` (`@wildo-ai/saas-models`): it hands back a
314
+ * `ProviderAddressLookupSelection`. Whether the vendor's place id comes back at all is a static
315
+ * declaration on the component (`placeIdRetention`), refused at the framework boundary when a selection
316
+ * contradicts it — the #383 pattern — and the id is never stored (#561 D3). The component reaches its
317
+ * vendor through the application backend's provider-operation door, never from the page (#561 D2).
318
+ *
319
+ * Fills no engine slot: nothing in the engine requires an address lookup to exist, and a field that
320
+ * finds none is typed by hand. Needs no consent at the capability floor (the person asked for the
321
+ * lookup); a vendor whose terms make it more than that adds purposes on its own module.
322
+ */
323
+ FRONTEND_ADDRESS_LOOKUP: 'FRONTEND_ADDRESS_LOOKUP',
278
324
  /**
279
325
  * Backend LLM-call observability — a provider that ingests per-`invokeAgent`
280
326
  * generation traces (model / tokens / cost / latency), e.g. PostHog