@wildo-ai/framework-knowledge 1.1.10 → 1.1.12

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 (1349) 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/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +628 -107
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  15. package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  17. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts +2 -0
  22. package/dist/esm/index.d.ts.map +1 -1
  23. package/dist/esm/index.js +2 -0
  24. package/dist/esm/index.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +82 -15
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -5
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +4 -16
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  43. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  47. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  51. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +38 -14
  56. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  58. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  62. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  66. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  70. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  73. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -2
  74. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  78. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  82. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  86. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  90. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  91. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
  93. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  95. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  96. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  97. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  98. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  100. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  101. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  104. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +15 -5
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  113. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  115. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  117. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  118. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  119. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  120. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  121. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  122. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  123. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  124. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  125. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  127. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  129. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  130. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +7 -3
  131. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  132. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +6 -4
  133. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  134. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  135. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  137. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  138. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  139. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  140. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  142. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
  144. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  146. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  148. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  150. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  153. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  154. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  156. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  158. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  159. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  162. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  163. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  166. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  167. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  170. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  171. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  174. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
  175. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  178. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  179. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  182. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +39 -20
  183. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  184. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  185. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  186. package/dist/esm/source-anchor-grammar.js +114 -0
  187. package/dist/esm/source-anchor-grammar.js.map +1 -0
  188. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  189. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  190. package/dist/knowledge/manifest.json +8 -8
  191. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
  192. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  193. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  194. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  195. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  196. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  197. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
  198. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
  199. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
  200. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
  201. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  202. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  203. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
  204. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  205. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
  206. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  207. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  208. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  209. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  210. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
  211. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
  212. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
  213. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
  214. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
  215. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  216. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
  217. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
  218. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  219. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  220. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
  221. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
  222. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  223. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
  224. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  225. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  226. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  227. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  228. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  229. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
  230. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
  231. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  232. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  233. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
  234. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  235. package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
  236. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
  237. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
  238. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  239. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
  240. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  241. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  242. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  243. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
  244. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  245. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  246. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  247. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  248. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  249. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  250. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  251. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
  254. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  255. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  256. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  257. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  258. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
  259. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  260. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  261. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  262. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  263. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  264. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  265. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  266. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  267. package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
  268. package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
  269. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  270. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
  271. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
  272. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  273. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  274. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  275. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  276. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  277. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  278. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  279. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  281. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  282. package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
  283. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  284. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  285. package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
  286. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
  287. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  288. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  289. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  290. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  291. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
  292. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
  293. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  294. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  295. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  296. package/dist/knowledge/references/application-maturity.config.md +28 -2
  297. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
  298. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
  299. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  300. package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
  301. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  302. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  303. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  304. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  305. package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
  306. package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
  307. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  308. package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
  309. package/dist/knowledge/references/capability-composition.config.md +4 -3
  310. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  311. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  312. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  313. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  314. package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
  315. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  316. package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
  317. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  318. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  319. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  320. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  321. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  322. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  323. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  324. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  325. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  326. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  327. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
  328. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  329. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  330. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  331. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  332. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  333. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  334. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
  335. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  336. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  337. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  338. package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
  339. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  340. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  341. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  342. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  343. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  344. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  345. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  346. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  347. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  348. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  349. package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
  350. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  351. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  352. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  353. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
  354. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  355. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  356. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  357. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
  358. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
  359. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
  360. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  361. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  362. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  363. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  364. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  365. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  366. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  367. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  368. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  369. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  370. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  371. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  372. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  373. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  374. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  375. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  376. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  377. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  378. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  379. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  380. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  381. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  382. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  383. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  384. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  385. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  386. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  387. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  388. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  389. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  390. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  391. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  392. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  393. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  394. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  395. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  396. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  397. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  398. package/dist/knowledge/references/experience-plan.config.md +127 -1
  399. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
  400. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  401. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  402. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
  403. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  404. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
  405. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  406. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
  407. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
  408. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
  409. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  410. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  411. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  412. package/dist/knowledge/references/integration-plan.config.md +28 -8
  413. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  414. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  415. package/dist/knowledge/references/placement-plan.config.md +94 -13
  416. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  417. package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
  418. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  419. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
  420. package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
  421. package/dist/knowledge/references/platform.config.saas.md +126 -32
  422. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  423. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  424. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  425. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  426. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  427. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  428. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  429. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  430. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  431. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  432. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  433. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  434. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  435. package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
  436. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  437. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  438. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  439. package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
  440. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  441. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  442. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  443. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
  444. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
  445. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
  446. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  447. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  448. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  449. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  450. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  451. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  452. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  453. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  454. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  455. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  456. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  457. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  458. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  459. package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
  460. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  461. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  462. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  463. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
  464. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  465. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  466. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  467. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  468. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  469. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
  470. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  471. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
  472. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
  473. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  479. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
  480. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  481. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  482. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  483. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  484. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  485. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  486. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  487. package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
  488. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
  489. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  490. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  491. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  492. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  493. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  494. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  495. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  496. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  497. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  498. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  499. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  500. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  501. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  502. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  503. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  504. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  505. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  506. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  507. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  508. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  509. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  510. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
  511. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  513. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  514. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  515. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  516. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
  517. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  518. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  519. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  520. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
  521. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  522. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  523. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  524. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  525. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  526. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  527. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
  528. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  529. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  530. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  531. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
  532. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
  533. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
  534. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  535. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
  536. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
  537. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  538. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  539. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  540. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  541. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  542. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  543. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  544. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  545. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  546. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  547. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  548. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  549. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  550. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  551. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
  552. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  553. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  554. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  555. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  556. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  557. package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
  558. package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
  559. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
  560. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  561. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
  562. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
  563. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
  564. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
  565. package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
  566. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  567. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  568. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  569. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  570. package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
  571. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  572. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
  573. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  574. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  575. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  576. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
  577. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  578. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  579. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  580. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  581. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
  582. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
  583. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  584. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
  585. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  586. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
  587. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  588. package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
  589. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  590. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  591. package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
  592. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  593. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  594. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  595. package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
  596. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  597. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  598. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  599. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  600. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  601. package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
  602. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
  603. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  604. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  605. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
  606. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
  607. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  608. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  609. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  610. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
  611. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  612. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  613. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  614. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  615. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
  616. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
  617. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
  618. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  619. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
  620. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
  621. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  622. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  623. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  624. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  625. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
  626. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  627. package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
  628. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  629. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  630. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
  631. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
  632. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  633. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  634. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  635. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  636. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  637. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  638. package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
  639. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
  640. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  641. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
  642. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  643. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  644. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  645. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  646. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  647. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  648. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  649. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  650. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
  651. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  652. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  653. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  654. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  655. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  656. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  657. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
  658. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  659. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
  660. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  661. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  662. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  663. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  664. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  665. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  666. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  667. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  668. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
  669. package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
  670. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  671. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  672. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
  673. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
  674. package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
  675. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  676. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  677. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
  678. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  679. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  680. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  681. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
  682. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  683. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
  684. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  685. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
  686. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  687. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  688. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  689. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  690. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
  691. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  692. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
  693. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  694. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  695. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  696. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  697. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  698. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  699. package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
  700. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  701. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
  702. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  703. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  704. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  705. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  706. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  707. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  708. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  709. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  710. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  711. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  712. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  713. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  714. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  715. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  716. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  717. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  718. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  719. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  720. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  721. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  722. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  723. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  724. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  725. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  726. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  727. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  728. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  729. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  730. package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
  731. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  732. package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
  733. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  734. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  735. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  736. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  737. package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
  738. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
  739. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  740. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  741. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
  742. package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
  743. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  744. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  745. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  746. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  747. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  748. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  749. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  750. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  751. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  752. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  753. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  754. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  755. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  756. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  757. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  758. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  759. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  760. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  761. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  762. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  763. package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
  764. package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
  765. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  766. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  767. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  768. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  769. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  770. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  771. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  772. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  773. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  774. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  775. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  776. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  777. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  778. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  779. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  780. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  781. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  782. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  783. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  784. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  785. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  786. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  787. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  788. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  789. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  790. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  791. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  792. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  793. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  794. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  795. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  796. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  797. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  798. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  799. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  800. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  801. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  802. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  803. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  804. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  805. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  806. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  807. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  808. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  809. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  810. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  811. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  812. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  813. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  814. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  815. package/dist/knowledge/references/service-method.config.md +303 -0
  816. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  817. package/dist/knowledge/references/website-plan.config.md +544 -32
  818. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  819. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  820. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  821. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  822. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
  823. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  824. package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
  825. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
  826. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
  827. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  828. package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
  829. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  830. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  831. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  832. package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
  833. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
  834. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
  835. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
  836. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  837. package/dist/knowledge/references/zod.factories.code.md +18 -9
  838. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  839. package/dist/knowledge/references/zod.factories.money.md +24 -15
  840. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  841. package/dist/knowledge/references/zod.factories.range.md +5 -1
  842. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  843. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  844. package/dist/knowledge/registries/framework-topics.json +5250 -2565
  845. package/dist/knowledge/registries/playbooks.json +88 -55
  846. package/dist/knowledge/registries/source-tags.json +9347 -4807
  847. package/dist/knowledge/rules/database-migration-obligation.md +10 -5
  848. package/dist/knowledge/rules/live-context-door.md +1 -1
  849. package/dist/knowledge/skills/INDEX.md +62 -33
  850. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  851. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
  852. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  853. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  854. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  855. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  856. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  857. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
  858. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  859. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  860. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  861. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
  862. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  863. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  864. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  865. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  866. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  867. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  868. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  869. package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
  870. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  871. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
  872. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  873. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
  874. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  875. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
  876. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
  877. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  878. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
  879. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  880. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  881. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
  882. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
  883. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  884. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  885. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  886. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
  887. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  888. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  889. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  890. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  891. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  892. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  893. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  894. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
  895. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  896. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  897. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  898. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  899. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  900. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  901. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  902. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  903. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
  904. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
  905. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  906. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  907. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
  908. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  909. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  910. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
  911. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  912. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
  913. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
  914. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  915. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
  916. package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
  917. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  918. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  919. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  920. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  921. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  922. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
  923. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  924. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  925. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  926. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  927. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  928. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  929. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  930. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
  931. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
  932. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  933. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  934. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  935. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  936. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
  937. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  938. package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
  939. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
  940. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  941. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
  942. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  943. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
  944. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  945. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
  946. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
  947. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
  948. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
  949. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  950. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
  951. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  952. package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
  953. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  954. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  955. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  956. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  957. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
  958. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  959. package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
  960. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
  961. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  962. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  963. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  964. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  965. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  966. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  967. package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
  968. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  969. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
  970. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  971. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  972. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
  973. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
  974. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
  975. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  976. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
  977. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  978. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  979. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  980. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
  981. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
  982. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
  983. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
  984. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
  985. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
  986. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  987. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  988. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
  989. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
  990. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
  991. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
  992. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
  993. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  994. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  995. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
  996. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  997. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
  998. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
  999. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  1000. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  1001. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
  1002. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
  1003. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  1004. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  1005. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
  1006. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
  1007. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  1008. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  1009. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  1010. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  1011. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  1012. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  1013. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  1014. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  1015. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
  1016. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  1017. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  1018. package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
  1019. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
  1020. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
  1021. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  1022. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
  1023. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  1024. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
  1025. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
  1026. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  1027. package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
  1028. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  1029. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
  1030. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
  1031. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
  1032. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  1033. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  1034. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  1035. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  1036. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  1037. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  1038. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  1039. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  1040. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  1041. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  1042. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  1043. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  1044. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  1045. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  1046. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
  1047. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  1048. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  1049. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  1050. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  1051. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
  1052. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
  1053. package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
  1054. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
  1055. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  1056. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  1057. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
  1058. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
  1059. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  1060. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  1061. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
  1062. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  1063. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
  1064. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
  1065. package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
  1066. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  1067. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  1068. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
  1069. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  1070. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  1071. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
  1072. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
  1073. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
  1074. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  1075. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  1076. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  1077. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
  1078. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  1079. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  1080. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  1081. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  1082. package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
  1083. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
  1084. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  1085. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  1086. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  1087. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
  1088. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
  1089. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
  1090. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  1091. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  1092. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
  1093. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  1094. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  1095. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
  1096. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
  1097. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  1098. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  1099. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
  1100. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  1101. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  1102. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  1103. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  1104. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  1105. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
  1106. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  1107. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  1108. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  1109. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  1110. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
  1111. package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
  1112. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  1113. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
  1114. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
  1115. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  1116. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
  1117. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  1118. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  1119. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
  1120. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
  1121. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
  1122. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
  1123. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  1124. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
  1125. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  1126. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  1127. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
  1128. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  1129. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
  1130. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
  1131. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
  1132. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
  1133. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
  1134. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  1135. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  1136. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
  1137. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  1138. package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
  1139. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  1140. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  1141. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  1142. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  1143. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
  1144. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
  1145. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  1146. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
  1147. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  1148. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  1149. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  1150. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
  1151. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  1152. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  1153. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  1154. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  1155. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
  1156. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  1157. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  1158. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
  1159. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
  1160. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  1161. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  1162. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
  1163. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
  1164. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  1165. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  1166. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
  1167. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
  1168. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  1169. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  1170. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  1171. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
  1172. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  1173. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
  1174. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  1175. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
  1176. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  1177. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
  1178. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
  1179. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  1180. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
  1181. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
  1182. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
  1183. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
  1184. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
  1185. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  1186. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
  1187. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
  1188. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  1189. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  1190. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  1191. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  1192. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
  1193. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
  1194. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
  1195. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  1196. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  1197. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
  1198. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  1199. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  1200. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  1201. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
  1202. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
  1203. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  1204. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
  1205. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
  1206. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
  1207. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  1208. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  1209. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  1210. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  1211. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  1212. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  1213. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  1214. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
  1215. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
  1216. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
  1217. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  1218. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  1219. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  1220. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
  1221. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  1222. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  1223. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
  1224. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  1225. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
  1226. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  1227. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  1228. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  1229. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  1230. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  1231. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  1232. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  1233. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1234. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  1235. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
  1236. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  1237. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  1238. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
  1239. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  1240. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  1241. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
  1242. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  1243. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
  1244. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
  1245. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  1246. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  1247. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  1248. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  1249. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  1250. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
  1251. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  1252. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
  1253. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  1254. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  1255. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  1256. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  1257. package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
  1258. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  1259. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  1260. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  1261. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  1262. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  1263. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  1264. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  1265. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  1266. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  1267. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  1268. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  1269. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  1270. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
  1271. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  1272. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  1273. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  1274. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  1275. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  1276. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  1277. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  1278. package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
  1279. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  1280. package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
  1281. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  1282. package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
  1283. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1284. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1285. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
  1286. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1287. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
  1288. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1289. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
  1290. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1291. package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
  1292. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1293. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1294. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1295. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1296. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1297. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1298. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1299. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1300. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1301. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1302. package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
  1303. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
  1304. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1305. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
  1306. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1307. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1308. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1309. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1310. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1311. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1312. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1313. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1314. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1315. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1316. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1317. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
  1318. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1319. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1320. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1321. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1322. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1323. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1324. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1325. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1326. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1327. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
  1328. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1329. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1330. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1331. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1332. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  1333. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1334. package/dist/knowledge/topic-index.json +17998 -8568
  1335. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1336. package/package.json +6 -6
  1337. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1338. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
  1339. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1340. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1341. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1342. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1343. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1344. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1345. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1346. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1347. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1348. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
  1349. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,1259 @@
1
+ # Organization relationships — vocabularies, schemas and refusals (source)
2
+
3
+ Read this when you need the exact contract of a relationship between two organizations:
4
+
5
+ - which statuses a relationship passes through, and which of them are live;
6
+ - the fields on the relationship (stored in the granting organization, with the `kind` it was proposed under), the
7
+ representing organization's own record of it, and a representative assignment (stored in the representing
8
+ organization) — every one is server-authored;
9
+ - the stable 409 codes a screen can branch on (each refusal is a CONFLICT: the caller is authorized, the current state
10
+ forbids the write), including `RELATIONSHIP_KIND_REQUIRED` and `RELATIONSHIP_RECORD_NOT_SHAREABLE`;
11
+ - the verbs each side owns, including the granting organization's `shareRecord` / `unshareRecord`;
12
+ - what each side sees of the other, and how a mutual kind's two directions live and end together;
13
+ - what suspension, unassignment and deletion leave behind, and what a per-representative approval guarantees.
14
+
15
+ The kinds a relationship is an instance of are declared under `organizationRelationships`: see
16
+ `framework-relationship-kinds-api.md`.
17
+
18
+ ## What each side sees
19
+
20
+ A representing organization sees the granting organization's name on its record of the relationship only once that
21
+ organization has proposed to it or accepted its proposal: a pending proposal or a decline shows the id. The one
22
+ exception is the second direction of a mutual relationship, which names its granting organization while still proposed:
23
+ the two organizations already dealt with each other in the first direction, so the name discloses nothing new. A
24
+ representative's sign-ins are routed to the representing organization's security export, not to every granting
25
+ organization; what they do inside one reaches that organization's audit trail.
26
+
27
+ A representative membership never counts toward the granting organization's owner floor, can never be granted
28
+ ownership, cannot have its roles edited directly (409), never appears in its SCIM directory, and receives its
29
+ notifications only while live.
30
+
31
+ ## A mutual kind's two directions
32
+
33
+ A relationship of a `mutual` kind is one agreement with two directions, each a relationship of its own held by its
34
+ granting organization. Each direction opens its granting organization's tenant, so each needs that organization's
35
+ owner's consent, with step-up, on its granting door. Accepting the first direction PROPOSES the second: proposed by its
36
+ representing organization (the one that granted the first), with the first's purpose and term, the kind's default role,
37
+ organization-wide, and its granting type's default admission. It waits PROPOSED until the other organization accepts
38
+ it (its owner, with step-up) or declines it, and that organization then changes what it grants with the usual verbs. Until then the agreement
39
+ is half made: the first direction confers and the second confers nothing, so representatives can be assigned only into
40
+ the first.
41
+
42
+ Either direction ending ends the other in the same transaction, as the same organization acting on the other side.
43
+ While the other is ACTIVE or SUSPENDED: a granting organization that terminates (or declines) withdraws from what it is granted, a
44
+ representing organization that withdraws terminates what it grants, and an elapsed term expires both. While the other
45
+ is still PROPOSED, the proposal goes with it: withdrawn when the first direction is terminated or expires, declined when
46
+ the first is withdrawn from. Each direction's suspension, role, units, admission and term stay its granting organization's own, so suspending one leaves
47
+ the other conferring. While one direction lives, no other relationship of any kind may link the pair in either
48
+ direction (`ORGANIZATION_RELATIONSHIP_ALREADY_LIVE`).
49
+
50
+ ## Suspension, unassignment and deletion
51
+
52
+ Unassigning ends the person's reach but never lifts a suspension the granting organization set: a SUSPENDED membership
53
+ stays SUSPENDED — through an unassign, and through the relationship ending, so a new relationship cannot bring the
54
+ person back until the granting organization reactivates them. Reactivation restores ACTIVE only while the person's
55
+ relationship has not ended (ACTIVE or SUSPENDED — a suspended one counts, and its RESUME brings the authority back) and
56
+ they are still assigned to it. Otherwise the membership lands INACTIVE: the representing organization can then assign
57
+ them again, under any relationship with that granting organization that is ACTIVE.
58
+
59
+ An ACTIVE representative membership confers nothing by itself — the per-request live filter reads the relationship.
60
+ Deleting a representative membership ends its assignment in the same transaction, so the representing organization
61
+ stops showing them as assigned; it does not stop it assigning them again. To keep one person out, suspend them.
62
+
63
+ Deleting a party ORGANIZATION (the purge after its retention window, or an operator's immediate delete) ends its
64
+ relationships in the other tenant in the same transaction — TERMINATED where it was the granting organization,
65
+ WITHDRAWN where it was the representing one — with the representing side's record, the ACTIVE assignments and the
66
+ ACTIVE representative memberships; a SUSPENDED membership is kept.
67
+
68
+ ### Withdrawing on the representing organization's behalf
69
+
70
+ When your application's own records say a representation is over (a service firm's mandate ended and nothing still
71
+ needs its access), your backend may withdraw the relationship for the representing organization: the INTERNAL
72
+ `withdrawOnBehalf` verb on `organization-representations`, dispatched with an internal execution context
73
+ (`createForInternalOperation` + `executeCustomOperation`, roles `APP_ADMIN_SUPER_ADMIN`) on the representing
74
+ organization's mirror row, with a REQUIRED `decisionReason`. It is the representing side's own `withdraw` transition: the
75
+ relationship and its mirror become WITHDRAWN, its reach ends, its pending decisions end, and the lifecycle row in both
76
+ trails names the representing organization and no person. The reason is the only account of the decision either
77
+ organization will have, so state it fully. A relationship that already ended refuses a second withdrawal.
78
+
79
+ ## Per-representative approval: what it guarantees, so a screen can rely on it
80
+
81
+ When a relationship's `representativeAdmissionPolicy` is `GRANTOR_APPROVES_EACH`:
82
+
83
+ - A pending, denied or lapsed assignment has no membership row in the granting organization: it confers nothing and
84
+ appears in no member list, directory or notification.
85
+ - Only an administrator of the GRANTING organization can answer (ORG_ADMIN, or an owner); the representing organization
86
+ and ordinary members cannot, and the request is never routed to a named person, so it cannot be claimed or reassigned.
87
+ - Approving re-checks everything at that moment — the relationship still live and in term, still admitted by its kind
88
+ (the two organizations' types, the role, the unit scope), both organizations still conferring authority, the
89
+ representative still an active member of the representing organization, the person not already there another way. If
90
+ any has changed, the approval is recorded and the assignment ends `DENIED` with `approvalDenialReason`; nobody is
91
+ admitted. `assign` refuses the same conditions up front.
92
+ - The representing organization sees the state on its assignment list (pending, active, denied, lapsed) and, on its
93
+ record of the relationship, the policy — never which administrator answered.
94
+ - Ending the relationship, or unassigning, withdraws a pending approval.
95
+
96
+ ## Import Origins
97
+
98
+ - `@wildo-ai/saas-models`
99
+
100
+ ## Source Excerpts
101
+
102
+ ### Origin Package: `@wildo-ai/saas-models`
103
+
104
+ ```typescript
105
+ /**
106
+ * Where an organization relationship stands. One member per distinct claim, so the record says WHO
107
+ * ended it and HOW.
108
+ *
109
+ * Only {@link OrganizationRelationshipStatus.ACTIVE} confers anything, and even then only while
110
+ * `endsAt` is absent or in the future — {@link isOrganizationRelationshipConferring} is the one
111
+ * predicate, and it reads `endsAt` itself rather than trusting {@link EXPIRED}.
112
+ */
113
+ export enum OrganizationRelationshipStatus {
114
+ /** Proposed by one side, awaiting the other. Confers nothing. */
115
+ PROPOSED = 'PROPOSED',
116
+ /** Accepted by the non-proposing side. Confers, subject to the live filter. */
117
+ ACTIVE = 'ACTIVE',
118
+ /** Paused by the granting organization. Confers nothing; `resume` returns it to ACTIVE. */
119
+ SUSPENDED = 'SUSPENDED',
120
+ /** The granting organization refused the representing organization's proposal. Terminal. */
121
+ DECLINED = 'DECLINED',
122
+ /**
123
+ * The representing organization ended it (or withdrew its proposal) — or the representing ORGANIZATION was deleted
124
+ * (the purge after its retention window, or an operator's immediate delete), which ends every relationship it serves
125
+ * the same way. Terminal.
126
+ */
127
+ WITHDRAWN = 'WITHDRAWN',
128
+ /**
129
+ * The granting organization ended it — or the granting ORGANIZATION was deleted (the purge, or an operator's immediate
130
+ * delete), which ends every relationship it holds the same way. Terminal.
131
+ */
132
+ TERMINATED = 'TERMINATED',
133
+ /** The sweep relabelled it after `endsAt`. Terminal bookkeeping — admission never reads this label. */
134
+ EXPIRED = 'EXPIRED',
135
+ }
136
+
137
+ /** Statuses from which a relationship can still move — at most one of these per (representing, granting) pair. */
138
+ export const ORGANIZATION_RELATIONSHIP_LIVE_STATUSES: readonly OrganizationRelationshipStatus[] = [
139
+ OrganizationRelationshipStatus.PROPOSED,
140
+ OrganizationRelationshipStatus.ACTIVE,
141
+ OrganizationRelationshipStatus.SUSPENDED,
142
+ ];
143
+
144
+ /** Statuses that end a relationship for good. Reaching one ends every assignment and representative membership. */
145
+ export const ORGANIZATION_RELATIONSHIP_TERMINAL_STATUSES: readonly OrganizationRelationshipStatus[] = [
146
+ OrganizationRelationshipStatus.DECLINED,
147
+ OrganizationRelationshipStatus.WITHDRAWN,
148
+ OrganizationRelationshipStatus.TERMINATED,
149
+ OrganizationRelationshipStatus.EXPIRED,
150
+ ];
151
+
152
+ /** One lifecycle audit row per transition, written to BOTH organizations' trails. */
153
+ export enum OrganizationRelationshipTransition {
154
+ PROPOSED = 'PROPOSED',
155
+ ACCEPTED = 'ACCEPTED',
156
+ DECLINED = 'DECLINED',
157
+ SUSPENDED = 'SUSPENDED',
158
+ RESUMED = 'RESUMED',
159
+ SCOPE_AMENDED = 'SCOPE_AMENDED',
160
+ TERMINATED = 'TERMINATED',
161
+ WITHDRAWN = 'WITHDRAWN',
162
+ EXPIRED = 'EXPIRED',
163
+ /**
164
+ * The granting organization changed how the representing organization's representatives are admitted (#1612) — see
165
+ * {@link RepresentativeAdmissionPolicy}. Not retroactive: representatives already admitted stay admitted.
166
+ */
167
+ REPRESENTATIVE_ADMISSION_POLICY_CHANGED = 'REPRESENTATIVE_ADMISSION_POLICY_CHANGED',
168
+ /**
169
+ * An operator changed one party's organization type and the declaration no longer allows this pair or role (#2611):
170
+ * the relationship's status is unchanged, but it confers nothing on the next request until a declaration or a type
171
+ * allows it again. Recorded in both trails, so the party that did NOT change learns its relationship went quiet.
172
+ */
173
+ DORMANT_BY_TYPE_CHANGE = 'DORMANT_BY_TYPE_CHANGE',
174
+ /**
175
+ * An operator changed one party's organization type and the declaration allows this pair and role again (#2611): a
176
+ * dormant relationship confers again, giving the representatives back the granting organization's data. Recorded in
177
+ * both trails — above all the granting organization's, which may not be the organization whose type changed.
178
+ */
179
+ REVIVED_BY_TYPE_CHANGE = 'REVIVED_BY_TYPE_CHANGE',
180
+ /**
181
+ * One party organization stopped operating (suspended, closed, or marked for deletion) and so confers nothing (#2795):
182
+ * the relationship's status is unchanged, but it confers nothing on the next request until that organization operates
183
+ * again. Recorded in both trails, so the OTHER party learns its relationship went quiet and why.
184
+ */
185
+ DORMANT_BY_PARTY_STATUS = 'DORMANT_BY_PARTY_STATUS',
186
+ /**
187
+ * One party organization operates again (reactivated or restored) and the relationship confers again (#2795): above all
188
+ * the granting organization's record, since another organization's people act in it again without anyone in it deciding so.
189
+ */
190
+ REVIVED_BY_PARTY_STATUS = 'REVIVED_BY_PARTY_STATUS',
191
+ }
192
+
193
+ /**
194
+ * Whether a transition GRANTS reach: another organization's people gain, regain or widen access to the granting tenant.
195
+ * The relationship lifecycle audit row is HIGH for these and MEDIUM for the rest, so a reviewer filtering to HIGH sees
196
+ * every moment a third party gained or widened access to a tenant (#2795 review F1). Total over the enum, so a transition
197
+ * added tomorrow is a compile error until someone decides which it is, rather than silently MEDIUM.
198
+ */
199
+ export const ORGANIZATION_RELATIONSHIP_TRANSITION_GRANTS_REACH: Readonly<Record<OrganizationRelationshipTransition, boolean>> = {
200
+ [OrganizationRelationshipTransition.PROPOSED]: false,
201
+ [OrganizationRelationshipTransition.ACCEPTED]: true,
202
+ [OrganizationRelationshipTransition.DECLINED]: false,
203
+ [OrganizationRelationshipTransition.SUSPENDED]: false,
204
+ [OrganizationRelationshipTransition.RESUMED]: true,
205
+ [OrganizationRelationshipTransition.SCOPE_AMENDED]: true,
206
+ [OrganizationRelationshipTransition.TERMINATED]: false,
207
+ [OrganizationRelationshipTransition.WITHDRAWN]: false,
208
+ [OrganizationRelationshipTransition.EXPIRED]: false,
209
+ // Changes how representatives are admitted, never whether the relationship reaches: not retroactive.
210
+ [OrganizationRelationshipTransition.REPRESENTATIVE_ADMISSION_POLICY_CHANGED]: false,
211
+ [OrganizationRelationshipTransition.DORMANT_BY_TYPE_CHANGE]: false,
212
+ [OrganizationRelationshipTransition.REVIVED_BY_TYPE_CHANGE]: true,
213
+ [OrganizationRelationshipTransition.DORMANT_BY_PARTY_STATUS]: false,
214
+ [OrganizationRelationshipTransition.REVIVED_BY_PARTY_STATUS]: true,
215
+ };
216
+
217
+ /** Whether a representative currently serves an engagement. */
218
+ export enum RepresentativeAssignmentStatus {
219
+ /** Designated by the representing organization; the representative holds a representative membership in the granting organization. */
220
+ ACTIVE = 'ACTIVE',
221
+ /**
222
+ * Unassigned, ended with the relationship, ended by the representative's erasure (#2920), or withdrawn while still
223
+ * awaiting the granting organization's approval. The membership in the granting organization (when one was ever
224
+ * created) is INACTIVE; the row is evidence.
225
+ */
226
+ ENDED = 'ENDED',
227
+ /**
228
+ * The representing organization assigned the representative under a relationship whose granting organization approves
229
+ * each representative (#1612), and the granting organization has not answered yet. Confers NOTHING by construction: no
230
+ * membership row exists in the granting organization, so there is no role entry, nothing in any membership consumer,
231
+ * and no (person, granting organization) slot taken.
232
+ */
233
+ PENDING_GRANTING_APPROVAL = 'PENDING_GRANTING_APPROVAL',
234
+ /**
235
+ * The granting organization refused the representative — or approved, but the relationship, the representative's
236
+ * membership in the representing organization or the (person, granting organization) slot no longer allowed admission
237
+ * when the approval was applied. Nothing was created. Terminal; `approvalDenialReason` says which.
238
+ */
239
+ DENIED = 'DENIED',
240
+ /** Nobody in the granting organization answered before the approval's lapse (decision deadlines, #1628). Nothing was created. Terminal. */
241
+ LAPSED = 'LAPSED',
242
+ }
243
+
244
+ /** Assignment statuses that still hold, or still wait for, a place in the granting organization — the ones a second assignment collides with. */
245
+ export const REPRESENTATIVE_ASSIGNMENT_LIVE_STATUSES: readonly RepresentativeAssignmentStatus[] = [
246
+ RepresentativeAssignmentStatus.ACTIVE,
247
+ RepresentativeAssignmentStatus.PENDING_GRANTING_APPROVAL,
248
+ ];
249
+
250
+ /**
251
+ * Why a per-representative approval ended without admitting the representative (#1612). Recorded on the assignment the
252
+ * representing organization reads, so it names a FACT the representing side may know — never the granting
253
+ * organization's administrator who answered.
254
+ */
255
+ export enum RepresentativeApprovalDenialReason {
256
+ /** An administrator of the granting organization refused the representative. */
257
+ REFUSED_BY_GRANTING_ORGANIZATION = 'REFUSED_BY_GRANTING_ORGANIZATION',
258
+ /**
259
+ * The granting organization approved, but the relationship no longer confers: it ended, was suspended or is past its
260
+ * term; its kind no longer admits the two organizations, the role or the unit scope (a dormant relationship, #2616);
261
+ * or the granting organization itself is suspended, cancelled or being deleted.
262
+ */
263
+ RELATIONSHIP_NO_LONGER_CONFERS = 'RELATIONSHIP_NO_LONGER_CONFERS',
264
+ /**
265
+ * The granting organization approved, but the representative is no longer an active, ordinary member of the
266
+ * representing organization, or the representing organization no longer confers authority.
267
+ */
268
+ REPRESENTATIVE_NO_LONGER_ELIGIBLE = 'REPRESENTATIVE_NO_LONGER_ELIGIBLE',
269
+ /**
270
+ * The granting organization approved, but the person meanwhile holds another membership in it (their own, a suspended
271
+ * one, or one through another representing organization).
272
+ */
273
+ CONFLICTS_WITH_GRANTING_MEMBERSHIP = 'CONFLICTS_WITH_GRANTING_MEMBERSHIP',
274
+ }
275
+
276
+ /**
277
+ * The two answers a per-representative approval offers (#1612), in the one answer shape (`HumanDecision_Answer.optionRef`).
278
+ * APPROVE proceeds (the representative is admitted, re-checked at that moment); REJECT ends the waiting assignment.
279
+ */
280
+ export enum RepresentativeApprovalOption {
281
+ APPROVE = 'approve',
282
+ REJECT = 'reject',
283
+ }
284
+ ```
285
+
286
+ ### Origin Package: `@wildo-ai/saas-models`
287
+
288
+ ```typescript
289
+ /**
290
+ * One admitted machine client's agents, as the GRANTING organization chose them (#1611). See
291
+ * `OrganizationRelationship.admittedAutonomousAgents`.
292
+ */
293
+ export const RelationshipAdmittedAutonomousAgentsSchema = z.object({
294
+ oauthClientId: z.string().min(1).describe('The representing organization\'s machine client this entry is for. It is always one of the relationship\'s `admittedMachineClientIds`.'),
295
+ autonomousAgentRefs: z
296
+ .array(AutonomousAgentRefSchema)
297
+ .max(AUTONOMOUS_AGENT_REFS_PER_CLIENT_MAX)
298
+ .describe('The agents of that machine client the granting organization lets act inside it. An empty list admits none, even if the representing organization runs more agents on that machine client.'),
299
+ });
300
+ export type RelationshipAdmittedAutonomousAgents = z.infer<typeof RelationshipAdmittedAutonomousAgentsSchema>;
301
+
302
+ /**
303
+ * Does this relationship let this machine client of the representing organization run this autonomous agent in the
304
+ * granting organization (#1611)? The granting organization's consent only: whether the machine client is admitted at
305
+ * all, live, and with which role is `admitRelationshipMachineClient`'s question, and whether the representing
306
+ * organization binds the agent to it is the OAuth client row's. The one predicate the principal resolver, the schedule's
307
+ * nomination and the admission audit share.
308
+ */
309
+ export function relationshipAdmitsAutonomousAgent(
310
+ relationship: Pick<OrganizationRelationship, 'admittedMachineClientIds' | 'admittedAutonomousAgents'> | null | undefined,
311
+ oauthClientId: string,
312
+ autonomousAgentRef: string,
313
+ ): boolean {
314
+ if (!relationship || !(relationship.admittedMachineClientIds ?? []).includes(oauthClientId)) return false;
315
+ return (relationship.admittedAutonomousAgents ?? [])
316
+ .some((entry) => entry.oauthClientId === oauthClientId && entry.autonomousAgentRefs.includes(autonomousAgentRef));
317
+ }
318
+
319
+ /**
320
+ * The relationship, stored in the GRANTING organization — the party whose tenant is reached into, and which controls it.
321
+ *
322
+ * Every field is server-authored. There is no generic CREATE or UPDATE: each field changes only through
323
+ * the verb that owns its transition, which is what makes the record evidence rather than a form.
324
+ */
325
+ export const OrganizationRelationshipSchema = z.object({
326
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
327
+
328
+ /** The GRANTING organization — the scope anchor, and the only party that can widen or end the relationship. */
329
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
330
+
331
+ /**
332
+ * The relationship KIND this is an instance of (`organizationRelationships.<kind>` in the application configuration):
333
+ * what the relationship may confer, what its representatives see of this organization's own records, who may propose
334
+ * it (#2722). Fixed at the proposal, like the pair it links. A kind the declaration no longer carries leaves the
335
+ * relationship dormant: it confers nothing until the kind is declared again.
336
+ */
337
+ kind: z.string().min(1).systemEnum(ApplicationConfigVocabulary.ORGANIZATION_RELATIONSHIP_KIND).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
338
+
339
+ /**
340
+ * The REPRESENTING organization. A plain indexed id, not a foreign key: it names another tenant, and a navigable
341
+ * edge from one tenant's row into another tenant is exactly what this model refuses to create.
342
+ */
343
+ representingOrganizationId: z.string().min(1).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
344
+ /**
345
+ * The representing organization's name when the relationship was proposed — a snapshot, because the granting
346
+ * organization cannot read the representing organization's row.
347
+ *
348
+ * Personal data where the representing organization is a sole trader (#2119, #2535): the name of the party the row
349
+ * describes, not of anyone an erasure of the row reaches. Kept, with the rest of the row, as the granting
350
+ * organization's evidence of who could reach its tenant (AUDIT_LOGS class from `endedAt`); the representing
351
+ * organization's own deletion ends the relationship and does not scrub the copy held in the other tenant.
352
+ */
353
+ representingOrganizationName: z.string().max(200).optional().isSummaryField().excludeFromCreate().excludeFromUpdate()
354
+ .dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true }),
355
+
356
+ status: z.enum(OrganizationRelationshipStatus)
357
+ .systemEnum('OrganizationRelationshipStatus')
358
+ .default(OrganizationRelationshipStatus.PROPOSED)
359
+ .isDBIndexed()
360
+ .isSummaryField()
361
+ .excludeFromCreate()
362
+ .excludeFromUpdate()
363
+ .isAuditEvidence(),
364
+
365
+ /**
366
+ * The role every representative holds in the granting organization. One of its kind's `confers.roles` that the
367
+ * granting organization's type offers, never one leading up to `ORG_ADMIN` (refused at startup).
368
+ * The representative memberships' `roles` mirror it; the live filter emits THIS value.
369
+ */
370
+ role: z.string().min(1).isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
371
+
372
+ /**
373
+ * Engagement scope. Absent or empty ⇒ organization-wide. Present ⇒ the representatives reach ONLY these units:
374
+ * the live filter emits one unit-scoped role entry per id and NO organization-wide entry, so a
375
+ * resource that neither narrows by unit nor is declared organization-wide for representatives is refused.
376
+ * Stored once, here — no `ORGANIZATION_UNIT_MEMBERS` rows mirror it.
377
+ */
378
+ organizationUnitIds: z.array(z.string().min(1)).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
379
+
380
+ /** The term. Absent ⇒ open-ended. Admission reads this, never the EXPIRED label. */
381
+ // Nullish: `amendScope` CLEARS a term by writing null, which means "no term".
382
+ endsAt: z.date().nullish().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
383
+
384
+ /** Why the relationship exists — required, and the fact the granting organization's processor register derives from. */
385
+ purpose: purposeField(),
386
+
387
+ /**
388
+ * OAuth clients owned by the representing organization that the granting organization admits into its organization
389
+ * under this relationship (S3). A listed client authenticating by client credentials receives the relationship's role
390
+ * in THIS organization, re-checked per request. What such a principal may do is decided elsewhere.
391
+ */
392
+ admittedMachineClientIds: z.array(z.string().min(1)).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
393
+
394
+ /**
395
+ * Which of the representing organization's autonomous agents the granting organization lets each admitted machine
396
+ * client run HERE (#1611). The representing organization decides which agents its machine client runs
397
+ * (`autonomousAgentRefs` on the OAuth client); the GRANTING organization decides which of those may act in its
398
+ * organization, at the relationship's role and on its token budget. A turn needs both: see
399
+ * {@link relationshipAdmitsAutonomousAgent}. No entry for a machine client, or an empty list, admits none — a
400
+ * representing organization adding an agent to its own machine client never starts it in a granting organization that
401
+ * did not choose it.
402
+ *
403
+ * Written only by `admitMachineClient` (which replaces the machine client's entry) and `removeMachineClient` (which
404
+ * drops it), so it can never name a client `admittedMachineClientIds` does not.
405
+ */
406
+ admittedAutonomousAgents: z.array(RelationshipAdmittedAutonomousAgentsSchema).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
407
+
408
+ /**
409
+ * Whether each representative the representing organization assigns waits for the granting organization's own
410
+ * approval (#1612). The GRANTING organization's choice: written by its `propose`, `accept` and
411
+ * `setRepresentativeAdmissionPolicy` only — a proposal from the representing side starts from the granting
412
+ * organization type's declared default, and no verb of the representing side reads a value for it.
413
+ */
414
+ representativeAdmissionPolicy: z.enum(RepresentativeAdmissionPolicy)
415
+ .systemEnum('RepresentativeAdmissionPolicy')
416
+ .default(RepresentativeAdmissionPolicy.ADMITTED_ON_DESIGNATION)
417
+ .isSummaryField()
418
+ .excludeFromCreate()
419
+ .excludeFromUpdate()
420
+ .isAuditEvidence(),
421
+
422
+ /**
423
+ * Whether the granting organization accepts the multi-factor proof the REPRESENTING organization's own enterprise
424
+ * identity provider made (#1633). The granting organization's choice, written only by its `setRepresentingMfaTrust`
425
+ * verb (ORG_OWNER, step-up); off by default. The granting organization type's authentication policy governs the
426
+ * representatives either way — this only decides whether a factor the representing organization's provider reported
427
+ * may satisfy it. See {@link RelationshipMfaTrust}.
428
+ */
429
+ representingMfaTrust: z.enum(RelationshipMfaTrust)
430
+ .systemEnum('RelationshipMfaTrust')
431
+ .default(RelationshipMfaTrust.NOT_TRUSTED)
432
+ .isSummaryField()
433
+ .excludeFromCreate()
434
+ .excludeFromUpdate()
435
+ .isAuditEvidence(),
436
+
437
+ /**
438
+ * How much of the audit rows the representatives' acts wrote in this granting organization the REPRESENTING
439
+ * organization's administrators may read (#2874). The granting organization's choice, written only by its
440
+ * `setRepresentativeActivityDisclosure` verb (ORG_ADMIN); `METADATA` by default. Read live, per row, by the
441
+ * representative-activity read. See {@link RepresentativeActivityDisclosure}.
442
+ */
443
+ representativeActivityDisclosure: z.enum(RepresentativeActivityDisclosure)
444
+ .systemEnum('RepresentativeActivityDisclosure')
445
+ .default(RepresentativeActivityDisclosure.METADATA)
446
+ .isSummaryField()
447
+ .excludeFromCreate()
448
+ .excludeFromUpdate()
449
+ .isAuditEvidence(),
450
+
451
+ /** Which side proposed — the OTHER side accepts. */
452
+ proposedByOrganizationId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
453
+ proposedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
454
+ acceptedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
455
+ acceptedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
456
+ endedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
457
+ /*
458
+ * The people above, NAMED (#1852): each stamp is a user id and deliberately not a foreign key (it records who acted,
459
+ * nothing navigates through it), so its screen showed 24 hexadecimal characters. Resolved at read time
460
+ * (`forwardedUserName`), never stored: the row's evidence holds the ids and nothing else.
461
+ *
462
+ * Only the GRANTING organization reads this row, and a person of either side may be named here: the granting side is
463
+ * already told who the representing side's people are (a representative's name in its directory, the assigner's on
464
+ * an approval card). The representing side reads its own mirror, which carries no person.
465
+ */
466
+ proposedByName: forwardedUserName({ localField: 'proposedByUserId' }),
467
+ acceptedByName: forwardedUserName({ localField: 'acceptedByUserId' }),
468
+ endedByName: forwardedUserName({ localField: 'endedByUserId' }),
469
+ /** When a terminal status was reached — the retention clock's start point. */
470
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
471
+ decisionReason: decisionReasonField(),
472
+
473
+ createdAt: z.date().optional(),
474
+ updatedAt: z.date().optional(),
475
+ });
476
+ export type OrganizationRelationship = z.infer<typeof OrganizationRelationshipSchema>;
477
+
478
+ /**
479
+ * The representing side's mirror of one relationship, stored in the REPRESENTING organization.
480
+ *
481
+ * System-written in the same transaction as every relationship transition, and what the representing organization
482
+ * reads — its list of granting organizations, the representative assignment screen, the organization switcher's
483
+ * grouping. It carries only what the representing side needs: the granting organization's unit ids stay in its own
484
+ * tenant (`scopedToOrganizationUnits` says whether a scope exists, not what it is).
485
+ */
486
+ export const OrganizationRepresentationSchema = z.object({
487
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
488
+
489
+ /** The REPRESENTING organization. */
490
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
491
+
492
+ /** The granting organization. A plain id for the same reason as `representingOrganizationId` on the relationship. */
493
+ grantingOrganizationId: z.string().min(1).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
494
+
495
+ /** The relationship this mirrors, in the granting organization's tenant. Unique: one mirror per relationship. */
496
+ organizationRelationshipId: z.string().min(1).isDBIndexed().isUnique().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
497
+
498
+ /** The relationship's kind, copied from it (#2722): the representing side reads its own record, never the other tenant's. */
499
+ kind: z.string().min(1).systemEnum(ApplicationConfigVocabulary.ORGANIZATION_RELATIONSHIP_KIND).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate(),
500
+
501
+ status: z.enum(OrganizationRelationshipStatus)
502
+ .systemEnum('OrganizationRelationshipStatus')
503
+ .default(OrganizationRelationshipStatus.PROPOSED)
504
+ .isDBIndexed()
505
+ .isSummaryField()
506
+ .excludeFromCreate()
507
+ .excludeFromUpdate(),
508
+ role: z.string().min(1).isSummaryField().excludeFromCreate().excludeFromUpdate(),
509
+ scopedToOrganizationUnits: z.boolean().default(false).isSummaryField().excludeFromCreate().excludeFromUpdate(),
510
+ // Nullish, and always written by the mirror sync: a term the granting organization cleared must clear here too.
511
+ endsAt: z.date().nullish().isSummaryField().excludeFromCreate().excludeFromUpdate(),
512
+ purpose: purposeField(),
513
+ proposedByOrganizationId: z.string().min(1).excludeFromCreate().excludeFromUpdate(),
514
+ /**
515
+ * Display copy of the granting organization's name — the representing organization cannot read the granting row.
516
+ * Written only once the granting organization has consented to the representing organization knowing it (it proposed
517
+ * to this organization, or accepted this organization's proposal), then refreshed at each transition. Absent while a
518
+ * representing organization's proposal is pending and after a decline: a proposal must not be a way to learn a
519
+ * tenant's name. The one exception is the second direction of a MUTUAL relationship, written at its proposal: the two
520
+ * organizations already dealt with each other in the first direction (#2722, review H1).
521
+ *
522
+ * Personal data where the granting organization is a sole trader (#2119, #2535), kept with the mirror as the
523
+ * representing organization's record of whom it served; the granting organization's deletion does not scrub it.
524
+ */
525
+ grantingOrganizationName: z.string().max(200).optional().isSummaryField().excludeFromCreate().excludeFromUpdate()
526
+ .dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true }),
527
+ /**
528
+ * The granting organization's admission policy, mirrored so the representing organization knows before assigning
529
+ * whether each representative will wait for the granting organization's approval (#1612). Read-only here: the
530
+ * representing side has no verb that writes it.
531
+ */
532
+ representativeAdmissionPolicy: z.enum(RepresentativeAdmissionPolicy)
533
+ .systemEnum('RepresentativeAdmissionPolicy')
534
+ .default(RepresentativeAdmissionPolicy.ADMITTED_ON_DESIGNATION)
535
+ .isSummaryField()
536
+ .excludeFromCreate()
537
+ .excludeFromUpdate(),
538
+ /**
539
+ * The administrative capabilities the granting organization currently lends this representing organization (#1631),
540
+ * with when each ends — mirrored so the representing side knows what its representatives may do there. System-written
541
+ * on every grant and revocation; read-only to the representing side, which can never grant, widen or extend one.
542
+ */
543
+ delegatedCapabilities: z.array(OrganizationRepresentationDelegatedCapabilitySchema).optional().excludeFromCreate().excludeFromUpdate(),
544
+ /** Mirrors the relationship's end — the retention clock's start point, so the sweep queries it (indexed). */
545
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
546
+ decisionReason: decisionReasonField(),
547
+
548
+ createdAt: z.date().optional(),
549
+ updatedAt: z.date().optional(),
550
+ });
551
+ export type OrganizationRepresentation = z.infer<typeof OrganizationRepresentationSchema>;
552
+
553
+ /**
554
+ * Has the GRANTING organization consented to the representing organization knowing its name? (#1597 review L2, #2722)
555
+ *
556
+ * A representing organization can propose to any organization whose id it knows, so a name disclosed at that proposal,
557
+ * or on the granting organization's refusal of it, would tell a tenant's name to a party it never agreed to deal with.
558
+ * The name is owed only once the granting organization took a step toward it: proposing to that representing
559
+ * organization itself, or accepting its proposal (`acceptedAt`, which stays set through suspension and termination, so
560
+ * a name once disclosed is not withdrawn from the representing organization's history).
561
+ *
562
+ * The ONE rule for every place the representing side may see the granting side's name: the mirror's
563
+ * `grantingOrganizationName`, and the emails a relationship verb sends the representing organization (#2781).
564
+ */
565
+ export function grantingOrganizationConsentedToNameDisclosure(
566
+ relationship: { readonly organizationId?: unknown; readonly proposedByOrganizationId?: unknown; readonly acceptedAt?: unknown } | null | undefined,
567
+ ): boolean {
568
+ // A row that does not say whose it is gives no consent: `undefined === undefined` must not read as "it proposed".
569
+ if (!relationship || typeof relationship.organizationId !== 'string' || relationship.organizationId.length === 0) return false;
570
+ return relationship.proposedByOrganizationId === relationship.organizationId || Boolean(relationship.acceptedAt);
571
+ }
572
+
573
+ /**
574
+ * Which of the representing organization's members serve which engagement — stored in the REPRESENTING organization,
575
+ * decided by its administrators. Assigning creates (or reactivates) the representative's representative membership in the
576
+ * granting organization; unassigning makes it INACTIVE. The live filter reads the ACTIVE assignment for
577
+ * `(organizationRelationshipId, userId)` on every request.
578
+ */
579
+ export const RepresentativeAssignmentSchema = z.object({
580
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
581
+
582
+ /** The REPRESENTING organization. */
583
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
584
+
585
+ /** The engagement (mirror) this assignment serves — same tenant, a real edge. */
586
+ organizationRepresentationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
587
+
588
+ /** The representative. Must be an ACTIVE, ordinary member of the representing organization when assigned. */
589
+ userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence()
590
+ .foreignKeyUI({ display: { labelFallbackField: 'representativeName' } }),
591
+ /**
592
+ * The representative, NAMED (#1852): `userId`'s `labelFallbackField`, for an administrator who may not read the
593
+ * member's account. Resolved at read time (`forwardedUserName`), never stored. Shown through the reference.
594
+ */
595
+ representativeName: forwardedUserName({ localField: 'userId' }).isSummaryField().isHidden({ display: true }),
596
+
597
+ /** Copied from the engagement so the live filter reads one row by `(relationship, user)`. */
598
+ organizationRelationshipId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
599
+ grantingOrganizationId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
600
+
601
+ status: z.enum(RepresentativeAssignmentStatus)
602
+ .systemEnum('RepresentativeAssignmentStatus')
603
+ .default(RepresentativeAssignmentStatus.ACTIVE)
604
+ .isDBIndexed()
605
+ .isSummaryField()
606
+ .excludeFromCreate()
607
+ .excludeFromUpdate()
608
+ .isAuditEvidence(),
609
+
610
+ /**
611
+ * The representing organization's administrator who assigned the person (#3010: a decider, sealed by ASSIGN as an
612
+ * authorization the granting organization relies on). Their own access export carries the act (the resource's
613
+ * `assignedByUserId` person column); the representative's copy withholds it, with `assignedByName`, as another
614
+ * person's data (#3562).
615
+ */
616
+ assignedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
617
+ /**
618
+ * Who assigned, NAMED (#1852): an administrator of the representing organization, which reads this row. Resolved at read
619
+ * time (`forwardedUserName`), never stored. `endedByUserId` below has no name on purpose: an assignment ends with its
620
+ * relationship, and then the actor may be the granting organization's administrator, whom the representing
621
+ * organization is never told about (see `approvalResolvedAt`).
622
+ */
623
+ assignedByName: forwardedUserName({ localField: 'assignedByUserId' }),
624
+ assignedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
625
+
626
+ /**
627
+ * The granting organization's pending approval of this representative (#1612): the `HumanDecision_Request.decisionId`
628
+ * of the decision routed to the granting organization's administrators, set when the assignment was made under a
629
+ * relationship whose granting organization approves each representative. It is the ONE key the decision is read,
630
+ * listed and settled by, and the settle write matches on it, so an answer can only ever settle the request it was given.
631
+ */
632
+ approvalDecisionId: z.string().min(1).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
633
+ /**
634
+ * When the granting organization's approval ended — approved, denied or lapsed. Indexed (#2880): the ending repair lists
635
+ * the approvals settled within its window by it, whatever the assignment's status has become since (an approved
636
+ * assignment may since have ENDED). A withdrawal of an approval nobody answered never sets it.
637
+ */
638
+ approvalResolvedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
639
+ /**
640
+ * The granting organization's administrator who ANSWERED the approval (approved or refused), written by the
641
+ * `settleGrantorApproval` verb in the same write as the answer (#2880). Absent on a lapse, a late answer the verb ends
642
+ * LAPSED, and a withdrawal: nobody decided those.
643
+ *
644
+ * BACKEND-ONLY, and that is the whole design: the representing organization reads this row, and is never told who in
645
+ * the granting organization decided (the decision's resolved row, in the GRANTING organization's trail, names them).
646
+ * So it is never in a response, a listing, another person's subject-export bundle or an email, and it is deliberately NOT
647
+ * `.isAuditEvidence()`: that would put its value on the settle's `RESOURCE_OPERATION_PERFORMED` row, which sits in the
648
+ * representing organization's trail.
649
+ *
650
+ * It exists for one reader: the ending repair (`repairUnrecordedRepresentativeApprovalEndings`), which records and tells
651
+ * an answer whose commit landed with its reply lost, so its ending row names the person who answered rather than nobody.
652
+ * Kept as evidence on erasure, like the other actor ids here (the resource is RETAIN_ONLY).
653
+ *
654
+ * `disclosedToSubject` (#2958): the decider's OWN access export carries the decision they took, through the resource's
655
+ * `approvalDecidedByUserId` person column. The representative, who reads this row through their `userId` edge, never
656
+ * does: the resource withholds the field from every edge as another person's data (`subjectExportOthersDataFields`).
657
+ */
658
+ approvalDecidedByUserId: z.string().min(1).optional().isBackendOnly({ disclosedToSubject: true }).excludeFromCreate().excludeFromUpdate().isDecider(),
659
+ /** Why a DENIED assignment admitted nobody — a fact the representing side may know, never who in the granting organization decided. */
660
+ approvalDenialReason: z.enum(RepresentativeApprovalDenialReason)
661
+ .systemEnum('RepresentativeApprovalDenialReason')
662
+ .optional()
663
+ .excludeFromCreate()
664
+ .excludeFromUpdate(),
665
+
666
+ /**
667
+ * The clocks of a pending approval by the granting organization (#1909), armed at `assign` from the relationship
668
+ * kind's `granting.organizationTypes[type].representativeApprovalDeadlines` for the granting organization's type, with
669
+ * #1628's model, and stored rather than recomputed so a deployment that changes the declaration never reshapes a clock
670
+ * already running.
671
+ *
672
+ * - `approvalLapseAt` — when the approval ends LAPSED, admitting nobody. The representing organization may see it: it
673
+ * is when its request stops waiting.
674
+ * - `approvalDecisionDeadlineAt` / `approvalDecisionWarningAt` — the DECISION service target and its optional
675
+ * warning, on `approvalDecisionClockBasis`. There is no CLAIM clock: this plane offers no claim.
676
+ * - `approvalDecisionWarningFiredAt` / `approvalDecisionMissedFiredAt` — each stage's fired marker, set by a
677
+ * compare-and-swap that requires it null, so a stage fires exactly once across hosts.
678
+ * - `approvalNextDueAt` — the earliest of the lapse and any stage still to fire: what the sweep selects by index.
679
+ */
680
+ approvalLapseAt: z.date().nullish().isDBIndexed().excludeFromCreate().excludeFromUpdate()
681
+ .describe('While the granting organization has not decided on this assignment: when the request lapses, admitting nobody. Empty once the granting organization has decided.'),
682
+ approvalDecisionDeadlineAt: z.date().nullish().excludeFromCreate().excludeFromUpdate()
683
+ .describe('The service target by which the granting organization is expected to decide on this assignment, counted on `approvalDecisionClockBasis`.'),
684
+ approvalDecisionWarningAt: z.date().nullish().excludeFromCreate().excludeFromUpdate()
685
+ .describe('When the granting organization is warned that the decision target is near, when its organization type declares a warning. Empty otherwise.'),
686
+ approvalDecisionClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').nullish().excludeFromCreate().excludeFromUpdate()
687
+ .describe('How the decision target is counted: `elapsed` wall-clock time, or `calendar` working hours of the application\'s review calendar.'),
688
+ approvalDecisionWarningFiredAt: z.date().nullish().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
689
+ approvalDecisionMissedFiredAt: z.date().nullish().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
690
+ approvalNextDueAt: z.date().nullish().isDBIndexed().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
691
+ /**
692
+ * #2923: the step-up the granting organization's administrator must carry to answer the approval, from the granting
693
+ * type's `representativeApprovalStepUp` when the assignment was made; absent when it requires none. Stored like the
694
+ * clocks, so a declaration changed or removed while the approval waits never changes what answering it requires.
695
+ */
696
+ approvalStepUpRequirement: HumanDecision_StepUpRequirementSchema.optional().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
697
+ /** #2923: the channels that may answer the approval, from `representativeApprovalAnswerChannels` at assign, stored the same way. */
698
+ approvalAnswerChannels: HumanDecision_AnswerChannelsSchema.optional().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
699
+
700
+ /**
701
+ * Who ended the assignment. Their own access export carries the act (the `endedByUserId` person column); the
702
+ * representative's copy withholds it as another person's data (#3562).
703
+ */
704
+ endedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
705
+ /** When the assignment ended — the retention clock's start point. */
706
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
707
+
708
+ createdAt: z.date().optional(),
709
+ updatedAt: z.date().optional(),
710
+ });
711
+ export type RepresentativeAssignment = z.infer<typeof RepresentativeAssignmentSchema>;
712
+
713
+ /**
714
+ * The input of the INTERNAL `settleGrantorApproval` verb (#1612): which pending approval, and how the granting
715
+ * organization answered.
716
+ *
717
+ * `outcome` is the one decision vocabulary (`HumanDecision_Outcome`). Only ACCEPTED, REJECTED and LAPSED settle a
718
+ * representative approval — the verb refuses the others rather than reading them as one of these.
719
+ */
720
+ export const RepresentativeAssignmentSettleGrantorApprovalDtoSchema = z.object({
721
+ approvalDecisionId: z.string().min(1),
722
+ outcome: z.enum(HumanDecision_Outcome),
723
+ /**
724
+ * The granting organization's administrator who answered — recorded in the GRANTING organization's trail, and on the
725
+ * assignment only as its backend-only `approvalDecidedByUserId` (#2880), which no response carries to the
726
+ * representing organization that reads the row.
727
+ */
728
+ decidedByUserId: z.string().min(1).optional(),
729
+ /** #2664: the inbound delivery the answer arrived through (a chat button), recorded on the RESOLVED row with it. */
730
+ answeredThrough: HumanDecision_AnsweredThroughSchema.optional(),
731
+ /** #2905: how the administrator who answered was authenticated, recorded on the RESOLVED row with them. Never stored. */
732
+ decider: HumanDecision_DeciderRecordSchema.optional(),
733
+ /**
734
+ * #2903: what the administrator was shown, as the decision host checked it against the assignment, and what they
735
+ * answered, sealed with the answer in the settle's transaction. Built by the host, never by a caller.
736
+ */
737
+ presentation: HumanDecision_SealedPresentationSchema.optional(),
738
+ statement: HumanDecision_StatementSchema.optional(),
739
+ });
740
+ export type RepresentativeAssignmentSettleGrantorApprovalDto = z.infer<typeof RepresentativeAssignmentSettleGrantorApprovalDtoSchema>;
741
+
742
+ /**
743
+ * The input of the INTERNAL `recordTypeChangeStanding` verb (#2611, #2794): what the type change did to the relationship,
744
+ * and which party's type changed. The party told is the OTHER one.
745
+ */
746
+ export const RecordTypeChangeStandingDtoSchema = z.object({
747
+ transition: z.enum([OrganizationRelationshipTransition.DORMANT_BY_TYPE_CHANGE, OrganizationRelationshipTransition.REVIVED_BY_TYPE_CHANGE])
748
+ .systemEnum('OrganizationRelationshipTransition'),
749
+ changedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
750
+ });
751
+ export type RecordTypeChangeStandingDto = z.infer<typeof RecordTypeChangeStandingDtoSchema>;
752
+
753
+ /**
754
+ * The input of the INTERNAL `recordPartyStatusStanding` verb (#2795): what a party organization's status change did to the
755
+ * relationship, which party changed, and the status it now has, which is what the other party is told (a suspension and a
756
+ * deletion mean different things to it: the second ends the relationship unless the organization is restored).
757
+ */
758
+ export const RecordPartyStatusStandingDtoSchema = z.object({
759
+ transition: z.enum([OrganizationRelationshipTransition.DORMANT_BY_PARTY_STATUS, OrganizationRelationshipTransition.REVIVED_BY_PARTY_STATUS])
760
+ .systemEnum('OrganizationRelationshipTransition'),
761
+ changedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
762
+ // No `.systemEnum`: the organization's own `status` declares none, and this internal input is never rendered.
763
+ partyStatus: z.enum(OrganizationStatus),
764
+ });
765
+ export type RecordPartyStatusStandingDto = z.infer<typeof RecordPartyStatusStandingDtoSchema>;
766
+
767
+ /**
768
+ * The input of the INTERNAL `endForRemovedParty` verb (#2794): which party organization is being deleted. Who deleted it
769
+ * is not an input: the organization delete runs the verb on that person's behalf (`auditActorUserId`, evidence only).
770
+ */
771
+ export const EndForRemovedPartyDtoSchema = z.object({
772
+ removedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
773
+ });
774
+ export type EndForRemovedPartyDto = z.infer<typeof EndForRemovedPartyDtoSchema>;
775
+
776
+ /**
777
+ * The statuses that end one direction of a MUTUAL relationship and so end the other with it (#2722 Phase 3, #2796): the
778
+ * granting side's DECLINED, TERMINATED and EXPIRED, and the representing side's WITHDRAWN. Each also says which side
779
+ * acted: the representing side only ever ends a relationship as WITHDRAWN, the granting side never does.
780
+ */
781
+ export const RECIPROCAL_ENDING_CAUSES = [
782
+ OrganizationRelationshipStatus.DECLINED,
783
+ OrganizationRelationshipStatus.TERMINATED,
784
+ OrganizationRelationshipStatus.WITHDRAWN,
785
+ OrganizationRelationshipStatus.EXPIRED,
786
+ ] as const;
787
+
788
+ /**
789
+ * The input of the INTERNAL `endWithReciprocal` verb (#2796): the status that ended the OTHER direction of the mutual
790
+ * agreement. The verb derives everything else from it and from the row (what this direction becomes, and which
791
+ * organization acted). Who acted is not an input: the ending verb runs it on that person's behalf (`auditActorUserId`).
792
+ */
793
+ export const EndWithReciprocalDtoSchema = z.object({
794
+ endedDirectionStatus: z.enum(RECIPROCAL_ENDING_CAUSES).systemEnum('OrganizationRelationshipStatus'),
795
+ });
796
+ export type EndWithReciprocalDto = z.infer<typeof EndWithReciprocalDtoSchema>;
797
+
798
+ /**
799
+ * The client-branchable codes a relationship refusal carries (all answer 409 CONFLICT: the caller is
800
+ * authorized and the payload is valid; the current STATE forbids the write).
801
+ */
802
+ export enum OrganizationRelationshipErrorCode {
803
+ /** A PROPOSED, ACTIVE or SUSPENDED relationship already links this representing and this granting organization. */
804
+ ORGANIZATION_RELATIONSHIP_ALREADY_LIVE = 'ORGANIZATION_RELATIONSHIP_ALREADY_LIVE',
805
+ /** The representative is one of the granting organization's OWN members; a person is in an organization one way at a time. */
806
+ RELATIONSHIP_ASSIGNMENT_CONFLICTS_WITH_MEMBERSHIP = 'RELATIONSHIP_ASSIGNMENT_CONFLICTS_WITH_MEMBERSHIP',
807
+ /** The representative already serves this granting organization under another live relationship. */
808
+ RELATIONSHIP_ASSIGNMENT_ALREADY_LIVE = 'RELATIONSHIP_ASSIGNMENT_ALREADY_LIVE',
809
+ /** A representative membership's roles belong to the relationship; change the relationship, not the membership. */
810
+ RELATIONSHIP_MEMBERSHIP_ROLES_OWNED_BY_RELATIONSHIP = 'RELATIONSHIP_MEMBERSHIP_ROLES_OWNED_BY_RELATIONSHIP',
811
+ /**
812
+ * An invitation to a person who has a REPRESENTATIVE membership in this organization. A live one: the person is
813
+ * already here through a representing organization. An ended one (INACTIVE): remove that membership first, then invite.
814
+ */
815
+ RELATIONSHIP_MEMBERSHIP_CONFLICTS_WITH_INVITATION = 'RELATIONSHIP_MEMBERSHIP_CONFLICTS_WITH_INVITATION',
816
+ /**
817
+ * An organization type does not take the side this act needs. In a relationship verb, no kind admits the two
818
+ * organizations' types in these sides (or the named kind does not).
819
+ */
820
+ RELATIONSHIP_ORGANIZATION_TYPE_NOT_ELIGIBLE = 'RELATIONSHIP_ORGANIZATION_TYPE_NOT_ELIGIBLE',
821
+ /** The side that proposed tried to accept its own proposal. */
822
+ RELATIONSHIP_PROPOSAL_ACCEPTED_BY_PROPOSER = 'RELATIONSHIP_PROPOSAL_ACCEPTED_BY_PROPOSER',
823
+ /** The requested role is not one the relationship's kind confers, or the granting type does not offer it. */
824
+ RELATIONSHIP_ROLE_NOT_DECLARED = 'RELATIONSHIP_ROLE_NOT_DECLARED',
825
+ /** The relationship's kind lets only the other side propose (`proposedBy`): this side accepts a proposal, never makes one. */
826
+ RELATIONSHIP_KIND_NOT_PROPOSED_BY_THIS_SIDE = 'RELATIONSHIP_KIND_NOT_PROPOSED_BY_THIS_SIDE',
827
+ /** A requested organization unit is not a unit of the granting organization. */
828
+ RELATIONSHIP_UNIT_NOT_IN_GRANTOR = 'RELATIONSHIP_UNIT_NOT_IN_GRANTOR',
829
+ /**
830
+ * Assignment needs an ACTIVE engagement, a relationship that confers right now (ACTIVE, in term, still admitted by its
831
+ * kind, both organizations conferring authority: #2616) and an ACTIVE, ordinary member of the representing organization.
832
+ */
833
+ RELATIONSHIP_ASSIGNMENT_NOT_ELIGIBLE = 'RELATIONSHIP_ASSIGNMENT_NOT_ELIGIBLE',
834
+ /**
835
+ * The granting organization SUSPENDED this representative's membership. That is the granting organization's decision
836
+ * about one person, and an assignment by the representing side may not undo it: the granting organization reactivates
837
+ * the membership first.
838
+ */
839
+ REPRESENTATIVE_SUSPENDED_BY_GRANTOR = 'REPRESENTATIVE_SUSPENDED_BY_GRANTOR',
840
+ /** The OAuth client to admit is not an ACTIVE client owned by the representing organization. */
841
+ RELATIONSHIP_MACHINE_CLIENT_NOT_ELIGIBLE = 'RELATIONSHIP_MACHINE_CLIENT_NOT_ELIGIBLE',
842
+ /** The representing organization already has a PENDING, unexpired invitation to this address: revoke it before inviting again (#2618). */
843
+ RELATIONSHIP_INVITATION_ALREADY_PENDING = 'RELATIONSHIP_INVITATION_ALREADY_PENDING',
844
+ /** The relationship is confined to units, and its kind confers only organization-wide relationships (`confers.unitScope: false`). */
845
+ RELATIONSHIP_KIND_CONFERS_NO_UNIT_SCOPE = 'RELATIONSHIP_KIND_CONFERS_NO_UNIT_SCOPE',
846
+ /** The kind forbids accepting the representing organization's identity-provider MFA (`confers.representingMfaTrust: false`). */
847
+ RELATIONSHIP_KIND_FORBIDS_MFA_TRUST = 'RELATIONSHIP_KIND_FORBIDS_MFA_TRUST',
848
+ /**
849
+ * The invitee acted on an invitation that can no longer be delivered (#2716): the representing organization revoked it,
850
+ * it was delivered or declined, or it lapsed. Answered only to the person it is addressed to.
851
+ */
852
+ RELATIONSHIP_INVITATION_NO_LONGER_PENDING = 'RELATIONSHIP_INVITATION_NO_LONGER_PENDING',
853
+ /**
854
+ * A granting organization asked "the operator" without naming one, under a kind in which the operating organization is
855
+ * not the only representing party (`OperatorStanding.OPERATOR_IS_PARTY`), or whose operating organization cannot be
856
+ * reached (#2618, #2722). Only then is there exactly one organization to ask.
857
+ */
858
+ RELATIONSHIP_OPERATOR_UNAVAILABLE = 'RELATIONSHIP_OPERATOR_UNAVAILABLE',
859
+ /** The proposal names no relationship kind, and more than one kind admits this pair of organization types (#2722). */
860
+ RELATIONSHIP_KIND_REQUIRED = 'RELATIONSHIP_KIND_REQUIRED',
861
+ /**
862
+ * The record named for sharing cannot be shared (#2722): its resource is not one of the organization's separated records
863
+ * (an application- or user-scoped resource, the organization row, the member directory, a system of record's row), or it
864
+ * issues authority (a credential, a membership, a relationship), which is never shared.
865
+ */
866
+ RELATIONSHIP_RECORD_NOT_SHAREABLE = 'RELATIONSHIP_RECORD_NOT_SHAREABLE',
867
+ }
868
+ ```
869
+
870
+ ### Origin Package: `@wildo-ai/saas-models`
871
+
872
+ ```typescript
873
+ /**
874
+ * The granting side's verbs. Kept with the vocabulary, not the resources-config, for the reason recorded on
875
+ * `PlatformAccessGrants_Operations`: authorization and batch code need the names without dragging
876
+ * resource-configuration evaluation into their module graph.
877
+ *
878
+ * No generic CREATE / UPDATE: every field's server authorship IS the control.
879
+ */
880
+ export enum OrganizationRelationships_Operations {
881
+ /** The granting organization's ORG_OWNER proposes a relationship to a representing organization. The proposal is the granting organization's consent. */
882
+ PROPOSE = 'propose',
883
+ /** The granting organization's ORG_OWNER accepts a REPRESENTING organization's proposal (step-up). Never available to the proposing side. */
884
+ ACCEPT = 'accept',
885
+ /** The granting organization's ORG_ADMIN refuses a representing organization's proposal. */
886
+ DECLINE = 'decline',
887
+ SUSPEND = 'suspend',
888
+ RESUME = 'resume',
889
+ TERMINATE = 'terminate',
890
+ /**
891
+ * The granting organization's ORG_OWNER changes role, units or term (step-up). The representing organization cannot
892
+ * widen what the granting organization granted.
893
+ */
894
+ AMEND_SCOPE = 'amendScope',
895
+ ADMIT_MACHINE_CLIENT = 'admitMachineClient',
896
+ REMOVE_MACHINE_CLIENT = 'removeMachineClient',
897
+ /** ACTIVE → EXPIRED past `endsAt`, dispatched by the credential-expiry sweep only. */
898
+ EXPIRE = 'expire',
899
+ /**
900
+ * INTERNAL: a party organization is being deleted, so the relationship ends inside that deletion's transaction (#2794):
901
+ * TERMINATED when the granting organization goes, WITHDRAWN when the representing one does. Run by the organization
902
+ * delete only, one relationship at a time, so the remaining party is told through this verb's declared notice.
903
+ */
904
+ END_FOR_REMOVED_PARTY = 'endForRemovedParty',
905
+ /**
906
+ * INTERNAL: one party's type changed, and the relationship stopped conferring (`DORMANT_BY_TYPE_CHANGE`) or confers
907
+ * again (`REVIVED_BY_TYPE_CHANGE`) (#2611, #2794). Stores nothing about it on the row (dormancy is derived per request,
908
+ * so a stored copy would drift when a declaration changes; only `updatedAt` moves, the framework's core update of an
909
+ * entity replace): it records the transition in both trails and tells the party whose type did NOT change. Run by
910
+ * `organizations.changeType` and owner promotion only.
911
+ */
912
+ RECORD_TYPE_CHANGE_STANDING = 'recordTypeChangeStanding',
913
+ /**
914
+ * INTERNAL: the other direction of a MUTUAL relationship ended, so this one ends with it, in the same transaction
915
+ * (#2722 Phase 3, #2796). Run by every verb that ends a direction, so the organization whose own tenant this direction
916
+ * narrows is told through this verb's declared notice rather than learning it from nothing.
917
+ */
918
+ END_WITH_RECIPROCAL = 'endWithReciprocal',
919
+ /**
920
+ * INTERNAL: one party organization stopped operating or operates again, and the relationship stopped conferring
921
+ * (`DORMANT_BY_PARTY_STATUS`) or confers again (`REVIVED_BY_PARTY_STATUS`) (#2795). The status-change twin of
922
+ * `recordTypeChangeStanding`: stores nothing (conferral is derived per request), records the transition in both trails
923
+ * and tells the party whose status did NOT change. Run by `organizations` `suspend`, `activate`, `requestDeletion` and
924
+ * `restore`, only for a change that crosses the line between a status that confers and one that does not.
925
+ */
926
+ RECORD_PARTY_STATUS_STANDING = 'recordPartyStatusStanding',
927
+ /** The granting organization's ORG_OWNER decides whether the representing organization's own identity provider's MFA counts here (#1633, step-up). */
928
+ SET_REPRESENTING_MFA_TRUST = 'setRepresentingMfaTrust',
929
+ /** The granting organization's ORG_ADMIN decides how much of its representatives' activity rows the representing organization reads (#2874). */
930
+ SET_REPRESENTATIVE_ACTIVITY_DISCLOSURE = 'setRepresentativeActivityDisclosure',
931
+ /**
932
+ * The granting organization's ORG_ADMIN changes how the representatives are admitted (#1612). Not retroactive. The
933
+ * representing side has no such verb.
934
+ */
935
+ SET_REPRESENTATIVE_ADMISSION_POLICY = 'setRepresentativeAdmissionPolicy',
936
+ /**
937
+ * The granting organization's administrator shares one of its records with this relationship (#2722): the record
938
+ * becomes visible to the relationship's representatives, whichever relationship (or none) created it. Decision #2617:
939
+ * a granting organization may share one representing organization's record with another. The representing side has no
940
+ * such verb.
941
+ */
942
+ SHARE_RECORD = 'shareRecord',
943
+ /** Withdraws a share {@link SHARE_RECORD} made. Never hides a record the relationship created itself. */
944
+ UNSHARE_RECORD = 'unshareRecord',
945
+ /**
946
+ * The granting organization's administrator reads whose one of its records is and which relationships it is shared
947
+ * with (#2736): what a screen offering {@link SHARE_RECORD} / {@link UNSHARE_RECORD} shows. Answered only to the
948
+ * organization's own administrators, never on the record's own response: a representative reading a shared record must
949
+ * not learn which other relationships it reaches, nor the id of the one that created it (#2617).
950
+ */
951
+ READ_RECORD_SHARING = 'readRecordSharing',
952
+ }
953
+
954
+ /**
955
+ * What one relationship's people reach of one record (#2736), as the sharing read answers it: each field the engine's own
956
+ * decision (`describeRelationshipRecordReach`), so a screen offers a share only where it changes what someone reads.
957
+ */
958
+ export const RelationshipRecordReachSchema = z.object({
959
+ confersNow: z.boolean()
960
+ .describe('The relationship confers authority right now: live, its kind and role still declared, both organizations active.'),
961
+ rolesReachRecord: z.boolean()
962
+ .describe('Its people\'s roles let them read this record, before any share: the resource\'s read permission through the relationship\'s role and the capabilities you lent it, and, for a relationship limited to units, the record\'s unit.'),
963
+ readsWithoutShare: z.boolean()
964
+ .describe('Its people read this record without a share naming the relationship: it was created through it, the relationship reads your organization\'s own records of this kind, or the kind is common to every relationship.'),
965
+ wouldReadIfShared: z.boolean()
966
+ .describe('Sharing the record with the relationship would let its people read it.'),
967
+ });
968
+ export type RelationshipRecordReach = z.infer<typeof RelationshipRecordReachSchema>;
969
+
970
+ /** One relationship in the sharing read's answer: who it is, and what its people reach of the record. */
971
+ export const RelationshipRecordSharingRelationshipSchema = RelationshipRecordReachSchema.extend({
972
+ relationshipId: z.string().describe('The relationship, by its id: the value `shareRecord` and `unshareRecord` name.'),
973
+ representingOrganizationName: z.string().optional().describe('The representing organization\'s name, when the relationship carries it.'),
974
+ });
975
+
976
+ /**
977
+ * Whose a record is and who it is shared with (#2736), as {@link OrganizationRelationships_Operations.READ_RECORD_SHARING}
978
+ * answers it. Both fields are engine-managed on every record that carries relationship provenance and are stripped from
979
+ * the record's own response.
980
+ */
981
+ export const RelationshipRecordSharingSchema = z.object({
982
+ resourceType: z.string().describe('The kind of record, as the application names its resource.'),
983
+ recordId: z.string().describe('The record\'s id in your organization.'),
984
+ viaRelationshipId: z.string().nullable()
985
+ .describe('The relationship the record was created through, or null when it is your organization\'s own.'),
986
+ sharedWithRelationshipIds: z.array(z.string())
987
+ .describe('The relationships you shared the record with. Their representatives read it whichever relationship created it.'),
988
+ commonToEveryRelationship: z.boolean()
989
+ .describe('Whether the application declares this kind of record common to every relationship (`relationshipCommonRecords`): every relationship already reads every record of it, so a share changes nothing.'),
990
+ relationships: z.array(RelationshipRecordSharingRelationshipSchema)
991
+ .describe('Every live relationship of your organization, and any other the record names (created through it, or shared with it): what its people reach of this record.'),
992
+ });
993
+
994
+ export type RelationshipRecordSharing = z.infer<typeof RelationshipRecordSharingSchema>;
995
+
996
+ /** The representing side's verbs, on its own mirror. */
997
+ export enum OrganizationRepresentations_Operations {
998
+ /** The representing organization's ORG_ADMIN proposes a relationship to a granting organization. */
999
+ PROPOSE = 'propose',
1000
+ /** The representing organization's ORG_ADMIN accepts a GRANTING organization's proposal. */
1001
+ ACCEPT = 'accept',
1002
+ /** The representing organization's ORG_ADMIN ends the relationship, or withdraws its own pending proposal. */
1003
+ WITHDRAW = 'withdraw',
1004
+ /**
1005
+ * INTERNAL — the APPLICATION withdraws a live relationship on the representing organization's behalf, with the reason
1006
+ * stated (#2573): what the representing organization would do, done when the application's own records say it must.
1007
+ * Wonder Ledger's first: once a firm's mandate ENDED and nothing still awaits its sign-off, the firm keeps no access to
1008
+ * the client (a processor's access ends with its services). The transition, its audit row in both trails and the
1009
+ * ending of the relationship's reach are the representing side's `withdraw`; only no person acted.
1010
+ */
1011
+ WITHDRAW_ON_BEHALF = 'withdrawOnBehalf',
1012
+ }
1013
+
1014
+ export enum RepresentativeAssignments_Operations {
1015
+ /** The representing organization's ORG_ADMIN designates one of its members to serve an ACTIVE engagement. */
1016
+ ASSIGN = 'assign',
1017
+ /** Ends an ACTIVE assignment, or withdraws one still awaiting the granting organization's approval (#1612). */
1018
+ UNASSIGN = 'unassign',
1019
+ /**
1020
+ * Apply the granting organization's answer to a per-representative approval (#1612) — INTERNAL only, reached through
1021
+ * the human-decision answer path after the answerer was authorized there. Approval re-checks everything admission
1022
+ * depends on, inside one transaction, before creating the membership.
1023
+ */
1024
+ SETTLE_GRANTOR_APPROVAL = 'settleGrantorApproval',
1025
+ }
1026
+ ```
1027
+
1028
+ ## An invitation to a granting organization that does not exist yet
1029
+
1030
+ Read this when a representing organization invites a granting organization's owner by email: the invitation's
1031
+ statuses, its stored fields (including the kind it proposes), when it can still be delivered, and the representing
1032
+ organization's two verbs on it.
1033
+
1034
+ ## Import Origins
1035
+
1036
+ - `@wildo-ai/saas-models`
1037
+
1038
+ ## Source Excerpts
1039
+
1040
+ ### Origin Package: `@wildo-ai/saas-models`
1041
+
1042
+ ```typescript
1043
+ /**
1044
+ * Where a representing organization's invitation stands. Only {@link RelationshipInvitationStatus.PENDING} can still be
1045
+ * delivered.
1046
+ */
1047
+ export enum RelationshipInvitationStatus {
1048
+ /**
1049
+ * No proposal exists yet, as far as the representing organization can tell. Lapses at `expiresAt`. An invitation the
1050
+ * invitee declined stays PENDING (its `declinedAt` is never served), so a refusal and a person who never answered
1051
+ * look the same to the representing organization.
1052
+ */
1053
+ PENDING = 'PENDING',
1054
+ /** The proposal was written into the invitee's organization (`grantingOrganizationId`, `organizationRelationshipId`). Terminal. */
1055
+ DELIVERED = 'DELIVERED',
1056
+ /** The representing organization withdrew it before delivery. Terminal. */
1057
+ REVOKED = 'REVOKED',
1058
+ }
1059
+
1060
+ /**
1061
+ * How long an invitation waits, in days. The member invitation's period (`ORGANIZATION_MEMBER_INVITATION` tokens live
1062
+ * 7 days): both wait for a person to sign up from an email, and one application should not ask the same person to act
1063
+ * within two different windows.
1064
+ */
1065
+ export const RELATIONSHIP_INVITATION_VALIDITY_DAYS = 7;
1066
+
1067
+ /**
1068
+ * The representing organization's verbs on its invitations. Kept with the vocabulary for the reason
1069
+ * `OrganizationRepresentations_Operations` is.
1070
+ */
1071
+ export enum RelationshipInvitations_Operations {
1072
+ /**
1073
+ * Representing organization ORG_ADMIN invites a granting organization's owner by email. Nothing is conferred, or
1074
+ * proposed, until delivery.
1075
+ */
1076
+ INVITE = 'invite',
1077
+ /** Representing organization ORG_ADMIN withdraws a PENDING invitation. */
1078
+ REVOKE = 'revoke',
1079
+ }
1080
+
1081
+ /**
1082
+ * The representing organization's invitation, stored in the REPRESENTING organization.
1083
+ *
1084
+ * Every field is server-authored except the terms `invite` asks for. There is no generic CREATE or UPDATE: the status
1085
+ * moves only through `revoke` and the system's delivery.
1086
+ */
1087
+ export const RelationshipInvitationSchema = z.object({
1088
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
1089
+
1090
+ /** The REPRESENTING organization — the scope anchor. */
1091
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
1092
+
1093
+ /**
1094
+ * The invitee's address, lower-cased. Delivery matches it against an organization owner's PROVEN address. Personal
1095
+ * data of someone who may never become a user, so it is removed on erasure; an invitation without it cannot be
1096
+ * delivered.
1097
+ */
1098
+ email: addImpersonalizeWith(
1099
+ z.email().max(320).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate()
1100
+ .dataCategories(PersonalDataCategory.CONTACT_DETAILS),
1101
+ RedactionType.REMOVE,
1102
+ ),
1103
+
1104
+ /** Why the representing organization wants the relationship. Becomes the relationship's `purpose` on delivery. */
1105
+ purpose: addImpersonalizeWith(
1106
+ z.string().min(1).max(1000).isSummaryField().excludeFromCreate().excludeFromUpdate()
1107
+ .dataCategories(PersonalDataCategory.USER_CONTENT),
1108
+ RedactionType.MASK,
1109
+ { maskValue: '[erased]' },
1110
+ ),
1111
+
1112
+ /**
1113
+ * The kind of relationship the invitation proposes (#2722), fixed when it is sent: one whose representing side admits
1114
+ * the inviting organization's type and which declares `invitations`. Delivery proposes under it, and delivers only into
1115
+ * an organization whose type is on that kind's granting side.
1116
+ */
1117
+ kind: z.string().min(1).systemEnum(ApplicationConfigVocabulary.ORGANIZATION_RELATIONSHIP_KIND).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
1118
+
1119
+ /** The role proposed for the representatives. Absent ⇒ the kind's `defaultRole`, resolved at delivery. */
1120
+ role: z.string().min(1).optional().isSummaryField().excludeFromCreate().excludeFromUpdate(),
1121
+
1122
+ /** The term the representing organization proposes. Dropped at delivery if it has already passed. */
1123
+ endsAt: z.date().nullish().excludeFromCreate().excludeFromUpdate(),
1124
+
1125
+ status: z.enum(RelationshipInvitationStatus)
1126
+ .systemEnum('RelationshipInvitationStatus')
1127
+ .default(RelationshipInvitationStatus.PENDING)
1128
+ .isDBIndexed()
1129
+ .isSummaryField()
1130
+ .excludeFromCreate()
1131
+ .excludeFromUpdate()
1132
+ .isAuditEvidence(),
1133
+
1134
+ /** When a PENDING invitation stops being deliverable. Read by delivery; nothing relabels the row. */
1135
+ expiresAt: z.date().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate(),
1136
+
1137
+ invitedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
1138
+
1139
+ /** Set at delivery: the organization the invitee created, and the relationship proposed into it. */
1140
+ deliveredAt: z.date().optional().isSummaryField().excludeFromCreate().excludeFromUpdate(),
1141
+ grantingOrganizationId: z.string().min(1).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
1142
+ organizationRelationshipId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
1143
+
1144
+ revokedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
1145
+ revokedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
1146
+ /*
1147
+ * The people above, NAMED (#1852): each stamp is a user id and deliberately not a foreign key (it records who acted,
1148
+ * nothing navigates through it), so its screen showed 24 hexadecimal characters. Resolved at read time
1149
+ * (`forwardedUserName`), never stored: the row's evidence holds the ids and nothing else. Both are administrators of the inviting organization, which reads the row. The invitee who declined is not
1150
+ * named: `declinedByUserId` is backend-only, and the inviting organization must not learn of it.
1151
+ */
1152
+ invitedByName: forwardedUserName({ localField: 'invitedByUserId' }),
1153
+ revokedByName: forwardedUserName({ localField: 'revokedByUserId' }),
1154
+
1155
+ /**
1156
+ * Set when the invitee, signed in with the proven address, declined the invitation (#2716). It is then never offered
1157
+ * or delivered again. Backend-only, and deliberately not audit evidence: these two fields are the invitee's decision,
1158
+ * and the representing organization, whose tenant the row lives in, must not learn of it. Both responses and the
1159
+ * representing organization's audit trail would show it, and so would an ordering: a caller's sort on a backend-only
1160
+ * field is dropped (`admitDisclosableSortKeys`).
1161
+ *
1162
+ * `disclosedToSubject` (#2958): the decision is the invitee's own, so THEIR access export carries it, through the
1163
+ * resource's `declinedByUserId` person column. No other path reads these two fields: the inviter's and the revoker's
1164
+ * columns are allow-lists that name neither, and the resource is on no person's export graph.
1165
+ */
1166
+ declinedAt: z.date().optional().isBackendOnly({ disclosedToSubject: true }).excludeFromCreate().excludeFromUpdate(),
1167
+ declinedByUserId: z.string().min(1).optional().isBackendOnly({ disclosedToSubject: true }).excludeFromCreate().excludeFromUpdate().isDecider(),
1168
+
1169
+ createdAt: z.date().optional(),
1170
+ updatedAt: z.date().optional(),
1171
+ });
1172
+ export type RelationshipInvitation = z.infer<typeof RelationshipInvitationSchema>;
1173
+
1174
+ /** The one spelling of an address an invitation is stored and matched under. */
1175
+ export function normalizeRelationshipInvitationEmail(email: string): string {
1176
+ return email.trim().toLowerCase();
1177
+ }
1178
+
1179
+ /**
1180
+ * Is this invitation still waiting, as the REPRESENTING organization sees it at `now`? PENDING and not past
1181
+ * `expiresAt`, whether or not the invitee declined it. What the representing organization's own rules read: a
1182
+ * representing organization may hold one outstanding invitation per address.
1183
+ */
1184
+ export function isRelationshipInvitationOutstanding(
1185
+ invitation: Pick<RelationshipInvitation, 'status' | 'expiresAt'> | null | undefined,
1186
+ now: Date,
1187
+ ): boolean {
1188
+ if (!invitation || invitation.status !== RelationshipInvitationStatus.PENDING) return false;
1189
+ const expiresAt = invitation.expiresAt instanceof Date ? invitation.expiresAt : new Date(invitation.expiresAt as unknown as string);
1190
+ return expiresAt.getTime() > now.getTime();
1191
+ }
1192
+
1193
+ /**
1194
+ * Can this invitation still be delivered or offered at `now`? Outstanding, still addressed (erasure removes the
1195
+ * address), and not declined by its invitee (#2716). Every delivery door and the invitee's own list read this one rule.
1196
+ */
1197
+ export function isRelationshipInvitationDeliverable(
1198
+ invitation: Pick<RelationshipInvitation, 'status' | 'expiresAt' | 'email' | 'declinedAt'> | null | undefined,
1199
+ now: Date,
1200
+ ): boolean {
1201
+ return isRelationshipInvitationOutstanding(invitation, now) && Boolean(invitation?.email) && !invitation?.declinedAt;
1202
+ }
1203
+
1204
+ /**
1205
+ * An organization the invitee owns that can receive one invitation: the representing organization's type may serve its
1206
+ * type with the role the representing organization asked for (#2716).
1207
+ */
1208
+ export const RelationshipInvitationReceivingOrganizationSchema = z.object({
1209
+ organizationId: z.string().min(1),
1210
+ organizationName: z.string().optional(),
1211
+ });
1212
+ export type RelationshipInvitationReceivingOrganization = z.infer<typeof RelationshipInvitationReceivingOrganizationSchema>;
1213
+
1214
+ /**
1215
+ * One representing organization's invitation as its INVITEE sees it, in the account's Invitations panel (#2716). Listed
1216
+ * only to the person whose PROVEN address it was sent to, and only while it can still be delivered.
1217
+ *
1218
+ * `receivingOrganizations` holds the organizations the person owns that this representing organization may serve. It
1219
+ * may be empty: the invitation is still shown, so it can be declined.
1220
+ */
1221
+ export const RelationshipInvitationForInviteeSchema = z.object({
1222
+ invitationId: z.string().min(1),
1223
+ representingOrganizationName: z.string().optional(),
1224
+ purpose: z.string().optional(),
1225
+ /** The role the representing organization proposes for its representatives, as a key of the application's role table. */
1226
+ role: z.string().optional(),
1227
+ endsAt: z.string().optional(),
1228
+ expiresAt: z.string(),
1229
+ createdAt: z.string().optional(),
1230
+ receivingOrganizations: z.array(RelationshipInvitationReceivingOrganizationSchema),
1231
+ });
1232
+ export type RelationshipInvitationForInvitee = z.infer<typeof RelationshipInvitationForInviteeSchema>;
1233
+
1234
+ /** The invitee receives one invitation into one organization they own. */
1235
+ export const RelationshipInvitationReceiveRequestSchema = z.object({
1236
+ invitationId: z.string().min(1).describe('Id of the invitation to receive, as listed in your invitations.'),
1237
+ organizationId: z.string().min(1)
1238
+ .describe('Id of the organization you own that receives the invitation: one of the invitation\'s `receivingOrganizations`.'),
1239
+ });
1240
+ export type RelationshipInvitationReceiveRequest = z.infer<typeof RelationshipInvitationReceiveRequestSchema>;
1241
+
1242
+ /**
1243
+ * What receiving produced: the relationship now waiting in the organization. `proposed` is false when the representing
1244
+ * organization already had a live relationship with that organization, which the invitation was then recorded against
1245
+ * instead of a second.
1246
+ */
1247
+ export const RelationshipInvitationReceiveResultSchema = z.object({
1248
+ organizationId: z.string().min(1),
1249
+ organizationRelationshipId: z.string().min(1),
1250
+ proposed: z.boolean(),
1251
+ });
1252
+ export type RelationshipInvitationReceiveResult = z.infer<typeof RelationshipInvitationReceiveResultSchema>;
1253
+
1254
+ /** The invitee declines one invitation. */
1255
+ export const RelationshipInvitationDeclineRequestSchema = z.object({
1256
+ invitationId: z.string().min(1).describe('Id of the invitation to decline. It is not offered to you again, and the inviting organization is not told.'),
1257
+ });
1258
+ export type RelationshipInvitationDeclineRequest = z.infer<typeof RelationshipInvitationDeclineRequestSchema>;
1259
+ ```