@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
@@ -40,35 +40,12 @@
40
40
  // Erasure stance (GDPR Art. 17 on rows we do not own)
41
41
  // --------------------------------
42
42
 
43
- /**
44
- * The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
45
- * from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
46
- * registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
47
- * "we cannot delete rows we do not own" is not an answer the framework may imply silently.
43
+ /*
44
+ * `HttpApiErasureStance` lives in `./http-api-erasure-stance.shared` and is published from the package ROOT
45
+ * (#1710): three root-exported contracts name it, and a nominal enum reachable only through this subpath
46
+ * made their inferred types unnameable for a root-only consumer (TS2742). The binding arms below still
47
+ * discriminate on it.
48
48
  */
49
- export enum HttpApiErasureStance {
50
- /**
51
- * (6a) The resource declares it holds NO personal/subject data. Registration verifies the
52
- * declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
53
- * the remote rows.
54
- */
55
- NO_SUBJECT_DATA = 'no-subject-data',
56
-
57
- /**
58
- * (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
59
- * engine invokes on a subject-erasure request. This is a single declared write and does NOT
60
- * require general write support (slice 1 stays read-only otherwise).
61
- */
62
- EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
63
-
64
- /**
65
- * (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
66
- * lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
67
- * administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
68
- * is the control. NEVER a standing default — the acknowledgement is per erasure request.
69
- */
70
- CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
71
- }
72
49
 
73
50
  /*
74
51
  * ─── `HttpApiTenancyStance` was REMOVED here (#1055), and NOT replaced by a narrower vocabulary ──
@@ -122,6 +99,575 @@ export enum HttpApiKeyComponentCodec {
122
99
  */
123
100
  DATETIME_ISO = 'datetime-iso',
124
101
  }
102
+
103
+ // --------------------------------
104
+ // Write verbs a binding OPENS (#1679)
105
+ // --------------------------------
106
+
107
+ /**
108
+ * A row-level write a read-through resource may send to its system of record.
109
+ *
110
+ * Three members and no bulk ones, deliberately. A bulk write against a system the platform does not
111
+ * own has no atomicity to offer — ten rows are ten remote calls, any of which can fail after the ones
112
+ * before it landed — so the engine opens single-row create, update and delete by key, and nothing
113
+ * else. `createMany`, `updateMany`, `deleteMany`, the guarded atomic primitives and the raw-filter
114
+ * doors stay refused by name on the repository.
115
+ *
116
+ * ## Why the binding declares them at all, when the resource already lists its operations
117
+ *
118
+ * Because opening a write door into somebody else's ERP is a decision of its own, taken where the
119
+ * remote contract is written. The resource's operation list says which HTTP routes exist; this says
120
+ * the binding may WRITE through them. The resource factory refuses the two disagreeing in EITHER
121
+ * direction — a write operation whose verb the binding does not open, and an opened verb no operation
122
+ * uses — so the second declaration can never drift from the first into an inert door or an open one.
123
+ *
124
+ * Absent is empty: every binding written before #1679 stays read-only without a change.
125
+ */
126
+ export enum HttpApiWriteVerb {
127
+ /** A new remote row. The engine derives its partition from the caller's organization unit. */
128
+ CREATE = 'create',
129
+ /** A change to one remote row, addressed by its synthesized id. Read first, then written. */
130
+ UPDATE = 'update',
131
+ /** The removal of one remote row, addressed by its synthesized id. Read first, then deleted. */
132
+ DELETE = 'delete',
133
+ }
134
+
135
+ /**
136
+ * What protects an UPDATE against overwriting a change made since its author read the row (#1724, #1726, #1728) —
137
+ * declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODATA, REST_JSON).
138
+ *
139
+ * ## Why a binding must say this at all
140
+ *
141
+ * An update that carries no version is last-writer-wins, whatever the vendor could have offered: Odoo's external API
142
+ * applies `write(ids, vals)` unconditionally, a REST_JSON write is sent with no precondition, and an OData service
143
+ * applies a `PATCH` whose `If-Match` matches — which a caller who never read the row cannot make match anything but
144
+ * `*`. A default nobody chose is a lost update nobody expects, so a binding that opens UPDATE states which of the two it
145
+ * accepts, and the factory refuses the omission.
146
+ *
147
+ * ## What VERSION_CHECKED is, honestly — it depends on the dialect
148
+ *
149
+ * The caller sends the row version it read (the local field named by `versionField`, mapped onto the vendor's
150
+ * `rowVersionField` — Odoo `write_date`, an OData service's `@odata.etag`). The engine reads the row just before
151
+ * writing it — the read it already makes to check the partition — and refuses the update when the versions differ,
152
+ * before anything is sent. Then:
153
+ *
154
+ * - **Odoo: best-effort.** Odoo takes no precondition, so the comparison and the write are two calls. That NARROWS the
155
+ * race to the gap between them; it does NOT close it. A change landing inside that gap is overwritten, and a vendor
156
+ * that serves its version coarsely (Odoo: to the second) cannot tell two changes in the same second apart.
157
+ * - **REST_JSON: best-effort, as on Odoo** — the write is sent as declared, with no precondition. It is available only
158
+ * where the vendor facet declares a `rowVersionField`; neither the Salesforce nor the NetSuite facet does, so a
159
+ * binding against them states LAST_WRITER_WINS (startup refuses VERSION_CHECKED there).
160
+ * - **OData: atomic.** The version is also sent as `If-Match`, so the SERVICE compares it with the row it is about to
161
+ * change and answers `412 Precondition Failed` without applying anything when it moved — the gap is closed by the
162
+ * vendor, not narrowed by the engine.
163
+ * spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match).
164
+ */
165
+ export enum HttpApiWriteConcurrencyMode {
166
+ /**
167
+ * Every UPDATE carries the version its author read, and a stale one is refused before sending. Best-effort on Odoo
168
+ * and REST_JSON; atomic on OData, where the version also travels as `If-Match`.
169
+ */
170
+ VERSION_CHECKED = 'version-checked',
171
+ /**
172
+ * No check against the version the CALLER read: the last update sent wins. Stated, so it is a decision rather than an
173
+ * accident. On OData the engine still sends the entity tag of the row it read first (or `*` when the row carries
174
+ * none), so a row that moved between that read and the write is refused, and a row deleted in between is never
175
+ * re-created by an upsert.
176
+ */
177
+ LAST_WRITER_WINS = 'last-writer-wins',
178
+ }
179
+ ```
180
+
181
+ ### Origin Package: `@wildo-ai/saas-models`
182
+
183
+ ```typescript
184
+ /**
185
+ * What kind of TEMPORAL value a remote field holds, when a query statement compares it (#1972).
186
+ *
187
+ * A statement language spells a date and a date-time differently, and neither accepts a quoted string:
188
+ *
189
+ * | language | `DATE` | `DATE_TIME` |
190
+ * |---|---|---|
191
+ * | SOQL | `2026-01-05` (unquoted) | `2026-01-05T10:00:00Z` (unquoted, whole seconds) |
192
+ * | SuiteQL | `TO_DATE('2026-01-05', 'YYYY-MM-DD')` ¹ | `TO_DATE('2026-01-05 10:00:00', 'YYYY-MM-DD HH24:MI:SS')` |
193
+ *
194
+ * ¹ spec-cite: N/A — the date-only mask is Oracle SQL's `TO_DATE` convention (SuiteQL is SQL-92 / Oracle SQL);
195
+ * NetSuite's page shows only the date-time mask cited below.
196
+ *
197
+ * Which one a field needs is a fact about the REMOTE column that nothing in a local `Date` carries, so a
198
+ * statement read that filters a date field DECLARES it; a date compared with an undeclared field is refused
199
+ * rather than guessed, because the wrong form is refused by the vendor or silently compares as text.
200
+ * spec-cite: Salesforce, "SOQL and SOSL Reference" v68.0, WHERE › "Date Formats and Date Literals in WHERE" —
201
+ * `WHERE CreatedDate > 2005-10-08T01:02:03Z`; `date YYYY-MM-DD`; `dateTime YYYY-MM-DDThh:mm:ss+hh:mm,
202
+ * YYYY-MM-DDThh:mm:ss-hh:mm, or YYYY-MM-DDThh:mm:ssZ`.
203
+ * spec-cite: Oracle NetSuite, "SuiteQL Performance and Best Practices" (article_0824094533) — "You can't use date
204
+ * literals. You must encapsulate dates using the `to_date()` function."; "Do not use plain string values for date
205
+ * comparisons."; `where lastmodifieddate >= TO_DATE('2024-01-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss')`.
206
+ *
207
+ * Read by the REST_JSON STATEMENT compilers only; declared on another dialect, or on a REST_JSON binding none of
208
+ * whose read members is a statement, it would change nothing, so the binding coherence refuses it there.
209
+ */
210
+ export enum HttpApiRemoteTemporalKind {
211
+ /** A calendar date with no time — SOQL `date`, a NetSuite date column. */
212
+ DATE = 'date',
213
+ /** An instant — SOQL `dateTime`, a NetSuite datetime column. */
214
+ DATE_TIME = 'date-time',
215
+ }
216
+
217
+ /**
218
+ * Local-to-remote field name mapping for fields whose names differ. Fields not listed map by
219
+ * identity (same name both sides). Key components are declared in `keyFields`, not here.
220
+ *
221
+ * A REST_JSON statement read that FILTERS a temporal field lists it here — with the same name on both sides
222
+ * when they agree — to declare its `temporalKind`.
223
+ */
224
+ export const HttpApiFieldMappingSchema = z.object({
225
+ localField: z.string().min(1),
226
+ remoteField: z.string().min(1),
227
+ /** The remote column's temporal kind, when a statement compares it with a date — see {@link HttpApiRemoteTemporalKind}. */
228
+ temporalKind: z.enum(HttpApiRemoteTemporalKind).optional(),
229
+ });
230
+ ```
231
+
232
+ ### Origin Package: `@wildo-ai/saas-models`
233
+
234
+ ```typescript
235
+ /**
236
+ * Where a declared REST parameter is placed on the request, when the method's own answer is wrong for it (#1686).
237
+ */
238
+ export enum HttpApiRestParameterPlacement {
239
+ /**
240
+ * The URL query string, whatever the method — NetSuite's SuiteQL `limit` and `offset` on a POST.
241
+ * spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
242
+ * statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
243
+ */
244
+ QUERY_STRING = 'query-string',
245
+ }
246
+
247
+ /**
248
+ * REST_JSON per-operation declaration: how one read-family member maps onto a concrete HTTP
249
+ * operation. Deliberately minimal in slice 1 — pagination/filter parameter NAMES are declared,
250
+ * their VALUES are supplied by the adapter from the translated query.
251
+ *
252
+ * Related but distinct: `ProviderRestOperation` on a provider's `rest` runtime contract describes a
253
+ * VENDOR operation — one entry in the catalogue a reference below names. This schema describes a
254
+ * RESOURCE read surface, which is a different thing and stays here.
255
+ *
256
+ * (An earlier revision pointed at `REST_API_OperationSpecSchema` in
257
+ * `@wildo-ai/external-connectors-models` "for capability transformers". Both are gone: the
258
+ * transformer layer was retired with `features/` in #327, and that OpenAPI-shaped operations layer
259
+ * — ten exported symbols with zero code readers — was deleted in #331 rather than wired up, so
260
+ * "what a provider can do" has one description instead of two.)
261
+ *
262
+ * The convergence performed in S3a (#331) — a member naming an operation in a PROVIDER's own
263
+ * catalogue — was UNDONE in #1055. A system of record is not a connector (D10), and a read that
264
+ * depends on a provider catalogue being loadable is the crossing that decision forbids. An inline
265
+ * spec is now the only form, which is what every authored binding used anyway.
266
+ */
267
+ /**
268
+ * A query LANGUAGE a REST system of record reads through, rather than a set of filter parameters
269
+ * (#1293).
270
+ *
271
+ * Two vendors read this way and neither can be expressed as parameters: Salesforce takes SOQL and
272
+ * NetSuite takes SuiteQL, each as ONE statement naming the fields, the entity, the predicates and
273
+ * the order. A `filterParams` map cannot say "SELECT these columns FROM that object", so without this
274
+ * neither vendor can be declared at all.
275
+ *
276
+ * ## Why this is a closed vocabulary and not a template string
277
+ *
278
+ * A statement is BUILT, and building means escaping. Each language has its own literal rules and its
279
+ * own paging spelling, and a template with `{filter}` holes would put the escaping in the author's
280
+ * hands — an injection surface in a file nobody reviews as one. The engine builds the statement and
281
+ * the vocabulary names which grammar to build.
282
+ *
283
+ * This is the same trade the OData compiler already makes for `$filter`: expressions are composed
284
+ * here, literals are escaped by one function, and no authored string reaches the wire uninspected.
285
+ */
286
+ export enum HttpApiQueryStatementLanguage {
287
+ /**
288
+ * Salesforce Object Query Language.
289
+ *
290
+ * spec-cite: Salesforce Developers, "SOQL and SOSL Reference" —
291
+ * https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/
292
+ *
293
+ * `SELECT *` does not exist: every field is named, which the binding's `fieldMappings` and key
294
+ * fields already supply. Paging is by the response's own continuation rather than by `OFFSET`,
295
+ * which SOQL bounds at 2000 rows.
296
+ */
297
+ SOQL = 'soql',
298
+ /**
299
+ * NetSuite SuiteQL — an SQL-92 dialect over its analytics schema.
300
+ *
301
+ * spec-cite: Oracle NetSuite, "SuiteQL" —
302
+ * https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156257770590.html
303
+ *
304
+ * Paged by `limit` / `offset` QUERY parameters rather than inside the statement, which is why the
305
+ * statement declaration and `pagingParams` are independent.
306
+ */
307
+ SUITEQL = 'suiteql',
308
+ }
309
+
310
+ /**
311
+ * Where a KEYSET page's size bound goes, per statement language (#1686).
312
+ *
313
+ * A keyset page is "the next N rows after the last key", so the statement's predicate and order are
314
+ * the same in every language — `<key> > <last key> … ORDER BY <key> ASC` — and only the size bound
315
+ * differs. Decided by the LANGUAGE, never declared by an author: it is a fact about the grammar.
316
+ */
317
+ export enum HttpApiKeysetPageBound {
318
+ /**
319
+ * The statement carries `LIMIT <n>` itself — SOQL, which has no size parameter on `/query`.
320
+ *
321
+ * The vendor may still split the limited result into several BATCHES and answer the first one with
322
+ * a continuation (`nextRecordsUrl`), so a keyset page on this bound follows the operation's declared
323
+ * `cursorPath` inside the page until the result is exhausted — which is why the bound requires one.
324
+ * Without it, a batch shorter than the limit would read as the end of the pass and every row after
325
+ * it would go unread, and a DELETE orphan policy would then delete them.
326
+ * spec-cite: Salesforce REST API Developer Guide v68.0, "Query" — "up to 2,000 records can be returned
327
+ * at a time … the returned batch can include fewer records than the limit or what's set in the
328
+ * request … If the total number of results exceeds the limit or the requested number of results, the
329
+ * response contains the first batch of records, a false value for done, and a query locator."
330
+ */
331
+ STATEMENT_LIMIT_CLAUSE = 'statement-limit-clause',
332
+ /**
333
+ * The operation's declared `pagingParams.limitParam` carries the size, and its `offsetParam` is sent
334
+ * as 0 on every page — SuiteQL, which pages by `limit`/`offset` query parameters.
335
+ *
336
+ * Offset 0 always: each page is a NEW query that starts after the last key, so no offset is ever
337
+ * needed, and none of the offset rules (an offset divisible by the limit, the result ceiling) is
338
+ * ever reached.
339
+ * spec-cite: Oracle NetSuite, "Collection Paging" (section_156414087576) — "You can only set offset
340
+ * and limit values in a way that the offset is divisible by the limit"; "Executing SuiteQL Queries
341
+ * Through REST Web Services" (section_157909186990) — "Using SuiteQL queries, you can return a
342
+ * maximum of 100,000 results."
343
+ */
344
+ LIMIT_PARAMETER = 'limit-parameter',
345
+ }
346
+
347
+ /** The page bound of each statement language. A `Record` over the enum, so a new language is a compile error until it has one. */
348
+ export const HTTP_API_KEYSET_PAGE_BOUND: Readonly<Record<HttpApiQueryStatementLanguage, HttpApiKeysetPageBound>> = {
349
+ [HttpApiQueryStatementLanguage.SOQL]: HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE,
350
+ [HttpApiQueryStatementLanguage.SUITEQL]: HttpApiKeysetPageBound.LIMIT_PARAMETER,
351
+ };
352
+
353
+ /**
354
+ * The key codecs a keyset may walk (#1686): an INTEGER compares as a number and a STRING by code
355
+ * unit, and the engine CHECKS every served page against that order before trusting its last key.
356
+ *
357
+ * GUID and DATETIME_ISO are refused. A GUID has no order the vendors agree on — SQL Server sorts a
358
+ * `uniqueidentifier` by its last bytes first — so a page could never be checked; a datetime is not
359
+ * unique, and a keyset on a non-unique column skips the rows that share the boundary value.
360
+ */
361
+ export const HTTP_API_KEYSET_ELIGIBLE_CODECS: readonly HttpApiKeyComponentCodec[] = [
362
+ HttpApiKeyComponentCodec.INTEGER,
363
+ HttpApiKeyComponentCodec.STRING,
364
+ ];
365
+
366
+ /**
367
+ * A declared KEYSET on a statement read (#1686) — what lets a REST system of record feed a pipeline.
368
+ *
369
+ * ## What it makes the engine build
370
+ *
371
+ * For the pipeline's extraction, the `list` member's statement becomes
372
+ *
373
+ * ```
374
+ * SELECT <mapped fields> FROM <entity> WHERE <sourceFilter> AND <key> > <last key> ORDER BY <key> ASC
375
+ * ```
376
+ *
377
+ * with the page size bounded per {@link HttpApiKeysetPageBound} (SOQL `LIMIT <n>`; SuiteQL
378
+ * `limit=<n>&offset=0`). The last key of each page is the pipeline's persisted cursor, and a page
379
+ * shorter than asked ends the pass — the Odoo id-keyset discipline, drift-safe for the same reason: a
380
+ * row inserted or deleted mid-pass never shifts the rows after the cursor, so none is skipped or read
381
+ * twice. Offset paging has neither property, which is why a REST source without a keyset stays
382
+ * refused.
383
+ *
384
+ * ## Why there is no cursor PLACEHOLDER to write
385
+ *
386
+ * The statement is BUILT by the engine (#1293), never templated by an author, so there is nowhere for a
387
+ * `:cursor` placeholder to go and no ORDER BY an author could forget: declaring the keyset is what puts
388
+ * both into the statement, and the engine writes them itself. What an author declares is only which
389
+ * column the walk runs on.
390
+ *
391
+ * ## Which column
392
+ *
393
+ * The binding's ONE key field — unique and immutable, which is what a keyset needs. Named by its
394
+ * remote field; its codec is the key field's own, so the two cannot disagree. A composite key is
395
+ * refused: one component of it is not unique.
396
+ *
397
+ * ## A vendor continuation is followed INSIDE a page, never persisted
398
+ *
399
+ * Salesforce's `nextRecordsUrl` names a server-side query locator. How long a locator lives is not
400
+ * stated in the REST API guide (UNVERIFIED), so it is never the cross-run cursor: the key is.
401
+ */
402
+ export const HttpApiQueryStatementKeysetSchema = z.strictObject({
403
+ /** The remote field of the binding's single key field — Salesforce `Id`, NetSuite `id`. */
404
+ keyRemoteField: z.string().min(1),
405
+ });
406
+ export type HttpApiQueryStatementKeyset = z.infer<typeof HttpApiQueryStatementKeysetSchema>;
407
+
408
+ /**
409
+ * How a read member builds and sends a query STATEMENT (#1293).
410
+ *
411
+ * Declared per operation rather than per binding, because a vendor's `read` and `list` genuinely
412
+ * differ: Salesforce addresses one record at `/sobjects/Account/{key}` and queries collections
413
+ * through `/query`, and only the second is a statement at all.
414
+ */
415
+ export const HttpApiQueryStatementSpecSchema = z.object({
416
+ language: z.enum(HttpApiQueryStatementLanguage),
417
+ /**
418
+ * The parameter or body member the statement is placed in (`q` for both vendors surveyed).
419
+ *
420
+ * WHERE it lands is not declared, because the operation's own `method` already decides: a GET puts
421
+ * parameters in the query string and a POST puts them in the JSON body, which is what the request
422
+ * builder has always done. A `placement` field was drafted here and removed before it shipped — it
423
+ * would have been a second declaration of something the method already says, free to disagree with
424
+ * it. Salesforce is a GET with `?q=`, NetSuite a POST with `{"q": …}`, and neither needs to be told
425
+ * twice. PAGING is the one parameter the method places wrongly for a vendor — NetSuite reads its
426
+ * `limit`/`offset` from the URL of that POST — which is why `pagingParams` carries its own
427
+ * `placement` (#1686) while the statement does not.
428
+ */
429
+ parameterName: z.string().min(1),
430
+ /**
431
+ * The object the statement selects FROM. Absent = the binding's `entityRef`, which is the ordinary
432
+ * case; present when the vendor's query schema names an object differently from its REST resource.
433
+ */
434
+ fromEntity: z.string().min(1).optional(),
435
+ /**
436
+ * The KEYSET a pipeline extraction walks (#1686) — see {@link HttpApiQueryStatementKeysetSchema}.
437
+ * Declared on the `list` member only. Absent = the binding can be read through, and cannot feed a
438
+ * pipeline.
439
+ */
440
+ keyset: HttpApiQueryStatementKeysetSchema.optional(),
441
+ });
442
+ export type HttpApiQueryStatementSpec = z.infer<typeof HttpApiQueryStatementSpecSchema>;
443
+
444
+ export const HttpApiRestOperationSpecSchema = z.object({
445
+ /** HTTP method for this read-family operation. */
446
+ method: z.enum(HttpApiRestOperationMethod),
447
+
448
+ /**
449
+ * Path template relative to the provider's base URL. `{key}` interpolates the synthesized
450
+ * key's remote addressing form; other `{param}` tokens must be declared parameter names.
451
+ */
452
+ pathTemplate: z.string().min(1),
453
+
454
+ /** Query/body parameter names for pagination, when the operation supports it. */
455
+ pagingParams: z
456
+ .object({
457
+ limitParam: z.string().min(1),
458
+ offsetParam: z.string().min(1),
459
+ /**
460
+ * Where the two paging parameters go (#1686). Absent = where the operation's method puts every
461
+ * parameter: the query string of a GET, the JSON body of a POST.
462
+ *
463
+ * NetSuite is why this exists: its SuiteQL read is a POST whose BODY is the statement and whose
464
+ * paging is in the URL, so a method-placed `limit` lands in the body, where the vendor does not
465
+ * read it, and the page is not bounded at all.
466
+ */
467
+ placement: z.enum(HttpApiRestParameterPlacement).optional(),
468
+ })
469
+ .optional(),
470
+
471
+ /**
472
+ * Declared filter parameter name per LOCAL field. Only fields listed here are translatable for
473
+ * this operation (scope-down paper, shape T3); everything else is refused at the adapter
474
+ * boundary.
475
+ */
476
+ filterParams: z.record(z.string().min(1), z.string().min(1)).optional(),
477
+
478
+ /**
479
+ * The parameter that receives the SEARCH text (T4), for a `search` operation. Absent =
480
+ * search is refused for this binding even when the operation exists.
481
+ */
482
+ searchParam: z.string().min(1).optional(),
483
+
484
+ /**
485
+ * Dot-path to the payload inside the response body — the rows array (list/search), the entity
486
+ * object (read), or the number (count). Absent = the body IS the payload. Declared, never
487
+ * sniffed: response shapes vary per target (`items`, `result`, `value`, raw array) and a wrong
488
+ * guess would silently read zero rows.
489
+ */
490
+ resultPath: z.string().min(1).optional(),
491
+
492
+ /** Wrap request/response in a JSON-RPC 2.0 envelope (the Odoo variant). */
493
+ jsonRpcEnvelope: z
494
+ .object({
495
+ rpcMethod: z.string().min(1),
496
+ })
497
+ .optional(),
498
+
499
+ /**
500
+ * Read through a query STATEMENT rather than through filter parameters (#1293).
501
+ *
502
+ * Mutually exclusive with `filterParams` and `searchParam` in practice rather than by schema: a
503
+ * statement expresses its own predicates, so a declaration carrying both has said the same thing
504
+ * twice in two grammars. The compiler refuses that pairing, where it can name which one it was
505
+ * about to ignore.
506
+ */
507
+ statement: HttpApiQueryStatementSpecSchema.optional(),
508
+
509
+ /**
510
+ * Dot-path to a CONTINUATION URL in the response — Salesforce's `nextRecordsUrl` (#1293).
511
+ *
512
+ * Declared rather than sniffed, for the same reason `resultPath` is: response shapes vary per
513
+ * target and a wrong guess reads zero rows silently. Absent means the operation pages by
514
+ * `pagingParams` or not at all.
515
+ *
516
+ * A continuation is followed only on the target's OWN origin, exactly as the OData one is — the
517
+ * link comes from a remote response body and carries this deployment's credentials wherever it
518
+ * points.
519
+ */
520
+ cursorPath: z.string().min(1).optional(),
521
+
522
+ /**
523
+ * Headers this vendor requires on the request — NetSuite's `Prefer: transient` (#1293).
524
+ *
525
+ * VENDOR headers only. A credential never goes here: credentials come from the instance's access,
526
+ * and a header authored in a binding would be a second credential channel in a file that is
527
+ * committed. The compiler refuses an `authorization` key by name rather than trusting the author.
528
+ */
529
+ staticHeaders: z.record(z.string().min(1), z.string().min(1)).optional(),
530
+ });
531
+
532
+ export type HttpApiRestOperationSpec = z.infer<typeof HttpApiRestOperationSpecSchema>;
533
+ ```
534
+
535
+ ### Origin Package: `@wildo-ai/saas-models`
536
+
537
+ ```typescript
538
+ /**
539
+ * The fields EVERY binding carries, whatever its dialect — spread into each arm of the union below.
540
+ */
541
+ const httpApiResourceBindingBaseShape = {
542
+ /**
543
+ * The SYSTEM OF RECORD this resource lives in, by the NAME the application declared it under in
544
+ * `wildo.saas.config.ts` (`systemsOfRecord.<name>`, #1055).
545
+ *
546
+ * ## Why a name, and not a provider ref
547
+ *
548
+ * `providerRef` named a PROVIDER, and a provider's env-var names live in its module — so one ref
549
+ * was one deployment, and a second Odoo was unrepresentable. A name here is an INSTANCE: two
550
+ * (`odoo-fr`, `odoo-de`) share one vendor facet and differ only in the environment variables their
551
+ * names derive. It is also not a provider in any other sense (D10): nothing here is selected
552
+ * through the capability plane, carries a person's lent credential, or has an operation catalogue.
553
+ *
554
+ * ## What validates it, and where
555
+ *
556
+ * Not here, and not in the resource factory — the factory runs in the application's `shared-lib`,
557
+ * where the saas configuration is not in scope. The factory checks SHAPE; the boot registry checks
558
+ * that this name is DECLARED and that `dialect` below equals the instance's, at the first moment
559
+ * both are visible. That split is the honest one rather than a compromise.
560
+ */
561
+ system: z.string().min(1),
562
+
563
+ /**
564
+ * The remote entity addressed by this binding — an OData entity-set name, or a logical name for
565
+ * a REST_JSON surface. One binding, one remote entity set.
566
+ */
567
+ entityRef: z.string().min(1),
568
+
569
+ /*
570
+ * `connection` was here, and it is GONE (#1055 D12).
571
+ *
572
+ * It declared WHOSE ACCOUNT a binding spends — `ORGANIZATION × USER` and its siblings — which is a
573
+ * real question for a CONNECTOR, where a customer connects their own account. A system of record is
574
+ * not that: it is a deployment the application reads its own business rows out of, with its own
575
+ * service identity, and the only honest answer was always `APPLICATION × SERVICE`. A field with one
576
+ * legal value is a question nobody should be asked.
577
+ *
578
+ * The customer-connection case is case 2 of #1049 and keeps the connector resolver, untouched.
579
+ */
580
+
581
+ /** Ordered key declaration — the source of the synthesized engine-facing `_id` (paper A). */
582
+ keyFields: z.array(HttpApiKeyFieldSchema).min(1),
583
+
584
+ /** Non-key field name mappings; unlisted fields map by identity. */
585
+ fieldMappings: z.array(HttpApiFieldMappingSchema).default([]),
586
+
587
+ /*
588
+ * `tenancy` was here, and it is GONE (#1055 §5).
589
+ *
590
+ * Both of its stances were wrong for a system of record. `SCOPE_FILTER_PUSHDOWN` sent WILDO's own
591
+ * organization id to the remote as a filter value — an id the remote has never heard of — and
592
+ * `SINGLE_TENANT_BINDING` became the only truth, which makes it a declaration with one legal answer.
593
+ *
594
+ * What replaced it is not a smaller field but a different mechanism: the row projector STAMPS the
595
+ * owner organization's id onto every remote row, so the per-row tenant gate passes with no exemption
596
+ * and a read under another organization's URL is refused by the gate that already existed.
597
+ * Partitioning a system of record BY organization unit returns in #1058, as a property of the
598
+ * INSTANCE and its vendor facet rather than of each binding.
599
+ */
600
+
601
+ /** Erasure stance (D6) — required; no silent default. */
602
+ erasure: HttpApiErasureDeclarationSchema,
603
+
604
+ /**
605
+ * The processing PURPOSES this data flow serves (#1745) — each a `purposeRef` of
606
+ * `operatorComplianceIdentity.lawfulBases` in `wildo.saas.config.ts`. Absent = none linked.
607
+ *
608
+ * A system of record is where an application OBTAINS personal data it did not collect from the person, and a
609
+ * privacy notice then owes the purpose and the legal basis for it (GDPR Art. 14(1)(c)) beside the source (Art.
610
+ * 14(2)(f)). The source and the categories are derived from this binding; the purpose is the one thing the
611
+ * framework cannot infer from what the data is, so it is LINKED here, per binding, rather than typed into a
612
+ * notice. The same link a provider's compliance choice carries (#1709), for the same reason.
613
+ *
614
+ * Checked where both halves are visible — the document facts and the evidence collector — and a ref naming no
615
+ * declared purpose is REPORTED there as a broken link, never refused: the factory runs in `shared-lib`, where the
616
+ * lawful bases are not in scope, and a compliance link must never stop the application from starting.
617
+ */
618
+ purposeRefs: z.array(z.string().trim().min(1)).optional(),
619
+
620
+ /**
621
+ * The row-level writes this binding OPENS toward its system of record (#1679). Absent = none: the
622
+ * binding is read-only, which is what every binding authored before #1679 declared implicitly.
623
+ *
624
+ * Opening a verb is not enough to write. The resource must also declare the matching operation
625
+ * (the factory refuses either without the other), the dialect must implement writes (the boot
626
+ * registration refuses a verb its dialect cannot send, naming the dialect), and every write
627
+ * variant carries a REQUIRED `Idempotency-Key`, because a remote write cannot be rolled back and
628
+ * a retried request must replay its first outcome rather than write twice.
629
+ */
630
+ writableVerbs: z.array(z.enum(HttpApiWriteVerb)).default([]),
631
+
632
+ /**
633
+ * How an opened UPDATE is protected against overwriting a change made since its author read the row (#1724). See
634
+ * {@link HttpApiWriteConcurrencyMode} for the two answers and the limit of the first.
635
+ *
636
+ * REQUIRED when the binding opens UPDATE — on ODOO_JSONRPC (#1724), ODATA (#1726) and REST_JSON (#1728) alike — and
637
+ * refused when the binding opens no UPDATE — a concurrency stance on a door that is shut decides nothing. `versionField` names the LOCAL field that
638
+ * carries the version: it must map onto the vendor facet's `rowVersionField` (checked at boot, where the facet is
639
+ * visible) — Odoo `write_date`, an OData service's `@odata.etag` — and the resource's schema must let an UPDATE carry
640
+ * it and keep a CREATE from sending it (checked by the resource factory).
641
+ */
642
+ writeConcurrency: z.discriminatedUnion('mode', [
643
+ z.strictObject({
644
+ mode: z.literal(HttpApiWriteConcurrencyMode.VERSION_CHECKED),
645
+ /** The LOCAL field carrying the row version the caller read — never written to the remote. */
646
+ versionField: z.string().min(1),
647
+ }),
648
+ z.strictObject({ mode: z.literal(HttpApiWriteConcurrencyMode.LAST_WRITER_WINS) }),
649
+ ]).optional(),
650
+
651
+ /**
652
+ * The vendor ACTIONS this binding declares toward its system of record (#1678) — named operations that are not row
653
+ * writes: posting an invoice, confirming an order, an OData bound or unbound action. Absent = none.
654
+ *
655
+ * Declared here rather than on the instance for the reasons `system-of-record-actions.shared.schemas.ts` records: an
656
+ * action carries a Zod input schema and the roles admitted to it, both of which live in `shared-lib` beside this
657
+ * binding. An action runs only through the system-of-record action executor, under the instance's service identity,
658
+ * confined to the owner organization and to the caller's partition, and audited on every outcome. It is reached over
659
+ * HTTP only through a custom operation of this resource whose implementation calls the executor.
660
+ */
661
+ actions: SystemOfRecordActionDeclarationsSchema.optional(),
662
+
663
+ /** Remote-call semantics (D10/R15). */
664
+ remoteCallSemantics: HttpApiRemoteCallSemanticsSchema.default({
665
+ timeoutMs: 10_000,
666
+ retry: { maxAttempts: 2, backoffMs: 500 },
667
+ maxIdSetSize: 50,
668
+ maxPartitionSetSize: 200,
669
+ }),
670
+ };
125
671
  ```
126
672
 
127
673
  ### Origin Package: `@wildo-ai/saas-models`
@@ -144,10 +690,21 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
144
690
  * something somebody can act on.
145
691
  */
146
692
  }),
693
+ z.object({
694
+ /*
695
+ * OData v2 (#1687) — generic like ODATA: the entity set IS `entityRef`, and read/list/count map mechanically. Its
696
+ * own arm rather than a flag on ODATA because the compiler, the envelope and the value encoding all differ.
697
+ */
698
+ dialect: z.literal(HttpApiTransportDialect.ODATA_V2),
699
+ ...httpApiResourceBindingBaseShape,
700
+ }),
147
701
  z.object({
148
702
  dialect: z.literal(HttpApiTransportDialect.REST_JSON),
149
703
  ...httpApiResourceBindingBaseShape,
150
- /** The declared read surface — absent members are refused, never emulated. */
704
+ /**
705
+ * The declared read surface, and the declared request of each row write the binding opens (#1728) — absent members
706
+ * are refused, never emulated.
707
+ */
151
708
  operations: HttpApiRestOperationsSchema,
152
709
  }),
153
710
  z.object({
@@ -161,6 +718,92 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
161
718
  }),
162
719
  ]);
163
720
 
721
+ /**
722
+ * A declared statement keyset must be one the engine can walk (#1686). Every refusal names the fix.
723
+ *
724
+ * Checked on the BINDING rather than only on a pipeline, so a keyset declared on a read-through
725
+ * resource is refused the same way: a declaration that says something false is refused wherever it
726
+ * is written, not only where it is used.
727
+ */
728
+ function assertRestJsonKeysetCoherence(keyFields: readonly HttpApiKeyField[], operations: HttpApiRestOperations): void {
729
+ for (const [member, declaration] of Object.entries(operations) as Array<[string, HttpApiRestOperationSpec | undefined]>) {
730
+ /*
731
+ * A statement on `read` is never sent (#1972 review): a key-addressed read is a path with `{key}` — Salesforce's
732
+ * `/sobjects/Account/{key}` — and `compileRestJsonKeyAddressedRead` reads no statement. Declared there it would
733
+ * look like it shapes the read and shape nothing, and it would admit a `temporalKind` that nothing reads.
734
+ */
735
+ if (member === 'read' && declaration?.statement !== undefined) {
736
+ throw new Error(
737
+ 'operations.read.statement: a key-addressed read is its `pathTemplate` with `{key}`, and sends no statement — declare the '
738
+ + 'statement on `list` (or `search` / `count`), where collection reads are built.',
739
+ );
740
+ }
741
+ /*
742
+ * SuiteQL is NetSuite's, and NetSuite reads a SuiteQL POST's paging from the URL (#1686). Placed by method, the
743
+ * `limit` lands in the body, the vendor applies its own default, and the page is not bounded — a read-through LIST
744
+ * then serves whole results, and a keyset page is refused at every run. Refused here, where the declaration is.
745
+ * spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
746
+ * statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
747
+ */
748
+ if (declaration?.statement?.language === HttpApiQueryStatementLanguage.SUITEQL
749
+ && declaration.method === HttpApiRestOperationMethod.POST
750
+ && declaration.pagingParams !== undefined
751
+ && declaration.pagingParams.placement !== HttpApiRestParameterPlacement.QUERY_STRING) {
752
+ throw new Error(
753
+ `operations.${member}.pagingParams: a SuiteQL read POSTs its statement in the body and is paged in the URL — declare `
754
+ + `\`placement: '${HttpApiRestParameterPlacement.QUERY_STRING}'\`, or the limit lands in the body and bounds nothing.`,
755
+ );
756
+ }
757
+ const keyset = declaration?.statement?.keyset;
758
+ if (declaration === undefined || keyset === undefined) continue;
759
+ if (member !== 'list') {
760
+ throw new Error(
761
+ `operations.${member}.statement.keyset: a keyset is what a pipeline walks a COLLECTION by, so it is declared on the 'list' member only.`,
762
+ );
763
+ }
764
+ if (keyFields.length !== 1) {
765
+ throw new Error(
766
+ `operations.list.statement.keyset: this binding declares ${keyFields.length} key components, and a keyset needs ONE unique column — `
767
+ + 'one component of a composite key is not unique, and a walk on it skips the rows that share its boundary value.',
768
+ );
769
+ }
770
+ const keyField = keyFields[0];
771
+ if (keyset.keyRemoteField !== keyField.remoteField) {
772
+ throw new Error(
773
+ `operations.list.statement.keyset.keyRemoteField: '${keyset.keyRemoteField}' is not this binding's key field ('${keyField.remoteField}'). `
774
+ + 'A keyset walks the row identity, which is the key field: unique and immutable, so no row can move behind the cursor.',
775
+ );
776
+ }
777
+ if (!HTTP_API_KEYSET_ELIGIBLE_CODECS.includes(keyField.codec)) {
778
+ throw new Error(
779
+ `operations.list.statement.keyset: the key field '${keyField.remoteField}' has the ${keyField.codec} codec, and a keyset walks `
780
+ + `${HTTP_API_KEYSET_ELIGIBLE_CODECS.join(' or ')} keys only — the engine checks each page against the key's order, and that `
781
+ + 'order must be one it can state.',
782
+ );
783
+ }
784
+ const bound = HTTP_API_KEYSET_PAGE_BOUND[declaration.statement!.language];
785
+ switch (bound) {
786
+ case HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE:
787
+ if (declaration.cursorPath === undefined) {
788
+ throw new Error(
789
+ `operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with LIMIT, and the vendor may still `
790
+ + 'answer the limited result in several batches. Declare the continuation (`cursorPath`, e.g. \'nextRecordsUrl\') so a page is '
791
+ + 'read to its end — a batch shorter than the limit would otherwise end the pass with rows unread.',
792
+ );
793
+ }
794
+ break;
795
+ case HttpApiKeysetPageBound.LIMIT_PARAMETER:
796
+ if (declaration.pagingParams === undefined) {
797
+ throw new Error(
798
+ `operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with the operation's limit parameter — `
799
+ + 'declare `pagingParams` (limitParam / offsetParam; the offset is always sent as 0).',
800
+ );
801
+ }
802
+ break;
803
+ }
804
+ }
805
+ }
806
+
164
807
  /**
165
808
  * Dialect-specific structural constraints that a discriminated union cannot express member-side.
166
809
  * Called by the resource-configuration factory AFTER the schema parse; throws with the offending
@@ -202,7 +845,100 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
202
845
  );
203
846
  }
204
847
  }
848
+ assertRestJsonKeysetCoherence(binding.keyFields, binding.operations);
849
+ }
850
+
851
+ // #1972 — a temporal kind is read by the REST_JSON statement compilers only; anywhere no statement is built it would
852
+ // decide nothing — a setting that looks like it controls date spelling and controls nothing.
853
+ const declaredTemporal = binding.fieldMappings.find((mapping) => mapping.temporalKind !== undefined);
854
+ if (declaredTemporal !== undefined) {
855
+ const readsThroughStatement = binding.dialect === HttpApiTransportDialect.REST_JSON
856
+ && Object.values(binding.operations).some((member) => (member as HttpApiRestOperationSpec | undefined)?.statement !== undefined);
857
+ if (!readsThroughStatement) {
858
+ throw new Error(
859
+ `fieldMappings('${declaredTemporal.localField}').temporalKind: declared on a ${binding.dialect} binding that reads through no query `
860
+ + 'statement — it tells a SOQL or SuiteQL statement how to spell a date, and nothing here builds one, so it would change nothing. Remove it.',
861
+ );
862
+ }
863
+ }
864
+
865
+ // #1679 — each opened verb once. A duplicate is not harmful by itself, but it is a declaration that
866
+ // says the same thing twice, which is the shape that drifts when one copy is edited.
867
+ if (new Set(binding.writableVerbs).size !== binding.writableVerbs.length) {
868
+ throw new Error(`writableVerbs: each verb may be opened once — got [${binding.writableVerbs.join(', ')}].`);
869
+ }
870
+
871
+ // #1724 — the concurrency stance of an opened UPDATE. A stance with no UPDATE decides nothing; an Odoo UPDATE with no
872
+ // stance would be last-writer-wins by an omission nobody reviewed, because Odoo's `write` takes no precondition.
873
+ const opensUpdate = binding.writableVerbs.includes(HttpApiWriteVerb.UPDATE);
874
+ if (binding.writeConcurrency !== undefined && !opensUpdate) {
875
+ throw new Error(
876
+ 'writeConcurrency: declared on a binding that opens no UPDATE — it governs updates only. Remove it, or open the update.',
877
+ );
878
+ }
879
+ if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODOO_JSONRPC) {
880
+ throw new Error(
881
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}', and Odoo's external API has no conditional write — `
882
+ + '`write(ids, vals)` applies the values whatever changed since they were read. State the stance: '
883
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to write_date>' } to refuse `
884
+ + `a stale version before sending (best-effort: it narrows the race, it does not close it), or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
885
+ );
886
+ }
887
+ // #1728 — a REST_JSON write is sent exactly as the binding declares it, so each opened verb needs its member and a
888
+ // member of a verb that is not opened is a declaration nothing sends. Both are refused, naming the member.
889
+ if (binding.dialect === HttpApiTransportDialect.REST_JSON) {
890
+ for (const verb of Object.values(HttpApiWriteVerb)) {
891
+ const member = binding.operations[verb];
892
+ const opened = binding.writableVerbs.includes(verb);
893
+ if (opened && member === undefined) {
894
+ throw new Error(
895
+ `operations.${verb}: this binding opens ${verb.toUpperCase()} toward '${binding.system}', and a REST_JSON write is sent `
896
+ + `exactly as declared — declare operations.${verb} (method + pathTemplate${verb === HttpApiWriteVerb.CREATE ? ' + createdKey' : ''}).`,
897
+ );
898
+ }
899
+ if (!opened && member !== undefined) {
900
+ throw new Error(
901
+ `operations.${verb}: declared on a binding that does not open ${verb.toUpperCase()} — nothing would ever send it. `
902
+ + `Open it in writableVerbs, or remove the member.`,
903
+ );
904
+ }
905
+ if (member !== undefined) {
906
+ assertHttpApiRestWriteOperationShape(member, {
907
+ member: verb,
908
+ ...HTTP_API_REST_WRITE_MEMBER_RULES[verb],
909
+ keyRemoteFields: binding.keyFields.map((keyField) => keyField.remoteField),
910
+ });
911
+ }
912
+ }
913
+ // Neither REST_JSON vendor's record API is written with a precondition, so an update's stance must be stated, as on Odoo.
914
+ if (opensUpdate && binding.writeConcurrency === undefined) {
915
+ throw new Error(
916
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}' over REST_JSON, which the engine writes with no `
917
+ + `precondition. State the stance: { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }, or `
918
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to the row version>' } — `
919
+ + 'best-effort, and available only when the vendor facet declares its row version field.',
920
+ );
921
+ }
922
+ }
923
+ // #1726 — an OData UPDATE is conditional only on a version the caller supplies; without a stance it would be
924
+ // last-writer-wins by an omission nobody reviewed, exactly as for Odoo.
925
+ if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODATA) {
926
+ throw new Error(
927
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}' over OData. State the stance: `
928
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to @odata.etag>' } to send the `
929
+ + 'entity tag the caller read as If-Match, so the service itself refuses a stale update (412) — available only when the '
930
+ + `vendor facet declares its entity tag as rowVersionField — or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
931
+ );
205
932
  }
933
+ if (binding.writeConcurrency?.mode === HttpApiWriteConcurrencyMode.VERSION_CHECKED) {
934
+ const versionField = binding.writeConcurrency.versionField;
935
+ if (binding.keyFields.some((keyField) => keyField.localField === versionField)) {
936
+ throw new Error(`writeConcurrency.versionField: '${versionField}' is a key field — a row's version is not its address.`);
937
+ }
938
+ }
939
+
940
+ // #1678 — every declared action must be one this binding's dialect can call, on the target it names.
941
+ assertSystemOfRecordActionDeclarationsCoherence({ dialect: binding.dialect, actions: binding.actions });
206
942
 
207
943
  // D6 stance 6b — the declared erasure operation's FORM is dialect-specific. The union schema
208
944
  // admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
@@ -213,6 +949,17 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
213
949
  // - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
214
950
  // the binding declares the exact call, like every other REST_JSON operation).
215
951
  if (binding.erasure.stance === HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION) {
952
+ /*
953
+ * #1687 — an OData v2 binding reads only. The explicit-erasure stance is a remote DELETE, which on SAP Gateway needs
954
+ * the CSRF-token handshake the engine does not perform, and v2's write shapes are the write path's (#1679). Refused
955
+ * here rather than at the first erasure request, where a subject's Art. 17 answer would be the one to fail.
956
+ */
957
+ if (binding.dialect === HttpApiTransportDialect.ODATA_V2) {
958
+ throw new Error(
959
+ 'erasure: an ODATA_V2 binding reads only, and the explicit-erasure stance is a remote DELETE the engine does not send on v2 '
960
+ + '(SAP Gateway requires a CSRF-token handshake). Declare NO_SUBJECT_DATA or CONTROLLER_ACKNOWLEDGED_NON_ERASURE, or bind a v4 service.',
961
+ );
962
+ }
216
963
  const usesCanonicalDelete = 'useCanonicalDelete' in binding.erasure.operation;
217
964
  if (binding.dialect === HttpApiTransportDialect.REST_JSON && usesCanonicalDelete) {
218
965
  throw new Error(
@@ -227,3 +974,39 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
227
974
  }
228
975
  }
229
976
  ```
977
+
978
+ ### Origin Package: `@wildo-ai/saas-models`
979
+
980
+ ```typescript
981
+ /**
982
+ * The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
983
+ * from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
984
+ * registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
985
+ * "we cannot delete rows we do not own" is not an answer the framework may imply silently.
986
+ *
987
+ * Import it from `@wildo-ai/saas-models` (the package root), not from the `external-data` subpath.
988
+ */
989
+ export enum HttpApiErasureStance {
990
+ /**
991
+ * (6a) The resource declares it holds NO personal/subject data. Registration verifies the
992
+ * declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
993
+ * the remote rows.
994
+ */
995
+ NO_SUBJECT_DATA = 'no-subject-data',
996
+
997
+ /**
998
+ * (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
999
+ * engine invokes on a subject-erasure request. This is a single declared write and does NOT
1000
+ * require general write support (slice 1 stays read-only otherwise).
1001
+ */
1002
+ EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
1003
+
1004
+ /**
1005
+ * (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
1006
+ * lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
1007
+ * administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
1008
+ * is the control. NEVER a standing default — the acknowledgement is per erasure request.
1009
+ */
1010
+ CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
1011
+ }
1012
+ ```