@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
@@ -32,17 +32,61 @@ import { ApiReferenceResourceCategorySchema, OpenApiServerSchema } from '../comp
32
32
  export const API_DOC_RESOURCES_ALL = 'all' as const;
33
33
 
34
34
  /**
35
- * One complete category declaration for the resources published by this API
36
- * reference. `resourceNames` uses the generated OpenAPI tag name, which is
37
- * the resolved resource identifier, rather than a display label or a
38
- * filesystem location. The companion rejects a duplicate, stale or missing
39
- * assignment whenever this feature is configured.
35
+ * The application's OWN resources an assignment places. `resourceNames` uses the generated OpenAPI tag name, which is
36
+ * the resolved resource identifier, rather than a display label or a filesystem location.
40
37
  */
41
- export const ApiReferenceResourceCategoryAssignmentSchema = ApiReferenceResourceCategorySchema.extend({
42
- resourceNames: z.array(z.string().min(1)).min(1),
38
+ const ApiReferenceAssignedResourceNamesSchema = z.array(z.string().min(1)).min(1);
39
+
40
+ /**
41
+ * A category the APPLICATION declares, with the words a reader meets: for a part of the product the engine has no
42
+ * category for (Your Application' "Work management", Wonder CRM's "Deals and pipeline").
43
+ *
44
+ * Its id and its label may not be an engine category's, compared ignoring case and spacing: an application group
45
+ * called "Notifications" beside the engine's "Notifications" would be two groups a reader cannot tell apart. To put an
46
+ * application resource in a part the engine already names, use {@link ApiReferenceEngineCategoryAssignmentSchema}.
47
+ * A near-synonym ("Notifications and webhooks") is not refused, since no rule can tell one from a different part of
48
+ * the product; whether a new group names a part the engine already covers is the author's judgement.
49
+ */
50
+ export const ApiReferenceApplicationCategoryAssignmentSchema = ApiReferenceResourceCategorySchema.extend({
51
+ resourceNames: ApiReferenceAssignedResourceNamesSchema,
43
52
  });
53
+ export type ApiReferenceApplicationCategoryAssignment = z.infer<typeof ApiReferenceApplicationCategoryAssignmentSchema>;
54
+
55
+ /**
56
+ * The application files some of its OWN resources into a category the ENGINE declares, by the engine's id. The label
57
+ * and description are the engine's, so the group reads the same whether a resource came from the engine or from the
58
+ * application (Your Application' `appAnnouncements` sits in the engine's "Notifications" group).
59
+ *
60
+ * `engineCategory` is an `EngineResourceSubDomain` value from `@wildo-ai/saas-specifications`. The schema types it as
61
+ * a string on purpose: this module is exported from this package's ROOT, which every docs build and every
62
+ * `wildo.tech-doc.config.ts` loads, and importing the enum would bring the whole specification tree with it (the cost
63
+ * `engine-resource-sub-domain.ts` measured for its only browser consumer). The companion checks the value against the
64
+ * enum before anything is published, and names an unknown one.
65
+ */
66
+ export const ApiReferenceEngineCategoryAssignmentSchema = z.strictObject({
67
+ /** The engine category's id: an `EngineResourceSubDomain` value such as `'notifications'`. */
68
+ engineCategory: z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/).max(100),
69
+ resourceNames: ApiReferenceAssignedResourceNamesSchema,
70
+ });
71
+ export type ApiReferenceEngineCategoryAssignment = z.infer<typeof ApiReferenceEngineCategoryAssignmentSchema>;
72
+
73
+ /**
74
+ * One entry of `apiReferenceResourceCategories`: an application category, or application resources filed into an
75
+ * engine category. The companion rejects a duplicate, stale or missing assignment whenever this feature is configured.
76
+ */
77
+ export const ApiReferenceResourceCategoryAssignmentSchema = z.union([
78
+ ApiReferenceApplicationCategoryAssignmentSchema,
79
+ ApiReferenceEngineCategoryAssignmentSchema,
80
+ ]);
44
81
  export type ApiReferenceResourceCategoryAssignment = z.infer<typeof ApiReferenceResourceCategoryAssignmentSchema>;
45
82
 
83
+ /** Whether an assignment files resources into an ENGINE category rather than declaring an application one. */
84
+ export function isApiReferenceEngineCategoryAssignment(
85
+ assignment: ApiReferenceResourceCategoryAssignment,
86
+ ): assignment is ApiReferenceEngineCategoryAssignment {
87
+ return 'engineCategory' in assignment;
88
+ }
89
+
46
90
  /**
47
91
  * Per-service technical-documentation configuration block.
48
92
  *
@@ -137,13 +181,23 @@ export const WildoTechnicalDocConfigSchema = z.strictObject({
137
181
  ]).optional(),
138
182
 
139
183
  /**
140
- * Explicit source-owned grouping for the generated API reference.
184
+ * How the API reference groups the APPLICATION's own resources.
185
+ *
186
+ * There is one category vocabulary for the engine, and the engine applies it: every engine resource is grouped by
187
+ * the sub-domain its own specification declares (`EngineResourceSubDomain`), and this config cannot move one. Each
188
+ * entry here either declares an application category (`id`, `label`, `description`) or files application
189
+ * resources into an engine category (`engineCategory`). Undeclared, application resources render as unclassified.
190
+ *
191
+ * Once declared, every published resource must end up in exactly one category, here or from the engine, and the
192
+ * companion refuses publication otherwise. It also refuses:
193
+ * - an entry naming an ENGINE resource. Re-filing engine resources is what fragmented the reference into
194
+ * near-duplicate pairs ("Notifications and webhooks" beside "Notifications", #1840): every engine resource added
195
+ * after the list was written fell into the engine's group beside the application's twin of it;
196
+ * - an application category whose id or label is an engine category's;
197
+ * - an `engineCategory` that is not an `EngineResourceSubDomain` value.
141
198
  *
142
- * Omit this only when an application deliberately has no API taxonomy yet.
143
- * When present, it must classify every published resource exactly once:
144
- * categories cannot silently drift as framework or application resources are
145
- * added or removed. The category facts become `tags[].x-wildo.category` in
146
- * the canonical OpenAPI document and are consumed by the generic renderer.
199
+ * The category facts become `tags[].x-wildo.category` in the canonical OpenAPI document and are consumed by the
200
+ * generic renderer.
147
201
  */
148
202
  apiReferenceResourceCategories: z.array(ApiReferenceResourceCategoryAssignmentSchema).min(1).optional(),
149
203
 
@@ -200,9 +254,9 @@ export const WildoTechnicalDocConfigSchema = z.strictObject({
200
254
  * the bundle is served from a static host that bypasses nginx).
201
255
  *
202
256
  * Typed against `WildoCspConfigSchema` from
203
- * `@wildo-ai/platform-config-lib` (auth-hardening Slice B B-Step 1).
257
+ * `@wildo-ai/platform-config-lib`.
204
258
  * The parsed value is consumed by the build-time generator at
205
- * `platform-config-lib/src/project-config/shared/csp-emit.ts` (Slice B B-Step 3)
259
+ * `platform-config-lib/src/project-config/shared/csp-emit.ts`,
206
260
  * which produces the per-app nginx `add_header` line and the
207
261
  * `<meta http-equiv>` tag for the Docusaurus build to inject.
208
262
  *
@@ -41,4 +41,14 @@ export const workspaceAvailableOrgRoles: Roles[] = [
41
41
  export const jobReadAndProgressRoles: Roles[] = ['FIELD_TECHNICIAN', CORE_ORG_ROLES.ORG_MEMBER];
42
42
  /** Quotes and invoices: office only. A technician holding only the field role is refused. */
43
43
  export const quoteAndInvoiceRoles: Roles[] = [CORE_ORG_ROLES.ORG_MEMBER];
44
+
45
+ /**
46
+ * 4. Who may GIVE the role needs no fourth place. An owner or administrator may grant a custom role whenever everything
47
+ * it confers is within their own role: its `inheritFrom` chain is on theirs, and every operation naming it admits
48
+ * them too, at the same row reach. Here the field role inherits `ORG_GUEST` and the one operation naming it also
49
+ * names `ORG_MEMBER`, so owners and administrators give it on the members screen and in invitations. Name the
50
+ * custom role ALONE on an operation administrators cannot call, or make it inherit `ORG_OWNER`, and only a role
51
+ * covering it may grant it, which for an organization role is the platform super-administrator. Who may write a
52
+ * membership at all is still that operation's own `roles` (`ORG_ADMIN` in the engine).
53
+ */
44
54
  ```
@@ -18,6 +18,8 @@ const backendModule: BackendDomainModule = {
18
18
  myWeekTasksByStatusChartDefinition, myWeekTasksByPriorityChartDefinition,
19
19
  // Org-wide todo analytics — surfaced on the Todos LIST host and the home dashboard.
20
20
  todosByStatusChartDefinition, todosByPriorityChartDefinition, todosCreatedTimelineChartDefinition,
21
+ // Org-wide todo FIGURES (KPI charts, #2299) — the home dashboard's KPI tiles.
22
+ todosInFlightChartDefinition, todosCompletedChartDefinition, todosCompletionRateChartDefinition,
21
23
  ],
22
24
  // Singleton config rows auto-seeded on resource lifecycle:
23
25
  // - M2M outbound webhook config (per ORG / per APP) — app-specific dev-listener
@@ -36,6 +38,10 @@ const backendModule: BackendDomainModule = {
36
38
  // A signed webhook from a client's system that creates a todo (#1596) — `POST /webhooks/app/todo-intake`;
37
39
  // and an email to an organization's address that creates one and answers on the thread (#1600, #1630).
38
40
  inboundHandlers: [todoIntakeInboundHandler, todoEmailIntakeHandler, todoEmailScreenedHandler, todoEmailScreeningHandler],
41
+ // NOT listed: `todoSmsStatusHandler` (`./inbound/todos.sms-status.inbound-channel-handler`, #3394), a member's todo
42
+ // status by text. An SMS channel handler stops the backend at startup while the SMS channel does not receive, and
43
+ // Your Application keeps the SMS capability off (no vendor account, 2026-10-02). Enabling SMS with a provider whose
44
+ // notification endpoint is served is the change that adds it here.
39
45
  };
40
46
 
41
47
  // NB: this module intentionally does not populate `customLabels`. The dev
@@ -0,0 +1,41 @@
1
+ # example.backend.custom-operation.declared-refusal-code
2
+
3
+
4
+ ## Usage Example
5
+
6
+ ```typescript
7
+ // The person reads the CODE's words (`errors_refusals.<code>.msg`); `reason` and the ids stay for the logs.
8
+ if (todo.status === Todos_Status.COMPLETED || todo.status === Todos_Status.CANCELLED) {
9
+ throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {
10
+ customMessageReference: ErrorCustomMessageReference.RESOURCE_STATUS_TRANSITION_CONFLICT,
11
+ context: { code: Todos_AutoResolveRefusalCode.ALREADY_SETTLED, reason: 'todo_already_settled', todoId: id, status: todo.status },
12
+ });
13
+ }
14
+ ```
15
+
16
+ ## Usage Example
17
+
18
+ ```typescript
19
+ /**
20
+ * Why `auto_resolve` refused to start: the code its refusal carries in `error.details.code` (#3066). The person reads
21
+ * each code's words (`errors_refusals.<code>.msg`, generated from the specification's `errorScenarios[].errorCode`),
22
+ * never the server's own text, which the client never shows.
23
+ */
24
+ export enum Todos_AutoResolveRefusalCode {
25
+ /** The todo is already completed or cancelled: there is nothing left to resolve. */
26
+ ALREADY_SETTLED = 'TODO_AUTO_RESOLVE_ALREADY_SETTLED',
27
+ /** An auto-resolve run for this todo is still open. */
28
+ ALREADY_RUNNING = 'TODO_AUTO_RESOLVE_ALREADY_RUNNING',
29
+ /** The todo records nobody to tell how the run ended. */
30
+ NOBODY_TO_TELL = 'TODO_AUTO_RESOLVE_NOBODY_TO_TELL',
31
+ }
32
+ ```
33
+
34
+ ## Usage Example
35
+
36
+ ```typescript
37
+ // Each code a refusal carries, declared with the sentence the person reads: the labelling pipeline writes it.
38
+ { code: HttpResponseStatusCode.CONFLICT_409, errorCode: Todos_AutoResolveRefusalCode.ALREADY_SETTLED, when: 'The todo is already completed or cancelled, so there is nothing left to resolve.' },
39
+ { code: HttpResponseStatusCode.CONFLICT_409, errorCode: Todos_AutoResolveRefusalCode.ALREADY_RUNNING, when: 'An auto-resolve run for this todo is still open. Wait for it to finish, or answer the approval it is waiting on.' },
40
+ { code: HttpResponseStatusCode.CONFLICT_409, errorCode: Todos_AutoResolveRefusalCode.NOBODY_TO_TELL, when: 'The todo records no creator and the request did not come from a person, so nobody could be told how the run ended. Start it from a person\'s account.' },
41
+ ```
@@ -0,0 +1,107 @@
1
+ # example.backend.custom-operation.external-effect-reservation
2
+
3
+
4
+ ## Usage Example
5
+
6
+ ```typescript
7
+ import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';
8
+ import {
9
+ createResourceCustomServiceImplementation,
10
+ reserveExternalEffect,
11
+ type ApplicationExternalEffectCompensator,
12
+ type InversifyContainer,
13
+ type ResourceCustomServiceImplementationFactory,
14
+ type ResourcesRegistryBackendService,
15
+ } from '@wildo-ai/saas-backend-lib';
16
+
17
+ /** In an application this comes from its shared-lib (`Crm_ResourceType`). */
18
+ export enum Crm_ResourceType {
19
+ CONTACTS = 'crmContacts',
20
+ }
21
+
22
+ /** The application's OWN compensation kinds: one per kind of object its operations create at another system. */
23
+ export enum Crm_ExternalEffectCompensation {
24
+ DELETE_VENDOR_CONTACT = 'crm_delete_vendor_contact',
25
+ }
26
+
27
+ /** The vendor's client, which the application binds in its container (`setupModuleBackendInjection`). */
28
+ export interface VendorContactsClient {
29
+ /** Creates the contact and answers the id the vendor minted. Throws `VendorContactRefused` when it created nothing. */
30
+ createContact(input: { name: string; email: string; externalReference: string }): Promise<{ id: string }>;
31
+ /** Deletes the contact. Answers normally when it is already gone. */
32
+ deleteContact(vendorContactId: string): Promise<void>;
33
+ }
34
+ export const VENDOR_CONTACTS_CLIENT = Symbol.for('crm.VendorContactsClient');
35
+
36
+ /** The vendor's refusal of a request it evaluated: nothing was created, so nothing is left to undo. */
37
+ export class VendorContactRefused extends Error {}
38
+
39
+ /**
40
+ * How each kind is undone, declared in a backend module: `externalEffectCompensators: crmExternalEffectCompensators`.
41
+ * The engine calls it when no contact row names the vendor contact once the operation ended. Total over the enum, so a
42
+ * kind added without its compensator fails to compile.
43
+ */
44
+ export const crmExternalEffectCompensators = {
45
+ [Crm_ExternalEffectCompensation.DELETE_VENDOR_CONTACT]: async (vendorContactId, { container }) => {
46
+ // Resolved on use: the module file is read before the container is populated.
47
+ await container.get<VendorContactsClient>(VENDOR_CONTACTS_CLIENT).deleteContact(vendorContactId);
48
+ },
49
+ } satisfies Record<Crm_ExternalEffectCompensation, ApplicationExternalEffectCompensator>;
50
+
51
+ const crmContactsCreateCustomImpl: ResourceCustomServiceImplementationFactory = (
52
+ resourcesRegistryService: ResourcesRegistryBackendService,
53
+ container: InversifyContainer,
54
+ ) => {
55
+ const operationPath = {
56
+ resourceIdentifier: Crm_ResourceType.CONTACTS,
57
+ operationIdentifier: CoreResourceOperation.CREATE,
58
+ variantType: ResourceOperationVariantType.API_CALL,
59
+ isOperationDefault: true,
60
+ };
61
+ const requestDtoSchema = resourcesRegistryService.getRequestDtoFromPath(operationPath);
62
+ const responseDtoSchema = resourcesRegistryService.getResponseDtoFromPath(operationPath);
63
+
64
+ return createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({
65
+ operationPath,
66
+ requestDtoSchema,
67
+ responseDtoSchema,
68
+ handlers: {
69
+ prefixCoreOperations: async (_id, input, _executionContext, _operationPath, utils) => {
70
+ const vendor = container.get<VendorContactsClient>(VENDOR_CONTACTS_CLIENT);
71
+ const contact = input as { name: string; email: string };
72
+ // 1. Reserve BEFORE the call, naming the evidence that the operation landed: a contact row whose
73
+ // `vendorContactId` holds the vendor's id. No reservation, no call: this throws when it cannot be written.
74
+ const reservation = await reserveExternalEffect(utils, {
75
+ applicationCompensationKind: Crm_ExternalEffectCompensation.DELETE_VENDOR_CONTACT,
76
+ operationResourceType: Crm_ResourceType.CONTACTS,
77
+ operationIdentifier: CoreResourceOperation.CREATE,
78
+ ownerResourceType: Crm_ResourceType.CONTACTS,
79
+ ownerField: 'vendorContactId',
80
+ });
81
+ let created: { id: string };
82
+ try {
83
+ // The vendor keeps the reservation id, so a contact whose reply was lost can be found there again.
84
+ created = await vendor.createContact({ name: contact.name, email: contact.email, externalReference: reservation.reservationId });
85
+ } catch (error) {
86
+ // 2. A refusal the vendor evaluated created nothing: release. Any other failure may have created it: keep it.
87
+ if (error instanceof VendorContactRefused) await reservation.release();
88
+ throw error;
89
+ }
90
+ try {
91
+ // 3. Record the vendor's id the moment it answered.
92
+ await reservation.identify(created.id);
93
+ } catch (error) {
94
+ // The contact exists and its id could not be recorded: undo it now, while its id is still known here.
95
+ await vendor.deleteContact(created.id).then(() => reservation.release(), () => undefined);
96
+ throw error;
97
+ }
98
+ // 4. The row's write names it. The engine settles the reservation when the operation ends: a row naming the
99
+ // contact keeps it; none (a refused write, a lost commit, a stopped process) has it deleted at the vendor.
100
+ return { vendorContactId: created.id };
101
+ },
102
+ },
103
+ });
104
+ };
105
+
106
+ export default crmContactsCreateCustomImpl;
107
+ ```
@@ -33,12 +33,14 @@ export const blueprintDefinition = {
33
33
  { file: 'shared-lib/src/engine/features.ts', declaration: 'FEATURE_PROFILES', path: [] },
34
34
  ],
35
35
  },
36
- // The group's organization type replaces the base type `wildo/internal-tool` marked as the owner, and the group's
37
- // ORGANIZATIONS entry replaces the `enabled: true` it set.
36
+ // The group's organization type replaces the base type `wildo/internal-tool` marked as the owner, the group's
37
+ // ORGANIZATIONS entry replaces the `enabled: true` it set, and the group's user types replace the base `member` whose
38
+ // registration it closed to invitations (#3037): `employee` is invitation-only too.
38
39
  overrides: {
39
40
  declarations: [
40
41
  { file: 'wildo.saas.config.ts', path: ['organizationTypes'] },
41
42
  { file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.ORGANIZATIONS'] },
43
+ { file: 'backend-api/src/saas-config.backend.ts', path: ['userTypes'] },
42
44
  ],
43
45
  },
44
46
  } satisfies BlueprintDefinitionInput;
@@ -192,11 +192,10 @@ export const moduleBackend_FlowsActorsRegistry: {
192
192
  // owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
193
193
  // DTO coerces the ISO `dueDate` string to a Date at the service boundary.
194
194
  //
195
- // `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
196
- // resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
197
- // to select a variant — omitting it fails with "no matching discriminator". The assistant only
198
- // creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
199
- // use a literal so the model cannot select the recurring variant, whose extra fields
195
+ // `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
196
+ // resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
197
+ // left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
198
+ // states that: the model cannot select the recurring variant, whose extra fields
200
199
  // (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
201
200
  // defaulted (not merely optional) so they are always present for the discriminated base branch.
202
201
  resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
@@ -215,6 +214,10 @@ export const moduleBackend_FlowsActorsRegistry: {
215
214
  .describe('Always "one_time"; the assistant creates non-recurring todos.'),
216
215
  dueDate: z.string().optional()
217
216
  .describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
217
+ // The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
218
+ // and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
219
+ // lost answer does not add a second todo. Optional, like the operation's key.
220
+ idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
218
221
  }),
219
222
  }),
220
223
  // WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
@@ -16,8 +16,8 @@ export default defineInfraEnvConfig({
16
16
  // `{ accessTokenExpirationMinutes: 60, refreshTokenExpirationDays: 30 }`
17
17
  // \u2014 byte-for-byte equal to the THEN-CURRENT `WildoAuthConfigSchema`
18
18
  // defaults, which is author-noise per the framework-mindset principle
19
- // documented on `production/wildo.infra.remote.config.ts`. With Auth-
20
- // hardening Slice A Step 5 lowering the access-token default to 15 min,
19
+ // documented on `production/wildo.infra.remote.config.ts`. With the
20
+ // access-token default lowered to 15 min (2026-04-13),
21
21
  // local dev now inherits the tighter posture too: an XSS bug in dev only
22
22
  // exposes a 15-min access-token window (the refresh loop rotates
23
23
  // transparently via the `__wildo_refresh` cookie, so developers see no
@@ -125,7 +125,7 @@ export default defineInfraEnvConfig({
125
125
  },
126
126
 
127
127
  /**
128
- * OTLP telemetry (Slice 2 Phase 5) — local verification against the in-compose
128
+ * OTLP telemetry — local verification against the in-compose
129
129
  * `otel-collector` (published on `localhost:4318`). `enabled` → `OTEL_ENABLED` + the
130
130
  * `--import @wildo-ai/saas-backend-lib/otel-preload` wiring; `endpoint` →
131
131
  * `OTEL_EXPORTER_OTLP_ENDPOINT`. No provider auth here — the local collector needs none
@@ -158,12 +158,14 @@ export default defineInfraEnvConfig({
158
158
  },
159
159
 
160
160
  /**
161
- * Env-layer docs CSP override (`auth-hardening.md` B-2C).
161
+ * Env-layer CSP additions, one block per frontend (`app`, `docs`, `website`).
162
162
  *
163
- * This is the per-env origin the docs frontend is allowed to fetch for
164
- * auth handoff + OpenAPI runtime calls. The app-static posture
165
- * (`enabled`, `reportOnly`) lives in `technical-doc/wildo.tech-doc.config.ts`;
166
- * this env layer only supplies the local backend origin.
163
+ * Each admits the local backend origin in `connect-src`: the app calls its
164
+ * API, the docs site fetches it for auth handoff and OpenAPI runtime calls,
165
+ * and the website posts its forms to it. The static posture (`enabled`,
166
+ * `reportOnly`) lives with each frontend: the app's in `wildo.saas.config.ts`,
167
+ * the docs site's in `technical-doc/wildo.tech-doc.config.ts`, the website's in
168
+ * `website/wildo.website.config.ts`. This env layer only supplies origins.
167
169
  */
168
170
  csp: {
169
171
  app: {
@@ -214,9 +216,9 @@ export default defineInfraEnvConfig({
214
216
  * The content-safety classifier is `azure-content-safety` pointed at the provider-simulators double on this machine
215
217
  * (#2991): its host slot `AZURE_CONTENT_SAFETY_HOST` holds `127.0.0.1:18309` and its key the double's own, both in
216
218
  * `secrets.json`, never here. The engine reaches a loopback host only in a development or test environment, so this
217
- * selection cannot carry the double's address anywhere else. Run the double with
218
- * `CONTENT_SAFETY_MOCK_PORT=18309 pnpm -C ../../platform/testing/provider-simulators mock:content-safety`; without it,
219
- * the guarded agents answer that their content could not be screened.
219
+ * selection cannot carry the double's address anywhere else. The double is the content-safety simulator of
220
+ * `@wildo-ai/provider-simulators`, listening on that port; without a service answering there, the guarded agents
221
+ * answer that their content could not be screened.
220
222
  */
221
223
  [EngineCapability.AI_CONTENT_SAFETY]: {
222
224
  primary: 'azure-content-safety',
@@ -267,61 +269,6 @@ export default defineInfraEnvConfig({
267
269
  silent: false,
268
270
  },
269
271
 
270
- /**
271
- * WHERE each declared system of record is, in THIS environment (#1055).
272
- *
273
- * `odoo` is declared ABSENT, and that is the true statement: this machine has no Odoo. Every read
274
- * of `billableServices` answers **409 `SYSTEM_OF_RECORD_UNAVAILABLE_IN_ENVIRONMENT`** — a code a
275
- * client can branch on — rather than a transport error against an address nobody is listening on.
276
- *
277
- * ## It carried the E2E double's address for one day, and why it does not any more
278
- *
279
- * `a4c48797d` (2026-09-21) pointed this at `127.0.0.1:18069`, the read-through lane's own double.
280
- * That was the ONLY way the lane could run past its preflight: a lane driving an ALREADY-RUNNING
281
- * application cannot set deployment configuration, so the address had to be committed. It worked —
282
- * #590 ran end to end for the first time, and #1058's partition confinement was proven on a real
283
- * stack (`e7f2ab6ff`).
284
- *
285
- * It is reverted because of what it cost everyone else. The dependency splits in two and only one
286
- * half is on demand:
287
- *
288
- * - `billableServices` is READ-THROUGH, so it needs Odoo only while a read happens — and the lane
289
- * spawns its own double and reaps it. Self-sufficient.
290
- * - `externalCustomers` is a PIPELINE with `scheduleCron: '0 * * * *'`, so it dialled this address
291
- * every hour whether or not anyone was testing. Measured at `11:00:00.779Z` on 2026-09-22:
292
- * `pipeline 'externalCustomers' failed: HTTP-API network failure … fetch failed`, and it would
293
- * have repeated identically forever, on every developer's machine.
294
- *
295
- * An hourly failure for a condition nobody intends to fix is a warning people learn to skip, and
296
- * they take that habit to the warnings that matter. Decided in #1476; the engine-side
297
- * miscalibration (warn hourly rather than back off) is #1475.
298
- *
299
- * ## What this does NOT change
300
- *
301
- * `partition: true` stays on the INSTANCE in `wildo.saas.config.ts`, and that is the D2 split
302
- * working rather than a leftover: how a deployment's data is shaped is a property of the
303
- * declaration (WHAT), and whether this machine can reach it is a property of the environment
304
- * (WHERE). A machine with no Odoo still knows its Odoo is partitioned by company.
305
- *
306
- * An absent declaration is still refused at boot. "No access here" and "somebody forgot to author
307
- * the address" need opposite behaviours and silence cannot be either — so a machine that genuinely
308
- * has no Odoo writes `{ enabled: false }`, rather than deleting the key.
309
- *
310
- * ## To run the read-through lane, or to use a REAL Odoo
311
- *
312
- * For the LANE: put the double's address back — `baseUrl: 'http://127.0.0.1:18069'`,
313
- * `database: 'wildo_e2e'`, `login: 'e2e@wildo.test'` (`ODOO_SIMULATOR_CREDENTIALS` from
314
- * `@wildo-ai/engine-behavior-e2e`) — then `wildo config sync --local --domain env-files` and
315
- * restart. Expect the hourly pipeline failure above for as long as it is there.
316
- *
317
- * For a REAL Odoo: the same three values pointed at that instance, with its key in `secrets.json`
318
- * under `systemsOfRecordEnv.WILDO_SOR_ODOO__API_KEY`. The derived environment variable names
319
- * (`WILDO_SOR_ODOO__BASE_URL` and siblings) are never authored — they come from the instance name.
320
- */
321
- systemsOfRecord: {
322
- odoo: { enabled: false },
323
- },
324
-
325
272
  devCompanion: {
326
273
  // Loopback ONLY (meta-workflows P-29): the companion API hosts
327
274
  // endpoints that spend money and execute code (coding-agent dispatch),
@@ -168,5 +168,6 @@ export const specificationsCompanionExports: SpecificationsCompanionExports<
168
168
  * reports a vendor-hosted provider a runtime selects that is not named here.
169
169
  */
170
170
  processorRegister: applicationProcessorRegister,
171
+ translationGlossary,
171
172
  };
172
173
  ```
@@ -4,44 +4,44 @@
4
4
  ## Usage Example
5
5
 
6
6
  ```typescript
7
- // The SUBJECT edge: scope, routing and lifecycle. `allowCycle` because of the operator edge below.
8
- createResourcesRelationship(
9
- CoreResourceType.USERS, TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS,
10
- ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
11
- {
12
- nature: RelationshipNature.COMPOSITION,
13
- isPrimaryScope: true,
14
- foreignKeyField: 'userId',
15
- allowCycle: true,
16
- parentResourceRequirement: ResourceParentResourceRequirement.MANDATORY,
17
- accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT,
18
- childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
19
- contextPolicy: {},
20
- }
21
- ),
7
+ // The SUBJECT edge: scope, routing and lifecycle.
8
+ createResourcesRelationship(
9
+ CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
10
+ ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
11
+ {
12
+ nature: RelationshipNature.COMPOSITION,
13
+ isPrimaryScope: true,
14
+ foreignKeyField: 'userId',
15
+ parentResourceRequirement: ResourceParentResourceRequirement.MANDATORY,
16
+ accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT,
17
+ childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
18
+ contextPolicy: {},
19
+ }
20
+ ),
22
21
  ```
23
22
 
24
23
  ## Usage Example
25
24
 
26
25
  ```typescript
27
- // The OPERATOR edge: a second FK to the resource type that already owns this resource's scope.
28
- // Evidence only — never a scope path, never a nested route. Both edges carry `allowCycle`.
29
- createResourcesRelationship(
30
- TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS, CoreResourceType.USERS,
31
- ResourceRelationshipCardinality.MANY, ResourceRelationshipCardinality.ONE,
32
- {
33
- nature: RelationshipNature.REFERENCE,
34
- foreignKeyField: 'requestedByUserId',
35
- allowCycle: true,
36
- parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
37
- accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.STANDALONE,
38
- contextPolicy: {
39
- objectMode: ContextPolicy_ObjectMode.SUMMARY,
40
- operationOverrides: {
41
- [CoreResourceOperation.LIST]: { enabled: false },
42
- [CoreResourceOperation.SEARCH]: { enabled: false },
43
- },
44
- },
45
- }
46
- ),
26
+ // The OPERATOR edge: a second FK to the resource type that already owns this resource's scope, declared in the
27
+ // same PARENT direction. Evidence only — never a scope path, never a nested route, never a teardown.
28
+ createResourcesRelationship(
29
+ CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
30
+ ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
31
+ {
32
+ nature: RelationshipNature.REFERENCE,
33
+ foreignKeyField: 'requestedByUserId',
34
+ parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
35
+ accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.STANDALONE,
36
+ // Erasing the operator leaves the request exactly as it is: it is the controller's evidence of who acted.
37
+ childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
38
+ contextPolicy: {
39
+ objectMode: ContextPolicy_ObjectMode.SUMMARY,
40
+ operationOverrides: {
41
+ [CoreResourceOperation.LIST]: { enabled: false },
42
+ [CoreResourceOperation.SEARCH]: { enabled: false },
43
+ },
44
+ },
45
+ }
46
+ ),
47
47
  ```
@@ -0,0 +1,47 @@
1
+ # example.navigation.one-entry-per-concept
2
+
3
+
4
+ ## Usage Example
5
+
6
+ ```tsx
7
+ /**
8
+ * Suppliers — the ONE place the application's navigation sends a person for a supplier (#3066).
9
+ *
10
+ * The group keeps each supplier twice, for reasons a person should never have to know: a COPY in the application
11
+ * (`supplierDirectory`, refreshed from the ERP by a scheduled pipeline, carrying procurement's assessment, and the row a
12
+ * purchase request names) and the ERP's own record READ THROUGH live (`suppliers`, where a new supplier is onboarded).
13
+ * Two sidebar entries side by side, "Supplier Directory" and "Suppliers", left everyone guessing which one to use and
14
+ * why a supplier was in one and not the other. So the navigation names the concept once and this view shows:
15
+ *
16
+ * | block | for whom | what it is for |
17
+ * |---|---|---|
18
+ * | `directory` | every employee | the suppliers the group buys from, with procurement's standing on each: the list a requester chooses from |
19
+ * | `erpRecords` | who may read the ERP's suppliers (the procurement office) | the ERP's record as it stands now, and onboarding a new supplier into the ERP |
20
+ *
21
+ * The second block is drawn only for a reader the backend lets read the ERP (`useViewerMayPerformResourceOperation`),
22
+ * so a requester sees one list and never a refusal. Words: `composite_views.app.suppliers-overview.*`.
23
+ */
24
+ export function SuppliersCompositeView(): React.JSX.Element {
25
+ const readsErp = useViewerMayPerformResourceOperation({
26
+ resourceType: Suppliers_ResourceType.SUPPLIERS,
27
+ operationIdentifier: CoreResourceOperation.LIST,
28
+ });
29
+ return (
30
+ <CompositeLayout>
31
+ <SupplierList name="directory" resourceType={Suppliers_ResourceType.SUPPLIER_DIRECTORY} />
32
+ {readsErp && <SupplierList name="erpRecords" resourceType={Suppliers_ResourceType.SUPPLIERS} />}
33
+ </CompositeLayout>
34
+ );
35
+ }
36
+ ```
37
+
38
+ ## Usage Example
39
+
40
+ ```typescript
41
+ children: [
42
+ {
43
+ kind: LauncherItemTargetKind.VIEW,
44
+ viewRef: SUPPLIERS_OVERVIEW_VIEW_REF,
45
+ },
46
+ ],
47
+ ```
@@ -0,0 +1,18 @@
1
+ # example.organization-identity.system-of-record-partitions
2
+
3
+
4
+ ## Usage Example
5
+
6
+ ```typescript
7
+ /**
8
+ * Each subsidiary's company in the group's ERP, assigned to the subsidiary's unit (#3066). Odoo partitions its suppliers
9
+ * and orders by company, and a company assigned to no unit loads none of them: on a fresh environment the supplier
10
+ * directory held only the supplier shared by the whole group. A buyer confined to one subsidiary then reads that
11
+ * subsidiary's suppliers and the shared ones.
12
+ */
13
+ systemOfRecordPartitions: [
14
+ { system: GROUP_ERP_INSTANCE, remoteKey: GROUP_ERP_COMPANY_KEYS.MANUFACTURING, unitKey: 'MFG' },
15
+ { system: GROUP_ERP_INSTANCE, remoteKey: GROUP_ERP_COMPANY_KEYS.RETAIL, unitKey: 'RETAIL' },
16
+ { system: GROUP_ERP_INSTANCE, remoteKey: GROUP_ERP_COMPANY_KEYS.SERVICES, unitKey: 'SERVICES' },
17
+ ],
18
+ ```