@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
@@ -22,10 +22,23 @@ empty or fails.
22
22
  | `wildo context list` | the menu of introspection behaviours this companion serves |
23
23
  | `wildo context info <behavior>` | one behaviour's answer (some take a JSON input) |
24
24
  | `wildo context elements map\|get\|related` | the product decisions already made — ICPs, personas, requirements, phases — a subset at a time |
25
+ | `wildo context workspace map\|get\|related` | the application's own code, by resource — its fields, operations and relationships — instead of the whole registry |
25
26
  | `wildo context journey` | where the application's creation stands: what is eligible, what is unmet, and what each run took and spent — per round and per child for a composite, with the rounds that began from a state an earlier round had already begun from |
26
27
  | `wildo context coherence` | what disagrees across the landed specification families |
27
28
  | `wildo context health` | whether the companion is answering at all |
28
29
 
30
+ ## Commands that ask the running application backend
31
+
32
+ | verb | answers |
33
+ |---|---|
34
+ | `wildo context pipelines` | every external-data pipeline this application declares, with its health: when it last completed a pass (and a full one), how long ago, and whether it is failing |
35
+ | `wildo context pipelines --runs <resourceType>` | that pipeline's runs, newest first — each one's outcome, failure kind and the source rows it refused, with their remote key and reason |
36
+
37
+ A pipeline's history lives in the application's own store, so this verb asks the locally-running
38
+ **backend**, not the companion: `wildo context health` says nothing about it. If it fails, the backend
39
+ is down or its admin secret is not configured — the message says which. It is still a failure, never
40
+ an empty listing.
41
+
29
42
  **Do not guess a behaviour name and do not invent a verb.** `wildo context list` is served by the
30
43
  running companion rather than from a table, so it can never offer something the answering side does
31
44
  not have. Use CLI help for the command list; the companion menu is the authority for introspection
@@ -60,6 +73,22 @@ clause is not an element of its own: read it inside its section, and follow `rel
60
73
  to reach the facts its clauses rest on. GET the whole candidate (`--refs document:public.privacy-notice`)
61
74
  only when you need every section at once.
62
75
 
76
+ ## What the companion did, and what it is waiting on you for
77
+
78
+ The companion also RUNS things — playbooks, coding workers, judges — and some of them stop to ask.
79
+ In a Claude Code session the `wildo` plugin announces a change in one line (at session start, before a
80
+ prompt, and from a background monitor); the detail is always read with these verbs:
81
+
82
+ | verb | answers |
83
+ |---|---|
84
+ | `wildo creation feed` | what happened (a run completed or was refused, a dispatch settled), what is asked of you, what could come next |
85
+ | `wildo creation feed --follow --exit-on-change` | waits, and returns at the first new event — the loop to run after starting work |
86
+ | `wildo creation questions` | every question waiting on an answer, each with the exact command that answers it |
87
+ | `wildo creation answer <id> --revision <r> …` | answers, declines or cancels one of them. Every answer records who gave it: `--person` for the person's, `--derived <ref>=<value> --derived-by agent:<name>` for one the application's own files settle — the verb refuses an unattributed answer from inside an agent session |
88
+
89
+ Check `wildo creation questions` whenever work you started through the companion seems not to move:
90
+ a run waiting on an answer looks exactly like a slow one. The `/wildo:run` and `/wildo:build` commands carry the loop.
91
+
63
92
  ## A failure is not an answer
64
93
 
65
94
  The companion commands above require a running companion beside the checkout. They have no CLI-side
@@ -39,6 +39,7 @@ describes adding or changing its capabilities.
39
39
  | **`resource-add-module`** **(orchestrator)** — scaffold a new module folder across shared-lib, app, specifications, backend-api | "add a new module", "scaffold a billing module folder", "new bounded context", "create a feature area" |
40
40
  | **`resource-schema-authoring`** — edit Zod schemas with structural decorators | "edit the Zod schema for tasks", "change the shape of a field", "use schema family for variants", "tweak lifecycle flags on a field" |
41
41
  | **`resource-config-wiring`** — edit `*.resources-config.ts` for operations, variants, relationships, roles | "wire a new operation variant", "add a custom operation to a resource", "configure resource relationships in registry", "change operation roles" |
42
+ | **`resource-retention-binding`** — bind a resource to a retention class and start point so expired rows are deleted on schedule | "delete closed tickets after 90 days", "how long do we keep X", "keep invoices ten years", "purge old logs", "retention period for this resource" |
42
43
  | **`resource-ui-behavior`** — edit `*.ui-behavior.tsx` for layouts, display/edit modes, enum UI | "change how the priority field renders", "tweak the tasks list UI behavior", "add display-mode badge-with-colors", "conditional visibility on a field" |
43
44
  | **`resource-custom-view`** — implement `*CustomView.tsx` components bound to operation context | "implement TaskExecutionView", "write a custom view component", "hook custom React into a resource operation", "author a resource-owned view host" |
44
45
  | **`resource-rag-source-fields`** — declare which fields feed the retrieval corpus (`.ragSource()`), their chunking, and embeddings | "make this searchable by AI", "add RAG over our documents", "let the assistant answer from the knowledge base", "make uploaded PDFs searchable", "set up embeddings" |
@@ -102,10 +103,13 @@ navigation, design tokens.
102
103
  | **`configure-billing`** — enable billing / make a backend-reachable provider resolve across the 5-surface config chain | "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "provider not reachable on the backend", "my provider is authored but the backend can't reach it" |
103
104
  | **`provider-backend-package`** — install and scope a BACKEND provider shipped as its own npm package, so a host loads it on demand | "add the Slack provider", "install a provider package", "integrate a vendor on the backend", "my provider package is installed but the backend can't see it", "provider not present in the composed backend catalog", "exports no backendProviderFragment", "how do I ship our own provider" |
104
105
  | **`provider-operation-calls`** — call a connected provider's operation from a backend service (generated typed client) or from a frontend component (the browser door, for operations the application declares) | "call the Slack API from my service", "post to a vendor from the backend", "use the generated provider client", "call a provider operation from a component", "my component needs data from a third-party API", "PROVIDER_OPERATION_REFUSED", "not_browser_reachable" |
105
- | **`provider-frontend-file-picker`** — add or tune the frontend FILE PICKER provider (browser-bound module + contribution + scope; framework file fields resolve its constraints automatically) | "add a file picker", "let users attach files", "restrict uploads to PDFs", "raise the upload size limit", "file field accepts anything", "picker allows too many files", "wire a file upload provider" |
106
+ | **`provider-frontend-module`** — author or scope a frontend provider module on any browser surface (application, website, docs site): capability, public keys, CSP, scripts, components; including a facet a provider PACKAGE ships on its `./<ref>/frontend-app` subpath | "add a frontend provider", "load a vendor widget in the browser", "use the Cloudinary picker", "ship a browser part in our provider package", "the provider's component never loads", "which keys may a frontend provider take" |
107
+ | **`provider-frontend-file-picker`** — add or tune the frontend FILE PICKER provider (browser-bound module + contribution + scope; framework file fields resolve its constraints automatically); also how ANY provider component loads on the application, the website and the docs site | "add a file picker", "let users attach files", "restrict uploads to PDFs", "raise the upload size limit", "file field accepts anything", "picker allows too many files", "wire a file upload provider", "put a provider component on the website", "show a vendor widget in the docs" |
108
+ | **`provider-address-lookup`** — let people fill a `z_address()` field by searching for their address (Google Places), with the vendor reached only through the application backend; or add another vendor's lookup with an adapter | "add address autocomplete", "let users search for their address", "fill the address from Google Places", "address suggestions", "the address search says it is unavailable", "add a Loqate / Mapbox address lookup" |
106
109
  | **`config-app-shell`** — configure menubar, sidebar, command menu (static commands + omnibox record search), their labels, and whether the PUBLIC (sign-in / sign-up) pages carry the application's identity | "edit the menubar", "change sidebar chrome", "enable the Cmd+K command menu", "add record search to the command palette", "make Cmd+K search todos", "turn on omnibox search", "command-bar label changes", "app shell label edits", "show our logo on the login page", "put the app name on the sign-in screen", "brand the sign-up page", "the login page does not say which product it is" |
110
+ | **`layout-3d-adoption`** — make the signed-in shell 3D with the optional 3D layout library: adopt it (`wildo compose add-3d-layout`), choose its ONE layout, tune its frame, author a layout of the application's own, or remove it. Every region stays the existing HTML; an application is 2D by default | "make the app 3D", "add the 3D layout", "use the header-first 3D layout", "give the shell depth", "change the 3D frame style", "turn off the 3D navigation animation", "author our own 3D layout", "remove the 3D layout" |
107
111
  | **`settings-placement-authoring`** — author the application's Settings rail: which engine settings destinations are placed, in which category, in what order, under what name. The engine ships destinations and NO arrangement, so a section that is not placed does not appear | "add a settings section", "remove billing from settings", "reorder the settings tabs", "rename a settings section", "put SSO under a different group", "my settings section is not showing", "the settings menu opens the wrong page" |
108
- | **`config-navigation`** — configure navigation layout, zones, transitions, viewport behavior | "change navigation zones", "configure viewport behavior", "tweak nav transitions", "edit navigation layout" |
112
+ | **`config-navigation`** — CHOOSE how the application navigates (one-thing-at-a-time, list-and-detail, canvas-with-floating-detail) from its users and jobs, then declare it as zones, transitions, viewport behaviour and overlay appearance | "how should this app navigate", "design the navigation", "should the detail be a page, a pane or a dialog", "make it work like a tracker", "I want a reading pane", "open records beside the list", "the detail should float over the board", "change navigation zones", "configure viewport behavior", "tweak nav transitions", "edit navigation layout" |
109
113
  | **`config-design-system`** — edit design system tokens, theme materials, refractive budget, surfaces, `surfacePolicies`, generated CSS, and the FIRST-PAINT theme behavior declared in `frontend/index.html` | "edit design tokens", "change theme surfaces", "configure glass materials", "set refraction budget", "configure surface policy", "change SHELL main landmark behavior", "update CSS tokens output", "tweak design system config", "the app flashes white before it loads", "dark mode is ignored on the login screen", "editing frontend/index.html", "add a favicon or meta tags to the app page" |
110
114
 
111
115
  ### Modules & Engine — registration, relationships, companion exports
@@ -183,6 +187,12 @@ targeting through ISO codes on the ICP profile, never per-locale
183
187
  prose. The `{{output_language}}` placeholder lets templates produce
184
188
  non-English output at LLM time without per-locale duplication.
185
189
 
190
+ **An application with no market authors none of this.** An internal tool
191
+ is built for the company's own people, not sold: its market snapshot does
192
+ not apply, and neither do marketing pages or a brand. Its users are the
193
+ operating team its vision names. Do not create a `specifications/src/market/`
194
+ slice for one, and do not invent ICPs or personas to satisfy a skill here.
195
+
186
196
  | Skill | Trigger phrases |
187
197
  | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
188
198
  | **`market-authoring-overview`** **(orchestrator)** — bootstrap and assemble the full market snapshot across Phases 1–3 (category + ICPs + personas + jobs/pains/gains + voices + benefits + positioning + channels + alternatives + triggers + journeys + proofs + objections) | "set up the market spec", "author our ICPs and pains", "what is the market spec", "we need a marketing truth", "wire the market snapshot", "start the market specification slice" |
@@ -222,15 +232,20 @@ Anything that changes **backend-api code** beyond schema-driven CRUD.
222
232
 
223
233
  | Skill | Trigger phrases |
224
234
  | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
225
- | **`flows-actors-chat-assistant`** **(orchestrator)** — add a conversational AI assistant grounded on resource data (CHAT agent + `resourceReadTool` + FRONTEND actor system + `/flows-actors/:ref` view) | "add a chat assistant", "add an AI assistant grounded on <resource>", "let users chat with / ask questions about their <resource>", "wire a resourceReadTool", "add a flows-actors chat agent", "expose an actor system as a chat view" |
235
+ | **`flows-actors-chat-assistant`** **(orchestrator)** — add a conversational AI assistant grounded on resource data (CHAT agent + `resourceReadTool` + FRONTEND actor system + `/flows-actors/:ref` view) | "add a chat assistant", "add an AI assistant grounded on <resource>", "let users chat with / ask questions about their <resource>", "wire a resourceReadTool", "add a flows-actors chat agent", "expose an actor system as a chat view", "set a deadline on an approval", "remind reviewers before an approval expires" |
226
236
  | **`flows-actors-llm-agent-invocation`** — author a ONE-SHOT LLM agent and call it from your own backend code (operation key → agent definition → registration → `invokeAgent` envelope → wrapped output); text or schema-constrained structured output, no conversation and no view | "summarize this with AI", "classify / categorize these with an LLM", "extract fields from this text", "call Claude / GPT from the backend", "add an AI agent that generates X", "get structured JSON out of a model", "score or triage this automatically", "invokeAgent" |
227
237
  | **`configure-coding-agent`** — configure the autonomous agent that edits THIS application's own workspace (ACP execution profile → ceiling → host-configuration posture → per-agent limits you cannot configure away) | "set up the coding agent", "let the AI edit my app", "switch to Codex / OpenCode", "use a different model for coding tasks", "the coding agent can't start", "execution profile not found", "my coding run changed nothing", "the agent asked for permission and there was nobody to answer" |
228
238
  | **`flows-actors-a2a-exposure`** — expose your agentic actor systems to EXTERNAL AI agents over Agent2Agent (auto-exposed skills + OIDC/OAuth auth; user-delegated OR machine principal → scope-owned conversations) | "expose my actor as an A2A agent", "let other AI agents call my assistant", "agent2agent", "A2A endpoint", "machine / client-credentials access to my chat agent", "how do external agents authenticate to my actor", "agent card" |
239
+ | **`flows-actors-autonomous-agents`** — run an agent with nobody signed in, on a schedule or from an inbound handler, under a machine credential each organization binds to it; its writes pause for a reviewer | "run this agent every morning", "schedule an agent", "an agent that works in the background", "triage X automatically and let an admin approve", "start an agent from a webhook / inbound email", "autonomous agent", "bind an agent to an OAuth client" |
240
+ | **`model-cost-attribution`** — know what each case costs in model calls: declare the case resource (`workUnit`), register model prices (`modelCostAccounting`), pass `caseRef` to turns, read `POST /model-cost/summary` | "how much does each ticket cost us in AI", "cost per case", "track LLM spend per customer", "what is our margin per matter", "register model prices" |
241
+ | **`agent-work-review`** — record what experts decide about an agent's work: tool approvals automatically, actor questions marked as reviews, `recordOutputReview` for edited drafts; reason codes (`agentWorkReview`), the organization's content opt-in, the override rate (`POST /agent-work/override-rate`) and the authorised evaluation export (`POST /agent-work/evaluation-exports`) | "how often do our lawyers correct the agent", "track the override rate", "record expert corrections", "export corrections for evals", "why did the export get refused" |
229
242
  | **`resource-mcp-tool-exposure`** — expose resource OPERATIONS (create/read/list/search/update/delete) as MCP tools to external AI agents via the per-operation `mcp: { exposed, description }` opt-in (fail-closed; ORG/APP scope only; OAuth 2.1 resource-server auth, per-call role authorization) | "expose my resource as an MCP tool", "let an AI agent create/read/update my <resource>", "add MCP tools", "model context protocol server", "make my resources callable by an agent", "machine access to resource CRUD", "how do agents authenticate to my MCP endpoint", "agent-callable tools" |
230
243
  | **`backend-addon-wiring`** — wire backend services, controllers, DI bindings for a module | "add a controller to backend-api", "wire DI for a new service", "register flows-actors integration", "new service in the backend module" |
231
244
  | **`backend-custom-operation`** — implement or modify default/custom resource operations server-side | "change server-side create logic for tasks", "add custom operation handler", "override default update behavior", "custom backend logic for an operation" |
245
+ | **`inbound-channels`** — declare an inbound handler (`BackendDomainModule.inboundHandlers`): a webhook handler, engine-verified (Svix / HMAC header), or an EMAIL channel handler gated on the sender's assurance, answering on the thread; receiving email (shared domain, organization domains proven by a DNS TXT record, client mailboxes); stored once, scope-pinned with declared roles, retried, replayable | "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "let each organization receive mail at its own domain", "give each client a mailbox on our domain" |
232
246
  | **`rate-limit-authoring`** — author per-endpoint rate limits via the declarative `rateLimit?` policy on resource-operation variants, or call `RateLimitBackendService.checkPolicy(...)` from a custom controller | "rate-limit this endpoint", "add a per-IP cap", "throttle the magic-link / OTP / password-reset / register flow", "the endpoint is being abused", "tune the OAuth / SCIM token quota", "the headers don't show the right `X-RateLimit-Reset`" |
233
247
  | **`authorization-unit-narrowing`** — declare a resource confined to the organization UNIT (department / region / team) a member holds a role in, via the `organizationUnitNarrowing` startup opt-in; confines reads and writes without touching the organization scope | "scope this resource to a department", "each team should only see their own records", "regional managers should only manage their region's data", "restrict projects to the user's business unit", "add unit-level permissions", "why can a unit manager see every record" |
248
+ | **`service-provider-relationships`** — let one organization's people work inside other organizations (an agency, a practice) under a relationship each client proposes or accepts, can confine to some of its teams, and can end on the next request; `servesAsProvider` on an organization type | "let an agency work in our customers' workspaces", "our consultants need access to client accounts", "managed service provider access", "limit the agency to one department", "how does a client revoke an outside firm" |
234
249
 
235
250
  ### Data seeding — declarative row materialization + operations
236
251
 
@@ -336,7 +351,7 @@ contracts and the `InboundContact` resource.
336
351
  | **`website-section-hero`** — author a Hero section using `defineWebsiteSection({ category: WebsiteSectionCategory.HERO, … })` with optional `Organization`/`WebSite` JSON-LD | "add a hero section", "write the landing hero", "compose a hero with headline / subheadline / CTA", "customize the hero layout" |
337
352
  | **`website-section-cta`** — author a mid-page CTA band using `defineWebsiteSection({ category: WebsiteSectionCategory.CTA, … })` with cross-frontend handoff | "add a CTA section", "write a 'sign up' band", "compose a mid-page CTA with headline + button", "customize the conversion CTA layout" |
338
353
  | **`website-section-pricing`** — author a Pricing section using `defineWebsiteSection({ category: WebsiteSectionCategory.PRICING, … })` with first-class `Product` + `AggregateOffer` JSON-LD | "add a pricing section", "compose pricing tiers", "wire pricing JSON-LD for SEO", "customize the pricing comparison layout" |
339
- | **`website-section-contact`** — author a Contact section around the engine's `InboundContactForm` and the site's `WebsiteAnonymousSessionClient` | "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with email + topic", "build a sales-contact landing form" |
354
+ | **`website-section-contact`** — author a Contact section around the engine's `InboundContactForm` and the site's `WebsiteAnonymousSessionClient` | "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with an email field", "build a sales-contact landing form" |
340
355
  | **`website-section-faq`** — author an FAQ section using `defineWebsiteSection({ category: WebsiteSectionCategory.FAQ, … })` with mandatory `FAQPage` JSON-LD for AEO/GEO | "add an FAQ section", "compose questions and answers with structured data", "wire FAQ JSON-LD", "customize the FAQ accordion layout" |
341
356
  | **`website-section-social-proof`** — author a Social Proof section (logo band / testimonial list / aggregate rating) using `defineWebsiteSection({ category: WebsiteSectionCategory.SOCIAL_PROOF, … })` with `Review` + `AggregateRating` JSON-LD | "add a logos band", "compose a testimonial section", "wire customer-quote JSON-LD", "build a press-mentions strip" |
342
357
  | **`website-section-feature-benefit-summary`** — author a Feature-Benefit Summary grid (icon + headline + blurb) using `defineWebsiteSection({ category: WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY, … })`; copy ideally grounded in `MarketFeatureBenefit` entries | "add a feature grid", "compose a 3-up benefits section", "wire icons + headline + blurb", "build a 'why us' summary band" |
@@ -349,26 +364,14 @@ contracts and the `InboundContact` resource.
349
364
  | **`website-marketing-metadata-extension`** — extend `marketingMetadata.extra` on InboundContact with ICP-specific tracking fields | "add custom marketing metadata", "track ICP fields on contact", "capture company size on form submission", "extend inbound-contact attribution" |
350
365
  | **`website-bundle-discipline`** — bundle-safety contract for app-side website code (primitive overrides, layout overrides, sections, page composition, label packs, Astro middleware): which packages are safe to import, why `@wildo-ai/saas-models/public-runtime` is the only door, when SSR-tier deps (`axios` / `jsonwebtoken` / `socket.io-client` / `reflect-metadata`) are allowed | "the marketing site bundle exploded", "can I import saas-frontend-lib in my Hero", "where do I get locale enums on the website", "is axios ok in my Astro middleware", "should this go in island or middleware", "review my website primitive override for bundle safety" |
351
366
 
352
- ### Journey — app-creation journey interface
353
-
354
- Anything that drives **application creation**: the playbook-driven choreography
355
- that builds the application, served by the dev companion's HTTP surface
356
- (`/api/companion/playbooks`, `/playbooks/loop`, `/build/*`, `/deliberations/run`,
357
- `/traces`). Reads there need nothing; a mutating call — `/playbooks/loop` and
358
- `/deliberations/run` among them — must carry `x-wildo-companion-token` from
359
- `./.wildo-saas/state/companion.token`, or it answers `401`. State lives in git
360
- (committed = accepted) and on the eligibility board; acceptance is a human git
361
- commit. The advisory judge's verdicts are
362
- review input, never gates.
363
-
364
- | Skill | Trigger phrases |
365
- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
366
- | **`journey-status`** — read where creation stands: eligibility board, coding-lane next task, recent traces, git acceptance state | "where is my app journey", "journey status", "what's the state of the build", "what is blocking progress" |
367
- | **`journey-next`** — list the playbooks eligible RIGHT NOW and propose one, without executing | "what should we do next on the app", "journey next", "what's the next step of the build", "propose the next playbook" |
368
- | **`journey-run`** — run one playbook, read what landed, the validator findings and the advisory judge verdicts | "run the next playbook", "journey run", "execute the vision playbook", "start playbook X" |
369
- | **`journey-approve`** — guide the creator through accepting landed work: review the diff with the judge's findings, then a human commit | "accept this run", "journey approve", "approve the landed files", "how does acceptance work" |
370
- | **`journey-report`** — provenance-backed progress report: accepted commits, in-flight edits, run evidence, judge findings | "journey report", "summarize the app-creation progress", "what has been accepted so far", "write up where the build stands" |
371
- | **`journey-bootstrap-scope`** — collect the creator's declared interview answers (scope, regulated domains) a playbook requires | "declare the application scope", "answer the playbook questions", "start the vision interview", "the run wants elicitation answers" |
367
+ ### Driving application creation — not a knowledge skill
368
+
369
+ Running creation — playbooks, the build lane, answering the dev companion's questions, accepting what it
370
+ produced — is done through the `/wildo:*` Claude Code commands (`/wildo:start`, `/wildo:status`, `/wildo:next`,
371
+ `/wildo:run`, `/wildo:build`, `/wildo:answer`, `/wildo:accept`, `/wildo:why`, `/wildo:doctor`) and the `wildo creation …` and
372
+ `wildo build …` verbs they call. They ship in the `wildo` plugin, not in this catalog. Route a request
373
+ about WHERE creation stands, WHAT to run next, or HOW acceptance works to those commands; this catalog
374
+ is the knowledge the work itself needs. Never call the companion's routes directly.
372
375
 
373
376
  ## Notes
374
377
 
@@ -0,0 +1,141 @@
1
+ ---
2
+ name: agent-work-review
3
+ description: Record what experts decide about an agent's work, and use it. Mark an actor question as a review, record an expert's edit of agent-drafted output with `recordOutputReview`, declare reason codes, let an organization keep the content of corrections under a stated purpose, read the override rate from `POST /agent-work/override-rate`, and export evaluation data under a recorded authorisation from `POST /agent-work/evaluation-exports`. Use when the user says "how often do our lawyers correct the agent", "track the override rate", "record expert corrections", "log what the reviewer changed", "export corrections for evals", or "why did the export get refused".
4
+ user-invocable: false
5
+ ---
6
+
7
+ # Agent Work Review
8
+
9
+ ### Target Application Framing
10
+
11
+ This knowledge is for configuring behavior in the target application.
12
+ Wildo is the framework surface being used, not the product being built.
13
+
14
+ Read and apply these patterns from the application-developer point of view:
15
+
16
+ - how the application should configure the relevant app-level file
17
+ - how the application should use framework-provided factories, enums, and helpers
18
+ - how the application should avoid mixing frontend, backend, and infrastructure concerns
19
+
20
+
21
+ ## Overview
22
+
23
+ A service firm runs agents under experts: the agent proposes, a person accepts, changes or rejects it. Every
24
+ such decision is the firm's evidence that the work was supervised, and its best signal of where an agent is
25
+ weak. The engine records each one once, as metadata (who, when, what changed, never what it changed to), and
26
+ computes the override rate from it. It keeps the proposal and the final version only when the organization
27
+ chooses to, with a stated purpose, and exports them as evaluation data only under a recorded authorisation.
28
+
29
+ Tool-call approvals are recorded by the engine with nothing to author. The application authors three things:
30
+ which actor questions are reviews, which edits of agent-drafted rows are reviews, and its reason codes.
31
+
32
+ ## App Paths
33
+
34
+ | Surface | Glob (relative to the application root) |
35
+ |---|---|
36
+ | Reason codes, privileged cases | `backend-api/src/saas-config.backend.ts` (`agentWorkReview`) |
37
+ | Output review calls | `backend-api/src/**/*.custom-impl.backend.service.ts`, `backend-api/src/**/*.backend.service.ts` |
38
+ | Actor questions marked as reviews | `backend-api/src/**` where the actor system suspends (`HumanDecision_Request.review`) |
39
+ | Override-rate and export screens | `frontend/src/**` |
40
+
41
+ ## When to Use
42
+
43
+ - An agent drafts something (a letter, a ticket reply, a todo) and a person edits or rejects it.
44
+ - The firm wants its override rate per agent, tool, case or expert.
45
+ - The firm wants to evaluate or fine-tune its own agents on its experts' corrections.
46
+
47
+ ## When NOT to Use
48
+
49
+ - Who may answer a decision, reassignment, deadlines → the decision's route (`flows-actors-chat-assistant`).
50
+ - What a case costs in model calls → `model-cost-attribution`.
51
+ - How long records are kept → `resource-retention-binding` (these follow `AUDIT_LOGS`).
52
+
53
+ ## Workflow
54
+
55
+ 1. **Tool approvals: nothing to do.** Every approve, edit and deny of a gated tool call is recorded when it
56
+ settles, and so are lapses and withdrawals, which never count in the rate.
57
+ 2. **Mark an actor question as a review** when it asks a person to judge the actor's work: set
58
+ `review: { surface: AgentWorkDecisionSurface.ACTOR_REVIEW }` on the `HumanDecision_Request`, and pass
59
+ `decisionRecord` (owner scope, proposal, final version, reason code) when resuming or cancelling. A question
60
+ that asks for information is not a review; leave it unmarked (`references/framework-agent-work-review-marker-api.md`).
61
+ 3. **Record an edit of agent-drafted output** with `recordOutputReview` on `AgentWorkDecisionsBackendService`
62
+ (`@wildo-ai/saas-backend-lib`, bound as `SAAS_SERVICE_TYPES.AgentWorkDecisionsService`), passing an id you keep
63
+ and that is unique across the application (`decisionRef`: reusing one for another owner is refused), so a retry
64
+ records once
65
+ (`references/framework-agent-work-output-review-api.md`). The case must be a row of a `workUnit` resource
66
+ the caller can read.
67
+ 4. **Declare reason codes** in `agentWorkReview.reasonCodes`, and the case resources that are privileged in
68
+ `privilegedCaseResourceTypes` (`references/framework-agent-work-review-config-api.md`). An undeclared code is
69
+ refused and the decision stays open. The engine's approval card and inbox offer the declared codes while the
70
+ reviewer CORRECTS the agent (edits the call, or rejects it), and send the choice as `reasonCode`; approving as
71
+ proposed sends none, and a reason is always optional. The codes are configuration values under a NAMED vocabulary:
72
+ their words live at `system_enums.AgentWorkReasonCode.<code>`, planned by `wildo generate labels` from your
73
+ declaration. Never word them in a component; a code nobody has worded shows as the code. A code may use letters,
74
+ digits, `_` and `-` only.
75
+ 5. **Let organizations choose content capture.** Place the engine's `agent-work-review` settings destination in the
76
+ organization category of `frontend/src/config/settings-hub.config.ts`. It carries the override rate, the capture
77
+ setting, the export authorisation and the export ledger, for organization administrators. The capture setting is
78
+ one row per organization, and reading it is its page: the first read creates it `METADATA_ONLY`, and the
79
+ administrator changes it in its form. `WITH_CONTENT` needs a `purpose`, `contentReaderRole` names who else may read
80
+ the content (picked from the organization's roles, your custom organization roles included), and `narrowToCaseRefs` limits it to some cases (`references/framework-agent-work-capture-settings-api.md`).
81
+ 6. **Read the override rate**: `POST /api/v1/agent-work/override-rate` with a window, `groupBy` and the
82
+ organization (`references/framework-agent-work-override-rate-api.md`). Show `notDecided` beside the rate.
83
+ 7. **Export evaluation data** only after the organization grants it: its `evaluationExportAuthorizations` row
84
+ (created `NOT_GRANTED` on the first read of its settings page) set `ACTIVE` with a `basis` and a `basisReference`.
85
+ A grant without both is refused (400), and so is a return to `NOT_GRANTED`: withdrawing is `REVOKED`, which marks
86
+ the datasets exported under it (`references/framework-evaluation-export-authorization-api.md`). Then call
87
+ `POST /api/v1/agent-work/evaluation-exports` (`references/framework-evaluation-dataset-export-api.md`). With no row,
88
+ `NOT_GRANTED` or `REVOKED`, the export is refused (403) and audited.
89
+ 8. **Stop** when an edit in the application appears in the override rate as a modification, and an export
90
+ without authorisation is refused.
91
+
92
+ ## References
93
+
94
+ - `references/framework-agent-work-vocabulary-api.md` — source-backed record sources, groupings, capture modes, export bases, rated outcomes.
95
+ - `references/framework-agent-work-review-marker-api.md` — source-backed decision surfaces, the `review` marker, and the actor plane's `decisionRecord`.
96
+ - `references/framework-agent-work-review-config-api.md` — source-backed `agentWorkReview` configuration.
97
+ - `references/framework-agent-work-capture-settings-api.md` — source-backed organization content-capture setting.
98
+ - `references/framework-agent-work-output-review-api.md` — source-backed `recordOutputReview` input.
99
+ - `references/framework-agent-work-override-rate-api.md` — source-backed override-rate request and answer.
100
+ - `references/framework-evaluation-export-authorization-api.md` — source-backed export authorisation.
101
+ - `references/framework-evaluation-dataset-export-api.md` — source-backed export request and answer.
102
+
103
+ ## Verification
104
+
105
+ - [ ] Every actor question that asks a person to judge the actor's work carries `review`, and no other does.
106
+ - [ ] Every screen where an expert edits an agent draft calls `recordOutputReview` with a stable `decisionRef`.
107
+ - [ ] Every reason code the UI offers is in `agentWorkReview.reasonCodes` and has a label under `system_enums.AgentWorkReasonCode`.
108
+ - [ ] The override-rate screen shows `notDecided`, and never a rate for a group with none decided.
109
+ - [ ] The export screen handles the refusal (403) by pointing at the authorisation.
110
+ - [ ] The organization settings place `agent-work-review` when the application has agents.
111
+
112
+ Grep invariants: `rg -n "review: \{" backend-api/src` lists the marked questions;
113
+ `rg -n "recordOutputReview" backend-api/src` lists the output-review calls;
114
+ `rg -n "agentWorkReview" backend-api/src/saas-config.backend.ts` finds the reason codes;
115
+ `rg -n "AgentWorkReasonCode" backend-api/src/engine/i18n/themes/system_enums.en.ts` finds their words (regenerate with `wildo generate labels` when absent);
116
+ `rg -n "agent-work-review" frontend/src/config/settings-hub.config.ts` finds the settings placement.
117
+
118
+ ## Common Rationalizations
119
+
120
+ | Rationalization | Reality |
121
+ |---|---|
122
+ | "Mark every question as a review, more data is better." | A clarifying question is not a verdict on work; counting it inflates the rate's denominator. |
123
+ | "Store the reviewer's free-text reason as the code." | Codes are a declared list; free text goes to `reasonText`, kept only under the content opt-in. |
124
+ | "Word the reason codes in my screen's own labels." | Their words live once, under `system_enums.AgentWorkReasonCode`, planned from the declaration; a second copy drifts from it. |
125
+ | "Keep content by default, it is useful for evals." | Content is the client's material: off by default, on only with a stated purpose. |
126
+ | "A lapsed approval is a rejection." | Nobody decided; it is counted apart and never in the rate. |
127
+ | "The firm owns the corrections, export them anytime." | Improving the firm's own agents is a purpose of its own: it needs a recorded basis, and privileged cases their client's consent. |
128
+
129
+ ## Red Flags
130
+
131
+ - A `review` marker on a question that asks for information (catch with the `review` grep above).
132
+ - An expert edit screen with no `recordOutputReview` call (catch with the `recordOutputReview` grep above).
133
+ - A reason code offered in the UI but missing from `agentWorkReview.reasonCodes` (the answer is refused; check the config grep above).
134
+ - A declared reason code with no word under `system_enums.AgentWorkReasonCode` (it shows as the code; catch with the labels grep above).
135
+ - An override rate shown without the undecided count.
136
+
137
+ ## Related Skills
138
+
139
+ - `flows-actors-chat-assistant` — approvals in chat, where tool decisions are taken.
140
+ - `model-cost-attribution` — the case, and the expert time this record adds to a case's cost.
141
+ - `resource-retention-binding` — the retention these records follow.
@@ -0,0 +1,38 @@
1
+ # The organization's content-capture setting (source-backed)
2
+
3
+ Read this when:
4
+ - building the organization's setting screen;
5
+ - deciding who may read kept content.
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-models`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-models`
14
+
15
+ ```typescript
16
+ *
17
+ * One organization's choice to keep the CONTENT of its experts' corrections (#1599 D5). No row means
18
+ * `METADATA_ONLY`. Every change is audited (`CORRECTION_CAPTURE_SETTING_CHANGED`). Keeping content needs a stated
19
+ * purpose; the engine refuses `WITH_CONTENT` without one.
20
+ */
21
+ export const AgentWorkCaptureSettingsSchema = z.object({
22
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
23
+ organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),
24
+ contentCapture: z.enum(CorrectionContentCapture).systemEnum('CorrectionContentCapture').default(CorrectionContentCapture.METADATA_ONLY).isSummaryField(),
25
+ /** Why the content is kept, stated by the organization. Required to turn capture on. */
26
+ purpose: z.string().min(1).max(2_000).optional(),
27
+ /**
28
+ * The organization role that may READ captured content (an organization administrator always may). Content is the
29
+ * client's material; the role says who among its people may see what the experts changed.
30
+ */
31
+ contentReaderRole: z.string().min(1).max(120).optional(),
32
+ /** Keep content only for these cases (a matter-by-matter opt-in). Empty: every case of the organization. */
33
+ narrowToCaseRefs: z.array(WorkUnitRefSchema).max(500).default([]),
34
+ createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
35
+ updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
36
+ });
37
+ export type AgentWorkCaptureSettings = z.infer<typeof AgentWorkCaptureSettingsSchema>;
38
+ ```
@@ -0,0 +1,40 @@
1
+ # recordOutputReview (source-backed)
2
+
3
+ Read this when:
4
+ - recording an expert's edit of agent-drafted output;
5
+ - choosing the decisionRef an application keeps.
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-models`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-models`
14
+
15
+ ```typescript
16
+ *
17
+ * `recordOutputReview` — the application tells the engine an expert reviewed output an agent drafted into the
18
+ * application's own rows (the main case in a service firm: an agent drafts a letter, a lawyer edits it). The
19
+ * application supplies `decisionRef` (opaque, unique per review), so a retried call records once.
20
+ */
21
+ export const AgentWorkOutputReviewInputSchema = z.strictObject({
22
+ decisionRef: z.string().min(1).max(200),
23
+ outcome: z.enum([HumanDecision_Outcome.ACCEPTED, HumanDecision_Outcome.ACCEPTED_WITH_MODIFICATIONS, HumanDecision_Outcome.REJECTED] as const),
24
+ agentRef: z.string().min(1).max(200),
25
+ agentVersion: z.string().min(1).max(120).optional(),
26
+ /** The case the output is for. Admitted only if it is a readable row of a `workUnit` resource. */
27
+ caseRef: WorkUnitRefSchema.optional(),
28
+ taskRef: z.string().min(1).max(200).optional(),
29
+ /** The row the reviewed output now lives in. */
30
+ finalWorkProductRef: AgentWorkProductRefSchema.optional(),
31
+ /** What the agent proposed, and what the expert kept. Used for the diff; stored only under the tenant's opt-in. */
32
+ proposal: z.unknown().optional(),
33
+ final: z.unknown().optional(),
34
+ reasonCode: AgentWorkReasonCodeSchema.optional(),
35
+ reasonText: z.string().max(4_000).optional(),
36
+ /** When the draft was put before the expert (defaults to the review instant when the application does not know). */
37
+ presentedAt: z.iso.datetime({ offset: true }).optional(),
38
+ });
39
+ export type AgentWorkOutputReviewInput = z.infer<typeof AgentWorkOutputReviewInputSchema>;
40
+ ```
@@ -0,0 +1,54 @@
1
+ # The override-rate API (source-backed)
2
+
3
+ Read this when:
4
+ - building an override-rate report;
5
+ - reading notDecided and a null rate.
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-models`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-models`
14
+
15
+ ```typescript
16
+ *
17
+ * The override rate: (ACCEPTED_WITH_MODIFICATIONS + REJECTED) / (ACCEPTED + ACCEPTED_WITH_MODIFICATIONS + REJECTED)
18
+ * per group, over a window. Lapsed, withdrawn and authority-lapsed decisions are counted apart and never enter the
19
+ * rate. Computed from metadata only: no export authorisation is needed.
20
+ */
21
+ export const AgentWorkOverrideRateRequestSchema = z.strictObject({
22
+ from: z.iso.datetime({ offset: true }),
23
+ to: z.iso.datetime({ offset: true }),
24
+ groupBy: z.enum(AgentWorkDecisionGrouping),
25
+ /** The tenant. Required for an organization administrator; an application administrator may omit it. */
26
+ organizationId: z.string().min(1).optional(),
27
+ agentRef: z.string().min(1).optional(),
28
+ }).refine(withinWindow, { message: `from must precede to, within ${AGENT_WORK_MAX_WINDOW_DAYS} days`, path: ['to'] });
29
+ export type AgentWorkOverrideRateRequest = z.infer<typeof AgentWorkOverrideRateRequestSchema>;
30
+
31
+ export const AgentWorkOverrideRateGroupSchema = z.object({
32
+ key: z.object({
33
+ agentRef: z.string().optional(),
34
+ toolName: z.string().optional(),
35
+ caseRef: WorkUnitRefSchema.optional(),
36
+ deciderUserId: z.string().optional(),
37
+ }),
38
+ accepted: z.number().int().min(0),
39
+ acceptedWithModifications: z.number().int().min(0),
40
+ rejected: z.number().int().min(0),
41
+ /** Lapsed, withdrawn and authority-lapsed: not decisions anyone made, never in the rate. */
42
+ notDecided: z.number().int().min(0),
43
+ /** `null` when nothing was decided in the group: a rate of zero decisions is not zero. */
44
+ overrideRate: z.number().min(0).max(1).nullable(),
45
+ });
46
+ export type AgentWorkOverrideRateGroup = z.infer<typeof AgentWorkOverrideRateGroupSchema>;
47
+
48
+ export const AgentWorkOverrideRateSchema = z.object({
49
+ window: z.object({ from: z.string(), to: z.string() }),
50
+ groupBy: z.enum(AgentWorkDecisionGrouping),
51
+ groups: z.array(AgentWorkOverrideRateGroupSchema),
52
+ });
53
+ export type AgentWorkOverrideRate = z.infer<typeof AgentWorkOverrideRateSchema>;
54
+ ```
@@ -0,0 +1,28 @@
1
+ # The agentWorkReview configuration (source-backed)
2
+
3
+ Read this when:
4
+ - declaring reason codes;
5
+ - declaring privileged case resources.
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-models`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-models`
14
+
15
+ ```typescript
16
+ *
17
+ * `agentWorkReview` in the backend configuration (#1599): the application's reason-code vocabulary for corrections,
18
+ * and the case resources whose work is privileged (an export of such a case needs its client's recorded consent).
19
+ * Optional: absent, reason codes are refused and no case is treated as privileged.
20
+ */
21
+ export const AgentWorkReviewConfigSchema = z.strictObject({
22
+ /** The reason codes an expert may give for a correction. A code outside this list is refused, never stored. */
23
+ reasonCodes: z.array(AgentWorkReasonCodeSchema).max(200).default([]),
24
+ /** Work-unit resource types whose cases are privileged or confidential (a matter, a patient file). */
25
+ privilegedCaseResourceTypes: z.array(z.string().min(1).max(120)).max(50).default([]),
26
+ });
27
+ export type AgentWorkReviewConfig = z.infer<typeof AgentWorkReviewConfigSchema>;
28
+ ```
@@ -0,0 +1,108 @@
1
+ # Review markers and the actor plane's decision record (source-backed)
2
+
3
+ Read this when:
4
+ - marking an actor-system question as a review of the actor's work;
5
+ - passing the record's half (owner scope, proposal, final version, reason code) when resuming or cancelling it.
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-models`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-models`
14
+
15
+ ```typescript
16
+ *
17
+ * Where a decision on an AGENT'S PROPOSAL was taken (#1599). Only a decision on something an agent proposed is
18
+ * recorded as agent-work review — a clarifying question is not, or it would inflate the override rate's denominator.
19
+ * An actor-system question is a review only when its `HumanDecision_Request` carries `review: { surface }`.
20
+ */
21
+ export enum AgentWorkDecisionSurface {
22
+ /** A person approved, edited or denied a tool call the agent proposed (the paused-turn approval). Always a proposal. */
23
+ TOOL_CALL_APPROVAL = 'tool_call_approval',
24
+ /** A person answered an actor-system suspension that asked them to review the actor's work. */
25
+ ACTOR_REVIEW = 'actor_review',
26
+ /** A person reviewed output an agent drafted into the application's own rows (`recordOutputReview`). */
27
+ OUTPUT_REVIEW = 'output_review',
28
+ }
29
+
30
+ /**
31
+ * A reason code an expert gives for a correction (#1599): one value of the vocabulary the APPLICATION declared
32
+ * (`agentWorkReview.reasonCodes`). A code outside that vocabulary is refused before anything moves, never stored.
33
+ *
34
+ * No `.` (#1921): a code is also the last segment of its label key, `system_enums.AgentWorkReasonCode.<code>`, and
35
+ * the label tree is addressed by dotted path — a dotted code would name a label nobody could resolve, so it would
36
+ * render as its raw code forever with nothing reporting why.
37
+ */
38
+ export const AgentWorkReasonCodeSchema = z.string().min(1).max(80).regex(LABEL_KEY_SEGMENT_PATTERN);
39
+
40
+ /**
41
+ * The NAMED VOCABULARY the reason codes' words live under (#1921): `system_enums.AgentWorkReasonCode.<code>`.
42
+ *
43
+ * The VALUES are the application's (`agentWorkReview.reasonCodes`); the NAME is the framework's, so a reviewer surface
44
+ * and the labelling pipeline agree on where each code's words are without either inventing them. The pipeline plans one
45
+ * key per declared code; a code with no authored word renders as the code itself — a missing label that looks missing.
46
+ */
47
+ // The wire value is `'AgentWorkReasonCode'`: the words live under `system_enums.AgentWorkReasonCode.<code>`.
48
+ export const AGENT_WORK_REASON_CODE_VOCABULARY = ApplicationConfigVocabulary.AGENT_WORK_REASON_CODE;
49
+ ```
50
+
51
+ ## Import Origins
52
+
53
+ - `@wildo-ai/saas-models`
54
+
55
+ ## Source Excerpts
56
+
57
+ ### Origin Package: `@wildo-ai/saas-models`
58
+
59
+ ```typescript
60
+ /**
61
+ * Marks the request as a REVIEW of an agent's proposal (#1599): its settlement is recorded as an agent-work
62
+ * decision on this surface. Absent for a question that asks for information rather than a verdict on work.
63
+ * A tool approval is always a proposal and needs no marker.
64
+ */
65
+ review: z.strictObject({
66
+ surface: z.enum(AgentWorkDecisionSurface),
67
+ }).optional(),
68
+ ```
69
+
70
+ ## Import Origins
71
+
72
+ - `@wildo-ai/saas-backend-lib`
73
+
74
+ ## Source Excerpts
75
+
76
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
77
+
78
+ ```typescript
79
+ *
80
+ * The host's half of an actor-plane agent-work record (#1599): the owner scope the engine cannot know (the actor
81
+ * plane's rows are the host's, and so is their tenancy) and the work itself. The outcome, the decider, the instants
82
+ * and the decision's identity come from the settle.
83
+ */
84
+ export interface ActorExecutionDecisionRecord {
85
+ readonly owner: AgentWorkOwnerScope;
86
+ /** Defaults to the run's actor system. */
87
+ readonly agentRef?: string;
88
+ readonly agentVersion?: string;
89
+ /** What the actor proposed, and what the person kept. For the diff; stored only under the organization's opt-in. */
90
+ readonly proposal?: unknown;
91
+ readonly final?: unknown;
92
+ readonly reasonCode?: string;
93
+ readonly reasonText?: string;
94
+ readonly finalWorkProductRef?: { readonly resourceType: string; readonly resourceId: string };
95
+ readonly taskRef?: string;
96
+ /** The organization the decision was routed in, when the route names none. */
97
+ readonly routeOrganizationId?: string;
98
+ }
99
+
100
+ /**
101
+ * The key of an actor-plane decision's agent-work record: the decision id AND the suspension it settled. A host keys
102
+ * `decisionId` to its run or task id, so one run that asks twice asks under one id; the suspension ref is what tells
103
+ * the two questions apart, and without it the second decision would be deduplicated into the first.
104
+ */
105
+ export function actorDecisionRecordRef(suspension: ActorExecution_Suspension): string {
106
+ return `${suspension.decision.decisionId}:${actorExecutionSuspensionRef(suspension)}`;
107
+ }
108
+ ```