@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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: resource-external-data
3
- description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP").
3
+ description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP"), or edited on both sides ("sync both ways", "two-way sync with Odoo").
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -56,10 +56,10 @@ run.
56
56
 
57
57
  - **The application owns the data** — that is an ordinary resource; use `resource-add-resource`.
58
58
  - **You are adding a provider or credential**, not consuming data — that is provider configuration.
59
- - **The same rows must be edited on BOTH sides.** A pipeline runs one direction: INBOUND copies the
60
- system of record's rows in, OUTBOUND sends the application's own rows out (see "When the application
61
- is the source" below). A row changed on both sides needs a conflict policy, which is not built — say
62
- so plainly rather than declaring two pipelines over one resource.
59
+ - **Two pipelines over one resource.** Never declare an INBOUND and an OUTBOUND pipeline on the same
60
+ destination to get a two-way sync: each would overwrite the other's changes unseen. When the same rows
61
+ are edited on both sides, that is ONE `direction: BIDIRECTIONAL` pipeline (see "When both sides edit
62
+ the records" below).
63
63
 
64
64
  ## Workflow
65
65
 
@@ -111,12 +111,25 @@ The library describes **seven** vendors — `odoo`, `microsoft-dataverse`,
111
111
  - **Your vendor is named** → use it. You get its real paging behaviour, its real credential kinds and
112
112
  its partition field, all with the vendor's own documentation cited.
113
113
  - **Your system speaks OData v4 and is not named** → use `odata`. A vendor-neutral facet: OData v4,
114
- every credential kind the engine ships, conformant paging, no partition. The instance's address
115
- block carries the service root.
114
+ five credential kinds (a bearer key, HTTP Basic, the two OAuth client-credentials kinds, a client
115
+ certificate), conformant paging, no partition. The instance's address block carries the service root.
116
116
  - **Neither** → the vendor has no facet, and that is the answer. Do not reach for `odata` because it
117
117
  is the only one that parses: if the system is not OData v4, `odata` will fail at the first read,
118
118
  further from the cause.
119
119
 
120
+ **A number an OData service serves that no number field can hold is never rounded.** OData v4 JSON
121
+ serves NaN and the infinities as the STRINGS `"INF"`, `"-INF"` and `"NaN"`. In a field your resource
122
+ declares as a number, a read-through refuses the read and names the property, because it cannot refuse
123
+ one record of a page. A pipeline rejects just that record and loads the rest. The same word in a text
124
+ field is only a word. A 64-bit integer or an exact decimal is asked for as a string
125
+ (`IEEE754Compatible=true`), so it arrives whole: in a number field, a value a number holds exactly
126
+ becomes that number, and one no number can hold (an integer past 2^53 − 1, a decimal of more than 15
127
+ significant digits) is refused in a read-through and rejected as one record in a pipeline. It is never
128
+ rounded. A pipeline applies the same rule to a number served as TEXT by any source, REST and Odoo
129
+ included: map the field to a string to keep such values. A declared action's answer is read the same
130
+ way against its `output` schema. A service that ignores the request and still sends JSON numbers cannot
131
+ be detected after parsing. For v2, which has more such values, see `references/odata-v2-sources.md`.
132
+
120
133
  Two naming traps, both real: the Microsoft Web API is known under three provider
121
134
  ids, and only **`microsoft-dataverse`** has a facet — `microsoft-dynamics-365` and
122
135
  `microsoft-dynamics-crm` do not, and naming one is refused. And the SAP facet is **`sap-s4hana`**,
@@ -124,10 +137,15 @@ not `sap-s4hana-cloud`.
124
137
 
125
138
  #### What each facet admits it cannot do
126
139
 
127
- Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared:
140
+ Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared. When your
141
+ application must DECIDE something from one of these limits (open onboarding writes or not, advertise sort keys or
142
+ not, pick an incremental mode), ask the engine rather than restating the list: see
143
+ `references/framework-system-of-record-capabilities-api.md`.
128
144
 
129
- - **`sap-s4hana` — HTTP Basic only.** Its communication user prefers an X.509 client certificate,
130
- which is a TRANSPORT credential the outbound seam has no channel for yet.
145
+ - **`sap-s4hana` — HTTP Basic or a client certificate.** Its communication user takes either, so the
146
+ instance must name the one it uses (`credential: { kind: SystemOfRecordCredentialKind.BASIC }` or
147
+ `MTLS_CLIENT_CERTIFICATE`); naming neither is refused at boot. A client certificate is presented in
148
+ the TLS handshake and needs an `https:` base URL.
131
149
  - **`sap-s4hana` — OData v4 AND v2, one instance per service root.** SAP's most-used API
132
150
  (`API_BUSINESS_PARTNER`, `/sap/opu/odata/sap/…`) is **v2**; declare `dialect: ODATA_V2` on the instance
133
151
  AND the binding for it, and `ODATA` for a v4 root (`/sap/opu/odata4/…`). A system reached over both is
@@ -157,6 +175,10 @@ them:
157
175
 
158
176
  - **`keyFields` order is the encoding order.** It is committed. Changing it later re-keys every row
159
177
  identity, so decide it once and deliberately.
178
+ Declare each key field as the codec projects it — a number for an INTEGER key, a string or a date for a
179
+ DATETIME_ISO key, a string otherwise —
180
+ and `_id` as a plain string (it holds the synthesized id). A schema that rejects that form is refused
181
+ when the resource is defined, not left to fail every read.
160
182
  - **`system`** — the declared instance the rows live in, by name. Not a provider: the instance is
161
183
  declared under `systemsOfRecord` in `wildo.saas.config.ts`, and its address and credential come from
162
184
  the environment under names derived from that name. A name the application does not declare is
@@ -164,18 +186,50 @@ them:
164
186
  - **You do not declare tenancy.** Rows read out of a system of record are stamped with the
165
187
  organization that owns the application, so the engine's per-row gate decides — nothing about your
166
188
  tenants is pushed to a remote that has never heard of them.
167
- - **`erasure`** — what happens to this data when a person asks to be erased. Every stance is a real
168
- answer, including "this holds no personal data"; there is no silent option. That answer must agree
169
- with your fields: `NO_SUBJECT_DATA` is refused at startup when any field that comes from the system
170
- declares `.dataCategories()` (every field of a read-through resource; the mapped fields of a
171
- pipeline). Settle it by fact — a company's name and contact details are data about a legal person,
172
- not personal data, so they carry no category; a person's name does, and needs a stance that can
173
- erase it or acknowledges it cannot.
174
-
175
- One declaration is optional and belongs beside `erasure` whenever the rows hold personal data:
189
+ - **`subjectRights`** — who answers data-subject requests about these rows. **Leave it out**, and the
190
+ system of record does: it decides what happens to its records' personal data and answers the people
191
+ they concern, under its own rules, and the application follows it (`HANDLED_AT_SOURCE`). An erasure
192
+ in the application then reports the resource as handled at the source, names the system, and never
193
+ stops for want of anything. That is the default because a system of record backs internal tools and
194
+ carries its own GDPR obligations; the application owns only what it keeps beyond or apart from the
195
+ source. Two other answers exist:
196
+ - `NO_SUBJECT_DATA` — the rows hold nothing about a person. CHECKED at startup: it is refused when
197
+ any field the system holds declares `.dataCategories()` (every field of a read-through resource;
198
+ the mapped fields of a pipeline, whichever way they travel). Settle it by fact: GDPR Recital 14's
199
+ exclusion covers only LEGAL persons, a record's "company" flag does not establish one (a sole trader
200
+ may be recorded as a company), and a named person's address on a company record is personal data.
201
+ A company's own name and number are personal data only where the company is a sole trader:
202
+ declare them with `{ personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON }`,
203
+ and the notice words them conditionally. They still count here, because some rows are a person's;
204
+ - `FORWARDED_TO_SOURCE` (read-through only) — besides the source's own handling, each erasure is
205
+ forwarded to the system through a declared operation, best effort: it never blocks the local
206
+ erasure, and a forward that fails still reports the resource as handled at the source, with the
207
+ failed steps listed (re-running the erasure retries them). Refused on a pipeline, which sends no delete.
208
+ - `OWNED_COPY` (inbound pipelines only) — the application keeps this copy BEYOND its source, so its
209
+ own erasure applies to it: the local rows are scrubbed or deleted as the resource's retention says,
210
+ and a suppression keeps the next pass from loading the person back. REQUIRED when the copy holds
211
+ something the source does not: a field about a person that callers write and no mapping fills (an
212
+ internal note on a client). The startup check refuses such a copy under any other posture.
213
+
214
+ Every other pipeline copy FOLLOWS its system of record: an erasure leaves its rows to the source
215
+ (nothing scrubbed, nothing suppressed; the receipt says the system answers for them), and the copy
216
+ removes what the source removes through its orphan policy, which must then be `DELETE` or
217
+ `IMPERSONALIZE` if it copies personal data. An outbound or two-way pipeline may send personal data:
218
+ the system receiving it answers requests about what it holds. Outbound rows are the application's
219
+ own and are erased as their resource declares; a two-way copy follows its source, and may not let
220
+ callers write personal data on rows born locally (`population: OPEN`).
221
+
222
+ One declaration is optional and belongs beside `subjectRights` whenever the rows hold personal data:
176
223
  **`purposeRefs`**, the `purposeRef`s of `operatorComplianceIdentity.lawfulBases` this data is read for.
177
224
  See "Which purpose the data serves" below.
178
225
 
226
+ **An unset remote field reads as unset.** A vendor spells "no value" its own way — OData and the REST
227
+ vendors send `null`, Odoo sends `false` for every unset field that is not a boolean — and the read-through
228
+ projects it as what YOUR field accepts: `null` for a `.nullable()` field, left out for an `.optional()` one,
229
+ and a real `false` kept for a field that accepts booleans. So declare every field some rows leave empty as
230
+ `.optional()` (or `.nullable()`), exactly as you would for a pipeline. A REQUIRED field the vendor serves
231
+ empty still fails the read, naming the field: that is the declaration and the ERP disagreeing, not noise.
232
+
179
233
  **Writing rows back** — creating, updating or deleting ONE row of the remote system — is opened by
180
234
  `writableVerbs` on the binding and performed by ordinary `CREATE` / `UPDATE` / `DELETE` operations.
181
235
  Read `references/read-through-writes.md` before you open one: it owns the whole contract, and four
@@ -215,16 +269,30 @@ The four decisions that matter:
215
269
 
216
270
  1. **`remoteKeyLocalField`** — a `.isBusinessKey()` STRING field holding the remote row's identity.
217
271
  The sync merges on it, which is what makes re-running safe. (An OUTBOUND pipeline reverses this and
218
- the next rule — see "When the application is the source".)
272
+ the next rule — see "When the application is the source".) Keep it a plain string: it stores the id
273
+ the key codec synthesizes (`"42"` for an INTEGER key), so a `z.uuid()` or a `.regex()` on it is refused
274
+ at startup when it would reject that form.
219
275
  2. **`mapping`** — remote field → local field, plus constants for local fields with no remote source,
220
276
  and DECLARED EXPRESSIONS for a value derived from remote fields (see "When a local value is derived"
221
277
  below). It must NOT name your tenant field; see the next section.
222
278
  3. **`population`** — `CLOSED` (every row comes from the pipeline; caller CREATE is refused) or
223
279
  `OPEN` (users may also mint their own rows beside the synced ones).
224
280
  4. **`orphanPolicy`** — what happens to a local row whose remote original disappeared: `DELETE`,
225
- `DEPRECATE` or `REPORT`. The final execution compares against all accepted source keys from
226
- the whole pass. An unreadable identity skips reconciliation for every policy. `OPEN` populations
227
- retain the conservative REPORT policy for seed-owned records.
281
+ `DEPRECATE`, `REPORT` (the default) or `IMPERSONALIZE`. The final execution compares against all accepted source
282
+ keys from the whole pass. An unreadable identity skips reconciliation for every policy. An `OPEN` population runs
283
+ its declared policy too: only rows the pipeline loaded (or adopted) are ever orphan candidates, never a row a caller
284
+ created. A copy that FOLLOWS its system of record and copies personal data MUST declare `DELETE` or `IMPERSONALIZE`
285
+ — startup refuses `REPORT`, `DEPRECATE` or the default there, because the copy would keep a record the source
286
+ deleted. `DELETE` removes the row through its parent-delete lifecycle: rows on its `onParentDelete` edges are
287
+ deleted or scrubbed as each edge declares, and a `REFUSE_WHILE_CHILDREN_EXIST` edge keeps the orphan (the pass
288
+ reports it and retries).
289
+ `IMPERSONALIZE` is the one to choose when the copy holds personal data and other rows reference it: the
290
+ orphan's `.impersonalizeWith()` fields are scrubbed and the row is kept, hidden and immutable, so a record
291
+ erased at the source leaves your copy nothing about the person while the work that points at it survives.
292
+ It needs the destination to declare `retentionPolicy: { mode: RETAIN_AND_IMPERSONALIZE }` (refused at startup
293
+ otherwise), and on a following copy `.impersonalizeWith()` on every copied personal field, or that field would
294
+ survive the scrub. No erasure suppression is written, so a record the source restores under the same key loads
295
+ again as a new row. A legal hold suspends the scrub. An archived Odoo record is never an orphan.
228
296
 
229
297
  ### The destination's tenant is ENGINE-SUPPLIED, and the shape is not negotiable
230
298
 
@@ -268,6 +336,17 @@ last batch. Failed loads retain the previous checkpoint for retry. Identifiable
268
336
  remain protected; an unreadable source identity skips orphan reconciliation for the pass,
269
337
  including `REPORT`. Check `reconciliationStatus` as well as `loadStatus`.
270
338
 
339
+ A record whose value its local field cannot be stored as is a **rejected row**, not a failed run.
340
+ Examples: a non-numeric string mapped onto a `z.number()` field; onto a `z.date()`, anything but an
341
+ ISO date the calendar has (`2026-02-30` is refused, never stored as 2 March); onto a `z.boolean()`,
342
+ anything but a boolean, the numbers `1`/`0` or the words `true`/`false`/`1`/`0`/`yes`/`no`; onto a
343
+ `z.string()`, an array or an object (an Odoo many2one mapped as a plain field). The rejection names
344
+ the field, never the value, and the rest of the pass loads. Each kind accepts a defined set, the same
345
+ on MongoDB and PostgreSQL, so spellings both stores happen to read but no source serves (a hex
346
+ number, a lower-case ISO date) are refused too. A date or time served without an offset is stored as
347
+ UTC, and a fraction of a second is kept to milliseconds. Fix a rejection with a
348
+ coercion in the mapping, or map the field as a string, or leave it out.
349
+
271
350
  Manual and scheduled runs share exclusive ownership per application and pipeline, including
272
351
  across backend instances. A competing trigger reports `already-running` before reading the
273
352
  pipeline checkpoint. Ownership covers destination writes, run state, membership history and
@@ -339,18 +418,27 @@ partitionKeyLocalField: 'odooCompanyRef',
339
418
  ```
340
419
 
341
420
  Both must exist on the destination schema, be STRINGS, be optional or nullable,
342
- and be `.excludeFromCreate().excludeFromUpdate()`. Nothing may map onto either —
421
+ and be `.excludeFromCreate().excludeFromUpdate()`. Keep the key column a plain
422
+ string: it holds the partition key as text (`"1"` for an Odoo company id, a
423
+ lowercased GUID), and a format, pattern or length rule that rejects that form is
424
+ refused at startup (not checked for a STRING partition codec, whose values vary). Nothing may map onto either —
343
425
  the engine stamps them after your mapping, so a mapping entry would be inert.
344
426
  Declaring one without the other is refused, and so is declaring them against an
345
427
  unpartitioned source.
346
428
 
347
429
  **Why two columns and not one.** The unit is what confines a caller. The remote
348
- key exists for a different question: when an operator un-assigns a partition, the
349
- unit still exists and a previously-loaded row still carries a valid unit id —
350
- nothing about it says its partition is no longer mapped. Without the remote key
351
- stored per row, the next pass sees those rows absent from the extraction and an
352
- orphan policy of DELETE erases them. One operator edit, a company's entire loaded
353
- history gone.
430
+ key is the partition that unit was derived from, and the derivation changes: when
431
+ an operator reassigns or un-assigns a partition, a previously-loaded row still
432
+ carries a valid unit id, and nothing about it says which partition it belongs to.
433
+ The stored key does, and the engine reads it on every query: a caller sees only
434
+ rows whose key is assigned to a unit, or unset (shared). So the rows loaded before
435
+ a partition was un-assigned, which keep their old unit because nothing re-stamps a
436
+ row that is no longer loaded, are read by nobody — organization-wide callers
437
+ included — until the partition is assigned again, when they reappear unchanged.
438
+
439
+ The key column is not what protects those rows from your `orphanPolicy`. A run
440
+ still extracts them and counts them as present, as the next section says, so an
441
+ un-assignment never deletes or scrubs them.
354
442
 
355
443
  ### What a run does with an unmapped partition
356
444
 
@@ -384,6 +472,21 @@ DELETIONS); OData v2 and REST sources run full passes.
384
472
  Read `references/incremental-extraction.md` before declaring it: the lookback, what re-reads the
385
473
  source, and how to read a run.
386
474
 
475
+ ## When the source announces what changed: requested keys
476
+
477
+ If the system of record can NOTIFY — an Odoo automated action posting on write, a Dataverse webhook — receive
478
+ the notification with an inbound handler (skill `inbound-channels`) and have it call
479
+ `ctx.pipelines.requestPipelineKeys(resourceType, remoteKeys)`. The pipeline then re-reads exactly those records
480
+ from the source and loads them through itself, within seconds. The handler never writes the pipeline's rows,
481
+ and nothing in the notification becomes a value: the source is asked, and its answer loads.
482
+
483
+ Nothing requested is dropped: the keys are recorded first, and every run of the pipeline — the scheduled one
484
+ included — re-reads waiting keys before its own pass; a run that ends with a request that arrived while it held the
485
+ pipeline asks for a keyed run itself. A keyed read the source refuses never stops the pass that follows it. A requested record the source no longer serves is reported `missing` and never deleted locally.
486
+ It supplements the schedule, never replaces it. An INBOUND or a BIDIRECTIONAL pipeline on Odoo (one key field) or
487
+ OData v4 takes requested keys; startup refuses a handler naming any other. On a BIDIRECTIONAL pipeline a re-read record
488
+ is decided exactly as a pass decides it, conflicts included. Read `references/requested-keys.md`.
489
+
387
490
  ## Rate budgets: two per call, and only a pipeline waits
388
491
 
389
492
  Every remote call spends TWO local budgets and is sent only if both have room. The instance budget and a
@@ -434,9 +537,11 @@ Odoo's own list views — while a subject erasure searches archived records too.
434
537
 
435
538
  ## When a copied person is erased: the suppression list
436
539
 
437
- Nothing to declare. An erasure that scrubs or deletes a pipeline-copied row records a SUPPRESSION of its
438
- remote record — a keyed hash, never the key — and every later pass, full or incremental, loads nothing
439
- under it and counts the skip as `suppressedRows`. It is released only by a completed full pass over the
540
+ Only an `OWNED_COPY` is suppressed. An erasure that scrubs or deletes a row of an owned copy records a
541
+ SUPPRESSION of its remote record — a keyed hash, never the key — and every later pass, full or incremental,
542
+ loads nothing under it and counts the skip as `suppressedRows`. A copy that follows its system of record is
543
+ left to the source by an erasure, so nothing is suppressed: when the source erases the record, the copy's
544
+ orphan policy removes it. It is released only by a completed full pass over the
440
545
  whole remote entity (no `sourceFilter`) that no longer sees the record. Read
441
546
  `references/erasure-suppression.md`, including the one refusal: a changed `encryptionKey` stops runs.
442
547
 
@@ -499,9 +604,22 @@ now: a CREATE the first time (its answered key is written to `remoteKeyLocalFiel
499
604
  The ownership rules reverse: the mapped fields are the application's and stay writable, the remote key is
500
605
  an optional engine-written string. Only the owner organization's rows are ever sent, a local delete never
501
606
  is, and an unknown-outcome CREATE waits for an operator rather than risk a duplicate. It needs
502
- `writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only, and
503
- — until erasure reaches sent records — `NO_SUBJECT_DATA` with no personal-data field. Read
504
- `references/outbound-pipelines.md`.
607
+ `writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, and `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only. It may
608
+ send personal data: the system of record answers requests about what it receives (leave `subjectRights` out), and
609
+ your local rows are erased as their resource declares. Read `references/outbound-pipelines.md`.
610
+
611
+ ## When both sides edit the records: `direction: BIDIRECTIONAL`
612
+
613
+ When a record is edited in the application AND in the system of record, declare ONE pipeline with
614
+ `direction: ExternalDataPipelineDirection.BIDIRECTIONAL`.
615
+ - Each mapped field says who owns it (`owner`): `REMOTE` is loaded, `LOCAL` is sent, `BOTH` is loaded and sent.
616
+ - A run loads, then sends. Only a `BOTH` field changed on both sides since they last agreed is a conflict, and
617
+ `conflictPolicy` decides it: `REMOTE_WINS`, `LOCAL_WINS`, or `REFUSE_AND_REPORT` (the default). A refused row
618
+ waits, listed on every run, until an operator chooses a side through the admin door.
619
+ - The vendor must version its rows (Odoo `write_date`, an OData v4 entity tag). Startup refuses one that does
620
+ not, and `population` must be `OPEN`.
621
+
622
+ Read `references/bidirectional-pipelines.md`.
505
623
 
506
624
  ## Worked Example
507
625
 
@@ -596,12 +714,40 @@ export enum ExternalDataDestinationPopulation {
596
714
  * seam's mapping is exhaustive and compile-forced, so a new member on either side reddens P-2).
597
715
  */
598
716
  export enum ExternalDataOrphanPolicy {
599
- /** Hard-delete the orphan row — flows through ordinary lifecycle (cascades, file teardown). Opt-in. */
717
+ /**
718
+ * Hard-delete the orphan row through the row's declared parent-delete lifecycle (#2575): a legal hold on the row keeps
719
+ * it; a `REFUSE_WHILE_CHILDREN_EXIST` edge still naming it, or a held descendant, refuses the delete (reported, retried
720
+ * next pass); otherwise its file fields are released, every enabled `onParentDelete` edge runs as it declares (children
721
+ * deleted, scrubbed or deferred), and its RAG chunks and case corrections go with it. Not run: the resource's operation
722
+ * hooks. Opt-in, and one of the two answers a copy that follows its system of record and copies personal data must
723
+ * declare (#2560).
724
+ */
600
725
  DELETE = 'delete',
601
726
  /** Mark the row deprecated and keep it; a re-appearing remote key REVIVES it (v3.1 §4). Opt-in. */
602
727
  DEPRECATE = 'deprecate',
603
728
  /** Touch nothing; surface the diff in the run ledger. The DEFAULT — least surprise. */
604
729
  REPORT = 'report',
730
+ /**
731
+ * Erase the orphan's personal data in place and keep the row (#2117). A record ABSENT FROM A COMPLETE PASS leaves the
732
+ * copy nothing of what the system held about a person, while rows that reference the copy (the work done for a client)
733
+ * keep pointing at it.
734
+ *
735
+ * "Absent from a complete pass" is wider than "deleted at the source": a record that leaves the pipeline's filtered or
736
+ * permitted view (a source filter it no longer matches, a service account that lost the right to read it) is scrubbed
737
+ * the same way, and the scrub cannot be undone.
738
+ *
739
+ * The row goes through the same scrub chokepoint the erasure door uses (`impersonalizeRowsInPlace`): its
740
+ * `.impersonalizeWith()` fields are scrubbed, and it is marked RETAINED (hidden from ordinary reads, immutable). Unlike
741
+ * an erasure, NO erasure suppression is written: nobody asked for this record to be forgotten, it only stopped being
742
+ * listed. So a record the source lists again loads as a NEW row (the destination's remote-key unique index is
743
+ * retention-scoped, so the retained row does not block it), and rows that referenced the scrubbed copy keep pointing at
744
+ * the scrubbed copy, not at the new one. A legal hold suspends the scrub, as it suspends the DELETE.
745
+ *
746
+ * Requires the destination to opt into the scrub door (`retentionPolicy: RETAIN_AND_IMPERSONALIZE`) and a CLOSED
747
+ * population; the factory refuses it otherwise. An archived Odoo record is never an orphan (see
748
+ * `ExternalDataArchivedRecordTreatment`), so archiving a record does not scrub its copy. Opt-in.
749
+ */
750
+ IMPERSONALIZE = 'impersonalize',
605
751
  }
606
752
 
607
753
  /**
@@ -1025,6 +1171,21 @@ export const ExternalDataFieldMappingEntrySchema = z.discriminatedUnion('kind',
1025
1171
  required: z.boolean().default(false),
1026
1172
  /** Which side owns the field — BIDIRECTIONAL pipelines only (#1723). Absent = REMOTE. */
1027
1173
  owner: z.enum(ExternalDataFieldOwner).optional(),
1174
+ /**
1175
+ * #2566 — the field's name in a WRITE member that spells it differently from the list the pipeline extracts through
1176
+ * (REST_JSON only). NetSuite's SuiteQL answers `companyname`, while its record service — which a create or an update
1177
+ * is sent to — names the same field `companyName`; sent under the list's name, the field is unknown there. Each key
1178
+ * names the field in that member; a member not named here uses `remoteField`. The same answer a read-through binding
1179
+ * gives in `fieldMappings[].remoteFieldByMember` (#2553).
1180
+ *
1181
+ * OUTBOUND pipelines only: nothing else sends a body (an INBOUND pipeline writes nothing, and a BIDIRECTIONAL one needs
1182
+ * a row-version read that only Odoo and OData serve). Refused on Odoo and OData, whose members share one wire shape,
1183
+ * and for a member the binding does not declare.
1184
+ */
1185
+ remoteFieldByMember: z.strictObject({
1186
+ create: z.string().trim().min(1).optional(),
1187
+ update: z.string().trim().min(1).optional(),
1188
+ }).optional(),
1028
1189
  }),
1029
1190
  z.strictObject({
1030
1191
  kind: z.literal(ExternalDataMappingEntryKind.CONSTANT),
@@ -1120,7 +1281,7 @@ export enum ExternalDataIncrementalExtractionMode {
1120
1281
  * and the next incremental pass reads the whole source again. The run summary says it did.
1121
1282
  */
1122
1283
  export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminatedUnion('mode', [
1123
- z.object({
1284
+ z.strictObject({
1124
1285
  mode: z.literal(ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE),
1125
1286
  /**
1126
1287
  * When FULL passes run (cron). The only deletion detector, so required. A full pass that takes
@@ -1145,7 +1306,7 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
1145
1306
  * re-read by the next pass. Changing `modifiedAtRemoteField` starts the track over (the stored watermark
1146
1307
  * names the property it was read on).
1147
1308
  */
1148
- z.object({
1309
+ z.strictObject({
1149
1310
  mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT),
1150
1311
  fullPassCron: z.string().trim().min(1),
1151
1312
  /** The entity's modified-at property (`Edm.DateTimeOffset`), by its REMOTE name. */
@@ -1162,18 +1323,26 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
1162
1323
  *
1163
1324
  * Refused at declaration: a `sourceFilter` (Dataverse refuses `$filter`, `$orderby`, `$expand` and `$top`
1164
1325
  * with change tracking) and a composite key (a deleted entity names one id). A delta link the service no
1165
- * longer honours (`410 Gone`) resets the track and the same run falls back to a FULL pass, which is what
1166
- * finds the deletions the expired link would have reported; the run summary says so.
1326
+ * longer honours resets the track and the same run falls back to a FULL pass; the run summary says so. "No longer
1327
+ * honours" is `410 Gone` or `404 Not Found` — the two answers the protocol lets a service give for an expired URL —
1328
+ * or one of the vendor's own error codes for an expired change position, declared by its system-of-record facet as
1329
+ * `odataExpiredChangePositionErrorCodes` (#2104 review F6). That pass finds most of what the expired link would have reported, not all of it: when it completes it
1330
+ * orphans every row it did not see, so a row deleted before the pass read its key is found, but one deleted after
1331
+ * both the pass read it and the old link's last read, and before the next incremental run opens a new link, is
1332
+ * found only by the next full pass.
1167
1333
  * spec-cite: Microsoft Learn, "Use change tracking to synchronize data with external systems"
1168
1334
  * (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/use-change-tracking-synchronize-data-external-systems),
1169
1335
  * "Query options not supported in Change Tracking Web API request" — "System query options $filter,
1170
1336
  * $orderby, $expand, and $top aren't supported when you use the Prefer: odata.track-changes header".
1171
1337
  * spec-cite: OData Version 4.01 Part 1: Protocol §9.2.4 — "410 Gone indicates that the requested resource is
1172
1338
  * no longer available. This can happen if a client has waited too long to follow a delta link".
1339
+ * spec-cite: OData Version 4.01 Part 1: Protocol §11.2 — "If a client subsequently requests the advertised resource and
1340
+ * the URL has expired, then the service SHOULD respond with 410 Gone. If this is not feasible, the service MUST respond
1341
+ * with 404 Not Found."
1173
1342
  *
1174
1343
  * No lookback: a delta link is the service's own position, not a clock.
1175
1344
  */
1176
- z.object({
1345
+ z.strictObject({
1177
1346
  mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK),
1178
1347
  fullPassCron: z.string().trim().min(1),
1179
1348
  }),
@@ -1195,7 +1364,7 @@ export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT: Readonly<Record<ExternalDat
1195
1364
  ### Origin Package: `@wildo-ai/saas-models`
1196
1365
 
1197
1366
  ```typescript
1198
- export const ExternalDataPipelineDeclarationSchema = z.object({
1367
+ export const ExternalDataPipelineDeclarationSchema = z.strictObject({
1199
1368
  /**
1200
1369
  * Which way rows travel — see {@link ExternalDataPipelineDirection}. `INBOUND` when omitted.
1201
1370
  *
@@ -1210,7 +1379,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1210
1379
 
1211
1380
  /**
1212
1381
  * The source half — the SAME binding declaration the VIRTUAL mode uses (the system of record it
1213
- * reads, entity, dialect, key fields + codecs, remote-call semantics, erasure stance).
1382
+ * reads, entity, dialect, key fields + codecs, remote-call semantics, subject-rights posture).
1214
1383
  *
1215
1384
  * Every source is a SYSTEM OF RECORD: a deployment the OPERATOR runs, read with the application's
1216
1385
  * own service identity, with ONE owner organization. There is no per-tenant variant to confine
@@ -1245,9 +1414,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1245
1414
  * On an OUTBOUND pipeline (#1690) it is empty until the row is first sent: the engine writes the key the system of
1246
1415
  * record answers the create with, exactly once, and then updates the remote row it names. It must therefore accept
1247
1416
  * absence, and it is still excluded from create and update — a caller that could write it could point a local row at
1248
- * any remote record. It must be `.isUnique()` (global, sparse — the default) and `.optional()`, never `.nullable()`:
1249
- * one remote record, one local row, enforced by the store on every path that writes the key, while the rows not yet
1250
- * sent (no key) stay outside the index. No business key is required there: nothing upserts on it.
1417
+ * any remote record. It must be `.isUnique()` (global, sparse — the default): one remote record, one local row,
1418
+ * enforced by the store on every path that writes the key, while the rows not yet sent stay outside the index on both
1419
+ * stores, whether their key is absent or null (#2582). Declare it `.optional()`, so "no key yet" has one
1420
+ * representation. No business key is required there: nothing upserts on it.
1251
1421
  */
1252
1422
  remoteKeyLocalField: z.string().trim().min(1),
1253
1423
 
@@ -1268,13 +1438,20 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1268
1438
  * subsidiary to their own company's rows. Declare the destination narrowable on this field.
1269
1439
  *
1270
1440
  * `partitionKeyLocalField` carries the REMOTE key verbatim — Odoo's `company_id`, NetSuite's
1271
- * `subsidiary`. It exists because the unit id CANNOT answer the question the orphan walk asks.
1272
- * When an operator unassigns a partition, the unit still exists and other rows still point at it;
1273
- * only the partition→unit edge is gone. A row loaded before the unassignment therefore still
1274
- * carries a perfectly valid unit id, and nothing about it says "this row's partition is no longer
1275
- * mapped". Without the remote key stored per row, the next pass sees those rows absent from the
1276
- * extraction and an orphan policy of DELETE erases them — an operator's unassignment becoming a
1277
- * mass delete.
1441
+ * `subsidiary`. It is the FACT the unit was derived from: the unit is a function of this key and
1442
+ * the assignment map at load time, and the map changes. Keep only the unit and, once a partition
1443
+ * is reassigned or unassigned, nothing on the row says which partition it belongs to — the unit
1444
+ * id still resolves, and says nothing about the edge that produced it. With the key stored, a
1445
+ * row's partition is answered locally: shown to people, queryable, and READ ON EVERY CALLER'S QUERY
1446
+ * (#2479): a non-exempt caller — organization-wide included — sees only rows whose stored key is
1447
+ * assigned to a unit, or unset (shared). That is what keeps the rows loaded before a partition was
1448
+ * unassigned from being read through the unit they still carry: nothing re-stamps a row that is no
1449
+ * longer loaded, so the unit alone would keep confining them to the unit the operator withdrew.
1450
+ *
1451
+ * It is NOT what keeps an unassignment from becoming a mass delete, and no orphan walk reads it
1452
+ * (#2478). That guard is in the transform: a pipeline extracts every row, unassigned partitions
1453
+ * included, and a row whose partition has no unit is left out of the load while its business key
1454
+ * is counted as OBSERVED, so a complete pass never sees it as gone.
1278
1455
  *
1279
1456
  * Both are ENGINE-WRITTEN: the transform stamps them from the assignment map, so a mapping entry
1280
1457
  * targeting either is refused, as is a caller write (the factory requires both
@@ -1358,6 +1535,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1358
1535
  * It bounds extraction and load together: each page is loaded before the next is read (#1689), so a
1359
1536
  * run finishes after the page it was working on, by at most one page's extraction and load.
1360
1537
  *
1538
+ * A BIDIRECTIONAL run's two halves share it (#2107): the loading half starts no page after two thirds, and the sending
1539
+ * half runs until the whole deadline, so a long inbound pass never leaves the sending half no time (it keeps about the
1540
+ * last third). A keyed run, which sends nothing, reads to the whole deadline.
1541
+ *
1361
1542
  * Fifteen minutes by default: well inside an hourly `scheduleCron`, and long enough that a pass of the
1362
1543
  * default `maxRowsPerRun` completes at even a small binding ceiling. Six hours at most — a run that
1363
1544
  * needs longer is a backfill, and resuming across runs is what the cursor is for.
@@ -1379,6 +1560,8 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1379
1560
  - `references/odata-v2-sources.md` — reading an OData v2 service (`ODATA_V2`): declaring it, why the
1380
1561
  engine reads the service's `$metadata`, the values it decodes and refuses, how a pipeline walks it by
1381
1562
  key rather than by `__next`, and what it cannot do.
1563
+ - `references/framework-system-of-record-capabilities-api.md` — what the engine can do over a binding (sort, writes,
1564
+ partitions, incremental modes, actions), asked instead of restated per vendor.
1382
1565
  - `references/system-of-record-actions.md` — running a declared ERP action (Odoo `action_post`, an
1383
1566
  OData action): the declaration, who may run it on which record, its one HTTP door, and its codes.
1384
1567
  - `references/lane-selection.md` — the choice in Step 1 at more depth, including what each lane
@@ -1389,14 +1572,17 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1389
1572
  its mapping, read what each one last did (`cursor`, `loadStatus`) and its health, list its run
1390
1573
  history with the rows each run refused (`GET …/runs`), and reset a pipeline whose run keeps
1391
1574
  refusing its stored state (`POST …/reset`).
1575
+ - `references/requested-keys.md` — a system of record announcing which records changed: the inbound handler's
1576
+ `ctx.pipelines.requestPipelineKeys`, the keyed run, why a busy pipeline drops nothing, what it never deletes,
1577
+ and which pipelines can take it.
1392
1578
  - `references/incremental-extraction.md` — reading only what changed: the two tracks, the Odoo
1393
1579
  `write_date` watermark and its lookback, the fingerprint that re-reads the source, and why a
1394
1580
  full-pass cadence is required.
1395
1581
  - `references/rate-budgets-and-pacing.md` — the instance budget and the binding ceiling, how a
1396
1582
  pipeline paces against them, `maxRunDurationMs`, how to size the numbers, and the measured load
1397
1583
  throughput a pass costs the store.
1398
- - `references/erasure-suppression.md` — why an erased copied row is not re-imported, what a run counts,
1399
- when a suppression is released, and the key-rotation refusal.
1584
+ - `references/erasure-suppression.md` — why an erased row of an `OWNED_COPY` is not re-imported (a following copy
1585
+ writes no suppression), what a run counts, when a suppression is released, and the key-rotation refusal.
1400
1586
  - `references/declared-expressions.md` — `ENUM_MAP`, `CONCATENATION`, `ARITHMETIC`, `CONDITIONAL`: a
1401
1587
  local value derived from remote fields, what startup checks, why there is no transform function, and
1402
1588
  how an expression edit reaches rows an incremental pass would not re-read.
@@ -1412,6 +1598,9 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1412
1598
  - `references/outbound-pipelines.md` — `direction: OUTBOUND`: sending the application's own rows to a
1413
1599
  system of record — the declaration, the reversed field ownership, what each pass sends and never sends,
1414
1600
  partition placement, the unknown-outcome create that waits for an operator, and what a pass reports.
1601
+ - `references/bidirectional-pipelines.md` — `direction: BIDIRECTIONAL`: one resource edited on both sides —
1602
+ field ownership, the vendor's row version, what a run loads and sends, the three conflict policies, the
1603
+ operator's door for a refused conflict, what is audited and reported, and the stated limits.
1415
1604
  - `references/provenance-cue.md` — the "synced from ⟨instance⟩ · as of ⟨pass⟩" note on pipeline-written
1416
1605
  fields: which fields carry it, what "as of" means, the read surface and instance label it needs, and
1417
1606
  who may read it.
@@ -1419,7 +1608,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1419
1608
  ## Verification
1420
1609
 
1421
1610
  - [ ] The resource declares exactly one lane, not both.
1422
- - [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `erasure` is stated.
1611
+ - [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `subjectRights` is left out unless the rows hold no subject data or each erasure is forwarded.
1423
1612
  - [ ] A binding whose rows hold personal data names `purposeRefs` that exist in
1424
1613
  `operatorComplianceIdentity.lawfulBases`.
1425
1614
  - [ ] An instance whose resources hold personal data declares `personalDataOrigin`.
@@ -1431,7 +1620,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1431
1620
  custom operation named in `actions.<name>.operation`, borrowing `UPDATE`, with
1432
1621
  `idempotencyKey: REQUIRED`, whose implementation calls `utils.systemOfRecordActions.run(...)`; no
1433
1622
  code reaches the ERP any other way.
1434
- - [ ] Either lane: a binding declaring `erasure: NO_SUBJECT_DATA` brings no field that declares
1623
+ - [ ] Either lane: a binding declaring `subjectRights: NO_SUBJECT_DATA` brings no field that declares
1435
1624
  `.dataCategories()` (read-through: any field; pipeline: any mapped field).
1436
1625
  - [ ] Virtual writes: a field landing on the partition field is excluded from create and update.
1437
1626
  - [ ] Virtual writes: the client handles `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` by reading the row,
@@ -1447,8 +1636,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1447
1636
  `remoteCallSemantics.maxRequestsPerMinute` strictly below it, and `maxRunDurationMs` fits the
1448
1637
  pipeline's `scheduleCron` interval.
1449
1638
  - [ ] Pipeline: verify first and last batch keys remain present across a resumed pass; then remove a source row and verify the configured orphan policy. Check reconciliationStatus for skipped reconciliation and loadStatus for failed writes.
1450
- - [ ] Pipeline holding personal data: erase one copied row, run a full pass, and confirm the row is not
1451
- back as a live row and the run reports `suppressedRows: 1`.
1639
+ - [ ] `OWNED_COPY` pipeline holding personal data: erase one copied row, run a full pass, and confirm the
1640
+ row is not back as a live row and the run reports `suppressedRows: 1`.
1641
+ - [ ] Following copy holding personal data: remove its record at the source, run a full pass, and confirm the
1642
+ copy keeps none of the person's data (gone under `DELETE`, scrubbed under `IMPERSONALIZE`).
1452
1643
  - [ ] REST_JSON pipeline source: the binding's `list` statement declares `keyset` on its single key
1453
1644
  field; a SOQL one declares `cursorPath`, a SuiteQL one `pagingParams` with
1454
1645
  `placement: 'query-string'`.
@@ -1461,11 +1652,19 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
1461
1652
  code); each `CONCATENATION` targets a string field, each `ARITHMETIC` a number field, and a
1462
1653
  currency conversion uses a declared `factor`.
1463
1654
  - [ ] OUTBOUND pipeline: `writableVerbs` includes `CREATE`; the mapped fields are caller-writable;
1464
- `remoteKeyLocalField` is an optional (not nullable) `.isUnique()` string excluded from create and update; no sent field declares
1655
+ `remoteKeyLocalField` is an optional `.isUnique()` string excluded from create and update; no sent field declares
1465
1656
  `.dataCategories()`; on a partitioned instance `partitionUnitLocalField` names the row's unit.
1466
1657
  - [ ] OUTBOUND pipeline: create a row, run a pass, and confirm the row gained its remote key and the
1467
1658
  record exists remotely; edit it, run again, and confirm exactly one update; a row of another
1468
1659
  organization is never sent (`droppedOtherOrganization`).
1660
+ - [ ] BIDIRECTIONAL pipeline: every mapped entry that is not Odoo's-only declares `owner`; `population` is
1661
+ `OPEN`; the vendor facet declares `rowVersionField` (Odoo or OData v4); `conflictPolicy` is chosen on purpose.
1662
+ - [ ] BIDIRECTIONAL pipeline: edit a `BOTH` field on each side, run, and confirm the declared policy's outcome
1663
+ in the run's `conflicts` — and for `REFUSE_AND_REPORT`, that neither side's value moved.
1664
+ - [ ] A handler asking a pipeline to re-read (`requestPipelineKeys`) lists that resource in its
1665
+ `pipelineKeyRequests`, and the pipeline is INBOUND on Odoo or OData v4; the pipeline keeps its
1666
+ `scheduleCron`. Send a notification naming one changed record and confirm the run history shows a
1667
+ `keyed` run with `drainedRequestedKeys: 1` and only that row changed.
1469
1668
  - [ ] The application starts. Every rule above is checked at startup, by name.
1470
1669
 
1471
1670
  ### Grep invariants
@@ -1495,6 +1694,12 @@ rg -n 'maxRequestsPerMinute' wildo.saas.config.ts shared-lib/src
1495
1694
  # OUTBOUND pipelines — each mapped field must be caller-writable and its remote key an optional string.
1496
1695
  rg -B2 -A12 'ExternalDataPipelineDirection.OUTBOUND' shared-lib/src --glob '*.resources-config.ts'
1497
1696
 
1697
+ # BIDIRECTIONAL pipelines — each owner declared, OPEN population, a conflict policy chosen on purpose.
1698
+ rg -B2 -A16 'ExternalDataPipelineDirection.BIDIRECTIONAL' shared-lib/src --glob '*.resources-config.ts'
1699
+
1700
+ # Requested keys — every handler calling requestPipelineKeys declares the resource in pipelineKeyRequests.
1701
+ rg -l 'requestPipelineKeys' backend-api/src/modules | xargs rg --files-without-match 'pipelineKeyRequests'
1702
+
1498
1703
  # Bulk write operations on a virtual resource — refused; a remote bulk write has no atomicity.
1499
1704
  rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOperation'
1500
1705
  ```
@@ -1503,6 +1708,8 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
1503
1708
 
1504
1709
  | Rationalization | Reality |
1505
1710
  |---|---|
1711
+ | "The webhook body has the new values, so the handler can write them straight into the synced resource." | The synced fields are the pipeline's to write, and a notification body is not the system of record — it can be stale, partial, forged or replayed. Name the records with `ctx.pipelines.requestPipelineKeys`; the pipeline re-reads them from the source. |
1712
+ | "Notifications keep it fresh, so the schedule can go." | A vendor drops notifications, and a keyed read never finds a deletion. Keep `scheduleCron`: requested keys make a pipeline fresher, not complete. |
1506
1713
  | "Virtual is cleaner — no copy to keep in sync." | Cleaner until the first requirement it cannot meet. A virtual resource can hold no files, feed no retrieval corpus, and carry no local column. Those are not edge cases; they are the second and third things most applications ask for. |
1507
1714
  | "I'll mark the synced fields writable and let users fix bad data." | Then the next sync overwrites their edit and nobody knows why. Remote-authoritative fields are read-only *because* the remote system wins; if users must edit, that field belongs in the local half, not the mapping. |
1508
1715
  | "I'll sync everything from the remote entity, just in case." | Every mapped field is personal data you now store, retain and must erase. Map what the application uses. |
@@ -1527,7 +1734,9 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
1527
1734
  - `population: CLOSED` alongside a create-shaped custom operation — refused at startup, and the
1528
1735
  message names the operation.
1529
1736
  - A run reporting rejected rows after the source added a selection value — an `ENUM_MAP` that does not
1530
- map it; catch it with the declared-expressions grep above and map the code.
1737
+ map it, or a plain mapping onto an enum field that now receives a value outside the field's members
1738
+ (such a row is rejected, never loaded with a value the field refuses); catch it with the
1739
+ declared-expressions grep above and map the code.
1531
1740
  - Concurrent pipeline execution across application instances — single-instance execution is required until destination mutations have exclusive ownership. Checkpoint conflicts alone do not fence deletion.
1532
1741
  - A binding whose `system` was copied from another resource without checking the instance is the one
1533
1742
  you meant — two instances of one vendor differ only by that name.
@@ -1548,8 +1757,13 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
1548
1757
  (`suppressedRows` above zero is expected; never delete a suppression to "fix" it — that re-imports.)
1549
1758
  - An OUTBOUND pipeline whose runs show `waiting.awaitingOperator` above zero — creates of unknown outcome that
1550
1759
  nobody has answered and that are never sent again on their own; look each up in the system of record and answer
1551
- it through `POST /internal/admin/external-data/outbound-changes/resolve`. Catch the declarations with the
1552
- OUTBOUND grep above.
1760
+ it through `POST /internal/admin/external-data/outbound-changes/resolve`. One whose `lastOutcomeCode` is
1761
+ `remote-key-held-by-another-row` first needs the wrong holder unlinked (`…/outbound-changes/unlink`; see
1762
+ `references/outbound-pipelines.md`). Catch the declarations with the OUTBOUND grep above.
1763
+ - A BIDIRECTIONAL pipeline whose runs keep reporting `conflicts.refused` above zero — rows edited on both
1764
+ sides that nobody has chosen a side for; they are neither loaded over nor sent until someone does, through
1765
+ `POST /internal/admin/external-data/outbound-changes/conflicts/resolve`. Catch the declarations with the
1766
+ BIDIRECTIONAL grep above.
1553
1767
  - A `STANDALONE` primary-scope anchor on a virtual resource. It answers 403 `parent_scope_denied` to
1554
1768
  an organization owner, because the execution context's organization id comes from the URL and a
1555
1769
  standalone resource is not routed under its scope parent — measured, not inferred.
@@ -1560,3 +1774,5 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
1560
1774
  - `resource-schema-authoring` — the field declarations a destination schema needs.
1561
1775
  - `resource-rag-source-fields` — indexing pipeline-fed text for retrieval (a pipeline lane only).
1562
1776
  - `application-database-migrations` — a new destination resource on PostgreSQL owes a migration.
1777
+ - `inbound-channels` — receiving a system of record's change notification, and asking the pipeline to
1778
+ re-read the records it names (`ctx.pipelines`).