@wildo-ai/framework-knowledge 1.1.10 → 1.1.11

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 (1062) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  4. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  5. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  6. package/dist/esm/framework-knowledge.definitions.js +459 -76
  7. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  9. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  10. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  11. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  12. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  13. package/dist/esm/index.d.ts +2 -0
  14. package/dist/esm/index.d.ts.map +1 -1
  15. package/dist/esm/index.js +2 -0
  16. package/dist/esm/index.js.map +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  18. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  20. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -2
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +11 -6
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +3 -3
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +3 -2
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  45. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  49. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  53. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  56. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  62. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  66. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  69. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  70. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +6 -4
  74. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  83. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  97. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  99. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  101. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  118. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  120. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -3
  124. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  125. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  126. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  127. package/dist/esm/source-anchor-grammar.js +114 -0
  128. package/dist/esm/source-anchor-grammar.js.map +1 -0
  129. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  130. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  131. package/dist/knowledge/manifest.json +8 -8
  132. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  133. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  135. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  136. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +350 -23
  137. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
  138. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
  139. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  140. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  141. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  142. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  143. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +3 -3
  144. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
  145. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
  146. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
  147. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  149. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  150. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  151. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  152. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +33 -5
  153. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  155. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -3
  156. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  157. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  158. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +97 -23
  159. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  160. package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
  161. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  163. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  164. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  165. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  166. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  167. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  168. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
  169. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  170. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  171. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  172. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  173. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  174. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  175. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  176. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  177. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +3 -3
  178. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
  180. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  181. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  182. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  183. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  184. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +4 -0
  185. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -4
  186. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  187. package/dist/knowledge/references/application-maturity.config.md +1 -1
  188. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  189. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  190. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  191. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  192. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  193. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  194. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  195. package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
  196. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  197. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  198. package/dist/knowledge/references/capability-composition.config.md +4 -3
  199. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  200. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  201. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  202. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  203. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  204. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  205. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  206. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  207. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  208. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  209. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  210. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  211. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  213. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  214. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  215. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  216. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  217. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  218. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  219. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  220. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  221. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  222. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  223. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  224. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  225. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  226. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  227. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  228. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  229. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  230. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  231. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  232. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -22
  233. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  234. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  235. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  236. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  237. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  238. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  239. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  240. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  241. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  242. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  243. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  244. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  245. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  246. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  247. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  248. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  249. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  250. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  251. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  252. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  253. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  254. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  255. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  256. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  257. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  258. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  259. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  260. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  261. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  262. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  263. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  264. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  265. package/dist/knowledge/references/experience-plan.config.md +16 -0
  266. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  267. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  268. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  269. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  270. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  271. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  272. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  273. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  274. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  275. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  276. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  277. package/dist/knowledge/references/integration-plan.config.md +21 -1
  278. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  279. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  280. package/dist/knowledge/references/placement-plan.config.md +75 -13
  281. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  282. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  283. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  284. package/dist/knowledge/references/platform.config.saas.md +106 -14
  285. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  286. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  287. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  288. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  289. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  290. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  291. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  292. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  293. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  294. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  295. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  296. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  297. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  298. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  299. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  300. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  301. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  302. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  303. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  304. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  305. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  306. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  307. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  308. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  309. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  310. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  311. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  312. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  313. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  314. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  315. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  316. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  317. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  318. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  319. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  320. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  321. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  322. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  323. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  324. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  325. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  326. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  327. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  328. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  329. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  330. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  331. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  332. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  333. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  334. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  335. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  336. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  337. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  338. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  339. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  340. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  341. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  342. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  343. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  344. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  345. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  346. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  347. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  348. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  349. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +18 -16
  350. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  351. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  352. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  353. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  354. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  355. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  356. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  357. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +10 -2
  358. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  359. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  360. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  361. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  362. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  363. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  364. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  365. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  366. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
  367. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
  368. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  369. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
  370. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  371. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  372. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  373. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  374. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  375. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  376. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  377. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  378. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  379. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  380. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  381. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  382. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  383. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  384. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  385. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  386. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  387. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  388. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  389. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  390. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  391. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  392. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  393. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  396. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  397. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  398. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  400. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  406. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  407. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  408. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  409. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  410. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  411. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  412. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  413. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  414. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  415. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  416. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  417. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  418. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  419. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  420. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  421. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  422. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  423. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  424. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  425. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  426. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  427. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +58 -6
  428. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  429. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  430. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  431. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  434. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  435. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  436. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  437. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  438. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  440. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  441. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  442. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  443. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  444. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  445. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  446. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  447. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  448. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  451. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  452. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  453. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  454. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  455. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  456. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +58 -2
  457. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  459. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  460. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  461. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  463. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  465. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  466. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  467. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  468. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  469. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  470. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  471. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  472. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  473. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  474. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  475. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  476. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  477. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  478. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  479. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -6
  480. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  481. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  482. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  483. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  484. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  485. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  486. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  487. package/dist/knowledge/references/saas.public-runtime.contract.md +34 -2
  488. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  489. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  490. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  492. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  493. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  494. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  495. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  496. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  497. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  498. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  499. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  500. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  501. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  502. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  503. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  504. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  505. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  506. package/dist/knowledge/references/saas.website.astro.label-loader.md +38 -9
  507. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  508. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  509. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  510. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  511. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  512. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  513. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  514. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  515. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  516. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  517. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  518. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  519. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  520. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  521. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  522. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  523. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  524. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  525. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  526. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  527. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  528. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  529. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  530. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  531. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  532. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  533. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  534. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  535. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  536. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  537. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  538. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  539. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  540. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  541. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  542. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  543. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  544. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  545. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  546. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  547. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  548. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  549. package/dist/knowledge/references/saas.website.config.site-context-loader.md +21 -1
  550. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  551. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  552. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  553. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  554. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  555. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  556. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  557. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  558. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  559. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  560. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  561. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  562. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  563. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  564. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  565. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  566. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  567. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  568. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  569. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  570. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  571. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  572. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  573. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  574. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  575. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  576. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  577. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  578. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  579. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  580. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  581. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  582. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  583. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  584. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  585. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  586. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  587. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  588. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  589. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  590. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  591. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  592. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  593. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  594. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  595. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  596. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  597. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  598. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  599. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  600. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  601. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  602. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  603. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  604. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  605. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  606. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  607. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  608. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  609. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  610. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  611. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  612. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  613. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  614. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  615. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  616. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  617. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  618. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  619. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  620. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  621. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  622. package/dist/knowledge/references/service-method.config.md +270 -0
  623. package/dist/knowledge/references/website-plan.config.md +544 -32
  624. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  625. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  626. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  627. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  628. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +73 -9
  629. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  630. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  631. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +75 -6
  632. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  633. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  634. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  635. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  636. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  637. package/dist/knowledge/references/zod.decorators.schema-metadata.md +4 -0
  638. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
  639. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  640. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  641. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  642. package/dist/knowledge/references/zod.factories.code.md +18 -9
  643. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  644. package/dist/knowledge/references/zod.factories.money.md +24 -15
  645. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  646. package/dist/knowledge/references/zod.factories.range.md +5 -1
  647. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  648. package/dist/knowledge/registries/framework-topics.json +2411 -139
  649. package/dist/knowledge/registries/playbooks.json +51 -30
  650. package/dist/knowledge/registries/source-tags.json +8500 -4768
  651. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  652. package/dist/knowledge/skills/INDEX.md +60 -33
  653. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  654. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  655. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  656. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  657. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  658. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  659. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  660. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  661. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  662. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  663. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  664. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  665. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  666. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  667. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  668. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  669. package/dist/knowledge/skills/application-database-migrations/SKILL.md +27 -9
  670. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  671. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
  672. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
  673. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  674. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  675. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  676. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  677. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +35 -1
  678. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  679. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +3 -0
  680. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  681. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  682. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  683. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  684. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  685. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  686. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  687. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  688. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  689. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  690. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  691. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  692. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  693. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  694. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +134 -33
  695. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  696. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  697. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  698. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  699. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  700. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  701. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  702. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  703. package/dist/knowledge/skills/config-app-shell/SKILL.md +57 -28
  704. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  705. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  706. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  707. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  708. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +17 -6
  709. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  710. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  711. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  712. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  713. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  714. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  715. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  716. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  717. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  718. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  719. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  720. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  721. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  722. package/dist/knowledge/skills/config-saas/SKILL.md +2 -0
  723. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
  724. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  725. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  726. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  727. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  728. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  729. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  730. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  731. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  732. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  733. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  734. package/dist/knowledge/skills/config-saas-backend/SKILL.md +5 -3
  735. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  736. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  737. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  738. package/dist/knowledge/skills/configure-billing/SKILL.md +14 -0
  739. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  740. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  741. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  742. package/dist/knowledge/skills/email-add-template/SKILL.md +46 -5
  743. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
  744. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  745. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  746. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  747. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  748. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  749. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  750. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  751. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  752. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  753. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  754. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +281 -20
  755. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  756. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  757. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  758. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  759. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  760. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  761. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  762. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  763. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  764. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  765. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  766. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  767. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  768. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  769. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  770. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  771. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  772. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  773. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  774. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  775. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  776. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  777. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  778. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
  779. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -14
  780. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  781. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  782. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  783. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  784. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  785. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
  786. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  787. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  788. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  789. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  790. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  791. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  792. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  793. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  794. package/dist/knowledge/skills/infra-environment-config/SKILL.md +107 -2
  795. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  796. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  797. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  798. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  799. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  800. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  801. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  802. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  803. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  804. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  805. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  806. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  807. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  808. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  809. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  810. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
  811. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
  812. package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
  813. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -1
  814. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  815. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  816. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  817. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  818. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  819. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  820. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +150 -4
  821. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  822. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  823. package/dist/knowledge/skills/module-relationships/SKILL.md +50 -27
  824. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  825. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  826. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  827. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  828. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  829. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  830. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  831. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  832. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  833. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  834. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  835. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  836. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  837. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  838. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  839. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  840. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  841. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  842. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  843. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  844. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  845. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  846. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  847. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  848. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  849. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  850. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  851. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  852. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  853. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +26 -14
  854. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  855. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  856. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  857. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  858. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  859. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  860. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  861. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  862. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  863. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +132 -55
  864. package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
  865. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -2
  866. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  867. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  868. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +102 -4
  869. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  870. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  871. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +6 -0
  872. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  873. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +18 -0
  874. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  875. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +60 -3
  876. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  877. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  878. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +1 -1
  879. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  880. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +195 -23
  881. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  882. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  883. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +176 -10
  884. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  885. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
  886. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  887. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  888. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  889. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  890. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  891. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  892. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  893. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  894. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  895. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  896. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  897. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  898. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  899. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  900. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  901. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  902. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  903. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  904. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  905. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  906. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  907. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  908. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  909. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +3 -1
  910. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  911. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  912. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +26 -10
  913. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  914. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +9 -7
  915. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  916. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +79 -6
  917. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  918. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  919. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  920. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +32 -4
  921. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  922. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +116 -66
  923. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  924. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +203 -18
  925. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  926. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
  927. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
  928. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  929. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  930. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  931. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +168 -58
  932. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  933. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  934. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  935. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  936. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  937. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  938. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  939. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  940. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  941. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  942. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  943. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +141 -32
  944. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
  945. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  946. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  947. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  948. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  949. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  950. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  951. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  952. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  953. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  954. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
  955. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  956. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +11 -4
  957. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  958. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  959. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  960. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
  961. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -192
  962. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  963. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  964. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  965. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  966. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  967. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +39 -18
  968. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  969. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  970. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  971. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  972. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  973. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  974. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  975. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  976. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  977. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  978. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  979. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  980. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  981. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  982. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  983. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  984. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  985. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  986. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  987. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +24 -3
  988. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  989. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  990. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  991. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  992. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  993. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  994. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  995. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  996. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  997. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  998. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  999. package/dist/knowledge/skills/website-section-faq/SKILL.md +561 -302
  1000. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1001. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1002. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +647 -274
  1003. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1004. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +572 -264
  1005. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1006. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1007. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1008. package/dist/knowledge/skills/website-section-hero/SKILL.md +603 -332
  1009. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1010. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1011. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1012. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1013. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1014. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1015. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1016. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1017. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1018. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1019. package/dist/knowledge/skills/website-section-pricing/SKILL.md +549 -378
  1020. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1021. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1022. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1023. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1024. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1025. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1026. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1027. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1028. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1029. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1030. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1031. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1032. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1033. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1034. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +739 -315
  1035. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1036. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1037. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1038. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1039. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1040. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1041. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1042. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1043. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1044. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1045. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1046. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1047. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1048. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1049. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1050. package/dist/knowledge/topic-index.json +16442 -8572
  1051. package/package.json +4 -4
  1052. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1053. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1054. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1055. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1056. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1057. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1058. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1059. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1060. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1061. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1062. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -32,7 +32,8 @@ report carries `passMode` — `full` or `incremental` — and `incrementalTrackR
32
32
  the incremental track over. `POST …/run` accepts `"passMode": "full"` to run a deletion-detecting pass
33
33
  now; without it the run is the kind `scheduleCron` runs. An OUTBOUND pipeline runs `send` passes only — `full` or
34
34
  `incremental` is refused for it — and its report carries an `outbound` summary of what was sent, kept, dropped and
35
- left for an operator (`outbound-pipelines.md`).
35
+ left for an operator (`outbound-pipelines.md`). `"passMode": "keyed"` re-reads now only the records inbound
36
+ deliveries asked for (`requested-keys.md`); a report that drained any carries `requestedKeys`.
36
37
 
37
38
  Three summary fields name rows the source HOLDS that the run deliberately did not load. All are
38
39
  still counted as present, so none can reach the orphan policy:
@@ -75,18 +76,45 @@ A summary carries **`fullPassRestart: extraction-basis-changed`** when that full
75
76
  because the declaration changed under it (see `incremental-extraction.md`).
76
77
 
77
78
  **`POST …/reset`** is the way past those refusals — a checkpoint with no version, a malformed
78
- checkpoint, a membership journal that is cyclic, does not match its pass, or was recorded in the format
79
- used before its keys were stored one row each — which otherwise repeat on
79
+ checkpoint, a membership journal that is cyclic, does not match its pass, holds fewer key rows than its segments
80
+ count, or was recorded in the format used before its keys were stored one row each — which otherwise repeat on
80
81
  every scheduled tick. Body: `{ "resourceType": "…", "mode": "restart-pass" | "full-resync", "reason":
81
82
  "…", "operator": "…" }`. `restart-pass` discards the full pass in flight (cursor, checkpoint, membership
82
83
  journal) and the next full run starts over; `full-resync` also discards the incremental watermark, so
83
- the next incremental pass re-reads the whole source. `reason` is required. The answer names what was
84
+ the next incremental pass re-reads the whole source. `full-resync` also drops the records inbound deliveries asked the
85
+ pipeline to re-read (`requested-keys.md`) — its whole re-read covers them — which is how a request whose keyed read the
86
+ source keeps refusing is cleared; `restart-pass` keeps them, as it keeps the incremental watermark: a delivery's "this
87
+ record changed" is still true after the full pass's position is gone, and dropping it would leave the change unread
88
+ until a full pass reached the record — on an incremental or unscheduled pipeline, possibly never. `reason` is required. The answer names what was
84
89
  discarded, and so does the audit trail (`external_data_pipeline_reset`: pipeline, mode, reason, the
85
- operator as stated, the discarded pass id, cursor and watermark). Destination rows, erasure
90
+ operator as stated, the discarded pass id, cursor — a next link's query string removed — and watermark, the requested
91
+ keys dropped, and an `outcome`). A reset
92
+ writes TWO rows, paired by `resetAttemptId`: `attempted`, written under its lease before it deletes anything (if the
93
+ audit trail refuses that row, or does not confirm it within 15 seconds, the reset is not started and answers 409, and
94
+ still writes a `failed-before-discard` ending row), and one when it ends — `completed`,
95
+ `failed-after-discard` (what the row names is gone and a later step did not finish), `failed-before-discard` (nothing
96
+ changed) or `outcome-unknown` (a commit answer was lost: read the pipeline's state to know). An `attempted` row with no
97
+ ending row means the ending was not recorded, and what it names may already be gone: the audit store refused the ending
98
+ row (the metric `audit_store_failure_total` counts that), the process died part-way, or a refused start's ending row also
99
+ failed to land. An ending row can also appear without its `attempted` row, when the store refused that one. The
100
+ requested-key count is absent when the delete had not landed, because
101
+ those keys still wait. When a SIEM receives the rows, the failures and `outcome-unknown` are failures; a reset row
102
+ carries no tenant, so today no per-organization SIEM receives it.
103
+ Destination rows, erasure
86
104
  suppressions and pending references are never touched. The door answers `409` while the pipeline is
87
105
  running; retry when the run has finished. You do NOT need it after a declaration change — the run
88
106
  restarts the pass itself.
89
107
 
108
+ **`POST …/erasure-suppressions/reconcile`** (#2082) is the way past the run's refusal on erasure suppressions filed
109
+ under a source identity the pipeline no longer has (409, `external_data_erasure_suppression_identity_mismatch`). Body:
110
+ `{ "resourceType": "…", "action": "carry-over" | "release", "reason": "…", "operator": "…" }`. The decision is this
111
+ pipeline's: `carry-over` keeps it matching the suppressions filed under the old identity; `release` stops it matching
112
+ them, and records still at the source are copied in again. A `release` releases the suppressions themselves only when
113
+ no other registered pipeline still matches that identity or owes a decision about it — the answer's `stillMatchedBy`
114
+ names any that do. A decision is final (see `erasure-suppression.md`). The reason is required and recorded at HIGH
115
+ risk with the identities, the counts and what was released, also when the door fails after deciding. See
116
+ `erasure-suppression.md` for which to choose. 409 while the pipeline is running, and before it first ran.
117
+
90
118
  ## The run history — what happened across runs, and which rows were refused
91
119
 
92
120
  The listing shows each pipeline's CURRENT state; the history shows what its runs did. Every run leaves one row —
@@ -114,15 +142,20 @@ reads the door with the application's stored admin secret, so you need not call
114
142
  **`GET …/runs?resourceType=…&limit=…`** answers one pipeline's runs, most recently STARTED first (20 by default, at
115
143
  most 100).
116
144
  Each run names its trigger, `passMode`, `passId`, `outcome`, counts (`extractedRows`, `rejectedRows`,
117
- `submittedEntries`, `suppressedRows`, `pendingReferences`), `durationMs`, `seedRunId`, `fullPassRestart` and
118
- `incrementalTrackReset`. A failed run also names its **`failureKind`**:
145
+ `submittedEntries`, `suppressedRows`, `pendingReferences`), `durationMs`, `leaseGeneration` (the turn the run took on
146
+ the pipeline's lease, increasing run after run; empty for a run that ended before taking it), `seedRunId`, `fullPassRestart`,
147
+ `incrementalTrackReset`, `continuationRestart` (why the pass read again from its start: `expired` — the source forgot
148
+ its next link — or `origin-moved` — the link named a host the instance's base URL no longer points at) — and, for records inbound deliveries asked to re-read, `inboundDeliveryId` (the delivery that
149
+ started a keyed run), `drainedRequestedKeys`, `missingRequestedKeys`, `keptRequestedKeys` (re-read and kept for a later
150
+ run on a two-way pipeline) and `requestedKeyDeliveryIds`. A keyed run is not a
151
+ pass: the pipeline's health ignores it. A failed run also names its **`failureKind`**:
119
152
 
120
153
  | `failureKind` | What to do |
121
154
  |---|---|
122
155
  | `source-unreachable` (with `unreachableCause`) | Wait, or fix the instance address; the scheduled runs back off (see above). |
123
156
  | `owner-organization-absent` | Seed or promote the application's owner organization; nothing loads until it exists. |
124
157
  | `ownership-lost` | Nothing: the run lost its lease and a later run continues from the accepted checkpoint. |
125
- | `other` | Read `failureMessage` — the failure's log line, URL query strings removed. A refused stored state is cleared with `POST …/reset`. |
158
+ | `other` | Read `failureMessage` — the failure's line, with a URL's query and the forms in which a database driver quotes a row's values (a duplicate key, a refused input or cast) removed; a vendor's own wording beyond those forms is not controlled. A refused stored state is cleared with `POST …/reset`. |
126
159
 
127
160
  **`rejections`** lists the source rows the transform refused — up to 100 per run, `rejectionsTruncated` true
128
161
  when there were more (`rejectedRows` stays exact). Each carries the row's `remoteKey` (null when the row could
@@ -168,7 +201,10 @@ export const ExternalDataAdminEndpointPath = {
168
201
  * `incremental` (#1682), its last-run summary, and — while its system of record cannot be reached — the
169
202
  * unreachable streak (`sourceUnreachable`, #1475): since when, how many failed attempts, how many scheduled
170
203
  * runs were skipped, and when the next scheduled attempt is. Each entry carries `health` (#1740), read from the run
171
- * history: the last run and its outcome, the failures in a row, and when it last completed a pass.
204
+ * history: the last run and its outcome, the failures in a row, and when it last completed a pass — and, for a
205
+ * BIDIRECTIONAL pipeline, how many passes in a row ended with the sending half failed and when the last did
206
+ * (`consecutiveSendingFailures`, `lastSendingFailureAt`, #2096): a run keeps its inbound outcome when only its sending
207
+ * half fails, so those two fields are the only signal that nothing is being sent.
172
208
  */
173
209
  PIPELINES: '/pipelines',
174
210
  /**
@@ -187,13 +223,14 @@ export const ExternalDataAdminEndpointPath = {
187
223
  RUN: '/run',
188
224
  /**
189
225
  * GET — one pipeline's run history, newest first (#1740): `?resourceType=externalCustomers&limit=20`. Each row names
190
- * the trigger, track, pass, outcome, counts and duration; a failed run its failure kind (source unreachable, no owner
226
+ * the trigger, track, pass, outcome, counts and duration, and the lease generation the run held (#2271); a failed run its failure kind (source unreachable, no owner
191
227
  * organization, lost lease, other) and message; and every run up to 100 of its REJECTED rows with their remote key and
192
228
  * reason — what an operator needs to fix the data at the source. Kept for the application's OPERATIONAL_LOGS period.
193
229
  */
194
230
  RUNS: '/runs',
195
231
  /**
196
- * POST — reset ONE pipeline (#1734): `{ "resourceType": "externalCustomers", "mode": "restart-pass" | "full-resync",
232
+ * POST — reset ONE pipeline (#1734) — the way past a refused stored state, including a membership journal holding fewer
233
+ * key rows than its segments count (#2080): `{ "resourceType": "externalCustomers", "mode": "restart-pass" | "full-resync",
197
234
  * "reason": "…", "operator"?: "…" }`. `restart-pass` discards the full pass in flight (cursor, checkpoint, membership
198
235
  * journal) so the next full run starts over; `full-resync` also discards the incremental watermark, so the next
199
236
  * incremental pass re-reads the whole source. Destination rows are never touched. The reason is required and
@@ -204,6 +241,31 @@ export const ExternalDataAdminEndpointPath = {
204
241
  * pipeline is running.
205
242
  */
206
243
  RESET: '/reset',
244
+ /**
245
+ * POST — reconcile ONE pipeline's erasure suppressions with its changed source identity (#2082): `{ "resourceType":
246
+ * "externalCustomers", "action": "carry-over" | "release", "reason": "…", "operator"?: "…" }`.
247
+ *
248
+ * A run REFUSES (409, code `external_data_erasure_suppression_identity_mismatch`) while active suppressions are filed
249
+ * under a system, remote entity or key shape the pipeline no longer has — the identity it last matched under, whoever
250
+ * recorded them, or one its own destination recorded under: they would match nothing, and every erased record would be
251
+ * copied back in. The decision is THIS pipeline's and is kept on its state; nothing is moved or re-keyed.
252
+ * - `carry-over`: the pipeline keeps matching the suppressions filed under the old identity, so they keep suppressing —
253
+ * right when the same records keep the same remote keys (an instance renamed, an entity moved to another API version).
254
+ * - `release`: the pipeline stops matching them — right when the identity names other records now, and a record still
255
+ * at the source is copied in again. The suppressions themselves are released only when NO other registered pipeline
256
+ * still matches that identity or still owes a decision about it; otherwise they stay active for it, and the answer's
257
+ * `stillMatchedBy` names who.
258
+ *
259
+ * A decision is per identity and final: a released suppression is not restored (run the erasure again), and an identity
260
+ * already decided is not offered again. A wrong carry-over is NOT harmless: it suppresses every record of the new source
261
+ * that merely shares a key value with an erased one, so that record is never copied; no door revokes a carry-over yet,
262
+ * so choose it only when the same remote keys name the same records. A `release` also retries the identities this
263
+ * pipeline already decided to release whose rows are still active. Returning the pipeline to an identity voids its
264
+ * decision about it. The reason is required and recorded at HIGH risk with the identities, the counts and what
265
+ * was released, also when the door fails after deciding. Answers 409 while the pipeline is running, and before it first
266
+ * ran.
267
+ */
268
+ ERASURE_SUPPRESSIONS_RECONCILE: '/erasure-suppressions/reconcile',
207
269
  /**
208
270
  * GET — one OUTBOUND pipeline's changes of UNKNOWN outcome (#2039): `?resourceType=leads&limit=50`. A write the pass
209
271
  * sent and got no clear answer for — a timeout after sending — is never sent again on its own, because a create sent
@@ -228,6 +290,44 @@ export const ExternalDataAdminEndpointPath = {
228
290
  * unknown outcome any more (answered, or settled by a pass) — list again.
229
291
  */
230
292
  OUTBOUND_CHANGES_RESOLVE: '/outbound-changes/resolve',
293
+ /**
294
+ * POST — UNLINK one row from the remote record whose key it holds (#2043): `{ "resourceType": "leads",
295
+ * "localResourceId": "…", "remoteKey": "…", "reason": "…", "operator"?: "…" }`.
296
+ *
297
+ * The way past a create the pass could not link: it landed in the system of record, and the key it returned is held
298
+ * by ANOTHER local row (`lastOutcomeCode: remote-key-held-by-another-row`) — a key written by an earlier mistake, or a
299
+ * record merged over there. Unlink the row that holds it WRONGLY, then answer the waiting create `applied` with that
300
+ * key through `/outbound-changes/resolve`; the store's unique index refuses a racing claim on the key.
301
+ *
302
+ * `remoteKey` must be the key the row holds (409 `row-does-not-hold-key` otherwise): naming it is what says which link
303
+ * is wrong. 409 `send-in-flight` when the row's own change is being sent or is of unknown outcome — answer that first;
304
+ * 409 `conflict-undecided` when the row's two-way conflict is waiting for, or carrying, a choice of side.
305
+ * The unlinked row's pending change, or its next one, is sent as a CREATE. The reason is required and recorded on the
306
+ * audit trail.
307
+ * There is no re-key: moving a key between two rows is two claims, each made through its own door.
308
+ */
309
+ OUTBOUND_CHANGES_UNLINK: '/outbound-changes/unlink',
310
+ /**
311
+ * GET — one BIDIRECTIONAL pipeline's refused CONFLICTS (#1723): `?resourceType=partners&limit=50`. A row whose shared
312
+ * fields changed on both sides since they last agreed, which the declared policy `refuse-and-report` left alone on
313
+ * both sides. Neither loaded over nor sent until someone chooses a side. Each entry names the local row, and who made
314
+ * the local change and when; the run history's `conflicts` names its remote key and the fields that differ.
315
+ */
316
+ OUTBOUND_CONFLICTS: '/outbound-changes/conflicts',
317
+ /**
318
+ * POST — choose the side that wins ONE of them (#1723): `{ "resourceType": "partners", "localResourceId": "…",
319
+ * "winner": "remote" | "local", "reason": "…", "operator"?: "…" }`.
320
+ *
321
+ * - `remote` discards the local change to the shared fields: the next pass that reads the record loads the system of
322
+ * record's values over them (a full pass at the latest, for a pipeline that reads incrementally). Nothing local is
323
+ * sent over the record in the meantime.
324
+ * - `local` keeps the local values: the next outbound pass agrees on the record's current version and sends them over
325
+ * it.
326
+ *
327
+ * The reason is required and recorded on the audit trail. 409 (`no-conflict`) when the row has no refused conflict —
328
+ * answered already, or never refused.
329
+ */
330
+ OUTBOUND_CONFLICTS_RESOLVE: '/outbound-changes/conflicts/resolve',
231
331
  } as const;
232
332
 
233
333
  export type ExternalDataAdminEndpointPathValue =
@@ -0,0 +1,145 @@
1
+ # What the engine can do over a binding — ask, do not restate
2
+
3
+ Read this when an application decides something per vendor that the ENGINE already decides:
4
+
5
+ - whether a list over this binding may declare `sortFields` (and must, where the dialect sorts);
6
+ - whether the binding may open `writableVerbs` (an onboarding create, an update);
7
+ - which incremental extraction mode a pipeline over this vendor can use;
8
+ - whether the instance can be partitioned, and which action call shapes it can declare.
9
+
10
+ Every one of these is enforced at startup, so writing the answer down per vendor is a second copy of engine
11
+ knowledge: it is right until the engine learns something (a dialect gains sort translation, a write prerequisite
12
+ gets performed), and then it refuses work the engine would now accept, or opens work it would refuse.
13
+
14
+ Two questions, two inputs, both from `@wildo-ai/saas-models/external-data`:
15
+
16
+ - `httpApiDialectCapabilities(dialect)` needs only the binding's dialect: `translatesSort`, `sendsRowWrites`, and a
17
+ `writeRefusal` sentence when it cannot write. Shared code that a frontend also loads can ask it.
18
+ - `systemOfRecordBindingCapabilities(facet, dialect)` also takes the vendor's facet (from
19
+ `@wildo-ai/systems-of-record/systems-of-record`, linked where the application declares it): it adds `writesRows`
20
+ (the dialect writes AND every write prerequisite the vendor declares is performed), `partitions` (the vendor declares
21
+ a partition of a kind the engine can confine — a FIELD, like Odoo's `company_id`. A path-segment partition cannot be
22
+ confined, and `partition: true` on one is refused at startup; Business Central addresses its companies that way, which
23
+ is why its facet declares no partition at all), and the vendor's `incrementalExtractionModes` and `actionCallShapes`
24
+ narrowed to that dialect. Use it in a backend, a script or a
25
+ test that checks a declaration against the vendor.
26
+
27
+ ## Import Origins
28
+
29
+ - `@wildo-ai/saas-models`
30
+
31
+ ## Source Excerpts
32
+
33
+ ### Origin Package: `@wildo-ai/saas-models`
34
+
35
+ ```typescript
36
+ /** What one transport dialect can do in this engine. */
37
+ export interface HttpApiDialectCapabilities {
38
+ /**
39
+ * The dialect translates a list's sort to the remote (`$orderby`, Odoo's `order`). A list over a dialect that does
40
+ * must declare its `sortFields` (an undeclared key is refused at translation); a list over one that does not must
41
+ * declare none, and serves the remote's natural order.
42
+ */
43
+ readonly translatesSort: boolean;
44
+ /** The engine sends row writes (`writableVerbs`) over this dialect. A binding opening a verb on one that does not is refused at startup. */
45
+ readonly sendsRowWrites: boolean;
46
+ }
47
+
48
+ /**
49
+ * Total over {@link HttpApiTransportDialect}, so a dialect added tomorrow is a compile error here until somebody
50
+ * states what it can do.
51
+ */
52
+ export const HTTP_API_DIALECT_CAPABILITIES: { readonly [dialect in HttpApiTransportDialect]: HttpApiDialectCapabilities } = Object.freeze({
53
+ // `$orderby`; POST / PATCH / DELETE on the entity set (#1726).
54
+ [HttpApiTransportDialect.ODATA]: { translatesSort: true, sendsRowWrites: true },
55
+ // `$orderby`; reads only — v2 writes (a CSRF fetch, MERGE, v2 payloads) are not built (#1687).
56
+ [HttpApiTransportDialect.ODATA_V2]: { translatesSort: true, sendsRowWrites: false },
57
+ // `search_read`'s `order`; `execute_kw` create / write / unlink (#1724).
58
+ [HttpApiTransportDialect.ODOO_JSONRPC]: { translatesSort: true, sendsRowWrites: true },
59
+ // No sort translation (the compiler refuses every sort); the binding's declared method and path per verb (#1728).
60
+ [HttpApiTransportDialect.REST_JSON]: { translatesSort: false, sendsRowWrites: true },
61
+ });
62
+
63
+ /**
64
+ * The vendor write PREREQUISITES this engine performs before a modifying request (#1726) — none yet. Total over
65
+ * {@link SystemOfRecordWritePrerequisite}; `false` means a binding opening writes toward a vendor that requires the
66
+ * step is refused at startup, because the vendor would refuse every such write anyway, as a bare `403`.
67
+ */
68
+ export const SYSTEM_OF_RECORD_PERFORMED_WRITE_PREREQUISITES: { readonly [prerequisite in SystemOfRecordWritePrerequisite]: boolean } = Object.freeze({
69
+ // SAP Gateway's X-CSRF-Token fetch + session cookie: the read client carries no cookie jar and fetches no token.
70
+ [SystemOfRecordWritePrerequisite.CSRF_TOKEN_HANDSHAKE]: false,
71
+ });
72
+
73
+ /**
74
+ * Which kinds of partition the engine can CONFINE a read to. Total over {@link SystemOfRecordPartitionKind}, so a kind
75
+ * added tomorrow is a compile error here until somebody decides. The vocabulary names a kind the engine cannot confine
76
+ * (a path segment) so that a facet or an augmentation CAN be honest about one, and the backend refuses `partition: true`
77
+ * on such a vendor at startup (`PARTITION_KIND_UNSUPPORTED`), reading this table. (Business Central addresses its
78
+ * companies by path segment, and its shipped facet declares no partition at all for that reason, so `partition: true`
79
+ * there is refused earlier, as `PARTITION_NOT_SUPPORTED_BY_VENDOR`.)
80
+ */
81
+ export const SYSTEM_OF_RECORD_CONFINABLE_PARTITION_KINDS: { readonly [kind in SystemOfRecordPartitionKind]: boolean } = Object.freeze({
82
+ // A field on every row (Odoo `company_id`): filterable, so the confinement is pushed down into the read.
83
+ [SystemOfRecordPartitionKind.FIELD]: true,
84
+ // A path segment is chosen before the request is built, so it cannot express several partitions in one read.
85
+ [SystemOfRecordPartitionKind.PATH_SEGMENT]: false,
86
+ });
87
+
88
+ /** Whether a vendor's declared partition is one the engine can confine; `false` when it declares none. */
89
+ export function systemOfRecordPartitionIsConfinable(partition: SystemOfRecordPartitionSupport | undefined): boolean {
90
+ return partition !== undefined && SYSTEM_OF_RECORD_CONFINABLE_PARTITION_KINDS[partition.kind];
91
+ }
92
+
93
+ /** What a dialect can do, and — when it cannot write — why, in a sentence an application can show as a held reason. */
94
+ export function httpApiDialectCapabilities(dialect: HttpApiTransportDialect): HttpApiDialectCapabilities & { readonly writeRefusal?: string } {
95
+ const capabilities = HTTP_API_DIALECT_CAPABILITIES[dialect];
96
+ return capabilities.sendsRowWrites ? capabilities : { ...capabilities, writeRefusal: `The engine sends no row writes over the ${dialect} dialect yet.` };
97
+ }
98
+
99
+ /** The write prerequisites of a vendor that this engine does NOT perform — empty when its writes can be sent. */
100
+ export function unperformedSystemOfRecordWritePrerequisites(prerequisites: readonly SystemOfRecordWritePrerequisite[] | undefined): SystemOfRecordWritePrerequisite[] {
101
+ return (prerequisites ?? []).filter((prerequisite) => !SYSTEM_OF_RECORD_PERFORMED_WRITE_PREREQUISITES[prerequisite]);
102
+ }
103
+
104
+ /** What the engine can do over a binding of a vendor, through one of its dialects. */
105
+ export interface SystemOfRecordBindingCapabilities extends HttpApiDialectCapabilities {
106
+ /** The engine can send row writes to THIS vendor over this dialect: the dialect writes and every prerequisite is performed. */
107
+ readonly writesRows: boolean;
108
+ /** Why `writesRows` is false, as a sentence. Absent when it is true. */
109
+ readonly writeRefusal?: string;
110
+ /**
111
+ * The engine can confine the vendor's data by partition — the vendor declares a partition of a kind the engine can
112
+ * confine (Odoo's companies). An instance still opts in with `partition: true`.
113
+ */
114
+ readonly partitions: boolean;
115
+ /** The incremental extraction modes the vendor offers that run over this dialect. Empty: every pass is a full pass. */
116
+ readonly incrementalExtractionModes: readonly ExternalDataIncrementalExtractionMode[];
117
+ /** The vendor action call shapes spoken over this dialect. Empty: the binding can declare no action. */
118
+ readonly actionCallShapes: readonly SystemOfRecordActionCallShape[];
119
+ }
120
+
121
+ /**
122
+ * Everything the engine can do over a binding of `facet`'s vendor through `dialect`. Refuses a dialect the vendor's
123
+ * facet does not list, which the backend would refuse at startup too.
124
+ */
125
+ export function systemOfRecordBindingCapabilities(facet: SystemOfRecordVendorFacet, dialect: HttpApiTransportDialect): SystemOfRecordBindingCapabilities {
126
+ if (!facet.dialects.includes(dialect)) {
127
+ throw new Error(`System-of-record vendor '${facet.vendor}' is not spoken to over ${dialect} (its dialects: ${facet.dialects.join(', ')}).`);
128
+ }
129
+ const dialectCapabilities = HTTP_API_DIALECT_CAPABILITIES[dialect];
130
+ const unperformed = unperformedSystemOfRecordWritePrerequisites(facet.writePrerequisites);
131
+ const writeRefusal = !dialectCapabilities.sendsRowWrites
132
+ ? `The engine sends no row writes over the ${dialect} dialect yet.`
133
+ : unperformed.length > 0
134
+ ? `The engine does not perform ${unperformed.join(', ')}, which '${facet.vendor}' requires before every write.`
135
+ : undefined;
136
+ return {
137
+ ...dialectCapabilities,
138
+ writesRows: writeRefusal === undefined,
139
+ ...(writeRefusal === undefined ? {} : { writeRefusal }),
140
+ partitions: systemOfRecordPartitionIsConfinable(facet.partition),
141
+ incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) => EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT[mode] === dialect),
142
+ actionCallShapes: (facet.actionCallShapes ?? []).filter((shape) => SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape] === dialect),
143
+ };
144
+ }
145
+ ```
@@ -83,13 +83,39 @@ v4: modified-at; the generic `odata` facet: both):
83
83
  last page names the next one. Refused at startup: a `sourceFilter` (change tracking refuses `$filter`)
84
84
  and a composite key (a deleted entity names one id). A service that answers the first pass without a
85
85
  delta link does not track changes — that pass fails, naming the cause.
86
- - **A delta link that has EXPIRED** resets the track, and the same run falls back to a FULL pass — the
87
- read that finds the deletions the expired link would have reported. Expired means `410 Gone` or
86
+ - **A delta link that has EXPIRED** resets the track, and the same run advances a FULL pass instead. Expired means `410 Gone` or
88
87
  `404 Not Found` (what the protocol lets a service answer), or the vendor's own error code where its
89
88
  system-of-record facet declares one: Dataverse keeps change tracking for `ExpireChangeTrackingInDays`
90
89
  (seven by default) and answers an older token with `0x80044352`, "Please perform a full sync". The run reports
91
- `incrementalTrackReset: position-rejected` with `passMode: full`, and the next incremental run starts a
92
- new delta link.
90
+ `incrementalTrackReset: position-rejected` with `passMode: full` and `continuationRestart: expired`, and
91
+ the next incremental run starts a new delta link. What that full pass does and does not recover, precisely:
92
+ - The fallback run advances the full pass by ONE run's worth of rows (`maxRowsPerRun`). If a full pass
93
+ was already in flight, it is that pass that continues; otherwise a new one starts. The deletions it
94
+ recovers are applied only when that pass COMPLETES, which may take several runs.
95
+ - A completing full pass orphans the rows whose keys it did not see anywhere in the pass — in its own
96
+ pages or in the incremental runs that ran while it was in flight. A row deleted at the source AFTER the
97
+ pass read its key was seen, so it is not orphaned by this pass.
98
+ - A row deleted before the old link's last successful read was already reported by that link. A row
99
+ deleted AFTER both that read and the moment the full pass read it, and before the next incremental run
100
+ opens a new delta link, is reported by neither: the pass saw it present, and the new link starts after
101
+ it left. It stays until the next full pass (`fullPassCron`) finds it absent.
102
+ - **A NEXT LINK that has expired** is different: it only continues a pass. A pass that spans runs keeps the
103
+ service's `@odata.nextLink` as its cursor — the OData full pass, and a modified-at pass — and a service
104
+ may forget it. On `410` / `404` the pass reads again from its start (the full pass from its first page,
105
+ a modified-at pass from its unchanged watermark); nothing is skipped, and the run's history row says
106
+ `continuationRestart: expired`. Once per pass: a second restart in the same pass, for either reason
107
+ (expired or moved, below), FAILS the run, because a source that forgets links faster than a pass
108
+ completes would otherwise restart it forever and never detect a deletion. The failure names both
109
+ reasons. When the second was an expiry, raise `maxRowsPerRun` or run the pipeline more often; when it
110
+ was a move, settle the instance's base URL. Then reset the pipeline.
111
+ - **A stored link under a base URL you MOVED the instance away from** is never followed. That covers
112
+ another scheme, host or port (a continuation that leaves the instance's origin would carry its
113
+ credentials elsewhere), and also only another PATH on the same host (`/odata/v1` → `/odata/v2`: the
114
+ link would keep reading the service root you moved away from). Each link is stored with the service
115
+ root it was received under, so both moves are seen. It is treated like an expired one: the full and
116
+ modified-at passes restart on the new root, a delta link resets the track and falls back to a full
117
+ pass, and the history says `continuationRestart: origin-moved`. Same once-per-pass rule. Links are
118
+ stored absolute, so this holds for a service that serves relative links too.
93
119
 
94
120
  ## How the Odoo mode reads what changed
95
121
 
@@ -28,11 +28,20 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
28
28
  - **It decodes values before you see them:** `"/Date(1767571200000)/"` becomes a `Date`; a string
29
29
  `Edm.Decimal`, `Edm.Int64`, `Edm.Double` becomes a `number`; `__metadata` and deferred navigation
30
30
  properties are removed. Map these fields onto `z.date()` / `z.number()` directly — no coercion needed.
31
- - **It refuses what a number cannot hold exactly,** naming the property: an `Edm.Int64` beyond
32
- 2^53 − 1, and an `Edm.Decimal` with more than 15 significant digits. It only fetches what you read, so
33
- this fails only a read that asks for the property: a read-through `$select`s the fields of the
34
- resource's schema (plus its keys), and a pipeline the fields its mapping reads. Leave such a property
35
- out of the resource's schema or the mapping, or read it from a service that serves it as `Edm.String`.
31
+ - **It never rounds a number,** and names the property, never the value: an `Edm.Int64` beyond
32
+ 2^53 − 1, an `Edm.Decimal` with more than 15 significant digits, and a `NaN`, `INF` or `-INF` (legal
33
+ `Edm.Double` / `Edm.Single` values) are values no number field can hold. Where the reading stops depends
34
+ on the reader:
35
+ - a **read-through** cannot refuse one record of a page, so it refuses the READ. It `$select`s only the
36
+ fields of the resource's schema (plus its keys), so this happens only for a property you declared.
37
+ - a **pipeline** rejects just THAT RECORD, naming the field: the other records load, the pass completes,
38
+ and the record keeps its earlier value (it stays observed, so it is never orphaned). This applies only
39
+ to a field the pipeline reads (a mapping, a key, a reference). A record holding such a value in a field
40
+ nobody reads loads normally. A KEY component of that kind still refuses the read, because the key walk
41
+ cannot advance past a key it cannot read.
42
+
43
+ Leave such a property out of the resource's schema or the mapping, or read it from a service that
44
+ serves it as `Edm.String`.
36
45
  - **It spells each filter for the property's type:** `datetime'2026-01-05T00:00:00.000'`, `42L`,
37
46
  `2.5M`, `guid'…'`, and search as `substringof('needle', tolower(Prop)) eq true`. Every request asks for
38
47
  JSON (`$format=json`); totals use `$inlinecount=allpages`. When the service serves fewer rows than a
@@ -41,13 +50,16 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
41
50
  - **A pipeline walks the entity's KEY,** not `__next`: each page asks for the next N keys after the last
42
51
  one read (`Key gt 'last'`, lexicographic for a composite key). v2 does not promise a partial listing is
43
52
  stable, and a complete pass that skipped a row would delete its local copy. A page served out of key
44
- order is refused rather than trusted.
53
+ order is refused rather than trusted. The one exception is a page with NO rows that still carries a
54
+ `__next`: the service cut its answer short, and an empty page cannot move a key walk, so its link is
55
+ followed to the first page that serves rows. A service that keeps answering empty pages is refused
56
+ after a bounded number of links, and the run stops rather than treat the set as finished.
45
57
 
46
58
  ## What it cannot do
47
59
 
48
60
  - **Write.** A binding opening `create` / `update` / `delete` on `ODATA_V2` is refused at startup, and so
49
- is the `EXTERNAL_ERASURE_OPERATION` stance (a remote DELETE). Declare `NO_SUBJECT_DATA` or
50
- `CONTROLLER_ACKNOWLEDGED_NON_ERASURE`.
61
+ is `subjectRights: FORWARDED_TO_SOURCE` (a remote DELETE). Leave `subjectRights` out (the system of
62
+ record answers for its records) or declare `NO_SUBJECT_DATA`.
51
63
  - **Filter or sort by a complex-typed property,** or by `Edm.Time` / `Edm.Binary`: those are refused by
52
64
  name.
53
65
  - **Run actions** (OData function imports) — declared actions are v4-only.
@@ -56,5 +68,5 @@ the entity set, `keyFields`, `fieldMappings`). The instance's `baseUrl` is the v
56
68
 
57
69
  - [ ] The instance and the binding both say `ODATA_V2`, and the instance's `baseUrl` is the v2 service root.
58
70
  - [ ] Every mapped field exists in the service's `$metadata` (a pipeline's run report warns when one is missing).
59
- - [ ] The erasure stance is `NO_SUBJECT_DATA` or `CONTROLLER_ACKNOWLEDGED_NON_ERASURE`.
71
+ - [ ] `subjectRights` is left out or declares `NO_SUBJECT_DATA` (never a forward).
60
72
  - [ ] No `create` / `update` / `delete` is opened.
@@ -16,7 +16,7 @@ record: a **create** the first time, an **update** after that.
16
16
  | One user action must change the ERP NOW, and the user must see the result or the refusal | a write through a VIRTUAL resource (`read-through-writes.md`) |
17
17
  | The ERP owns the data and the application copies it | an INBOUND pipeline (the default direction) |
18
18
  | The ERP must run a business step (post an invoice, confirm an order) | a declared action (`system-of-record-actions.md`) |
19
- | The same row is edited on BOTH sides | not yet — a conflict policy is a separate direction, not built |
19
+ | The same row is edited on BOTH sides | a BIDIRECTIONAL pipeline (`bidirectional-pipelines.md`) |
20
20
 
21
21
  The difference from a virtual write is WHEN and WHO: a virtual write happens inside the user's request and fails
22
22
  it when the ERP refuses. An outbound pipeline sends later, on its own schedule, and a refusal is retried and
@@ -26,14 +26,14 @@ reported — the user's save always succeeds locally.
26
26
 
27
27
  ```ts
28
28
  import { ExternalDataMappingEntryKind, ExternalDataPipelineDirection, HttpApiKeyComponentCodec, HttpApiWriteConcurrencyMode, HttpApiWriteVerb } from '@wildo-ai/saas-models/external-data';
29
- import { HttpApiErasureStance, HttpApiTransportDialect } from '@wildo-ai/saas-models';
29
+ import { HttpApiTransportDialect, SystemOfRecordSubjectRightsPosture } from '@wildo-ai/saas-models';
30
30
 
31
31
  externalDataPipeline: {
32
32
  direction: ExternalDataPipelineDirection.OUTBOUND,
33
33
  binding: {
34
34
  dialect: HttpApiTransportDialect.ODOO_JSONRPC, system: 'odoo', entityRef: 'crm.lead',
35
35
  keyFields: [{ localField: 'id', remoteField: 'id', codec: HttpApiKeyComponentCodec.INTEGER }],
36
- erasure: { stance: HttpApiErasureStance.NO_SUBJECT_DATA },
36
+ subjectRights: { posture: SystemOfRecordSubjectRightsPosture.NO_SUBJECT_DATA },
37
37
  writableVerbs: [HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE],
38
38
  writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS },
39
39
  },
@@ -58,13 +58,16 @@ What each part means, and what startup refuses:
58
58
  ones and has no inverse. `required`, `coercion` and a non-default `unresolved` are refused: they describe
59
59
  loading, and this direction loads nothing. `orphanCascadeAcknowledged` is ADMITTED and means what it means
60
60
  inbound: when the reference's target is an INBOUND destination that deletes orphans, and the relationship
61
- deletes children with their parent, a record vanishing from the target's source takes these rows with it.
61
+ deletes children with their parent, the declaration says a record vanishing from the target's source should take
62
+ these rows with it, and the cascade does run when that record vanishes.
62
63
  - **Nothing that describes READING the source:** `sourceFilter`, `incremental`, `archivedRecords`,
63
64
  `partitionKeyLocalField`, and a `population` or `orphanPolicy` other than the defaults are refused.
64
- - **`erasure.stance` must be `NO_SUBJECT_DATA`, and no sent field may declare `.dataCategories()`.** A system of
65
- record receiving rows about people is their recipient, and no subject erasure reaches the copy it holds yet. Until
66
- it does, this direction sends records about organizations and things (a company lead, an order, an asset), never
67
- about a person.
65
+ - **`subjectRights` says who answers for what the system of record receives.** Leave it out (`HANDLED_AT_SOURCE`):
66
+ the system answers requests about the records it received, and an erasure's receipt says so. The local rows are
67
+ born in your application, so an erasure scrubs or deletes them as their resource's retention declares, like any of
68
+ your rows. Declare `NO_SUBJECT_DATA` only when no sent field can be about a person — startup checks it against the
69
+ sent fields that declare `.dataCategories()`, a credential marker, `.impersonalizeWith()` or `.portabilityProvenance()`,
70
+ the same fields the privacy notice counts. `FORWARDED_TO_SOURCE` and `OWNED_COPY` are refused here (#2560).
68
71
 
69
72
  ## The destination schema — the ownership rules reversed
70
73
 
@@ -74,7 +77,7 @@ APPLICATION's:
74
77
  | Field | Rule | Why |
75
78
  |---|---|---|
76
79
  | each mapped `localField` | writable by callers (NOT excluded from both create and update) | a field nobody can set would send a value nobody decided |
77
- | `remoteKeyLocalField` | `z.string().optional().isUnique().excludeFromCreate().excludeFromUpdate()` — optional, never `.nullable()` | empty until the first send; the engine writes it ONCE from the key the create answered, and a caller who could write it could point a local row at any remote record. UNIQUE because one remote record may have one local row: two rows on one key would overwrite each other's record. The plain (sparse) unique ignores rows with no key yet; an explicit null would not be ignored on MongoDB, so the field refuses null |
80
+ | `remoteKeyLocalField` | `z.string().optional().isUnique().excludeFromCreate().excludeFromUpdate()` — optional | empty until the first send; the engine writes it ONCE from the key the create answered, and a caller who could write it could point a local row at any remote record. UNIQUE because one remote record may have one local row: two rows on one key would overwrite each other's record. The plain (sparse) unique ignores rows with no key yet, on both stores, whether the key is absent or null |
78
81
  | a `REMOTE_REFERENCE` `localField` | an optional string foreign key of a declared relationship to `targetResourceType` | the target's REMOTE key is sent in its place |
79
82
  | the tenant foreign key | exactly as for any pipeline destination: ORGANIZATIONS scope, a routed required foreign key, engine-supplied | see "The destination's tenant is ENGINE-SUPPLIED" in the skill |
80
83
 
@@ -101,6 +104,16 @@ Each pass (on `scheduleCron`, or `POST …/run`) reads the markers and, for each
101
104
  - **a `REMOTE_REFERENCE`** sends the target row's remote key — an Odoo many2one as the bare record id. A target not
102
105
  sent yet makes the row WAIT (`deferred.reference-target-not-sent`), because sending it without its link would
103
106
  create a record nothing ever links afterwards. It goes the pass after its target does.
107
+ - **a field the vendor's write API spells differently from its list** goes under the write member's name. NetSuite's
108
+ SuiteQL answers `companyname`, while the record service a create or an update goes to names it `companyName`. Name it
109
+ per member on the mapping entry, the way a read-through binding does (see `read-through-writes.md`):
110
+
111
+ ```ts
112
+ { kind: ExternalDataMappingEntryKind.REMOTE_FIELD, remoteField: 'companyname', localField: 'name',
113
+ remoteFieldByMember: { create: 'companyName', update: 'companyName' } }
114
+ ```
115
+
116
+ REST_JSON only, OUTBOUND only, and only for a member the binding declares. Anything else is refused at startup.
104
117
 
105
118
  Never sent:
106
119
 
@@ -116,8 +129,16 @@ A created record must land in ONE partition (an Odoo company). Declare `partitio
116
129
  field holding the organization unit the row belongs to. The engine places the create in the partition the operator
117
130
  assigned to that unit, exactly as a read-through create is placed. A row naming no unit, or a unit assigned no
118
131
  single partition, waits (`deferred.partition-unplaced`) and is retried each time its backoff elapses — assign the partition, or set the
119
- row's unit. An update never moves a record between partitions. Do not map anything onto the partition field
120
- itself: startup refuses it, because the partition is derived.
132
+ row's unit. An update never moves a record between partitions.
133
+
134
+ An update is confined as well, the same way a key-addressed write through a read-through resource is. Before
135
+ sending it, the pass reads the partition the record is in, and sends only if the row's unit is assigned that
136
+ partition. A row naming no unit may update only a record that is in no partition. Otherwise the update waits
137
+ (`deferred.partition-not-entitled`) until the unit is assigned the record's partition, or the row names a unit that
138
+ is. Because the confinement needs that read, a partitioned instance takes updates only over a dialect that can read
139
+ one record (Odoo, OData v4); startup refuses the others.
140
+
141
+ Do not map anything onto the partition field itself: startup refuses it, because the partition is derived.
121
142
 
122
143
  ## The order changes are sent in, and the backoff
123
144
 
@@ -136,10 +157,11 @@ the local row it came from.
136
157
  | What happened | What the pipeline does |
137
158
  |---|---|
138
159
  | The system of record refused the write | retried under a NEW key once its backoff has elapsed; counted in `remoteRefused` |
139
- | It could not be reached | the pass stops (`stoppedBecauseUnreachable`); the row that met it is backed off, and the rows not reached are taken by the next pass |
160
+ | It could not be reached, before anything was sent (the connection was refused, the host was not found, the token endpoint or Odoo's sign-in did not answer) | the pass stops (`stoppedBecauseUnreachable`). Nothing was written, so the change is not refused: it keeps its due time, is counted `leftForNextPass`, and the next pass sends it under a new key, with the rows not reached |
161
+ | The run's deadline came while the write waited for its rate budget, before it was sent | the pass stops (`stoppedAtDeadline`), and the change is left for the next pass exactly as above. A write is never re-sent after a throttle, so this is the only wait it has |
140
162
  | The write landed, and recording it locally failed | nothing is sent again: the next pass settles it (`replayed`) — from the row's key if it was written, from the write ledger if not |
141
- | The pass stopped after sending, before the answer was recorded | the next pass asks the write ledger. Applied → settled, nothing sent (`replayed`). Still in flight → left for later (`leftForNextPass`), then UNKNOWN once its deadline passes. A CREATE whose ledger entry is gone (a day passed) is UNKNOWN — never sent afresh |
142
- | **The outcome is UNKNOWN** (a timeout after sending) | never sent again under that change. An UPDATE is sent again once the row changes again (`awaitingNewerChange` until then). A **CREATE waits for an operator** (`awaitingOperator`): sending it again could create the record twice |
163
+ | The pass stopped after sending, before the answer was recorded | the next pass asks the write ledger, whether or not the row changed since. Applied → settled, nothing sent (`replayed`), and a newer change is then sent under a new key. Not applied → sent again: under the same key when the row is unchanged, under a new key when it changed since. Still in flight → left for later (`leftForNextPass`), then UNKNOWN once its deadline passes. A CREATE whose ledger entry is gone (a day passed) is UNKNOWN — never sent afresh |
164
+ | **The outcome is UNKNOWN** (a timeout or a lost connection after sending, or a 502 or 504 from a gateway) | never sent again under that change. An UPDATE is sent again once the row changes again (`awaitingNewerChange` until then). A **CREATE waits for an operator** (`awaitingOperator`): sending it again could create the record twice |
143
165
 
144
166
  An unknown CREATE is answered by someone who looked in the system of record, through the admin door (same
145
167
  `X-Admin-Secret` as the other pipeline doors; see `framework-pipeline-admin-endpoints-api.md`):
@@ -158,6 +180,31 @@ An unknown CREATE is answered by someone who looked in the system of record, thr
158
180
  Every answer is recorded on the audit trail (`external_data_outbound_unknown_resolved`) with the reason, who said they
159
181
  answered, and what it changed. 409 means the change is not of unknown outcome any more — list again.
160
182
 
183
+ ### When the key is already held by another row
184
+
185
+ A create can land and return a key that ANOTHER local row already holds. That happens when the other row's link is
186
+ wrong: a key written by an earlier mistaken answer, or a record merged in the system of record. The pass refuses to
187
+ link one record to two rows. The create then waits with `lastOutcomeCode: remote-key-held-by-another-row`, and the
188
+ error log names both rows and the key. Answering it `applied` with that key is refused for the same reason. The way
189
+ past it has two steps, each one audited, and each one a single write the store can refuse:
190
+
191
+ 1. **Unlink the row that holds the key wrongly**: `POST /internal/admin/external-data/outbound-changes/unlink` with
192
+ `{ "resourceType", "localResourceId", "remoteKey", "reason", "operator"? }`.
193
+ - `remoteKey` must be the key that row holds (409 `row-does-not-hold-key` otherwise), so the unlink names which
194
+ link is wrong.
195
+ - It is refused (409 `send-in-flight`) while that row's own change is being sent or is of unknown outcome. Answer
196
+ that change first. On a BIDIRECTIONAL pipeline it is also refused (409 `conflict-undecided`) while the row has a
197
+ conflict that is not yet decided.
198
+ - The unlinked row keeps its values but loses its link: its pending change, or its next one, is sent as a CREATE.
199
+ - Recorded as `external_data_outbound_remote_key_unlinked`.
200
+ 2. **Answer the waiting create** `applied` with the key, as above. The destination's unique index now lets the right
201
+ row hold it, and refuses any other answer that claims the same key at the same moment. On a BIDIRECTIONAL pipeline
202
+ the gap between the two steps is safe too. While that create waits for its answer, a run does not load records that
203
+ no local row holds. So the record is not imported as a third row before the answer links it.
204
+
205
+ There is deliberately no single "move the key" call. Moving a key between two rows is two claims about another
206
+ system, and each one is made, checked and recorded on its own.
207
+
161
208
  ## What a pass reports
162
209
 
163
210
  A sending pass's run report carries `passMode: 'send'` (an OUTBOUND pipeline runs no other kind, and `POST …/run`