@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) 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 +170 -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 +29 -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 +80 -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 +51 -7
  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 +10 -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/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -8,6 +8,7 @@ write; PostgreSQL does not.**
8
8
  | Add a resource | Collection appears on first write | Table must be CREATED by a migration |
9
9
  | Add a field | Document simply carries it | Column must be ADDED by a migration |
10
10
  | Add `.isDBIndexed()` | Index built at boot maintenance | Index created by a migration |
11
+ | Add `.compoundIndex([...])` on the schema | Index built at boot maintenance | Index created by a migration |
11
12
  | Add `.isUnique()` | Index built at boot maintenance | Unique index by migration; FAILS loudly on existing duplicates |
12
13
  | Add a Zod `.default()` | Convertor forwards it to the model | Column `DEFAULT` by migration, and it applies to NEW rows only |
13
14
  | Remove a field | Document key stops being written | `drop column` — DESTRUCTIVE, and acknowledged in writing |
@@ -33,9 +34,10 @@ schema plan, owe no migration, and are never checked at boot:
33
34
 
34
35
  - `persistenceAdapter: HTTP_API` — read through from another system, which keeps the rows;
35
36
  - `persistenceAdapter: INTROSPECTION` — computed from the application itself;
36
- - `persistenceAdapter: MONGODB` — stored in MongoDB.
37
+ - `persistenceAdapter: MONGODB` — stored in MongoDB, which only a MongoDB application
38
+ can declare (an application uses one transactional store).
37
39
 
38
- Moving an existing resource to one of these adapters removes it from the plan, so
40
+ Moving an existing resource to a read-through or introspected adapter removes it from the plan, so
39
41
  the next migration drops its table. That is DESTRUCTIVE: the runner refuses it until
40
42
  you acknowledge it, and any rows the table held are gone. Check the table is empty,
41
43
  or copy what you need, before you generate it.
@@ -43,16 +45,14 @@ or copy what you need, before you generate it.
43
45
  A resource that declares no adapter takes your application's default, and the plan
44
46
  reads that default from every environment you author: it is PostgreSQL when any
45
47
  environment persists to PostgreSQL (`applicationDatabase`, which defaults to
46
- PostgreSQL), and MongoDB only when every environment persists to MongoDB. So a MongoDB
47
- application that keeps one resource on PostgreSQL (`persistenceAdapterIsolation`) gets
48
- a plan, and a migration, for that resource alone; the framework's own resources stay
49
- in MongoDB and out of the plan.
48
+ PostgreSQL), and MongoDB only when every environment persists to MongoDB. An
49
+ application uses exactly one transactional store, so no resource can be kept on the
50
+ other one: startup refuses a resource whose `persistenceAdapter` is MongoDB in a
51
+ PostgreSQL application, or PostgreSQL in a MongoDB one.
50
52
 
51
53
  One lockfile serves all your environments. If they disagree (one on PostgreSQL, one
52
- on MongoDB), the plan covers what the PostgreSQL environment needs. A MongoDB
53
- environment that also keeps a resource on PostgreSQL receives those extra tables in
54
- its PostgreSQL database, empty and never read; one with no PostgreSQL resource never
55
- touches PostgreSQL at all. A table planned and unused costs nothing; a table needed
54
+ on MongoDB), the plan covers what the PostgreSQL environment needs, and the MongoDB
55
+ environment never touches PostgreSQL at all. A table planned and unused costs nothing; a table needed
56
56
  and not planned stops that environment's backend from starting.
57
57
 
58
58
  If your MongoDB application already generated a plan that included every undeclared
@@ -65,4 +65,6 @@ they are empty and acknowledge it.
65
65
  Resource schemas, decorators, factories, operations, relationships, UI
66
66
  behavior and specifications are all adapter-neutral. You author them exactly
67
67
  the same way. The only thing PostgreSQL adds is the obligation to ship the
68
- physical change alongside the semantic one.
68
+ physical change alongside the semantic one. Which framework features run on
69
+ PostgreSQL, and the few differences you can observe, are in
70
+ `postgresql-supported-surfaces.md`.
@@ -69,6 +69,15 @@ Read `references/framework-application-roles-api.md` for the chain. A custom rol
69
69
  role whose access it should start from — `ORG_GUEST` for "almost nothing", `ORG_MEMBER` for
70
70
  "everything a member has, plus".
71
71
 
72
+ "Almost nothing" includes the organization's people. The member directory, the people picker
73
+ (`/organizations/:org/users/search`) and colleagues' names on records all ask the directory's own
74
+ SEARCH roles (`ORG_MEMBER` and up). A role that does not inherit `ORG_MEMBER` lists nobody: its
75
+ holders cannot pick a colleague, and see a person reference on a record as unavailable. When such a
76
+ group does need to see its colleagues (technicians picking who a job is handed to), declare
77
+ `seesOrganizationPeople: true` on its role in Step 2: the directory's SEARCH then counts it, so its
78
+ holders (and holders of any role inheriting it) list, pick and name the organization's people, and
79
+ nothing else widens. Without the declaration the role sees nobody.
80
+
72
81
  ### Step 2 — Declare each custom role in `shared-lib/src/engine/roles.ts`
73
82
 
74
83
  One entry per role, keyed by its name, with `relatedPrimaryScope` `ORGANIZATIONS` (a role inside one
@@ -97,8 +106,19 @@ UPDATE.
97
106
  Author a role specification (`spec-family-update`) so the purpose grounds the role's labels, and make
98
107
  sure `roleSpecifications` in `specifications/src/companion-exports.ts` spreads the application's role
99
108
  specifications beside `engineRoleSpecifications`. Then regenerate labels (`i18n-label-generation`).
100
- People receive the role on the engine's members screen and through invitations: there is nothing to
101
- build for assignment.
109
+
110
+ ### Step 6 — Check who can give it to people
111
+
112
+ People receive the role on the engine's members screen and through invitations; there is no
113
+ assignment screen to build. Who may give it is decided by the role-ceiling gate: an owner or
114
+ administrator may grant a custom role when everything it confers is within their own role — its
115
+ `inheritFrom` chain is on theirs, and every operation that names it (Step 4) also admits them, at the
116
+ same row reach. So a supervisor inheriting `ORG_MANAGER` and named beside `ORG_ADMIN` on the escalation
117
+ rota is grantable by owners and administrators, and refused to managers. A custom role named ALONE on
118
+ an operation administrators cannot call, or inheriting `ORG_OWNER`, exceeds them: only the platform
119
+ super-administrator can grant it. If tenant administrators must be able to give the role, name them
120
+ beside it on every operation it unlocks. The organization type still has to offer it (Step 3) in the
121
+ organization the membership belongs to.
102
122
 
103
123
  ## Worked Example
104
124
 
@@ -108,13 +128,14 @@ The complete office/field wiring — role table, organization type, operation ro
108
128
  ## References
109
129
 
110
130
  - `references/framework-application-roles-api.md` — source-backed role definition and the engine's organization roles with their inheritance chain.
111
- - `references/office-and-field-worked-example.md` — the three places a role must appear, for office staff and field technicians.
131
+ - `references/office-and-field-worked-example.md` — the three places a role must appear, for office staff and field technicians, and who may then grant it.
112
132
 
113
133
  ## Verification
114
134
 
115
135
  - [ ] Every custom role in `roles.ts` has `relatedPrimaryScope` `ORGANIZATIONS` or `APPLICATION`.
116
136
  - [ ] Every custom organization role is in `availableOrgRoles` of each organization type that should offer it.
117
137
  - [ ] Every custom role is named in at least one operation's `roles`.
138
+ - [ ] Every operation naming a custom role that tenant administrators must be able to grant also names `ORG_ADMIN` (or a role on its chain), or the role is grantable by the platform super-administrator only.
118
139
  - [ ] No resource stores roles, permissions or role assignments.
119
140
  - [ ] Each role has a specification and labels.
120
141
 
@@ -127,6 +148,8 @@ rg -n "role: '" shared-lib/src/engine/roles.ts
127
148
  rg -n "'FIELD_TECHNICIAN'" wildo.saas.config.ts
128
149
  # each declared role is named on an operation (repeat per role name)
129
150
  rg -l "'FIELD_TECHNICIAN'" shared-lib/src/modules
151
+ # grantable by administrators: every role list naming the custom role should also name ORG_MEMBER/ORG_ADMIN (or a role on their chain)
152
+ rg -n "'FIELD_TECHNICIAN'" shared-lib/src/modules --glob '*.resources-config.ts'
130
153
  # a resource modelling roles or permissions as data (must return empty)
131
154
  rg -li "permission|roleassignment|accessrole" shared-lib/src/modules --glob '*.schemas.ts'
132
155
  ```
@@ -139,12 +162,14 @@ rg -li "permission|roleassignment|accessrole" shared-lib/src/modules --glob '*.s
139
162
  | "I'll add a permissions enum and check it later" | Nothing checks it later. The engine gates operations on `roles` alone, so the enum ships as a control that enforces nothing. |
140
163
  | "The field role should inherit ORG_MEMBER so technicians can work" | Then technicians hold everything office staff hold. Inherit `ORG_GUEST` and name the field role on the operations it needs. |
141
164
  | "ORG_ADMIN inherits everything, so admins pass my custom role's operations" | The chain is linear and a custom role is not on it. Name `ORG_MEMBER` (or `ORG_ADMIN`) beside the custom role where administrators must qualify. |
165
+ | "Only a super-administrator can give a custom role, so I need an assignment screen" | An owner or administrator grants it on the members screen whenever every operation, approval or decision route, action and agent or flow launch gate (`accessControl[].roles`) naming it also admits them. Name them beside the role instead of building a screen; a role that is the only one a decision route admits stays a super-administrator's to give. |
142
166
  | "Hiding the menu entry is enough" | Hiding is not refusing. The operation's `roles` is what the engine enforces; navigation only follows it. |
143
167
 
144
168
  ## Red Flags
145
169
 
146
170
  - A custom role in `roles.ts` that no operation names (catch with the **named on an operation** grep).
147
171
  - A custom organization role missing from `availableOrgRoles` (catch with the **offered** grep).
172
+ - A custom role tenant administrators must give, named alone on an operation they cannot call (catch with the **grantable by administrators** grep).
148
173
  - A resource whose schema stores roles, permissions or assignments (catch with the **modelling roles as data** grep — must return empty).
149
174
  - A custom role inheriting `ORG_MEMBER` or higher when the requirement narrows access (catch by reading `roles.ts` against Step 1).
150
175
  - Every operation of a resource on the same single role while the requirements name several groups (catch by reading each `*.resources-config.ts` touched in Step 4).
@@ -39,17 +39,28 @@ ships. Read this before declaring a role, choosing what it inherits, or naming r
39
39
  * - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
40
40
  * organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
41
41
  * ignored at startup with a warning, and the role grants nothing.
42
+ * - `seesOrganizationPeople` — `true` admits the role's holders to the organization's people: the member directory's
43
+ * SEARCH, the people picker behind every user reference (`/organizations/:organizationId/users/search`) and
44
+ * colleagues' names on records. Those three ask ONE question, the directory's SEARCH roles (`ORG_MEMBER` and up),
45
+ * and a role declaring this is counted among them, as is every role inheriting from it. Read only on a role whose
46
+ * `relatedPrimaryScope` is `ORGANIZATIONS`. Absent means refused: a role that does not inherit `ORG_MEMBER` (a field
47
+ * technician inheriting `ORG_GUEST`) sees nobody unless it declares this.
42
48
  *
43
49
  * Declaring a role is one of three steps. An organization role must also be listed in
44
50
  * `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
45
51
  * it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
46
- * nothing). People receive it through the engine's members screen and invitations.
52
+ * nothing). People receive it through the engine's members screen and invitations, from an owner or
53
+ * administrator whose role covers everything it confers: its `inheritFrom` chain, and every operation,
54
+ * approval or decision route, reference constraint, system-of-record action and agent or flow launch gate naming it
55
+ * (`resolveCustomRolesWithinAuthority`). Named alone where administrators are not admitted (an operation
56
+ * they cannot call, a decision route only it answers), it is grantable by the platform super-administrator only.
47
57
  */
48
58
  export const RoleDefinitionSchema = z.object({
49
59
  role: RolesSchema,
50
60
  inheritFrom: RolesSchema.optional(),
51
61
  isSystemRole: z.boolean().default(false),
52
62
  relatedPrimaryScope : z.enum(ResourcePrimaryScope),
63
+ seesOrganizationPeople: z.boolean().optional(),
53
64
  });
54
65
 
55
66
 
@@ -133,6 +144,12 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
133
144
  isSystemRole: true,
134
145
  relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
135
146
  },
147
+ // No `inheritFrom`: handler-only, confers no operation; the signature notification handler only triggers a re-read (#2293).
148
+ [CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS]: {
149
+ role: CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS,
150
+ isSystemRole: true,
151
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
152
+ },
136
153
  // No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
137
154
  // inheriting anything would make a lent capability's reach a function of what that role grows into later.
138
155
  [CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
@@ -47,6 +47,16 @@ export const workspaceAvailableOrgRoles: Roles[] = [
47
47
  export const jobReadAndProgressRoles: Roles[] = ['FIELD_TECHNICIAN', CORE_ORG_ROLES.ORG_MEMBER];
48
48
  /** Quotes and invoices: office only. A technician holding only the field role is refused. */
49
49
  export const quoteAndInvoiceRoles: Roles[] = [CORE_ORG_ROLES.ORG_MEMBER];
50
+
51
+ /**
52
+ * 4. Who may GIVE the role needs no fourth place. An owner or administrator may grant a custom role whenever everything
53
+ * it confers is within their own role: its `inheritFrom` chain is on theirs, and every operation naming it admits
54
+ * them too, at the same row reach. Here the field role inherits `ORG_GUEST` and the one operation naming it also
55
+ * names `ORG_MEMBER`, so owners and administrators give it on the members screen and in invitations. Name the
56
+ * custom role ALONE on an operation administrators cannot call, or make it inherit `ORG_OWNER`, and only a role
57
+ * covering it may grant it, which for an organization role is the platform super-administrator. Who may write a
58
+ * membership at all is still that operation's own `roles` (`ORG_ADMIN` in the engine).
59
+ */
50
60
  ```
51
61
 
52
62
  What each part earns:
@@ -56,8 +66,19 @@ What each part earns:
56
66
  operation to name it AND the core roles.
57
67
  - **The field role inherits `ORG_GUEST`.** It starts from the bottom, so a technician reaches only the
58
68
  operations that name the field role explicitly. Inheriting `ORG_MEMBER` instead would give
59
- technicians everything office staff have, which is the opposite of the requirement.
69
+ technicians everything office staff have, which is the opposite of the requirement. It also means a
70
+ technician does not list the organization's people: the people picker and colleagues' names ask the
71
+ member directory's roles (`ORG_MEMBER`), so jobs are assigned by the office, and a technician sees
72
+ an assignee on a job as unavailable rather than by name. If technicians must see their colleagues,
73
+ add `seesOrganizationPeople: true` to the field role: the directory's SEARCH then counts it, and
74
+ the people picker and colleagues' names follow, while every other operation still admits only the
75
+ roles it names.
60
76
  - **`availableOrgRoles` lists it.** Without the entry, the members screen cannot give the role to
61
77
  anyone: the default list is owner, admin and member.
62
78
  - **Operations name it where technicians are admitted, and only there.** Invoices name `ORG_MEMBER`
63
79
  alone, so a technician is refused by the engine, not merely hidden from in the UI.
80
+ - **Owners and administrators can give it, with nothing more to build.** The role-ceiling gate admits
81
+ a custom role when everything it confers is within the granter's role: the field role inherits
82
+ `ORG_GUEST`, on every administrator's chain, and the jobs operation that names it also names
83
+ `ORG_MEMBER`. Had the field role been named ALONE on some operation, it would exceed every tenant
84
+ role, and only the platform super-administrator could grant it.
@@ -201,6 +201,15 @@ whose type does not declare `scimProvisioning`: the SCIM API refuses every reque
201
201
  for such an organization, so no directory can push to it, and no SCIM token can be
202
202
  generated for it.
203
203
 
204
+ **c) Declared in code, for the application's own organization.** An internal
205
+ tool's name, chart, department → unit mapping, the unit each partition of a
206
+ partitioned system of record belongs to, and SSO-only posture can be a
207
+ committed `organizationIdentity` declaration applied at boot instead of settings
208
+ clicked in per environment. Units are named by `key` (their `code`), bindings
209
+ name units by key, and the boot step creates what is missing while keeping and
210
+ reporting what an administrator changed. See
211
+ `references/framework-organization-identity-declaration-api.md`.
212
+
204
213
  ### Step 6 — Update the resource specification
205
214
 
206
215
  Say plainly, in the resource's specification, that the resource is confined by
@@ -266,7 +275,11 @@ startup:
266
275
  someone else. Another user foreign key (a requester, an assignee) is allowed;
267
276
  it must be a top-level foreign key of the main schema.
268
277
  - `roles` — the roles whose ORGANIZATION-WIDE grant reaches only the rows the
269
- holder owns, typically the default member role.
278
+ holder owns, typically the default member role. Held on a UNIT, a declared
279
+ role supplies no unit (and no own rows of its own): a directory that places
280
+ every employee in their department with the member role therefore does not
281
+ open the department's rows to them. The department is reached through a role
282
+ you do not list (the department head's manager role on the unit).
270
283
 
271
284
  It is a privilege DEPTH, not an admission. A declared role still has to satisfy
272
285
  the operation's own `roles`, so give the read operations the member role when
@@ -278,6 +291,7 @@ What changes is how far the satisfying role reaches:
278
291
  | an organization-wide role NOT in `roles` that satisfies the operation (a manager, finance) | every row |
279
292
  | a unit role that satisfies it, and a declared role organization-wide | their units' rows **and** their own rows anywhere |
280
293
  | only a declared role that satisfies it | the rows they own |
294
+ | a declared role held only on a unit (no organization-wide grant that satisfies it) | nothing |
281
295
  | no user (an API key, an OAuth client) with only a declared role | nothing |
282
296
 
283
297
  Depth is a property of the role HELD: a manager whose role inherits the member
@@ -304,6 +318,28 @@ perform whatever their role (only the requester may submit their request, even
304
318
  though the procurement office reads it) is still a check in that operation's
305
319
  hook: reading a row is not the right to act on it.
306
320
 
321
+ ### The rows ABOUT an owner's record: name the owner on them
322
+
323
+ A workflow item collects rows other people write about it: the decisions on a
324
+ request, the assessments of a claim. The person the item belongs to must often
325
+ read them (a refusal's reason is written for the requester) and must never read
326
+ the ones about a colleague's item. Confine them with own rows too, on a field
327
+ of THEIR OWN that names the person they are addressed to:
328
+
329
+ - Add a user foreign key (`requesterUserId`) to the decision, and copy it from
330
+ the item when the decision is recorded, beside the item's unit. The item's
331
+ owner never changes, so the copy cannot drift.
332
+ - Declare own rows on it for the member role, and give the decision's READ and
333
+ LIST that role. Keep the unit narrowing the decision already has: the
334
+ approvers keep their department, and finance keeps everything.
335
+ - Do not reach the decisions "through" the item instead. Own rows match a field
336
+ on the row itself, and nothing confines a row by whether its caller may read
337
+ the row it references. A nested route under the item filters by the item id
338
+ the caller NAMES, which any member can name, so it confines nothing.
339
+
340
+ A decision that names nobody (an item raised by a machine principal) is read by
341
+ no requester, never by every one. See `references/framework-own-rows-declaration-api.md`.
342
+
307
343
  ## Assigned rows: when the row does not name its person
308
344
 
309
345
  Some rows belong to whoever is ASSIGNED to them, and the assignment is a row of
@@ -335,7 +371,8 @@ member cannot create a row matched on its own id (no assignment can name a row
335
371
  before it exists). With `confinedRowField`, a create or an update that sets the
336
372
  field must name a value one of their live assignments names, and emptying it is
337
373
  refused, so no write moves a row to a client they do not serve. A
338
- resource declares one of unit narrowing, own rows or assigned rows, never two.
374
+ resource that declares assigned rows declares nothing else: unit narrowing and
375
+ own rows compose (above), assigned rows stand alone.
339
376
  The engine declares two itself: a representing organization's member reads only
340
377
  the client relationships they hold an active assignment for, and those clients'
341
378
  mailboxes, so do not redeclare `organizationRepresentations` or
@@ -458,6 +495,9 @@ Three consequences worth knowing before you see them:
458
495
  - [ ] With own rows declared: a member holding only the declared role lists only
459
496
  the rows they own, and the read operations' `roles` include that role (a
460
497
  declaration on a resource members cannot read confines nobody)
498
+ - [ ] With own rows declared beside unit narrowing: a member who also holds the
499
+ declared role ON A UNIT (a directory placement) still lists only their
500
+ own rows, never the unit's
461
501
 
462
502
  ### Grep invariants
463
503
 
@@ -471,6 +511,7 @@ Run from the app root, substituting `<resource>` and `<field>`:
471
511
  | The specification mentions the confinement | `rg -n -i "organization unit" specifications/src/modules/*/resources/<resource>.resource.specification.ts` |
472
512
  | An own-rows declaration exists, beside the unit one | `rg -n "organizationOwnRows" backend-api/src` |
473
513
  | An assigned-rows declaration exists where rows belong to whoever is assigned | `rg -n "organizationAssignedRows" backend-api/src` |
514
+ | The owner organization's chart is declared, not clicked in | `rg -n "organizationIdentity" backend-api/src` |
474
515
 
475
516
  ```bash
476
517
  # No authorization-plane resource is declared (must be empty)
@@ -529,6 +570,9 @@ loudly, while a misspelled field name is the one mistake that fails quietly.
529
570
  contract (source-backed).
530
571
  - `references/framework-assigned-rows-declaration-api.md` — the assigned-rows
531
572
  declaration contract (source-backed).
573
+ - `references/framework-organization-identity-declaration-api.md` — the owner
574
+ organization's units, directory mapping and SSO posture, declared and applied
575
+ at boot (source-backed).
532
576
 
533
577
  ## Related Skills
534
578
 
@@ -14,8 +14,9 @@ lawyer works), or when startup refuses an assigned-rows declaration.
14
14
  passed to application startup, beside `organizationOwnRows`.
15
15
  - **What it never does** — admit anyone. The operation's own roles still decide
16
16
  who may call it; the declaration decides how far a declared role reaches.
17
- - **One confinement per resource** — a resource declares assigned rows, own rows
18
- or unit narrowing, never two of them.
17
+ - **Assigned rows stand alone** — a resource that declares assigned rows declares
18
+ neither own rows nor unit narrowing. (Own rows and unit narrowing compose with
19
+ each other.)
19
20
 
20
21
  ## Import Origins
21
22
 
@@ -66,7 +67,8 @@ lawyer works), or when startup refuses an assigned-rows declaration.
66
67
  * write never moves a row to a client the caller does not serve. A principal with no user (an API key, an OAuth client)
67
68
  * is assigned nothing, so a declared role reaches no row for it.
68
69
  *
69
- * A resource declares assigned rows, own rows or unit narrowing, never two of them together.
70
+ * A resource that declares assigned rows declares no other confinement. (Own rows and unit narrowing compose with each
71
+ * other: a department head reaches their department's rows and their own.)
70
72
  */
71
73
  export type OrganizationAssignedRowsDeclaration = {
72
74
  /** The resource whose rows assign a user to a row of this resource. */
@@ -0,0 +1,247 @@
1
+ # Organization identity declaration — contract (source)
2
+
3
+ Read this when the application's OWN organization (an internal tool's company) should get its name, its units, its
4
+ directory's department → unit mapping, or its single-sign-on-only posture from committed code rather than from an administrator
5
+ clicking through the settings after every new environment.
6
+
7
+ - **Where it is declared** — `organizationIdentity` in the configuration passed to application startup
8
+ (`backend-api/src/bootstrap-config.ts`), beside `organizationUnitNarrowing`. Keep the object in its own file
9
+ (`backend-api/src/organization-identity.ts`) so scripts and tests can import the same chart.
10
+ - **Which organization** — `OrganizationIdentityDeclarationTarget.APPLICATION_OWNER`: the organization of the type
11
+ that declares `ownsApplication`. There is no "every organization of type X" form.
12
+ - **The name** (`name`) is what every member reads in the breadcrumb and the organization switcher. The platform seeds
13
+ the owner organization as `PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME` ("Default Organization"); the backend
14
+ replaces that placeholder with the declared name, through the organization's own audited UPDATE. It writes the name
15
+ only over the placeholder: once the organization is named, a CHANGED `name` is reported as drift and the stored name
16
+ is kept, because an administrator's rename and an earlier declaration's write leave the same row. To adopt the new
17
+ name, rename the organization to it in its settings. Declare it: an internal tool whose company is called "Default
18
+ Organization" tells every employee the set-up was never finished.
19
+ - **Partitions of a system of record** (`systemOfRecordPartitions`) — one `{ system, remoteKey, unitKey }` per remote
20
+ partition of a partitioned instance (an Odoo company). A partition no unit holds loads no rows, so declare each one
21
+ you know; the backend assigns a missing one at boot through `systemOfRecordPartitionAssignments`' own create, keeps
22
+ one an administrator moved (reported as drift), and startup refuses a binding to an instance not declared
23
+ `partition: true`. The keys are the system's own: per environment, like a directory's department names.
24
+ - **Units** are addressed by `key`, which becomes the unit's `code`. A directory binding names a unit by that key; the
25
+ engine resolves it to the unit's id. Never write unit ids into the declaration.
26
+ - **What applying means** — at every boot the backend creates what is missing and reports, without overwriting, what an
27
+ administrator changed: a renamed or moved unit, a department bound to another unit, a role or a posture field set to
28
+ something else. A posture field is applied only while the stored value is still the engine default, so a field an
29
+ administrator sets BACK to its default is applied again at the next boot: relax the posture by changing the
30
+ declaration. What is missing is created again, whoever removed it: to drop a unit or a binding for good, remove it
31
+ from the declaration. An owner that resolves to no single row (several organizations of the owner type) is reported
32
+ at ERROR and nothing is applied; an application that declares no owner type refuses to start.
33
+ - **Stored is not in effect** — the step writes with system authority, so it does not meet the entitlement gate an
34
+ administrator's form meets. It therefore checks afterwards: a `requireSSO` on an organization without the
35
+ `SINGLE_SIGN_ON` entitlement (ignored at sign-in), or a department mapping on one without `DIRECTORY_PROVISIONING`
36
+ (the directory provisions nobody), is reported at ERROR as "stored, but not in effect". A `directory` declared on an
37
+ owner type that does not declare `scimProvisioning: { enabled: true }` refuses startup.
38
+ - **What it never carries** — the SSO connection and its client secret, the SCIM token, a domain's DNS proof and its
39
+ sign-in routing. Those stay runtime records the organization's administrator (or a set-up script) writes.
40
+ - **When it applies** — after the data-seeding passes, in the application backend only, and again whenever the owner
41
+ organization appears while the backend runs. On a fresh installation the owner organization does not exist at the
42
+ first boot: the step logs that it is pending, keeps looking for the owner (for an hour after boot), and applies the
43
+ declaration as soon as the platform seeds it, with no restart. A promotion (`organizations.promoteToOwnerOrganization`)
44
+ that makes a new owner applies it at once. Each owner gets it once per backend process; the next boot is the backstop
45
+ for a write that failed. Its log line names the trigger (`boot` or `owner_appeared`).
46
+ - **Refused at startup** — a duplicate key, an unknown parent, a cycle, a binding to an undeclared unit, a department
47
+ bound twice, a break-glass address listed twice. Its log line is `organization identity declaration`.
48
+
49
+ ## Import Origins
50
+
51
+ - `@wildo-ai/saas-models`
52
+
53
+ ## Source Excerpts
54
+
55
+ ### Origin Package: `@wildo-ai/saas-models`
56
+
57
+ ```typescript
58
+ /**
59
+ * Which organization an identity declaration describes.
60
+ *
61
+ * Imported from `@wildo-ai/saas-models`. One member today, and the vocabulary is closed on purpose: a declaration
62
+ * describes ONE organization whose chart the application knows when it is written.
63
+ *
64
+ * - `APPLICATION_OWNER` — the organization recorded as the application's owner, the single organization of the type
65
+ * that declares `ownsApplication`. An internal tool's company is this organization.
66
+ *
67
+ * A template applied to every organization of a type ("every customer gets a Sales and a Support unit") is a different
68
+ * contract — a per-tenant default rather than a chart — and is deliberately not expressible here.
69
+ */
70
+ export enum OrganizationIdentityDeclarationTarget {
71
+ APPLICATION_OWNER = 'application_owner',
72
+ }
73
+
74
+ /**
75
+ * The name the platform gives the organization it seeds for an application's first administrator, before anybody has
76
+ * named it.
77
+ *
78
+ * Imported from `@wildo-ai/saas-models`. One named value read by both sides: the platform seeds the organization with it,
79
+ * and the identity declaration's `name` replaces it — and only it. A stored name equal to this placeholder means
80
+ * "nobody has named this organization yet", so the current declaration replaces it, the first one or a changed one. Any
81
+ * other stored name is kept, whether a person chose it or an earlier declaration wrote it: the row cannot tell them
82
+ * apart, and the drift report says how to adopt the declared name.
83
+ */
84
+ export const PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME = 'Default Organization';
85
+
86
+ /**
87
+ * One unit of the declared chart.
88
+ *
89
+ * - `key` becomes the unit's `code` and is how the declaration recognises the unit on every later boot. Unique within
90
+ * the declaration; at most 20 characters, the unit `code` limit.
91
+ * - `kind` is the unit's `type`.
92
+ * - `parentKey` names another declared unit; absent for a unit directly under the organization.
93
+ * - `displayName` is the unit's `name` when the declaration creates it. An administrator may rename it afterwards; the
94
+ * declaration reports the difference and keeps the administrator's name.
95
+ */
96
+ export const OrganizationIdentityUnitDeclarationSchema = z.object({
97
+ key: z.string().trim().min(1).max(20),
98
+ kind: z.enum(OrganizationUnitType),
99
+ parentKey: z.string().trim().min(1).max(20).optional(),
100
+ displayName: z.string().trim().min(1).max(100),
101
+ }).strict();
102
+ export type OrganizationIdentityUnitDeclaration = z.infer<typeof OrganizationIdentityUnitDeclarationSchema>;
103
+
104
+ /** One binding of a directory `department` value to a declared unit, by the unit's `key`. */
105
+ export const OrganizationIdentityDepartmentBindingSchema = z.object({
106
+ /** The value the directory pushes, e.g. `"Sales"` — matched exactly by the SCIM `/Users` path. */
107
+ directoryValue: z.string().trim().min(1).max(200),
108
+ /** The `key` of the declared unit members with this department are assigned to. */
109
+ unitKey: z.string().trim().min(1).max(20),
110
+ }).strict();
111
+ export type OrganizationIdentityDepartmentBinding = z.infer<typeof OrganizationIdentityDepartmentBindingSchema>;
112
+
113
+ /**
114
+ * How the organization's directory (SCIM) places the people it provisions.
115
+ *
116
+ * - `departmentUnitMapping` binds each directory department to a declared unit. Declaring it makes the directory
117
+ * AUTHORITATIVE over each member's unit assignments: every push replaces them with what the directory says.
118
+ * - `unitRole` is the role every directory-made unit assignment carries (the provisioning config's `defaultUnitRole`).
119
+ * Required: the department mapping does nothing without it.
120
+ * - `organizationRole` is the organization-wide role a provisioned member receives (`defaultRole`). Never an
121
+ * administrative role: the engine refuses a directory that could mint tenant administrators.
122
+ */
123
+ export const OrganizationIdentityDirectoryDeclarationSchema = z.object({
124
+ departmentUnitMapping: z.array(OrganizationIdentityDepartmentBindingSchema).min(1),
125
+ unitRole: z.string().trim().min(1),
126
+ organizationRole: z.string().trim().min(1).optional(),
127
+ }).strict();
128
+ export type OrganizationIdentityDirectoryDeclaration = z.infer<typeof OrganizationIdentityDirectoryDeclarationSchema>;
129
+
130
+ /**
131
+ * One remote partition of a system of record, bound to a declared unit (#3066).
132
+ *
133
+ * A partitioned system of record (`systemsOfRecord.<name>.partition: true`) splits its records by a remote partition —
134
+ * Odoo's companies, SAP company codes — and a record reaches a member only through the organization unit its partition
135
+ * is assigned to (`systemOfRecordPartitionAssignments`). Until an assignment exists, the rows of that partition are not
136
+ * loaded at all. Declaring the binding here is what makes a new environment of the application read its system of record
137
+ * on its first boot, instead of waiting for an operator to assign each partition by hand.
138
+ *
139
+ * - `system` is the `systemsOfRecord` instance name, which must be declared and partitioned (startup refuses otherwise).
140
+ * - `remoteKey` is the partition's key AS THE REMOTE SPELLS IT, in canonical text (an Odoo company id `'1'`).
141
+ * - `unitKey` names a declared unit, normally the subsidiary that owns the partition.
142
+ *
143
+ * The binding is per environment by nature, like the directory's department values: it names the remote's own keys. An
144
+ * application whose environments' systems number their partitions differently declares the binding where it builds
145
+ * the declaration for each.
146
+ */
147
+ export const OrganizationIdentityPartitionBindingSchema = z.object({
148
+ system: z.string().regex(SYSTEM_OF_RECORD_NAME_PATTERN).max(SYSTEM_OF_RECORD_NAME_MAX_LENGTH),
149
+ remoteKey: z.string().trim().min(1).max(SYSTEM_OF_RECORD_REMOTE_KEY_MAX_LENGTH),
150
+ unitKey: z.string().trim().min(1).max(20),
151
+ }).strict();
152
+ export type OrganizationIdentityPartitionBinding = z.infer<typeof OrganizationIdentityPartitionBindingSchema>;
153
+
154
+ /**
155
+ * The organization's single sign-on posture — the enforcement half only. The connection to the identity provider (with
156
+ * its client secret) and the domain routing (proved by DNS) stay runtime records.
157
+ *
158
+ * - `requireSSO` — members at an SSO-enabled domain must sign in through single sign-on.
159
+ * - `allowPasswordFallback` — `false` refuses every password sign-in except a break-glass account's.
160
+ * - `requireEnterpriseSSOOnly` — every social sign-in provider is refused.
161
+ * - `breakGlassAccounts` — the named accounts that keep a password for the day the identity provider is unreachable.
162
+ * Keep it short: each one is a standing way in with a password alone.
163
+ */
164
+ export const OrganizationIdentitySingleSignOnDeclarationSchema = z.object({
165
+ requireSSO: z.boolean(),
166
+ allowPasswordFallback: z.boolean(),
167
+ requireEnterpriseSSOOnly: z.boolean(),
168
+ breakGlassAccounts: z.array(z.email()),
169
+ }).strict();
170
+ export type OrganizationIdentitySingleSignOnDeclaration = z.infer<typeof OrganizationIdentitySingleSignOnDeclarationSchema>;
171
+
172
+ /**
173
+ * Why an identity declaration is refused at startup. Each is a contradiction inside the declaration, so its remedy is
174
+ * an edit to the declaration and the application refuses to start rather than apply half of it.
175
+ */
176
+ export enum OrganizationIdentityDeclarationViolation {
177
+ /** Two units declare the same `key`. */
178
+ DUPLICATE_UNIT_KEY = 'duplicate_unit_key',
179
+ /** A unit's `parentKey` names no declared unit. */
180
+ UNKNOWN_PARENT_UNIT = 'unknown_parent_unit',
181
+ /** Following `parentKey` from a unit comes back to it. */
182
+ UNIT_PARENT_CYCLE = 'unit_parent_cycle',
183
+ /** A department binding names a `unitKey` no unit declares. */
184
+ MAPPING_TO_UNDECLARED_UNIT = 'mapping_to_undeclared_unit',
185
+ /** Two bindings for the same directory value: the directory could place a member in either. */
186
+ DUPLICATE_DIRECTORY_VALUE = 'duplicate_directory_value',
187
+ /** The same break-glass address twice. */
188
+ DUPLICATE_BREAK_GLASS_ACCOUNT = 'duplicate_break_glass_account',
189
+ /** A partition binding names a `unitKey` no unit declares. */
190
+ PARTITION_TO_UNDECLARED_UNIT = 'partition_to_undeclared_unit',
191
+ /** Two bindings for the same `system` and `remoteKey`: a partition belongs to one unit. */
192
+ DUPLICATE_PARTITION = 'duplicate_partition',
193
+ }
194
+
195
+ /**
196
+ * The organization identity declaration.
197
+ *
198
+ * Imported from `@wildo-ai/saas-models`. Pass it to application startup as `organizationIdentity`, beside
199
+ * `organizationUnitNarrowing`, in `backend-api/src/bootstrap-config.ts`:
200
+ *
201
+ * ```ts
202
+ * organizationIdentity: {
203
+ * organization: OrganizationIdentityDeclarationTarget.APPLICATION_OWNER,
204
+ * name: 'Wonder Group',
205
+ * units: [
206
+ * { key: 'FR', kind: OrganizationUnitType.COMPANY, displayName: 'Wonder France' },
207
+ * { key: 'FR-SALES', kind: OrganizationUnitType.DEPARTMENT, parentKey: 'FR', displayName: 'Sales' },
208
+ * ],
209
+ * directory: { departmentUnitMapping: [{ directoryValue: 'Sales', unitKey: 'FR-SALES' }], unitRole: CORE_ORG_ROLES.ORG_MEMBER },
210
+ * singleSignOn: { requireSSO: true, allowPasswordFallback: false, requireEnterpriseSSOOnly: true, breakGlassAccounts: ['it-emergency@example.com'] },
211
+ * systemOfRecordPartitions: [{ system: 'odoo', remoteKey: '1', unitKey: 'FR' }],
212
+ * }
213
+ * ```
214
+ *
215
+ * Every part is optional except the target and the unit list (which may be empty). At every boot the application backend
216
+ * creates what is missing — the organization's name while it is still the platform's placeholder, a unit, a department
217
+ * binding, a partition assignment, an absent role, a posture field still at the engine's default — and reports, without overwriting, what an administrator changed. Something missing is created again whoever removed
218
+ * it: to drop a unit or a binding for good, remove it from the declaration. A posture field an administrator set back to
219
+ * its default is applied again; relax the posture by changing the declaration.
220
+ */
221
+ export const OrganizationIdentityDeclarationSchema = z.object({
222
+ organization: z.enum(OrganizationIdentityDeclarationTarget),
223
+ /**
224
+ * The organization's name — what every member reads in the breadcrumb, the organization switcher and the e-mails.
225
+ * Written only while the stored name is still the platform's placeholder
226
+ * ({@link PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME}). Any other stored name — an administrator's, or one an earlier
227
+ * version of this declaration wrote — is kept and reported as drift with its remedy: rename the organization to the
228
+ * declared name, or set this field to the stored one. So changing this field renames the organization only while it
229
+ * still carries the placeholder.
230
+ * At most 100 characters, the organization `name` limit.
231
+ */
232
+ name: z.string().trim().min(1).max(100).optional(),
233
+ units: z.array(OrganizationIdentityUnitDeclarationSchema),
234
+ directory: OrganizationIdentityDirectoryDeclarationSchema.optional(),
235
+ singleSignOn: OrganizationIdentitySingleSignOnDeclarationSchema.optional(),
236
+ /**
237
+ * The remote partitions of the application's partitioned systems of record, each bound to a declared unit (#3066).
238
+ * A missing assignment is created; a partition an administrator assigned to another unit is kept and reported.
239
+ */
240
+ systemOfRecordPartitions: z.array(OrganizationIdentityPartitionBindingSchema).optional(),
241
+ }).strict().superRefine((declaration, ctx) => {
242
+ for (const violation of collectOrganizationIdentityDeclarationViolations(declaration)) {
243
+ ctx.addIssue({ code: 'custom', path: violation.path, message: `${violation.violation}: ${violation.detail}` });
244
+ }
245
+ });
246
+ export type OrganizationIdentityDeclaration = z.infer<typeof OrganizationIdentityDeclarationSchema>;
247
+ ```
@@ -5,9 +5,13 @@ startup refuses an own-rows declaration.
5
5
 
6
6
  - **`OrganizationOwnRowsDeclaration`** — the per-resource shape: the field naming
7
7
  each row's owner, and the roles whose organization-wide grant reaches only the
8
- holder's own rows. Declared as an `organizationOwnRows` map keyed by resource
9
- type in the configuration passed to application startup, beside
10
- `organizationUnitNarrowing`.
8
+ holder's own rows (held on a unit, such a role supplies no unit). Declared as an `organizationOwnRows` map
9
+ keyed by resource type in the configuration passed to application startup,
10
+ beside `organizationUnitNarrowing`, with which it composes.
11
+ - **The owner field may be a copy** — a row written ABOUT someone's record (a
12
+ decision on a request) names that person in a field of its own, copied when it
13
+ is written, and is confined on it. Nothing confines a row through the row it
14
+ references.
11
15
  - **What it never does** — admit anyone. The operation's own roles still decide
12
16
  who may call it; the declaration decides how far a declared role reaches.
13
17
 
@@ -37,7 +41,10 @@ startup refuses an own-rows declaration.
37
41
  * field of the resource's main schema, declared as a foreign key: it becomes a query predicate on every read and a
38
42
  * write-time check on every create and update.
39
43
  * - `roles` are the roles whose ORGANIZATION-WIDE grant reaches only the holder's own rows on this resource, typically
40
- * the default member role. A role not listed keeps its organization depth: an organization-wide manager or finance
44
+ * the default member role. Held on a UNIT, a declared role supplies no unit and no own rows of its own (#3068): a
45
+ * directory that places every employee in their department with the member role therefore does not open the
46
+ * department's rows to them, and the department is reached through a role that is not listed (the department head's
47
+ * manager role on the unit). A role not listed keeps the depth of its grant: an organization-wide manager or finance
41
48
  * role still reaches every row. A role is judged as HELD: a manager whose role inherits the member role is not
42
49
  * confined, because what they hold is the manager role.
43
50
  *
@@ -53,7 +60,7 @@ startup refuses an own-rows declaration.
53
60
  export type OrganizationOwnRowsDeclaration = {
54
61
  /** The field on the resource holding the owning user's id. */
55
62
  readonly ownerUserIdField: string;
56
- /** The roles whose organization-wide grant reaches only the holder's own rows on this resource. */
63
+ /** The roles whose organization-wide grant reaches only the holder's own rows on this resource, and which supply no unit. */
57
64
  readonly roles: readonly string[];
58
65
  };
59
66
  ```