@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) 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 +3 -3
  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 +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  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.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,139 @@
1
+ # saas.models.providers.processing-region-selection
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ /**
13
+ * What an application's `processingRegion` choice does to the endpoint a provider's runtime calls (#3513). One answer per
14
+ * case, because each is a different statement a reader makes and a different thing the runtime does.
15
+ */
16
+ export enum ProviderProcessingRegionSelectionStatus {
17
+ /**
18
+ * The chosen region has its own endpoint, and every arm calls it (its base URL, or the host the application account's
19
+ * region answer resolves to): the region is ENFORCED.
20
+ */
21
+ ENDPOINT_SELECTED = 'endpoint-selected',
22
+ /** The chosen region is named by a request parameter, and every request of every AI-SDK arm sends it: ENFORCED. */
23
+ REQUEST_PARAMETER_SELECTED = 'request-parameter-selected',
24
+ /** The chosen region is where the operator's vendor account lives. Nothing is selected; the region is ATTESTED. */
25
+ ACCOUNT_ATTESTED = 'account-attested',
26
+ /** The provider states no reach for its regions (or no established profile): the region is neither selected nor attested. */
27
+ REACH_UNDECLARED = 'reach-undeclared',
28
+ /** No region is chosen (a self-hosted choice, or no choice): every arm calls its own declared base URL. */
29
+ NO_REGION_CHOSEN = 'no-region-chosen',
30
+ /**
31
+ * The chosen region is not one the provider lists, and the provider is reached by account residency only. Reported as an
32
+ * app-asserted region (the choice schema's warn-do-not-block posture), never refused: no endpoint would have reached it
33
+ * any differently.
34
+ */
35
+ REGION_NOT_LISTED = 'region-not-listed',
36
+ /**
37
+ * The chosen region is not one the provider can be reached in, and the provider ENFORCES its regions (by endpoint or by
38
+ * request parameter). REFUSED at configuration load: calling the default host, or sending no region, would state a
39
+ * region the product does not use, which is the defect this exists to remove.
40
+ */
41
+ REFUSED = 'refused',
42
+ }
43
+
44
+ /** The outcome of {@link resolveProviderProcessingRegionSelection}, keyed by its status. */
45
+ export type ProviderProcessingRegionSelection =
46
+ | {
47
+ readonly status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED;
48
+ readonly region: string;
49
+ /** Per arm, the base URL it calls in the region (empty when the region names only host answers). */
50
+ readonly baseUrls: Readonly<Record<string, string>>;
51
+ /** Per arm, the answers the application's own account gives in the region (empty when it names only base URLs). */
52
+ readonly applicationConnectionAnswers: Readonly<Record<string, Readonly<Record<string, string>>>>;
53
+ /** Per signing arm, the region its signature is scoped to (empty for a region no arm signs with). */
54
+ readonly requestSigningRegions: Readonly<Record<string, string>>;
55
+ }
56
+ | {
57
+ readonly status: ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED;
58
+ readonly region: string;
59
+ /** Per AI-SDK arm, the `providerOptions` every request it sends carries. */
60
+ readonly sdkProviderOptions: Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, string | number | boolean>>>>>>;
61
+ }
62
+ | { readonly status: ProviderProcessingRegionSelectionStatus.ACCOUNT_ATTESTED; readonly region: string }
63
+ | { readonly status: ProviderProcessingRegionSelectionStatus.REACH_UNDECLARED; readonly region: string }
64
+ | { readonly status: ProviderProcessingRegionSelectionStatus.NO_REGION_CHOSEN }
65
+ | { readonly status: ProviderProcessingRegionSelectionStatus.REGION_NOT_LISTED; readonly region: string }
66
+ | { readonly status: ProviderProcessingRegionSelectionStatus.REFUSED; readonly region: string; readonly message: string };
67
+
68
+ /**
69
+ * True when the profile ENFORCES at least one of its regions (by endpoint or by request parameter,
70
+ * {@link processingRegionReachIsEnforced}), so a region choice SELECTS what the runtime calls or sends, and a region it
71
+ * does not list is refused rather than reported.
72
+ */
73
+ export function providerEnforcesProcessingRegion(profile: ProviderComplianceProfile | null | undefined): boolean {
74
+ const reach = establishedProviderComplianceProfile(profile)?.processingRegionReach;
75
+ return reach !== undefined && Object.values(reach).some((entry) => processingRegionReachIsEnforced(entry.kind));
76
+ }
77
+
78
+ /**
79
+ * The ONE decision about what a chosen region does to a provider's endpoints (#3513), read by `wildo config sync` (which
80
+ * refuses a {@link ProviderProcessingRegionSelectionStatus.REFUSED} choice before writing a runtime artifact) and by the
81
+ * backend provider loader (which binds the module for an ENDPOINT_SELECTED or REQUEST_PARAMETER_SELECTED one, and refuses to
82
+ * start on a REFUSED one). Never re-derived beside it: the configuration check and the runtime must not disagree about which host a
83
+ * region means.
84
+ *
85
+ * assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a processing region an application declares for an
86
+ * endpoint-reached processor selects the endpoint the product calls, and a region it cannot be reached in is refused.
87
+ */
88
+ export function resolveProviderProcessingRegionSelection(params: {
89
+ readonly providerRef: string;
90
+ readonly profile: ProviderComplianceProfile | null | undefined;
91
+ readonly region: string | undefined;
92
+ }): ProviderProcessingRegionSelection {
93
+ const { providerRef, region } = params;
94
+ if (region === undefined) return { status: ProviderProcessingRegionSelectionStatus.NO_REGION_CHOSEN };
95
+ const established = establishedProviderComplianceProfile(params.profile);
96
+ const reach = established?.processingRegionReach;
97
+ if (established === null || reach === undefined) return { status: ProviderProcessingRegionSelectionStatus.REACH_UNDECLARED, region };
98
+ const entry = Object.hasOwn(reach, region) ? reach[region] : undefined;
99
+ if (entry === undefined) {
100
+ if (!providerEnforcesProcessingRegion(established)) return { status: ProviderProcessingRegionSelectionStatus.REGION_NOT_LISTED, region };
101
+ return {
102
+ status: ProviderProcessingRegionSelectionStatus.REFUSED,
103
+ region,
104
+ message: `providerComplianceChoices.${providerRef}.processingRegion is "${region}", which provider "${providerRef}" cannot be reached in. `
105
+ + `It selects its region on every call (the endpoint each call goes to, or a parameter each request carries), and serves: ${established.processingRegions.join(', ')}. `
106
+ + 'Choose one of those; calling its default endpoint instead would state a region the application does not use.',
107
+ };
108
+ }
109
+ switch (entry.kind) {
110
+ case ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY:
111
+ return { status: ProviderProcessingRegionSelectionStatus.ACCOUNT_ATTESTED, region };
112
+ case ProviderProcessingRegionReachKind.REQUEST_PARAMETER:
113
+ return { status: ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED, region, sdkProviderOptions: entry.sdkProviderOptions };
114
+ case ProviderProcessingRegionReachKind.ENDPOINT:
115
+ return {
116
+ status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED,
117
+ region,
118
+ baseUrls: entry.baseUrls ?? {},
119
+ applicationConnectionAnswers: entry.applicationConnectionAnswers ?? {},
120
+ requestSigningRegions: entry.requestSigningRegions ?? {},
121
+ };
122
+ }
123
+ }
124
+
125
+ /**
126
+ * True when a selection changes what the runtime calls or sends, so `wildo config sync` records the region in the provider
127
+ * runtime artifacts and the backend loader binds the module to it. Every other status leaves the module unchanged. A type
128
+ * guard, so a caller reads `selection.region` only on the arms that carry the region it binds.
129
+ */
130
+ export function processingRegionSelectionBindsRuntime(
131
+ selection: ProviderProcessingRegionSelection,
132
+ ): selection is Extract<
133
+ ProviderProcessingRegionSelection,
134
+ { status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED | ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED }
135
+ > {
136
+ return selection.status === ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED
137
+ || selection.status === ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED;
138
+ }
139
+ ```
@@ -44,8 +44,12 @@ export const RepresentativeActivityRowSchema = z.object({
44
44
  outcome: z.enum(AuditEventOutcome).systemEnum('AuditEventOutcome').describe('Whether the act succeeded, by the same rule the SIEM export states it with.'),
45
45
  createdAt: z.string().describe('When the row was written, as an ISO 8601 date-time.'),
46
46
  grantingOrganizationId: z.string().describe('The organization the act happened in, whose trail holds the row.'),
47
+ grantingOrganizationName: z.string().optional()
48
+ .describe('That organization\'s name, as this organization\'s record of the engagement holds it. Absent where that record holds none; show the id then.'),
47
49
  actingViaRelationshipId: z.string().describe('The relationship the act went through.'),
48
50
  userId: z.string().optional().describe('The person who acted, when a person did.'),
51
+ userName: z.string().optional()
52
+ .describe('That person\'s name, from their profile, when they are a member of this organization. Absent otherwise (a granting organization\'s person, an erased person, a person with no name); show the id then.'),
49
53
  actorKind: z.enum(AuditActorKind).systemEnum('AuditActorKind').optional(),
50
54
  agentRef: z.string().optional().describe('The agent that acted, when one did.'),
51
55
  resourceType: z.string().optional().describe('The resource the act reached, when the event names one.'),
@@ -81,26 +81,28 @@ export enum ResourceSystemAccessMode {
81
81
  /**
82
82
  * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
83
83
  *
84
- * ## Why the application declares it rather than the framework knowing it
84
+ * ## Who declares it, and why it is still a declaration
85
85
  *
86
- * The erasure lane is application-owned — four of the five marked sites for
87
- * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
88
- * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
89
- * status vocabulary are the application's, so a collector queries it against that application's
90
- * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
91
- * that is one application's modelling choice"*.
86
+ * Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
87
+ * has, carries this declaration, and the evidence door refuses an application where a second resource
88
+ * declares one. An application does not declare its own. (Before #2296 the lane was an application's to
89
+ * build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
90
+ * first declarer and was harvested into the engine.)
92
91
  *
93
- * So a collector may not know that a request is raised through a field called `channel` carrying a
94
- * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
95
- * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
96
- * to find it (#1209): not a missing control, a control nobody could point at.
92
+ * It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
93
+ * and the collector read the lane through it and never through the engine's vocabulary: they count the
94
+ * field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
95
+ * them to), so their reading follows the resource and cannot drift from it. Before this existed, three
96
+ * clauses of that demand had a durable row holding every fact they wanted and no way to find it
97
+ * (#1209): not a missing control, a control nobody could point at.
97
98
  *
98
99
  * ## It binds FIELDS, never values the framework invents
99
100
  *
100
- * Every member below names something the application already authored. The one value the
101
- * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
102
- * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
103
- * framework supplies no vocabulary here and must never grow one.
101
+ * Every member below names something the declaring resource already has. The one value the
102
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
103
+ * resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
104
+ * reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
105
+ * never grow one.
104
106
  *
105
107
  * ## What is deliberately NOT declared
106
108
  *
@@ -171,6 +173,21 @@ export type ResourceSubjectErasureLane = {
171
173
  },
172
174
  /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
173
175
  executionOperationIdentifier: string,
176
+ /**
177
+ * How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
178
+ * (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
179
+ * as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
180
+ *
181
+ * A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
182
+ * `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
183
+ * exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
184
+ */
185
+ erasureMarker?: {
186
+ /** The field carrying it. Must be a persisted field of this resource. */
187
+ fieldName: string,
188
+ /** The value of that field meaning the row is an erasure request. */
189
+ erasureValue: string,
190
+ },
174
191
  };
175
192
 
176
193
  export type ResourceSystemAccessPolicy = {
@@ -376,6 +393,15 @@ export interface ResourceRetentionPolicy {
376
393
  * reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
377
394
  * personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
378
395
  * be the primary key or a retention marker: the build refuses each of those.
396
+ *
397
+ * ## Closing a retained record (#1841)
398
+ *
399
+ * A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
400
+ * field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
401
+ * subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
402
+ * `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
403
+ * The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
404
+ * period counted from the end of a contract or a matter; without it the build refuses that combination.
379
405
  */
380
406
  retainedRowCompletion?: ResourceRetainedRowCompletion;
381
407
  }
@@ -402,6 +428,18 @@ export interface ResourceStatutoryRetention {
402
428
  * claim nobody can check.
403
429
  */
404
430
  rationale: string;
431
+ /**
432
+ * WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
433
+ *
434
+ * The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
435
+ * `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
436
+ * arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
437
+ * after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
438
+ * Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
439
+ * are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
440
+ * with it (#1841).
441
+ */
442
+ staysInUseBecause?: string;
405
443
  }
406
444
 
407
445
  /**
@@ -466,30 +504,15 @@ export type ResourceConfiguration_BuilderParameters<
466
504
  * If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
467
505
  * should stay the normal case.
468
506
  *
469
- * **Declaring a value that DISAGREES with the application default is refused at registration
470
- * unless {@link ResourceConfiguration_BuilderParameters.persistenceAdapterIsolation} is also
471
- * declared.** An application is wholly one adapter by default because two adapters cannot
472
- * share a native transaction; the isolation declaration is the only way past that refusal,
473
- * and it is a claim about this resource's write topology rather than a way to silence the
474
- * error. Declaring an adapter that AGREES with the default is always fine and needs nothing.
507
+ * **An application uses exactly ONE transactional store** (#3328, decided 2026-11-06), so a
508
+ * `mongodb` or `postgresql` value that DISAGREES with the application default is refused at
509
+ * registration, with no declaration that admits it. Declaring an adapter that AGREES with the
510
+ * default is always fine and needs nothing. The non-default values a resource may declare are
511
+ * the ones that hold no transaction: `http-api` (read through from another system) and
512
+ * `introspection` (computed from the application itself).
475
513
  */
476
514
  persistenceAdapter?: PersistenceAdapterType,
477
515
 
478
- /**
479
- * This resource's declared relationship to cross-adapter atomic write boundaries.
480
- *
481
- * Required — and only meaningful — when {@link
482
- * ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
483
- * `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
484
- * application at startup; with it, the registry admits the resource and LOGS the admitted
485
- * set, so a mixed configuration is always named and never ambient.
486
- *
487
- * Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
488
- * assertion about the resource's design that the persistence unit of work will still enforce
489
- * at every real boundary.
490
- */
491
- persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
492
-
493
516
  /**
494
517
  * REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
495
518
  *
@@ -565,9 +588,9 @@ export type ResourceConfiguration_BuilderParameters<
565
588
 
566
589
  /**
567
590
  * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
568
- * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
569
- * most resources are not, and an application that never built an erasure lane has declared none
570
- * rather than failed a control. See {@link ResourceSubjectErasureLane}.
591
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
592
+ * but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
593
+ * evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
571
594
  */
572
595
  subjectErasureLane?: ResourceSubjectErasureLane,
573
596
  coreOperations: TCoreOperationEnum[],
@@ -681,14 +704,22 @@ export type ResourceConfiguration_BuilderParameters<
681
704
  * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
682
705
  * deleted when its class period ends.
683
706
  *
684
- * Optional. An unbound resource is kept until it is erased, and is reported as unbound
685
- * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
686
- * may not also declare a `.ttl()` field — one row, one retention authority.
707
+ * Optional, with no default class: an unbound row has no clock. That is normal when something else ends the
708
+ * row, and `deriveResourceRowLifetimes` says what does for every resource. A resource that binds a class may not
709
+ * also declare a `.ttl()` field — one row, one retention authority.
687
710
  *
688
711
  * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
689
712
  */
690
713
  retentionBinding?: ResourceRetentionBinding,
691
714
 
715
+ /**
716
+ * What ends this resource's rows, for the case its configuration cannot show: a dedicated cleanup, the audit
717
+ * archive, the files cleanup, or operator configuration. Everything else is derived, so declare this only when
718
+ * `deriveResourceRowLifetimes` would otherwise answer `UNDECIDED` and a real mechanism exists. It may not sit beside
719
+ * a {@link retentionBinding}: one row, one retention authority.
720
+ */
721
+ rowLifetime?: ResourceRowLifetimeDeclaration,
722
+
692
723
  /**
693
724
  * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
694
725
  * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
@@ -705,6 +736,40 @@ export type ResourceConfiguration_BuilderParameters<
705
736
  */
706
737
  subjectExportOthersDataFields?: readonly string[],
707
738
 
739
+ /**
740
+ * The same withholding, for rows reached through ONE edge (#2958 follow-up): keyed by the foreign-key field of a
741
+ * relationship edge to this resource, the fields a subject export withholds and lists as other people's data when it
742
+ * reaches a row THROUGH THAT EDGE, for both rights, on top of {@link subjectExportOthersDataFields}.
743
+ *
744
+ * For a resource two people reach by two edges with different standing. A data-subject request is the SUBJECT's
745
+ * (`userId`, whole) and names the operator who recorded it (`requestedByUserId`): the operator's own act (that they
746
+ * recorded a request, of which kind, when) is personal data concerning them (Art. 15(1)), the subject's identity and
747
+ * the request's content are another person's (Art. 15(4)). A resource-wide declaration cannot say that, since it
748
+ * would withhold the subject's own request from the subject.
749
+ *
750
+ * Not read by the retained-row scrub (`resolveRetainedRowScrubSurface`), unlike the resource-wide list: these fields
751
+ * are the row's OWN subject's data, removed by that subject's erasure, not a third person's.
752
+ *
753
+ * Each key and each listed name must be a top-level field of the main schema; the factory refuses one that is not.
754
+ */
755
+ subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
756
+
757
+ /**
758
+ * #2958: columns of this resource that hold a USER's id on no edge of that user's export graph, and that their ACCESS
759
+ * export reads (Art. 15 only): who acted on the row (`ACTED`: proposed, granted, verified, ended, triaged, kept as
760
+ * accountability evidence and never severed) or who owns it (`OWNS`: a user-private file). Keyed by the column; each
761
+ * declares its relation and the fields of a row found through it that are about that person (`shownFields`, an
762
+ * allow-list: every other field is withheld and listed as other people's data). A person-naming column a SEVERER
763
+ * reaches is declared beside the severer instead (`SubjectReferenceSeverer.subjectReferenceColumns`).
764
+ *
765
+ * Not an edge, on purpose: `exportSubject` is per resource, so an `invitedByUserId` edge on `organizationMembers` would
766
+ * put every member the person invited, whole, into their export.
767
+ *
768
+ * Each key and each shown name must be a top-level field of the main schema (a variant's included); the factory refuses
769
+ * one that is not. The resource must declare `systemAccessPolicy.exportSubject`.
770
+ */
771
+ subjectExportPersonColumns?: SubjectExportPersonColumns,
772
+
708
773
  /**
709
774
  * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
710
775
  * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
@@ -144,5 +144,40 @@ export type ResourceConfiguration_Operation_ApiCall<
144
144
  * },
145
145
  */
146
146
  requestFieldOffers?: RequestFieldOffers; // default undefined
147
+ /**
148
+ * The row field each request field SETS, keyed by a top-level field of the request DTO, for a request field that is
149
+ * named apart from the row field it stands for (#3465).
150
+ *
151
+ * A move verb names its target apart from the parent key on purpose: a route under the SOURCE parent carries that key,
152
+ * and the request layer refuses a body that disagrees with a route parameter, so a "move to list" verb takes
153
+ * `targetListId` and its prefix writes `listId`. The name no longer says which row field the choice is ABOUT,
154
+ * and that is the one thing a surface showing the choice needs: the action bar's DROPDOWN marks the value the row
155
+ * holds now (and closes without writing when it is picked again) by reading `currentObject[rowField]`. Undeclared, a
156
+ * request field stands for the row field of its own name, which is right for every field named like the row
157
+ * (an `assign` verb over `assignedToUserId`) and needs no entry.
158
+ *
159
+ * A description, never the write: it does not set the row field. Whatever writes it (a `basicPrefixOperation`, an
160
+ * implementation) still does, under `authoritativeFields`. Each key must be a top-level request field and each value
161
+ * a top-level row field (of the base schema or an inheritance variant) that reaches the frontend, holding the same
162
+ * kind of value (a reference to the same resource, or an enum holding every value the request can carry); the factory
163
+ * refuses anything else, and a field mapped to its own name.
164
+ *
165
+ * Rejected: a parameter on the request field's foreign-key declaration. It would cover a REFERENCE choice and not an
166
+ * ENUM one named apart from its row field (`targetStatus` → `status`), and the correspondence is the operation's,
167
+ * beside the other per-request-field declarations (`requestFieldOffers`).
168
+ *
169
+ * Rejected: DERIVING it, from the referenced type or from `authoritativeFields`. A row may hold two references to one
170
+ * resource (an assignee and an escalation contact), so the type alone is ambiguous; a "copy into list" verb references
171
+ * the same type and sets nothing on the row, so marking the current list there would be false; and
172
+ * `authoritativeFields` is optional for a hook that writes a field from the request, so it is not complete enough to
173
+ * derive from. Only the operation knows which field its target becomes.
174
+ *
175
+ * @example
176
+ * requestDto: z.object({ targetListId: z.string().isForeignKey({ referencedResourceType: 'lists' }) }),
177
+ * basicPrefixOperation: ({ inputDto }) => ({ listId: inputDto.targetListId }),
178
+ * authoritativeFields: ['listId'],
179
+ * requestFieldRowFields: { targetListId: 'listId' },
180
+ */
181
+ requestFieldRowFields?: Readonly<Record<string, string>>; // default undefined
147
182
  }
148
183
  ```
@@ -37,7 +37,7 @@ export type ResourceOperation_AuditableEvent = {
37
37
  * or an unrestricted business-data field. Bound the text in the request DTO and tell callers
38
38
  * to supply an operational justification. Other request values are never copied by this option.
39
39
  * This does not change the risk floor: below-floor writes still need `auditBelowRiskFloor`.
40
- * OVERRIDE_ALL implementations own their persistence and must emit their committed audit event.
40
+ * An OVERRIDE_ALL implementation's operation is recorded the same way, once its handler returns (#3151).
41
41
  */
42
42
  reasonField?: string;
43
43
  };
@@ -55,7 +55,9 @@ export type ResourceOperation_AuditableEvent = {
55
55
  * - **A bulk write records submitted field NAMES without prior values.** The before-image is fetched
56
56
  * only when exactly one row is selected, so a bulk update cannot tell a reviewer what a field
57
57
  * used to hold.
58
- * - **There is no suppression, and the second row is not a duplicate.** An operation with its own
58
+ * - **There is no suppression, and the second row is not a duplicate.** (The one narrow exception: an
59
+ * `overrideAll` handler that writes the operation-performed row ITSELF declares `ownsOperationAuditRecord`,
60
+ * so the framework does not write a second copy of the same row, #3151.) An operation with its own
59
61
  * purpose-built event emits BOTH. The generic row carries the operation identity, the cascade
60
62
  * correlation, the actor's roles as they stood and the execution type — and no purpose-built
61
63
  * event carries any of those, so the two state different facts about one action.
@@ -0,0 +1,56 @@
1
+ # saas.models.resource-config.operation-condition-parameters
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ /**
13
+ * What an operation's `enabledCondition` (and a variant's other row functions) receives. Imported from
14
+ * `@wildo-ai/saas-models`; you write the function, the engine calls it.
15
+ *
16
+ * The engine calls `enabledCondition` in TWO places with these parameters, so one function decides both: in the frontend
17
+ * before it offers the action (a list judges each SUMMARY row, a record page the full row), and in the backend before the
18
+ * operation runs, where a `false` refuses the call with 403 `service_resource_operation_disabled` before any hook. So a
19
+ * condition must say EVERYTHING the operation's handler would refuse on the row's state or on who is asking, or the
20
+ * action is offered and then refused.
21
+ *
22
+ * - `currentObject` — the row as it stands. On a list row only its summary fields and the variant's
23
+ * `enabledConditionFields` are present.
24
+ * - `initiatorIds.userId` — the person asking (absent for a machine principal). Compare it with an owner field to offer an
25
+ * action only to the requester, or never to them (nobody approves their own request).
26
+ * - `inputDto` — the request body when the backend judges the call. When the frontend decides whether to offer the
27
+ * action there is no body yet, and it passes the ROW in its place, so never decide availability from `inputDto`.
28
+ *
29
+ * @example
30
+ * // Offered only to the person who raised the request, and only while it is a draft.
31
+ * enabledCondition: ({ currentObject, initiatorIds }) =>
32
+ * currentObject.status === RequestStatus.DRAFT && currentObject.createdByUserId === initiatorIds?.userId,
33
+ * enabledConditionFields: ['createdByUserId'],
34
+ */
35
+ export type ResourceConfiguration_OperationVariant_CustomImplementation_FunctionParameters<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {
36
+ inputDto: MainSchemaInfer<TMainSchema>,
37
+ currentObject: MainSchemaInfer<TMainSchema>,
38
+ /**
39
+ * The row as it stood BEFORE the write (the pre-image), when the framework captured one.
40
+ *
41
+ * Present only for a SINGLE-row UPDATE/DELETE (the framework fetches a pre-image only when
42
+ * exactly one id is selected); `undefined` for CREATE (nothing existed) and for bulk writes.
43
+ * It lets a consumer reason about what CHANGED rather than only the final state. Its wired
44
+ * consumers are the derived-badge recompute, which re-counts the scope a mutation moved a
45
+ * row OUT of (not just the one it moved it into) — see `dispatchDerivedBadgeRecomputes` — and a
46
+ * notification's `condition`, which receives it to tell a change from a write that left the row as
47
+ * it was (#2781). A `userIdsSelector` (e.g. notifying the PRIOR assignee a task was taken from them)
48
+ * would need the notification dispatcher to forward it into the selector call first; it is not
49
+ * plumbed there yet. Never assume it is populated; branch on its presence.
50
+ */
51
+ previousObject?: MainSchemaInfer<TMainSchema>,
52
+ objectContext: any,
53
+ initiatorUserContext?: any,
54
+ initiatorIds?: { userId?: string; organizationId?: string; applicationId?: string },
55
+ }
56
+ ```
@@ -13,9 +13,10 @@
13
13
  * Whether this variant takes the `Idempotency-Key` request header, so a caller's retry receives the first request's
14
14
  * outcome instead of running the effect again.
15
15
  *
16
- * Declare it on a mutation whose effect happens OUTSIDE your database — a payment provider, an email, a third-party
17
- * write — where a retry after a lost response is the duplicate you cannot roll back. A pure database write already
18
- * gets optimistic locking from `If-Match`; this is for what a transaction cannot undo.
16
+ * Declare it on a mutation a caller may retry after losing the answer — a CREATE above all, where a retry is a second
17
+ * row — and on every mutation whose effect happens OUTSIDE your database (a payment provider, an email, a third-party
18
+ * write), where the duplicate cannot be rolled back. `If-Match` protects an update from a stale read; it does nothing
19
+ * for a create sent twice.
19
20
  *
20
21
  * - `ACCEPTED`: the header is honored when sent, and a request without it runs unkeyed. Right for an effect that
21
22
  * converges when repeated (cancelling something twice leaves it cancelled).
@@ -38,9 +39,18 @@
38
39
  * nothing, so the key would protect no retry and `REQUIRED` would only refuse harmless repeats. A custom operation whose
39
40
  * effect must not run twice is not a read: borrow a mutation verb in `resourceOperationLike` and declare the key there.
40
41
  *
41
- * What it does NOT do: remember outcomes. Deciding that a key was seen, replaying its result and refusing the same key
42
- * sent with a different request (422, `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`) is the implementation's
43
- * job, because only it knows what "the same request" and "its result" mean for its effect.
42
+ * It also REMEMBERS the outcome (#747): the first response to a keyed request is kept for a day per (caller, resource,
43
+ * key), and a repeat of the same request is answered from it without running again. A repeat while the first is still
44
+ * running is refused 409 (`idempotency_key_in_progress`); the same key with a different request (another operation,
45
+ * target or payload) is refused 422 (`ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`). A first request refused
46
+ * before anything landed (validation, permission, a rule) leaves the key free, so the corrected retry runs; one whose
47
+ * outcome is unknown (an unclassified failure, a lost commit, a crash) is never run again under the key (409 `idempotency_key_outcome_unknown`:
48
+ * read before acting). A response carrying a one-time secret (`.isEphemeral()`) is never stored, so its repeat is refused
49
+ * 409 (`idempotency_key_outcome_not_replayable`) naming the row instead. `IdempotentRequestRefusalCode` lists the codes.
50
+ *
51
+ * Your implementation still receives the key, because an effect outside your database needs its own bracket: pass the
52
+ * key (or a key derived from it) to the provider, so the provider deduplicates the call itself. A read-through
53
+ * resource's writes are remembered by its system-of-record admission ledger instead, which never stores the row.
44
54
  *
45
55
  * @example a provider-backed mutation that must not run twice
46
56
  * variants: [{
@@ -210,6 +210,24 @@
210
210
  */
211
211
  admitsSelfConfinedScopeRootWrite?: boolean;
212
212
 
213
+ /**
214
+ * Declares a routed operation that borrows a write verb and writes NOTHING, so a member of ANY tenant may ask it on a
215
+ * route naming no organization (#3293).
216
+ *
217
+ * A routed write takes no organization entry from a request that names no organization: there is no tenant to ask, and
218
+ * pooling the caller's entries across tenants let an administrator of one tenant delete the application every tenant
219
+ * runs on. A look is not gated this way. This is for the rare operation shaped like a write for its verb and body,
220
+ * which only answers a question: `promotions.apply` reports what a code is worth.
221
+ *
222
+ * Declare it only on an `overrideAll` implementation, which returns before the core write. On any other mode the
223
+ * request's persisted fields reach the core write and the declaration is false, so an application's startup refuses
224
+ * it there, and where it changes nothing: a look, a variant no route addresses, a route naming an organization, or an
225
+ * operation declaring no organization role.
226
+ *
227
+ * assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE — a write to a row no organization owns is never answered by a role held in some tenant.
228
+ */
229
+ admitsOrganizationRolesOfAnyTenant?: boolean;
230
+
213
231
  /**
214
232
  * Declares a scope-root collection READ that is deliberately NOT confined to the caller's own
215
233
  * tenants: an application-wide DIRECTORY, such as every organization of the application. Fourth
@@ -233,6 +251,10 @@
233
251
  * answers 403. The DEFAULT variant of the same operation stays confined, so every ordinary caller
234
252
  * keeps the old answer.
235
253
  *
254
+ * The variant is addressed only at the scope root (`/organizations/directory`). No parent-scoped
255
+ * route is generated for it, because a parent segment would confine a read that is unconfined by
256
+ * declaration.
257
+ *
236
258
  * ## Why a declaration, not `admitsCrossTenantPlatformAdministration`
237
259
  *
238
260
  * The cross-tenant flag admits a crossing into ONE named tenant under that tenant's own grant
@@ -252,4 +274,20 @@
252
274
  * recorded.
253
275
  */
254
276
  admitsUnconfinedScopeRootDirectoryRead?: boolean;
277
+ /**
278
+ * This variant is addressed at its scope root only: no route nested under a parent is generated for it (#3249).
279
+ *
280
+ * Declare it on a read whose rows are decided at the scope root rather than by a parent, so that a parent segment
281
+ * could only ever refuse. The organizations `mine` search is the case: its rows are the organizations the CALLER holds
282
+ * an organization-wide role in, and `/users/{userId}/organizations/search/mine` is refused to a person for their own
283
+ * id (the junction gate). Without the declaration that route was generated anyway, and the frontend's
284
+ * most-specific-first route selection chose it whenever the signed-in user was in context, so the organization
285
+ * switcher's search failed for everyone.
286
+ *
287
+ * A declared directory read (`admitsUnconfinedScopeRootDirectoryRead`) is already addressed this way; the two share
288
+ * one rule in the URL builders, so the backend router, the frontend, the generated clients and the API reference see
289
+ * one address. The factory refuses the declaration on a resource that is not its own scope root, where the variant
290
+ * would be left with no route.
291
+ */
292
+ addressedAtScopeRootOnly?: boolean;
255
293
  ```