@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
@@ -2,9 +2,10 @@
2
2
 
3
3
  Read this when declaring a resource whose rows live entirely in a remote system:
4
4
 
5
+ - which declared SYSTEM OF RECORD the rows live in, and how a binding names it;
5
6
  - the transport dialects, and what each one requires;
6
7
  - the key-component codecs, and which are safe to embed in a row identity verbatim;
7
- - the tenancy and erasure stances — both mandatory, both decisions the framework refuses to guess;
8
+ - the erasure stance — mandatory, and a decision the framework refuses to guess;
8
9
  - the per-dialect binding shape.
9
10
 
10
11
  Everything below is imported from `@wildo-ai/saas-models/external-data` — the same subpath the
@@ -15,14 +16,24 @@ Three contracts to internalise before you author anything:
15
16
  1. **`keyFields` order is the ENCODING order, and it is committed.** Row identity is synthesized
16
17
  from the key components in the order you declare. Reordering them later re-keys every row and
17
18
  orphans every stored foreign-key value pointing at them.
18
- 2. **`tenancy` is a security declaration, not metadata.** It states how remote data relates to your
19
- tenants. A wrong answer is a cross-tenant leak, which is why there is no default.
19
+ 2. **`system` names an INSTANCE you declared, not a provider.** The instance lives in
20
+ `wildo.saas.config.ts` under `systemsOfRecord`, and its address and credential come from the
21
+ ENVIRONMENT under names derived from its name — so a second deployment of the same vendor is a
22
+ second entry there and nothing else. A binding naming an instance the application does not declare
23
+ is refused at boot, with the declared ones listed.
24
+
25
+ There is no tenancy declaration, and that is deliberate: rows read out of a system of record are
26
+ STAMPED with the organization that owns the application, so the engine's per-row tenant gate
27
+ decides. Nothing about your tenants is pushed to the remote, which has never heard of them.
20
28
  3. **`erasure` must answer for personal data.** Every stance is a real answer — including "this
21
29
  binding holds no subject data" — but silence is not one of them, because a subject-erasure
22
30
  request has to be answerable for every resource the application declares.
23
31
 
24
- Slice-1 reality: **reads only.** Every write member of a virtual resource is an honest refusal, and
25
- the one sanctioned exception is the declared external-erasure call that a subject erasure invokes.
32
+ **Writes are opened, never implied.** A binding is read-only until `writableVerbs` opens `create`,
33
+ `update` or `delete`, and each opened verb must be performed by a declared operation — the full
34
+ contract, including who may write which partition and what a client does with an unknown outcome, is
35
+ in `read-through-writes.md`. Bulk writes are never available. The subject-erasure delete is separate
36
+ from all of this: it runs through the declared erasure operation whatever `writableVerbs` says.
26
37
 
27
38
  ## Import Origins
28
39
 
@@ -33,183 +44,665 @@ the one sanctioned exception is the declared external-erasure call that a subjec
33
44
  ### Origin Package: `@wildo-ai/saas-models`
34
45
 
35
46
  ```typescript
36
- export enum HttpApiTransportDialect {
47
+ // --------------------------------
48
+ // Whose identity reaches the target
49
+ // --------------------------------
50
+
51
+ /*
52
+ * ─── `HttpApiIdentityMode` was REMOVED here (#333), and replaced rather than widened ────────────
53
+ *
54
+ * It had two values — `SERVICE_PRINCIPAL` and `USER_DELEGATED` — and its own docstring said it
55
+ * stayed declared "so bindings need no reshape when it arrives". That is the one thing it got
56
+ * wrong. `USER_DELEGATED` names a delegation without naming WHOSE ACCOUNT is spent, and those are
57
+ * two independent questions with five real answers (`ExternalProvider_ConnectionShape`):
58
+ *
59
+ * - a user's own personal grant is `USER × SERVICE`;
60
+ * - one member's own account, linked for the whole organization, is `ORGANIZATION × USER`
61
+ * (decided on wildo-ai/wildo-ai#18: every member spends it, and the linking member is named in
62
+ * the audit trail).
63
+ *
64
+ * Both are "per-user OAuth against the target", they resolve DIFFERENT credentials, and the single
65
+ * field cannot distinguish them. So mapping it onto a target would have silently picked a lane —
66
+ * which is why `connectionTargetForBinding` refused instead of guessing, and why the fix is the
67
+ * richer vocabulary rather than a translation table.
68
+ *
69
+ * The audit contract is unchanged and was never the identity mode's to keep: every row carries the
70
+ * REAL initiating user whatever the connection, so the shared-principal attribution failure
71
+ * documented for Power Platform ("credential-sharing as a service") stays closed (requirement R12).
72
+ */
73
+
74
+ // --------------------------------
75
+ // Erasure stance (GDPR Art. 17 on rows we do not own)
76
+ // --------------------------------
77
+
78
+ /*
79
+ * `HttpApiErasureStance` lives in `./http-api-erasure-stance.shared` and is published from the package ROOT
80
+ * (#1710): three root-exported contracts name it, and a nominal enum reachable only through this subpath
81
+ * made their inferred types unnameable for a root-only consumer (TS2742). The binding arms below still
82
+ * discriminate on it.
83
+ */
84
+
85
+ /*
86
+ * ─── `HttpApiTenancyStance` was REMOVED here (#1055), and NOT replaced by a narrower vocabulary ──
87
+ *
88
+ * It had two members and both were wrong for a system of record.
89
+ *
90
+ * `SCOPE_FILTER_PUSHDOWN` pushed the engine's contextual scope predicate into the remote query —
91
+ * which means sending WILDO's own organization id to a system that has never heard of it, as a
92
+ * filter value. Nothing on the far side could match it, so the stance could only ever have worked
93
+ * against a remote that happened to store Wildo ids.
94
+ *
95
+ * `SINGLE_TENANT_BINDING` then became the only truth, and a declaration with one legal value is a
96
+ * question nobody should be asked — plus it carried a `justification` string, which made every
97
+ * binding restate the same sentence.
98
+ *
99
+ * What replaced it is a different MECHANISM rather than a smaller field: the row projector stamps
100
+ * the owner organization's id onto each remote row, so the per-row tenant gate passes with no
101
+ * exemption and a request under another organization's URL is refused by the branch that already
102
+ * existed. Narrowing a system of record BY organization unit is #1058, and it belongs to the
103
+ * INSTANCE and its vendor facet — one declaration for every resource that reads that system,
104
+ * rather than one per binding.
105
+ */
106
+
107
+ // --------------------------------
108
+ // Key declaration + component codecs (paper A)
109
+ // --------------------------------
110
+
111
+ /**
112
+ * Per-component value normalization for key synthesis. The codec is what makes the synthesized
113
+ * `_id` STABLE: every component must round-trip byte-identically between the remote
114
+ * representation and the encoded id, or the same remote row would answer to different ids.
115
+ *
116
+ * `INTEGER` and `GUID` are the two codecs whose entire value space is URL-unreserved-safe, which
117
+ * is what qualifies a single-key binding for the VERBATIM id form (see
118
+ * `httpApiBindingUsesVerbatimKey`).
119
+ */
120
+ export enum HttpApiKeyComponentCodec {
121
+ /** Arbitrary remote string. NOT charset-safe → always participates via the encoded id form. */
122
+ STRING = 'string',
123
+
124
+ /** Integer key (Odoo `id`, SAP numeric keys). Digits only → verbatim-eligible. */
125
+ INTEGER = 'integer',
126
+
127
+ /** GUID/UUID key (Dataverse row ids). Hex + dashes → verbatim-eligible. */
128
+ GUID = 'guid',
129
+
130
+ /**
131
+ * Date/time key component, normalized to the RFC 3339 / ISO 8601 UTC string form before
132
+ * encoding. NOT verbatim-eligible (`:` is forbidden in ids — websocket room names are
133
+ * colon-parsed).
134
+ */
135
+ DATETIME_ISO = 'datetime-iso',
136
+ }
137
+
138
+ // --------------------------------
139
+ // Write verbs a binding OPENS (#1679)
140
+ // --------------------------------
141
+
142
+ /**
143
+ * A row-level write a read-through resource may send to its system of record.
144
+ *
145
+ * Three members and no bulk ones, deliberately. A bulk write against a system the platform does not
146
+ * own has no atomicity to offer — ten rows are ten remote calls, any of which can fail after the ones
147
+ * before it landed — so the engine opens single-row create, update and delete by key, and nothing
148
+ * else. `createMany`, `updateMany`, `deleteMany`, the guarded atomic primitives and the raw-filter
149
+ * doors stay refused by name on the repository.
150
+ *
151
+ * ## Why the binding declares them at all, when the resource already lists its operations
152
+ *
153
+ * Because opening a write door into somebody else's ERP is a decision of its own, taken where the
154
+ * remote contract is written. The resource's operation list says which HTTP routes exist; this says
155
+ * the binding may WRITE through them. The resource factory refuses the two disagreeing in EITHER
156
+ * direction — a write operation whose verb the binding does not open, and an opened verb no operation
157
+ * uses — so the second declaration can never drift from the first into an inert door or an open one.
158
+ *
159
+ * Absent is empty: every binding written before #1679 stays read-only without a change.
160
+ */
161
+ export enum HttpApiWriteVerb {
162
+ /** A new remote row. The engine derives its partition from the caller's organization unit. */
163
+ CREATE = 'create',
164
+ /** A change to one remote row, addressed by its synthesized id. Read first, then written. */
165
+ UPDATE = 'update',
166
+ /** The removal of one remote row, addressed by its synthesized id. Read first, then deleted. */
167
+ DELETE = 'delete',
168
+ }
169
+
170
+ /**
171
+ * What protects an UPDATE against overwriting a change made since its author read the row (#1724, #1726, #1728) —
172
+ * declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODATA, REST_JSON).
173
+ *
174
+ * ## Why a binding must say this at all
175
+ *
176
+ * An update that carries no version is last-writer-wins, whatever the vendor could have offered: Odoo's external API
177
+ * applies `write(ids, vals)` unconditionally, a REST_JSON write is sent with no precondition, and an OData service
178
+ * applies a `PATCH` whose `If-Match` matches — which a caller who never read the row cannot make match anything but
179
+ * `*`. A default nobody chose is a lost update nobody expects, so a binding that opens UPDATE states which of the two it
180
+ * accepts, and the factory refuses the omission.
181
+ *
182
+ * ## What VERSION_CHECKED is, honestly — it depends on the dialect
183
+ *
184
+ * The caller sends the row version it read (the local field named by `versionField`, mapped onto the vendor's
185
+ * `rowVersionField` — Odoo `write_date`, an OData service's `@odata.etag`). The engine reads the row just before
186
+ * writing it — the read it already makes to check the partition — and refuses the update when the versions differ,
187
+ * before anything is sent. Then:
188
+ *
189
+ * - **Odoo: best-effort.** Odoo takes no precondition, so the comparison and the write are two calls. That NARROWS the
190
+ * race to the gap between them; it does NOT close it. A change landing inside that gap is overwritten, and a vendor
191
+ * that serves its version coarsely (Odoo: to the second) cannot tell two changes in the same second apart.
192
+ * - **REST_JSON: best-effort, as on Odoo** — the write is sent as declared, with no precondition. It is available only
193
+ * where the vendor facet declares a `rowVersionField`; neither the Salesforce nor the NetSuite facet does, so a
194
+ * binding against them states LAST_WRITER_WINS (startup refuses VERSION_CHECKED there).
195
+ * - **OData: atomic.** The version is also sent as `If-Match`, so the SERVICE compares it with the row it is about to
196
+ * change and answers `412 Precondition Failed` without applying anything when it moved — the gap is closed by the
197
+ * vendor, not narrowed by the engine.
198
+ * spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match).
199
+ */
200
+ export enum HttpApiWriteConcurrencyMode {
201
+ /**
202
+ * Every UPDATE carries the version its author read, and a stale one is refused before sending. Best-effort on Odoo
203
+ * and REST_JSON; atomic on OData, where the version also travels as `If-Match`.
204
+ */
205
+ VERSION_CHECKED = 'version-checked',
206
+ /**
207
+ * No check against the version the CALLER read: the last update sent wins. Stated, so it is a decision rather than an
208
+ * accident. On OData the engine still sends the entity tag of the row it read first (or `*` when the row carries
209
+ * none), so a row that moved between that read and the write is refused, and a row deleted in between is never
210
+ * re-created by an upsert.
211
+ */
212
+ LAST_WRITER_WINS = 'last-writer-wins',
213
+ }
214
+ ```
215
+
216
+ ### Origin Package: `@wildo-ai/saas-models`
217
+
218
+ ```typescript
219
+ /**
220
+ * What kind of TEMPORAL value a remote field holds, when a query statement compares it (#1972).
221
+ *
222
+ * A statement language spells a date and a date-time differently, and neither accepts a quoted string:
223
+ *
224
+ * | language | `DATE` | `DATE_TIME` |
225
+ * |---|---|---|
226
+ * | SOQL | `2026-01-05` (unquoted) | `2026-01-05T10:00:00Z` (unquoted, whole seconds) |
227
+ * | SuiteQL | `TO_DATE('2026-01-05', 'YYYY-MM-DD')` ¹ | `TO_DATE('2026-01-05 10:00:00', 'YYYY-MM-DD HH24:MI:SS')` |
228
+ *
229
+ * ¹ spec-cite: N/A — the date-only mask is Oracle SQL's `TO_DATE` convention (SuiteQL is SQL-92 / Oracle SQL);
230
+ * NetSuite's page shows only the date-time mask cited below.
231
+ *
232
+ * Which one a field needs is a fact about the REMOTE column that nothing in a local `Date` carries, so a
233
+ * statement read that filters a date field DECLARES it; a date compared with an undeclared field is refused
234
+ * rather than guessed, because the wrong form is refused by the vendor or silently compares as text.
235
+ * spec-cite: Salesforce, "SOQL and SOSL Reference" v68.0, WHERE › "Date Formats and Date Literals in WHERE" —
236
+ * `WHERE CreatedDate > 2005-10-08T01:02:03Z`; `date YYYY-MM-DD`; `dateTime YYYY-MM-DDThh:mm:ss+hh:mm,
237
+ * YYYY-MM-DDThh:mm:ss-hh:mm, or YYYY-MM-DDThh:mm:ssZ`.
238
+ * spec-cite: Oracle NetSuite, "SuiteQL Performance and Best Practices" (article_0824094533) — "You can't use date
239
+ * literals. You must encapsulate dates using the `to_date()` function."; "Do not use plain string values for date
240
+ * comparisons."; `where lastmodifieddate >= TO_DATE('2024-01-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss')`.
241
+ *
242
+ * Read by the REST_JSON STATEMENT compilers only; declared on another dialect, or on a REST_JSON binding none of
243
+ * whose read members is a statement, it would change nothing, so the binding coherence refuses it there.
244
+ */
245
+ export enum HttpApiRemoteTemporalKind {
246
+ /** A calendar date with no time — SOQL `date`, a NetSuite date column. */
247
+ DATE = 'date',
248
+ /** An instant — SOQL `dateTime`, a NetSuite datetime column. */
249
+ DATE_TIME = 'date-time',
250
+ }
251
+
252
+ /**
253
+ * Local-to-remote field name mapping for fields whose names differ. Fields not listed map by
254
+ * identity (same name both sides). Key components are declared in `keyFields`, not here.
255
+ *
256
+ * A REST_JSON statement read that FILTERS a temporal field lists it here — with the same name on both sides
257
+ * when they agree — to declare its `temporalKind`.
258
+ */
259
+ export const HttpApiFieldMappingSchema = z.object({
260
+ localField: z.string().min(1),
261
+ remoteField: z.string().min(1),
262
+ /** The remote column's temporal kind, when a statement compares it with a date — see {@link HttpApiRemoteTemporalKind}. */
263
+ temporalKind: z.enum(HttpApiRemoteTemporalKind).optional(),
264
+ });
265
+ ```
266
+
267
+ ### Origin Package: `@wildo-ai/saas-models`
268
+
269
+ ```typescript
270
+ /**
271
+ * Where a declared REST parameter is placed on the request, when the method's own answer is wrong for it (#1686).
272
+ */
273
+ export enum HttpApiRestParameterPlacement {
274
+ /**
275
+ * The URL query string, whatever the method — NetSuite's SuiteQL `limit` and `offset` on a POST.
276
+ * spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
277
+ * statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
278
+ */
279
+ QUERY_STRING = 'query-string',
280
+ }
281
+
282
+ /**
283
+ * REST_JSON per-operation declaration: how one read-family member maps onto a concrete HTTP
284
+ * operation. Deliberately minimal in slice 1 — pagination/filter parameter NAMES are declared,
285
+ * their VALUES are supplied by the adapter from the translated query.
286
+ *
287
+ * Related but distinct: `ProviderRestOperation` on a provider's `rest` runtime contract describes a
288
+ * VENDOR operation — one entry in the catalogue a reference below names. This schema describes a
289
+ * RESOURCE read surface, which is a different thing and stays here.
290
+ *
291
+ * (An earlier revision pointed at `REST_API_OperationSpecSchema` in
292
+ * `@wildo-ai/external-connectors-models` "for capability transformers". Both are gone: the
293
+ * transformer layer was retired with `features/` in #327, and that OpenAPI-shaped operations layer
294
+ * — ten exported symbols with zero code readers — was deleted in #331 rather than wired up, so
295
+ * "what a provider can do" has one description instead of two.)
296
+ *
297
+ * The convergence performed in S3a (#331) — a member naming an operation in a PROVIDER's own
298
+ * catalogue — was UNDONE in #1055. A system of record is not a connector (D10), and a read that
299
+ * depends on a provider catalogue being loadable is the crossing that decision forbids. An inline
300
+ * spec is now the only form, which is what every authored binding used anyway.
301
+ */
302
+ /**
303
+ * A query LANGUAGE a REST system of record reads through, rather than a set of filter parameters
304
+ * (#1293).
305
+ *
306
+ * Two vendors read this way and neither can be expressed as parameters: Salesforce takes SOQL and
307
+ * NetSuite takes SuiteQL, each as ONE statement naming the fields, the entity, the predicates and
308
+ * the order. A `filterParams` map cannot say "SELECT these columns FROM that object", so without this
309
+ * neither vendor can be declared at all.
310
+ *
311
+ * ## Why this is a closed vocabulary and not a template string
312
+ *
313
+ * A statement is BUILT, and building means escaping. Each language has its own literal rules and its
314
+ * own paging spelling, and a template with `{filter}` holes would put the escaping in the author's
315
+ * hands — an injection surface in a file nobody reviews as one. The engine builds the statement and
316
+ * the vocabulary names which grammar to build.
317
+ *
318
+ * This is the same trade the OData compiler already makes for `$filter`: expressions are composed
319
+ * here, literals are escaped by one function, and no authored string reaches the wire uninspected.
320
+ */
321
+ export enum HttpApiQueryStatementLanguage {
37
322
  /**
38
- * OData **v4** — one generic client: mechanical pushdown of
39
- * `$filter`/`$select`/`$top`/`$skip`/`$orderby`/`$count`, with a `$metadata` boot-time
40
- * verification probe of the committed declaration.
323
+ * Salesforce Object Query Language.
41
324
  *
42
- * ⚠ **This member is v4 ONLY, and that excludes SAP's most-used API.** An earlier revision of
43
- * this comment named "SAP S/4HANA, Microsoft Dataverse/Dynamics 365" here, which is half right
44
- * and was load-bearing — it is why nobody looked:
325
+ * spec-cite: Salesforce Developers, "SOQL and SOSL Reference" —
326
+ * https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/
45
327
  *
46
- * | Target | Version | Consumable today |
47
- * |---|---|---|
48
- * | Microsoft Dataverse / Dynamics 365 Web API (`/api/data/v9.2/`) | v4 | ✅ |
49
- * | SAP S/4HANA OData **v4** services (`/sap/opu/odata4/…`) | v4 | ✅ |
50
- * | SAP `API_BUSINESS_PARTNER` (`/sap/opu/odata/sap/API_BUSINESS_PARTNER`) | **v2** | ❌ |
328
+ * `SELECT *` does not exist: every field is named, which the binding's `fieldMappings` and key
329
+ * fields already supply. Paging is by the response's own continuation rather than by `OFFSET`,
330
+ * which SOQL bounds at 2000 rows.
331
+ */
332
+ SOQL = 'soql',
333
+ /**
334
+ * NetSuite SuiteQL — an SQL-92 dialect over its analytics schema.
51
335
  *
52
- * v2 is not a v4 variant with a different header. Its collection envelope is
53
- * `{ "d": { "results": [...], "__next": …, "__count": … } }` rather than
54
- * `{ "value": [...], "@odata.nextLink": … }`; `Edm.DateTime` serializes as `"/Date(<ticks>)/"`
55
- * rather than ISO 8601; `Edm.Decimal` and `Edm.Int64` serialize as JSON STRINGS rather than
56
- * numbers; and JSON must be requested (`$format=json`) because v2 defaults to Atom/XML. So it
57
- * changes the envelope, the paging property, the count property AND the value encoding — a
58
- * reader written for one cannot read the other, and the mapping layer needs coercions the way
59
- * Odoo needs `ODOO_FALSE_AS_NULL`.
60
- * spec-cite: OData Version 2.0 JSON Format
61
- * (https://www.odata.org/documentation/odata-version-2-0/json-format/) — the `d`/`results`/
62
- * `__next`/`__count` envelope, the `/Date(<ticks>)/` DateTime literal, and Edm.Decimal /
63
- * Edm.Int64 "formatted as a JSON string".
336
+ * spec-cite: Oracle NetSuite, "SuiteQL" —
337
+ * https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156257770590.html
64
338
  *
65
- * Supporting v2 is an OPEN decision, not an oversight. Until it lands, point an ODATA binding at
66
- * a v4 service: for SAP that means the OData v4 edition of the API where one is published.
339
+ * Paged by `limit` / `offset` QUERY parameters rather than inside the statement, which is why the
340
+ * statement declaration and `pagingParams` are independent.
67
341
  */
68
- ODATA = 'odata',
342
+ SUITEQL = 'suiteql',
343
+ }
69
344
 
345
+ /**
346
+ * Where a KEYSET page's size bound goes, per statement language (#1686).
347
+ *
348
+ * A keyset page is "the next N rows after the last key", so the statement's predicate and order are
349
+ * the same in every language — `<key> > <last key> … ORDER BY <key> ASC` — and only the size bound
350
+ * differs. Decided by the LANGUAGE, never declared by an author: it is a fact about the grammar.
351
+ */
352
+ export enum HttpApiKeysetPageBound {
70
353
  /**
71
- * Declared per-binding REST/JSON operation mapping (bespoke enterprise APIs). Unlike ODATA
72
- * there is no generic client: each binding declares how read/list/count/search map onto
73
- * concrete HTTP operations.
354
+ * The statement carries `LIMIT <n>` itself — SOQL, which has no size parameter on `/query`.
355
+ *
356
+ * The vendor may still split the limited result into several BATCHES and answer the first one with
357
+ * a continuation (`nextRecordsUrl`), so a keyset page on this bound follows the operation's declared
358
+ * `cursorPath` inside the page until the result is exhausted — which is why the bound requires one.
359
+ * Without it, a batch shorter than the limit would read as the end of the pass and every row after
360
+ * it would go unread, and a DELETE orphan policy would then delete them.
361
+ * spec-cite: Salesforce REST API Developer Guide v68.0, "Query" — "up to 2,000 records can be returned
362
+ * at a time … the returned batch can include fewer records than the limit or what's set in the
363
+ * request … If the total number of results exceeds the limit or the requested number of results, the
364
+ * response contains the first batch of records, a false value for done, and a query locator."
74
365
  */
75
- REST_JSON = 'rest-json',
76
-
366
+ STATEMENT_LIMIT_CLAUSE = 'statement-limit-clause',
77
367
  /**
78
- * Odoo's external API (`/jsonrpc` + `execute_kw`). Promoted to its OWN dialect 2026-08-27 —
79
- * D0's original "JSON-RPC is a thin envelope variant of REST_JSON" was corrected by measuring
80
- * the protocol: it is generic like ODATA (no per-binding operation declarations — the model
81
- * name IS `entityRef`, and read/list/count map onto `read`/`search_read`/`search_count`
82
- * mechanically), but it speaks POSITIONAL arguments, its own domain filter language
83
- * (`[['field','=',value], …]` with polish-notation `'|'` disjunction), and authenticates
84
- * INSIDE the RPC args (`execute_kw(db, uid, api_key, …)`) rather than via HTTP headers.
85
- * Forcing that through REST_JSON's declared-parameter model would have been the
86
- * merge-distinct-concepts failure `design-philosophy.md` forbids.
368
+ * The operation's declared `pagingParams.limitParam` carries the size, and its `offsetParam` is sent
369
+ * as 0 on every page — SuiteQL, which pages by `limit`/`offset` query parameters.
87
370
  *
88
- * Structural constraint (schema-enforced): exactly ONE key field with the `INTEGER` codec —
89
- * Odoo row ids are integers, always.
371
+ * Offset 0 always: each page is a NEW query that starts after the last key, so no offset is ever
372
+ * needed, and none of the offset rules (an offset divisible by the limit, the result ceiling) is
373
+ * ever reached.
374
+ * spec-cite: Oracle NetSuite, "Collection Paging" (section_156414087576) — "You can only set offset
375
+ * and limit values in a way that the offset is divisible by the limit"; "Executing SuiteQL Queries
376
+ * Through REST Web Services" (section_157909186990) — "Using SuiteQL queries, you can return a
377
+ * maximum of 100,000 results."
90
378
  */
91
- ODOO_JSONRPC = 'odoo-jsonrpc',
379
+ LIMIT_PARAMETER = 'limit-parameter',
92
380
  }
93
381
 
94
- // --------------------------------
95
- // Identity mode (whose identity reaches the target)
96
- // --------------------------------
382
+ /** The page bound of each statement language. A `Record` over the enum, so a new language is a compile error until it has one. */
383
+ export const HTTP_API_KEYSET_PAGE_BOUND: Readonly<Record<HttpApiQueryStatementLanguage, HttpApiKeysetPageBound>> = {
384
+ [HttpApiQueryStatementLanguage.SOQL]: HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE,
385
+ [HttpApiQueryStatementLanguage.SUITEQL]: HttpApiKeysetPageBound.LIMIT_PARAMETER,
386
+ };
387
+
388
+ /**
389
+ * The key codecs a keyset may walk (#1686): an INTEGER compares as a number and a STRING by code
390
+ * unit, and the engine CHECKS every served page against that order before trusting its last key.
391
+ *
392
+ * GUID and DATETIME_ISO are refused. A GUID has no order the vendors agree on — SQL Server sorts a
393
+ * `uniqueidentifier` by its last bytes first — so a page could never be checked; a datetime is not
394
+ * unique, and a keyset on a non-unique column skips the rows that share the boundary value.
395
+ */
396
+ export const HTTP_API_KEYSET_ELIGIBLE_CODECS: readonly HttpApiKeyComponentCodec[] = [
397
+ HttpApiKeyComponentCodec.INTEGER,
398
+ HttpApiKeyComponentCodec.STRING,
399
+ ];
400
+
401
+ /**
402
+ * A declared KEYSET on a statement read (#1686) — what lets a REST system of record feed a pipeline.
403
+ *
404
+ * ## What it makes the engine build
405
+ *
406
+ * For the pipeline's extraction, the `list` member's statement becomes
407
+ *
408
+ * ```
409
+ * SELECT <mapped fields> FROM <entity> WHERE <sourceFilter> AND <key> > <last key> ORDER BY <key> ASC
410
+ * ```
411
+ *
412
+ * with the page size bounded per {@link HttpApiKeysetPageBound} (SOQL `LIMIT <n>`; SuiteQL
413
+ * `limit=<n>&offset=0`). The last key of each page is the pipeline's persisted cursor, and a page
414
+ * shorter than asked ends the pass — the Odoo id-keyset discipline, drift-safe for the same reason: a
415
+ * row inserted or deleted mid-pass never shifts the rows after the cursor, so none is skipped or read
416
+ * twice. Offset paging has neither property, which is why a REST source without a keyset stays
417
+ * refused.
418
+ *
419
+ * ## Why there is no cursor PLACEHOLDER to write
420
+ *
421
+ * The statement is BUILT by the engine (#1293), never templated by an author, so there is nowhere for a
422
+ * `:cursor` placeholder to go and no ORDER BY an author could forget: declaring the keyset is what puts
423
+ * both into the statement, and the engine writes them itself. What an author declares is only which
424
+ * column the walk runs on.
425
+ *
426
+ * ## Which column
427
+ *
428
+ * The binding's ONE key field — unique and immutable, which is what a keyset needs. Named by its
429
+ * remote field; its codec is the key field's own, so the two cannot disagree. A composite key is
430
+ * refused: one component of it is not unique.
431
+ *
432
+ * ## A vendor continuation is followed INSIDE a page, never persisted
433
+ *
434
+ * Salesforce's `nextRecordsUrl` names a server-side query locator. How long a locator lives is not
435
+ * stated in the REST API guide (UNVERIFIED), so it is never the cross-run cursor: the key is.
436
+ */
437
+ export const HttpApiQueryStatementKeysetSchema = z.strictObject({
438
+ /** The remote field of the binding's single key field — Salesforce `Id`, NetSuite `id`. */
439
+ keyRemoteField: z.string().min(1),
440
+ });
441
+ export type HttpApiQueryStatementKeyset = z.infer<typeof HttpApiQueryStatementKeysetSchema>;
97
442
 
98
443
  /**
99
- * Whose identity the adapter presents to the target system. In BOTH modes audit rows carry the
100
- * REAL initiating user — the shared-principal attribution failure documented for Power Platform
101
- * ("credential-sharing as a service") must not be reproduced (requirement R12).
102
- *
103
- * D9 ruling (Paul, 2026-08-27 — re-scoping the original "both executable in slice 1"):
104
- * **SERVICE_PRINCIPAL-first.** `USER_DELEGATED` stays DECLARED and representable so bindings
105
- * need no reshape when it arrives, but resolving it REFUSES naming the missing substrate: the
106
- * engine has no outbound per-user token store (measured — `OAuth2_CredentialSchema` is a model
107
- * with no resource, persistence or service behind it). Building that store is its own workstream.
444
+ * How a read member builds and sends a query STATEMENT (#1293).
445
+ *
446
+ * Declared per operation rather than per binding, because a vendor's `read` and `list` genuinely
447
+ * differ: Salesforce addresses one record at `/sobjects/Account/{key}` and queries collections
448
+ * through `/query`, and only the second is a statement at all.
108
449
  */
109
- export enum HttpApiIdentityMode {
450
+ export const HttpApiQueryStatementSpecSchema = z.object({
451
+ language: z.enum(HttpApiQueryStatementLanguage),
110
452
  /**
111
- * One service account per binding (never shared across applications — blast-radius doctrine).
112
- * Wildo's own roles/operations gate who may trigger calls. The default, and the only option
113
- * when the target has no per-user OAuth surface.
453
+ * The parameter or body member the statement is placed in (`q` for both vendors surveyed).
454
+ *
455
+ * WHERE it lands is not declared, because the operation's own `method` already decides: a GET puts
456
+ * parameters in the query string and a POST puts them in the JSON body, which is what the request
457
+ * builder has always done. A `placement` field was drafted here and removed before it shipped — it
458
+ * would have been a second declaration of something the method already says, free to disagree with
459
+ * it. Salesforce is a GET with `?q=`, NetSuite a POST with `{"q": …}`, and neither needs to be told
460
+ * twice. PAGING is the one parameter the method places wrongly for a vendor — NetSuite reads its
461
+ * `limit`/`offset` from the URL of that POST — which is why `pagingParams` carries its own
462
+ * `placement` (#1686) while the statement does not.
463
+ */
464
+ parameterName: z.string().min(1),
465
+ /**
466
+ * The object the statement selects FROM. Absent = the binding's `entityRef`, which is the ordinary
467
+ * case; present when the vendor's query schema names an object differently from its REST resource.
114
468
  */
115
- SERVICE_PRINCIPAL = 'service-principal',
469
+ fromEntity: z.string().min(1).optional(),
470
+ /**
471
+ * The KEYSET a pipeline extraction walks (#1686) — see {@link HttpApiQueryStatementKeysetSchema}.
472
+ * Declared on the `list` member only. Absent = the binding can be read through, and cannot feed a
473
+ * pipeline.
474
+ */
475
+ keyset: HttpApiQueryStatementKeysetSchema.optional(),
476
+ });
477
+ export type HttpApiQueryStatementSpec = z.infer<typeof HttpApiQueryStatementSpecSchema>;
478
+
479
+ export const HttpApiRestOperationSpecSchema = z.object({
480
+ /** HTTP method for this read-family operation. */
481
+ method: z.enum(HttpApiRestOperationMethod),
116
482
 
117
483
  /**
118
- * Per-user OAuth 2.0 tokens against the target — encrypted, session-bound (the Retool model;
119
- * on-behalf-of where the IdP is shared, e.g. Entra ID for Dynamics). Use when the TARGET's own
120
- * authorization must decide per user: the tool can then never show a user more than the target
121
- * would.
484
+ * Path template relative to the provider's base URL. `{key}` interpolates the synthesized
485
+ * key's remote addressing form; other `{param}` tokens must be declared parameter names.
122
486
  */
123
- USER_DELEGATED = 'user-delegated',
124
- }
487
+ pathTemplate: z.string().min(1),
125
488
 
126
- // --------------------------------
127
- // Erasure stance (GDPR Art. 17 on rows we do not own)
128
- // --------------------------------
489
+ /** Query/body parameter names for pagination, when the operation supports it. */
490
+ pagingParams: z
491
+ .object({
492
+ limitParam: z.string().min(1),
493
+ offsetParam: z.string().min(1),
494
+ /**
495
+ * Where the two paging parameters go (#1686). Absent = where the operation's method puts every
496
+ * parameter: the query string of a GET, the JSON body of a POST.
497
+ *
498
+ * NetSuite is why this exists: its SuiteQL read is a POST whose BODY is the statement and whose
499
+ * paging is in the URL, so a method-placed `limit` lands in the body, where the vendor does not
500
+ * read it, and the page is not bounded at all.
501
+ */
502
+ placement: z.enum(HttpApiRestParameterPlacement).optional(),
503
+ })
504
+ .optional(),
129
505
 
130
- /**
131
- * The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
132
- * from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
133
- * registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
134
- * "we cannot delete rows we do not own" is not an answer the framework may imply silently.
135
- */
136
- export enum HttpApiErasureStance {
137
506
  /**
138
- * (6a) The resource declares it holds NO personal/subject data. Registration verifies the
139
- * declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
140
- * the remote rows.
507
+ * Declared filter parameter name per LOCAL field. Only fields listed here are translatable for
508
+ * this operation (scope-down paper, shape T3); everything else is refused at the adapter
509
+ * boundary.
141
510
  */
142
- NO_SUBJECT_DATA = 'no-subject-data',
511
+ filterParams: z.record(z.string().min(1), z.string().min(1)).optional(),
143
512
 
144
513
  /**
145
- * (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
146
- * engine invokes on a subject-erasure request. This is a single declared write and does NOT
147
- * require general write support (slice 1 stays read-only otherwise).
514
+ * The parameter that receives the SEARCH text (T4), for a `search` operation. Absent =
515
+ * search is refused for this binding even when the operation exists.
148
516
  */
149
- EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
517
+ searchParam: z.string().min(1).optional(),
150
518
 
151
519
  /**
152
- * (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
153
- * lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
154
- * administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
155
- * is the control. NEVER a standing default — the acknowledgement is per erasure request.
520
+ * Dot-path to the payload inside the response body — the rows array (list/search), the entity
521
+ * object (read), or the number (count). Absent = the body IS the payload. Declared, never
522
+ * sniffed: response shapes vary per target (`items`, `result`, `value`, raw array) and a wrong
523
+ * guess would silently read zero rows.
156
524
  */
157
- CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
158
- }
525
+ resultPath: z.string().min(1).optional(),
159
526
 
160
- // --------------------------------
161
- // Tenancy stance
162
- // --------------------------------
527
+ /** Wrap request/response in a JSON-RPC 2.0 envelope (the Odoo variant). */
528
+ jsonRpcEnvelope: z
529
+ .object({
530
+ rpcMethod: z.string().min(1),
531
+ })
532
+ .optional(),
163
533
 
164
- /**
165
- * How tenant confinement is enforced against the remote system (requirements R4/R16).
166
- */
167
- export enum HttpApiTenancyStance {
168
534
  /**
169
- * The engine's contextual scope predicate is pushed down into every remote query against a
170
- * declared remote field. Registration REFUSES a binding whose declared surface cannot express
171
- * the scope predicate — a query-time refusal would be a data leak one missed branch away.
535
+ * Read through a query STATEMENT rather than through filter parameters (#1293).
536
+ *
537
+ * Mutually exclusive with `filterParams` and `searchParam` in practice rather than by schema: a
538
+ * statement expresses its own predicates, so a declaration carrying both has said the same thing
539
+ * twice in two grammars. The compiler refuses that pairing, where it can name which one it was
540
+ * about to ignore.
172
541
  */
173
- SCOPE_FILTER_PUSHDOWN = 'scope-filter-pushdown',
542
+ statement: HttpApiQueryStatementSpecSchema.optional(),
174
543
 
175
544
  /**
176
- * The binding declares the target system serves exactly ONE tenant (the normal case for an
177
- * internal tool on one enterprise's IS). Scope pushdown is then N/A by declaration — an
178
- * explicit, audited stance, never an inferred one (R16).
545
+ * Dot-path to a CONTINUATION URL in the response — Salesforce's `nextRecordsUrl` (#1293).
546
+ *
547
+ * Declared rather than sniffed, for the same reason `resultPath` is: response shapes vary per
548
+ * target and a wrong guess reads zero rows silently. Absent means the operation pages by
549
+ * `pagingParams` or not at all.
550
+ *
551
+ * A continuation is followed only on the target's OWN origin, exactly as the OData one is — the
552
+ * link comes from a remote response body and carries this deployment's credentials wherever it
553
+ * points.
179
554
  */
180
- SINGLE_TENANT_BINDING = 'single-tenant-binding',
181
- }
555
+ cursorPath: z.string().min(1).optional(),
182
556
 
183
- // --------------------------------
184
- // Key declaration + component codecs (paper A)
185
- // --------------------------------
557
+ /**
558
+ * Headers this vendor requires on the request — NetSuite's `Prefer: transient` (#1293).
559
+ *
560
+ * VENDOR headers only. A credential never goes here: credentials come from the instance's access,
561
+ * and a header authored in a binding would be a second credential channel in a file that is
562
+ * committed. The compiler refuses an `authorization` key by name rather than trusting the author.
563
+ */
564
+ staticHeaders: z.record(z.string().min(1), z.string().min(1)).optional(),
565
+ });
566
+
567
+ export type HttpApiRestOperationSpec = z.infer<typeof HttpApiRestOperationSpecSchema>;
568
+ ```
186
569
 
570
+ ### Origin Package: `@wildo-ai/saas-models`
571
+
572
+ ```typescript
187
573
  /**
188
- * Per-component value normalization for key synthesis. The codec is what makes the synthesized
189
- * `_id` STABLE: every component must round-trip byte-identically between the remote
190
- * representation and the encoded id, or the same remote row would answer to different ids.
191
- *
192
- * `INTEGER` and `GUID` are the two codecs whose entire value space is URL-unreserved-safe, which
193
- * is what qualifies a single-key binding for the VERBATIM id form (see
194
- * `httpApiBindingUsesVerbatimKey`).
574
+ * The fields EVERY binding carries, whatever its dialect — spread into each arm of the union below.
195
575
  */
196
- export enum HttpApiKeyComponentCodec {
197
- /** Arbitrary remote string. NOT charset-safe → always participates via the encoded id form. */
198
- STRING = 'string',
576
+ const httpApiResourceBindingBaseShape = {
577
+ /**
578
+ * The SYSTEM OF RECORD this resource lives in, by the NAME the application declared it under in
579
+ * `wildo.saas.config.ts` (`systemsOfRecord.<name>`, #1055).
580
+ *
581
+ * ## Why a name, and not a provider ref
582
+ *
583
+ * `providerRef` named a PROVIDER, and a provider's env-var names live in its module — so one ref
584
+ * was one deployment, and a second Odoo was unrepresentable. A name here is an INSTANCE: two
585
+ * (`odoo-fr`, `odoo-de`) share one vendor facet and differ only in the environment variables their
586
+ * names derive. It is also not a provider in any other sense (D10): nothing here is selected
587
+ * through the capability plane, carries a person's lent credential, or has an operation catalogue.
588
+ *
589
+ * ## What validates it, and where
590
+ *
591
+ * Not here, and not in the resource factory — the factory runs in the application's `shared-lib`,
592
+ * where the saas configuration is not in scope. The factory checks SHAPE; the boot registry checks
593
+ * that this name is DECLARED and that `dialect` below equals the instance's, at the first moment
594
+ * both are visible. That split is the honest one rather than a compromise.
595
+ */
596
+ system: z.string().min(1),
199
597
 
200
- /** Integer key (Odoo `id`, SAP numeric keys). Digits only → verbatim-eligible. */
201
- INTEGER = 'integer',
598
+ /**
599
+ * The remote entity addressed by this binding — an OData entity-set name, or a logical name for
600
+ * a REST_JSON surface. One binding, one remote entity set.
601
+ */
602
+ entityRef: z.string().min(1),
202
603
 
203
- /** GUID/UUID key (Dataverse row ids). Hex + dashes → verbatim-eligible. */
204
- GUID = 'guid',
604
+ /*
605
+ * `connection` was here, and it is GONE (#1055 D12).
606
+ *
607
+ * It declared WHOSE ACCOUNT a binding spends — `ORGANIZATION × USER` and its siblings — which is a
608
+ * real question for a CONNECTOR, where a customer connects their own account. A system of record is
609
+ * not that: it is a deployment the application reads its own business rows out of, with its own
610
+ * service identity, and the only honest answer was always `APPLICATION × SERVICE`. A field with one
611
+ * legal value is a question nobody should be asked.
612
+ *
613
+ * The customer-connection case is case 2 of #1049 and keeps the connector resolver, untouched.
614
+ */
615
+
616
+ /** Ordered key declaration — the source of the synthesized engine-facing `_id` (paper A). */
617
+ keyFields: z.array(HttpApiKeyFieldSchema).min(1),
618
+
619
+ /** Non-key field name mappings; unlisted fields map by identity. */
620
+ fieldMappings: z.array(HttpApiFieldMappingSchema).default([]),
621
+
622
+ /*
623
+ * `tenancy` was here, and it is GONE (#1055 §5).
624
+ *
625
+ * Both of its stances were wrong for a system of record. `SCOPE_FILTER_PUSHDOWN` sent WILDO's own
626
+ * organization id to the remote as a filter value — an id the remote has never heard of — and
627
+ * `SINGLE_TENANT_BINDING` became the only truth, which makes it a declaration with one legal answer.
628
+ *
629
+ * What replaced it is not a smaller field but a different mechanism: the row projector STAMPS the
630
+ * owner organization's id onto every remote row, so the per-row tenant gate passes with no exemption
631
+ * and a read under another organization's URL is refused by the gate that already existed.
632
+ * Partitioning a system of record BY organization unit returns in #1058, as a property of the
633
+ * INSTANCE and its vendor facet rather than of each binding.
634
+ */
635
+
636
+ /** Erasure stance (D6) — required; no silent default. */
637
+ erasure: HttpApiErasureDeclarationSchema,
205
638
 
206
639
  /**
207
- * Date/time key component, normalized to the RFC 3339 / ISO 8601 UTC string form before
208
- * encoding. NOT verbatim-eligible (`:` is forbidden in ids — websocket room names are
209
- * colon-parsed).
640
+ * The processing PURPOSES this data flow serves (#1745) — each a `purposeRef` of
641
+ * `operatorComplianceIdentity.lawfulBases` in `wildo.saas.config.ts`. Absent = none linked.
642
+ *
643
+ * A system of record is where an application OBTAINS personal data it did not collect from the person, and a
644
+ * privacy notice then owes the purpose and the legal basis for it (GDPR Art. 14(1)(c)) beside the source (Art.
645
+ * 14(2)(f)). The source and the categories are derived from this binding; the purpose is the one thing the
646
+ * framework cannot infer from what the data is, so it is LINKED here, per binding, rather than typed into a
647
+ * notice. The same link a provider's compliance choice carries (#1709), for the same reason.
648
+ *
649
+ * Checked where both halves are visible — the document facts and the evidence collector — and a ref naming no
650
+ * declared purpose is REPORTED there as a broken link, never refused: the factory runs in `shared-lib`, where the
651
+ * lawful bases are not in scope, and a compliance link must never stop the application from starting.
210
652
  */
211
- DATETIME_ISO = 'datetime-iso',
212
- }
653
+ purposeRefs: z.array(z.string().trim().min(1)).optional(),
654
+
655
+ /**
656
+ * The row-level writes this binding OPENS toward its system of record (#1679). Absent = none: the
657
+ * binding is read-only, which is what every binding authored before #1679 declared implicitly.
658
+ *
659
+ * Opening a verb is not enough to write. The resource must also declare the matching operation
660
+ * (the factory refuses either without the other), the dialect must implement writes (the boot
661
+ * registration refuses a verb its dialect cannot send, naming the dialect), and every write
662
+ * variant carries a REQUIRED `Idempotency-Key`, because a remote write cannot be rolled back and
663
+ * a retried request must replay its first outcome rather than write twice.
664
+ */
665
+ writableVerbs: z.array(z.enum(HttpApiWriteVerb)).default([]),
666
+
667
+ /**
668
+ * How an opened UPDATE is protected against overwriting a change made since its author read the row (#1724). See
669
+ * {@link HttpApiWriteConcurrencyMode} for the two answers and the limit of the first.
670
+ *
671
+ * REQUIRED when the binding opens UPDATE — on ODOO_JSONRPC (#1724), ODATA (#1726) and REST_JSON (#1728) alike — and
672
+ * refused when the binding opens no UPDATE — a concurrency stance on a door that is shut decides nothing. `versionField` names the LOCAL field that
673
+ * carries the version: it must map onto the vendor facet's `rowVersionField` (checked at boot, where the facet is
674
+ * visible) — Odoo `write_date`, an OData service's `@odata.etag` — and the resource's schema must let an UPDATE carry
675
+ * it and keep a CREATE from sending it (checked by the resource factory).
676
+ */
677
+ writeConcurrency: z.discriminatedUnion('mode', [
678
+ z.strictObject({
679
+ mode: z.literal(HttpApiWriteConcurrencyMode.VERSION_CHECKED),
680
+ /** The LOCAL field carrying the row version the caller read — never written to the remote. */
681
+ versionField: z.string().min(1),
682
+ }),
683
+ z.strictObject({ mode: z.literal(HttpApiWriteConcurrencyMode.LAST_WRITER_WINS) }),
684
+ ]).optional(),
685
+
686
+ /**
687
+ * The vendor ACTIONS this binding declares toward its system of record (#1678) — named operations that are not row
688
+ * writes: posting an invoice, confirming an order, an OData bound or unbound action. Absent = none.
689
+ *
690
+ * Declared here rather than on the instance for the reasons `system-of-record-actions.shared.schemas.ts` records: an
691
+ * action carries a Zod input schema and the roles admitted to it, both of which live in `shared-lib` beside this
692
+ * binding. An action runs only through the system-of-record action executor, under the instance's service identity,
693
+ * confined to the owner organization and to the caller's partition, and audited on every outcome. It is reached over
694
+ * HTTP only through a custom operation of this resource whose implementation calls the executor.
695
+ */
696
+ actions: SystemOfRecordActionDeclarationsSchema.optional(),
697
+
698
+ /** Remote-call semantics (D10/R15). */
699
+ remoteCallSemantics: HttpApiRemoteCallSemanticsSchema.default({
700
+ timeoutMs: 10_000,
701
+ retry: { maxAttempts: 2, backoffMs: 500 },
702
+ maxIdSetSize: 50,
703
+ maxPartitionSetSize: 200,
704
+ }),
705
+ };
213
706
  ```
214
707
 
215
708
  ### Origin Package: `@wildo-ai/saas-models`
@@ -219,17 +712,34 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
219
712
  z.object({
220
713
  dialect: z.literal(HttpApiTransportDialect.ODATA),
221
714
  ...httpApiResourceBindingBaseShape,
222
- /**
223
- * Verify the committed declaration against the live `$metadata` at boot (decision D5 —
224
- * drift is detected at boot and the fix is re-authoring, never silent adaptation). Opt out
225
- * only for targets that genuinely do not serve `$metadata`.
715
+ /*
716
+ * `verifyMetadataAtBoot` was here, and it is GONE (#1055 §5).
717
+ *
718
+ * It had ZERO non-test readers — measured, not assumed — so nothing ever probed `$metadata` at
719
+ * boot whatever it was set to. It also asked for exactly what the registry above it must never
720
+ * do: dial the remote during startup, where an ERP outage would stop an application booting
721
+ * (`continuity-drift-and-cas-basis.md` Rule 3).
722
+ *
723
+ * The drift probe it promised EXISTS, on the extraction source, reached through the operator door
724
+ * (`external-data-extraction-source.backend.ts`) — where a human is present and a refusal is
725
+ * something somebody can act on.
726
+ */
727
+ }),
728
+ z.object({
729
+ /*
730
+ * OData v2 (#1687) — generic like ODATA: the entity set IS `entityRef`, and read/list/count map mechanically. Its
731
+ * own arm rather than a flag on ODATA because the compiler, the envelope and the value encoding all differ.
226
732
  */
227
- verifyMetadataAtBoot: z.boolean().default(true),
733
+ dialect: z.literal(HttpApiTransportDialect.ODATA_V2),
734
+ ...httpApiResourceBindingBaseShape,
228
735
  }),
229
736
  z.object({
230
737
  dialect: z.literal(HttpApiTransportDialect.REST_JSON),
231
738
  ...httpApiResourceBindingBaseShape,
232
- /** The declared read surface — absent members are refused, never emulated. */
739
+ /**
740
+ * The declared read surface, and the declared request of each row write the binding opens (#1728) — absent members
741
+ * are refused, never emulated.
742
+ */
233
743
  operations: HttpApiRestOperationsSchema,
234
744
  }),
235
745
  z.object({
@@ -243,6 +753,92 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
243
753
  }),
244
754
  ]);
245
755
 
756
+ /**
757
+ * A declared statement keyset must be one the engine can walk (#1686). Every refusal names the fix.
758
+ *
759
+ * Checked on the BINDING rather than only on a pipeline, so a keyset declared on a read-through
760
+ * resource is refused the same way: a declaration that says something false is refused wherever it
761
+ * is written, not only where it is used.
762
+ */
763
+ function assertRestJsonKeysetCoherence(keyFields: readonly HttpApiKeyField[], operations: HttpApiRestOperations): void {
764
+ for (const [member, declaration] of Object.entries(operations) as Array<[string, HttpApiRestOperationSpec | undefined]>) {
765
+ /*
766
+ * A statement on `read` is never sent (#1972 review): a key-addressed read is a path with `{key}` — Salesforce's
767
+ * `/sobjects/Account/{key}` — and `compileRestJsonKeyAddressedRead` reads no statement. Declared there it would
768
+ * look like it shapes the read and shape nothing, and it would admit a `temporalKind` that nothing reads.
769
+ */
770
+ if (member === 'read' && declaration?.statement !== undefined) {
771
+ throw new Error(
772
+ 'operations.read.statement: a key-addressed read is its `pathTemplate` with `{key}`, and sends no statement — declare the '
773
+ + 'statement on `list` (or `search` / `count`), where collection reads are built.',
774
+ );
775
+ }
776
+ /*
777
+ * SuiteQL is NetSuite's, and NetSuite reads a SuiteQL POST's paging from the URL (#1686). Placed by method, the
778
+ * `limit` lands in the body, the vendor applies its own default, and the page is not bounded — a read-through LIST
779
+ * then serves whole results, and a keyset page is refused at every run. Refused here, where the declaration is.
780
+ * spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
781
+ * statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
782
+ */
783
+ if (declaration?.statement?.language === HttpApiQueryStatementLanguage.SUITEQL
784
+ && declaration.method === HttpApiRestOperationMethod.POST
785
+ && declaration.pagingParams !== undefined
786
+ && declaration.pagingParams.placement !== HttpApiRestParameterPlacement.QUERY_STRING) {
787
+ throw new Error(
788
+ `operations.${member}.pagingParams: a SuiteQL read POSTs its statement in the body and is paged in the URL — declare `
789
+ + `\`placement: '${HttpApiRestParameterPlacement.QUERY_STRING}'\`, or the limit lands in the body and bounds nothing.`,
790
+ );
791
+ }
792
+ const keyset = declaration?.statement?.keyset;
793
+ if (declaration === undefined || keyset === undefined) continue;
794
+ if (member !== 'list') {
795
+ throw new Error(
796
+ `operations.${member}.statement.keyset: a keyset is what a pipeline walks a COLLECTION by, so it is declared on the 'list' member only.`,
797
+ );
798
+ }
799
+ if (keyFields.length !== 1) {
800
+ throw new Error(
801
+ `operations.list.statement.keyset: this binding declares ${keyFields.length} key components, and a keyset needs ONE unique column — `
802
+ + 'one component of a composite key is not unique, and a walk on it skips the rows that share its boundary value.',
803
+ );
804
+ }
805
+ const keyField = keyFields[0];
806
+ if (keyset.keyRemoteField !== keyField.remoteField) {
807
+ throw new Error(
808
+ `operations.list.statement.keyset.keyRemoteField: '${keyset.keyRemoteField}' is not this binding's key field ('${keyField.remoteField}'). `
809
+ + 'A keyset walks the row identity, which is the key field: unique and immutable, so no row can move behind the cursor.',
810
+ );
811
+ }
812
+ if (!HTTP_API_KEYSET_ELIGIBLE_CODECS.includes(keyField.codec)) {
813
+ throw new Error(
814
+ `operations.list.statement.keyset: the key field '${keyField.remoteField}' has the ${keyField.codec} codec, and a keyset walks `
815
+ + `${HTTP_API_KEYSET_ELIGIBLE_CODECS.join(' or ')} keys only — the engine checks each page against the key's order, and that `
816
+ + 'order must be one it can state.',
817
+ );
818
+ }
819
+ const bound = HTTP_API_KEYSET_PAGE_BOUND[declaration.statement!.language];
820
+ switch (bound) {
821
+ case HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE:
822
+ if (declaration.cursorPath === undefined) {
823
+ throw new Error(
824
+ `operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with LIMIT, and the vendor may still `
825
+ + 'answer the limited result in several batches. Declare the continuation (`cursorPath`, e.g. \'nextRecordsUrl\') so a page is '
826
+ + 'read to its end — a batch shorter than the limit would otherwise end the pass with rows unread.',
827
+ );
828
+ }
829
+ break;
830
+ case HttpApiKeysetPageBound.LIMIT_PARAMETER:
831
+ if (declaration.pagingParams === undefined) {
832
+ throw new Error(
833
+ `operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with the operation's limit parameter — `
834
+ + 'declare `pagingParams` (limitParam / offsetParam; the offset is always sent as 0).',
835
+ );
836
+ }
837
+ break;
838
+ }
839
+ }
840
+ }
841
+
246
842
  /**
247
843
  * Dialect-specific structural constraints that a discriminated union cannot express member-side.
248
844
  * Called by the resource-configuration factory AFTER the schema parse; throws with the offending
@@ -262,6 +858,123 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
262
858
  }
263
859
  }
264
860
 
861
+ /*
862
+ * A member naming a PROVIDER's catalogue operation is refused, and refused EXPLICITLY (#1055 D10).
863
+ *
864
+ * The schema alone would refuse it as an unknown key, with a message about `providerOperationId`
865
+ * not being expected — true, and useless to an author who reasonably believes the form still
866
+ * exists, because it did until this slice. So the refusal names what happened and where the shape
867
+ * went instead of letting the parse error carry it.
868
+ *
869
+ * This replaces an ambiguity check that existed for the opposite reason: while BOTH forms were
870
+ * legal, a member carrying both parsed as the inline one and dropped the reference silently.
871
+ */
872
+ if (binding.dialect === HttpApiTransportDialect.REST_JSON) {
873
+ for (const [member, declaration] of Object.entries(binding.operations)) {
874
+ if (declaration === undefined) continue;
875
+ if ((declaration as Record<string, unknown>).providerOperationId !== undefined) {
876
+ throw new Error(
877
+ `operations.${member}: a read member can no longer REFERENCE a provider's operation catalogue `
878
+ + '(`providerOperationId`). A system of record is not a connector, so its read surface is declared '
879
+ + 'INLINE here (method + pathTemplate) against the vendor facet.',
880
+ );
881
+ }
882
+ }
883
+ assertRestJsonKeysetCoherence(binding.keyFields, binding.operations);
884
+ }
885
+
886
+ // #1972 — a temporal kind is read by the REST_JSON statement compilers only; anywhere no statement is built it would
887
+ // decide nothing — a setting that looks like it controls date spelling and controls nothing.
888
+ const declaredTemporal = binding.fieldMappings.find((mapping) => mapping.temporalKind !== undefined);
889
+ if (declaredTemporal !== undefined) {
890
+ const readsThroughStatement = binding.dialect === HttpApiTransportDialect.REST_JSON
891
+ && Object.values(binding.operations).some((member) => (member as HttpApiRestOperationSpec | undefined)?.statement !== undefined);
892
+ if (!readsThroughStatement) {
893
+ throw new Error(
894
+ `fieldMappings('${declaredTemporal.localField}').temporalKind: declared on a ${binding.dialect} binding that reads through no query `
895
+ + '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.',
896
+ );
897
+ }
898
+ }
899
+
900
+ // #1679 — each opened verb once. A duplicate is not harmful by itself, but it is a declaration that
901
+ // says the same thing twice, which is the shape that drifts when one copy is edited.
902
+ if (new Set(binding.writableVerbs).size !== binding.writableVerbs.length) {
903
+ throw new Error(`writableVerbs: each verb may be opened once — got [${binding.writableVerbs.join(', ')}].`);
904
+ }
905
+
906
+ // #1724 — the concurrency stance of an opened UPDATE. A stance with no UPDATE decides nothing; an Odoo UPDATE with no
907
+ // stance would be last-writer-wins by an omission nobody reviewed, because Odoo's `write` takes no precondition.
908
+ const opensUpdate = binding.writableVerbs.includes(HttpApiWriteVerb.UPDATE);
909
+ if (binding.writeConcurrency !== undefined && !opensUpdate) {
910
+ throw new Error(
911
+ 'writeConcurrency: declared on a binding that opens no UPDATE — it governs updates only. Remove it, or open the update.',
912
+ );
913
+ }
914
+ if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODOO_JSONRPC) {
915
+ throw new Error(
916
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}', and Odoo's external API has no conditional write — `
917
+ + '`write(ids, vals)` applies the values whatever changed since they were read. State the stance: '
918
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to write_date>' } to refuse `
919
+ + `a stale version before sending (best-effort: it narrows the race, it does not close it), or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
920
+ );
921
+ }
922
+ // #1728 — a REST_JSON write is sent exactly as the binding declares it, so each opened verb needs its member and a
923
+ // member of a verb that is not opened is a declaration nothing sends. Both are refused, naming the member.
924
+ if (binding.dialect === HttpApiTransportDialect.REST_JSON) {
925
+ for (const verb of Object.values(HttpApiWriteVerb)) {
926
+ const member = binding.operations[verb];
927
+ const opened = binding.writableVerbs.includes(verb);
928
+ if (opened && member === undefined) {
929
+ throw new Error(
930
+ `operations.${verb}: this binding opens ${verb.toUpperCase()} toward '${binding.system}', and a REST_JSON write is sent `
931
+ + `exactly as declared — declare operations.${verb} (method + pathTemplate${verb === HttpApiWriteVerb.CREATE ? ' + createdKey' : ''}).`,
932
+ );
933
+ }
934
+ if (!opened && member !== undefined) {
935
+ throw new Error(
936
+ `operations.${verb}: declared on a binding that does not open ${verb.toUpperCase()} — nothing would ever send it. `
937
+ + `Open it in writableVerbs, or remove the member.`,
938
+ );
939
+ }
940
+ if (member !== undefined) {
941
+ assertHttpApiRestWriteOperationShape(member, {
942
+ member: verb,
943
+ ...HTTP_API_REST_WRITE_MEMBER_RULES[verb],
944
+ keyRemoteFields: binding.keyFields.map((keyField) => keyField.remoteField),
945
+ });
946
+ }
947
+ }
948
+ // Neither REST_JSON vendor's record API is written with a precondition, so an update's stance must be stated, as on Odoo.
949
+ if (opensUpdate && binding.writeConcurrency === undefined) {
950
+ throw new Error(
951
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}' over REST_JSON, which the engine writes with no `
952
+ + `precondition. State the stance: { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }, or `
953
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to the row version>' } — `
954
+ + 'best-effort, and available only when the vendor facet declares its row version field.',
955
+ );
956
+ }
957
+ }
958
+ // #1726 — an OData UPDATE is conditional only on a version the caller supplies; without a stance it would be
959
+ // last-writer-wins by an omission nobody reviewed, exactly as for Odoo.
960
+ if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODATA) {
961
+ throw new Error(
962
+ `writeConcurrency: this binding opens UPDATE toward '${binding.system}' over OData. State the stance: `
963
+ + `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to @odata.etag>' } to send the `
964
+ + 'entity tag the caller read as If-Match, so the service itself refuses a stale update (412) — available only when the '
965
+ + `vendor facet declares its entity tag as rowVersionField — or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
966
+ );
967
+ }
968
+ if (binding.writeConcurrency?.mode === HttpApiWriteConcurrencyMode.VERSION_CHECKED) {
969
+ const versionField = binding.writeConcurrency.versionField;
970
+ if (binding.keyFields.some((keyField) => keyField.localField === versionField)) {
971
+ throw new Error(`writeConcurrency.versionField: '${versionField}' is a key field — a row's version is not its address.`);
972
+ }
973
+ }
974
+
975
+ // #1678 — every declared action must be one this binding's dialect can call, on the target it names.
976
+ assertSystemOfRecordActionDeclarationsCoherence({ dialect: binding.dialect, actions: binding.actions });
977
+
265
978
  // D6 stance 6b — the declared erasure operation's FORM is dialect-specific. The union schema
266
979
  // admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
267
980
  // at authoring rather than on the first subject-erasure request:
@@ -271,6 +984,17 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
271
984
  // - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
272
985
  // the binding declares the exact call, like every other REST_JSON operation).
273
986
  if (binding.erasure.stance === HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION) {
987
+ /*
988
+ * #1687 — an OData v2 binding reads only. The explicit-erasure stance is a remote DELETE, which on SAP Gateway needs
989
+ * the CSRF-token handshake the engine does not perform, and v2's write shapes are the write path's (#1679). Refused
990
+ * here rather than at the first erasure request, where a subject's Art. 17 answer would be the one to fail.
991
+ */
992
+ if (binding.dialect === HttpApiTransportDialect.ODATA_V2) {
993
+ throw new Error(
994
+ 'erasure: an ODATA_V2 binding reads only, and the explicit-erasure stance is a remote DELETE the engine does not send on v2 '
995
+ + '(SAP Gateway requires a CSRF-token handshake). Declare NO_SUBJECT_DATA or CONTROLLER_ACKNOWLEDGED_NON_ERASURE, or bind a v4 service.',
996
+ );
997
+ }
274
998
  const usesCanonicalDelete = 'useCanonicalDelete' in binding.erasure.operation;
275
999
  if (binding.dialect === HttpApiTransportDialect.REST_JSON && usesCanonicalDelete) {
276
1000
  throw new Error(
@@ -285,3 +1009,126 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
285
1009
  }
286
1010
  }
287
1011
  ```
1012
+
1013
+ ### Origin Package: `@wildo-ai/saas-models`
1014
+
1015
+ ```typescript
1016
+ /**
1017
+ * The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
1018
+ * from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
1019
+ * registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
1020
+ * "we cannot delete rows we do not own" is not an answer the framework may imply silently.
1021
+ *
1022
+ * Import it from `@wildo-ai/saas-models` (the package root), not from the `external-data` subpath.
1023
+ */
1024
+ export enum HttpApiErasureStance {
1025
+ /**
1026
+ * (6a) The resource declares it holds NO personal/subject data. Registration verifies the
1027
+ * declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
1028
+ * the remote rows.
1029
+ */
1030
+ NO_SUBJECT_DATA = 'no-subject-data',
1031
+
1032
+ /**
1033
+ * (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
1034
+ * engine invokes on a subject-erasure request. This is a single declared write and does NOT
1035
+ * require general write support (slice 1 stays read-only otherwise).
1036
+ */
1037
+ EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
1038
+
1039
+ /**
1040
+ * (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
1041
+ * lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
1042
+ * administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
1043
+ * is the control. NEVER a standing default — the acknowledgement is per erasure request.
1044
+ */
1045
+ CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
1046
+ }
1047
+ ```
1048
+
1049
+ ## REST_JSON: the declared row writes
1050
+
1051
+ A REST_JSON binding names no protocol, so each write it opens is declared as the ONE request it
1052
+ sends — `operations.create`, `operations.update`, `operations.delete`, each present exactly when
1053
+ `writableVerbs` opens that verb. `read-through-writes.md` ("Writing to a REST_JSON API") has the
1054
+ Salesforce and NetSuite shapes and what a client meets.
1055
+
1056
+ ## Import Origins
1057
+
1058
+ - `@wildo-ai/saas-models`
1059
+
1060
+ ## Source Excerpts
1061
+
1062
+ ### Origin Package: `@wildo-ai/saas-models`
1063
+
1064
+ ```typescript
1065
+ /**
1066
+ * The methods a declared REST_JSON row write may use. Never `PUT` (it replaces the resource, so a partial update would
1067
+ * reset every field it omits) and never `GET` (a read is not a write). Which of these each verb admits is decided per verb:
1068
+ * a create is a `POST`; an update a `PATCH` or an RPC-style `POST`; a delete a `DELETE` or an RPC-style `POST`.
1069
+ */
1070
+ export enum HttpApiRestWriteMethod {
1071
+ POST = 'POST',
1072
+ PATCH = 'PATCH',
1073
+ DELETE = 'DELETE',
1074
+ }
1075
+
1076
+ /** Where a vendor answers the KEY of a record a create just made. */
1077
+ export enum HttpApiRestCreatedKeySource {
1078
+ /**
1079
+ * A value in the JSON answer, at a declared dot-path — Salesforce's `{ "id": "001…", "success": true, "errors": [] }`
1080
+ * answers `path: 'id'`. The answer need not be the record: only its key is read, and the row is then read back by it.
1081
+ */
1082
+ RESPONSE_BODY = 'response-body',
1083
+ /**
1084
+ * The LAST path segment of the answer's `Location` header — NetSuite answers `204` with no body and
1085
+ * `Location: https://<account>.suitetalk.api.netsuite.com/services/rest/record/v1/customer/647`. The header must name a
1086
+ * record of the path the create was sent to (`<create path>/<key>`), or the answer is not read as a key.
1087
+ */
1088
+ LOCATION_HEADER = 'location-header',
1089
+ }
1090
+
1091
+ /** Where a create's answer carries the new record's key. A single-key binding only: one answer names one value. */
1092
+ export const HttpApiRestCreatedKeySchema = z.discriminatedUnion('source', [
1093
+ z.object({
1094
+ source: z.literal(HttpApiRestCreatedKeySource.RESPONSE_BODY),
1095
+ /** Dot-path to the key inside the JSON answer (`id`, `data.id`). */
1096
+ path: z.string().min(1),
1097
+ }),
1098
+ z.object({
1099
+ source: z.literal(HttpApiRestCreatedKeySource.LOCATION_HEADER),
1100
+ }),
1101
+ ]);
1102
+ export type HttpApiRestCreatedKey = z.infer<typeof HttpApiRestCreatedKeySchema>;
1103
+
1104
+ /**
1105
+ * One declared REST_JSON row write: `operations.create`, `operations.update` or `operations.delete` — each present exactly
1106
+ * when the binding opens that verb in `writableVerbs`.
1107
+ *
1108
+ * @example
1109
+ * ```ts
1110
+ * // Salesforce: a create answers the id in its body; an update and a delete answer 204.
1111
+ * create: { method: HttpApiRestWriteMethod.POST, pathTemplate: '/services/data/v62.0/sobjects/Account',
1112
+ * createdKey: { source: HttpApiRestCreatedKeySource.RESPONSE_BODY, path: 'id' } },
1113
+ * update: { method: HttpApiRestWriteMethod.PATCH, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
1114
+ * delete: { method: HttpApiRestWriteMethod.DELETE, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
1115
+ * ```
1116
+ */
1117
+ export const HttpApiRestWriteOperationSpecSchema = z.object({
1118
+ method: z.enum(HttpApiRestWriteMethod),
1119
+ /**
1120
+ * Path relative to the instance's base URL. An update or a delete addresses ONE record by `{key}` (a single-key binding)
1121
+ * or `{key.<RemoteField>}` tokens, exactly as a `read` member does; a create names the collection and carries no key
1122
+ * token — the vendor chooses the key.
1123
+ */
1124
+ pathTemplate: z.string().min(1),
1125
+ /** Where the vendor answers the created record's key. Required on `create`, refused on `update` and `delete`. */
1126
+ createdKey: HttpApiRestCreatedKeySchema.optional(),
1127
+ /**
1128
+ * Headers this vendor requires on the write. VENDOR headers only: a credential comes from the instance's access, never
1129
+ * from a binding, and an `Authorization` key is refused by name.
1130
+ */
1131
+ staticHeaders: z.record(z.string().min(1), z.string().min(1)).optional(),
1132
+ });
1133
+ export type HttpApiRestWriteOperationSpec = z.infer<typeof HttpApiRestWriteOperationSpecSchema>;
1134
+ ```