@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
@@ -5,8 +5,8 @@ or will be disclosed" (GDPR Art. 15(1)(c)), and after an erasure the controller
5
5
  to whom the personal data have been disclosed" and name them on request (Art. 19).
6
6
 
7
7
  <!-- spec-cite: GDPR Art. 15(1)(c) https://gdpr-info.eu/art-15-gdpr/ and Art. 19 https://gdpr-info.eu/art-19-gdpr/ (fetched 2026-09-29) --> Your running backend answers both from
8
- ONE derived list, `compliance.subjectDataRecipients`: every provider your declared flows reach, with
9
- the legal entity your processor register adopted, the categories each flow carries and each recipient's erasure stance.
8
+ ONE derived list, `compliance.subjectDataRecipients`: every provider your declared flows reach and every vendor-hosted
9
+ system of record, with the legal entity your processor register adopted, the categories each flow carries and each recipient's erasure stance.
10
10
 
11
11
  Read this when:
12
12
 
@@ -36,18 +36,45 @@ and absent a stance it is UNMEASURED:
36
36
  | stance | where it is declared | erasure reports |
37
37
  |---|---|---|
38
38
  | `NO_SUBJECT_DATA` | the provider's `complianceProfile.subjectErasure` — the vendor keeps nothing about a subject beyond the call | `DECLARED_NO_SUBJECT_DATA` (complete) |
39
- | `EXTERNAL_ERASURE_OPERATION` | the provider's `complianceProfile.subjectErasure` — an erasure effect reaches it | the effect's status, or `NOT_REGISTERED` when none is registered |
39
+ | `EXTERNAL_ERASURE_OPERATION` | the provider's `complianceProfile.subjectErasure` — an erasure effect reaches it; for a provider package, also YOUR `providerComplianceChoices.<ref>.subjectReferences` (below) | the effect's status, or `NOT_REGISTERED` when none is registered |
40
+ | vendor deletion window | YOUR `providerComplianceChoices.<ref>.vendorScheduledDeletion: { retentionDays, basis }` — the vendor deletes what it received on its own published schedule | `COMPLETES_AT_VENDOR`, with the window and the date it lapses: "completes at the vendor by <date>" — neither complete nor incomplete |
40
41
  | `CONTROLLER_ACKNOWLEDGED_NON_ERASURE` | YOUR `providerComplianceChoices.<ref>.subjectErasureAcknowledgement: { reason }` — you accept that erasure does not reach it | `ACKNOWLEDGED_NON_ERASURE` (still incomplete: the data stays live there) |
41
42
  | none | — | `UNMEASURED` |
42
43
 
43
- A recipient is listed as CARRYING the subject's data when its flow names one of the subject's resources, or when the
44
- subject is an account holder (a user) and the capability's categories meet the subject's: the engine composes those
45
- calls from account holders' data. For any other subject — a CRM contact — a capability vendor is listed as MAY HAVE
46
- RECEIVED, and so is every recipient when a resource declares a personal field with no category. An effect registered
47
- for a vendor that does not apply to this subject's type reports UNMEASURED, not complete.
48
-
49
- A vendor stance is a fact about the vendor's product, stated by whoever authors its provider module. An acknowledgement
50
- is your decision as controller; write the reason you would give a data subject. Neither ever blocks an erasure — an
44
+ Prefer a deletion window to an acknowledgement whenever the vendor PUBLISHES how long it keeps what it received: the
45
+ outcome then promises a date instead of an open hole. `retentionDays` is that promise, so take the vendor's upper bound
46
+ for your plan, backups included where it states them, and put the published sentence and its URL in `basis`. A window
47
+ the vendor does not publish cannot be declared; acknowledge instead. The two are exclusive on one choice, and a window
48
+ is refused on a provider whose own profile already states a stance. An effect that reaches the vendor still wins over
49
+ either.
50
+
51
+ A provider PACKAGE that erases at its vendor needs one declaration from you: where you keep a person's identifier at
52
+ that vendor, because the package does not know your resources.
53
+ `providerComplianceChoices.<ref>.subjectReferences: [{ resourceType: 'users', referenceField: 'email' }]` reads it from
54
+ the person's own row; `{ resourceType: 'acmeAccounts', referenceField: 'acmeAccountId', subjectLinkField: 'userId' }`
55
+ reads it from a row that IS their account at the vendor; `referenceField: '_id'` when the vendor knows them by your
56
+ own id. A linked row must describe the person, never records they own about other people: contacts a salesperson
57
+ owns are not the salesperson, and declaring them would delete those contacts at the vendor when the salesperson is
58
+ erased. The engine reads it
59
+ before the local scrub, so a field the erasure blanks still works. Without it, the effect is not registered, a boot
60
+ warning names the missing declaration, and every erasure reports the vendor `NOT_REGISTERED`. References are refused
61
+ beside an acknowledgement or a deletion window, and on a provider whose stance is not `EXTERNAL_ERASURE_OPERATION`.
62
+ Run `wildo config subject-data-recipients` after changing them. A re-run of an erasure reports such a vendor
63
+ `UNMEASURED`, because the person's row can no longer be read: reconcile it at the vendor. Identifiers read from rows
64
+ under a legal hold are not sent; when all of them are, the vendor reads `KEPT_UNDER_LEGAL_HOLD`. Like the rows the hold
65
+ keeps locally, that leaves the erasure for review (the data is still at the vendor): file a new erasure once the hold
66
+ is released.
67
+
68
+ A recipient is listed as CARRYING the subject's data when the subject is an account holder (a user) and the
69
+ capability's categories meet the subject's: the engine composes those calls from account holders' data. For any other
70
+ subject — a CRM contact — a capability vendor is listed as MAY HAVE RECEIVED, and so is every recipient when a resource
71
+ declares a personal field with no category. A system of record is never listed as carrying: it may hold this subject's
72
+ records. An effect registered for a vendor that does not apply to this subject's type reports UNMEASURED, not complete
73
+ (a system of record's reports `HANDLED_AT_SOURCE`, below).
74
+
75
+ A vendor stance is a fact about the vendor's product, stated by whoever authors its provider module. A deletion window
76
+ and an acknowledgement are yours, because they depend on the plan and terms you hold with the vendor; write the reason
77
+ you would give a data subject. Neither ever blocks an erasure — an
51
78
  incomplete outcome MARKS the receipt for review.
52
79
 
53
80
  ## Say who owes the communication
@@ -58,11 +85,40 @@ processor (Art. 28(3)(e)), or the tenant for a vendor it connected with its own
58
85
  allocation names reads ROLE UNDECLARED — including a misspelt resource type, which nothing reports, so copy the
59
86
  types from your shared-lib enums. The role is read from the SUBJECT's resource type only.
60
87
 
61
- ## Systems of record are not in this list
88
+ ## Systems of record in this list
89
+
90
+ A `systemsOfRecord` instance (an Odoo, a SAP) answers requests about its own records: each bound resource reports its own
91
+ `http-api:<resource>` outcome under its binding's `subjectRights` posture. By default (`HANDLED_AT_SOURCE`) the outcome
92
+ states that the system of record handles requests about its own records; `NO_SUBJECT_DATA` states there is nothing about
93
+ a person there; `FORWARDED_TO_SOURCE` also asks it to delete the linked rows; `OWNED_COPY` (a pipeline copy the
94
+ application keeps beyond its source) states the source answers for its records while your erasure acts on the copy.
95
+
96
+ Whether the instance is a recipient depends on who runs it:
97
+
98
+ - **Self-hosted** (a `SELF_HOSTED` compliance choice): it is your own system, where the records live, and Art. 4(9)
99
+ makes a recipient a body the data is DISCLOSED to. It is not a recipient, here or in the notice.
100
+ - **Vendor-hosted**: its vendor is a processor, and Art. 4(9) counts a processor as a recipient ("whether a third party
101
+ or not"). An Art. 15 answer must name the actual recipients, so it is in this list, as a recipient of kind
102
+ `system-of-record`, as well as in the notice's recipients clause.
103
+
104
+ A vendor-hosted instance has one erasure outcome, and it is the system of record's: the outcome its bound resources'
105
+ effects reported when one applies to the subject, otherwise `HANDLED_AT_SOURCE` (the system answers for its records, and
106
+ no erasure effect of a resource bound to it applies to that subject's type). It carries no erasure stance, no vendor deletion
107
+ window and no subject references, so `wildo config subject-data-recipients` refuses an operator choice that declares one
108
+ of those for the instance: declare the posture on the resources' bindings instead.
62
109
 
63
- A `systemsOfRecord` instance (an Odoo, a SAP) is maintained on its own: an erasure reaches it per bound resource through
64
- the binding's declared erasure stance (`httpApiBinding.erasure`), and each such resource reports its own
65
- `http-api:<resource>` outcome. It never appears among these recipients, so the two mechanisms cannot disagree.
110
+ - **Its vendor's legal identity** comes from your processor register, in a `CONFIGURED_PROVIDER` entry whose
111
+ `providerRef` is the instance name. Without one the export says the legal entity is not recorded.
112
+ - **Its categories are not read** by the generator, because they come from your resource configurations, which only a
113
+ built backend can produce. So the export names it, for every subject, as a recipient that may hold their records.
114
+ - **A provider and an instance cannot share a name.** The erasure attributes each outcome to a recipient by name, so the
115
+ generator refuses the clash; rename the instance.
116
+
117
+ Do not add a system of record to `subjectDataRecipients` by hand: the generator would overwrite it. A vendor-hosted system that RECEIVES data from a pipeline
118
+ (an `outbound-pipeline` flow) is also named on the notice's recipient side; a self-hosted one is not, because it is no
119
+ recipient, so a self-hosted system the application only sends to appears in neither fact.
120
+
121
+ <!-- spec-cite: GDPR Art. 4(9) https://gdpr-info.eu/art-4-gdpr/ (fetched 2026-10-05); EDPB Guidelines 01/2022 on the right of access, v2.1 §117 https://www.edpb.europa.eu/system/files/2023-04/edpb_guidelines_202201_data_subject_rights_access_v2_en.pdf (fetched 2026-10-05) -->
66
122
 
67
123
  ## Import Origins
68
124
 
@@ -72,6 +128,88 @@ the binding's declared erasure stance (`httpApiBinding.erasure`), and each such
72
128
 
73
129
  ### Origin Package: `@wildo-ai/saas-models`
74
130
 
131
+ ```typescript
132
+ */
133
+ import { z } from 'zod';
134
+
135
+ import { HttpApiErasureStance } from '../../http-api-binding/http-api-erasure-stance.shared';
136
+
137
+ /**
138
+ * The stance a VENDOR declares about subject data it keeps (#1710) — on the provider's compliance profile. The D6
139
+ * vocabulary, narrowed to the two stances a vendor fact can take: the third, an acknowledged non-erasure, is the
140
+ * CONTROLLER's act and is declared by the operator ({@link ProviderSubjectErasureAcknowledgementSchema}).
141
+ */
142
+ export const ProviderSubjectErasureDeclarationSchema = z.strictObject({
143
+ /**
144
+ * - `NO_SUBJECT_DATA`: the vendor keeps nothing about a subject beyond the call itself — erasure reports
145
+ * DECLARED_NO_SUBJECT_DATA, which is complete.
146
+ * - `EXTERNAL_ERASURE_OPERATION`: an erasure effect in the external-effects registry reaches this vendor (the billing
147
+ * effect for a billing provider). If none is registered for it at runtime, erasure reports NOT_REGISTERED.
148
+ */
149
+ stance: z.enum({
150
+ NO_SUBJECT_DATA: HttpApiErasureStance.NO_SUBJECT_DATA,
151
+ EXTERNAL_ERASURE_OPERATION: HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION,
152
+ }),
153
+ });
154
+ export type ProviderSubjectErasureDeclaration = z.infer<typeof ProviderSubjectErasureDeclarationSchema>;
155
+
156
+ /**
157
+ * The OPERATOR's acknowledgement that erasure does not reach this vendor (#1710): the D6 stance
158
+ * CONTROLLER_ACKNOWLEDGED_NON_ERASURE for a provider, on `providerComplianceChoices.<ref>`. Erasure then reports
159
+ * ACKNOWLEDGED_NON_ERASURE — still incomplete, because the data is still live at the vendor, however deliberate the
160
+ * decision was.
161
+ */
162
+ export const ProviderSubjectErasureAcknowledgementSchema = z.strictObject({
163
+ /** Why the operator accepts that erasure does not reach the vendor — "Resend deletes its logs within 90 days". */
164
+ reason: z.string().trim().min(1),
165
+ });
166
+ export type ProviderSubjectErasureAcknowledgement = z.infer<typeof ProviderSubjectErasureAcknowledgementSchema>;
167
+
168
+ /**
169
+ * The vendor's OWN published deletion schedule for what it received (#2074): the typed window an erasure reports as
170
+ * COMPLETES_AT_VENDOR — "completes at the vendor by <date>". Declared by the operator, on
171
+ * `providerComplianceChoices.<ref>.vendorScheduledDeletion`, because the window depends on the plan and terms this
172
+ * operator holds with the vendor.
173
+ *
174
+ * `retentionDays` is the number the date is computed from, and it must be the vendor's published UPPER bound for this
175
+ * operator's plan: the outcome promises the data is gone by that date. `basis` names where the vendor publishes it, so a
176
+ * reviewer can check the number against the source; the number is never parsed out of that prose.
177
+ */
178
+ export const ProviderVendorScheduledDeletionSchema = z.strictObject({
179
+ /** Days the vendor keeps what it received before deleting it, per its published terms. */
180
+ retentionDays: z.number().int().positive(),
181
+ /** The vendor's own statement of that window, and where it is published. */
182
+ basis: z.string().trim().min(1),
183
+ });
184
+ export type ProviderVendorScheduledDeletion = z.infer<typeof ProviderVendorScheduledDeletionSchema>;
185
+
186
+ /**
187
+ * Where the application keeps a person's identifier AT ONE VENDOR, so an erasure can hand it to that provider's erasure
188
+ * effect (#2006). Declared by the OPERATOR on `providerComplianceChoices.<ref>.subjectReferences`, because the provider
189
+ * package cannot know the application's resources. The engine reads the field BEFORE the local scrub and gives the
190
+ * provider only the values, never the rows.
191
+ *
192
+ * Two shapes:
193
+ * - `resourceType` IS the subject's type (`users`): the identifier is on the subject's own row, read by id.
194
+ * - `resourceType` is another resource: `subjectLinkField` names its foreign key to the subject, and every row
195
+ * linked to the subject contributes its identifier (a person with two accounts at the vendor).
196
+ *
197
+ * `referenceField` may be `_id` when the vendor knows the person by the application's own id (an analytics vendor's
198
+ * distinct id).
199
+ */
200
+ export const ProviderSubjectReferenceSchema = z.strictObject({
201
+ /** The resource whose rows hold the identifier. */
202
+ resourceType: z.string().trim().min(1),
203
+ /** The field holding the vendor's identifier for the person. */
204
+ referenceField: z.string().trim().min(1),
205
+ /** When `resourceType` is not the subject's type: its foreign-key field pointing at the subject. */
206
+ subjectLinkField: z.string().trim().min(1).optional(),
207
+ });
208
+ export type ProviderSubjectReference = z.infer<typeof ProviderSubjectReferenceSchema>;
209
+ ```
210
+
211
+ ### Origin Package: `@wildo-ai/saas-models`
212
+
75
213
  ```typescript
76
214
  */
77
215
  import { z } from 'zod';
@@ -80,9 +218,14 @@ import { z } from 'zod';
80
218
  import { HttpApiErasureStance } from '../../http-api-binding/http-api-erasure-stance.shared';
81
219
  import { OperatorProcessingRole } from './operator-compliance-identity.shared.schemas';
82
220
  import { PersonalDataCategory } from './personal-data-category.shared.schemas';
221
+ import { capabilityFlowsLinkableToSubject } from './provider-capability-disclosure.shared.schemas';
222
+ import { ProviderSubjectReferenceSchema } from './provider-subject-erasure-choice.shared.schemas';
83
223
  import {
84
224
  SubjectErasureExternalEffectStatus,
225
+ isCompletesAtVendorSubjectErasureExternalEffect,
226
+ subjectErasureVendorDeletionLapsesAt,
85
227
  type SubjectErasureExternalEffectOutcome,
228
+ type SubjectErasureVendorScheduledDeletion,
86
229
  } from './subject-erasure.shared.schemas';
87
230
 
88
231
  /** Why a recipient's categories are not all derivable (#1709) — the reason travels with the recipient to runtime. */
@@ -111,40 +254,34 @@ export enum SubjectDataRecipientReach {
111
254
  }
112
255
 
113
256
  /**
114
- * The stance a VENDOR declares about subject data it keeps (#1710) — on the provider's compliance profile. The D6
115
- * vocabulary, narrowed to the two stances a vendor fact can take: the third, an acknowledged non-erasure, is the
116
- * CONTROLLER's act and is declared by the operator ({@link ProviderSubjectErasureAcknowledgementSchema}).
257
+ * WHAT a recipient is, which decides where its one erasure answer comes from (#2585).
258
+ *
259
+ * Mirrors the recipient population's member kinds (`RecipientPopulationMemberKind` in `@wildo-ai/saas-specifications`,
260
+ * which this package cannot import); the derivation maps one onto the other with an exhaustive switch, so a member kind
261
+ * added there is a compile error until someone says what kind of recipient it makes.
117
262
  */
118
- export const ProviderSubjectErasureDeclarationSchema = z.strictObject({
263
+ export enum SubjectDataRecipientKind {
264
+ /** A configured provider: its erasure answer is its effect's, or the stance or window it declares. */
265
+ CONFIGURED_PROVIDER = 'configured-provider',
119
266
  /**
120
- * - `NO_SUBJECT_DATA`: the vendor keeps nothing about a subject beyond the call itself — erasure reports
121
- * DECLARED_NO_SUBJECT_DATA, which is complete.
122
- * - `EXTERNAL_ERASURE_OPERATION`: an erasure effect in the external-effects registry reaches this vendor (the billing
123
- * effect for a billing provider). If none is registered for it at runtime, erasure reports NOT_REGISTERED.
267
+ * A vendor-hosted system-of-record instance: its vendor is a processor, so a recipient. It declares no erasure stance:
268
+ * the system of record answers requests about its own records, so its answer is the HTTP_API effects' when one applies
269
+ * to the subject, and HANDLED_AT_SOURCE otherwise. A self-hosted instance is the controller's own system and is never
270
+ * a recipient.
124
271
  */
125
- stance: z.enum({
126
- NO_SUBJECT_DATA: HttpApiErasureStance.NO_SUBJECT_DATA,
127
- EXTERNAL_ERASURE_OPERATION: HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION,
128
- }),
129
- });
130
- export type ProviderSubjectErasureDeclaration = z.infer<typeof ProviderSubjectErasureDeclarationSchema>;
131
-
132
- /**
133
- * The OPERATOR's acknowledgement that erasure does not reach this vendor (#1710): the D6 stance
134
- * CONTROLLER_ACKNOWLEDGED_NON_ERASURE for a provider, on `providerComplianceChoices.<ref>`. Erasure then reports
135
- * ACKNOWLEDGED_NON_ERASURE — still incomplete, because the data is still live at the vendor, however deliberate the
136
- * decision was.
137
- */
138
- export const ProviderSubjectErasureAcknowledgementSchema = z.strictObject({
139
- /** Why the operator accepts that erasure does not reach the vendor — "Resend deletes its logs within 90 days". */
140
- reason: z.string().trim().min(1),
141
- });
142
- export type ProviderSubjectErasureAcknowledgement = z.infer<typeof ProviderSubjectErasureAcknowledgementSchema>;
272
+ SYSTEM_OF_RECORD = 'system-of-record',
273
+ }
143
274
 
144
275
  /** One recipient, as the running application needs to state it. */
145
276
  export const SubjectDataRecipientSchema = z.strictObject({
146
- /** The provider ref. A system of record is never a recipient here (see the module JSDoc). */
277
+ /** The provider ref, or the `systemsOfRecord` instance name of a vendor-hosted system of record. */
147
278
  ref: z.string().trim().min(1),
279
+ /**
280
+ * What the recipient is ({@link SubjectDataRecipientKind}). Defaults to a configured provider so a projection
281
+ * generated before the field existed still PARSES, for the boot-path reason given on `vendorScheduledDeletion` below:
282
+ * every recipient such a projection names is a provider, because systems of record were left out of it.
283
+ */
284
+ kind: z.enum(SubjectDataRecipientKind).default(SubjectDataRecipientKind.CONFIGURED_PROVIDER),
148
285
  /**
149
286
  * The legal entity the operator's processor register adopted for it, or `null` when the register has no entry — a
150
287
  * gap stated as such, never filled with a suggestion.
@@ -166,7 +303,57 @@ export const SubjectDataRecipientSchema = z.strictObject({
166
303
  * exists — erasure then reports UNMEASURED for this recipient.
167
304
  */
168
305
  erasureStance: z.enum(HttpApiErasureStance).nullable(),
169
- });
306
+ /**
307
+ * The vendor's declared deletion window, when the operator declared one (#2074) — erasure then reports
308
+ * COMPLETES_AT_VENDOR for this recipient. `null` otherwise. A recipient has one erasure answer, so it is never set
309
+ * beside `NO_SUBJECT_DATA` or an acknowledged non-erasure, and the projection refuses both.
310
+ *
311
+ * The one stance it may sit beside is `EXTERNAL_ERASURE_OPERATION` with NO `subjectReferences` (#2181): the vendor
312
+ * offers a deletion the operator has not armed (PostHog's person deletion needs a key the operator has not supplied),
313
+ * so no effect answers and the vendor's own schedule is the honest answer. Armed — references declared — the effect
314
+ * answers, and a window beside it is refused by the operator's choice schema already.
315
+ *
316
+ * Defaults to `null` so a projection generated before the field existed still PARSES: the backend imports its
317
+ * generated module at boot, and the generator reads the backend to discover providers, so a required field would
318
+ * leave an older projection unable to load and unable to be regenerated — the boot-path deadlock
319
+ * `continuity-drift-and-cas-basis.md` Rule 3 forbids. Absent and `null` mean the same: no window declared.
320
+ */
321
+ vendorScheduledDeletion: z.strictObject({ retentionDays: z.number().int().positive() }).nullable().default(null),
322
+ /**
323
+ * Where the application keeps the person's identifier at this vendor (#2006), as the operator declared it. Read by
324
+ * the provider's erasure effect registration; meaningful only beside the stance `EXTERNAL_ERASURE_OPERATION`, and
325
+ * refused with any other. Defaults to empty for the same reason as `vendorScheduledDeletion`: an older projection
326
+ * must still parse.
327
+ */
328
+ subjectReferences: z.array(ProviderSubjectReferenceSchema).default([]),
329
+ }).refine(
330
+ (recipient) => recipient.vendorScheduledDeletion === null
331
+ || recipient.erasureStance === null
332
+ || (recipient.erasureStance === HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION && recipient.subjectReferences.length === 0),
333
+ {
334
+ message: 'a recipient carries one erasure answer: a vendor deletion window sits beside no stance, or beside an erasure operation the operator has not armed with subject references',
335
+ path: ['vendorScheduledDeletion'],
336
+ },
337
+ ).refine(
338
+ (recipient) => recipient.subjectReferences.length === 0 || recipient.erasureStance === HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION,
339
+ {
340
+ message: 'subject references locate what an erasure effect deletes at the vendor, so they belong only to a recipient whose stance is EXTERNAL_ERASURE_OPERATION',
341
+ path: ['subjectReferences'],
342
+ },
343
+ ).refine(
344
+ // One erasure answer (#2585): a system of record's is the system-of-record answer, so it carries none of the three a
345
+ // provider may declare. Subject references need no clause here: the refine above already refuses them beside any stance
346
+ // other than EXTERNAL_ERASURE_OPERATION, and this one requires no stance. And the population reaches every instance with
347
+ // the application's own account, so it is never a tenant's vendor.
348
+ (recipient) => recipient.kind !== SubjectDataRecipientKind.SYSTEM_OF_RECORD
349
+ || (recipient.erasureStance === null
350
+ && recipient.vendorScheduledDeletion === null
351
+ && recipient.reach === SubjectDataRecipientReach.OPERATOR_ACCOUNT),
352
+ {
353
+ message: 'a system-of-record recipient answers an erasure through the system of record, so it carries no erasure stance and no vendor deletion window, and is reached with the operator\'s account',
354
+ path: ['kind'],
355
+ },
356
+ );
170
357
  export type SubjectDataRecipient = z.infer<typeof SubjectDataRecipientSchema>;
171
358
 
172
359
  /** Which resource types one operator role covers, from `operatorComplianceIdentity.roleAllocations[].resourceTypes`. */
@@ -200,9 +387,15 @@ export enum SubjectDataRecipientsStatementStatus {
200
387
 
201
388
  /** Why one recipient is listed for this subject. */
202
389
  export enum SubjectDataRecipientRelevance {
203
- /** Its derived categories meet this subject's data, or its flow names one of the involved resources. */
390
+ /**
391
+ * The subject is an account holder and the recipient's capability categories meet the subject's: the engine composes
392
+ * those calls from account holders' data. Never a system of record (#2585).
393
+ */
204
394
  CARRIES_SUBJECT_DATA = 'carries-subject-data',
205
- /** Its categories are not all derivable, or are a floor: it may have received this subject's data. */
395
+ /**
396
+ * Less certain: a category match for any other subject or for a system of record, categories not all derivable or
397
+ * only a floor, or a subject side not fully known. It may have received this subject's data.
398
+ */
206
399
  MAY_HAVE_RECEIVED = 'may-have-received',
207
400
  }
208
401
 
@@ -265,7 +458,8 @@ function obligationOf(reach: SubjectDataRecipientReach, role: OperatorProcessing
265
458
 
266
459
  /**
267
460
  * The `derivedFrom` token kind of a flow the ENGINE composes through a capability: `capability:<token>` (#1709), written
268
- * by `deriveRecipientDisclosures`. The only flow kind this list carries, because systems of record are kept out of it.
461
+ * by `deriveRecipientDisclosures`. A provider's flows are all of this kind; a system of record's are named by their
462
+ * resource flow (`read-through-binding:<resource>`, `pipeline:<resource>`, …).
269
463
  */
270
464
  export const RECIPIENT_CAPABILITY_FLOW_TOKEN_KIND = 'capability';
271
465
 
@@ -298,8 +492,19 @@ export function selectSubjectDataRecipients(params: {
298
492
  const involvedCategories = new Set(params.involvedCategories);
299
493
  const recipients: SubjectDataRecipientStatementEntry[] = [];
300
494
  for (const recipient of params.declaration.recipients) {
301
- const sharesACategory = recipient.categories.some((category) => involvedCategories.has(category));
302
- const carries = sharesACategory && params.subjectIsAccountHolder;
495
+ // A vendor reached ONLY through capabilities that carry nothing the application can tie to a person (#2074 — a
496
+ // captcha scoring an anonymous browser) holds no record a request about one subject could select. Its categories
497
+ // therefore cannot meet the subject's, and an unknown on the SUBJECT side cannot widen it in either: whatever the
498
+ // subject has, nothing at that vendor is attributable to them. An unknown on its OWN side (a flow nobody declared)
499
+ // still lists it, below.
500
+ if (isUnlinkableToAnySubject(recipient)) {
501
+ if (recipient.categoriesNotDerivable.length === 0) continue;
502
+ }
503
+ const sharesACategory = !isUnlinkableToAnySubject(recipient) && recipient.categories.some((category) => involvedCategories.has(category));
504
+ // The account-holder reasoning is about what the engine sends through a capability (see `subjectIsAccountHolder`).
505
+ // A system of record's categories are what its bound resources hold, for whichever records are there, so a match
506
+ // says only that it may hold this subject's records (#2585).
507
+ const carries = sharesACategory && params.subjectIsAccountHolder && recipient.kind !== SubjectDataRecipientKind.SYSTEM_OF_RECORD;
303
508
  const uncertain = sharesACategory
304
509
  || recipient.categoriesNotDerivable.length > 0
305
510
  || recipient.categoriesAreAFloor
@@ -314,6 +519,18 @@ export function selectSubjectDataRecipients(params: {
314
519
  return { status: SubjectDataRecipientsStatementStatus.DECLARED, operatorRole: role, recipients };
315
520
  }
316
521
 
522
+ /**
523
+ * Whether every flow that reaches this recipient is an engine CAPABILITY whose call carries nothing the application can
524
+ * tie to a person — `ProviderCapabilityDisclosure.linkableToSubjectByApplication`. A recipient with any other
525
+ * flow (a pipeline, a resource binding) or with no declared flow at all is linkable: an unknown names the vendor.
526
+ */
527
+ function isUnlinkableToAnySubject(recipient: SubjectDataRecipient): boolean {
528
+ if (recipient.derivedFrom.length === 0) return false;
529
+ const prefix = `${RECIPIENT_CAPABILITY_FLOW_TOKEN_KIND}:`;
530
+ if (!recipient.derivedFrom.every((token) => token.startsWith(prefix))) return false;
531
+ return !capabilityFlowsLinkableToSubject(recipient.derivedFrom.map((token) => token.slice(prefix.length)));
532
+ }
533
+
317
534
  /**
318
535
  * The statement of an application with no recipient declaration. Also the placeholder an orchestrator writes into a
319
536
  * report its caller completes (the erasure and export doors fill the real statement, as they fill `externalEffects`).
@@ -349,11 +566,15 @@ export interface SubjectErasureRecipientOutcome {
349
566
  status: SubjectErasureExternalEffectStatus | null;
350
567
  /** The effect refs that reached it — a registered effect, or the reconciliation's `recipient:<ref>`. */
351
568
  effectRefs: string[];
569
+ /** Present when `status` is COMPLETES_AT_VENDOR: the vendor's declared window and when it lapses for this erasure. */
570
+ vendorScheduledDeletion?: SubjectErasureVendorScheduledDeletion;
352
571
  }
353
572
 
354
573
  /**
355
574
  * Most-incomplete-wins when several effects reach one recipient: a PARTIAL next to a COMPLETED is still partial.
356
- * Ordered from the state a reader must act on first to the states that close the question.
575
+ * Ordered from the state a reader must act on first to the states that close the question. TOTAL over the enum, and
576
+ * pinned so: a member missing here would make `mostIncompleteSubjectErasureExternalEffectStatus` report UNMEASURED for a recipient whose one effect said
577
+ * something else (it happened to KEPT_UNDER_LEGAL_HOLD, #2006).
357
578
  */
358
579
  const STATUS_SEVERITY: readonly SubjectErasureExternalEffectStatus[] = [
359
580
  SubjectErasureExternalEffectStatus.PARTIAL,
@@ -361,12 +582,24 @@ const STATUS_SEVERITY: readonly SubjectErasureExternalEffectStatus[] = [
361
582
  SubjectErasureExternalEffectStatus.UNMEASURED,
362
583
  SubjectErasureExternalEffectStatus.NOT_REGISTERED,
363
584
  SubjectErasureExternalEffectStatus.ACKNOWLEDGED_NON_ERASURE,
585
+ SubjectErasureExternalEffectStatus.KEPT_UNDER_LEGAL_HOLD,
586
+ SubjectErasureExternalEffectStatus.COMPLETES_AT_VENDOR,
587
+ // Handled at the system of record (#2558): closed for the application's part, and still a statement that the data is
588
+ // elsewhere, so it outranks an erasure the application carried out itself.
589
+ SubjectErasureExternalEffectStatus.HANDLED_AT_SOURCE,
364
590
  SubjectErasureExternalEffectStatus.COMPLETED,
365
591
  SubjectErasureExternalEffectStatus.NOTHING_TO_ERASE,
366
592
  SubjectErasureExternalEffectStatus.DECLARED_NO_SUBJECT_DATA,
367
593
  ];
368
594
 
369
- function combinedStatus(statuses: readonly SubjectErasureExternalEffectStatus[]): SubjectErasureExternalEffectStatus {
595
+ /**
596
+ * The most incomplete of several statuses, by the one severity order above. Exported so every place that folds two
597
+ * answers into one (several effects reaching one recipient here; an effect that ran for some subjects while others were
598
+ * kept under a legal hold, #2260) reads the same order. UNMEASURED when given none.
599
+ */
600
+ export function mostIncompleteSubjectErasureExternalEffectStatus(
601
+ statuses: readonly SubjectErasureExternalEffectStatus[],
602
+ ): SubjectErasureExternalEffectStatus {
370
603
  return STATUS_SEVERITY.find((status) => statuses.includes(status)) ?? SubjectErasureExternalEffectStatus.UNMEASURED;
371
604
  }
372
605
 
@@ -375,6 +608,12 @@ function combinedStatus(statuses: readonly SubjectErasureExternalEffectStatus[])
375
608
  *
376
609
  * Every operator-account recipient gets a status, so none can pass silently:
377
610
  * - a registered effect that names it as its `recipientRef` → that effect's status;
611
+ * - otherwise a declared vendor deletion window decides first: COMPLETES_AT_VENDOR, carrying the window and the date it
612
+ * lapses ("completes at the vendor by <date>", #2074) — neither complete nor incomplete;
613
+ * - a vendor-hosted SYSTEM OF RECORD no applicable effect covers → HANDLED_AT_SOURCE (#2585): it answers requests about
614
+ * its own records, and no erasure effect of a resource bound to it applies to this subject's type. Never UNMEASURED, and
615
+ * never the "registered for other subjects" answer below: an HTTP_API effect that does not apply is not missing
616
+ * evidence about this subject, it is the declared statement that nothing of theirs flows through that binding;
378
617
  * - otherwise its stance decides: NO_SUBJECT_DATA → DECLARED_NO_SUBJECT_DATA (complete); an acknowledged
379
618
  * non-erasure → ACKNOWLEDGED_NON_ERASURE; EXTERNAL_ERASURE_OPERATION with no effect registered → NOT_REGISTERED;
380
619
  * no stance → UNMEASURED. Each becomes an `externalEffects` outcome under `recipient:<ref>`, so every existing
@@ -389,6 +628,8 @@ export function reconcileSubjectErasureRecipients(params: {
389
628
  effectOutcomes: readonly SubjectErasureExternalEffectOutcome[];
390
629
  /** Which recipient each REGISTERED effect reaches — applicable to this subject or not: effect ref → recipient ref. */
391
630
  recipientRefByEffectRef: ReadonlyMap<string, string>;
631
+ /** When the erasure ran: a vendor's declared window lapses this long after it (see `subjectErasureVendorDeletionLapsesAt`). */
632
+ erasedAt: Date;
392
633
  }): { recipients: SubjectErasureRecipientOutcome[]; addedEffectOutcomes: SubjectErasureExternalEffectOutcome[] } {
393
634
  const addedEffectOutcomes: SubjectErasureExternalEffectOutcome[] = [];
394
635
  if (params.statement.status !== SubjectDataRecipientsStatementStatus.DECLARED) {
@@ -412,12 +653,23 @@ export function reconcileSubjectErasureRecipients(params: {
412
653
  if (recipient.reach === SubjectDataRecipientReach.TENANT_ACCOUNT) return { ...base, status: null, effectRefs: [] };
413
654
  const covering = params.effectOutcomes.filter((outcome) => params.recipientRefByEffectRef.get(outcome.effectRef) === recipient.ref);
414
655
  if (covering.length > 0) {
415
- return { ...base, status: combinedStatus(covering.map((outcome) => outcome.status)), effectRefs: covering.map((outcome) => outcome.effectRef) };
656
+ const status = mostIncompleteSubjectErasureExternalEffectStatus(covering.map((outcome) => outcome.status));
657
+ // An effect that reports COMPLETES_AT_VENDOR carries its own window (#2181: the vendor queued the deletion), and the
658
+ // recipient's outcome states it the same way the reconciliation's own window does, so its audit row names the date.
659
+ const lapse = isCompletesAtVendorSubjectErasureExternalEffect(status) ? latestCompletesAtVendorWindow(covering) : undefined;
660
+ return { ...base, status, effectRefs: covering.map((outcome) => outcome.effectRef), ...(lapse === undefined ? {} : { vendorScheduledDeletion: lapse }) };
416
661
  }
417
662
  const effectRef = subjectErasureRecipientEffectRef(recipient.ref);
663
+ if (recipient.kind === SubjectDataRecipientKind.SYSTEM_OF_RECORD) {
664
+ const handled = handledAtSourceRecipientOutcome(recipient, effectRef);
665
+ addedEffectOutcomes.push(handled);
666
+ return { ...base, status: handled.status, effectRefs: [effectRef] };
667
+ }
418
668
  const registeredForOtherSubjects = [...params.recipientRefByEffectRef.entries()]
419
669
  .filter(([, recipientRef]) => recipientRef === recipient.ref).map(([registeredRef]) => registeredRef);
420
- const decided = registeredForOtherSubjects.length > 0
670
+ // A declared vendor window is a true bound whatever else is registered (#2181), so it answers first; it can sit beside
671
+ // a registered effect only for a stance the projection admits it with (an erasure operation).
672
+ const decided = registeredForOtherSubjects.length > 0 && recipient.vendorScheduledDeletion === null
421
673
  // An effect reaches this vendor, but not for this subject's type (the billing effect answers for users). That is
422
674
  // no evidence either way about THIS subject's data there, so it is unmeasured — never "not registered", which
423
675
  // would say nobody built the door.
@@ -426,14 +678,56 @@ export function reconcileSubjectErasureRecipients(params: {
426
678
  status: SubjectErasureExternalEffectStatus.UNMEASURED,
427
679
  detail: `${recipient.ref} is reached by the erasure effect(s) ${registeredForOtherSubjects.join(', ')}, which do not apply to this subject's type; whether ${recipient.ref} holds this subject's data is not measured.`,
428
680
  }
429
- : uncoveredRecipientOutcome(recipient, effectRef);
681
+ : uncoveredRecipientOutcome(recipient, effectRef, params.erasedAt);
430
682
  addedEffectOutcomes.push(decided);
431
- return { ...base, status: decided.status, effectRefs: [effectRef] };
683
+ return {
684
+ ...base,
685
+ status: decided.status,
686
+ effectRefs: [effectRef],
687
+ ...(decided.vendorScheduledDeletion === undefined ? {} : { vendorScheduledDeletion: decided.vendorScheduledDeletion }),
688
+ };
432
689
  });
433
690
  return { recipients, addedEffectOutcomes };
434
691
  }
435
692
 
436
- function uncoveredRecipientOutcome(recipient: SubjectDataRecipientStatementEntry, effectRef: string): SubjectErasureExternalEffectOutcome {
693
+ /** The window of the latest-lapsing COMPLETES_AT_VENDOR outcome among `outcomes`, or `undefined` when none carries one. */
694
+ function latestCompletesAtVendorWindow(outcomes: readonly SubjectErasureExternalEffectOutcome[]): SubjectErasureVendorScheduledDeletion | undefined {
695
+ let latest: SubjectErasureVendorScheduledDeletion | undefined;
696
+ for (const outcome of outcomes) {
697
+ const window = outcome.vendorScheduledDeletion;
698
+ if (!isCompletesAtVendorSubjectErasureExternalEffect(outcome.status) || window === undefined) continue;
699
+ if (latest === undefined || Date.parse(window.lapsesAt) > Date.parse(latest.lapsesAt)) latest = window;
700
+ }
701
+ return latest;
702
+ }
703
+
704
+ /**
705
+ * A vendor-hosted system of record no applicable erasure effect covers (#2585). The wording matches the HTTP_API effect's
706
+ * HANDLED_AT_SOURCE outcome: the system answers for its own records, and the application erased nothing there because
707
+ * no erasure effect of a resource bound to it applied to this subject's type. Said that way on purpose: whether one applies
708
+ * is what was measured, and it is not the same as linkage (a FORWARDED_TO_SOURCE resource can name the subject's type by a
709
+ * foreign key and still not apply, for want of a declared link field for that type).
710
+ */
711
+ function handledAtSourceRecipientOutcome(recipient: SubjectDataRecipientStatementEntry, effectRef: string): SubjectErasureExternalEffectOutcome {
712
+ return {
713
+ effectRef,
714
+ status: SubjectErasureExternalEffectStatus.HANDLED_AT_SOURCE,
715
+ detail: `${recipient.ref} is a system of record hosted by its vendor: requests about the records it holds are handled there. `
716
+ + 'No erasure effect of a resource the application binds to it applies to this subject\'s type, so the application erased nothing there.',
717
+ };
718
+ }
719
+
720
+ function uncoveredRecipientOutcome(recipient: SubjectDataRecipientStatementEntry, effectRef: string, erasedAt: Date): SubjectErasureExternalEffectOutcome {
721
+ if (recipient.vendorScheduledDeletion !== null) {
722
+ const { retentionDays } = recipient.vendorScheduledDeletion;
723
+ const lapsesAt = subjectErasureVendorDeletionLapsesAt(erasedAt, retentionDays);
724
+ return {
725
+ effectRef,
726
+ status: SubjectErasureExternalEffectStatus.COMPLETES_AT_VENDOR,
727
+ detail: `${recipient.ref} deletes what it received on its own published schedule (${retentionDays} days); the erasure completes there by ${lapsesAt}.`,
728
+ vendorScheduledDeletion: { retentionDays, lapsesAt },
729
+ };
730
+ }
437
731
  switch (recipient.erasureStance) {
438
732
  case HttpApiErasureStance.NO_SUBJECT_DATA:
439
733
  return { effectRef, status: SubjectErasureExternalEffectStatus.DECLARED_NO_SUBJECT_DATA, detail: `${recipient.ref} declares it keeps no subject data beyond the call.` };
@@ -472,13 +766,18 @@ export function deriveSubjectDataRecipients(inputs: {
472
766
  const registerByProviderRef = new Map((inputs.register?.processors ?? [])
473
767
  .flatMap((processor) => (processor.kind === ProcessorRegisterEntryKind.CONFIGURED_PROVIDER ? [[processor.providerRef, processor] as const] : [])));
474
768
 
475
- const recipients = excludeSystemsOfRecord(inputs.disclosures).map((disclosure): SubjectDataRecipient => {
769
+ refuseRefNamingProviderAndSystemOfRecord(inputs.population);
770
+ const disclosures = excludeOperatorRunSystemsOfRecord(inputs.disclosures);
771
+ const recipients = disclosures.map((disclosure): SubjectDataRecipient => {
772
+ const kind = subjectDataRecipientKindOf(disclosure.kind);
476
773
  const reach = disclosure.populationClass === RecipientPopulationClass.TENANT_RECIPIENT
477
774
  ? SubjectDataRecipientReach.TENANT_ACCOUNT
478
775
  : SubjectDataRecipientReach.OPERATOR_ACCOUNT;
479
776
  const registered = reach === SubjectDataRecipientReach.OPERATOR_ACCOUNT ? registerByProviderRef.get(disclosure.ref) : undefined;
777
+ const profile = membersByRef.get(disclosure.ref)?.complianceProfile ?? null;
480
778
  return {
481
779
  ref: disclosure.ref,
780
+ kind,
482
781
  legalEntityName: registered?.legalEntityName ?? null,
483
782
  processingRegions: [...(registered?.processingRegions ?? [])],
484
783
  reach,
@@ -486,7 +785,13 @@ export function deriveSubjectDataRecipients(inputs: {
486
785
  categoriesNotDerivable: [...disclosure.categoriesNotDerivable],
487
786
  categoriesAreAFloor: disclosure.categoriesAreAFloor,
488
787
  derivedFrom: [...disclosure.derivedFrom],
489
- erasureStance: erasureStanceOf(disclosure.ref, membersByRef.get(disclosure.ref)?.complianceProfile ?? null, inputs.providerComplianceChoices),
788
+ ...(kind === SubjectDataRecipientKind.SYSTEM_OF_RECORD
789
+ ? systemOfRecordErasureAnswer(disclosure.ref, inputs.providerComplianceChoices)
790
+ : {
791
+ erasureStance: erasureStanceOf(disclosure.ref, profile, inputs.providerComplianceChoices),
792
+ vendorScheduledDeletion: vendorScheduledDeletionOf(disclosure.ref, profile, inputs.providerComplianceChoices),
793
+ subjectReferences: subjectReferencesOf(disclosure.ref, profile, inputs.providerComplianceChoices),
794
+ }),
490
795
  };
491
796
  }).sort((left, right) => left.ref.localeCompare(right.ref));
492
797
 
@@ -498,11 +803,130 @@ export function deriveSubjectDataRecipients(inputs: {
498
803
  }
499
804
 
500
805
  /**
501
- * The guard that keeps systems of record out of the subject-data recipient list (see the function above). Exported so
502
- * its one rule is pinned directly: a system-of-record member never becomes a recipient here, whatever it discloses.
806
+ * The guard that keeps a self-hosted system of record out of the subject-data recipient list (#2585): only an instance
807
+ * the population classes as an operator SUB-PROCESSOR (a vendor hosts it) is a recipient. The population already makes a
808
+ * self-hosted instance operator-run, which reaches no disclosure; this holds the rule where the list is built, so a
809
+ * disclosure list from anywhere else cannot make the controller's own system a recipient. Exported so it is pinned
810
+ * directly.
811
+ */
812
+ export function excludeOperatorRunSystemsOfRecord(disclosures: readonly RecipientDisclosure[]): readonly RecipientDisclosure[] {
813
+ return disclosures.filter((disclosure) => disclosure.kind !== RecipientPopulationMemberKind.SYSTEM_OF_RECORD
814
+ || disclosure.populationClass === RecipientPopulationClass.OPERATOR_SUB_PROCESSOR);
815
+ }
816
+
817
+ /** The recipient kind a population member kind makes. Exhaustive, so a new member kind is a compile error here. */
818
+ function subjectDataRecipientKindOf(kind: RecipientPopulationMemberKind): SubjectDataRecipientKind {
819
+ switch (kind) {
820
+ case RecipientPopulationMemberKind.CONFIGURED_PROVIDER:
821
+ return SubjectDataRecipientKind.CONFIGURED_PROVIDER;
822
+ case RecipientPopulationMemberKind.SYSTEM_OF_RECORD:
823
+ return SubjectDataRecipientKind.SYSTEM_OF_RECORD;
824
+ default: {
825
+ const unhandled: never = kind;
826
+ throw new Error(`subject data recipients: unhandled population member kind ${String(unhandled)}`);
827
+ }
828
+ }
829
+ }
830
+
831
+ /**
832
+ * Refused, by name: a provider and a system-of-record instance under one ref, whatever either one's class. The erasure
833
+ * attributes each effect to the recipient whose ref it names, and every HTTP_API effect names its binding's system, self-
834
+ * hosted or not. So a provider sharing an instance's name would take the system of record's answer (or the other way
835
+ * round), and a provider shipping its own erasure effect would be refused at boot as a second answer for that name.
836
+ * Checked over the whole population rather than the recipients, so a self-hosted instance (no recipient) is covered too.
837
+ */
838
+ function refuseRefNamingProviderAndSystemOfRecord(population: RecipientPopulation): void {
839
+ const systemOfRecordRefs = new Set(population.members.filter((member) => member.kind === RecipientPopulationMemberKind.SYSTEM_OF_RECORD).map((member) => member.ref));
840
+ const shared = [...new Set(population.members
841
+ .filter((member) => member.kind !== RecipientPopulationMemberKind.SYSTEM_OF_RECORD && systemOfRecordRefs.has(member.ref))
842
+ .map((member) => member.ref))].sort();
843
+ if (shared.length > 0) {
844
+ throw new Error(
845
+ `subject data recipients: ${shared.map((ref) => `"${ref}"`).join(', ')} names both a provider and a system-of-record instance. `
846
+ + 'An erasure attributes each effect to one recipient by this name, so rename the systemsOfRecord instance.',
847
+ );
848
+ }
849
+ }
850
+
851
+ /**
852
+ * A vendor-hosted system of record's erasure fields: none (#2585). Its one answer is the system of record's (the HTTP_API
853
+ * effects' when one applies, HANDLED_AT_SOURCE otherwise), so an operator choice that declares an erasure answer for the
854
+ * instance is refused by name rather than dropped: dropping it would leave a declaration that reaches nothing.
503
855
  */
504
- export function excludeSystemsOfRecord(disclosures: readonly RecipientDisclosure[]): readonly RecipientDisclosure[] {
505
- return disclosures.filter((disclosure) => disclosure.kind !== RecipientPopulationMemberKind.SYSTEM_OF_RECORD);
856
+ function systemOfRecordErasureAnswer(
857
+ ref: string,
858
+ choices: ApplicationProviderComplianceChoices | undefined,
859
+ ): Pick<SubjectDataRecipient, 'erasureStance' | 'vendorScheduledDeletion' | 'subjectReferences'> {
860
+ const choice = choices?.[ref];
861
+ const declared = [
862
+ ...(choice?.subjectErasureAcknowledgement === undefined ? [] : ['subjectErasureAcknowledgement']),
863
+ ...(choice?.vendorScheduledDeletion === undefined ? [] : ['vendorScheduledDeletion']),
864
+ ...(choice?.subjectReferences === undefined ? [] : ['subjectReferences']),
865
+ ];
866
+ if (declared.length > 0) {
867
+ throw new Error(
868
+ `subject data recipients: providerComplianceChoices.${ref} declares ${declared.join(', ')}, but "${ref}" is a system of record, `
869
+ + 'which answers requests about its own records: an erasure reports its HTTP_API resources\' subject-rights posture. Remove '
870
+ + `${declared.length === 1 ? 'it' : 'them'}, and declare the posture on the resources' bindings (subjectRights) instead.`,
871
+ );
872
+ }
873
+ return { erasureStance: null, vendorScheduledDeletion: null, subjectReferences: [] };
874
+ }
875
+
876
+ /**
877
+ * The vendor deletion window the operator declared for this recipient (#2074), or `null`.
878
+ *
879
+ * Refused, by name, when the provider module ITSELF declares `NO_SUBJECT_DATA`: a vendor that states it keeps no
880
+ * subject data has already answered the erasure question, and a second answer from the operator would leave the
881
+ * recipient with two. The choice schema refuses the operator-side pairs (an acknowledgement, or subject references,
882
+ * beside a window) for the same reason.
883
+ *
884
+ * Admitted beside `EXTERNAL_ERASURE_OPERATION` (#2181). That stance says the vendor OFFERS a deletion an effect can
885
+ * call; a provider package's effect runs only once the operator arms it with `subjectReferences` and the credential it
886
+ * needs. An operator who has not armed it has no effect answering for the recipient, and the vendor's own published
887
+ * schedule is then the true answer, where refusing it would leave the recipient NOT_REGISTERED and every erasure
888
+ * FAILED. Arming it and keeping the window is the pair the choice schema refuses, so the recipient still has one answer.
889
+ */
890
+ function vendorScheduledDeletionOf(
891
+ ref: string,
892
+ profile: ProviderComplianceProfile | null,
893
+ choices: ApplicationProviderComplianceChoices | undefined,
894
+ ): { retentionDays: number } | null {
895
+ const choice = choices?.[ref];
896
+ if (choice?.vendorScheduledDeletion === undefined || choice.deploymentModel === ProviderDeploymentModel.SELF_HOSTED) return null;
897
+ const declared = establishedProviderComplianceProfile(profile)?.subjectErasure?.stance;
898
+ if (declared !== undefined && declared !== HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION) {
899
+ throw new Error(
900
+ `subject data recipients: providerComplianceChoices.${ref}.vendorScheduledDeletion contradicts the provider's own erasure stance "${declared}" — remove one of the two`,
901
+ );
902
+ }
903
+ return { retentionDays: choice.vendorScheduledDeletion.retentionDays };
904
+ }
905
+
906
+ /**
907
+ * Where the application keeps the person's identifier at this vendor (#2006), as the operator declared it, or empty.
908
+ *
909
+ * Refused, by name, unless the provider module ITSELF declares `EXTERNAL_ERASURE_OPERATION`: references locate what the
910
+ * provider's erasure effect deletes, so on any other stance they would be a declaration that reaches nothing. An
911
+ * acknowledged non-erasure or a deletion window beside them is refused earlier, by the choice schema.
912
+ */
913
+ function subjectReferencesOf(
914
+ ref: string,
915
+ profile: ProviderComplianceProfile | null,
916
+ choices: ApplicationProviderComplianceChoices | undefined,
917
+ ): ProviderSubjectReference[] {
918
+ const declaredReferences = choices?.[ref]?.subjectReferences;
919
+ if (declaredReferences === undefined) return [];
920
+ const declared = establishedProviderComplianceProfile(profile)?.subjectErasure?.stance;
921
+ if (declared !== HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION) {
922
+ throw new Error(
923
+ `subject data recipients: providerComplianceChoices.${ref}.subjectReferences locate what the provider's erasure effect deletes, `
924
+ + `but the provider declares ${declared === undefined ? 'no erasure stance' : `the erasure stance "${declared}"`}, `
925
+ + `not "${HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION}". If the provider's module does declare it, its companion contribution is missing the `
926
+ + 'copy of `complianceProfile` that discovery reads: fix the package. Otherwise remove the references, or install a provider version that erases at the vendor',
927
+ );
928
+ }
929
+ return declaredReferences.map((reference) => ({ ...reference }));
506
930
  }
507
931
 
508
932
  function erasureStanceOf(