@wildo-ai/framework-knowledge 1.1.5 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (837) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +321 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  338. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  339. package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
  340. package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
  341. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  342. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  343. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  344. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  345. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  346. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  347. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  348. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  349. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  354. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  355. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  356. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  357. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  358. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  359. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  360. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  361. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  362. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  363. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  364. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
  365. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  366. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  367. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  368. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  369. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  370. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  371. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  372. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  373. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  374. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  375. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  376. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  377. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  378. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  379. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  380. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  382. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  383. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  384. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  385. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  386. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  387. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  388. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  389. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  390. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  391. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  392. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  393. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  394. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  395. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  396. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  397. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  398. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  399. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  400. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  401. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  406. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  407. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  408. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  409. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  410. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  411. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  412. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  413. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  414. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  415. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  416. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  417. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  418. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  419. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  420. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  421. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  422. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  426. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  427. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  428. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  431. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  432. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  433. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  435. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  437. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  438. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  439. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  440. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  441. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  442. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  443. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  445. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  446. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  448. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  450. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  451. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  452. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  453. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  454. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  455. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  460. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  461. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  462. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  463. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  464. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  466. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  467. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  468. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  469. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  470. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  471. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  472. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  473. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  474. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  475. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  476. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  477. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  478. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  479. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  480. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  481. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  482. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  483. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  484. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  485. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  486. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  487. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  488. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  489. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  490. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  491. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  492. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  493. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  494. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  495. package/dist/knowledge/references/website-plan.config.md +39 -6
  496. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  497. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  498. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  500. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  501. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  502. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  503. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  504. package/dist/knowledge/references/zod.factories.address.md +7 -7
  505. package/dist/knowledge/references/zod.factories.code.md +2 -2
  506. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  507. package/dist/knowledge/references/zod.factories.money.md +3 -3
  508. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  509. package/dist/knowledge/registries/framework-topics.json +1248 -54
  510. package/dist/knowledge/registries/playbooks.json +81 -109
  511. package/dist/knowledge/registries/source-tags.json +3201 -1118
  512. package/dist/knowledge/rules/live-context-door.md +29 -0
  513. package/dist/knowledge/skills/INDEX.md +27 -24
  514. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  522. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  526. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  528. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  529. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  530. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  531. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  532. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  533. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  540. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  541. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  543. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
  544. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  545. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  546. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  547. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  551. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  552. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  553. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  554. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  555. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  556. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  557. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  558. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  559. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  560. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  561. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  562. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  564. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  565. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  566. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  568. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  569. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  570. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  571. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  572. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  573. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  574. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  575. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  576. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  577. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  578. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  579. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  581. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  582. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  587. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  595. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  596. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  599. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  600. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  602. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  604. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  605. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  607. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  608. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  609. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  612. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  613. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  614. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  615. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  616. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  617. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  624. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
  625. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  626. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  627. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  628. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  629. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  630. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  631. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  632. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  633. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  634. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  635. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  636. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  637. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  638. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  639. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  640. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  642. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  644. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  645. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  646. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  647. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  648. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  649. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  650. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  651. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  652. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  653. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  657. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  658. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  659. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  660. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  661. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  662. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  663. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  664. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  665. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  666. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  667. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  670. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  671. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  672. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  677. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  678. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  682. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  683. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  684. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  685. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  686. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  687. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  688. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  693. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  694. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  695. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  696. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  697. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  698. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  699. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  700. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  701. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  702. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  703. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  710. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  711. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  712. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  713. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  714. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  715. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  716. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  717. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  718. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  719. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  720. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  721. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  722. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  723. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  724. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  725. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  726. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  727. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  728. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  729. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  730. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  731. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  732. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  733. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  734. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  739. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  740. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  741. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  742. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  743. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  747. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  748. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  749. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  755. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  756. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  757. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  758. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  759. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  763. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  764. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  765. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  766. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  767. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  768. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  769. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  770. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  771. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  773. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  774. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  775. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  776. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  777. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  778. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  779. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  780. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  781. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  782. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  783. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  784. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  785. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  786. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  787. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  788. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  789. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  790. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  791. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  792. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  793. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  794. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  795. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  796. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  797. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  798. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  799. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  800. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  801. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  802. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  803. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  804. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  805. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  807. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  809. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  811. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  813. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  815. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  817. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  819. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  820. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  821. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  822. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  823. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  824. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  825. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  826. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  827. package/dist/knowledge/topic-index.json +5957 -1729
  828. package/dist/tsconfig.build.tsbuildinfo +1 -1
  829. package/dist/tsconfig.tsbuildinfo +1 -1
  830. package/package.json +4 -4
  831. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  832. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  833. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  834. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  835. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  836. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  837. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,127 @@
1
+ # Growing a connection by the scope an operation needs
2
+
3
+ Read this when:
4
+
5
+ - a call is refused with `PROVIDER_OPERATION_SCOPE_NOT_GRANTED` (or a backend call throws the executor's scope
6
+ refusal) and you need to let the person grant the missing permission;
7
+ - you are building the screen or prompt that offers the re-authorization;
8
+ - an audit row of `*_PROVIDER_CONNECTION_GRANTED` carries `addedScopes`.
9
+
10
+ ## What the refusal carries
11
+
12
+ An operation declares the vendor scopes it needs (`requiredScopes`). Before any request leaves, the executor
13
+ compares them with the scopes the stored grant RECORDS; a missing one refuses the call and nothing is sent. The
14
+ refusal carries a `reauthorization` offer for a connection a person or an organization owns (never for the
15
+ application's own deployment credential, which an operator re-issues):
16
+
17
+ - `requestableScopes` — the missing scopes a person may grant now, by re-authorizing the connection;
18
+ - `administratorConsentScopes` — missing scopes only an administrator of the connected account can grant
19
+ (the provider declares them; they are never put in a request a person is sent to);
20
+ - `unrequestableScopes` — missing scopes nobody can ask for on this connection, each with its `refusal`:
21
+ undeclared by every ref of the connection and every opted-in augmentation, outside the connection's
22
+ resource audiences, carrying a placeholder, or naming a NON-primary audience (a Dataverse environment on a
23
+ Graph-primary Microsoft connection) — such a permission is consented statically: the operator lists it on the
24
+ registration and the person reconnects.
25
+
26
+ The offer's types come from `@wildo-ai/saas-models` (`ProviderScopeReauthorizationOffer`,
27
+ `ProviderConnectionScopeRefusal`), so a component can read the 409 body typed. A backend service catches the
28
+ executor's `ProviderOperationScopeError` (from `@wildo-ai/saas-backend-lib`), whose `detail.reauthorization` is the
29
+ same offer.
30
+
31
+ ## Import Origins
32
+
33
+ - `@wildo-ai/saas-models`
34
+
35
+ ## Source Excerpts
36
+
37
+ ### Origin Package: `@wildo-ai/saas-models`
38
+
39
+ ```typescript
40
+ /** Why a scope cannot be requested on a connection. */
41
+ export enum ProviderConnectionScopeRefusal {
42
+ /** No declared ref and no opted-in augmentation of the connection declares it. An author declares it first. */
43
+ NOT_DECLARED_BY_CONNECTION = 'NOT_DECLARED_BY_CONNECTION',
44
+ /** It names a resource none of the connection's declared audiences covers. */
45
+ OUTSIDE_CONNECTION_AUDIENCES = 'OUTSIDE_CONNECTION_AUDIENCES',
46
+ /**
47
+ * A member or augmentation scope carrying a `{placeholder}`: it can be resolved only against its own declaring ref's
48
+ * allowances, which are inert inside a connection, so it is never a value a request could carry.
49
+ */
50
+ CARRIES_PLACEHOLDER = 'CARRIES_PLACEHOLDER',
51
+ /** Only an administrator of the account can grant it; a person is never sent to consent to it. */
52
+ ADMINISTRATOR_CONSENT_REQUIRED = 'ADMINISTRATOR_CONSENT_REQUIRED',
53
+ /**
54
+ * It names a declared audience OTHER than the primary one (a Dataverse environment, Business Central, Power BI on a
55
+ * Graph-primary Microsoft connection). A vendor that mints one resource per request answers an authorization with a
56
+ * token for the resource the request names, and the stored grant holds the PRIMARY audience's token — so growing the
57
+ * grant with another resource's scope would put that resource's token where every primary call reads it. Such a
58
+ * permission is consented statically (the operator lists it on the registration, and the person reconnects); the
59
+ * audience's token is then minted from the refresh token as before.
60
+ */
61
+ NOT_PRIMARY_AUDIENCE = 'NOT_PRIMARY_AUDIENCE',
62
+ }
63
+
64
+ /**
65
+ * What a refused call hands back so the person can grow the grant (#1671) — carried by `ProviderOperationScopeError`
66
+ * and the browser door's `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED`.
67
+ *
68
+ * `requestableScopes` is exactly what `POST /connections/:providerRef/start` accepts as `addScopes`; the other two
69
+ * lists are what no re-authorization can obtain, each with its own remedy.
70
+ */
71
+ export interface ProviderScopeReauthorizationOffer {
72
+ /** The connection whose grant grows. */
73
+ readonly connectionRef: string;
74
+ /** The ref to start the re-authorization through — the one the refused call used. */
75
+ readonly providerRef: string;
76
+ /** The operation that needs them, echoed as `forOperationId` so the grant's audit row names its cause. */
77
+ readonly operationId: string;
78
+ /** The missing scopes a person may grant now. Empty when none can be. */
79
+ readonly requestableScopes: readonly string[];
80
+ /** Missing scopes only an administrator of the account can grant. */
81
+ readonly administratorConsentScopes: readonly string[];
82
+ /** Missing scopes no re-authorization of this connection can ask for, with why. */
83
+ readonly unrequestableScopes: readonly { readonly scope: string; readonly refusal: ProviderConnectionScopeRefusal }[];
84
+ }
85
+ ```
86
+
87
+ ## Offering the re-authorization
88
+
89
+ Start the connect flow for the SAME target with `addScopes` set to `requestableScopes`, and `forOperationId` set to
90
+ the offer's `operationId`, then send the person to the returned `authorizeUrl` exactly as for a first connect:
91
+
92
+ ```ts
93
+ const { authorizeUrl } = await getManualCallsHttpClient().startProviderConnection(offer.providerRef, {
94
+ target, // the connection the refused call spent
95
+ addScopes: [...offer.requestableScopes],
96
+ forOperationId: offer.operationId,
97
+ });
98
+ window.location.assign(authorizeUrl);
99
+ ```
100
+
101
+ - The request asks for the missing scopes only — never every scope every ref of the connection could use. The
102
+ connection's refs and the application's OPTED-IN augmentations bound what may be asked (the ceiling); an
103
+ installed package that is not opted in widens nothing.
104
+ - The stored connection's parameters (the directory, the tenant) are reused, so do not send `scopes` or
105
+ `connectionParameters` with `addScopes`; the start refuses them.
106
+ - An organization's connection can be grown only by the member who linked it, whatever its delegation; one that lends
107
+ that member's own vendor account still carries `acknowledgesOrganizationWideUse: true`.
108
+ - `forOperationId` is checked: it must name an operation of the ref that requires every scope added.
109
+ - After the person consents, the stored grant records the ACCUMULATED consent: what was granted before plus the
110
+ new scopes, even when the vendor's answer names only the new one. The operation then succeeds, and so does
111
+ every operation that already worked.
112
+ - Signing in does not create or grow a connection. A person's sign-in and a data connection are separate
113
+ records, by default on separate registrations; the first data connection is a connect, and later scopes grow it.
114
+
115
+ The start leg answers:
116
+
117
+ | Status | `error` | Meaning |
118
+ |---|---|---|
119
+ | 409 | `NO_GRANT_TO_EXTEND` | The target holds no enabled connection with an authorization to grow — connect it first |
120
+ | 400 | `SCOPE_NOT_REQUESTABLE` | A scope is administrator-only or not requestable on the connection; `administratorConsentScopes` / `unrequestableScopes` name them |
121
+ | 409 | `SCOPES_ALREADY_GRANTED` | The grant already records every scope asked for |
122
+ | 403 | `NOT_THE_LINKING_MEMBER` | The organization's connection was linked by another member; only that member can grow it |
123
+ | 400 | `OPERATION_DOES_NOT_REQUIRE_SCOPES` | `forOperationId` names no operation of the ref, or one that does not require every scope added |
124
+
125
+ The completed grant is recorded as `USER_PROVIDER_CONNECTION_GRANTED` / `ORGANIZATION_PROVIDER_CONNECTION_GRANTED`
126
+ with `addedScopes`, `addedForOperationId`, `addedForPackageName` (whose operation asked — an augmentation's
127
+ package or the provider's own) and `consentAccumulated`.
@@ -5,6 +5,10 @@ export, an XML document, an empty 204) or its body is raw bytes.
5
5
 
6
6
  - `responseDecoding` decides how the answer is read, and sets the default `Accept` header.
7
7
  - `requestBody.encoding` decides how the input becomes the body; `TEXT` and `BINARY` need `contentType`.
8
+ - `pathTemplate` is RELATIVE to the provider's base URL and must start with `/`. It is appended to the
9
+ base URL, so a template such as `@host/x` or `.host/x` would move the request to another host; every
10
+ call is refused when its URL leaves the base URL's origin, and an augmentation's templates must
11
+ additionally be plain paths (no `//`, backslash, whitespace or `.`/`..` segment).
8
12
 
9
13
  ## Import Origins
10
14
 
@@ -271,5 +275,26 @@ export interface ProviderRestOperationCatalogue {
271
275
  readonly domains: readonly string[];
272
276
  /** Keyed by `operationId`. */
273
277
  readonly operations: Readonly<Record<string, ProviderRestOperation>>;
278
+ /**
279
+ * Which package contributed an operation that the provider's OWN module does not declare, keyed by
280
+ * `operationId` (#1672). Absent on every catalogue a provider module loads itself; set only by the
281
+ * framework when it merges an opted-in AUGMENTATION into a provider it does not own.
282
+ *
283
+ * A catalogue value and not a property of the operation, on purpose: an operation declaration is the
284
+ * augmentation author's data, and a field the author could write would let a package claim to be
285
+ * somebody else. The merge refuses a loaded catalogue that already carries this field.
286
+ *
287
+ * Read by the operation executor, which writes the contributor into the `PROVIDER_OPERATION_CALL` audit
288
+ * row: a call spending a shared grant must say whose code declared the request it sent.
289
+ */
290
+ readonly augmentedBy?: Readonly<Record<string, ProviderRestOperationContributor>>;
291
+ }
292
+
293
+ /** The package that contributed an operation to a provider it does not own (#1672). */
294
+ export interface ProviderRestOperationContributor {
295
+ /** The augmentation package's npm name, as its own manifest states it. */
296
+ readonly packageName: string;
297
+ /** The installed version of that package, as `wildo config sync` read it from the manifest. */
298
+ readonly packageVersion: string;
274
299
  }
275
300
  ```
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: rate-limit-authoring
3
3
  description: Author per-endpoint rate limits — declare a `rateLimit?` policy on a resource operation variant (declarative path) or call `RateLimitBackendService.checkPolicy(req, res, policy, scopeKey, organizationId?, clientIdOverride?)` from a custom controller (hand-wired path). Use when the user says "rate-limit this endpoint", "add a per-IP cap", "throttle the magic-link / OTP / password-reset / register flow", "the endpoint is being abused", "tune the OAuth / SCIM token quota", or "the headers don't show the right `X-RateLimit-Reset`".
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Rate-Limit Authoring
@@ -482,6 +483,11 @@ canonical multi-window per-IP policy on its anonymous `CREATE` — the same
482
483
  requestsPerMinute: 5,
483
484
  requestsPerHour: 30,
484
485
  },
486
+ // …and, when the application declares a captcha provider, a visitor answers a challenge before the lead is
487
+ // written (#1985): the engine asks it in `doOperation`, documents the header in the API reference, and refuses
488
+ // an unanswered or refused submission with 400. The rate limit stays the primary control: a bot can always
489
+ // choose the proof of work, which costs it milliseconds.
490
+ submissionChallenge: { action: SubmissionChallengeAction.INBOUND_CONTACT },
485
491
  // The lead's marketing opt-in is a consent DECISION: the server stamps its instant (#534).
486
492
  basicPrefixOperation: ({ inputDto }) => buildConsentDecisionPatch(inputDto, undefined),
487
493
  authoritativeFields: ['privacy'],
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: resource-add-field
3
3
  description: Add a new field to an existing resource end-to-end across shared schema, frontend UI behavior, specification, resources-config, and i18n labels. Use when the user says "add a field to <resource>", "give <resource> a <type> field", "add an enum/status/priority field", "add a foreign key to <other resource>", or "extend <resource> with <field>" — i.e. when the intent is a real resource capability change, not just a one-file schema edit.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Resource Add Field — Workflow
@@ -90,9 +90,8 @@ resource:
90
90
  // switches cards / FK previews to ICON — the compact icon-only badge
91
91
  // (label stays available to assistive tech and on hover).
92
92
  priority: sh.priority.enumUI({
93
- display: { displayMode: EnumDisplayMode.BADGE, showDescription: true },
93
+ display: { displayMode: EnumDisplayMode.BADGE },
94
94
  summaryOverride: { displayMode: EnumDisplayMode.ICON },
95
- edit: { showDescription: true },
96
95
  values: {
97
96
  [Todos_Priority.LOW]: { color: BadgeSemanticVariant.SECONDARY, icon: ArrowDown },
98
97
  [Todos_Priority.MEDIUM]: { color: BadgeSemanticVariant.DEFAULT, icon: Minus },
@@ -286,7 +286,11 @@ export interface BusinessKeySetParams {
286
286
  * stays above its target until the rate changes; it reports when it stops early;
287
287
  * - a resource CANNOT declare both a lifetime and retrieval-source fields (`.ragSource()`). That
288
288
  * pair is refused at startup, because rows expiring under a native index leave with no
289
- * application code running, so the derived search chunks could never be removed with them.
289
+ * application code running, so the derived search chunks could never be removed with them;
290
+ * - a resource scoped to an ORGANIZATION cannot declare a lifetime at all. For the same reason
291
+ * no legal hold could suspend the deletion, and a hold on an organization covers every row of
292
+ * it. A lifetime is for application-level plumbing; tenant data binds a retention class
293
+ * (`retentionBinding`), whose sweep deletes through the service layer and skips held rows.
290
294
  *
291
295
  * This is unrelated to `retentionPolicy`, which decides what an ERASURE does to a row that must
292
296
  * SURVIVE. This one decides whether the row lives at all.
@@ -376,6 +380,31 @@ export enum CollectionDisplayMode {
376
380
  TABLE = 'table',
377
381
  }
378
382
 
383
+ /**
384
+ * Whether a collection's toolbar OFFERS the free-form filters panel (the "Filters" trigger and the
385
+ * panel it opens), authored on a LIST operation's `collectionDisplayConfig.filterPanel`.
386
+ *
387
+ * ## Why this exists
388
+ *
389
+ * A collection whose useful narrowings are already one click away — a `quickFilterField` tab strip,
390
+ * a row of `presetFilters` pills — often has no need for the general-purpose panel beside them, and
391
+ * a third way to write the same filter state is clutter in the action lane. This lets the author say
392
+ * so, without giving up the backend's `filterFields` (the tabs and pills write into exactly those).
393
+ *
394
+ * ## What HIDDEN does NOT hide
395
+ *
396
+ * The active-filter CHIPS stay. They are the readout of what is currently narrowing the list and the
397
+ * only way to clear a value that arrived by another door (a deep link, a restored view). Hiding them
398
+ * with the trigger would let a filter be active and invisible — a list that silently shows less than
399
+ * it says. The quick-filter tabs and the preset pills are unaffected: they are their own surfaces.
400
+ */
401
+ export enum CollectionFilterPanelVisibility {
402
+ /** The "Filters" trigger and its panel are offered whenever the operation has filter fields. The default. */
403
+ OFFERED = 'offered',
404
+ /** No trigger and no panel — narrowing happens through the tabs and pills only; the chips remain. */
405
+ HIDDEN = 'hidden',
406
+ }
407
+
379
408
  /**
380
409
  * A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
381
410
  *
@@ -598,8 +627,8 @@ export enum ActionPlacement {
598
627
  *
599
628
  * `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions
600
629
  * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one
601
- * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at
602
- * all, because none of them is a destination: nothing is pushed, no zone changes, and there is
630
+ * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER`, `DROPDOWN` and `INLINE` never enter
631
+ * navigation at all, because none of them is a destination: nothing is pushed, no zone changes, and there is
603
632
  * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —
604
633
  * see `InPlaceOperationContext` for why that is not the navigation layer's job.
605
634
  *
@@ -611,7 +640,8 @@ export enum ActionPlacement {
611
640
  * ## When omitted
612
641
  *
613
642
  * It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An
614
- * operation that asks for nothing executes directly; a small field set opens a modal; input the
643
+ * operation that asks for nothing executes directly; one choice from an enum or a reference is a
644
+ * DROPDOWN; one or two simple fields open an anchored POPOVER; a small field set opens a modal; input the
615
645
  * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it
616
646
  * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author
617
647
  * has already said it is a deep-linkable destination.
@@ -630,11 +660,35 @@ export enum ResourceOperationActionPresentation {
630
660
  /**
631
661
  * A small form anchored to the button that opened it, dismissed by clicking away.
632
662
  *
633
- * The single-input idiom ("assign to…", "snooze until…"). Transient by construction: no URL, no
663
+ * The small-input idiom ("snooze until…", "reject with a reason…" — a ONE-CHOICE input such as
664
+ * "assign to…" is a {@link DROPDOWN}). Transient by construction: no URL, no
634
665
  * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user
635
666
  * is reading the row they are acting on and must not lose sight of it.
636
667
  */
637
668
  POPOVER = 'popover',
669
+ /**
670
+ * A list of the operation's admissible VALUES, anchored to the button; picking one executes the
671
+ * operation with it. No form, no Submit — the pick IS the submission.
672
+ *
673
+ * The "Status ▾" / "Assign ▾" idiom: an operation whose whole input is ONE choice from an
674
+ * enumerable domain. Two domains qualify, and each renders the list it deserves:
675
+ * - an ENUM field — its values, labelled exactly as the form would label them;
676
+ * - a REFERENCE (a foreign-key field) — a SEARCHABLE list of the referenced records, queried
677
+ * server-side as you type, scoped exactly like the form's reference picker.
678
+ *
679
+ * Transient like {@link POPOVER}, and it shares the popover's host and degrades: collapsed into
680
+ * the overflow menu or a subgroup — where nothing can anchor — it opens as an overlay form.
681
+ *
682
+ * **It cannot be a deliberate act.** A pick that executes has no second step, so an operation
683
+ * whose risk level asks for a confirmation (HIGH / CRITICAL), a BULK operation (one pick would
684
+ * rewrite every selected row), or one whose input is not one choice field, resolves to
685
+ * {@link POPOVER} instead even when this is authored: a panel holding the same control plus an
686
+ * explicit Submit. See `resolveResourceOperationActionPresentation`.
687
+ *
688
+ * Not to be confused with `ActionLabelDisplayMode.DROPDOWN`, which is about the BAR — whether its
689
+ * actions collapse into an overflow menu. This is about one action's INPUT.
690
+ */
691
+ DROPDOWN = 'dropdown',
638
692
  /**
639
693
  * The element being acted on transforms in place to collect the input, leaving its neighbours
640
694
  * visible — the row becomes the form rather than being covered by one.
@@ -889,10 +943,41 @@ export const ResourceOperationFrontendConfigSchema = z.object({
889
943
  * row id still rides the URL path too, which the handler may ignore.)
890
944
  */
891
945
  rowTargetRequestField: z.string().optional(),
946
+ /**
947
+ * How this operation runs when it is update-like (`resourceOperationLike: UPDATE`) and targets one
948
+ * row. Omitted means {@link UpdateLikeMutationFallbackMode.RMM_REQUIRED}: it runs through the row's
949
+ * RMM and fails closed without one, which is right for anything that edits the row's own fields.
950
+ *
951
+ * Declare `DIRECT_OPERATION_FALLBACK` for an ACTION on a row whose resource has no field-write
952
+ * operation, so no RMM can ever exist for it. A read-only row with a "set this secret" verb is the
953
+ * case: `resourceOperationLike: UPDATE` is what gives the verb its `…/{id}/<verb>` route, and it
954
+ * also made every host demand an RMM, so the form refused to submit ("This action failed") and a
955
+ * form-less verb could not run at all.
956
+ *
957
+ * What it means, in every host: use the row's RMM when there is one, and run the operation directly
958
+ * when there is not. The row id is still resolved first (from the route, else the canonical READ).
959
+ * What the direct run gives up is the RMM's optimistic state and its version-conflict details. The row
960
+ * is still re-read after success: the RMM-less `ResourceAutomaticDisplayer` re-reads when
961
+ * `RESOURCE_OPERATION_EXECUTED` names its row (#1782).
962
+ *
963
+ * Explicit on purpose. `update-like-mutation-fallback.frontend.ts` makes the weaker lane an opt-in
964
+ * rather than something a host infers, and this is the per-operation door that opt-in lacked. Every
965
+ * host that runs an operation reads it through `resolveDeclaredUpdateLikeMutationFallbackMode`: the
966
+ * form, the form-less `useOperationDirectExecution`, and `useResourceOperationSurface`. A mode a host
967
+ * passes explicitly still outranks it.
968
+ *
969
+ * @example
970
+ * [Secrets_Operations.SET, {
971
+ * surface: ResourceOperationFrontendSurface.EMBEDDED,
972
+ * updateLikeMutationFallbackMode: UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK,
973
+ * }],
974
+ */
975
+ updateLikeMutationFallbackMode: z.enum(UpdateLikeMutationFallbackMode).optional(),
892
976
  /**
893
977
  * HOW this action collects its input — see {@link ResourceOperationActionPresentation}.
894
978
  * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input
895
- * executes directly, a small field set opens a modal, complex input keeps its page.
979
+ * executes directly, one choice is a dropdown, one or two simple fields open an anchored popover,
980
+ * a small field set opens a modal, complex input keeps its page.
896
981
  *
897
982
  * Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins
898
983
  * over whatever this resolves to.
@@ -938,6 +1023,20 @@ export const ResourceOperationFrontendConfigSchema = z.object({
938
1023
  * ]
939
1024
  */
940
1025
  presetFilters: z.array(CollectionFilterPresetSchema).optional(),
1026
+ /**
1027
+ * Whether the toolbar offers the free-form filters panel. Omitted means
1028
+ * {@link CollectionFilterPanelVisibility.OFFERED}. Set `HIDDEN` when the tabs and pills above
1029
+ * already carry every narrowing this collection is read by; the active-filter chips stay either
1030
+ * way. See {@link CollectionFilterPanelVisibility}.
1031
+ *
1032
+ * @example
1033
+ * collectionDisplayConfig: {
1034
+ * quickFilterField: 'status',
1035
+ * presetFilters: [{ ref: 'urgent', filters: { priority: 'urgent' } }],
1036
+ * filterPanel: CollectionFilterPanelVisibility.HIDDEN,
1037
+ * }
1038
+ */
1039
+ filterPanel: z.enum(CollectionFilterPanelVisibility).optional(),
941
1040
  /**
942
1041
  * Group CARDS-mode rows into day buckets by this date field, rendering a
943
1042
  * date heading between groups (activity-feed idiom for log-like
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: resource-add-module
3
3
  description: Scaffold a new application module slice (folders + index files + module-registration objects) across `shared-lib`, `frontend`, `specifications`, and (when applicable) `backend-api`, then declare it in `wildo.saas.config.ts > modules` with the explicit `services: [...]` array. Use when the user says "add a new module", "create a `<name>` module", "scaffold a bounded context", "wire a new domain area", "add a new feature slice", or "split this domain into its own module" — NOT when adding a single resource inside an existing module.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Resource Add Module — Scaffold Workflow
@@ -39,7 +39,8 @@ including this one — is a copy of a moving population and will be behind it.
39
39
  The catalogue is much wider than modules and resources. It covers whole slices an application may
40
40
  not have yet, and hand-scaffolding one of those is a great deal of work a single command already
41
41
  does: a documentation portal, a marketing website, an additional environment, a background worker or
42
- a minion, a provider of several kinds, and a custom operation. If you are about to create a new
42
+ a minion, a provider of several kinds, a custom operation, and the optional 3D layout
43
+ (`add-3d-layout`, which edits existing frontend files rather than creating a slice). If you are about to create a new
43
44
  top-level package or a new workspace slice by hand, run `wildo compose` first.
44
45
 
45
46
  An unknown ref is refused by name, and the refusal tells you to run the bare command — so a mistyped
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: resource-add-resource
3
3
  description: Scaffold a new resource (schema, resources-config, relationships, factory wiring, optional UI behavior and specification) across `shared-lib`, `app`, and `specifications`. Use when the user says "add a new resource <name>", "create a <name> resource in the <module> module", "scaffold <name> alongside the existing tasks/todos", or "introduce a new persisted entity for <feature>" — anything that creates a brand-new resource type, not a field addition or operation tweak on an existing one.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Resource Add Resource — Scaffold Workflow
@@ -106,9 +107,11 @@ export const moduleResourcesConfigurationsFactoryMap: ResourceConfiguration_Init
106
107
  [TasksManager_ResourceType.ORGANIZATION_ESCALATION_POLICIES]: organizationEscalationPolicies_ResourceConfiguration_InitializationFactory,
107
108
  [TasksManager_ResourceType.EXTERNAL_CUSTOMERS]: externalCustomers_ResourceConfiguration_InitializationFactory,
108
109
  [TasksManager_ResourceType.BILLABLE_SERVICES]: billableServices_ResourceConfiguration_InitializationFactory,
110
+ [TasksManager_ResourceType.CUSTOMER_INVOICES]: customerInvoices_ResourceConfiguration_InitializationFactory,
109
111
  [TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS]: accountErasureRequests_ResourceConfiguration_InitializationFactory,
110
112
  [TasksManager_ResourceType.KNOWLEDGE_DOCUMENTS]: knowledgeDocuments_ResourceConfiguration_InitializationFactory,
111
113
  [TasksManager_ResourceType.TODO_LIST_REMINDER_RULES]: todoListReminderRules_ResourceConfiguration_InitializationFactory,
114
+ [TasksManager_ResourceType.EXPENSE_RECEIPTS]: expenseReceipts_ResourceConfiguration_InitializationFactory,
112
115
  }
113
116
  ```
114
117
 
@@ -347,6 +347,42 @@ export type ResourceSystemAccessPolicy = {
347
347
  };
348
348
 
349
349
  /**
350
+ * WHO a row of this resource is with respect to an erasure, and where that person's session lives.
351
+ * The companion of {@link ResourceRetentionPolicy}: retention says what happens to the ROW and whether
352
+ * the row holds personal data at all; this says **whose SESSION an erasure of it must end**.
353
+ *
354
+ * The two are independent, and reading this one as "is the row about a person" is the mistake that
355
+ * cost `NO_PRINCIPAL` its previous name — see {@link ResourceDataSubjectKind}. A CRM contact holds
356
+ * personal data (`RETAIN_AND_IMPERSONALIZE`) and has no session (`NO_PRINCIPAL`); an invoice holds
357
+ * none (`RETAIN_ONLY`) and also has no session. Same value here, opposite compliance meaning, and the
358
+ * retention mode is what tells them apart.
359
+ *
360
+ * Required on every resource declaring a {@link ResourceRetentionPolicy}, because those are exactly
361
+ * the resources that can be passed to `eraseSubjectAsSystem` as a subject (the orchestrator refuses a
362
+ * subject with no retention policy). Undeclared fails at config build rather than defaulting: the safe
363
+ * default is unknowable — guessing `NO_PRINCIPAL` silently drops a real person's revocation, and
364
+ * guessing a linked principal revokes the wrong people. See {@link ResourceDataSubjectKind} for why
365
+ * the linkage can never be inferred from the presence of a user foreign key.
366
+ */
367
+ export interface ResourceDataSubjectPolicy {
368
+ /** Whose login session an erasure of this row must end — never whether the row is about a person. */
369
+ kind: ResourceDataSubjectKind;
370
+ /**
371
+ * The field naming the `USERS` row whose session an erasure of this row must end.
372
+ *
373
+ * REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
374
+ * `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
375
+ * principal at all, so a field there would be a contradiction rather than redundancy. Both
376
+ * directions are enforced at config build.
377
+ */
378
+ sessionPrincipalField?: string;
379
+ }
380
+
381
+ /*
382
+ * `ResourceRetentionPolicy` — maintainer notes, kept OUTSIDE the anchored contract below because they cite
383
+ * repository test files an application cannot see. (This block used to sit orphaned above
384
+ * `ResourceDataSubjectPolicy`'s JSDoc, attached to nothing.)
385
+ *
350
386
  * Resource-level opt-in to the **impersonalization-on-erasure** capability: on erasure the
351
387
  * resource is impersonalized-and-retained (personal fields scrubbed, row kept for a legal/audit
352
388
  * obligation) instead of hard-deleted. When set, the factory injects a `retentionStatus` marker
@@ -382,37 +418,22 @@ export type ResourceSystemAccessPolicy = {
382
418
  * opposite direction). Reuse of that mechanism, never its name.
383
419
  */
384
420
  /**
385
- * WHO a row of this resource is with respect to an erasure, and where that person's session lives.
386
- * The companion of {@link ResourceRetentionPolicy}: retention says what happens to the ROW and whether
387
- * the row holds personal data at all; this says **whose SESSION an erasure of it must end**.
388
- *
389
- * The two are independent, and reading this one as "is the row about a person" is the mistake that
390
- * cost `NO_PRINCIPAL` its previous name — see {@link ResourceDataSubjectKind}. A CRM contact holds
391
- * personal data (`RETAIN_AND_IMPERSONALIZE`) and has no session (`NO_PRINCIPAL`); an invoice holds
392
- * none (`RETAIN_ONLY`) and also has no session. Same value here, opposite compliance meaning, and the
393
- * retention mode is what tells them apart.
394
- *
395
- * Required on every resource declaring a {@link ResourceRetentionPolicy}, because those are exactly
396
- * the resources that can be passed to `eraseSubjectAsSystem` as a subject (the orchestrator refuses a
397
- * subject with no retention policy). Undeclared fails at config build rather than defaulting: the safe
398
- * default is unknowable — guessing `NO_PRINCIPAL` silently drops a real person's revocation, and
399
- * guessing a linked principal revokes the wrong people. See {@link ResourceDataSubjectKind} for why
400
- * the linkage can never be inferred from the presence of a user foreign key.
421
+ * `retentionPolicy` on a resource configuration — what a subject ERASURE does to this resource's rows, and,
422
+ * for a record a statute keeps, on what ground and for how long it survives one.
423
+ *
424
+ * Imported from `@wildo-ai/saas-models`. Declaring it requires a `dataSubjectPolicy` and a service-resolvable
425
+ * `UPDATE_MANY`, `READ` and `LIST`; the factory injects the `retentionStatus` marker every retained row carries.
426
+ *
427
+ * @example A statutory business record — kept through an erasure, restricted, until its period ends
428
+ * ```ts
429
+ * retentionPolicy: {
430
+ * mode: ErasureRetentionMode.RETAIN_ONLY,
431
+ * statutoryRetention: { ground: StatutoryRetentionGround.LEGAL_OBLIGATION, rationale: 'HGB §257(1) no. 4, AO §147(1)' },
432
+ * },
433
+ * dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
434
+ * retentionBinding: { retentionClass: DataRetentionClass.BUSINESS_RECORDS, startPoint: RetentionStartPoint.END_OF_CALENDAR_YEAR },
435
+ * ```
401
436
  */
402
- export interface ResourceDataSubjectPolicy {
403
- /** Whose login session an erasure of this row must end — never whether the row is about a person. */
404
- kind: ResourceDataSubjectKind;
405
- /**
406
- * The field naming the `USERS` row whose session an erasure of this row must end.
407
- *
408
- * REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
409
- * `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
410
- * principal at all, so a field there would be a contradiction rather than redundancy. Both
411
- * directions are enforced at config build.
412
- */
413
- sessionPrincipalField?: string;
414
- }
415
-
416
437
  export interface ResourceRetentionPolicy {
417
438
  /**
418
439
  * WHAT happens to a row of this resource when its subject is erased.
@@ -425,6 +446,46 @@ export interface ResourceRetentionPolicy {
425
446
  * retention entirely; keeping them distinct is what makes "retain, nothing to scrub" expressible.
426
447
  */
427
448
  mode: ErasureRetentionMode;
449
+ /**
450
+ * WHY an erasure may not delete these rows yet: the law requires them kept (#1635).
451
+ *
452
+ * Declared by a resource bound to `DataRetentionClass.BUSINESS_RECORDS` — and REQUIRED there: the factory
453
+ * refuses that binding without it, and refuses this member on any other class. A subject erasure then
454
+ * RESTRICTS each row still inside its statutory period instead of treating it as the author's choice:
455
+ * the row is kept with {@link mode}'s treatment (flipped to `RETAINED`, so hidden from every ordinary
456
+ * read and refused every ordinary write — the GDPR Art. 18(2) effect), listed in the erasure report
457
+ * with this ground and the instant its period ends, and deleted by the retention-class sweep when it
458
+ * does. Every other row of the request is erased as usual; the request is never refused for these.
459
+ *
460
+ * ## The PERIOD is not here, on purpose
461
+ *
462
+ * How long the rows are kept is `dataRetention[BUSINESS_RECORDS].retentionDays`, counted from the
463
+ * resource's `retentionBinding.startPoint`. A second number on this declaration would be a second
464
+ * authority for one period, and the two would drift.
465
+ *
466
+ * ## One erasure authority
467
+ *
468
+ * This lives INSIDE `retentionPolicy` rather than beside it: `retentionPolicy` is the declaration whose
469
+ * whole subject is what an erasure does to a row, and a separate "erasure exemption" beside it would give
470
+ * one row two erasure authorities.
471
+ */
472
+ statutoryRetention?: ResourceStatutoryRetention;
473
+ }
474
+
475
+ /**
476
+ * The legal ground on which a {@link ResourceRetentionPolicy} keeps its rows through an erasure, and the
477
+ * operator's words for it (#1635).
478
+ */
479
+ export interface ResourceStatutoryRetention {
480
+ /** The GDPR Art. 17(3) exemption relied on. One member today — see {@link StatutoryRetentionGround}. */
481
+ ground: StatutoryRetentionGround;
482
+ /**
483
+ * WHICH statute, in the operator's words — "HGB §257(1) no. 4 and AO §147(1): accounting source documents,
484
+ * 8 years from the end of the calendar year". Required and non-empty: an operator telling a data subject
485
+ * why a record was kept (Art. 12(4)) has to be able to name the law, and a ground with no law named is a
486
+ * claim nobody can check.
487
+ */
488
+ rationale: string;
428
489
  }
429
490
 
430
491
  /**
@@ -645,6 +706,24 @@ export type ResourceConfiguration_BuilderParameters<
645
706
  */
646
707
  dataSubjectPolicy?: ResourceDataSubjectPolicy,
647
708
 
709
+ /**
710
+ * How long this resource's rows are KEPT: a binding to one of the application's declared retention
711
+ * classes, and the moment each row's clock starts. An engine sweep deletes a bound row once its
712
+ * class's `retentionDays` have passed since that start point, through the service layer, on both
713
+ * persistence adapters.
714
+ *
715
+ * ⚠️ NOT {@link retentionPolicy}. That is what an ERASURE does to a row (delete, or retain and
716
+ * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
717
+ * deleted when its class period ends.
718
+ *
719
+ * Optional. An unbound resource is kept until it is erased, and is reported as unbound
720
+ * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
721
+ * may not also declare a `.ttl()` field — one row, one retention authority.
722
+ *
723
+ * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
724
+ */
725
+ retentionBinding?: ResourceRetentionBinding,
726
+
648
727
  /**
649
728
  * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
650
729
  * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
@@ -652,5 +731,20 @@ export type ResourceConfiguration_BuilderParameters<
652
731
  * {@link ResourcePortabilityPolicy}.
653
732
  */
654
733
  portabilityPolicy?: ResourcePortabilityPolicy,
734
+
735
+ /**
736
+ * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
737
+ * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
738
+ * application can compute its cost per case (#1598), and expert decisions on agent work name it (#1599).
739
+ *
740
+ * A reference to a case is a `WorkUnitRef` (`{ resourceType, resourceId }`), and the engine accepts one at a
741
+ * service boundary only when `resourceType` names a resource declaring `workUnit: true` and the caller can
742
+ * READ that row. Several resources of one application may be work units. Default `false`.
743
+ *
744
+ * The engine opens the case frame by itself around every single-row operation on a work-unit resource (and
745
+ * around a CREATE once the new row's id is assigned, before its after-create hooks), so a model call made
746
+ * by a hook, a tool or a queued job started there is attributed without the application passing anything.
747
+ */
748
+ workUnit?: boolean,
655
749
  }
656
750
  ```
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: resource-config-wiring
3
3
  description: Author or modify `*.resources-config.ts` and the matching `*.relationships.ts` for operations, variants, FK relationships, role visibility, and access scope. Use when the user says "wire <field> as a foreign key to <resource>", "add a custom operation to <resource>", "make <op> admin-only", "expose <resource> on <role>", "declare <child> as a child of <parent>", or "change which operations include <relationship>" — anything that changes how a resource shows up in the framework registry, not just its persisted shape or rendered chrome.
4
+ user-invocable: false
4
5
  ---
5
6
 
6
7
  # Resource Config Wiring
@@ -89,5 +89,13 @@ export enum AdministrativeContinuityErrorCode {
89
89
  * tenant-access grant; ownerless request auto-approval does not bypass the repair's checks.
90
90
  */
91
91
  LAST_ORGANIZATION_OWNER = 'LAST_ORGANIZATION_OWNER',
92
+
93
+ /**
94
+ * `grantOwnership` was asked to make a PROVIDER membership (#1597 — a service firm's expert, present
95
+ * through the client's service-provider relationship) an owner. Refused: an organization whose owner
96
+ * is a firm's expert still cannot administer itself, and the floor never counts such a row. Remedy:
97
+ * grant ownership to one of the organization's OWN members.
98
+ */
99
+ SERVICE_PROVIDER_MEMBERSHIP_CANNOT_OWN = 'SERVICE_PROVIDER_MEMBERSHIP_CANNOT_OWN',
92
100
  }
93
101
  ```