@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,264 @@
1
+ # A workflow record page
2
+
3
+ Read this for a resource with a LIFECYCLE that other people move after its author wrote it — a request that waits for
4
+ approvals, a claim that is assessed, an order that is placed. Its record page has one job beyond showing the fields:
5
+ **where does it stand, and what happens next?** The engine's generated page puts the status first and who made the
6
+ record last, but it cannot know the route the record takes or which facts belong to which stage.
7
+
8
+ ## The page, part by part
9
+
10
+ | part | what it holds | construct |
11
+ |---|---|---|
12
+ | header | the record's name, and its status as a badge — the fact every reader needs first | `layout.header`: `<ResourceHeaderTitle />`, then `<DisplayField name="status" labelPlacement="hidden" />` (the name stays for a screen reader; `hideLabel` would remove it) |
13
+ | route | the steps the record takes, with the current one marked: the step after it IS the next step | a `Stepper` derived from the lifecycle (never a hand-kept list), each step named by the status enum's own words (`tResourceFieldEnumValue`) |
14
+ | what was asked | what the author wrote, once: the content, then its facts as tiles | `<Section name="…">` with the prose field and a `<FieldTiles>` |
15
+ | what happened | what other people did to it afterwards: when it was submitted, decided, completed, and the decisions recorded on it | a second `<Section>`; the decisions as their LIST, confined to the record and with its toolbar hidden (see below), drawn only for a reader who may list them; the section not drawn at all before anything has happened (a draft) |
16
+ | record keeping | who wrote it, when, and when it last changed | `<RecordKeepingFacts>` closing the page — never tiles inside either section (`framework-record-page-parts-api.md`) |
17
+ | actions | the transitions, each offered only from its `from` states, with words | the operations' views and icons (`views: [...]`); availability is the operations' `enabledCondition` |
18
+
19
+ The two sections pass the "different time, different reader" test of `references/surface-decisions.md`: the first is
20
+ written once by the author, the second is filled over time by the approvers. A record whose fields are all written at
21
+ one time needs no sections.
22
+
23
+ - **The route is derived.** Compute it from the same policy the transitions route by (which steps a record of this
24
+ amount needs), so a change of policy moves the route with it. A record that LEFT its route (refused, withdrawn)
25
+ shows no route: the badge says so, and the decision history says why.
26
+ - **The decisions are read by the person the record belongs to.** A refusal's reason is written for the requester, so
27
+ they read the decisions on their own record and on no colleague's: the decision names its requester in a field of its
28
+ own, confined by own rows (the `authorization-unit-narrowing` skill, "The rows ABOUT an owner's record"). Decisions
29
+ that outlive their record are a REFERENCE child on a standalone edge: the embed confines them to the record through
30
+ the decisions' route under it, or, where there is none, pins the record's foreign key declared in the decisions LIST's
31
+ `filterFields` (`framework-related-resource-embeds-api.md`, "A child whose route does not name the record"); with
32
+ neither the section is left out. Build the section from the embed's context with the toolbar hidden (a history is read, not searched). The
33
+ card shows what the requester asks: the outcome, the step, the reason in full, then who decided and when.
34
+ - **Leave out what is true of every record.** The owner organization of a single-tenant tool tells nobody anything.
35
+ - **Status words come from the enum.** The route adds no vocabulary: "Awaiting finance" on the stepper is the same
36
+ word as on the list's badge.
37
+ - **A date the business needs in the future** (needed by, due on) is refused when it is in the past by the operations
38
+ that write it (create, edit, submit) — never by a refinement of the main schema, which also parses every stored
39
+ record, including one whose date has since passed.
40
+
41
+ ## Worked example
42
+
43
+ Wonder Procurement's purchase request: header with the status badge, the route from draft through the approvals its
44
+ amount requires to ordered, then `request` and `approval` sections, the form and the card.
45
+
46
+
47
+ ## Usage Example
48
+
49
+ ```tsx
50
+ /**
51
+ * The decisions recorded on THIS request: who decided at which step, what, when, and why.
52
+ *
53
+ * Read by the approvers and finance, and by the requester (#3068): a refusal's reason is written for them, and they read
54
+ * the decisions on their own requests through own rows on the decision's `requesterUserId`. A section a reader cannot
55
+ * read is not drawn at all rather than drawn as an error, and a draft has never been decided, so it shows no empty
56
+ * history either.
57
+ *
58
+ * The decisions' LIST, embedded from this request. A decision is a REFERENCE child (it outlives the request) on a
59
+ * standalone edge, which puts no requirement for the request in the context, so the embed runtime sends the LIST down
60
+ * its route under the request, `/purchase-requests/{purchaseRequestId}/approval-decisions` (#3072, #3073), inside what
61
+ * the reader may read, so it only narrows. Built here
62
+ * rather than through `RelatedResourceSections` for what that component does not offer: the toolbar is hidden (a
63
+ * history is read, not searched), and the section is not drawn for a reader who may not list decisions or for a draft.
64
+ * The title is the decisions' own header label, as `RelatedResourceSections` uses.
65
+ */
66
+ function ApprovalDecisionsOfRequest(): React.JSX.Element | null {
67
+ const mayList = useViewerMayListRelatedResource(R.APPROVAL_DECISIONS);
68
+ const { data } = useDisplayTemplateContext();
69
+ const embedded = useEmbeddedResourceContext();
70
+ const { tResourceHeader, isReady } = useI18n();
71
+ const requestId = embedded.hostResourceId;
72
+ // Built only once the reader may list them: `mayList` is also false when the runtime could not confine the list to
73
+ // this request, and building it then would throw where the section should simply not be drawn.
74
+ const decisionsOfRequest = useMemo(
75
+ () => (requestId && mayList
76
+ ? {
77
+ ...embedded.buildOperationContext({ resourceType: R.APPROVAL_DECISIONS, operationLike: Op.LIST, requireAddressable: false }),
78
+ collectionToolbar: CollectionToolbarPresence.HIDDEN,
79
+ }
80
+ : null),
81
+ [embedded, requestId, mayList],
82
+ );
83
+ if (!mayList || !decisionsOfRequest || !isReady || data?.status === PurchaseRequestStatus.DRAFT) return null;
84
+ return (
85
+ <ContentSectionContainer
86
+ config={{ mode: SectionMode.INLINE }}
87
+ sections={[{
88
+ id: R.APPROVAL_DECISIONS,
89
+ title: resolveResourceHeaderLabel({ tResourceHeader, resourceType: R.APPROVAL_DECISIONS, key: 'title' }),
90
+ content: <EmbedResourceOperation resourceContext={decisionsOfRequest} />,
91
+ }]}
92
+ />
93
+ );
94
+ }
95
+
96
+ /**
97
+ * What happened to the request after it was written. A draft has not been submitted, so nothing has happened to it yet:
98
+ * the section is not drawn at all, rather than drawn as a heading over nothing (every fact in it is empty and drops out).
99
+ */
100
+ function ApprovalSection(): React.JSX.Element | null {
101
+ const { data } = useDisplayTemplateContext();
102
+ if (data?.status === PurchaseRequestStatus.DRAFT) return null;
103
+ return (
104
+ <Section name="approval">
105
+ <FieldTiles>
106
+ <DisplayField name="submittedAt" />
107
+ <DisplayField name="decidedAt" />
108
+ <DisplayField name="orderedAt" />
109
+ <DisplayField name="erpPurchaseOrderRef" />
110
+ </FieldTiles>
111
+ <ApprovalDecisionsOfRequest />
112
+ </Section>
113
+ );
114
+ }
115
+ ```
116
+
117
+ ## Usage Example
118
+
119
+ ```tsx
120
+ layout: {
121
+ refs: { sections: ['request', 'approval'] },
122
+ defaultChromeMode: {
123
+ summary: DisplayChromeMode.HIDDEN,
124
+ edit: EditChromeMode.STACKED,
125
+ },
126
+
127
+ header: () => (
128
+ <div className="flex min-w-0 flex-wrap items-center gap-field">
129
+ <ResourceHeaderTitle />
130
+ {/* The name stays for assistive technology (`labelPlacement="hidden"` renders it screen-reader only; `hideLabel` would drop it). */}
131
+ <DisplayField name="status" labelPlacement="hidden" hideDescription className="w-auto" />
132
+ </div>
133
+ ),
134
+
135
+ display: () => (
136
+ <DisplayLayout>
137
+ <PurchaseRequestProgress />
138
+ <Section name="request">
139
+ <DisplayField name="justification" />
140
+ <FieldTiles>
141
+ <DisplayField name="supplierDirectoryEntryId" />
142
+ <DisplayField name="estimatedTotal" />
143
+ <DisplayField name="neededBy" />
144
+ <DisplayField name="organizationUnitId" />
145
+ </FieldTiles>
146
+ </Section>
147
+ <ApprovalSection />
148
+ {/* Who wrote the request and when it last changed: record keeping, not what was asked or decided, so it
149
+ closes the page on one quiet line instead of sitting among the request's facts (#3066). */}
150
+ <RecordKeepingFacts>
151
+ <DisplayField name="createdByUserId" />
152
+ <DisplayField name="createdAt" />
153
+ <DisplayField name="updatedAt" />
154
+ </RecordKeepingFacts>
155
+ </DisplayLayout>
156
+ ),
157
+
158
+ edit: () => (
159
+ <FormLayout>
160
+ <FormField name="title" autoFocus />
161
+ <FormField name="justification" />
162
+ <div className="grid grid-cols-1 gap-field sm:grid-cols-2">
163
+ <FormField name="organizationUnitId" />
164
+ <FormField name="supplierDirectoryEntryId" />
165
+ <FormField name="estimatedTotal" />
166
+ <FormField name="neededBy" />
167
+ </div>
168
+ </FormLayout>
169
+ ),
170
+
171
+ summary: () => (
172
+ <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>
173
+ <SummaryHeader>
174
+ <SummaryTitle className="flex-initial" />
175
+ <DisplayField name="status" />
176
+ </SummaryHeader>
177
+ <SummaryMeta>
178
+ <DisplayField name="estimatedTotal" />
179
+ <DisplayField name="organizationUnitId" />
180
+ <DisplayField name="neededBy" />
181
+ </SummaryMeta>
182
+ </SummaryLayout>
183
+ ),
184
+ },
185
+ ```
186
+
187
+ ## Usage Example
188
+
189
+ ```tsx
190
+ /**
191
+ * The route a request takes, in the order it is walked: a draft, the approval steps its amount requires
192
+ * (`requiredApprovalSteps`, the purchasing policy's one rule), then approved and ordered. Derived from the policy rather
193
+ * than listed, so a request under the finance threshold shows no finance step and a change of threshold moves the
194
+ * route with it.
195
+ */
196
+ export function purchaseRequestRoute(totalMinorUnits: bigint): readonly PurchaseRequestStatus[] {
197
+ return [
198
+ PurchaseRequestStatus.DRAFT,
199
+ ...requiredApprovalSteps(totalMinorUnits).map((step) => STATUS_AWAITING_STEP[step]),
200
+ PurchaseRequestStatus.APPROVED,
201
+ PurchaseRequestStatus.ORDERED,
202
+ ];
203
+ }
204
+
205
+ /** The amount in minor units, as the wire carries it (a bigint, or its decimal string once serialized). */
206
+ function minorUnitsOf(estimatedTotal: unknown): bigint | undefined {
207
+ const amount = (estimatedTotal as { amount?: unknown } | undefined)?.amount;
208
+ if (typeof amount === 'bigint') return amount;
209
+ if (typeof amount === 'number' && Number.isFinite(amount)) return BigInt(Math.trunc(amount));
210
+ if (typeof amount === 'string' && /^-?\d+$/.test(amount)) return BigInt(amount);
211
+ return undefined;
212
+ }
213
+
214
+ /**
215
+ * Where a purchase request stands on its route, and what comes next — the record page's progress line (#3066).
216
+ *
217
+ * Each step is named by the status it reaches, in the words the status badge already uses (`system enum` labels of
218
+ * `PurchaseRequestStatus`), so the page adds no vocabulary: the step after the current one IS the next step, read in
219
+ * the same words the list's badges use ("Awaiting department head", "Awaiting finance").
220
+ *
221
+ * A request that left its route — refused or withdrawn — renders nothing: the header's badge says so, and the
222
+ * approval history below says who and why. Drawing a route it will never finish would show a next step that is not
223
+ * coming.
224
+ */
225
+ export function PurchaseRequestProgress(): React.JSX.Element | null {
226
+ const { data } = useDisplayTemplateContext();
227
+ const { tResourceFieldEnumValue } = useI18n();
228
+ const status = data?.status as PurchaseRequestStatus | undefined;
229
+ const total = minorUnitsOf(data?.estimatedTotal);
230
+
231
+ const route = useMemo(() => (total === undefined ? undefined : purchaseRequestRoute(total)), [total]);
232
+ if (!route || !status) return null;
233
+ const current = route.indexOf(status);
234
+ if (current < 0) return null;
235
+ const last = route.length - 1;
236
+ // An ordered request has walked every step: all of them are done, the last included.
237
+ const completedSteps = status === PurchaseRequestStatus.ORDERED ? new Set(route.map((_, index) => index)) : undefined;
238
+
239
+ return (
240
+ <Stepper currentStep={current} totalSteps={route.length} orientation={DisplayDirection.HORIZONTAL} completedSteps={completedSteps}>
241
+ {route.map((step, index) => (
242
+ <Fragment key={step}>
243
+ <StepperItem step={index}>
244
+ <StepperIndicator step={index} />
245
+ <StepperTitle step={index}>
246
+ {tResourceFieldEnumValue(R.PURCHASE_REQUESTS, 'status', step, PurchaseRequests_Schema.shape.status)}
247
+ </StepperTitle>
248
+ </StepperItem>
249
+ {index < last && <StepperSeparator step={index} />}
250
+ </Fragment>
251
+ ))}
252
+ </Stepper>
253
+ );
254
+ }
255
+ ```
256
+
257
+ ## Verify
258
+
259
+ - The page of a record at each status shows the route with that step current (or no route when refused/withdrawn).
260
+ - No section holds only record keeping: `createdByUserId`, `createdAt` and `updatedAt` sit in `<RecordKeepingFacts>`, and a
261
+ draft's page draws no empty "what happened" section.
262
+ - Every named section is in `layout.refs.sections` and documented in the specification's `frontend.layout.sections`.
263
+ - A future-date rule is checked in the operations that write the date (`rg -n "neededBy" backend-api/src/modules`),
264
+ and no `*.schemas.ts` refines the date field.
@@ -123,6 +123,14 @@ specific resource row. The triggering row's `_id` is the natural
123
123
  > is a resource, not a deployment event). The same applies to any
124
124
  > "on creation of resource X" pattern.
125
125
 
126
+ **The application start does not iterate rows.** `ON_APP_INIT` and `ON_APP_VERSION_UPGRADE` run a
127
+ seed once, against one anchor, so they take a `GLOBAL` or `APPLICATION` scope only.
128
+ `createDataSeedDefinition` refuses an `ORGANIZATION`, `USER` or `CUSTOM` seed carrying either
129
+ trigger, `scopeIteration` or not. Per-row data reaches its rows another way: a `RESOURCE_LIFECYCLE`
130
+ trigger for each new row, `lazyAccess` for an existing row on first read, or the cron path
131
+ (`ON_SCHEDULED_REFRESH` with a `schedule` whose `iterationStrategy` names the rows) to revisit every
132
+ row.
133
+
126
134
  On any level, a per-scope seed keeps STATIC entries with `anchorEntriesToScopeForeignKey: true`:
127
135
  leave the scope key (`organizationId`, …) out of the business key and the engine adds the id of the
128
136
  scope row being seeded. Use a computed `entry()` only when VALUES depend on the triggering row. It returns
@@ -138,7 +146,7 @@ computed (a server-owned total, a derived status) itself, and a seeded row annou
138
146
 
139
147
  | Mode | Re-run safe? | Touches existing rows? | Required fields | Pick when … |
140
148
  |------------|--------------|--------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------------|
141
- | `LAZY` | Yes | No | `lazyAccess`, `entry()` | "Default X appears the first time the user opens Y" |
149
+ | `LAZY` | Yes | On first access in a scope only — the payload is re-stamped on a row another seed already created, unless `existingRowTreatment: FILL_MISSING_DEFAULTS` | `lazyAccess`, `entry()` | "Default X appears the first time the user opens Y" |
142
150
  | `ADDITIVE` | Yes | Yes — full payload re-stamped, unless `existingRowTreatment: FILL_MISSING_DEFAULTS` | none beyond the base | "New rows shipped in vN+1 should appear; existing rows are re-stamped from the declared payload" |
143
151
  | `UPGRADE` | Yes | Yes — only `managedFields` | `managedFields[]` (non-empty), optional `migrators.fromVersion[n]` | "Re-deploy the framework-owned subject line, keep user-edited body" |
144
152
  | `SYNC` | Yes | Yes — controlled by `onOrphan` | `onOrphan` (`DELETE` / `DEPRECATE` / `REPORT`), `managedFields[]` | "Closed enum materialized as rows; declaration is the source of truth" |
@@ -149,7 +157,9 @@ re-applied `ADDITIVE` payload replaces each whole stored block — so every pass
149
157
  administrator saved. Declare `existingRowTreatment: DataSeedExistingRowTreatment.FILL_MISSING_DEFAULTS`
150
158
  on such a seed: it inserts when the row is absent and, on an existing row, assigns only the leaves the
151
159
  row is missing. On a `RESOURCE_LIFECYCLE` seed it also repairs the rows it created earlier, once per
152
- seed `version`, at application boot. The field is `ADDITIVE`-only; the factory rejects it elsewhere.
160
+ seed `version`, at application boot. The field is valid on `ADDITIVE` and `LAZY`; the factory rejects
161
+ it elsewhere. A `LAZY` seed of a row another seed also creates needs it too: the lazy pass runs when
162
+ its own ledger has no completed run, which includes a row the other seed already wrote.
153
163
 
154
164
  The §3.6 matrix rejects illegal cells at factory time:
155
165
 
@@ -298,8 +308,10 @@ ONLY — the factory auto-injects the matching trigger. Never declare
298
308
 
299
309
  Walk Decision 2. Cross-check the §3.6 matrix cell. If the cell is
300
310
  empty (e.g. UPGRADE × `RESOURCE_LIFECYCLE`), restructure the seed:
301
- either change the level (move to Level A `ON_APP_VERSION_UPGRADE`)
302
- or change the mode (use ADDITIVE for the per-row case).
311
+ either change the level (move to Level A `ON_APP_VERSION_UPGRADE`, which
312
+ is open to a `GLOBAL` or `APPLICATION` seed only; for a per-row seed use
313
+ `ON_SCHEDULED_REFRESH` with a `schedule`) or change the mode (use ADDITIVE
314
+ for the per-row case).
303
315
 
304
316
  ### Step 4: Declare the seed
305
317
 
@@ -648,6 +660,7 @@ What is **not** in this block (and shouldn't be):
648
660
  - [ ] Seed file default-exports the result of `createDataSeedDefinition({...})`
649
661
  - [ ] `seedKey` is stable across deploys (kebab-case segments joined by `:`)
650
662
  - [ ] Mode × trigger cell is allowed by the §3.6 matrix
663
+ - [ ] An `ORGANIZATION` / `USER` / `CUSTOM` seed carries no `ON_APP_INIT` or `ON_APP_VERSION_UPGRADE` trigger
651
664
  - [ ] LAZY seeds declare `lazyAccess` and OMIT `triggers`
652
665
  - [ ] Non-LAZY seeds declare `triggers[]` (≥1) and OMIT `lazyAccess`
653
666
  - [ ] UPGRADE seeds declare non-empty `managedFields[]`
@@ -656,6 +669,10 @@ What is **not** in this block (and shouldn't be):
656
669
  - [ ] `renames[*].to` matches a declared `entries[*].businessKey[field]`
657
670
  - [ ] A demonstration seed declares `allowedApplicationEnvironments` without `production`; a reference seed omits it
658
671
  - [ ] A foreign key to another seed's row is a `referenceDataSeedRow(...)` (never unset or a placeholder) and that seed is in `dependsOn`
672
+ - [ ] Every entry carries every field the resource's schema requires and does not default, including a field the create
673
+ request keeps out (`.excludeFromCreate()`, `.isBackendOnly()`); a required object with no object-level default is
674
+ written as `{}` so its field defaults fill it. The write refuses an entry that leaves one out, on every adapter and
675
+ on an existing row too
659
676
  - [ ] Seed surfaced on the module's `BackendDomainModule.seeds?: DataSeedDefinition[]` slot
660
677
  (aggregated by `mergeBackendDomainModules` and threaded into the assembly's `dataSeeds`)
661
678
 
@@ -698,6 +715,7 @@ with an actionable error.
698
715
  | "I'll rename the resource field directly without a `renames` entry" | Without the rename ledger, the next pass inserts a duplicate at the new business-key value and orphans the existing row (SYNC) or leaves it unowned (UPGRADE / ADDITIVE). Always ship the ledger entry in the same commit as the value change. |
699
716
  | "The contact seed can't know the customer's `_id`, so I'll leave `customerId` unset" | Use `referenceDataSeedRow(customersSeed, { …businessKey })` and list the customer seed in `dependsOn`: the engine resolves it to the row's `_id`. An unset or placeholder foreign key is a demo that shows unlinked records. |
700
717
  | "`dependsOn` resolves the link for me" | `dependsOn` only orders the seeds. Without a `referenceDataSeedRow` value nothing writes the foreign key. |
718
+ | "`data: {}` gets the schema's defaults, so I can leave the config blocks out" | Only a field that declares a default is filled. A required object with no object-level default must be written, as `{}`, for its field defaults to fill it; leave it out and the write refuses the row (it would be stored without the block). |
701
719
  | "I don't need `version` to bump for this UPGRADE" | UPGRADE re-applies `managedFields` only when `seedVersion < declared` — without bumping, existing rows skip the upgrade. Bump per material change. |
702
720
 
703
721
  ## Red Flags
@@ -725,6 +743,8 @@ with an actionable error.
725
743
  contract is "first access creates the row, never re-applied")
726
744
  - A demo seed whose foreign key to another seeded row is unset, `null` or hard-coded (Decision 7)
727
745
  - `referenceDataSeedRow` in a seed without `dependsOn` (catch with the references grep above)
746
+ - An entry whose `data` leaves out a required field with no default (a required config block included): the write
747
+ refuses it as `service_resource_validation_failed` naming the field (catch with the required-fields checklist item above)
728
748
 
729
749
  ## Related Skills
730
750
 
@@ -40,6 +40,18 @@ Nothing is ever written with a `null` or a placeholder foreign key.
40
40
  - Directly as a field value, or inside nested objects and arrays (`tagIds: [ref, ref]`).
41
41
  - In every mode (`ADDITIVE`, `UPGRADE`, `SYNC`, `LAZY`) and on every trigger level, including manual
42
42
  reruns.
43
+ - Inside another reference's business key, for a row keyed under its parent. A site address keyed
44
+ `(organizationId, customerId, label)` is named by its customer's reference and its own label:
45
+
46
+ ```ts
47
+ siteAddressId: referenceDataSeedRow(demoSiteAddressesSeed, {
48
+ customerId: referenceDataSeedRow(demoCustomersSeed, { email: 'ana.martin@example.com' }),
49
+ label: 'Main house',
50
+ })
51
+ ```
52
+
53
+ The inner reference resolves first. Its seed must be in the referring seed's `dependsOn` too, under
54
+ the same rules as a direct reference. If it resolves to nothing, the failure names it.
43
55
 
44
56
  ## Reading a failure
45
57
 
@@ -31,7 +31,10 @@ import from there in seed files (NOT the package root).
31
31
  * materialization, per-scope idempotency cache. Cannot combine with
32
32
  * `schedule?` (periodic re-run contradicts the contract). Write path
33
33
  * bypasses the operation pipeline (no hook re-entry from the seed's
34
- * own write).
34
+ * own write). "Never again" is per scope, by the run ledger, not by the
35
+ * row: the first pass writes like ADDITIVE, so a row ANOTHER seed already
36
+ * created there is re-stamped with the payload unless the seed declares
37
+ * `existingRowTreatment: FILL_MISSING_DEFAULTS` (#3383).
35
38
  * - **`ADDITIVE`** — "insert if business key absent; on present rows,
36
39
  * re-apply the entry's `data` payload via `upsertByBusinessKey`'s
37
40
  * `$set` semantics (no managed-fields gating, no version comparison)".
@@ -118,7 +121,7 @@ export enum DataSeedMode {
118
121
  * omitted for LAZY (factory auto-injects from `lazyAccess`).
119
122
  * - `lazyAccess` — required for LAZY, FORBIDDEN otherwise.
120
123
  * - `onOrphan` — required for SYNC, forbidden otherwise.
121
- * - `existingRowTreatment` — ADDITIVE only. Declare `FILL_MISSING_DEFAULTS`
124
+ * - `existingRowTreatment` — ADDITIVE and LAZY only. Declare `FILL_MISSING_DEFAULTS`
122
125
  * when the seed CREATES a row a person owns afterwards (a config
123
126
  * singleton): the default re-applies the declared payload on every pass,
124
127
  * which replaces whole stored blocks.
@@ -288,7 +291,8 @@ export class DataSeedRowReference {
288
291
  * @param businessKey The row's business key. Leave out the scope foreign key (`organizationId`, `userId`, …) when the
289
292
  * target seed has the same scope kind as the referring seed: the engine fills it from the scope being seeded.
290
293
  * @throws Error when `target` has no `seedKey`, when `businessKey` is not a plain object, or when a business-key value
291
- * is `undefined` or is itself a reference.
294
+ * is `undefined`. A business-key value may be another reference (a child keyed under its parent): it resolves first,
295
+ * and its seed must be in `dependsOn` too.
292
296
  *
293
297
  * @example
294
298
  * ```ts
@@ -313,9 +317,6 @@ export function referenceDataSeedRow(
313
317
  if (value === undefined) {
314
318
  throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is undefined — a business key is identity; use null for a genuinely-nullable field.`);
315
319
  }
316
- if (containsDataSeedRowReference(value)) {
317
- throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is itself a reference — a reference names its row by literal values.`);
318
- }
319
320
  }
320
321
  return new DataSeedRowReference(
321
322
  {
@@ -189,10 +189,14 @@ Run `wildo generate labels`.
189
189
  - [ ] `defaultSectionRef`, if set, names a destination you placed.
190
190
  - [ ] No two placements name the same destination.
191
191
  - [ ] The app starts with no settings-hub or launcher verification errors.
192
+ - [ ] `frontend/src/modules-registry.frontend.ts` passes the rail to the runtime (`settingsHub: settingsHubConfig` in `frontendBaseConfig`).
192
193
 
193
194
  ### Grep invariants
194
195
 
195
196
  ```bash
197
+ # The rail reaches the runtime: prints exactly one line. Nothing printed means Settings opens as an empty dialog.
198
+ rg -n "settingsHub: settingsHubConfig" frontend/src/modules-registry.frontend.ts
199
+
196
200
  # Every categoryRef a placement uses must be a declared category.
197
201
  rg -o "categoryRef: '([a-z-]+)'" -r '$1' frontend/src/config/settings-hub.config.ts | sort -u
198
202
  rg -o "^\s*\{ ref: '([a-z-]+)'" -r '$1' frontend/src/config/settings-hub.config.ts | sort -u
@@ -211,6 +215,7 @@ rg -U -o "ref: '([a-z-]+)',\s*target:" -r '$1' frontend/src/config/settings-hub.
211
215
 
212
216
  | Rationalization | Reality |
213
217
  |---|---|
218
+ | "Settings opens as an empty dialog, so the destinations must be broken" | The rail never reached the runtime. `settings-hub.config.ts` is read only where `modules-registry.frontend.ts` passes it as `settingsHub` in `frontendBaseConfig`; the startup verifier reports `SETTINGS_HUB_EMPTY`. |
214
219
  | "I removed the section but it still shows" | You removed the LABEL, not the placement. Delete the placement entry. |
215
220
  | "The framework will fill in the sections I did not place" | It will not. There is no default arrangement — absence is how you remove a section, so nothing re-adds one. |
216
221
  | "The engine has no destination for my resource, so it cannot go in settings" | Declare your own destination with a `RESOURCE_OPERATION` target and place it. Step 3b. |
@@ -223,6 +228,7 @@ rg -U -o "ref: '([a-z-]+)',\s*target:" -r '$1' frontend/src/config/settings-hub.
223
228
 
224
229
  ## Red Flags
225
230
 
231
+ - Settings opens with a title and nothing else: `settingsHub` is not passed in `frontendBaseConfig` — catch with the `settingsHub: settingsHubConfig` grep above.
226
232
  - A `categoryRef` that appears in no `categories` entry — catch with the categoryRef grep above.
227
233
  - A `groupRef` its category does not declare: the section is drawn above the groups with no heading — catch with the groupRef grep above.
228
234
  - The same `destinationRef` placed twice — catch with the duplicate grep above.
@@ -110,6 +110,11 @@ export enum EngineSettingsDestinationRef {
110
110
  * (#2324): one row per task transition and webhook, with its attempts and outcome. Each person's own.
111
111
  */
112
112
  MY_AGENT_PUSH_DELIVERIES = 'my-agent-push-deliveries',
113
+ /**
114
+ * The signed-in person's own data-subject requests (#2296): a request to exercise a data-protection right (today,
115
+ * erasure of their account), its grace window, the deadline it is answered by and what was done. Each person's own.
116
+ */
117
+ MY_DATA_SUBJECT_REQUESTS = 'my-data-subject-requests',
113
118
  /** Single sign-on configuration and connections. */
114
119
  SSO = 'sso',
115
120
  /** SCIM directory provisioning configuration and tokens. */
@@ -183,6 +188,12 @@ export enum EngineSettingsDestinationRef {
183
188
  * and the provider's DNS records, verify, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs.
184
189
  */
185
190
  EMAIL_DOMAINS = 'email-domains',
191
+ /**
192
+ * The domains on which the application answers for THIS organization (#2974): claim one, publish its ownership TXT
193
+ * record, prove ownership, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs; claiming and
194
+ * proving need the plan's custom branding, which the backend refuses by name when it is missing.
195
+ */
196
+ CUSTOM_DOMAINS = 'custom-domains',
186
197
  /**
187
198
  * The addresses THIS organization — a representing organization — keeps on its own verified domain for the granting
188
199
  * organizations it serves; each routes its mail into that granting organization (#1600). Org owner/admin only. Shown
@@ -282,6 +293,15 @@ export enum EngineSettingsDestinationRef {
282
293
  * grant. So the destination shows nothing without an elevation, and says where to request one.
283
294
  */
284
295
  APPLICATION_ORGANIZATIONS = 'application-organizations',
296
+ /**
297
+ * The data-subject request queue (#2296): every person's requests the controller still owes an answer to, or that
298
+ * need an operator, soonest deadline first.
299
+ *
300
+ * Lists through `dataSubjectRequests | operator_queue`, an application-wide read of personal data, so it needs an
301
+ * application-wide access grant a second platform administrator signed, and records every read, as the tenant
302
+ * directory does. So the destination shows nothing without an elevation, and says where to request one.
303
+ */
304
+ APPLICATION_DATA_SUBJECT_REQUESTS = 'application-data-subject-requests',
285
305
  /**
286
306
  * The application-wide audit trail — every tenant's events plus the ones belonging to no tenant.
287
307
  *
@@ -317,6 +337,16 @@ export enum EngineSettingsDestinationRef {
317
337
  * a different entitlement and a different operator task.
318
338
  */
319
339
  APPLICATION_INBOUND_DELIVERIES = 'application-inbound-deliveries',
340
+ /**
341
+ * Which of the application's SMS numbers belongs to which organization (#3394): the `smsNumberAssignments` rows that
342
+ * route a received text to its organization's SMS channel handler, with Assign (CREATE) and Withdraw (DELETE).
343
+ *
344
+ * Application-scope, super-admin, because every number sits in the APPLICATION's provider account: no organization can
345
+ * prove a number is its own, so the operator assigns, and an organization never claims (the email domain's
346
+ * organization-side {@link EMAIL_DOMAINS} has a DNS proof a number lacks). Shown only where the SMS capability is
347
+ * enabled, since a number assigned in an application that receives no texts routes nothing.
348
+ */
349
+ APPLICATION_SMS_NUMBERS = 'application-sms-numbers',
320
350
  /**
321
351
  * Whether each declared retention period is being enforced (#1636): one record per retention-sweep run and
322
352
  * bound resource — what it deleted under which period, what a hold kept, and how the run ended. Read-only;
@@ -346,6 +376,18 @@ export enum EngineSettingsDestinationRef {
346
376
  * an organization's own suspensions are on {@link AGENT_POLICY}.
347
377
  */
348
378
  APPLICATION_AGENT_POLICY = 'application-agent-policy',
379
+ /**
380
+ * The APPLICATION's OWN third-party accounts (#3398, #3579): the vendor account the whole deployment acts as toward a
381
+ * provider, which a super-administrator connects, sees the standing of, and disconnects.
382
+ *
383
+ * The third owner of the same feature, beside {@link PROVIDER_CREDENTIALS} (a tenant's) and
384
+ * {@link MY_PROVIDER_CREDENTIALS} (a person's), and never merged with either: the application's grant is spent by
385
+ * every tenant's call that the application makes as itself, so it is the operator's decision, and its rows have no
386
+ * resource route (`GET /connections/linked?ownerScope=application` lists them, `DELETE /connections/application/
387
+ * {connectionRef}` ends one). Super-admin, the role those routes and the connect start leg admit. The connection
388
+ * callback returns an application-owned connection here.
389
+ */
390
+ APPLICATION_PROVIDER_CONNECTIONS = 'application-provider-connections',
349
391
  /**
350
392
  * The billing CATALOGUE the application sells — products, their prices, and promotions.
351
393
  *
@@ -205,15 +205,12 @@ export interface SettingsDestination {
205
205
  * destination the application does not place does not render, which is the whole
206
206
  * point — "we should just place things", with no automatic inference.
207
207
  *
208
- * `label` is optional and is an OVERRIDE. The resolved label otherwise comes from
209
- * the `settings_hub.sections.<ref>.label` key, so a placed section is localizable
210
- * without the application authoring an English string.
211
- *
212
- * That namespace and its resolver (`tSettingsHubSection`) EXIST and already fall
213
- * back to the authored label. What does not exist is anything that generates the
214
- * units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the
215
- * companion plans nothing for it, so today every rail label is the authored
216
- * English string. R9 is a wiring job, not a new mechanism.
208
+ * `label` is the wording INTENT and the runtime fallback. The rail renders the
209
+ * `settings_hub.sections.<ref>.label` word when the bundle has one
210
+ * (`tSettingsHubSection`), and this string when it does not. The companion plans
211
+ * that key for every placed section (`collectSettingsHubLabelKeys`) and hands this
212
+ * string to label generation as the key's purpose, so a section is worded in every
213
+ * locale from what the application wrote here. Omitted, the fallback is the ref.
217
214
  */
218
215
  export interface SettingsPlacement {
219
216
  /** The {@link SettingsDestination.ref} being placed — an engine destination or one of `destinations`. Refused at DEV startup when unknown. */
@@ -293,6 +293,7 @@ export const specificationsCompanionExports: SpecificationsCompanionExports<
293
293
  * reports a vendor-hosted provider a runtime selects that is not named here.
294
294
  */
295
295
  processorRegister: applicationProcessorRegister,
296
+ translationGlossary,
296
297
  };
297
298
  ```
298
299
 
@@ -125,6 +125,8 @@ export interface SpecificationsCompanionExports<
125
125
  TBrandNameScreening = BrandNameScreening,
126
126
  // Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
127
127
  TServiceMethod = ServiceMethod,
128
+ // Appended STRICTLY LAST: the regimes research established for the product (#3362).
129
+ TCompliancePosture = CompliancePosture,
128
130
  > {
129
131
  resourceSpecifications: TResourceSpecifications;
130
132
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -629,8 +631,10 @@ export interface SpecificationsCompanionExports<
629
631
  */
630
632
  documentationPlan?: TApplicationDocumentationPlan;
631
633
  /**
632
- * THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
633
- * from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
634
+ * THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
635
+ * by being committed. Optional: a chapter is normally written in its own file,
636
+ * `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
637
+ * publication reads those files beside this set and merges them, refusing a chapter declared in both.
634
638
  *
635
639
  * Read by the documentation publication, which joins each body to its planned chapter and publishes
636
640
  * it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
@@ -641,6 +645,15 @@ export interface SpecificationsCompanionExports<
641
645
  * positional parameter would only add a slot for every consumer to skip.
642
646
  */
643
647
  documentationChapters?: ApplicationDocumentationChapterSet;
648
+ /**
649
+ * THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
650
+ * honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
651
+ * `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
652
+ * ignored. Optional: absent means every word is the model's.
653
+ *
654
+ * Typed directly, like `documentationChapters`: no application narrows it.
655
+ */
656
+ translationGlossary?: ApplicationTranslationGlossaryDeclaration;
644
657
  /**
645
658
  * WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
646
659
  * minion's tick may touch, and the providers this application binds (#1495). Read by
@@ -670,6 +683,12 @@ export interface SpecificationsCompanionExports<
670
683
  * playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
671
684
  */
672
685
  serviceMethod?: TServiceMethod;
686
+ /**
687
+ * WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
688
+ * compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
689
+ * creator's own compliance constraints; this carries the researched ones.
690
+ */
691
+ compliancePosture?: TCompliancePosture;
673
692
  /**
674
693
  * Accepted application-declared semantic causality between whole
675
694
  * specification-family states. This is not the registry's physical