@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
@@ -0,0 +1,276 @@
1
+ # Reserving an object your operation creates at another system
2
+
3
+ Read this when a custom implementation creates something at another system (a contact in a CRM, a calendar event,
4
+ a payment object) BEFORE its operation's own write: in `prefixCoreOperations`, or in `beforeTransactionalCore`.
5
+
6
+ The call cannot be part of the database transaction. So when the write then fails, the process stops, or the commit's
7
+ outcome is unknown, the object stays at the vendor and no row names it. Nothing in your operation can see that happen,
8
+ because in most of those cases your code is no longer running.
9
+
10
+ ## The pattern
11
+
12
+ 1. **Reserve before the call** with `reserveExternalEffect(utils, { applicationCompensationKind, … })`, from
13
+ `@wildo-ai/saas-backend-lib`. It writes a reservation in its own write, outside the transaction, naming the evidence
14
+ that the operation landed: a row of `ownerResourceType` whose `ownerField` holds the vendor's id. When it cannot be
15
+ written it throws, and you make no call.
16
+ 2. **Make the call.** When the vendor lets you choose the object's id, derive it from
17
+ `mintExternalEffectReservationId()` and pass both `reservationId` and `providerObjectId` when reserving. Otherwise give
18
+ the vendor the reservation id where it keeps your references (metadata, an external reference field), so an object
19
+ whose reply was lost can be found there again.
20
+ 3. **Record the vendor's id** with `reservation.identify(id)` the moment it answers. If that throws, undo the object
21
+ yourself at once, while you still hold its id, then `release()`. A reservation whose id was never recorded (the
22
+ vendor's reply was lost) cannot be undone by the engine: it is reported at every sweep with its reservation id, so it
23
+ can be found at the vendor by the reference you gave it, and dropped after seven days.
24
+ 4. **Release on a refusal that created nothing.** A refusal the vendor evaluated (a 4xx answer) leaves nothing to undo:
25
+ call `reservation.release()`. Never release on a timeout or a network error: the object may exist.
26
+ 5. **Return the id in the row's input** (`return { vendorContactId: id }`). The row's write is the evidence.
27
+
28
+ The engine then settles the reservation when the operation ends, and a sweep settles what is left after fifteen
29
+ minutes. A row naming the object keeps it. No row (a refused write, a lost commit, a stopped process) means the object is
30
+ undone with your compensator. A failed compensation keeps the reservation, and the next settlement tries again.
31
+
32
+ ## Your compensation kinds
33
+
34
+ Name each kind of vendor object your operations create in an enum your application owns, and declare how each is undone
35
+ in a backend module:
36
+
37
+ - the module's `externalEffectCompensators` maps each kind to an `ApplicationExternalEffectCompensator`, written
38
+ `satisfies Record<MyKind, ApplicationExternalEffectCompensator>` so a kind added without one fails to compile;
39
+ - a compensator receives the vendor's id and `{ container, reservationId }`. Resolve the vendor's client from the
40
+ container inside it: the module file is read before the container is populated;
41
+ - it is idempotent: an object already gone is the state asked for, so treat the vendor's "not found" as done. Throw on
42
+ any other failure;
43
+ - one module declares a kind. Two modules declaring the same kind are refused at startup, naming both;
44
+ - a reservation naming a kind no module declares is refused before anything is written or the vendor is called. A
45
+ reservation whose kind the running application no longer declares is kept and reported at every sweep (the run counts
46
+ it as `compensator_undeclared`), never dropped, so removing a kind while reservations of it are pending leaves them
47
+ waiting for it.
48
+
49
+ ## What it does not do
50
+
51
+ - It does not undo an object a row DOES name. A later delete of the row is your operation's own business (a DELETE
52
+ prefix, or the row-as-outbox pattern in `after-the-operation.md`).
53
+ - It is not a retry. If the object must exist, record the intent on the row and let a minion create it
54
+ (`after-the-operation.md`); a reservation only removes what should not exist.
55
+ - Fifteen minutes is a time, not a link to your running code. An operation still running after that long could have its
56
+ object undone before it saves.
57
+
58
+ ## Worked example
59
+
60
+ A contact mirrored to a vendor CRM: the application's kind, its compensator, and the CREATE prefix that reserves.
61
+
62
+
63
+ ## Usage Example
64
+
65
+ ```typescript
66
+ import { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';
67
+ import {
68
+ createResourceCustomServiceImplementation,
69
+ reserveExternalEffect,
70
+ type ApplicationExternalEffectCompensator,
71
+ type InversifyContainer,
72
+ type ResourceCustomServiceImplementationFactory,
73
+ type ResourcesRegistryBackendService,
74
+ } from '@wildo-ai/saas-backend-lib';
75
+
76
+ /** In an application this comes from its shared-lib (`Crm_ResourceType`). */
77
+ export enum Crm_ResourceType {
78
+ CONTACTS = 'crmContacts',
79
+ }
80
+
81
+ /** The application's OWN compensation kinds: one per kind of object its operations create at another system. */
82
+ export enum Crm_ExternalEffectCompensation {
83
+ DELETE_VENDOR_CONTACT = 'crm_delete_vendor_contact',
84
+ }
85
+
86
+ /** The vendor's client, which the application binds in its container (`setupModuleBackendInjection`). */
87
+ export interface VendorContactsClient {
88
+ /** Creates the contact and answers the id the vendor minted. Throws `VendorContactRefused` when it created nothing. */
89
+ createContact(input: { name: string; email: string; externalReference: string }): Promise<{ id: string }>;
90
+ /** Deletes the contact. Answers normally when it is already gone. */
91
+ deleteContact(vendorContactId: string): Promise<void>;
92
+ }
93
+ export const VENDOR_CONTACTS_CLIENT = Symbol.for('crm.VendorContactsClient');
94
+
95
+ /** The vendor's refusal of a request it evaluated: nothing was created, so nothing is left to undo. */
96
+ export class VendorContactRefused extends Error {}
97
+
98
+ /**
99
+ * How each kind is undone, declared in a backend module: `externalEffectCompensators: crmExternalEffectCompensators`.
100
+ * The engine calls it when no contact row names the vendor contact once the operation ended. Total over the enum, so a
101
+ * kind added without its compensator fails to compile.
102
+ */
103
+ export const crmExternalEffectCompensators = {
104
+ [Crm_ExternalEffectCompensation.DELETE_VENDOR_CONTACT]: async (vendorContactId, { container }) => {
105
+ // Resolved on use: the module file is read before the container is populated.
106
+ await container.get<VendorContactsClient>(VENDOR_CONTACTS_CLIENT).deleteContact(vendorContactId);
107
+ },
108
+ } satisfies Record<Crm_ExternalEffectCompensation, ApplicationExternalEffectCompensator>;
109
+
110
+ const crmContactsCreateCustomImpl: ResourceCustomServiceImplementationFactory = (
111
+ resourcesRegistryService: ResourcesRegistryBackendService,
112
+ container: InversifyContainer,
113
+ ) => {
114
+ const operationPath = {
115
+ resourceIdentifier: Crm_ResourceType.CONTACTS,
116
+ operationIdentifier: CoreResourceOperation.CREATE,
117
+ variantType: ResourceOperationVariantType.API_CALL,
118
+ isOperationDefault: true,
119
+ };
120
+ const requestDtoSchema = resourcesRegistryService.getRequestDtoFromPath(operationPath);
121
+ const responseDtoSchema = resourcesRegistryService.getResponseDtoFromPath(operationPath);
122
+
123
+ return createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({
124
+ operationPath,
125
+ requestDtoSchema,
126
+ responseDtoSchema,
127
+ handlers: {
128
+ prefixCoreOperations: async (_id, input, _executionContext, _operationPath, utils) => {
129
+ const vendor = container.get<VendorContactsClient>(VENDOR_CONTACTS_CLIENT);
130
+ const contact = input as { name: string; email: string };
131
+ // 1. Reserve BEFORE the call, naming the evidence that the operation landed: a contact row whose
132
+ // `vendorContactId` holds the vendor's id. No reservation, no call: this throws when it cannot be written.
133
+ const reservation = await reserveExternalEffect(utils, {
134
+ applicationCompensationKind: Crm_ExternalEffectCompensation.DELETE_VENDOR_CONTACT,
135
+ operationResourceType: Crm_ResourceType.CONTACTS,
136
+ operationIdentifier: CoreResourceOperation.CREATE,
137
+ ownerResourceType: Crm_ResourceType.CONTACTS,
138
+ ownerField: 'vendorContactId',
139
+ });
140
+ let created: { id: string };
141
+ try {
142
+ // The vendor keeps the reservation id, so a contact whose reply was lost can be found there again.
143
+ created = await vendor.createContact({ name: contact.name, email: contact.email, externalReference: reservation.reservationId });
144
+ } catch (error) {
145
+ // 2. A refusal the vendor evaluated created nothing: release. Any other failure may have created it: keep it.
146
+ if (error instanceof VendorContactRefused) await reservation.release();
147
+ throw error;
148
+ }
149
+ try {
150
+ // 3. Record the vendor's id the moment it answered.
151
+ await reservation.identify(created.id);
152
+ } catch (error) {
153
+ // The contact exists and its id could not be recorded: undo it now, while its id is still known here.
154
+ await vendor.deleteContact(created.id).then(() => reservation.release(), () => undefined);
155
+ throw error;
156
+ }
157
+ // 4. The row's write names it. The engine settles the reservation when the operation ends: a row naming the
158
+ // contact keeps it; none (a refused write, a lost commit, a stopped process) has it deleted at the vendor.
159
+ return { vendorContactId: created.id };
160
+ },
161
+ },
162
+ });
163
+ };
164
+
165
+ export default crmContactsCreateCustomImpl;
166
+ ```
167
+
168
+ ## The contract
169
+
170
+ ## Import Origins
171
+
172
+ - `@wildo-ai/saas-backend-lib`
173
+
174
+ ## Source Excerpts
175
+
176
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
177
+
178
+ ```typescript
179
+ /** The provider metadata key a reserved object carries when its provider mints the id, so a lost one can be found. */
180
+ export const EXTERNAL_EFFECT_RESERVATION_METADATA_KEY = 'wildoExternalEffectReservation';
181
+ ```
182
+
183
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
184
+
185
+ ```typescript
186
+ /** What an application's compensator is given beside the object's id. */
187
+ export interface ApplicationExternalEffectCompensationContext {
188
+ /**
189
+ * The application's container, to resolve the client that undoes the object. Resolve it here, on use: the compensator
190
+ * is declared in a module file, before the container is populated.
191
+ */
192
+ readonly container: Container;
193
+ /** The reservation being settled, for the application's logs. */
194
+ readonly reservationId: string;
195
+ }
196
+
197
+ /**
198
+ * Undo ONE provider object an application's operation created, by its id. Idempotent: an object already gone is the state
199
+ * asked for, so treat the provider's "not found" as done. Throw on any other failure: the reservation is kept and the next
200
+ * settlement calls it again.
201
+ */
202
+ export type ApplicationExternalEffectCompensator = (providerObjectId: string, context: ApplicationExternalEffectCompensationContext) => Promise<void>;
203
+
204
+ /**
205
+ * An application's compensators, keyed by its OWN compensation kinds: declared in a backend module's
206
+ * `externalEffectCompensators`. Key it by an enum the application owns, and write it `satisfies Record<MyKind, …>` so a kind
207
+ * added without its compensator fails to compile.
208
+ */
209
+ export type ApplicationExternalEffectCompensators = Readonly<Record<string, ApplicationExternalEffectCompensator>>;
210
+ ```
211
+
212
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
213
+
214
+ ```typescript
215
+ /** What every reservation declares before its provider call, whoever undoes it. */
216
+ export interface ExternalEffectReservationRequestBase {
217
+ /** The operation reserving it, for the logs. */
218
+ readonly operationResourceType: string;
219
+ readonly operationIdentifier: string;
220
+ /** The resource and field whose row names the object once the operation landed. */
221
+ readonly ownerResourceType: string;
222
+ readonly ownerField: string;
223
+ /** The reservation id, when the caller derived the provider object's id from it before reserving. */
224
+ readonly reservationId?: string;
225
+ /** The object's id, when the caller chose it (derived from {@link reservationId}); else recorded with `identify`. */
226
+ readonly providerObjectId?: string;
227
+ }
228
+
229
+ /** A reservation the ENGINE undoes, by one of its own kinds. */
230
+ export interface EngineExternalEffectReservationRequest extends ExternalEffectReservationRequestBase {
231
+ readonly kind: EngineExternalEffectCompensationKind;
232
+ /** None: an engine kind names no application kind (a reservation row carries null here). */
233
+ readonly applicationCompensationKind?: null;
234
+ }
235
+
236
+ /**
237
+ * A reservation the APPLICATION undoes (#3446): `applicationCompensationKind` is a key of a backend module's
238
+ * `externalEffectCompensators`. A kind no module declares is refused before anything is written.
239
+ */
240
+ export interface ApplicationExternalEffectReservationRequest extends ExternalEffectReservationRequestBase {
241
+ readonly applicationCompensationKind: string;
242
+ readonly kind?: never;
243
+ }
244
+
245
+ /** What a prefix declares before its provider call. */
246
+ export type ExternalEffectReservationRequest = EngineExternalEffectReservationRequest | ApplicationExternalEffectReservationRequest;
247
+
248
+ /** What the prefix holds after reserving. */
249
+ export interface ExternalEffectReservationHandle {
250
+ readonly reservationId: string;
251
+ /** Record the id the provider minted, as soon as it answered. Throws when the store refuses. */
252
+ identify(providerObjectId: string): Promise<void>;
253
+ /** Delete the reservation: the provider call certainly created nothing. Never throws; a reservation left is settled later. */
254
+ release(): Promise<void>;
255
+ }
256
+
257
+ /** Mint a reservation id before reserving, so a provider object's id can be derived from it: 24 hex characters, safe inside one. */
258
+ export function mintExternalEffectReservationId(): string {
259
+ return randomBytes(12).toString('hex');
260
+ }
261
+ ```
262
+
263
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
264
+
265
+ ```typescript
266
+ /**
267
+ * Record an external effect BEFORE making it (#3441). Written in its own write, never in a transaction, so it survives the
268
+ * failure it exists for. Throws when the store refuses, and the caller must then make no provider call. A custom
269
+ * implementation passes its `utils`, which carry both dependencies. An `applicationCompensationKind` no backend module
270
+ * declares is refused here, before anything is written (#3446).
271
+ */
272
+ export async function reserveExternalEffect(
273
+ deps: { readonly repositoriesRegistry: ApplicationRepositoriesRegistry; readonly logger: ExternalEffectReservationDeps['logger'] },
274
+ request: ExternalEffectReservationRequest,
275
+ ): Promise<ExternalEffectReservationHandle>
276
+ ```
@@ -0,0 +1,79 @@
1
+ # Hook transaction posture API
2
+
3
+ Read this when your custom implementation is registered on an operation the framework audits (a HIGH or CRITICAL
4
+ risk, or `auditableEvent.auditBelowRiskFloor`), and the operation is not already transactional
5
+ (`transactionalCore: true`, a token, a bulk selection).
6
+
7
+ Such a write records its `RESOURCE_OPERATION_PERFORMED` audit row after it commits. Without a transaction the row is
8
+ written best effort: a process that stops between the commit and the row loses it. The framework closes that gap by
9
+ running the write in a transaction whose audit row is kept in an outbox and written later if the process dies. That
10
+ transaction would also run your hooks, so the framework does it only when your registration says they may run there:
11
+
12
+ ```ts
13
+ createResourceCustomServiceImplementation({
14
+ // ...
15
+ hookTransactionPosture: ResourceCustomServiceImplementationHookTransactionPosture.RUNS_INSIDE_TRANSACTION,
16
+ handlers: {
17
+ prefixCoreOperations: async (id, input, executionContext, operationPath, utils) => { /* database only */ },
18
+ },
19
+ });
20
+ ```
21
+
22
+ Declare `RUNS_INSIDE_TRANSACTION` only when every hook (PREFIX, REPLACE, POSTFIX) holds to all of these:
23
+
24
+ - **Every read or write of the operation's own row, or of a row the core write creates or changes, passes
25
+ `utils.serviceOptions`.** On PostgreSQL the row is locked from the start of the transaction, so a write on another
26
+ connection waits forever, and a read there does not see what the transaction wrote.
27
+ - **Nothing outside the database happens before the commit**: no provider or HTTP call, no email, no queue publish, no
28
+ cache write, no audit row. Register such an effect to run after the commit instead, with
29
+ `registerTransactionPostCommitEffect(utils.serviceOptions.transaction, { key, execute })`: it then runs once, only for
30
+ an attempt that committed. A refusal's own audit row, written just before the hook throws, may stay where it is.
31
+ - **A hook may run twice.** The store can retry the transaction once, and every hook runs again from the start. That is
32
+ harmless when everything it does is in the database: the first attempt was rolled back.
33
+
34
+ Declare `STAYS_OUTSIDE_TRANSACTION` when a hook cannot hold to them (its answer depends on a provider call, or on an
35
+ audit row that must exist before the operation answers), and write why beside it. The write then stays best effort under
36
+ its own reported reason, not as unreviewed. A registration that declares nothing is treated as unreviewed, and so is an
37
+ operation one of whose registrations declares nothing.
38
+
39
+ ## Import Origins
40
+
41
+ - `@wildo-ai/saas-backend-lib`
42
+
43
+ ## Source Excerpts
44
+
45
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
46
+
47
+ ```typescript
48
+ /**
49
+ * Whether a registration's hooks (PREFIX, REPLACE, POSTFIX) may run inside a database transaction the framework opens
50
+ * around the operation, so that the operation's audit row is kept through a crash (#2297).
51
+ *
52
+ * An audited write whose operation is not transactional for another reason writes its `RESOURCE_OPERATION_PERFORMED` row
53
+ * after the commit, best effort: a process that dies in between loses it. The framework closes that gap by running the
54
+ * write in a transaction whose post-commit effects are captured, so the row is kept in the outbox and written later.
55
+ * Running a write in a transaction runs its hooks there too, and that changes what a hook may do, so the framework does it
56
+ * only for a registration that says its hooks were reviewed for it. Undeclared, the write stays best effort.
57
+ *
58
+ * Inside the transaction a hook runs before the commit, possibly twice (the store may retry the transaction once), and on
59
+ * PostgreSQL the operation's own row is locked from the start. So a hook that RUNS_INSIDE_TRANSACTION:
60
+ * - reads and writes the operation's own row, and any row the core write creates or changes, only with
61
+ * `utils.serviceOptions` (another connection would wait on the row lock, or not see the uncommitted row);
62
+ * - makes no effect outside the database before the commit: a provider call, an email, a queue publish, a cache or Redis
63
+ * write, an audit row. Such an effect is registered as a post-commit effect instead
64
+ * (`registerTransactionPostCommitEffect(utils.serviceOptions.transaction, …)`, or `emitAuthorityChangeAuditWhenDurable`
65
+ * for an authority-change audit row), where it runs once, after the commit, and never for a rolled-back attempt. A
66
+ * refusal's own audit row (written just before the hook throws) may stay where it is: nothing commits after it.
67
+ *
68
+ * STAYS_OUTSIDE_TRANSACTION records the opposite review: a hook must run outside any transaction (its answer depends on a
69
+ * provider call, or on an audit row that has to exist before the operation answers), so the write stays best effort,
70
+ * reported under its own reason rather than as unreviewed. Say why at the declaration.
71
+ *
72
+ * A registration with `transactionalCore: true` already runs its hooks in a transaction and needs neither. Refused beside an
73
+ * `overrideAll` handler, which replaces the pipeline whose transaction this is about.
74
+ */
75
+ export enum ResourceCustomServiceImplementationHookTransactionPosture {
76
+ RUNS_INSIDE_TRANSACTION = 'runs_inside_transaction',
77
+ STAYS_OUTSIDE_TRANSACTION = 'stays_outside_transaction',
78
+ }
79
+ ```
@@ -129,12 +129,14 @@ export const blueprintDefinition = {
129
129
  { file: 'shared-lib/src/engine/features.ts', declaration: 'FEATURE_PROFILES', path: [] },
130
130
  ],
131
131
  },
132
- // The group's organization type replaces the base type `wildo/internal-tool` marked as the owner, and the group's
133
- // ORGANIZATIONS entry replaces the `enabled: true` it set.
132
+ // The group's organization type replaces the base type `wildo/internal-tool` marked as the owner, the group's
133
+ // ORGANIZATIONS entry replaces the `enabled: true` it set, and the group's user types replace the base `member` whose
134
+ // registration it closed to invitations (#3037): `employee` is invitation-only too.
134
135
  overrides: {
135
136
  declarations: [
136
137
  { file: 'wildo.saas.config.ts', path: ['organizationTypes'] },
137
138
  { file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.ORGANIZATIONS'] },
139
+ { file: 'backend-api/src/saas-config.backend.ts', path: ['userTypes'] },
138
140
  ],
139
141
  },
140
142
  } satisfies BlueprintDefinitionInput;
@@ -91,7 +91,11 @@ same-category use, but say so in `competitorCollisions` too.
91
91
 
92
92
  ### Step 4: Record honestly: a failure is not an answer
93
93
 
94
- A register you could not query or read is **`UNKNOWN`, with a note**, never `CLEAR`. `CONFLICT`
94
+ A register you could not query or read is **`UNKNOWN`, with a note**, never `CLEAR`. Every query
95
+ names the term it ran with (`searchedName`): a search run for one candidate is never recorded as
96
+ another's. A register you tried once, for another name, and did not try for this one is
97
+ **`NOT_SEARCHED`**, citing that attempt (`searchedName`, `sourceUrl`, a note); the validator refuses
98
+ a query that records another name's search as this one's (`QUERY_FOR_ANOTHER_NAME`). `CONFLICT`
95
99
  exactly when a live identical or near-identical mark was found, with every such mark listed and
96
100
  sourced. Every query carries its source URL and date. There is **no candidate-level verdict to
97
101
  write**. `deriveBrandNameTrademarkOutcome` computes it from the queries, so a candidate with an
@@ -113,7 +117,10 @@ The brand-identity interview offers options computed by `deriveOfferableBrandNam
113
117
  A conflicting proposal is never offered. Each option is shown with a line saying what its qualifier
114
118
  summarizes (the product using the name, the registers nobody read), and the creator's answer records
115
119
  that line with the choice. Until the screening clears the chosen name, `wildo context launch-blockers`
116
- lists it as not cleared.
120
+ lists it as not cleared. A name kept despite a conflict never clears by re-screening (the mark is still on the
121
+ register): once an IP professional's opinion, a filed application or a registered mark covers it, the creator
122
+ records it in `brandNameClearances` in `wildo.saas.config.ts`, which settles the item. Never write that record
123
+ yourself: it is a legal record only a person can make (`config-saas`, `references/compliance-declarations.md`).
117
124
  To screen another name of their own, they add it to `top_down.brand-naming`'s interview
118
125
  (`names-to-screen`) and re-run it. Stop there: choosing is not this skill's job.
119
126
 
@@ -130,6 +137,7 @@ To screen another name of their own, they add it to `top_down.brand-naming`'s in
130
137
  state is targeted.
131
138
  - [ ] Classes 9 and 42 are searched.
132
139
  - [ ] Every query has a `sourceUrl` and a `checkedOn` date.
140
+ - [ ] Every query's `searchedName` is its own candidate's name, unless its outcome is `NOT_SEARCHED`.
133
141
  - [ ] No query the research could not run is recorded as `CLEAR`.
134
142
  - [ ] Every query states its `accessPath`, and every same-category use its `categoryRelation`.
135
143
  - [ ] Every country the creator named as a target is a declared jurisdiction.
@@ -152,6 +160,7 @@ wildo context coherence
152
160
  | Rationalization | Reality |
153
161
  |---|---|
154
162
  | "The register would not load, so it is probably fine." | A register that could not be read is `UNKNOWN`. Silence is not a search result. |
163
+ | "One attempt failed, so the result applies to every candidate." | Only the name that was searched has a search. The others are `NOT_SEARCHED`, citing that attempt; copying the attempt onto them is refused. |
155
164
  | "A quick web search found nothing, so it is clear." | Search engines do not index trademark registers. Only the register's own result counts. |
156
165
  | "The creator likes the name, so skip screening it." | A creator-supplied name is screened exactly like a proposal. Choosing it despite a conflict is their explicit act, not a skipped check. |
157
166
  | "Mark the candidate clear to save the creator a worry." | There is no clear field: the outcome is derived from the queries. Inventing a query result is the one thing the validator cannot catch. |
@@ -166,6 +175,8 @@ wildo context coherence
166
175
  - The word "available" or "cleared" in the brand or screening. Catch it with the first grep above.
167
176
  - No `EU` jurisdiction while an EU country is targeted. Catch it with the validator's
168
177
  `EU_TRADE_MARK_NOT_DECLARED` finding.
178
+ - Several candidates carrying the same `sourceUrl`, one name's search. Catch it with the
179
+ `searchedName` check above and the validator's `QUERY_FOR_ANOTHER_NAME` finding.
169
180
  - Every query `UNKNOWN` and nothing said about it. Catch it with `wildo context coherence`
170
181
  (`brand-name-screening-read-nothing`) and the validator's `NO_REGISTER_READ` finding.
171
182
  - A same-job product with the candidate's name filed with no `categoryRelation`. Catch it with the
@@ -88,14 +88,26 @@ export enum BrandNameMatchType {
88
88
  NEAR_IDENTICAL = 'NEAR_IDENTICAL',
89
89
  }
90
90
 
91
- /** What one register query returned. `UNKNOWN` is a query that could not be completed — never a clear one. */
91
+ /**
92
+ * What one register query returned. `UNKNOWN` is a query that could not be completed, and `NOT_SEARCHED` one that was
93
+ * never run for this candidate — neither is ever a clear one.
94
+ */
92
95
  export enum BrandNameTrademarkQueryOutcome {
93
96
  /** Searched, at full coverage, and no live identical or near-identical mark found. */
94
97
  CLEAR = 'CLEAR',
95
98
  /** At least one live identical or near-identical mark in a searched class. */
96
99
  CONFLICT = 'CONFLICT',
97
- /** The register was unreachable, the search could not be run, or its result could not be read. */
100
+ /** The search for THIS candidate was run and the register was unreachable, or its result could not be read. */
98
101
  UNKNOWN = 'UNKNOWN',
102
+ /**
103
+ * No search for THIS candidate was run on this register (#3239). Recorded when the register failed on an attempt
104
+ * made for ANOTHER name, so a search for this one was not tried: `searchedName` and `sourceUrl` then cite that
105
+ * shared attempt honestly, and `note` says so; its classes, match types and jurisdictions are those of the cited
106
+ * attempt, the search this candidate would have had. Read exactly like UNKNOWN (nothing was read), and the only
107
+ * outcome whose `searchedName` may name another candidate. On app-creation-test-007 one failed attempt per register for
108
+ * "groundwork" was copied onto four other candidates as their own searches, with the groundwork search URL.
109
+ */
110
+ NOT_SEARCHED = 'NOT_SEARCHED',
99
111
  }
100
112
 
101
113
  /** The status of a conflicting mark. Only LIVE marks are recorded: an expired or withdrawn mark is not a conflict. */
@@ -229,6 +241,13 @@ export const BrandNameTrademarkQuerySchema = z.object({
229
241
  niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
230
242
  matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
231
243
  outcome: z.enum(BrandNameTrademarkQueryOutcome).systemEnum('BrandNameTrademarkQueryOutcome'),
244
+ /**
245
+ * The name the register was actually asked about (#3239): the term the search ran with. It is this candidate's name
246
+ * for every outcome but `NOT_SEARCHED`, which cites the attempt made for another name. Optional in the STORED record
247
+ * only because screenings landed before the field existed carry none; the generation schema requires it, and the
248
+ * validator reads the `sourceUrl` of a record without it.
249
+ */
250
+ searchedName: NonEmptyStringSchema.optional(),
232
251
  /**
233
252
  * How the register was reached (#2333). Optional in the STORED record only because screenings landed before
234
253
  * the field existed carry none; read it through {@link resolveBrandNameQueryAccessPath}, never directly. A
@@ -307,12 +326,20 @@ export type BrandNameCandidate = z.infer<typeof BrandNameCandidateSchema>;
307
326
  * THE brand-name screening payload — one per application. `jurisdictions` and `niceClasses` are the
308
327
  * coverage every candidate is measured against: a candidate whose queries do not reach all of them is
309
328
  * UNKNOWN, whatever its queries say.
329
+ *
330
+ * `jurisdictions` may be EMPTY (#3484): nothing declares a target yet, because the creator left where the product's users
331
+ * are "not decided yet" and neither the market, the vision nor the configuration names a place. The screening still
332
+ * records what it searched (international registrations, `WO`, are always required), and is MARKED rather than refused:
333
+ * no candidate of a screening with no target is ever CLEAR ({@link deriveBrandNameTrademarkOutcome}), and its
334
+ * validation carries `TARGET_JURISDICTIONS_NOT_DECLARED` as an advisory (`application-creation-directive.md`: an
335
+ * unfinished answer travels with the artifact, it does not stop it).
310
336
  */
311
337
  export const BrandNameScreeningSchema = z.object({
312
338
  version: z.enum(BrandNameScreeningVersion).default(BrandNameScreeningVersion.V1),
313
339
  /** The day the screening was run. */
314
340
  screenedOn: IsoDateSchema,
315
- jurisdictions: z.array(BrandNameScreeningJurisdictionSchema).min(1),
341
+ /** The target jurisdictions searched; empty while no target is declared (see above). */
342
+ jurisdictions: z.array(BrandNameScreeningJurisdictionSchema),
316
343
  niceClasses: z.array(BrandNameScreeningNiceClassSchema).min(1),
317
344
  candidates: z.array(BrandNameCandidateSchema).min(1),
318
345
  });
@@ -65,6 +65,9 @@ the provider's inbound handler, and posts what the engine hands it, with the pro
65
65
  `NOT_YET` (the engine waits on the door's answer whatever the handler returns, and fails a delivery whose handler
66
66
  answers `NOT_YET` without the door having said it); post `sentence.text` for `REFUSED` with the module's helper (`postSlackConverseRefusal`,
67
67
  `postTeamsConverseRefusal`), which puts it where the person reads it. See `inbound-channels` for `converse()`.
68
+ While the conversation waits on a decision, a message is refused (`WAITING_FOR_DECISION`) with where to answer it,
69
+ except one: when the agent asked the person a single free-text question, the message IS the answer, and
70
+ `converse()` answers `STARTED` once the waiting turn resumes. The handler needs no branch for it.
68
71
  3. **Declare ONE chat reply handler per connection** (`chatReplyHandlers: [defineChatReplyHandler({ ref,
69
72
  connectionRef, reply })]`), whose `reply` calls the module's helper (`postSlackChatReply`, `postTeamsChatReply`).
70
73
  Startup refuses a messages endpoint whose connection has no reply handler: an answer would be owed to nobody.
@@ -132,6 +132,7 @@ export enum OrganizationChatSettingErrorCode {
132
132
  */
133
133
  import type { ChatConversationAudience, ProviderOperationExecute } from '@wildo-ai/external-connectors-models';
134
134
  import type { AvailableLanguage } from '@wildo-ai/presets-components-models';
135
+ import type { FlowsActors_ExecutionErrorCode } from '@wildo-ai/saas-models';
135
136
  import type { HumanDecisionNoticePersonalConversation } from './human-decision-notice-handler.backend.definitions';
136
137
 
137
138
  /** What one part of a reply is. */
@@ -151,10 +152,19 @@ export enum ChatReplyNoticeKind {
151
152
  EMPTY = 'empty',
152
153
  /** The answer was stopped before it finished; what it had written was posted before this. */
153
154
  STOPPED = 'stopped',
154
- /** The answer was cut off (the turn failed, or the service restarted), so the message can be sent again. */
155
+ /**
156
+ * The answer was cut off and no reason was recorded (a turn ABORTED, or one stored FAILED before #2827 recorded codes),
157
+ * so the message can be sent again. A failure that recorded its code is FAILED, including a restart (TURN_INTERRUPTED).
158
+ */
155
159
  INTERRUPTED = 'interrupted',
156
160
  /** A decision the agent was waiting on can no longer be answered (it lapsed, or was withdrawn). */
157
161
  DECISION_CLOSED = 'decision_closed',
162
+ /**
163
+ * #2827: the turn failed and recorded why (`failureCode` on the notice), so the sentence says what the person can do
164
+ * about it, in the words the application's own thread uses for that code. A failure recorded without a reason (one
165
+ * stored before the code was) is still INTERRUPTED.
166
+ */
167
+ FAILED = 'failed',
158
168
  /** The agent waits for a decision before it can go on; the sentence says where it can be answered. */
159
169
  WAITING = 'waiting',
160
170
  }
@@ -183,6 +193,8 @@ export interface ChatReplyNotice {
183
193
  readonly text: string;
184
194
  /** The decision a `WAITING` sentence is about. */
185
195
  readonly decisionRef?: string;
196
+ /** #2827: why the turn failed, for a `FAILED` sentence: the code the sentence is worded by. */
197
+ readonly failureCode?: FlowsActors_ExecutionErrorCode;
186
198
  }
187
199
 
188
200
  export type ChatReplyPart = ChatReplyAnswer | ChatReplyNotice;
@@ -365,6 +365,11 @@ because the law requires it, which law, and that they are deleted when the perio
365
365
  `retention-rules` fact names these resources and their statute under each erasure treatment. Never write
366
366
  that an erasure is refused or delayed because of them.
367
367
 
368
+ **A statutory record whose `statutoryRetention` carries `staysInUseBecause` is NOT hidden.** Billing records are the
369
+ worked case: a provider keeps reporting on them, so they stay in use and an erasure leaves them as they are. For such a
370
+ resource, state the law and the period, and say the records stay in use for the reason the fact gives. Never write that
371
+ they are restricted or hidden from other processing.
372
+
368
373
  **Derives from (the HOW LONG)** — the application's `dataRetention` schedule, declared in its config
369
374
  over five data classes: `RESOURCE_DATA` (its records), `FILES` (uploaded bytes), `AUDIT_LOGS` (the
370
375
  tamper-evident trail, kept longest and for a different reason — it is the evidence an operator may
@@ -380,7 +385,25 @@ counted from when the record stops being needed, so a live record is never delet
380
385
  `RETENTION_CLASS_SWEEP`, `FILES_CLEANUP` (file bytes after their row is gone), `AUDIT_ARCHIVAL`. An EMPTY
381
386
  mechanism list means nothing is even wired to enforce the class — say exactly that. `AUDIT_ARCHIVAL` means the audit
382
387
  trail is archived after the period and is NEVER deleted: do not write that audit records are deleted.
383
- The fact also names the resources bound to no class — kept until erased, because nobody decided otherwise.
388
+ `rowLifetimes` says what ends every resource's rows, so a clause can state the CRITERIA where there is no period. Law
389
+ allows either the period or the criteria that determine it, so "kept while the account exists, then deleted" is a true
390
+ and sufficient answer. Word each one as what it is:
391
+
392
+ | `lifetime` | what to write |
393
+ |---|---|
394
+ | `class_period` | the declared period of its class |
395
+ | `row_expiry` | deleted automatically after a set time; the fact does not carry the time, so mark the time as owed |
396
+ | `ends_with_tenant` / `ends_with_account` / `ends_with_parent` | kept while the organisation, the account or the parent record exists. Where `erasureTreatments` names the resource, say what that treatment does at the end instead of saying deleted |
397
+ | `dedicated_mechanism` | removed once it has served its purpose; do not state a period |
398
+ | `follows_system_of_record` | a copy kept in step with its source: the source's rules decide how long, so point there |
399
+ | `audit_trail` | archived at the audit period, never deleted |
400
+ | `file_cleanup` | the `FILES` period, counted from the file's release |
401
+ | `not_stored_locally` / `rows_owned_by_another_resource` | say nothing of its own: it holds no separate copy |
402
+ | `operator_configuration` / `no_personal_data` | it declares no personal data of its own, so there is no period to state for it |
403
+ | `undecided` | listed again in `resourcesWithUndecidedLifetime`: nothing ends these rows, so mark how long they are kept as owed, never a period and never "until erased" as if someone had decided that |
404
+
405
+ The remedy for `undecided` is a `retentionBinding`, or an owner whose deletion deletes the row. A bare "as long as
406
+ necessary" is never an answer.
384
407
 
385
408
  **Whether a period IS enforced is a different fact** — `retention-enforcement`, computed from the records the
386
409
  retention sweep writes on every run (runtime evidence, not a declaration). Per declared class it reads
@@ -577,6 +600,15 @@ OWN infrastructure holds the data (`operatorComplianceIdentity.hostingRegions`),
577
600
  operator has not declared it. State a `null` as the operator's hosting location not yet being declared;
578
601
  it never means the data is held nowhere, and it never supports "no international transfer".
579
602
 
603
+ It also carries `dataResidency`: the places the operator commits the data to
604
+ (`operatorComplianceIdentity.dataResidency.territories`), and for each vendor-hosted provider its chosen
605
+ region, the places that region processes in, and a `status` (`inside`, `outside`, `territory-unknown`,
606
+ `no-established-profile`). State the territories from this value, never from prose. `null` means no
607
+ residency is declared: say the service makes no residency commitment rather than naming a region.
608
+ `providers: null` means the providers' profiles were not read, so state the commitment without claiming
609
+ every vendor keeps it. A configuration with any status other than `inside` is refused by `wildo config
610
+ sync`, so a landed application normally shows only `inside`.
611
+
580
612
  **Completeness** — do not round any state up.
581
613
 
582
614
  | the register | what you may state | completeness |
@@ -743,10 +775,19 @@ results establish. A configured mechanism does not establish that a particular r
743
775
  portability collection rather than silently dropping fields. Explicitly forbidden resources do
744
776
  not need portability provenance for this export because their rows are not collected. Access uses
745
777
  its separate field selection; backend-only and write-only fields remain withheld.
746
- - Erasure: `eraseSubjectAsSystem(resourceType, rowIds)`, invoked by the application's verified request
747
- workflow. A contact or lead without a login can still be a data subject. Retention, relationship
778
+ - Erasure: `eraseSubjectAsSystem(resourceType, rowIds)`. For a person with an account, the engine's
779
+ `dataSubjectRequests` resource is the request workflow every application already has: the person files
780
+ an erasure request from their settings (or an operator records one received elsewhere, with a
781
+ justification), it waits out a 14-day grace window during which it can be withdrawn, carries a
782
+ `respondBy` deadline one calendar month after receipt, and an hourly sweep calls the erasure and records
783
+ the outcome and receipt on the request, which is kept as evidence. Do not build a second lane beside it:
784
+ the evidence collector refuses an application in which two resources declare a `subjectErasureLane`. A
785
+ contact or lead without a login can still be a data subject; that request is the operator's to record
786
+ and carry out. Retention, relationship
748
787
  treatments and account linkage are separate declarations; inspect the receipt before claiming
749
- completion, including dependent execution, session resolution and incomplete external effects.
788
+ completion, including dependent execution, sessions (`isSubjectErasureSessionRevocationComplete`: resolving a
789
+ principal is not ending their session), incomplete external effects and `unconfirmedSeveredReferences`, the rows a
790
+ severance write did not answer for.
750
791
 
751
792
  **The rights a notice states are COMPUTED, in the `rights-and-complaint-route` fact.** Which rights
752
793
  apply, and where a person may complain, are the law of the regime each `operatingJurisdictions` entry