@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,677 @@
1
+ # Work unit API (source-backed)
2
+
3
+ The reference to a CASE and the resource declaration that makes a resource's rows cases.
4
+
5
+ Read this when:
6
+ - deciding which resource of the application is the case;
7
+ - passing a `caseRef` to a chat turn, an A2A message or an actor run;
8
+ - explaining why a `caseRef` was refused.
9
+
10
+ ## Import Origins
11
+
12
+ - `@wildo-ai/saas-models`
13
+
14
+ ## Source Excerpts
15
+
16
+ ### Origin Package: `@wildo-ai/saas-models`
17
+
18
+ ```typescript
19
+ /**
20
+ * A reference to one CASE — the unit of work an application sells an outcome for (a matter, a file, a
21
+ * claim, a ticket). Model-call cost attribution, expert decisions on agent work and agent turns all carry it
22
+ * as `caseRef`. Import it from `@wildo-ai/saas-models`.
23
+ *
24
+ * `resourceType` is an OPEN application identifier (resource names are not a closed vocabulary), so the
25
+ * shape alone proves nothing: a ref is accepted at a service boundary only after the registry confirms
26
+ * the resource exists and the caller's own authorization can READ that row. The tenant is always derived
27
+ * from the row, never from the caller. And the resource must declare `workUnit: true` in its resource
28
+ * configuration: a ref to any other resource is refused as NOT_A_WORK_UNIT.
29
+ */
30
+ export const WorkUnitRefSchema = z.strictObject({
31
+ resourceType: z.string().min(1).max(120).describe('Name of the resource the case is a row of, as the API names it (for example `todos`). The resource must exist, and the caller must be able to read the row.'),
32
+ resourceId: z.string().min(1).max(200).describe('Id of that row. The case belongs to the organization that owns the row, whatever organization the request names.'),
33
+ });
34
+ export type WorkUnitRef = z.infer<typeof WorkUnitRefSchema>;
35
+ ```
36
+
37
+ The `workUnit` flag is one of the resource configuration's builder parameters:
38
+
39
+ ## Import Origins
40
+
41
+ - `@wildo-ai/saas-models`
42
+
43
+ ## Source Excerpts
44
+
45
+ ### Origin Package: `@wildo-ai/saas-models`
46
+
47
+ ```typescript
48
+ *
49
+ * Valid operation keys from core + custom enums, and builder params for `createResourceConfiguration`.
50
+ */
51
+ // Helper type to extract valid operation keys, excluding undefined
52
+ export type ValidOperationKeys<
53
+ TCustomOperationEnum extends EnumLikeType | undefined,
54
+ TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined
55
+ > = (TCustomOperationEnum extends EnumLikeType ? EnumValues<TCustomOperationEnum> : never) |
56
+ (TCoreOperationEnum extends Partial<CoreResourceOperation> ? TCoreOperationEnum : never);
57
+
58
+ /**
59
+ *
60
+ * Access mode for the ACL-bypassing system-context reads
61
+ * (`SystemAccessBackendService.readAsSystem` / `listAsSystem`, from
62
+ * `@wildo-ai/saas-backend-lib`).
63
+ *
64
+ * Those primitives run with a synthesised super-admin execution context and
65
+ * therefore SKIP the caller's scope and role checks entirely. A resource is
66
+ * readable that way ONLY if its resource configuration opts the verb in. Any
67
+ * verb left undeclared defaults to `FORBIDDEN`: a system read of a resource
68
+ * that has not opted in throws `ErrorType.CONFIGURATION` — the framework is
69
+ * fail-closed here by construction.
70
+ */
71
+ export enum ResourceSystemAccessMode {
72
+ /** The verb's system-context primitive is rejected for this resource (default). */
73
+ FORBIDDEN = 'FORBIDDEN',
74
+ /** The verb's system-context primitive is permitted for this resource. */
75
+ ALLOWED = 'ALLOWED',
76
+ }
77
+
78
+ /**
79
+ * Per-resource opt-in policy for the ACL-bypassing system-context primitives
80
+ * on `SystemAccessBackendService`: the reads (`readAsSystem` / `listAsSystem`)
81
+ * and the trusted writes (`createAsSystem` / `updateAsSystem` /
82
+ * `updateManyAsSystem`).
83
+ *
84
+ * A system-context call does not REMOVE the authorization decision — it
85
+ * RELOCATES it from the resource ACL onto the calling service, which MUST
86
+ * enforce an explicit alternative check (e.g. consumable-token or
87
+ * email-ownership matching). Declaring this policy is the data owner's
88
+ * statement that such a bypass is permissible at all, and for which verb. An
89
+ * absent policy — or a verb set to (or left defaulting to) `FORBIDDEN` — makes
90
+ * the primitive throw.
91
+ *
92
+ * The WRITE verbs additionally let a trusted in-process caller persist the
93
+ * fields the client-shaped request DTO strips — `.isBackendOnly()` material
94
+ * (e.g. a credential `passwordHash`) and the context-auto-populated FKs (e.g.
95
+ * `userId` on a system resource that has no HTTP surface to seed it) — by
96
+ * re-attaching exactly those fields after the strict parse. They are the
97
+ * sanctioned path for engine flows like registration that must write system
98
+ * resources directly; opting a verb in is the data owner's acknowledgement that
99
+ * a super-admin-context mutation of this resource is legitimate.
100
+ *
101
+ * Caveats a system-context call inherits (it runs as super-admin), to weigh
102
+ * before opting in:
103
+ * - a READ returns the FULL record — every field, including ones a normal
104
+ * caller's role / field-visibility would hide — so never forward the result
105
+ * verbatim to an under-privileged caller; project only what is safe.
106
+ * - a WRITE bypasses the caller's scope + role ACL, so the calling service
107
+ * owns the authorization decision (only trusted engine code can reach the
108
+ * primitive — it is never exposed to an HTTP payload).
109
+ * - feature flags do not gate it (it is an internal request).
110
+ * - the policy is RESOURCE-LEVEL: for a polymorphic resource it is shared by
111
+ * every scope variant (declare it once on the shared config).
112
+ *
113
+ * Intentionally DISTINCT from `isSystemResource`: marking a resource as
114
+ * framework infrastructure does NOT imply that an ACL bypass is acceptable
115
+ * for its data. Keep the two concepts separate.
116
+ */
117
+ /**
118
+ * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
119
+ *
120
+ * ## Why the application declares it rather than the framework knowing it
121
+ *
122
+ * The erasure lane is application-owned — four of the five marked sites for
123
+ * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
124
+ * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
125
+ * status vocabulary are the application's, so a collector queries it against that application's
126
+ * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
127
+ * that is one application's modelling choice"*.
128
+ *
129
+ * So a collector may not know that a request is raised through a field called `channel` carrying a
130
+ * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
131
+ * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
132
+ * to find it (#1209): not a missing control, a control nobody could point at.
133
+ *
134
+ * ## It binds FIELDS, never values the framework invents
135
+ *
136
+ * Every member below names something the application already authored. The one value the
137
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
138
+ * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
139
+ * framework supplies no vocabulary here and must never grow one.
140
+ *
141
+ * ## What is deliberately NOT declared
142
+ *
143
+ * The SCHEDULE. C3 asks that requests be executed on the declared schedule, and that schedule is
144
+ * already on the executing operation's `CRON_JOB` variant (`cronExpression`) — declaring it again
145
+ * here would be a second copy that can only ever disagree with the one the scheduler reads.
146
+ * `executionOperationIdentifier` names the operation; the schedule is read from it.
147
+ */
148
+ export type ResourceSubjectErasureLane = {
149
+ /**
150
+ * How a row says WHO raised the request — the subject exercising their own right, or the
151
+ * controller acting on their behalf. C1's whole obligation is that the two are distinguishable.
152
+ */
153
+ raisedBy: {
154
+ /** The field carrying it. Must be a persisted field of this resource. */
155
+ fieldName: string,
156
+ /**
157
+ * The value of that field meaning the SUBJECT raised it themselves. Every other value is read as
158
+ * controller-raised — stated this way round because a lane may grow a second controller channel
159
+ * without the declaration going stale, whereas enumerating the controller values could not.
160
+ */
161
+ subjectValue: string,
162
+ },
163
+ /**
164
+ * The field carrying WHICH user raised a controller-raised request.
165
+ *
166
+ * Omitting it is a positive claim, not a gap: it says this lane admits no controller-raised
167
+ * request at all. A collector reads it that way and a row carrying a non-subject value then
168
+ * contradicts the declaration, which is a finding about the application rather than about the
169
+ * evidence.
170
+ */
171
+ requesterFieldName?: string,
172
+ /** The field carrying the justification a controller-raised request was made on, where the lane records one. */
173
+ justificationFieldName?: string,
174
+ /** The field carrying the instant the request was executed or failed. C3 judges execution against it. */
175
+ completedAtFieldName: string,
176
+ /** The field carrying what the execution did. Its vocabulary is the application's. */
177
+ outcomeFieldName: string,
178
+ /**
179
+ * The operation a SUBJECT uses to withdraw their own pending request (C2). Named rather than
180
+ * inferred: "the operation that cancels" is not derivable from an operation vocabulary, and
181
+ * guessing it would make the evidence depend on a naming convention no application agreed to.
182
+ */
183
+ withdrawalOperationIdentifier: string,
184
+ /**
185
+ * How a WITHDRAWN row is recognisable afterwards — the same shape as {@link raisedBy}, and for the
186
+ * same reason: the vocabulary is the application's.
187
+ *
188
+ * C2 asks for the withdrawal door AND for "any cancelled rows", and those are two different
189
+ * questions. The door is answered from {@link withdrawalOperationIdentifier} — is the operation
190
+ * reachable to a subject while the request is pending — and needs no data at all. The rows need a
191
+ * marker, and there is nothing to derive one from: withdrawal and execution both leave a request in
192
+ * a terminal state, so a reader that knows only `completedAtFieldName` cannot tell "the subject
193
+ * changed their mind" from "the sweep ran".
194
+ *
195
+ * OPTIONAL, because an application may not model withdrawal as a value at all — it may delete the
196
+ * row, or move it. Omitting it says the count is unavailable, and a collector reports that rather
197
+ * than guessing; it never turns into a zero, which would read as "nobody withdrew anything".
198
+ *
199
+ * Note an EMPTY withdrawal set is explicitly not a deficiency in the demand — people do not have
200
+ * to change their minds — so this exists to make the number REPORTABLE, never to make it a target.
201
+ */
202
+ withdrawnMarker?: {
203
+ /** The field carrying it. Must be a persisted field of this resource. */
204
+ fieldName: string,
205
+ /** The value of that field meaning the SUBJECT withdrew the request before it executed. */
206
+ withdrawnValue: string,
207
+ },
208
+ /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
209
+ executionOperationIdentifier: string,
210
+ };
211
+
212
+ export type ResourceSystemAccessPolicy = {
213
+ /** Governs `readAsSystem`. Omitted ⇒ FORBIDDEN. */
214
+ read?: ResourceSystemAccessMode,
215
+ /** Governs `listAsSystem`. Omitted ⇒ FORBIDDEN. */
216
+ list?: ResourceSystemAccessMode,
217
+ /** Governs `createAsSystem`. Omitted ⇒ FORBIDDEN. */
218
+ create?: ResourceSystemAccessMode,
219
+ /** Governs `updateAsSystem`. Omitted ⇒ FORBIDDEN. */
220
+ update?: ResourceSystemAccessMode,
221
+ /** Governs `updateManyAsSystem`. Omitted ⇒ FORBIDDEN. */
222
+ updateMany?: ResourceSystemAccessMode,
223
+ // NOTE: there is deliberately NO `delete` verb here — there is no `deleteAsSystem` primitive. A row is
224
+ // removed either through its own DELETE operation ACL (e.g. an owner-facing `API_CALL` DELETE under the
225
+ // USER_SELF owner filter) or by the `onParentDelete` composition cascade (which deletes at the raw
226
+ // repository layer, variant-agnostic — see `deleteChildrenImmediate`). If you find yourself reaching
227
+ // for `systemAccessPolicy.delete`, model the removal as one of those two instead.
228
+ /**
229
+ * Governs the impersonalization see-through reads (`readRetainedAsSystem` /
230
+ * `listRetainedAsSystem`) — the privileged, audited path that reveals
231
+ * `retentionStatus = RETAINED` rows hidden-by-default. Omitted ⇒ FORBIDDEN.
232
+ * Auto-derived to `ALLOWED` by the factory when a resource opts into
233
+ * `retentionPolicy`; never authored by hand in the common case.
234
+ *
235
+ * **LIVE, and REACHABLE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
236
+ * the verb is asserted fail-closed, a privileged human role is required, and every reveal emits a
237
+ * human-attributed `RETAINED_DATA_ACCESS` audit event.
238
+ *
239
+ * "Reachable" is the half that was missing until #490, and the distinction is worth keeping. The
240
+ * primitives were correct and enforced from the day M5b landed — and had **no caller**, so the only
241
+ * route an operator actually had to a retained record was a database console: the unaudited path
242
+ * they were built to replace. `users | read_retained` is the operator surface that closes it, an
243
+ * authenticated `APP_ADMIN_SUPER_ADMIN` operation carrying a mandatory justification.
244
+ *
245
+ * A resource that derives this grant and exposes no such operation is reachable by nothing. That
246
+ * is a defensible state — not every retention resource needs an operator door — but it should be a
247
+ * decision rather than an oversight, and `retained-see-through-operator-surface.test.ts` is what
248
+ * makes it one.
249
+ *
250
+ * (This block previously said the primitives were "wired in a later phase" — false since M5b.)
251
+ */
252
+ seeRetained?: ResourceSystemAccessMode,
253
+
254
+ /**
255
+ * May this resource's rows be swept into a SUBJECT EXPORT bundle (GDPR Art. 15 / Art. 20)?
256
+ *
257
+ * Fail-closed by omission, like every other verb here. A subject export reads across the whole
258
+ * child-direction graph of its subject, so without an explicit opt-in a resource could be
259
+ * disclosed to a data subject because it merely sits on an edge — nobody having decided that its
260
+ * contents are appropriate to hand over.
261
+ *
262
+ * **The refusal is LOUD, not a silent skip.** When an edge the classifier marked for inclusion
263
+ * belongs to a resource that has not opted in, the export REFUSES and names it. Silently dropping
264
+ * it would produce an access bundle that is incomplete without saying so — a disclosure failure
265
+ * wearing the appearance of a successful response, which is the same class of lie as the routed
266
+ * export operations this capability replaced. Refusing is a one-line fix per resource; a silent
267
+ * omission is undetectable.
268
+ *
269
+ * NOT derived from `portabilityPolicy`: declaring where fields came from (Art. 20 scoping) and
270
+ * consenting to be disclosed at all are different decisions, and a resource may legitimately want
271
+ * the first without the second.
272
+ */
273
+ exportSubject?: ResourceSystemAccessMode,
274
+ };
275
+
276
+ /**
277
+ * WHO a row of this resource is with respect to an erasure, and where that person's session lives.
278
+ * The companion of {@link ResourceRetentionPolicy}: retention says what happens to the ROW and whether
279
+ * the row holds personal data at all; this says **whose SESSION an erasure of it must end**.
280
+ *
281
+ * The two are independent, and reading this one as "is the row about a person" is the mistake that
282
+ * cost `NO_PRINCIPAL` its previous name — see {@link ResourceDataSubjectKind}. A CRM contact holds
283
+ * personal data (`RETAIN_AND_IMPERSONALIZE`) and has no session (`NO_PRINCIPAL`); an invoice holds
284
+ * none (`RETAIN_ONLY`) and also has no session. Same value here, opposite compliance meaning, and the
285
+ * retention mode is what tells them apart.
286
+ *
287
+ * Required on every resource declaring a {@link ResourceRetentionPolicy}, because those are exactly
288
+ * the resources that can be passed to `eraseSubjectAsSystem` as a subject (the orchestrator refuses a
289
+ * subject with no retention policy). Undeclared fails at config build rather than defaulting: the safe
290
+ * default is unknowable — guessing `NO_PRINCIPAL` silently drops a real person's revocation, and
291
+ * guessing a linked principal revokes the wrong people. See {@link ResourceDataSubjectKind} for why
292
+ * the linkage can never be inferred from the presence of a user foreign key.
293
+ */
294
+ export interface ResourceDataSubjectPolicy {
295
+ /** Whose login session an erasure of this row must end — never whether the row is about a person. */
296
+ kind: ResourceDataSubjectKind;
297
+ /**
298
+ * The field naming the `USERS` row whose session an erasure of this row must end.
299
+ *
300
+ * REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
301
+ * `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
302
+ * principal at all, so a field there would be a contradiction rather than redundancy. Both
303
+ * directions are enforced at config build.
304
+ */
305
+ sessionPrincipalField?: string;
306
+ }
307
+
308
+ /*
309
+ * `ResourceRetentionPolicy` — maintainer notes, kept OUTSIDE the anchored contract below because they cite
310
+ * repository test files an application cannot see. (This block used to sit orphaned above
311
+ * `ResourceDataSubjectPolicy`'s JSDoc, attached to nothing.)
312
+ *
313
+ * Resource-level opt-in to the **impersonalization-on-erasure** capability: on erasure the
314
+ * resource is impersonalized-and-retained (personal fields scrubbed, row kept for a legal/audit
315
+ * obligation) instead of hard-deleted. When set, the factory injects a `retentionStatus` marker
316
+ * and derives the `updateMany` + `seeRetained` system-access grants.
317
+ *
318
+ * RESOURCE-level (intrinsic, trigger-agnostic). The per-EDGE trigger is
319
+ * `onParentDelete.strategy = IMPERSONALIZE_AND_RETAIN`; the per-FIELD scrub is `.impersonalizeWith()`.
320
+ *
321
+ * **LIVE — opting in has real effect today.** The marker + derived grants, the in-place scrub writer,
322
+ * the `IMPERSONALIZE_AND_RETAIN` cascade mode and the hidden-by-default read filter all exist and are
323
+ * enforced. A RETAINED row is invisible to reads, lists, counts and CHART aggregates, and immutable
324
+ * to ordinary writes, on BOTH persistence adapters; the only door is the audited see-through path.
325
+ *
326
+ * Runtime-proven, not asserted — and scoped precisely, because an earlier revision of this block
327
+ * over-claimed it. Against a real MongoDB, the erasure orchestrator reaches its terminal path and its
328
+ * receipt is truthful over a registered subset of resources
329
+ * (`subject-erasure-completion.mongo.integration.test.ts`); the retention OUTCOME and a SECOND erasure
330
+ * are observed (`subject-impersonalization-retention-outcome.mongo.integration.test.ts`); and a
331
+ * retained row is absent from a real application chart over real HTTP
332
+ * (Your Application `e2e/chart-retention-hide.e2e.ts`).
333
+ *
334
+ * What is NOT proven: that an erasure completes over the FULL `onParentDelete` closure, and that
335
+ * external (provider-side) effects run. The completion lane deliberately requires
336
+ * `declinedEdges.length > 0`, so it asserts a state in which some edges were NOT executed, and
337
+ * `externalEffects` is stubbed empty. Do not read "runtime-proven" here as end-to-end completeness.
338
+ *
339
+ * (This block previously read "Contract only in this phase … No record is impersonalized-and-retained
340
+ * yet." That was true when written and became false without being revisited — it is the public
341
+ * authoring contract an app developer reads before declaring this policy, so it is corrected here
342
+ * rather than left to mislead.)
343
+ *
344
+ * ⚠️ NOT the anonymous-user concept (`isAnonymizable` is pre-auth ownership transposition — the
345
+ * opposite direction). Reuse of that mechanism, never its name.
346
+ */
347
+ /**
348
+ * `retentionPolicy` on a resource configuration — what a subject ERASURE does to this resource's rows, and,
349
+ * for a record a statute keeps, on what ground and for how long it survives one.
350
+ *
351
+ * Imported from `@wildo-ai/saas-models`. Declaring it requires a `dataSubjectPolicy` and a service-resolvable
352
+ * `UPDATE_MANY`, `READ` and `LIST`; the factory injects the `retentionStatus` marker every retained row carries.
353
+ *
354
+ * @example A statutory business record — kept through an erasure, restricted, until its period ends
355
+ * ```ts
356
+ * retentionPolicy: {
357
+ * mode: ErasureRetentionMode.RETAIN_ONLY,
358
+ * statutoryRetention: { ground: StatutoryRetentionGround.LEGAL_OBLIGATION, rationale: 'HGB §257(1) no. 4, AO §147(1)' },
359
+ * },
360
+ * dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
361
+ * retentionBinding: { retentionClass: DataRetentionClass.BUSINESS_RECORDS, startPoint: RetentionStartPoint.END_OF_CALENDAR_YEAR },
362
+ * ```
363
+ */
364
+ export interface ResourceRetentionPolicy {
365
+ /**
366
+ * WHAT happens to a row of this resource when its subject is erased.
367
+ *
368
+ * Both modes retain the row (kept, marked `RETAINED`, hidden from normal reads and immutable,
369
+ * readable only through the audited see-through path). They differ on whether the row's own FIELDS
370
+ * additionally need scrubbing — which is a genuinely separate question, because a record can be
371
+ * legally retainable while holding no personal data of its own (a financial row that merely POINTS
372
+ * at a person). Fusing the two forced such a resource to either invent a fake scrub or forgo
373
+ * retention entirely; keeping them distinct is what makes "retain, nothing to scrub" expressible.
374
+ */
375
+ mode: ErasureRetentionMode;
376
+ /**
377
+ * WHY an erasure may not delete these rows yet: the law requires them kept (#1635).
378
+ *
379
+ * Declared by a resource bound to `DataRetentionClass.BUSINESS_RECORDS` — and REQUIRED there: the factory
380
+ * refuses that binding without it, and refuses this member on any other class. A subject erasure then
381
+ * RESTRICTS each row still inside its statutory period instead of treating it as the author's choice:
382
+ * the row is kept with {@link mode}'s treatment (flipped to `RETAINED`, so hidden from every ordinary
383
+ * read and refused every ordinary write — the GDPR Art. 18(2) effect), listed in the erasure report
384
+ * with this ground and the instant its period ends, and deleted by the retention-class sweep when it
385
+ * does. Every other row of the request is erased as usual; the request is never refused for these.
386
+ *
387
+ * ## The PERIOD is not here, on purpose
388
+ *
389
+ * How long the rows are kept is `dataRetention[BUSINESS_RECORDS].retentionDays`, counted from the
390
+ * resource's `retentionBinding.startPoint`. A second number on this declaration would be a second
391
+ * authority for one period, and the two would drift.
392
+ *
393
+ * ## One erasure authority
394
+ *
395
+ * This lives INSIDE `retentionPolicy` rather than beside it: `retentionPolicy` is the declaration whose
396
+ * whole subject is what an erasure does to a row, and a separate "erasure exemption" beside it would give
397
+ * one row two erasure authorities.
398
+ */
399
+ statutoryRetention?: ResourceStatutoryRetention;
400
+ }
401
+
402
+ /**
403
+ * The legal ground on which a {@link ResourceRetentionPolicy} keeps its rows through an erasure, and the
404
+ * operator's words for it (#1635).
405
+ */
406
+ export interface ResourceStatutoryRetention {
407
+ /** The GDPR Art. 17(3) exemption relied on. One member today — see {@link StatutoryRetentionGround}. */
408
+ ground: StatutoryRetentionGround;
409
+ /**
410
+ * WHICH statute, in the operator's words — "HGB §257(1) no. 4 and AO §147(1): accounting source documents,
411
+ * 8 years from the end of the calendar year". Required and non-empty: an operator telling a data subject
412
+ * 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
413
+ * claim nobody can check.
414
+ */
415
+ rationale: string;
416
+ }
417
+
418
+ /**
419
+ * Resource-level DEFAULT for where this resource's field values came from — the axis that decides
420
+ * GDPR Art. 20 (portability) scope. Per-field overrides are `.portabilityProvenance()`.
421
+ *
422
+ * ## Why a resource-level default exists at all
423
+ *
424
+ * Art. 20 is intrinsically a per-FIELD question: one row routinely mixes data the subject supplied
425
+ * (`firstName`) with data the controller produced about them (a computed score, a server-assigned
426
+ * status). But requiring a decorator on EVERY field of every resource would make the capability
427
+ * unadoptable, and an unadopted disclosure capability is worse than a coarse one — it means
428
+ * portability requests cannot be answered at all.
429
+ *
430
+ * So the declaration is two-level: this default carries the resource's common case in one line, and
431
+ * only fields that DIFFER from it need a decorator. A `USER_PROFILES` resource is
432
+ * `SUBJECT_PROVIDED` by default with a handful of derived exceptions; an `AUDIT_LOGS` resource is
433
+ * `DERIVED` throughout with none.
434
+ *
435
+ * ## Why it is optional, and what happens without it
436
+ *
437
+ * Omitting it entirely is legitimate: **Art. 15 (access) never consults provenance**, so an
438
+ * application can answer access requests in full before annotating anything. Only an Art. 20
439
+ * portability export needs the axis, and for a resource where neither the field nor this default
440
+ * declares one, that export REFUSES rather than guessing — see
441
+ * `SubjectExportFieldScope.UNDECLARED` for why neither guess is the safe one.
442
+ *
443
+ * ⚠️ NOT `retentionPolicy`. That says what happens to a value on ERASURE (destroy vs retain-and-
444
+ * scrub); this says where the value ORIGINATED, for a DISCLOSURE decision. A field is commonly
445
+ * `SUBJECT_PROVIDED` here and masked on erasure there — orthogonal axes on the same value.
446
+ */
447
+ export interface ResourcePortabilityPolicy {
448
+ /**
449
+ * The provenance every field of this resource is assumed to carry unless its own
450
+ * `.portabilityProvenance()` says otherwise.
451
+ */
452
+ defaultProvenance: DataPortabilityProvenance;
453
+ }
454
+
455
+ /**
456
+ * Builder parameters for creating a resource configuration.
457
+ * NOTE: databaseSchema has been removed. Backend-only fields are now marked with
458
+ * the isBackendOnly decorator in mainSchema and are stripped at the service layer.
459
+ */
460
+ export type ResourceConfiguration_BuilderParameters<
461
+ TCustomOperationEnum extends EnumLikeType | undefined,
462
+ TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined,
463
+ TMainSchema extends z.ZodTypeAny,
464
+ > = {
465
+ isDisabled?: boolean, // default false
466
+ mainSchema: TMainSchema,
467
+ resourceIdentifier : ResourceType,
468
+ resourceFieldIdentifier : ResourceFieldIdentifier,
469
+ resourceRelationships : ResourceRelationship[],
470
+ inheritenceSchemaDefinition?: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType,TMainSchema>,
471
+
472
+ /**
473
+ * Persistence adapter (database type) for this resource.
474
+ * - `mongodb`: MongoDB with Mongoose ORM
475
+ * - `postgresql`: PostgreSQL (SQL adapter)
476
+ *
477
+ * If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
478
+ * should stay the normal case.
479
+ *
480
+ * **Declaring a value that DISAGREES with the application default is refused at registration
481
+ * unless {@link ResourceConfiguration_BuilderParameters.persistenceAdapterIsolation} is also
482
+ * declared.** An application is wholly one adapter by default because two adapters cannot
483
+ * share a native transaction; the isolation declaration is the only way past that refusal,
484
+ * and it is a claim about this resource's write topology rather than a way to silence the
485
+ * error. Declaring an adapter that AGREES with the default is always fine and needs nothing.
486
+ */
487
+ persistenceAdapter?: PersistenceAdapterType,
488
+
489
+ /**
490
+ * This resource's declared relationship to cross-adapter atomic write boundaries.
491
+ *
492
+ * Required — and only meaningful — when {@link
493
+ * ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
494
+ * `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
495
+ * application at startup; with it, the registry admits the resource and LOGS the admitted
496
+ * set, so a mixed configuration is always named and never ambient.
497
+ *
498
+ * Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
499
+ * assertion about the resource's design that the persistence unit of work will still enforce
500
+ * at every real boundary.
501
+ */
502
+ persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
503
+
504
+ /**
505
+ * REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
506
+ *
507
+ * Carries everything the external repository needs that the platform does not own: provider
508
+ * reference (credentials resolve through `ExternalProvidersRegistryBackendService`), transport
509
+ * dialect, remote entity, ordered key declaration (id synthesis), identity mode, tenancy
510
+ * stance, erasure stance, and remote-call semantics. The factory enforces presence/absence
511
+ * coherence and content-validates the declaration.
512
+ */
513
+ httpApiBinding?: HttpApiResourceBindingAuthored,
514
+
515
+ /** REQUIRED when `persistenceAdapter` is INTROSPECTION; meaningless otherwise. */
516
+ introspectionBinding?: IntrospectionResourceBinding,
517
+
518
+ /**
519
+ * OPTIONAL inbound ETL pipeline on an ordinary LOCAL resource — "some resources local, some
520
+ * remote, ETL between them" (partial-resource coverage, model v3; PR-3). FORBIDDEN on an
521
+ * HTTP_API-adapter resource: a virtual resource IS the remote side. The factory
522
+ * content-validates the declaration and every mainSchema-dependent coherence rule (the
523
+ * remote-key field is a declared `.isBusinessKey()` + excludeFromCreate/Update STRING; mapped
524
+ * targets exist, accept null unless `required`, and are excludeFromCreate/Update; CLOSED
525
+ * population refuses caller CREATE operations).
526
+ */
527
+ externalDataPipeline?: ExternalDataPipelineDeclarationAuthored,
528
+
529
+ isSystemResource?: boolean, // default false - true for core system resources (organizations, users, etc.), false for tenant-specific resources
530
+
531
+ /**
532
+ * Does this resource's OWN primary-key URL segment name the CALLER, or the SUBJECT?
533
+ *
534
+ * Default `true` (the segment names the caller) — deliberately the SAFE default, so a resource
535
+ * whose author has not considered the question keeps the identity-coherence guard rather than
536
+ * silently losing it.
537
+ *
538
+ * ## Why this cannot be inferred
539
+ *
540
+ * The W3.6 identity-coherence guard (`handleUserJwtAuthentication` →
541
+ * `AUTHORIZATION_USER_ID_MISMATCH`) refuses a request whose URL `userId` differs from the JWT
542
+ * subject. That is exactly right for `USER_SELF` (`/user-self/{userId}` — the segment IS the
543
+ * caller, pinned by the horizontal-IDOR probes) and for child routes under a user
544
+ * (`/users/{userId}/draft-notes` — a PARENT segment naming whose rows these are).
545
+ *
546
+ * It is exactly WRONG for `USERS`, whose own `resourceFieldIdentifier` is also `userId` but whose
547
+ * segment names the TARGET of an administrative action. Both resources are keyed on the same
548
+ * field name, so no structural rule can tell them apart — the framework already had to add
549
+ * `coreResourceShared_FieldIdentifierPriority` to disambiguate the very same collision for FK
550
+ * resolution. This declaration is that disambiguation for IDENTITY.
551
+ *
552
+ * ## What it does and does not change
553
+ *
554
+ * Setting `false` relaxes ONLY the coherence refusal. It does not touch:
555
+ * - `initiatorIds.userId`, which is taken from the JWT and spread LAST precisely so a URL can
556
+ * never spoof the caller (see the `W3.6` comment at that assignment) — so permitting the
557
+ * mismatch cannot produce impersonation;
558
+ * - the contextual-field map, which legitimately carries the ADDRESSED resource's id;
559
+ * - authorization, which still decides whether this caller may run this operation at all.
560
+ *
561
+ * Set `false` only for an administrative resource whose primary key is a person/tenant identifier
562
+ * that a privileged caller is MEANT to address on someone else's behalf.
563
+ */
564
+ primaryKeyIdentifiesInitiator?: boolean,
565
+
566
+ /**
567
+ * Opt-in policy for the ACL-bypassing system-context primitives
568
+ * (`readAsSystem` / `listAsSystem` and the trusted writes `createAsSystem` /
569
+ * `updateAsSystem` / `updateManyAsSystem`). Omitted ⇒ EVERY verb FORBIDDEN
570
+ * (fail-closed): a system-context call on this resource throws unless the
571
+ * matching verb is explicitly set to ALLOWED. Declare ONLY the verb(s) that
572
+ * genuinely need a system bypass, and ensure the calling service enforces an
573
+ * explicit alternative authorization.
574
+ */
575
+ systemAccessPolicy?: ResourceSystemAccessPolicy,
576
+
577
+ /**
578
+ * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
579
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
580
+ * most resources are not, and an application that never built an erasure lane has declared none
581
+ * rather than failed a control. See {@link ResourceSubjectErasureLane}.
582
+ */
583
+ subjectErasureLane?: ResourceSubjectErasureLane,
584
+ coreOperations: TCoreOperationEnum[],
585
+ customOperation?: TCustomOperationEnum, // default undefined
586
+ operationsConfiguration : { [K in ValidOperationKeys<TCustomOperationEnum, TCoreOperationEnum>]: OperationConfig_ForKey<K, TMainSchema> }
587
+ /**
588
+ * Configuration for auto-generated operation variants.
589
+ * Controls which READ/LIST variants (summary, context) are auto-generated.
590
+ * All variants are enabled by default.
591
+ */
592
+ autoVariants?: ResourceConfiguration_AutoVariants,
593
+ // NOTE: responseSummaryDto removed - now auto-derived from isSummaryField() decorators in factory
594
+
595
+ /**
596
+ * W7.3a: Marks this resource as accessible to anonymous sessions.
597
+ * When true, the factory auto-generates dual URL paths (USER_SELF + ANONYMOUS)
598
+ * and a STANDALONE relationship to ANONYMOUS_USERS.
599
+ * The resource MUST have a nullable `userId` field.
600
+ */
601
+ isAnonymizable?: boolean,
602
+
603
+ /**
604
+ * W7.3a: Controls how anonymous resources are handled during transposition.
605
+ * Only meaningful when isAnonymizable is true.
606
+ * Defaults to ADD (simple ownership reassignment).
607
+ */
608
+ transpositionPolicy?: ResourceTranspositionPolicy,
609
+
610
+ /**
611
+ * Opt in to impersonalization-on-erasure (retain + scrub instead of hard-delete). When set, the
612
+ * factory injects a `retentionStatus` marker and derives the `updateMany` / `seeRetained`
613
+ * system-access grants. Per-field scrub is `.impersonalizeWith()`; the per-edge trigger is the
614
+ * `IMPERSONALIZE_AND_RETAIN` cascade mode.
615
+ *
616
+ * **LIVE.** Marker injection, grant derivation, the scrub writer, the cascade mode and the
617
+ * hidden-by-default read filter are all enforced today — see `ResourceRetentionPolicy` for the
618
+ * runtime evidence. Declaring this changes behaviour; it is not a forward declaration.
619
+ *
620
+ * Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
621
+ * one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
622
+ * a person — and if so, whose session an erasure ends.
623
+ */
624
+ retentionPolicy?: ResourceRetentionPolicy,
625
+
626
+ /**
627
+ * WHO a row of this resource is with respect to an erasure — and, when it is a person, which field
628
+ * names the `USERS` row whose session that erasure must end.
629
+ *
630
+ * Mandatory for any resource declaring a {@link retentionPolicy}; meaningless (and rejected) without
631
+ * one, since a resource with no retention policy can never be an erasure subject. See
632
+ * {@link ResourceDataSubjectPolicy}.
633
+ */
634
+ dataSubjectPolicy?: ResourceDataSubjectPolicy,
635
+
636
+ /**
637
+ * How long this resource's rows are KEPT: a binding to one of the application's declared retention
638
+ * classes, and the moment each row's clock starts. An engine sweep deletes a bound row once its
639
+ * class's `retentionDays` have passed since that start point, through the service layer, on both
640
+ * persistence adapters.
641
+ *
642
+ * ⚠️ NOT {@link retentionPolicy}. That is what an ERASURE does to a row (delete, or retain and
643
+ * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
644
+ * deleted when its class period ends.
645
+ *
646
+ * Optional. An unbound resource is kept until it is erased, and is reported as unbound
647
+ * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
648
+ * may not also declare a `.ttl()` field — one row, one retention authority.
649
+ *
650
+ * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
651
+ */
652
+ retentionBinding?: ResourceRetentionBinding,
653
+
654
+ /**
655
+ * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
656
+ * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
657
+ * application can answer access requests without declaring this. See
658
+ * {@link ResourcePortabilityPolicy}.
659
+ */
660
+ portabilityPolicy?: ResourcePortabilityPolicy,
661
+
662
+ /**
663
+ * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
664
+ * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
665
+ * application can compute its cost per case (#1598), and expert decisions on agent work name it (#1599).
666
+ *
667
+ * A reference to a case is a `WorkUnitRef` (`{ resourceType, resourceId }`), and the engine accepts one at a
668
+ * service boundary only when `resourceType` names a resource declaring `workUnit: true` and the caller can
669
+ * READ that row. Several resources of one application may be work units. Default `false`.
670
+ *
671
+ * The engine opens the case frame by itself around every single-row operation on a work-unit resource (and
672
+ * around a CREATE once the new row's id is assigned, before its after-create hooks), so a model call made
673
+ * by a hook, a tool or a queued job started there is attributed without the application passing anything.
674
+ */
675
+ workUnit?: boolean,
676
+ }
677
+ ```