@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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 (1167) 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/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  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/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -9,183 +9,665 @@
9
9
  ### Origin Package: `@wildo-ai/saas-models`
10
10
 
11
11
  ```typescript
12
- export enum HttpApiTransportDialect {
12
+ // --------------------------------
13
+ // Whose identity reaches the target
14
+ // --------------------------------
15
+
16
+ /*
17
+ * ─── `HttpApiIdentityMode` was REMOVED here (#333), and replaced rather than widened ────────────
18
+ *
19
+ * It had two values — `SERVICE_PRINCIPAL` and `USER_DELEGATED` — and its own docstring said it
20
+ * stayed declared "so bindings need no reshape when it arrives". That is the one thing it got
21
+ * wrong. `USER_DELEGATED` names a delegation without naming WHOSE ACCOUNT is spent, and those are
22
+ * two independent questions with five real answers (`ExternalProvider_ConnectionShape`):
23
+ *
24
+ * - a user's own personal grant is `USER × SERVICE`;
25
+ * - one member's own account, linked for the whole organization, is `ORGANIZATION × USER`
26
+ * (decided on wildo-ai/wildo-ai#18: every member spends it, and the linking member is named in
27
+ * the audit trail).
28
+ *
29
+ * Both are "per-user OAuth against the target", they resolve DIFFERENT credentials, and the single
30
+ * field cannot distinguish them. So mapping it onto a target would have silently picked a lane —
31
+ * which is why `connectionTargetForBinding` refused instead of guessing, and why the fix is the
32
+ * richer vocabulary rather than a translation table.
33
+ *
34
+ * The audit contract is unchanged and was never the identity mode's to keep: every row carries the
35
+ * REAL initiating user whatever the connection, so the shared-principal attribution failure
36
+ * documented for Power Platform ("credential-sharing as a service") stays closed (requirement R12).
37
+ */
38
+
39
+ // --------------------------------
40
+ // Erasure stance (GDPR Art. 17 on rows we do not own)
41
+ // --------------------------------
42
+
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
+ */
49
+
50
+ /*
51
+ * ─── `HttpApiTenancyStance` was REMOVED here (#1055), and NOT replaced by a narrower vocabulary ──
52
+ *
53
+ * It had two members and both were wrong for a system of record.
54
+ *
55
+ * `SCOPE_FILTER_PUSHDOWN` pushed the engine's contextual scope predicate into the remote query —
56
+ * which means sending WILDO's own organization id to a system that has never heard of it, as a
57
+ * filter value. Nothing on the far side could match it, so the stance could only ever have worked
58
+ * against a remote that happened to store Wildo ids.
59
+ *
60
+ * `SINGLE_TENANT_BINDING` then became the only truth, and a declaration with one legal value is a
61
+ * question nobody should be asked — plus it carried a `justification` string, which made every
62
+ * binding restate the same sentence.
63
+ *
64
+ * What replaced it is a different MECHANISM rather than a smaller field: the row projector stamps
65
+ * the owner organization's id onto each remote row, so the per-row tenant gate passes with no
66
+ * exemption and a request under another organization's URL is refused by the branch that already
67
+ * existed. Narrowing a system of record BY organization unit is #1058, and it belongs to the
68
+ * INSTANCE and its vendor facet — one declaration for every resource that reads that system,
69
+ * rather than one per binding.
70
+ */
71
+
72
+ // --------------------------------
73
+ // Key declaration + component codecs (paper A)
74
+ // --------------------------------
75
+
76
+ /**
77
+ * Per-component value normalization for key synthesis. The codec is what makes the synthesized
78
+ * `_id` STABLE: every component must round-trip byte-identically between the remote
79
+ * representation and the encoded id, or the same remote row would answer to different ids.
80
+ *
81
+ * `INTEGER` and `GUID` are the two codecs whose entire value space is URL-unreserved-safe, which
82
+ * is what qualifies a single-key binding for the VERBATIM id form (see
83
+ * `httpApiBindingUsesVerbatimKey`).
84
+ */
85
+ export enum HttpApiKeyComponentCodec {
86
+ /** Arbitrary remote string. NOT charset-safe → always participates via the encoded id form. */
87
+ STRING = 'string',
88
+
89
+ /** Integer key (Odoo `id`, SAP numeric keys). Digits only → verbatim-eligible. */
90
+ INTEGER = 'integer',
91
+
92
+ /** GUID/UUID key (Dataverse row ids). Hex + dashes → verbatim-eligible. */
93
+ GUID = 'guid',
94
+
95
+ /**
96
+ * Date/time key component, normalized to the RFC 3339 / ISO 8601 UTC string form before
97
+ * encoding. NOT verbatim-eligible (`:` is forbidden in ids — websocket room names are
98
+ * colon-parsed).
99
+ */
100
+ DATETIME_ISO = 'datetime-iso',
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 {
13
239
  /**
14
- * OData **v4** — one generic client: mechanical pushdown of
15
- * `$filter`/`$select`/`$top`/`$skip`/`$orderby`/`$count`, with a `$metadata` boot-time
16
- * verification probe of the committed declaration.
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.
17
289
  *
18
- * ⚠ **This member is v4 ONLY, and that excludes SAP's most-used API.** An earlier revision of
19
- * this comment named "SAP S/4HANA, Microsoft Dataverse/Dynamics 365" here, which is half right
20
- * and was load-bearing — it is why nobody looked:
290
+ * spec-cite: Salesforce Developers, "SOQL and SOSL Reference" —
291
+ * https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/
21
292
  *
22
- * | Target | Version | Consumable today |
23
- * |---|---|---|
24
- * | Microsoft Dataverse / Dynamics 365 Web API (`/api/data/v9.2/`) | v4 | ✅ |
25
- * | SAP S/4HANA OData **v4** services (`/sap/opu/odata4/…`) | v4 | ✅ |
26
- * | SAP `API_BUSINESS_PARTNER` (`/sap/opu/odata/sap/API_BUSINESS_PARTNER`) | **v2** | ❌ |
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.
27
300
  *
28
- * v2 is not a v4 variant with a different header. Its collection envelope is
29
- * `{ "d": { "results": [...], "__next": …, "__count": … } }` rather than
30
- * `{ "value": [...], "@odata.nextLink": … }`; `Edm.DateTime` serializes as `"/Date(<ticks>)/"`
31
- * rather than ISO 8601; `Edm.Decimal` and `Edm.Int64` serialize as JSON STRINGS rather than
32
- * numbers; and JSON must be requested (`$format=json`) because v2 defaults to Atom/XML. So it
33
- * changes the envelope, the paging property, the count property AND the value encoding — a
34
- * reader written for one cannot read the other, and the mapping layer needs coercions the way
35
- * Odoo needs `ODOO_FALSE_AS_NULL`.
36
- * spec-cite: OData Version 2.0 JSON Format
37
- * (https://www.odata.org/documentation/odata-version-2-0/json-format/) — the `d`/`results`/
38
- * `__next`/`__count` envelope, the `/Date(<ticks>)/` DateTime literal, and Edm.Decimal /
39
- * Edm.Int64 "formatted as a JSON string".
301
+ * spec-cite: Oracle NetSuite, "SuiteQL" —
302
+ * https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156257770590.html
40
303
  *
41
- * Supporting v2 is an OPEN decision, not an oversight. Until it lands, point an ODATA binding at
42
- * a v4 service: for SAP that means the OData v4 edition of the API where one is published.
304
+ * Paged by `limit` / `offset` QUERY parameters rather than inside the statement, which is why the
305
+ * statement declaration and `pagingParams` are independent.
43
306
  */
44
- ODATA = 'odata',
307
+ SUITEQL = 'suiteql',
308
+ }
45
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 {
46
318
  /**
47
- * Declared per-binding REST/JSON operation mapping (bespoke enterprise APIs). Unlike ODATA
48
- * there is no generic client: each binding declares how read/list/count/search map onto
49
- * concrete HTTP operations.
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."
50
330
  */
51
- REST_JSON = 'rest-json',
52
-
331
+ STATEMENT_LIMIT_CLAUSE = 'statement-limit-clause',
53
332
  /**
54
- * Odoo's external API (`/jsonrpc` + `execute_kw`). Promoted to its OWN dialect 2026-08-27 —
55
- * D0's original "JSON-RPC is a thin envelope variant of REST_JSON" was corrected by measuring
56
- * the protocol: it is generic like ODATA (no per-binding operation declarations — the model
57
- * name IS `entityRef`, and read/list/count map onto `read`/`search_read`/`search_count`
58
- * mechanically), but it speaks POSITIONAL arguments, its own domain filter language
59
- * (`[['field','=',value], …]` with polish-notation `'|'` disjunction), and authenticates
60
- * INSIDE the RPC args (`execute_kw(db, uid, api_key, …)`) rather than via HTTP headers.
61
- * Forcing that through REST_JSON's declared-parameter model would have been the
62
- * merge-distinct-concepts failure `design-philosophy.md` forbids.
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.
63
335
  *
64
- * Structural constraint (schema-enforced): exactly ONE key field with the `INTEGER` codec —
65
- * Odoo row ids are integers, always.
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."
66
343
  */
67
- ODOO_JSONRPC = 'odoo-jsonrpc',
344
+ LIMIT_PARAMETER = 'limit-parameter',
68
345
  }
69
346
 
70
- // --------------------------------
71
- // Identity mode (whose identity reaches the target)
72
- // --------------------------------
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>;
73
407
 
74
408
  /**
75
- * Whose identity the adapter presents to the target system. In BOTH modes audit rows carry the
76
- * REAL initiating user — the shared-principal attribution failure documented for Power Platform
77
- * ("credential-sharing as a service") must not be reproduced (requirement R12).
78
- *
79
- * D9 ruling (Paul, 2026-08-27 — re-scoping the original "both executable in slice 1"):
80
- * **SERVICE_PRINCIPAL-first.** `USER_DELEGATED` stays DECLARED and representable so bindings
81
- * need no reshape when it arrives, but resolving it REFUSES naming the missing substrate: the
82
- * engine has no outbound per-user token store (measured — `OAuth2_CredentialSchema` is a model
83
- * with no resource, persistence or service behind it). Building that store is its own workstream.
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.
84
414
  */
85
- export enum HttpApiIdentityMode {
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),
86
430
  /**
87
- * One service account per binding (never shared across applications — blast-radius doctrine).
88
- * Wildo's own roles/operations gate who may trigger calls. The default, and the only option
89
- * when the target has no per-user OAuth surface.
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.
90
433
  */
91
- SERVICE_PRINCIPAL = 'service-principal',
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),
92
447
 
93
448
  /**
94
- * Per-user OAuth 2.0 tokens against the target — encrypted, session-bound (the Retool model;
95
- * on-behalf-of where the IdP is shared, e.g. Entra ID for Dynamics). Use when the TARGET's own
96
- * authorization must decide per user: the tool can then never show a user more than the target
97
- * would.
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.
98
451
  */
99
- USER_DELEGATED = 'user-delegated',
100
- }
452
+ pathTemplate: z.string().min(1),
101
453
 
102
- // --------------------------------
103
- // Erasure stance (GDPR Art. 17 on rows we do not own)
104
- // --------------------------------
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(),
105
470
 
106
- /**
107
- * The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
108
- * from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
109
- * registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
110
- * "we cannot delete rows we do not own" is not an answer the framework may imply silently.
111
- */
112
- export enum HttpApiErasureStance {
113
471
  /**
114
- * (6a) The resource declares it holds NO personal/subject data. Registration verifies the
115
- * declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
116
- * the remote rows.
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.
117
475
  */
118
- NO_SUBJECT_DATA = 'no-subject-data',
476
+ filterParams: z.record(z.string().min(1), z.string().min(1)).optional(),
119
477
 
120
478
  /**
121
- * (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
122
- * engine invokes on a subject-erasure request. This is a single declared write and does NOT
123
- * require general write support (slice 1 stays read-only otherwise).
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.
124
481
  */
125
- EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
482
+ searchParam: z.string().min(1).optional(),
126
483
 
127
484
  /**
128
- * (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
129
- * lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
130
- * administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
131
- * is the control. NEVER a standing default — the acknowledgement is per erasure request.
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.
132
489
  */
133
- CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
134
- }
490
+ resultPath: z.string().min(1).optional(),
135
491
 
136
- // --------------------------------
137
- // Tenancy stance
138
- // --------------------------------
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(),
139
498
 
140
- /**
141
- * How tenant confinement is enforced against the remote system (requirements R4/R16).
142
- */
143
- export enum HttpApiTenancyStance {
144
499
  /**
145
- * The engine's contextual scope predicate is pushed down into every remote query against a
146
- * declared remote field. Registration REFUSES a binding whose declared surface cannot express
147
- * the scope predicate — a query-time refusal would be a data leak one missed branch away.
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.
148
506
  */
149
- SCOPE_FILTER_PUSHDOWN = 'scope-filter-pushdown',
507
+ statement: HttpApiQueryStatementSpecSchema.optional(),
150
508
 
151
509
  /**
152
- * The binding declares the target system serves exactly ONE tenant (the normal case for an
153
- * internal tool on one enterprise's IS). Scope pushdown is then N/A by declaration — an
154
- * explicit, audited stance, never an inferred one (R16).
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.
155
519
  */
156
- SINGLE_TENANT_BINDING = 'single-tenant-binding',
157
- }
520
+ cursorPath: z.string().min(1).optional(),
158
521
 
159
- // --------------------------------
160
- // Key declaration + component codecs (paper A)
161
- // --------------------------------
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
+ ```
162
534
 
535
+ ### Origin Package: `@wildo-ai/saas-models`
536
+
537
+ ```typescript
163
538
  /**
164
- * Per-component value normalization for key synthesis. The codec is what makes the synthesized
165
- * `_id` STABLE: every component must round-trip byte-identically between the remote
166
- * representation and the encoded id, or the same remote row would answer to different ids.
167
- *
168
- * `INTEGER` and `GUID` are the two codecs whose entire value space is URL-unreserved-safe, which
169
- * is what qualifies a single-key binding for the VERBATIM id form (see
170
- * `httpApiBindingUsesVerbatimKey`).
539
+ * The fields EVERY binding carries, whatever its dialect — spread into each arm of the union below.
171
540
  */
172
- export enum HttpApiKeyComponentCodec {
173
- /** Arbitrary remote string. NOT charset-safe → always participates via the encoded id form. */
174
- STRING = 'string',
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),
175
562
 
176
- /** Integer key (Odoo `id`, SAP numeric keys). Digits only → verbatim-eligible. */
177
- INTEGER = 'integer',
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),
178
568
 
179
- /** GUID/UUID key (Dataverse row ids). Hex + dashes → verbatim-eligible. */
180
- GUID = 'guid',
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,
181
603
 
182
604
  /**
183
- * Date/time key component, normalized to the RFC 3339 / ISO 8601 UTC string form before
184
- * encoding. NOT verbatim-eligible (`:` is forbidden in ids — websocket room names are
185
- * colon-parsed).
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.
186
617
  */
187
- DATETIME_ISO = 'datetime-iso',
188
- }
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
+ };
189
671
  ```
190
672
 
191
673
  ### Origin Package: `@wildo-ai/saas-models`
@@ -195,17 +677,34 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
195
677
  z.object({
196
678
  dialect: z.literal(HttpApiTransportDialect.ODATA),
197
679
  ...httpApiResourceBindingBaseShape,
198
- /**
199
- * Verify the committed declaration against the live `$metadata` at boot (decision D5 —
200
- * drift is detected at boot and the fix is re-authoring, never silent adaptation). Opt out
201
- * only for targets that genuinely do not serve `$metadata`.
680
+ /*
681
+ * `verifyMetadataAtBoot` was here, and it is GONE (#1055 §5).
682
+ *
683
+ * It had ZERO non-test readers — measured, not assumed — so nothing ever probed `$metadata` at
684
+ * boot whatever it was set to. It also asked for exactly what the registry above it must never
685
+ * do: dial the remote during startup, where an ERP outage would stop an application booting
686
+ * (`continuity-drift-and-cas-basis.md` Rule 3).
687
+ *
688
+ * The drift probe it promised EXISTS, on the extraction source, reached through the operator door
689
+ * (`external-data-extraction-source.backend.ts`) — where a human is present and a refusal is
690
+ * something somebody can act on.
202
691
  */
203
- verifyMetadataAtBoot: z.boolean().default(true),
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,
204
700
  }),
205
701
  z.object({
206
702
  dialect: z.literal(HttpApiTransportDialect.REST_JSON),
207
703
  ...httpApiResourceBindingBaseShape,
208
- /** 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
+ */
209
708
  operations: HttpApiRestOperationsSchema,
210
709
  }),
211
710
  z.object({
@@ -219,6 +718,92 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
219
718
  }),
220
719
  ]);
221
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
+
222
807
  /**
223
808
  * Dialect-specific structural constraints that a discriminated union cannot express member-side.
224
809
  * Called by the resource-configuration factory AFTER the schema parse; throws with the offending
@@ -238,6 +823,123 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
238
823
  }
239
824
  }
240
825
 
826
+ /*
827
+ * A member naming a PROVIDER's catalogue operation is refused, and refused EXPLICITLY (#1055 D10).
828
+ *
829
+ * The schema alone would refuse it as an unknown key, with a message about `providerOperationId`
830
+ * not being expected — true, and useless to an author who reasonably believes the form still
831
+ * exists, because it did until this slice. So the refusal names what happened and where the shape
832
+ * went instead of letting the parse error carry it.
833
+ *
834
+ * This replaces an ambiguity check that existed for the opposite reason: while BOTH forms were
835
+ * legal, a member carrying both parsed as the inline one and dropped the reference silently.
836
+ */
837
+ if (binding.dialect === HttpApiTransportDialect.REST_JSON) {
838
+ for (const [member, declaration] of Object.entries(binding.operations)) {
839
+ if (declaration === undefined) continue;
840
+ if ((declaration as Record<string, unknown>).providerOperationId !== undefined) {
841
+ throw new Error(
842
+ `operations.${member}: a read member can no longer REFERENCE a provider's operation catalogue `
843
+ + '(`providerOperationId`). A system of record is not a connector, so its read surface is declared '
844
+ + 'INLINE here (method + pathTemplate) against the vendor facet.',
845
+ );
846
+ }
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
+ );
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 });
942
+
241
943
  // D6 stance 6b — the declared erasure operation's FORM is dialect-specific. The union schema
242
944
  // admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
243
945
  // at authoring rather than on the first subject-erasure request:
@@ -247,6 +949,17 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
247
949
  // - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
248
950
  // the binding declares the exact call, like every other REST_JSON operation).
249
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
+ }
250
963
  const usesCanonicalDelete = 'useCanonicalDelete' in binding.erasure.operation;
251
964
  if (binding.dialect === HttpApiTransportDialect.REST_JSON && usesCanonicalDelete) {
252
965
  throw new Error(
@@ -261,3 +974,39 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
261
974
  }
262
975
  }
263
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
+ ```