@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
@@ -221,7 +221,7 @@ export const ModelCostAccountingConfigSchema = z.object({
221
221
  try {
222
222
  assertUniqueProviderUsagePricingAuthorities(config.providerUsagePricingAuthorities);
223
223
  } catch (error) {
224
- context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: error instanceof Error ? error.message : String(error) });
224
+ context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: describeCaughtError(error) });
225
225
  }
226
226
  });
227
227
  export type ModelCostAccountingConfig = z.infer<typeof ModelCostAccountingConfigSchema>;
@@ -133,26 +133,28 @@ export enum ResourceSystemAccessMode {
133
133
  /**
134
134
  * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
135
135
  *
136
- * ## Why the application declares it rather than the framework knowing it
136
+ * ## Who declares it, and why it is still a declaration
137
137
  *
138
- * The erasure lane is application-owned — four of the five marked sites for
139
- * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
140
- * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
141
- * status vocabulary are the application's, so a collector queries it against that application's
142
- * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
143
- * that is one application's modelling choice"*.
138
+ * Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
139
+ * has, carries this declaration, and the evidence door refuses an application where a second resource
140
+ * declares one. An application does not declare its own. (Before #2296 the lane was an application's to
141
+ * build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
142
+ * first declarer and was harvested into the engine.)
144
143
  *
145
- * So a collector may not know that a request is raised through a field called `channel` carrying a
146
- * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
147
- * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
148
- * to find it (#1209): not a missing control, a control nobody could point at.
144
+ * It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
145
+ * and the collector read the lane through it and never through the engine's vocabulary: they count the
146
+ * field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
147
+ * them to), so their reading follows the resource and cannot drift from it. Before this existed, three
148
+ * clauses of that demand had a durable row holding every fact they wanted and no way to find it
149
+ * (#1209): not a missing control, a control nobody could point at.
149
150
  *
150
151
  * ## It binds FIELDS, never values the framework invents
151
152
  *
152
- * Every member below names something the application already authored. The one value the
153
- * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
154
- * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
155
- * framework supplies no vocabulary here and must never grow one.
153
+ * Every member below names something the declaring resource already has. The one value the
154
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
155
+ * resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
156
+ * reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
157
+ * never grow one.
156
158
  *
157
159
  * ## What is deliberately NOT declared
158
160
  *
@@ -223,6 +225,21 @@ export type ResourceSubjectErasureLane = {
223
225
  },
224
226
  /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
225
227
  executionOperationIdentifier: string,
228
+ /**
229
+ * How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
230
+ * (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
231
+ * as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
232
+ *
233
+ * A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
234
+ * `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
235
+ * exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
236
+ */
237
+ erasureMarker?: {
238
+ /** The field carrying it. Must be a persisted field of this resource. */
239
+ fieldName: string,
240
+ /** The value of that field meaning the row is an erasure request. */
241
+ erasureValue: string,
242
+ },
226
243
  };
227
244
 
228
245
  export type ResourceSystemAccessPolicy = {
@@ -428,6 +445,15 @@ export interface ResourceRetentionPolicy {
428
445
  * reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
429
446
  * personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
430
447
  * be the primary key or a retention marker: the build refuses each of those.
448
+ *
449
+ * ## Closing a retained record (#1841)
450
+ *
451
+ * A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
452
+ * field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
453
+ * subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
454
+ * `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
455
+ * The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
456
+ * period counted from the end of a contract or a matter; without it the build refuses that combination.
431
457
  */
432
458
  retainedRowCompletion?: ResourceRetainedRowCompletion;
433
459
  }
@@ -454,6 +480,18 @@ export interface ResourceStatutoryRetention {
454
480
  * claim nobody can check.
455
481
  */
456
482
  rationale: string;
483
+ /**
484
+ * WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
485
+ *
486
+ * The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
487
+ * `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
488
+ * arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
489
+ * after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
490
+ * Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
491
+ * are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
492
+ * with it (#1841).
493
+ */
494
+ staysInUseBecause?: string;
457
495
  }
458
496
 
459
497
  /**
@@ -518,30 +556,15 @@ export type ResourceConfiguration_BuilderParameters<
518
556
  * If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
519
557
  * should stay the normal case.
520
558
  *
521
- * **Declaring a value that DISAGREES with the application default is refused at registration
522
- * unless {@link ResourceConfiguration_BuilderParameters.persistenceAdapterIsolation} is also
523
- * declared.** An application is wholly one adapter by default because two adapters cannot
524
- * share a native transaction; the isolation declaration is the only way past that refusal,
525
- * and it is a claim about this resource's write topology rather than a way to silence the
526
- * error. Declaring an adapter that AGREES with the default is always fine and needs nothing.
559
+ * **An application uses exactly ONE transactional store** (#3328, decided 2026-11-06), so a
560
+ * `mongodb` or `postgresql` value that DISAGREES with the application default is refused at
561
+ * registration, with no declaration that admits it. Declaring an adapter that AGREES with the
562
+ * default is always fine and needs nothing. The non-default values a resource may declare are
563
+ * the ones that hold no transaction: `http-api` (read through from another system) and
564
+ * `introspection` (computed from the application itself).
527
565
  */
528
566
  persistenceAdapter?: PersistenceAdapterType,
529
567
 
530
- /**
531
- * This resource's declared relationship to cross-adapter atomic write boundaries.
532
- *
533
- * Required — and only meaningful — when {@link
534
- * ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
535
- * `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
536
- * application at startup; with it, the registry admits the resource and LOGS the admitted
537
- * set, so a mixed configuration is always named and never ambient.
538
- *
539
- * Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
540
- * assertion about the resource's design that the persistence unit of work will still enforce
541
- * at every real boundary.
542
- */
543
- persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
544
-
545
568
  /**
546
569
  * REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
547
570
  *
@@ -617,9 +640,9 @@ export type ResourceConfiguration_BuilderParameters<
617
640
 
618
641
  /**
619
642
  * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
620
- * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
621
- * most resources are not, and an application that never built an erasure lane has declared none
622
- * rather than failed a control. See {@link ResourceSubjectErasureLane}.
643
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
644
+ * but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
645
+ * evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
623
646
  */
624
647
  subjectErasureLane?: ResourceSubjectErasureLane,
625
648
  coreOperations: TCoreOperationEnum[],
@@ -733,14 +756,22 @@ export type ResourceConfiguration_BuilderParameters<
733
756
  * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
734
757
  * deleted when its class period ends.
735
758
  *
736
- * Optional. An unbound resource is kept until it is erased, and is reported as unbound
737
- * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
738
- * may not also declare a `.ttl()` field — one row, one retention authority.
759
+ * Optional, with no default class: an unbound row has no clock. That is normal when something else ends the
760
+ * row, and `deriveResourceRowLifetimes` says what does for every resource. A resource that binds a class may not
761
+ * also declare a `.ttl()` field — one row, one retention authority.
739
762
  *
740
763
  * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
741
764
  */
742
765
  retentionBinding?: ResourceRetentionBinding,
743
766
 
767
+ /**
768
+ * What ends this resource's rows, for the case its configuration cannot show: a dedicated cleanup, the audit
769
+ * archive, the files cleanup, or operator configuration. Everything else is derived, so declare this only when
770
+ * `deriveResourceRowLifetimes` would otherwise answer `UNDECIDED` and a real mechanism exists. It may not sit beside
771
+ * a {@link retentionBinding}: one row, one retention authority.
772
+ */
773
+ rowLifetime?: ResourceRowLifetimeDeclaration,
774
+
744
775
  /**
745
776
  * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
746
777
  * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
@@ -757,6 +788,40 @@ export type ResourceConfiguration_BuilderParameters<
757
788
  */
758
789
  subjectExportOthersDataFields?: readonly string[],
759
790
 
791
+ /**
792
+ * The same withholding, for rows reached through ONE edge (#2958 follow-up): keyed by the foreign-key field of a
793
+ * relationship edge to this resource, the fields a subject export withholds and lists as other people's data when it
794
+ * reaches a row THROUGH THAT EDGE, for both rights, on top of {@link subjectExportOthersDataFields}.
795
+ *
796
+ * For a resource two people reach by two edges with different standing. A data-subject request is the SUBJECT's
797
+ * (`userId`, whole) and names the operator who recorded it (`requestedByUserId`): the operator's own act (that they
798
+ * recorded a request, of which kind, when) is personal data concerning them (Art. 15(1)), the subject's identity and
799
+ * the request's content are another person's (Art. 15(4)). A resource-wide declaration cannot say that, since it
800
+ * would withhold the subject's own request from the subject.
801
+ *
802
+ * Not read by the retained-row scrub (`resolveRetainedRowScrubSurface`), unlike the resource-wide list: these fields
803
+ * are the row's OWN subject's data, removed by that subject's erasure, not a third person's.
804
+ *
805
+ * Each key and each listed name must be a top-level field of the main schema; the factory refuses one that is not.
806
+ */
807
+ subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
808
+
809
+ /**
810
+ * #2958: columns of this resource that hold a USER's id on no edge of that user's export graph, and that their ACCESS
811
+ * export reads (Art. 15 only): who acted on the row (`ACTED`: proposed, granted, verified, ended, triaged, kept as
812
+ * accountability evidence and never severed) or who owns it (`OWNS`: a user-private file). Keyed by the column; each
813
+ * declares its relation and the fields of a row found through it that are about that person (`shownFields`, an
814
+ * allow-list: every other field is withheld and listed as other people's data). A person-naming column a SEVERER
815
+ * reaches is declared beside the severer instead (`SubjectReferenceSeverer.subjectReferenceColumns`).
816
+ *
817
+ * Not an edge, on purpose: `exportSubject` is per resource, so an `invitedByUserId` edge on `organizationMembers` would
818
+ * put every member the person invited, whole, into their export.
819
+ *
820
+ * Each key and each shown name must be a top-level field of the main schema (a variant's included); the factory refuses
821
+ * one that is not. The resource must declare `systemAccessPolicy.exportSubject`.
822
+ */
823
+ subjectExportPersonColumns?: SubjectExportPersonColumns,
824
+
760
825
  /**
761
826
  * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
762
827
  * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
@@ -252,6 +252,7 @@ export const specificationsCompanionExports: SpecificationsCompanionExports<
252
252
  * reports a vendor-hosted provider a runtime selects that is not named here.
253
253
  */
254
254
  processorRegister: applicationProcessorRegister,
255
+ translationGlossary,
255
256
  };
256
257
  ```
257
258
 
@@ -136,6 +136,8 @@ export interface SpecificationsCompanionExports<
136
136
  TBrandNameScreening = BrandNameScreening,
137
137
  // Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
138
138
  TServiceMethod = ServiceMethod,
139
+ // Appended STRICTLY LAST: the regimes research established for the product (#3362).
140
+ TCompliancePosture = CompliancePosture,
139
141
  > {
140
142
  resourceSpecifications: TResourceSpecifications;
141
143
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -640,8 +642,10 @@ export interface SpecificationsCompanionExports<
640
642
  */
641
643
  documentationPlan?: TApplicationDocumentationPlan;
642
644
  /**
643
- * THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
644
- * from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
645
+ * THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
646
+ * by being committed. Optional: a chapter is normally written in its own file,
647
+ * `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
648
+ * publication reads those files beside this set and merges them, refusing a chapter declared in both.
645
649
  *
646
650
  * Read by the documentation publication, which joins each body to its planned chapter and publishes
647
651
  * it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
@@ -652,6 +656,15 @@ export interface SpecificationsCompanionExports<
652
656
  * positional parameter would only add a slot for every consumer to skip.
653
657
  */
654
658
  documentationChapters?: ApplicationDocumentationChapterSet;
659
+ /**
660
+ * THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
661
+ * honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
662
+ * `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
663
+ * ignored. Optional: absent means every word is the model's.
664
+ *
665
+ * Typed directly, like `documentationChapters`: no application narrows it.
666
+ */
667
+ translationGlossary?: ApplicationTranslationGlossaryDeclaration;
655
668
  /**
656
669
  * WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
657
670
  * minion's tick may touch, and the providers this application binds (#1495). Read by
@@ -681,6 +694,12 @@ export interface SpecificationsCompanionExports<
681
694
  * playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
682
695
  */
683
696
  serviceMethod?: TServiceMethod;
697
+ /**
698
+ * WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
699
+ * compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
700
+ * creator's own compliance constraints; this carries the researched ones.
701
+ */
702
+ compliancePosture?: TCompliancePosture;
684
703
  /**
685
704
  * Accepted application-declared semantic causality between whole
686
705
  * specification-family states. This is not the registry's physical
@@ -302,6 +302,15 @@ export interface BackendDomainModule extends SharedDomainModule {
302
302
  * the people who already may approve. Startup refuses a name a variant uses and no module registers.
303
303
  */
304
304
  operationApprovalResolvers?: OperationApprovalResolvers;
305
+ /**
306
+ * How each of the application's OWN external effects is undone (#3446), keyed by its compensation kind. A custom
307
+ * implementation that creates an object at a vendor before its operation's write reserves it first with
308
+ * `reserveExternalEffect(utils, { applicationCompensationKind, … })`; when no row names the object once the operation
309
+ * ended, the engine's settlement calls the compensator declared here. Key it by an enum the application owns
310
+ * (`satisfies Record<MyKind, ApplicationExternalEffectCompensator>`). One module declares a kind: two modules declaring
311
+ * the same kind are refused, naming both. A reservation naming a kind no module declares is refused before the vendor call.
312
+ */
313
+ externalEffectCompensators?: ApplicationExternalEffectCompensators;
305
314
  }
306
315
 
307
316
  /**
@@ -316,7 +325,7 @@ export interface BackendDomainModule extends SharedDomainModule {
316
325
  * |---|---|
317
326
  * | `resourceConfigurations` | **last module wins, silently** |
318
327
  * | `resourceFieldIdentifiers` | **last module wins, silently** |
319
- * | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` | rejected, naming both modules |
328
+ * | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` · `externalEffectCompensators` | rejected, naming both modules |
320
329
  * | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
321
330
  * | `inboundHandlers` | concatenated; a duplicate `ref` is rejected, naming both modules |
322
331
  * | `humanDecisionNoticeHandler` | at most one across every module; a second is rejected, naming both modules |
@@ -356,9 +365,29 @@ export function mergeBackendDomainModules(
356
365
  ...mergeHumanDecisionNoticeHandler(modules),
357
366
  chatReplyHandlers: modules.flatMap(m => m.chatReplyHandlers ?? []),
358
367
  operationApprovalResolvers: mergeOperationApprovalResolvers(modules),
368
+ externalEffectCompensators: mergeExternalEffectCompensators(modules),
359
369
  };
360
370
  }
361
371
 
372
+ /** Every module's external effect compensators in one record, refusing a kind two modules declare (naming both). */
373
+ function mergeExternalEffectCompensators(modules: BackendDomainModule[]): ApplicationExternalEffectCompensators | undefined {
374
+ const merged: Record<string, ApplicationExternalEffectCompensators[string]> = {};
375
+ const sourceIndexByKind = new Map<string, number>();
376
+ for (let moduleIndex = 0; moduleIndex < modules.length; moduleIndex++) {
377
+ for (const [kind, compensator] of Object.entries(modules[moduleIndex]!.externalEffectCompensators ?? {})) {
378
+ const firstSource = sourceIndexByKind.get(kind);
379
+ if (firstSource !== undefined) {
380
+ throw new Error(
381
+ `mergeBackendDomainModules: duplicate externalEffectCompensators kind '${kind}' — declared by module index ${firstSource} AND module index ${moduleIndex}. A kind is undone one way; pick a unique one.`,
382
+ );
383
+ }
384
+ sourceIndexByKind.set(kind, moduleIndex);
385
+ merged[kind] = compensator;
386
+ }
387
+ }
388
+ return Object.keys(merged).length > 0 ? merged : undefined;
389
+ }
390
+
362
391
  /** Every module's operation-approval resolvers in one record, refusing a name two modules register (naming both). */
363
392
  function mergeOperationApprovalResolvers(modules: BackendDomainModule[]): OperationApprovalResolvers | undefined {
364
393
  const merged: Record<string, OperationApprovalResolvers[string]> = {};
@@ -269,108 +269,106 @@ or share records with it, declare a relationship kind
269
269
  sees and per-record sharing come with it. A junction only confines
270
270
  which id a row may name.
271
271
 
272
- ## A second FK back to the type that owns your scope (`allowCycle`)
273
-
274
- Startup refuses the registry with:
275
-
276
- ```
277
- Cycle detected: users → accountErasureRequests → users.
278
- Edges missing allowCycle: [users → accountErasureRequests, accountErasureRequests → users].
279
- Set allowCycle: true on all edges in the cycle to allow it.
280
- ```
281
-
282
- **Read the detector correctly before changing anything.** It walks
283
- RESOURCE TYPES, not rows and not columns. Two edges between the same
284
- PAIR of types close a cycle in its graph even when the columns are
285
- disjoint and no row could ever reach itself. That is deliberate: the
286
- traversals it protects — context expansion, the descendant map, cascade
287
- teardown, nested DTOs — all follow edges by TYPE, so a type-level loop
288
- is exactly the shape that can make one recurse.
289
-
290
- **When this is a modelling mistake — fix the model, not the flag:**
291
-
292
- - The two edges mean the same thing and were written twice. Delete one.
293
- - You declared a lateral reference child-first when it belongs in the
294
- parent direction (previous section). Turn it around.
295
- - You are modelling a peer M:N directly. Use an explicit junction
296
- resource instead — the framework fail-closes peer expansion.
297
-
298
- **When it is genuine — and no direction avoids it:** a resource whose
299
- SCOPE is a type it also references. The canonical shape is an actor
300
- column: an erasure request lives under `/users/:userId/…` (the subject)
301
- and separately records the operator who filed it. Scope and actor are
302
- different facts about different people, and collapsing them destroys the
303
- accountability the actor column exists for. Both edges are required —
304
- an FK field with no relationship naming it is unresolvable, and the
305
- frontend registry throws `frontend_fk_resolution_failed` rather than
306
- render a reference it cannot type.
272
+ ## A second FK to the type that owns your scope
273
+
274
+ The canonical shape is an actor column: an erasure request lives under
275
+ `/users/:userId/…` (the subject) and separately records the operator who
276
+ filed it (`requestedByUserId`). Scope and actor are different facts about
277
+ different people, and collapsing them destroys the accountability the
278
+ actor column exists for. Both edges are required — an FK field with no
279
+ relationship naming it is unresolvable, and the frontend registry throws
280
+ `frontend_fk_resolution_failed` rather than render a reference it cannot
281
+ type.
282
+
283
+ **Declare BOTH edges in the PARENT direction** — the referenced type
284
+ first, your resource second, twice. The foreign-key holder is resolved
285
+ from CARDINALITY, so your resource holds both columns either way, and the
286
+ two edges are told apart by their `foreignKeyField`. Two parallel edges
287
+ between one pair of types are **not** a cycle: the startup detector walks
288
+ each edge from its first type to its second, so only an edge pointing BACK
289
+ closes one. No `allowCycle` is needed.
307
290
 
308
291
 
309
292
  ## Usage Example
310
293
 
311
294
  ```typescript
312
- // The SUBJECT edge: scope, routing and lifecycle. `allowCycle` because of the operator edge below.
313
- createResourcesRelationship(
314
- CoreResourceType.USERS, TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS,
315
- ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
316
- {
317
- nature: RelationshipNature.COMPOSITION,
318
- isPrimaryScope: true,
319
- foreignKeyField: 'userId',
320
- allowCycle: true,
321
- parentResourceRequirement: ResourceParentResourceRequirement.MANDATORY,
322
- accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT,
323
- childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
324
- contextPolicy: {},
325
- }
326
- ),
295
+ // The SUBJECT edge: scope, routing and lifecycle.
296
+ createResourcesRelationship(
297
+ CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
298
+ ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
299
+ {
300
+ nature: RelationshipNature.COMPOSITION,
301
+ isPrimaryScope: true,
302
+ foreignKeyField: 'userId',
303
+ parentResourceRequirement: ResourceParentResourceRequirement.MANDATORY,
304
+ accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT,
305
+ childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
306
+ contextPolicy: {},
307
+ }
308
+ ),
327
309
  ```
328
310
 
329
311
  ## Usage Example
330
312
 
331
313
  ```typescript
332
- // The OPERATOR edge: a second FK to the resource type that already owns this resource's scope.
333
- // Evidence only — never a scope path, never a nested route. Both edges carry `allowCycle`.
334
- createResourcesRelationship(
335
- TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS, CoreResourceType.USERS,
336
- ResourceRelationshipCardinality.MANY, ResourceRelationshipCardinality.ONE,
337
- {
338
- nature: RelationshipNature.REFERENCE,
339
- foreignKeyField: 'requestedByUserId',
340
- allowCycle: true,
341
- parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
342
- accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.STANDALONE,
343
- contextPolicy: {
344
- objectMode: ContextPolicy_ObjectMode.SUMMARY,
345
- operationOverrides: {
346
- [CoreResourceOperation.LIST]: { enabled: false },
347
- [CoreResourceOperation.SEARCH]: { enabled: false },
348
- },
349
- },
350
- }
351
- ),
314
+ // The OPERATOR edge: a second FK to the resource type that already owns this resource's scope, declared in the
315
+ // same PARENT direction. Evidence only — never a scope path, never a nested route, never a teardown.
316
+ createResourcesRelationship(
317
+ CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
318
+ ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
319
+ {
320
+ nature: RelationshipNature.REFERENCE,
321
+ foreignKeyField: 'requestedByUserId',
322
+ parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
323
+ accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.STANDALONE,
324
+ // Erasing the operator leaves the request exactly as it is: it is the controller's evidence of who acted.
325
+ childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
326
+ contextPolicy: {
327
+ objectMode: ContextPolicy_ObjectMode.SUMMARY,
328
+ operationOverrides: {
329
+ [CoreResourceOperation.LIST]: { enabled: false },
330
+ [CoreResourceOperation.SEARCH]: { enabled: false },
331
+ },
332
+ },
333
+ }
334
+ ),
352
335
  ```
353
336
 
354
337
  Rules that make the second edge safe:
355
338
 
356
339
  | Rule | Why |
357
340
  |---|---|
358
- | `allowCycle: true` on **every** edge in the cycle | The check is all-or-nothing. One edge left out and startup still refuses — naming the edges that lack it. |
341
+ | Parent direction, like the scope edge | A child-first actor edge makes the referenced type a CHILD of your resource in every relationship bucket (`users` gains a parent), and closes a cycle that fails startup (below). |
359
342
  | The actor edge is `REFERENCE`, never `COMPOSITION` | `COMPOSITION` is what makes a parent's teardown reach the child. Evidence about who acted must outlive the actor. |
343
+ | `childOperations.lifecycle.onParentDelete: { enabled: false }` | States that survival explicitly: erasing the operator leaves the row as it is. |
360
344
  | `accessScopeStrategy: STANDALONE` | Scope belongs to the composition. A second scope-bearing edge to the same parent type makes the resource's primary scope ambiguous. |
361
345
  | `parentResourceRequirement: OPTIONAL` if the column is `.optional()` | A self-service row has no operator; `MANDATORY` would reject every such row. |
362
346
  | `LIST`/`SEARCH` context disabled | An actor is a summary field on one row, not a collection-level join. |
363
347
 
364
- **What `allowCycle` does and does not do.** It is a registration-time
365
- escape hatch and nothing more — no traversal reads it. It does not make
366
- the cascade follow the new edge (teardown runs parent → child, so only
367
- the composition), it does not create a nested route (`STANDALONE`
348
+ ### The cycle error means an edge points the wrong way
349
+
350
+ Declare the actor edge child-first and startup refuses the registry with:
351
+
352
+ ```
353
+ Cycle detected: users → dataSubjectRequests → users.
354
+ Edges missing allowCycle: [users → dataSubjectRequests, dataSubjectRequests → users].
355
+ Set allowCycle: true on all edges in the cycle to allow it.
356
+ ```
357
+
358
+ The fix is to turn the child-first edge around, not to set the flag.
359
+ Setting `allowCycle` on both edges silences the error and keeps the wrong
360
+ model: the referenced type still has your resource as its parent.
361
+
362
+ **When `allowCycle` is genuine:** a type that is really its own parent —
363
+ a self-referential tree (`parentUnitId` on organization units), where
364
+ the edge points from the type to itself — or a true loop in which each
365
+ type owns rows of the other. It is a registration-time escape hatch and
366
+ nothing more — no traversal reads it. It does not make the cascade
367
+ follow the edge, it does not create a nested route (`accessScopeStrategy`
368
368
  decides that), and it does not disable any recursion guard: context
369
369
  expansion is bounded by a per-row visited set and a depth cap, and the
370
- descendant map by its own visited set. What the edge itself changes is
371
- that your resource's descendant set now includes the referenced type and
372
- everything under it — worth a look if you rely on descendant-scoped
373
- navigation.
370
+ descendant map by its own visited set. Every edge of the loop needs the
371
+ flag; the error names each one still missing it.
374
372
 
375
373
  | Rationalization | Reality |
376
374
  |---|---|
@@ -436,6 +434,14 @@ Key choices to internalize:
436
434
  — the parent doesn't need to be in scope for the child query. The
437
435
  alternative (`STANDALONE`) decouples scope entirely; the default
438
436
  scopes the child by the parent.
437
+ A `STANDALONE` edge (or one whose context policy is disabled) puts no
438
+ requirement for the parent in the child's context. If a page of the parent
439
+ will show those children (`RelatedResourceSections`, `EmbedRelatedResourceList`),
440
+ the embed takes the child's route under the parent when one exists; when
441
+ none does, declare the edge's foreign key in the child LIST's `filterFields`
442
+ and the embed pins it to the parent record. Without either the section is
443
+ left out, with a warning naming the cause, rather than listing every row the
444
+ reader may see.
439
445
  - `contextPolicy.objectMode: ContextPolicy_ObjectMode.SUMMARY` — when
440
446
  resolving the parent in the child's response, surface a summary
441
447
  payload by default. The `operationOverrides[READ]` upgrades to
@@ -559,19 +565,14 @@ read it back after the build settles, not mid-edit.
559
565
  - [ ] A lateral reference to a NON tenant-scoped target (`users`, `organizations`) declares `scopeMembership` — otherwise a cross-tenant id is accepted and stored
560
566
  - [ ] Per-variant tightening (status / roles / typed junction rows) is declared as `referenceConstraints` on the OPERATION, not on the relationship
561
567
  - [ ] A reference to another organization names its junction and is declared in the PARENT direction (a child-first edge closes a graph cycle and fails startup)
562
- - [ ] Every edge in a deliberate cycle carries `allowCycle: true` — and the second edge is `REFERENCE` + `STANDALONE`, so it grants no scope and no nested route
568
+ - [ ] A second FK to the type that owns your scope is a PARENT-direction edge, `REFERENCE` + `STANDALONE` with an explicit `foreignKeyField` — no `allowCycle`, which only a self-referential tree or a true two-way ownership loop needs
563
569
 
564
570
  ### Grep invariants
565
571
 
566
572
  ```bash
567
- # every allowCycle edge — a lone one is a cycle that cannot be complete, so startup still refuses
568
- rg -c "allowCycle: true" ./shared-lib/src/modules/**/*.relationships.ts
569
-
570
- # an allowCycle edge with no explicit foreignKeyField — two edges between one pair of types are
571
- # told apart ONLY by their columns, so an implicit one is ambiguous (must return empty). One
572
- # match is one createResourcesRelationship(...) call holding allowCycle and no foreignKeyField,
573
- # wherever in the call either appears.
574
- rg -U -P -l 'createResourcesRelationship\((?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*?allowCycle: true(?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*(?=createResourcesRelationship\(|\z)' ./shared-lib/src/modules --glob '*.relationships.ts'
573
+ # every allowCycle edge — each must be a self-referential tree or a true two-way ownership loop,
574
+ # never an actor reference declared child-first (turn that edge around instead)
575
+ rg -n -B 3 "allowCycle: true" ./shared-lib/src/modules --glob '*.relationships.ts'
575
576
 
576
577
  # a lateral reference to a non-tenant-scoped target that does NOT confine itself (must return empty)
577
578
  rg -U -P -l "createResourcesRelationship\((?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*?foreignKeyField: '(?:assignedTo|sharedWith|reviewer|owner)\w*'(?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*(?=createResourcesRelationship\(|\z)" ./shared-lib/src/modules --glob '*.relationships.ts'
@@ -613,8 +614,8 @@ are renamed.
613
614
  | "A COMPOSITION edge cascades by default" | It does not: `onParentDelete.enabled` defaults to `false`. Declaring COMPOSITION says who owns the rows; only `onParentDelete` says what happens to them, and a tenant purge relies on it for every owned resource. |
614
615
  | "The UI task already did the ui-behavior" | It ran before this relationship existed, so the foreign key was not there to show. Adding it to the read page is this task's work (Step 3). |
615
616
  | "Cascade is fine without `maxDepth`" | `maxDepth` bounds the cascade. Without it, a deep tree can produce expensive deletes (or wedge the framework on cyclic graphs). |
616
- | "The cycle report is wrong — my two columns are different, no row can loop" | Both halves are true and the refusal still stands. The detector is type-level because the traversals it protects are type-level. Declare `allowCycle` on every edge and say in a comment why the loop is unreachable at row level. |
617
- | "I'll set `allowCycle` on the new edge only" | The check is all-or-nothing: the error names each edge still missing the flag, including ones you did not write. |
617
+ | "The cycle report is wrong — my two columns are different, no row can loop" | Two parallel edges are not a cycle. A report means one edge points BACK at a type that is already its parent — usually an actor reference declared child-first. Turn it around; `allowCycle` would keep the wrong parent in every relationship bucket. |
618
+ | "I'll set `allowCycle` and move on" | That silences the error and keeps the inverted model. The flag is for a self-referential tree or a true two-way ownership loop, and then it must be on every edge of the loop. |
618
619
  | "I'll reuse the scope edge instead of adding a second one" | Then the actor and the subject become one field, which is the exact fact the actor column exists to keep separate. A scope edge answers "whose row is this"; an actor edge answers "who did this". |
619
620
  | "`allowCycle` might make something recurse forever" | It changes registration only — no traversal reads it. Context expansion is bounded by a per-row visited set and a depth cap, and the descendant map by its own visited set. |
620
621
 
@@ -626,7 +627,7 @@ are renamed.
626
627
  - `nature` missing from a relationship entry (catch with the **`nature` is declared on every relationship** grep — count must equal the number of `createResourcesRelationship(` calls).
627
628
  - `onParentDelete: { enabled: true }` without `maxDepth` (catch with the **Composition relationships with `onParentDelete` declare `maxDepth`** grep).
628
629
  - A `COMPOSITION` edge with no `onParentDelete` at all (catch with the **Every `COMPOSITION` edge declares its parent-delete lifecycle** counts, and with the boot line `[dependent-lifecycle-unclassified]`).
629
- - An odd number of `allowCycle: true` edges, or one with no explicit `foreignKeyField` (catch with the two **allowCycle** greps above — a cycle needs the flag on every edge, and the edges are told apart only by their columns).
630
+ - An `allowCycle: true` edge on an actor reference, or an actor edge declared child-first (catch with the **allowCycle** grep above — turn the edge around instead), or two edges to one type without explicit `foreignKeyField`s (catch with the **`foreignKeyField` literal always paired** grep — the edges are told apart only by their columns).
630
631
  - A foreign key that appears in the holder's `edit()` and not in its `display()`: the read page never says which record it belongs to (catch with the **holder shows the reference on its read page** grep).
631
632
  - A second edge to a parent type declared `COMPOSITION` or `REQUIRES_CONTEXT` when it is only an actor reference (catch by reading both edges together — the resource's scope must come from exactly one of them).
632
633