@wildo-ai/framework-knowledge 1.1.5 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (837) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +321 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  338. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  339. package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
  340. package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
  341. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  342. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  343. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  344. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  345. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  346. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  347. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  348. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  349. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  354. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  355. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  356. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  357. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  358. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  359. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  360. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  361. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  362. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  363. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  364. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
  365. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  366. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  367. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  368. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  369. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  370. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  371. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  372. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  373. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  374. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  375. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  376. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  377. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  378. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  379. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  380. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  382. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  383. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  384. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  385. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  386. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  387. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  388. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  389. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  390. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  391. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  392. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  393. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  394. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  395. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  396. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  397. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  398. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  399. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  400. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  401. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  406. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  407. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  408. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  409. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  410. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  411. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  412. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  413. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  414. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  415. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  416. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  417. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  418. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  419. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  420. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  421. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  422. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  426. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  427. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  428. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  431. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  432. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  433. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  435. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  437. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  438. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  439. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  440. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  441. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  442. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  443. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  445. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  446. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  448. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  450. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  451. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  452. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  453. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  454. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  455. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  460. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  461. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  462. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  463. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  464. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  466. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  467. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  468. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  469. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  470. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  471. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  472. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  473. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  474. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  475. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  476. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  477. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  478. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  479. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  480. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  481. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  482. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  483. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  484. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  485. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  486. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  487. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  488. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  489. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  490. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  491. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  492. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  493. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  494. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  495. package/dist/knowledge/references/website-plan.config.md +39 -6
  496. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  497. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  498. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  500. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  501. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  502. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  503. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  504. package/dist/knowledge/references/zod.factories.address.md +7 -7
  505. package/dist/knowledge/references/zod.factories.code.md +2 -2
  506. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  507. package/dist/knowledge/references/zod.factories.money.md +3 -3
  508. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  509. package/dist/knowledge/registries/framework-topics.json +1248 -54
  510. package/dist/knowledge/registries/playbooks.json +81 -109
  511. package/dist/knowledge/registries/source-tags.json +3201 -1118
  512. package/dist/knowledge/rules/live-context-door.md +29 -0
  513. package/dist/knowledge/skills/INDEX.md +27 -24
  514. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  522. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  526. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  528. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  529. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  530. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  531. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  532. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  533. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  540. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  541. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  543. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
  544. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  545. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  546. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  547. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  551. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  552. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  553. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  554. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  555. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  556. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  557. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  558. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  559. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  560. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  561. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  562. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  564. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  565. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  566. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  568. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  569. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  570. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  571. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  572. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  573. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  574. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  575. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  576. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  577. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  578. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  579. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  581. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  582. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  587. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  595. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  596. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  599. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  600. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  602. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  604. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  605. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  607. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  608. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  609. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  612. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  613. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  614. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  615. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  616. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  617. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  624. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
  625. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  626. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  627. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  628. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  629. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  630. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  631. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  632. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  633. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  634. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  635. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  636. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  637. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  638. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  639. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  640. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  642. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  644. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  645. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  646. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  647. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  648. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  649. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  650. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  651. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  652. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  653. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  657. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  658. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  659. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  660. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  661. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  662. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  663. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  664. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  665. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  666. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  667. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  670. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  671. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  672. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  677. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  678. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  682. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  683. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  684. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  685. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  686. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  687. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  688. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  693. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  694. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  695. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  696. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  697. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  698. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  699. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  700. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  701. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  702. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  703. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  710. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  711. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  712. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  713. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  714. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  715. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  716. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  717. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  718. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  719. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  720. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  721. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  722. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  723. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  724. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  725. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  726. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  727. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  728. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  729. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  730. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  731. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  732. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  733. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  734. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  739. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  740. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  741. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  742. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  743. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  747. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  748. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  749. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  755. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  756. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  757. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  758. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  759. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  763. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  764. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  765. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  766. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  767. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  768. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  769. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  770. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  771. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  773. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  774. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  775. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  776. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  777. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  778. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  779. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  780. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  781. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  782. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  783. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  784. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  785. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  786. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  787. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  788. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  789. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  790. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  791. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  792. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  793. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  794. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  795. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  796. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  797. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  798. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  799. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  800. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  801. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  802. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  803. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  804. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  805. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  807. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  809. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  811. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  813. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  815. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  817. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  819. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  820. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  821. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  822. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  823. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  824. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  825. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  826. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  827. package/dist/knowledge/topic-index.json +5957 -1729
  828. package/dist/tsconfig.build.tsbuildinfo +1 -1
  829. package/dist/tsconfig.tsbuildinfo +1 -1
  830. package/package.json +4 -4
  831. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  832. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  833. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  834. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  835. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  836. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  837. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,745 @@
1
+ # Writing through a read-through resource
2
+
3
+ Read this when a virtual (`HTTP_API`) resource must CREATE, UPDATE or DELETE rows in its system of
4
+ record — an Odoo partner created from the application, an invoice line corrected, a record removed.
5
+
6
+ The data still lives only in the remote system. A write is sent there, once, and the answer is read
7
+ back from there. Nothing is stored locally except a short-lived record that the request's
8
+ `Idempotency-Key` was spent.
9
+
10
+ ## What you declare
11
+
12
+ Three things, and the framework refuses the resource at startup until all three agree:
13
+
14
+ 1. **The verbs the binding OPENS** — `httpApiBinding.writableVerbs`, a list of `HttpApiWriteVerb`
15
+ (`create`, `update`, `delete`). Absent means none: the binding stays read-only.
16
+ 2. **The operations that perform them** — the ordinary `CREATE`, `UPDATE` and `DELETE` core
17
+ operations, or a custom operation that borrows one through `resourceOperationLike`. An operation
18
+ that writes a verb the binding does not open is refused, and so is an opened verb no operation
19
+ uses.
20
+ 3. **Nothing else.** You do not declare an `Idempotency-Key` requirement on the write variants: the
21
+ framework sets it to REQUIRED, because a remote write cannot be rolled back and every retry must
22
+ replay the first outcome. Declaring `accepted` is refused.
23
+
24
+ Also refused, whatever you open:
25
+
26
+ - **bulk writes** — `CREATE_MANY`, `UPDATE_MANY`, `DELETE_MANY`, and a `haveBulkOperation` twin of a
27
+ write. Ten remote writes are ten calls with no transaction to roll back into when the sixth fails;
28
+ - **a queued or background write** — it could not carry the Idempotency-Key;
29
+ - **personal data under `erasure: NO_SUBJECT_DATA`** — refused whether or not you write: a
30
+ read-through resource whose fields declare `.dataCategories(...)` holds personal data in the
31
+ system, so declare `EXTERNAL_ERASURE_OPERATION` or `CONTROLLER_ACKNOWLEDGED_NON_ERASURE` (or, if
32
+ the fields are not about a person, remove the categories);
33
+ - **a dialect that cannot write** — the application refuses to start and names the dialect.
34
+ Which dialects write is a property of your engine version, not of your binding. `ODOO_JSONRPC`
35
+ (see "Writing to Odoo"), `ODATA` v4 (see "Writing to an OData v4 service") and `REST_JSON` (see
36
+ "Writing to a REST_JSON API") write. An OData **v2** service (SAP `/sap/opu/odata/…`) is the
37
+ `ODATA_V2` dialect, which reads only: a binding opening a verb on it is refused at startup.
38
+ - **an UPDATE with no concurrency stance** — a binding that opens `update` must state
39
+ `writeConcurrency` (see each dialect's section below).
40
+ - **on `REST_JSON`, an opened verb with no declared request** — each opened verb needs its
41
+ `operations.<verb>` member, and a member of a verb that is not opened is refused too.
42
+
43
+ ## Who may write what
44
+
45
+ - **Only the organization that owns the application.** A write scoped to any other organization is
46
+ refused before anything is sent (`SYSTEM_OF_RECORD_WRITE_ORGANIZATION_NOT_OWNER`). A read under
47
+ another organization answers an empty page; a write has no honest empty answer.
48
+ - **A CREATE lands in the caller's unit's partition** when the instance is partitioned. A member of
49
+ exactly one assigned unit need send nothing — the engine writes that unit's partition key onto the
50
+ remote row. A member of several units, or an organization-wide caller, must name the unit in
51
+ `organizationUnitId`; otherwise the answer is `SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED`,
52
+ listing the candidates. `organizationUnitId` is a SELECTION and is never sent to the remote.
53
+ - **An UPDATE or DELETE reads the row first**, through the same gates a read passes. A row the caller
54
+ cannot see answers as if it did not exist — it never tells a caller that a row exists elsewhere.
55
+ A SHARED row (partition unset) is readable by everyone and writable only by an organization-wide
56
+ caller.
57
+ - **The partition field, the owner stamp, a row's unit after creation and its key are never
58
+ writable.** Sending one is refused, not stripped (`SYSTEM_OF_RECORD_WRITE_FIELD_NOT_WRITABLE`), and
59
+ a schema field that lands on the partition field must be `.excludeFromCreate().excludeFromUpdate()`
60
+ or the application refuses to start.
61
+
62
+ ## Writing to Odoo
63
+
64
+ Each write is ONE `execute_kw` on the binding's model (`entityRef`), under the instance's own service
65
+ identity and in-args credential:
66
+
67
+ | verb | Odoo call | answer |
68
+ |---|---|---|
69
+ | create | `create(vals)` | the new record's id, from which the row's `_id` is built; the row is then read back |
70
+ | update | `write([id], vals)` | `true`; the row is read back |
71
+ | delete | `unlink([id])` | `true`. If someone else deleted the record a moment earlier, Odoo is expected to answer `true` as well (its access check does not complain about deleting a deleted record); should it refuse instead, the answer is a remote refusal while the row is in fact gone |
72
+
73
+ - **Values are sent under their Odoo names** (`fieldMappings`). A many2one is WRITTEN as the bare id
74
+ (`company_id: 10`) although Odoo READS it back as `[10, "Acme"]`; the partition field on a create is
75
+ written that way by the engine.
76
+ - **A `Date` is sent as `YYYY-MM-DD HH:MM:SS`, UTC** — the only datetime form Odoo parses.
77
+ - **An update that changes no field is refused** rather than sent: Odoo would still stamp a new
78
+ `write_date` and answer `true`.
79
+ - **Odoo has no idempotency mechanism.** A write is sent exactly once, whatever
80
+ `remoteCallSemantics.retry` allows for reads. A timeout or a gateway error after the request left is
81
+ `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, and a retry under the same key answers it again instead of
82
+ creating a second record.
83
+ - **An Odoo refusal** (a validation error, a record another one still references, a record gone
84
+ before an update) comes back as a JSON-RPC error. Odoo ran the call in a transaction and rolled it
85
+ back, so nothing was applied: it is a refusal, never an unknown outcome.
86
+
87
+ ### Concurrency: Odoo has no conditional write, so the check is BEST-EFFORT
88
+
89
+ `write(ids, vals)` applies the values to whatever the record holds now; there is no `If-Match`, no
90
+ expected version. A binding that opens `update` on Odoo therefore states one of two stances:
91
+
92
+ ```ts
93
+ writeConcurrency: { mode: HttpApiWriteConcurrencyMode.VERSION_CHECKED, versionField: 'lastUpdatedAt' }
94
+ // or
95
+ writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS }
96
+ ```
97
+
98
+ `VERSION_CHECKED` names a LOCAL field mapped onto Odoo's `write_date` (the vendor's row version; the
99
+ application refuses to start if the mapping names another field). Declare it
100
+ `.optional().excludeFromCreate()` and NOT `.excludeFromUpdate()` — the factory refuses both mistakes —
101
+ and make it a `string` (the factory refuses any other type), so it is compared byte for byte with
102
+ what Odoo served. Then:
103
+
104
+ - every UPDATE must send the version it READ, unchanged — one without it is refused
105
+ (`SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED`);
106
+ - the engine compares it with the `write_date` Odoo answers to the read it makes just before writing,
107
+ and refuses a mismatch before anything is sent (`SYSTEM_OF_RECORD_WRITE_VERSION_STALE`, 409);
108
+ - the version is compared, never written, and a CREATE may not send it — nor may any other field
109
+ mapped onto `write_date`: Odoo discards a sent `write_date`, so the application refuses to start
110
+ while such a field is writable, and a request carrying one is refused;
111
+ - a DELETE is NOT version-checked: it is read first for the partition, then unlinked.
112
+
113
+ **What it does NOT guarantee — say this to whoever relies on it.** The comparison and the write are
114
+ two calls, so a change that lands between them is overwritten. And Odoo serves `write_date` to the
115
+ SECOND, so two changes inside one second read as the same version. The check turns most lost updates
116
+ into a refusal; it cannot make them impossible. If an update must never overwrite a concurrent change,
117
+ the system of record has to offer a conditional write, and Odoo's external API does not.
118
+
119
+ `LAST_WRITER_WINS` makes no check at all. It is legitimate for data nobody edits concurrently; it is
120
+ declared so that the choice is visible rather than an accident.
121
+
122
+ ## Writing to an OData v4 service
123
+
124
+ Each write is ONE request on the binding's entity set (`entityRef`), under the instance's own
125
+ credential, with `OData-Version: 4.0` and `OData-MaxVersion: 4.0`:
126
+
127
+ | verb | request | answer |
128
+ |---|---|---|
129
+ | create | `POST /<EntitySet>` with the fields, `Prefer: return=representation` | `201` with the created entity, whose key becomes the row's `_id`; no second read |
130
+ | update | `PATCH /<EntitySet>(<key>)` with ONLY the changed fields, `Prefer: return=representation`, `If-Match` | `200` with the entity, or `204` and the row is read back |
131
+ | delete | `DELETE /<EntitySet>(<key>)`, `If-Match` | `204` |
132
+
133
+ - **Never `PUT`.** `PUT` replaces the whole entity, so a partial update would reset every field it
134
+ did not send. `PATCH` leaves them alone.
135
+ - **Values are sent under their OData names** (`fieldMappings`); a `Date` is sent as ISO 8601 UTC,
136
+ the form an `Edm.DateTimeOffset` takes. A property typed `Edm.Date` wants `YYYY-MM-DD`: declare such
137
+ a field as a string. A lookup written as `field@odata.bind` (Dataverse navigation properties) is not
138
+ expressible — map only plain properties.
139
+ - **Every update and delete carries `If-Match`**: the entity tag (`@odata.etag`) of the row the
140
+ engine reads just before writing (for the partition check), or `*` when the service serves no tag
141
+ for this entity set. The service refuses a mismatch with `412 Precondition Failed` and applies
142
+ nothing, so a row that moved — edited, or moved into another partition — between that read and the
143
+ write is never written. `*` still matters: some services (Dataverse) turn a `PATCH` to a key that
144
+ no longer exists into a CREATE, and `If-Match` forbids that.
145
+ - **A `412` is a refusal**, `SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED`: nothing was applied, it is
146
+ not retried. Read the row again, re-apply the change and send it under a NEW key.
147
+ - **No idempotency.** OData offers nothing a service deduplicates a write by, so a write is sent
148
+ exactly once; an interrupted one is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, as for Odoo. So is a
149
+ create answered `204` with no entity: the entity exists and the answer does not say which one.
150
+ - **An update that changes no field is refused** rather than sent: it would move the entity tag and
151
+ make every other holder of it stale.
152
+ - **SAP S/4HANA cannot be written.** SAP Gateway requires an `X-CSRF-Token` fetched by a prior request
153
+ (with its session cookie) on every modifying request, and the engine does not perform that
154
+ handshake — so a binding opening writes against `sap-s4hana` is refused at startup
155
+ (`SYSTEM_OF_RECORD_WRITE_PREREQUISITE_NOT_SUPPORTED`) rather than answered `403` at its first write.
156
+ - **Partitions.** A FIELD partition (a company column) works as for Odoo: a create carries the
157
+ caller's unit's value, and an update or delete of another partition's row sends only its read.
158
+ Business Central's company is a PATH segment, which startup refuses to confine on: a Business
159
+ Central write lands in whatever company its `baseUrl` or `entityRef` path names, exactly as its
160
+ reads do.
161
+
162
+ ### Concurrency on OData: a REAL conditional write
163
+
164
+ State the stance as for Odoo — `VERSION_CHECKED` or `LAST_WRITER_WINS` — with one difference in
165
+ what `VERSION_CHECKED` is worth:
166
+
167
+ ```ts
168
+ fieldMappings: [{ localField: 'rowVersion', remoteField: '@odata.etag' }],
169
+ writeConcurrency: { mode: HttpApiWriteConcurrencyMode.VERSION_CHECKED, versionField: 'rowVersion' },
170
+ ```
171
+
172
+ The caller reads `rowVersion` (the entity tag) and sends it back with the update. The engine refuses
173
+ a mismatch with the row it reads first (`…_WRITE_VERSION_STALE`, nothing sent), then sends the same
174
+ tag as `If-Match` — so a change landing after that comparison is refused BY THE SERVICE
175
+ (`…_WRITE_PRECONDITION_FAILED`). Unlike Odoo, no concurrent change can be overwritten.
176
+
177
+ It is available only against a vendor whose facet declares the entity tag as its row version (the
178
+ generic `odata` facet, `microsoft-dataverse`, `microsoft-dynamics-365-business-central`). A row the service serves without
179
+ a tag is refused by name (`…_WRITE_ROW_VERSION_NOT_SERVED`): the entity set has no versions, and
180
+ `LAST_WRITER_WINS` is the honest stance for it. Declare the field `.optional().excludeFromCreate()`,
181
+ a `string`, and never `.excludeFromUpdate()`, as for Odoo.
182
+
183
+ `LAST_WRITER_WINS` on OData still sends the tag of the row read first, so the service refuses a write
184
+ racing a change by microseconds; what it does not check is the version the CALLER read.
185
+
186
+ ## Writing to a REST_JSON API
187
+
188
+ `REST_JSON` names no protocol, so nothing about a write is inferred: each verb the binding opens is
189
+ declared as the ONE request it sends, beside the read members, and the application refuses to start
190
+ until every opened verb has its member (and every member its opened verb).
191
+
192
+ ```ts
193
+ operations: {
194
+ read: { method: 'GET', pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
195
+ list: { method: 'GET', pathTemplate: '/services/data/v62.0/query', statement: { /* SOQL */ } },
196
+ create: { method: HttpApiRestWriteMethod.POST, pathTemplate: '/services/data/v62.0/sobjects/Account',
197
+ createdKey: { source: HttpApiRestCreatedKeySource.RESPONSE_BODY, path: 'id' } },
198
+ update: { method: HttpApiRestWriteMethod.PATCH, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
199
+ delete: { method: HttpApiRestWriteMethod.DELETE, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
200
+ },
201
+ writableVerbs: [HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE, HttpApiWriteVerb.DELETE],
202
+ writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS },
203
+ ```
204
+
205
+ The two vendors this was built against, and the one thing they differ in:
206
+
207
+ | | create | update | delete | where the new key is |
208
+ |---|---|---|---|---|
209
+ | Salesforce sObject rows | `POST …/sobjects/<Object>` → `201` | `PATCH …/sobjects/<Object>/{key}` → `204` | `DELETE …/sobjects/<Object>/{key}` → `204` | the body: `createdKey: { source: RESPONSE_BODY, path: 'id' }` |
210
+ | NetSuite record service | `POST …/record/v1/<type>` → `204`, no body | `PATCH …/record/v1/<type>/{key}` → `204` | `DELETE …/record/v1/<type>/{key}` → `204` | the `Location` header: `createdKey: { source: LOCATION_HEADER }` |
211
+
212
+ - **A create must say where its key is answered** (`createdKey`). The engine names the new row by
213
+ that key and reads the row back through your `read` member, so what a create answers is what a read
214
+ would. A `Location` is read only when it names a record of the path the create was sent to; an
215
+ answer that does not name the key is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` — the record was made
216
+ and the engine cannot say which one. A created key needs a single key field.
217
+ - **An update or a delete addresses one record** with `{key}` (or `{key.<RemoteField>}` tokens), the
218
+ `read` member's grammar; a create carries no key token and names its collection. Every path starts
219
+ with `/`. No other `{…}` token is allowed, `{key}` needs a single key field, and a
220
+ `{key.<RemoteField>}` must name one of yours — all checked at startup, not at the first write.
221
+ - **Methods:** a create is a `POST`; an update a `PATCH` (or an RPC-style `POST`); a delete a `DELETE`
222
+ (or an RPC-style `POST`). **Never `PUT`** — it replaces the record, so a partial update would reset
223
+ every field it did not send. A vendor whose only update is a full replacement stays read-only.
224
+ - **Values are sent under their remote names** (`fieldMappings`); a `Date` as ISO 8601 UTC. The
225
+ partition field on a create is written by the engine, as for the other dialects. An update that
226
+ changes no field is refused rather than sent.
227
+ - **Vendor headers** go in the member's `staticHeaders`. A credential never does: `Authorization` is
228
+ refused by name, since the binding is committed and the credential comes from the instance.
229
+ - **No idempotency, no precondition.** Neither vendor deduplicates a synchronous write by a request id
230
+ (NetSuite's idempotency header is documented for asynchronous requests), so every write is sent
231
+ exactly once and an interrupted one is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`. Nothing is sent
232
+ conditionally, so `writeConcurrency` is required on an opened update and `VERSION_CHECKED` is
233
+ best-effort, as on Odoo — and available only where the vendor facet declares a row version field,
234
+ which neither the Salesforce nor the NetSuite facet does today: state `LAST_WRITER_WINS` there.
235
+ - **Declared ERP actions are not available on REST_JSON** (see `system-of-record-actions.md`); only
236
+ row writes are.
237
+
238
+ ## The answers a client must handle
239
+
240
+ | code | what happened | what the client does |
241
+ |---|---|---|
242
+ | `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` | The write was sent and nobody knows whether it landed (a timeout, a dropped connection, a gateway answering) | Do NOT resend under a new key. Read the row (or search for it); if it is missing, send a NEW request under a NEW key |
243
+ | `SYSTEM_OF_RECORD_WRITE_IN_PROGRESS` (`409`) | The same key is being sent right now | Wait and retry the same request with the same key |
244
+ | `SYSTEM_OF_RECORD_WRITE_IDEMPOTENCY_KEY_REUSED` (`422`, see below) | The key was already used for a different request (another row, verb or payload) | Never retry that request as it is; use a new key for a new request |
245
+ | `SYSTEM_OF_RECORD_WRITE_APPLIED_FOLLOW_UP_FAILED` | The remote applied the write and a step after it failed | Treat it as written; `appliedWrites` names the rows |
246
+ | `SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED` / `…_PARTITION_REFUSED` / `…_FIELD_NOT_WRITABLE` | Refused before anything was sent | Fix the request; the same key may be retried |
247
+ | `SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED` | A version-checked update carried no version | Send the version field exactly as it was read |
248
+ | `SYSTEM_OF_RECORD_WRITE_VERSION_STALE` | The row changed since it was read; nothing was sent | Read the row again, re-apply the change, send under a NEW key |
249
+ | `SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED` | OData: the service refused the write because the row's entity tag moved (412); nothing was applied | Read the row again, re-apply the change, send under a NEW key |
250
+ | `SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SERVED` | A version-checked update of a row the service serves no version for; nothing was sent | A binding problem: declare `LAST_WRITER_WINS` for that entity set |
251
+
252
+ **Of the three answers the key ledger gives, a reused key is the one that is not a `409` and carries
253
+ no `error.code`.** A key still in flight and a key spent on a different request are opposite
254
+ instructions, so they get different statuses — `409` and `422`, the statuses the Idempotency-Key draft names for them. A `422`
255
+ is a business-rule answer whose details the engine strips on the wire, so an HTTP client branches on
256
+ the status and on `error.customMessageReference: 'idempotency_key_reused'` — the same answer the
257
+ engine's own idempotent operations give a reused key. The code above is what your own server code
258
+ reads when it catches the error in-process (`error.context.code`), and what the audit trail records.
259
+ The same holds for a declared action's door.
260
+
261
+ A retry of an APPLIED create or update under the same key sends nothing and answers the row as it is
262
+ now — even when the operation's `enabledCondition` would refuse the row in the state the first attempt
263
+ left it: the key, not the row's current state, decides a retry. (Only where the framework runs the
264
+ core write that spends the key; an OVERRIDE_ALL or REPLACE implementation in front of it keeps the refusal.) A retried delete under the same key answers what the first attempt did — the deleted id — and sends nothing, even though the row is gone; a delete sent under a NEW key after the row is gone answers "not found".
265
+
266
+ **Idempotency-Key expiry: one day.** After a day a key is forgotten, and reusing it is a new request.
267
+
268
+ ## What you cannot do in the same request
269
+
270
+ - **Write nested children** under a read-through parent. Parent and children could not land together,
271
+ because the parent's write lands in a system with no transaction to share. Write them separately.
272
+ - **Cascade a delete into local rows.** A local resource whose rows point at a read-through parent
273
+ that opens `delete` must declare, on that relationship, `REFUSE_WHILE_CHILDREN_EXIST` (the parent is
274
+ refused while a child names it) or `onParentDelete: { enabled: false }` (the children survive). A
275
+ remote delete cannot be atomic with a local cascade, and neither order is safe.
276
+ - **Run it inside a transaction.** A write is refused inside a database transaction — a retried
277
+ transaction would send it twice. Call it from code that is not inside one.
278
+
279
+ ## The trail
280
+
281
+ Every write attempt — applied, refused, refused by the remote, unknown, replayed — is recorded as
282
+ `http_api_write_through` with the person who acted, the row, and the NAMES of the fields written.
283
+ Never their values: those live in the system of record.
284
+
285
+ ## The stable codes
286
+
287
+ ## Import Origins
288
+
289
+ - `@wildo-ai/saas-models`
290
+
291
+ ## Source Excerpts
292
+
293
+ ### Origin Package: `@wildo-ai/saas-models`
294
+
295
+ ```typescript
296
+ *
297
+ * Why a system of record could not be prepared, read, or written — the stable `context.code` a client branches on.
298
+ * Imported from `@wildo-ai/saas-models`. Request codes ride a `CONFLICT` (409) or `VALIDATION` (400) answer, the two
299
+ * error types whose context reaches the client.
300
+ */
301
+ export enum SystemOfRecordErrorCode {
302
+ /**
303
+ * BOOT — an instance names a vendor no facet answers to.
304
+ *
305
+ * The framework's facets ship in the opt-in library `@wildo-ai/systems-of-record` (#2013), and an augmentation
306
+ * package an instance opts into may add others, so this means the vendor is spelled wrong OR the package that
307
+ * owns it is not installed. The message names both, because from inside the registry the two are
308
+ * indistinguishable, and names the library and its remedy.
309
+ */
310
+ VENDOR_HAS_NO_FACET = 'SYSTEM_OF_RECORD_VENDOR_HAS_NO_FACET',
311
+
312
+ /**
313
+ * BOOT — the application declares systems of record, but its provider runtime artifact lists no facet
314
+ * modules at all: it predates the field, or was never generated. Distinct from
315
+ * {@link VENDOR_HAS_NO_FACET}, because the remedy is a regeneration rather than a spelling or an
316
+ * install, and reporting it as that one sent a correct configuration looking for a typo (2026-09-24).
317
+ */
318
+ FACET_MODULES_NOT_GENERATED = 'SYSTEM_OF_RECORD_FACET_MODULES_NOT_GENERATED',
319
+
320
+ /**
321
+ * BOOT — an instance opts into a facet AUGMENTATION (#1675) from a package that ships none for its
322
+ * vendor: `wildo config sync` did not record its `<package>/systems-of-record` module (a package discovery
323
+ * does not walk by name must be listed in `providers.packages`, #1676), the recorded module fails to load
324
+ * (the import error is named), or it augments other vendors only. `wildo config sync` refuses the first
325
+ * case too, before anything starts. Named rather than ignored, because an augmentation the author believes
326
+ * applies — a partition declaration, say — that silently does not is a confinement they think they have.
327
+ */
328
+ FACET_AUGMENTATION_NOT_FOUND = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_NOT_FOUND',
329
+
330
+ /**
331
+ * BOOT — an opted-in augmentation (#1675) fails the augmentation schema, or the facet it produces once
332
+ * merged into the base fails the facet schema. The refusal names the package and the instance rather
333
+ * than surfacing a bare schema error that names neither.
334
+ */
335
+ FACET_AUGMENTATION_INVALID = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_INVALID',
336
+
337
+ /**
338
+ * BOOT — two facet modules each present a BASE facet for one vendor (#1675). Refused naming both,
339
+ * because the base carries the vendor's partition and "first in module order" would let whichever
340
+ * package name sorts first decide how a tenant's rows are confined. A package that adds to a vendor it
341
+ * does not own ships an augmentation an instance opts into.
342
+ */
343
+ FACET_BASE_CONFLICT = 'SYSTEM_OF_RECORD_FACET_BASE_CONFLICT',
344
+
345
+ /**
346
+ * BOOT — two sources declare the same thing for one instance's vendor (#1675): a partition declared by
347
+ * the base facet AND an augmentation, or by two augmentations; one credential kind offered twice. The
348
+ * facet is the single partition authority, so which declaration confines a tenant's rows must never
349
+ * depend on order. The refusal names both sources.
350
+ */
351
+ FACET_AUGMENTATION_CONFLICT = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_CONFLICT',
352
+
353
+ /**
354
+ * BOOT — the instance declares a dialect its vendor's facet does not speak.
355
+ *
356
+ * A vendor may legitimately offer several (a service reachable over OData v4 and a bespoke REST
357
+ * surface is one vendor, two ways in), so this is checked against the facet's list rather than
358
+ * assumed from the vendor.
359
+ */
360
+ DIALECT_NOT_SPOKEN_BY_VENDOR = 'SYSTEM_OF_RECORD_DIALECT_NOT_SPOKEN_BY_VENDOR',
361
+
362
+ /**
363
+ * BOOT — the instance names a credential kind its vendor does not offer.
364
+ */
365
+ CREDENTIAL_KIND_NOT_OFFERED = 'SYSTEM_OF_RECORD_CREDENTIAL_KIND_NOT_OFFERED',
366
+
367
+ /**
368
+ * BOOT — the vendor offers several credential kinds and the instance named none.
369
+ *
370
+ * Only reachable once a facet offers more than one (#1056). Until then the kind is DERIVED and an
371
+ * author is never asked for something with a single legal answer.
372
+ */
373
+ CREDENTIAL_KIND_AMBIGUOUS = 'SYSTEM_OF_RECORD_CREDENTIAL_KIND_AMBIGUOUS',
374
+
375
+ /**
376
+ * BOOT — a required slot's environment variable is unset while the environment DID author a block
377
+ * for the instance (#1055 E4).
378
+ *
379
+ * Distinct from the instance being declared absent: an environment that has no access says so with
380
+ * `{ enabled: false }`, and this is what is left — an environment that meant to have access and is
381
+ * missing a value. Silence is not a declaration, which is why these two are separable at all.
382
+ */
383
+ REQUIRED_SLOT_MISSING = 'SYSTEM_OF_RECORD_REQUIRED_SLOT_MISSING',
384
+
385
+ /**
386
+ * BOOT — a resource's `httpApiBinding` names an instance the application does not declare.
387
+ *
388
+ * Checked at REGISTRATION rather than in the resource factory, because the factory runs in the
389
+ * application's `shared-lib` where the saas configuration is not in scope. The factory checks
390
+ * SHAPE; this checks AGREEMENT, at the first moment both are visible.
391
+ */
392
+ BINDING_NAMES_UNDECLARED_SYSTEM = 'SYSTEM_OF_RECORD_BINDING_NAMES_UNDECLARED_SYSTEM',
393
+
394
+ /**
395
+ * BOOT — a binding's dialect and its instance's dialect disagree.
396
+ *
397
+ * Both are authored, in different files, and the binding's is the discriminator of its own
398
+ * per-dialect union — so the binding cannot simply inherit the instance's, and the disagreement has
399
+ * to be refused where both are known.
400
+ */
401
+ BINDING_DIALECT_DISAGREES_WITH_SYSTEM = 'SYSTEM_OF_RECORD_BINDING_DIALECT_DISAGREES_WITH_SYSTEM',
402
+
403
+ /**
404
+ * REQUEST — this environment declared it has no access to the instance (#1055 E3).
405
+ *
406
+ * A developer laptop and a staging with no ERP are the ordinary case. The application boots, every
407
+ * other resource works, and a read on a bound resource answers this rather than a transport error
408
+ * against an address nobody authored.
409
+ */
410
+ UNAVAILABLE_IN_ENVIRONMENT = 'SYSTEM_OF_RECORD_UNAVAILABLE_IN_ENVIRONMENT',
411
+
412
+ /**
413
+ * REQUEST — the application has no owner organization to stamp remote rows with (#1055 E10,
414
+ * resting on #1054 E1).
415
+ *
416
+ * A fresh install before bootstrap runs is the real case. Rows read out of a system of record carry
417
+ * the owner organization's id so the per-row tenant gate passes without an exemption; with no owner
418
+ * there is nothing to stamp, and answering an empty list would say "this system holds nothing about
419
+ * you", which is false.
420
+ */
421
+ OWNER_ORGANIZATION_ABSENT = 'SYSTEM_OF_RECORD_OWNER_ORGANIZATION_ABSENT',
422
+
423
+ /**
424
+ * REQUEST — the instance's token endpoint could not be reached, refused to mint, or answered
425
+ * something that is not a token (#1056 E2, E3; R11).
426
+ *
427
+ * ONE code for the whole family rather than one per failure, with a `reason` in the context and an
428
+ * optional `retryAfterSeconds` taken from the answer's `Retry-After`. The family is deliberately
429
+ * coarse because every member has the same shape from a caller's side: the remote is not currently
430
+ * giving us an identity, the request cannot proceed, and retrying later may work. Splitting it
431
+ * would ask a client to branch on a distinction it cannot act on differently.
432
+ *
433
+ * Never carries the token endpoint's own `error_description` verbatim into a client-visible
434
+ * message: an authorization server is entitled to say things about the credential, and a
435
+ * credential's failure mode is not an application user's business. The detail is logged.
436
+ */
437
+ TOKEN_UNAVAILABLE = 'SYSTEM_OF_RECORD_TOKEN_UNAVAILABLE',
438
+
439
+ /**
440
+ * BOOT — the instance's credential material cannot produce a credential at all: an encrypted
441
+ * private key (#1056 E6), a certificate whose validity window does not contain now (E7), a BASIC
442
+ * username carrying the `:` that RFC 7617 makes the delimiter (E11).
443
+ *
444
+ * Separate from {@link REQUIRED_SLOT_MISSING} because the remedy is different: a value IS present
445
+ * and it is the wrong KIND of value, so an operator re-reading their environment for a blank finds
446
+ * nothing. Refused at boot rather than at the first read — the material is known then, and a
447
+ * certificate that expired last week should not first be noticed by a user.
448
+ */
449
+ CREDENTIAL_MATERIAL_UNUSABLE = 'SYSTEM_OF_RECORD_CREDENTIAL_MATERIAL_UNUSABLE',
450
+
451
+ /**
452
+ * BOOT — the instance opts into partitioning and its vendor declares none (#1058).
453
+ *
454
+ * Refused rather than ignored, for the reason the `partition` field was RESERVED for three slices:
455
+ * an author who writes `partition: true` and sees it accepted believes their rows are confined to
456
+ * organization units while every member still sees every row. An accepted declaration that does
457
+ * nothing is worse than a refusal, because only one of the two is visible.
458
+ */
459
+ PARTITION_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_PARTITION_NOT_SUPPORTED_BY_VENDOR',
460
+
461
+ /**
462
+ * BOOT — the instance opts into partitioning and its vendor partitions by a PATH SEGMENT, which
463
+ * this engine cannot confine (#1058 E9).
464
+ *
465
+ * A path segment is chosen before the request is built, so it cannot express "these three
466
+ * companies" in one read: the confinement would have to fan out into one request per unit, which is
467
+ * a different MECHANISM rather than a different predicate. Distinct from the code above because the
468
+ * remedy differs — there the vendor has no partitions at all, here it has partitions this engine
469
+ * does not yet reach, and only the second is a gap on our side.
470
+ */
471
+ PARTITION_KIND_UNSUPPORTED = 'SYSTEM_OF_RECORD_PARTITION_KIND_UNSUPPORTED',
472
+
473
+ // ─── Writes (#1679) ─────────────────────────────────────────────────────────────────────────────
474
+ //
475
+ // Every REQUEST code below is raised BEFORE anything is sent, except the two that name what the
476
+ // remote did (OUTCOME_UNKNOWN, APPLIED_FOLLOW_UP_FAILED) and the admission codes, which name what a
477
+ // retried request would do. A refusal before the send is safe to retry once the cause is fixed;
478
+ // the other two are the cases a client must NOT blindly retry, which is why they are codes at all.
479
+
480
+ /**
481
+ * BOOT — a binding opens a write verb whose DIALECT has no write implementation in this engine yet.
482
+ *
483
+ * Refused at boot rather than at the first write, for the reason every declaration refusal here is:
484
+ * the remedy is editing a file (remove the verb, or wait for the dialect), so nothing needs a
485
+ * running application to fix it. The message names the dialect, because that is the half an author
486
+ * cannot see from their own binding.
487
+ */
488
+ WRITE_DIALECT_NOT_IMPLEMENTED = 'SYSTEM_OF_RECORD_WRITE_DIALECT_NOT_IMPLEMENTED',
489
+
490
+ /**
491
+ * REQUEST — the write was scoped to an organization that does not own the application.
492
+ *
493
+ * A system of record's rows belong to the OWNER organization (#1055 Q2). A read under another
494
+ * organization answers an empty page, because an empty page is a true statement about what that
495
+ * tenant may see; a write has no such honest empty answer, so it is refused, before anything is
496
+ * sent, and the refusal is audited.
497
+ */
498
+ WRITE_ORGANIZATION_NOT_OWNER = 'SYSTEM_OF_RECORD_WRITE_ORGANIZATION_NOT_OWNER',
499
+
500
+ /**
501
+ * REQUEST — a CREATE on a partitioned instance could not tell which organization unit the new row
502
+ * belongs to, and the caller must name one (`organizationUnitId` in the payload).
503
+ *
504
+ * Reached by a member confined to SEVERAL units that own a partition of this instance, and by an
505
+ * organization-wide caller, who is entitled to every assigned partition and so has no single answer.
506
+ * Distinct from {@link WRITE_PARTITION_REFUSED} because the remedy is to ADD something, not to change it.
507
+ */
508
+ WRITE_PARTITION_UNIT_REQUIRED = 'SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED',
509
+
510
+ /**
511
+ * REQUEST — the partition this write would land in is not one the caller may write. The context
512
+ * carries a {@link SystemOfRecordWritePartitionRefusal} naming which rule refused.
513
+ */
514
+ WRITE_PARTITION_REFUSED = 'SYSTEM_OF_RECORD_WRITE_PARTITION_REFUSED',
515
+
516
+ /**
517
+ * REQUEST — the payload writes a field the engine owns: the partition field (it is DERIVED from the
518
+ * organization unit on create and never moves afterwards), the owner organization stamp, the unit
519
+ * stamp on update, or a key component.
520
+ *
521
+ * Refused rather than stripped. A caller who sends a partition value believes it decides where the
522
+ * row lands; silently discarding it would put the row somewhere they did not ask for.
523
+ */
524
+ WRITE_FIELD_NOT_WRITABLE = 'SYSTEM_OF_RECORD_WRITE_FIELD_NOT_WRITABLE',
525
+
526
+ /**
527
+ * REQUEST — the write was SENT and nobody knows whether the system of record applied it: the call
528
+ * timed out, the connection dropped after the request left, or a gateway answered for the vendor.
529
+ *
530
+ * The one answer a client must not treat as "not written". A retry with the SAME `Idempotency-Key`
531
+ * answers this again without sending anything; the way forward is to READ the row (or search for it)
532
+ * and decide, then send a NEW request under a new key if it is genuinely missing.
533
+ */
534
+ WRITE_OUTCOME_UNKNOWN = 'SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN',
535
+
536
+ /**
537
+ * REQUEST — a request with this `Idempotency-Key` is being sent right now. The client retried before
538
+ * the first attempt settled; answering it would mean sending the write twice.
539
+ *
540
+ * Answered `409` (a CONFLICT carrying this code): wait, then retry the SAME request under the same key.
541
+ */
542
+ WRITE_IN_PROGRESS = 'SYSTEM_OF_RECORD_WRITE_IN_PROGRESS',
543
+
544
+ /**
545
+ * REQUEST — this `Idempotency-Key` was already used for a DIFFERENT write (another target, verb or
546
+ * payload). A key names one request; replaying the first request's outcome for a second one would
547
+ * tell the caller something false about the second.
548
+ *
549
+ * Answered `422` with `customMessageReference: IDEMPOTENCY_KEY_REUSED` (#1941) — the status and the
550
+ * reference the engine's generic request idempotency answers a reused key with, so a client learns ONE
551
+ * spelling. A 422's context is stripped on the wire, so THIS code does not reach an HTTP client: it is
552
+ * what an in-process caller catching the error reads (`context.code`), and what the trail and the
553
+ * refusal audit row record. Never retry the request as it is; send a new request under a new key.
554
+ * spec-cite: draft-ietf-httpapi-idempotency-key-header-07 §2.7 (reused key with a different payload → 422;
555
+ * a request still being processed → 409).
556
+ */
557
+ WRITE_IDEMPOTENCY_KEY_REUSED = 'SYSTEM_OF_RECORD_WRITE_IDEMPOTENCY_KEY_REUSED',
558
+
559
+ /**
560
+ * REQUEST — the system of record APPLIED the write, and something the engine did after it failed
561
+ * (a postfix hook, a local lifecycle step, the response description).
562
+ *
563
+ * Never reported as a failure to write: the remote change is durable and nothing here can undo it.
564
+ * The context names the written row, so the caller can read it; a retry with the same key replays
565
+ * the applied outcome rather than writing again.
566
+ */
567
+ WRITE_APPLIED_FOLLOW_UP_FAILED = 'SYSTEM_OF_RECORD_WRITE_APPLIED_FOLLOW_UP_FAILED',
568
+
569
+ // ─── Version-checked updates (#1724, #1726) ─────────────────────────────────────────────────────
570
+ //
571
+ // A binding may declare `writeConcurrency: VERSION_CHECKED`: the caller sends the row version it read, and the engine
572
+ // compares it with the row it reads just before sending. On a system with no CONDITIONAL write (Odoo) that NARROWS the
573
+ // lost-update race and does not close it — the comparison and the write are two calls, and a change landing between
574
+ // them is overwritten. On OData the same version then travels as `If-Match`, and the vendor closes the gap itself
575
+ // (`WRITE_PRECONDITION_FAILED` below). The request codes in this block are raised BEFORE anything is sent.
576
+
577
+ /**
578
+ * BOOT — a binding declares `writeConcurrency: VERSION_CHECKED` and its vendor facet names no row version field
579
+ * (`rowVersionField`), or the binding's version field does not map onto that remote field. The check would compare a
580
+ * value the vendor does not maintain, and so would refuse or admit writes for no reason at all.
581
+ */
582
+ WRITE_ROW_VERSION_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SUPPORTED_BY_VENDOR',
583
+
584
+ /**
585
+ * REQUEST — an UPDATE on a `VERSION_CHECKED` binding carried no row version. The binding declared that every change is
586
+ * checked against the version its author read; an update without one would silently be last-writer-wins. Send the
587
+ * version field exactly as the read answered it.
588
+ */
589
+ WRITE_VERSION_REQUIRED = 'SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED',
590
+
591
+ /**
592
+ * REQUEST — the row changed since the caller read it: the version it sent is not the version the system of record
593
+ * answered just before the write. Nothing was sent. Read the row again and decide.
594
+ *
595
+ * BEST-EFFORT on Odoo, and the refusal's message says so: a change landing between that read and the write is not
596
+ * seen, and a vendor that serves its version coarsely (Odoo serves `write_date` to the SECOND) cannot tell two changes
597
+ * made in the same second apart. The absence of this code is therefore not proof that nobody else changed the row. On
598
+ * OData the change landing in that gap is refused by the vendor instead, as `WRITE_PRECONDITION_FAILED`.
599
+ */
600
+ WRITE_VERSION_STALE = 'SYSTEM_OF_RECORD_WRITE_VERSION_STALE',
601
+
602
+ /**
603
+ * REQUEST — an UPDATE on a `VERSION_CHECKED` binding, and the row the engine read just before writing carries NO
604
+ * version at all (#1726). Not "stale": nobody changed anything. The vendor serves no version for this row — an OData
605
+ * service that returns no `@odata.etag` for this entity set, although OData lets each set decide — so the binding's
606
+ * stance cannot be honoured for it. Nothing was sent. The remedy is the
607
+ * binding's, not the caller's: declare `LAST_WRITER_WINS` for this entity set, or have the vendor serve its versions.
608
+ */
609
+ WRITE_ROW_VERSION_NOT_SERVED = 'SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SERVED',
610
+
611
+ // ─── Conditional writes (#1726) ─────────────────────────────────────────────────────────────────
612
+ //
613
+ // A vendor that offers a real precondition (OData `If-Match` against the row's entity tag) refuses a stale write
614
+ // ITSELF, atomically — so the refusal arrives from the remote, after the write was sent, and still means that
615
+ // nothing was applied.
616
+
617
+ /**
618
+ * REQUEST — the system of record refused an UPDATE or DELETE because the row's version no longer matched the one the
619
+ * write was conditioned on: an OData `412 Precondition Failed` answering the `If-Match` the engine sent (#1726).
620
+ *
621
+ * Unlike {@link WRITE_VERSION_STALE} this is the VENDOR's decision, taken atomically against the row it was about to
622
+ * change, and the protocol requires that it change nothing — so it is a definite refusal, never an unknown outcome,
623
+ * and it is never retried: re-sending the same precondition would only be refused again. Read the row again and
624
+ * decide.
625
+ * spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match).
626
+ */
627
+ WRITE_PRECONDITION_FAILED = 'SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED',
628
+
629
+ /**
630
+ * BOOT — a binding opens writes toward a vendor whose facet lists a step it requires before any modifying request
631
+ * (`writePrerequisites`, e.g. SAP Gateway's `X-CSRF-Token` handshake) that this engine does not perform (#1726). Every
632
+ * such write would be refused by the vendor; the binding stays read-only until the engine performs the step.
633
+ */
634
+ WRITE_PREREQUISITE_NOT_SUPPORTED = 'SYSTEM_OF_RECORD_WRITE_PREREQUISITE_NOT_SUPPORTED',
635
+
636
+ // ── Declared ACTIONS (#1678) ───────────────────────────────────────────────────────────────────
637
+ //
638
+ // An action re-uses the write path's key-ledger answers as they are — WRITE_OUTCOME_UNKNOWN, WRITE_IN_PROGRESS and
639
+ // WRITE_IDEMPOTENCY_KEY_REUSED mean exactly the same thing for an action as for a row write, and a client that already
640
+ // branches on them must not learn a second spelling. Both doors answer them from one table, statuses included (#1941). What follows is what only an action can be refused for.
641
+
642
+ /**
643
+ * BOOT — a binding declares an action whose call shape the instance's vendor facet does not list
644
+ * (`actionCallShapes`). The vendor's product does not expose actions that way, so the declaration could never run.
645
+ */
646
+ ACTION_CALL_SHAPE_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_NOT_SUPPORTED_BY_VENDOR',
647
+
648
+ /**
649
+ * BOOT — a record-free action toward a PARTITIONED instance declares no partition stance. It must say either why it
650
+ * reaches no partitioned data, or which parameter carries the partition the engine derives from the caller's unit;
651
+ * otherwise one member's action could land in every company.
652
+ */
653
+ ACTION_PARTITION_STANCE_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_STANCE_REQUIRED',
654
+
655
+ /** BOOT — two bindings of one instance declare the same action name; callers address an action by `(system, action)`. */
656
+ ACTION_NAME_DUPLICATED = 'SYSTEM_OF_RECORD_ACTION_NAME_DUPLICATED',
657
+
658
+ /** REQUEST — no binding of this instance declares an action of that name. */
659
+ ACTION_NOT_DECLARED = 'SYSTEM_OF_RECORD_ACTION_NOT_DECLARED',
660
+
661
+ /**
662
+ * REQUEST — this kind of context may not run this action: an anonymous or public execution, an application-scoped
663
+ * machine with no organization, or a system context (batch, cron, webhook, an autonomous agent with nobody behind it)
664
+ * on an action that does not declare `admitsSystemInitiation`.
665
+ */
666
+ ACTION_INITIATION_NOT_ADMITTED = 'SYSTEM_OF_RECORD_ACTION_INITIATION_NOT_ADMITTED',
667
+
668
+ /**
669
+ * REQUEST — the action was initiated for an organization that does not own the application. A system of record's rows
670
+ * and actions belong to the owner organization; a tenant that is not the owner never reaches the ERP.
671
+ */
672
+ ACTION_ORGANIZATION_NOT_OWNER = 'SYSTEM_OF_RECORD_ACTION_ORGANIZATION_NOT_OWNER',
673
+
674
+ /** REQUEST — the caller holds none of the roles the action declares, in the owner organization. */
675
+ ACTION_ROLE_NOT_HELD = 'SYSTEM_OF_RECORD_ACTION_ROLE_NOT_HELD',
676
+
677
+ /** REQUEST — the input does not satisfy the action's declared input schema; the context carries the issues. */
678
+ ACTION_INPUT_INVALID = 'SYSTEM_OF_RECORD_ACTION_INPUT_INVALID',
679
+
680
+ /**
681
+ * REQUEST — a WRITING action was called without an Idempotency-Key. A remote change cannot be rolled back, so every
682
+ * caller names its request; a retry under the same key then replays the first outcome instead of acting twice.
683
+ */
684
+ ACTION_IDEMPOTENCY_KEY_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_IDEMPOTENCY_KEY_REQUIRED',
685
+
686
+ /**
687
+ * REQUEST — a record-free action that carries the partition must know the caller's unit, and the caller is a member
688
+ * of several units owning partitions of this instance. Name one in `organizationUnitId`.
689
+ */
690
+ ACTION_PARTITION_UNIT_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_UNIT_REQUIRED',
691
+
692
+ /**
693
+ * REQUEST — the partition the action would land in is not one the caller may act in. The context carries a
694
+ * {@link SystemOfRecordWritePartitionRefusal} naming which rule refused — the same rules a read-through create obeys.
695
+ */
696
+ ACTION_PARTITION_REFUSED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_REFUSED',
697
+
698
+ /**
699
+ * REQUEST — the record a record-targeted action names is not one this caller may act on: absent, or outside its
700
+ * partition, or (for a shared record) not writable by a unit-confined caller. Answered as NOT_FOUND and
701
+ * indistinguishably, as a read answers, so an action cannot probe for records the caller may not see.
702
+ */
703
+ ACTION_TARGET_NOT_REACHABLE = 'SYSTEM_OF_RECORD_ACTION_TARGET_NOT_REACHABLE',
704
+
705
+ /** REQUEST — the system of record refused the action with a definite answer; nothing was applied. */
706
+ ACTION_REMOTE_REFUSED = 'SYSTEM_OF_RECORD_ACTION_REMOTE_REFUSED',
707
+
708
+ /**
709
+ * REQUEST — the action could not be SENT: the instance's access could not be resolved, its handshake failed, the
710
+ * connection was refused before the request left, the rate budget was spent, or the read-first could not reach the
711
+ * record. Nothing reached the vendor as an action, so nothing was applied and the Idempotency-Key may be spent again.
712
+ * The context carries the transport KIND (and status), never the transport's message, which names the URL.
713
+ */
714
+ ACTION_NOT_SENT = 'SYSTEM_OF_RECORD_ACTION_NOT_SENT',
715
+ }
716
+
717
+ /**
718
+ * Which rule refused a write's PARTITION (#1679), carried as `context.reason` beside
719
+ * {@link SystemOfRecordErrorCode.WRITE_PARTITION_REFUSED}.
720
+ *
721
+ * Distinct members because the remedy differs for each, and every one is somebody else's work: an
722
+ * operator assigns partitions, an administrator grants units, an author declares the instance.
723
+ */
724
+ export enum SystemOfRecordWritePartitionRefusal {
725
+ /** The unit named (or derived) is not one the caller's grant covers. */
726
+ UNIT_OUTSIDE_GRANT = 'unit_outside_grant',
727
+ /** The unit owns no partition of this instance, so a row created "for it" would belong to nobody. */
728
+ UNIT_HAS_NO_PARTITION = 'unit_has_no_partition',
729
+ /**
730
+ * The unit owns SEVERAL partitions of this instance, so the unit alone does not say which one the row
731
+ * belongs to. The operator's assignment map decides this, not the caller: one unit, one partition is
732
+ * what makes a create's destination derivable.
733
+ */
734
+ UNIT_HAS_SEVERAL_PARTITIONS = 'unit_has_several_partitions',
735
+ /** A unit was named for a write to an instance that is not partitioned — a stamp nothing would enforce. */
736
+ INSTANCE_NOT_PARTITIONED = 'instance_not_partitioned',
737
+ /** The narrowing authority denied the caller every unit (no decision, a registry disagreement, an empty grant). */
738
+ NARROWING_DENIED = 'narrowing_denied',
739
+ /**
740
+ * A UNIT-ONLY principal (a unit-scoped service-provider expert, #1597) writing a resource that does not
741
+ * narrow. The organization-wide admission such a principal may hold covers reads only.
742
+ */
743
+ UNIT_ONLY_PRINCIPAL_NOT_ADMITTED = 'unit_only_principal_not_admitted',
744
+ }
745
+ ```