@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -25,8 +25,7 @@
25
25
  * enums) should NOT pay that cost.
26
26
  *
27
27
  * This subpath exposes that minimal stable surface, sourced from
28
- * side-effect-free atom files (saas-models-public-runtime.md K-1 / K-2 /
29
- * K-4):
28
+ * side-effect-free atom files:
30
29
  *
31
30
  * - Cross-Frontend Handoff + Token Exchange DTO atoms
32
31
  * (`../security/authentications/cross-frontend-handoff.shared.dto.schemas`):
@@ -35,8 +34,7 @@
35
34
  * `TokenExchangeResponseSchema`,
36
35
  * `CrossFrontendHandoffRequest`, `CrossFrontendHandoffResponse`,
37
36
  * `TokenExchangeRequest`, `TokenExchangeResponse`. The token-exchange
38
- * schemas were added
39
- * in cross-app-jwt-propagation.md Step 5 — every receiver of an
37
+ * schemas live here because every receiver of an
40
38
  * AUTH_CODE_EXCHANGE token (SaaS app, docs site) is by construction
41
39
  * a client-bundle target, so the response shape MUST live here too
42
40
  * (not just in the heavy backend schemas barrel).
@@ -52,15 +50,15 @@
52
50
  * conditional.
53
51
  * - Canonical HTTP header keys (`../requests/header-keys.shared`):
54
52
  * `WildoHeaderKeys` (already a zero-dep `as const` atom — re-exported
55
- * whole; per K-2 splitting it would itself violate DRY).
53
+ * whole; splitting it further would itself violate DRY).
56
54
  * - Locale enums (re-exported transparently from
57
55
  * `@wildo-ai/presets-components-models/public-runtime`):
58
56
  * `AvailableLanguage`, `TextDirection`. Consumers see ONE import path
59
57
  * (`@wildo-ai/saas-models/public-runtime`) — the
60
58
  * `presets-components-models/public-runtime` subpath is an internal
61
- * seam (saas-models-public-runtime.md K-6).
59
+ * seam.
62
60
  *
63
- * @wildo-boundary (saas-models-public-runtime.md K-3)
61
+ * @wildo-boundary
64
62
  * - This file and every file it transitively imports MUST NOT import from:
65
63
  * `@wildo-ai/zod-decorators`, `@wildo-ai/external-connectors-models`,
66
64
  * the `@wildo-ai/presets-components-models` ROOT barrel (only the
@@ -79,19 +77,18 @@
79
77
  * `initZodDecorators()` invocation, `reflect-metadata`, the full
80
78
  * `authentication.shared.dto.schemas.ts` web of types
81
79
  * (`UserContextSchema`, `SessionType`, `AuthMethod`, `AuthFactorLevel`,
82
- * `AuthSessionPurpose`, `AuthUtils`). The Step 5 vitest boundary test
83
- * snapshots `Object.getOwnPropertyNames(z.ZodType.prototype)` before and
84
- * after importing this module and asserts the prototype is unchanged
85
- * (proof that `initZodDecorators` did NOT run).
80
+ * `AuthSessionPurpose`, `AuthUtils`). `src/__tests__/public-runtime.boundary.test.ts`
81
+ * walks this barrel's import closure and refuses any forbidden specifier
82
+ * (a static check; its header says why it is not a runtime prototype
83
+ * snapshot).
86
84
  *
87
85
  * @wildo-dry-contract
88
86
  * Every atom exposed here lives in EXACTLY one source file. The original
89
87
  * home (e.g. `authentication.shared.dto.schemas.ts`,
90
88
  * `localization/language.shared.schemas.ts`) re-exports from the same atom
91
89
  * so existing root-barrel consumers keep working unchanged. Adding a new
92
- * atom: split it out of its current heavy file FIRST (matching K-2
93
- * protocol), add a re-export at the original home, then add the import
94
- * here. NEVER duplicate a declaration into a `_public-runtime/` folder.
90
+ * atom: split it out of its current heavy file FIRST, add a re-export at
91
+ * the original home, then add the import here (call this the atom rule). NEVER duplicate a declaration into a `_public-runtime/` folder.
95
92
  */
96
93
 
97
94
  export {
@@ -129,6 +126,14 @@ export {
129
126
  describeCaughtErrorWithKind,
130
127
  } from '../errors/caught-error-description.shared.utils';
131
128
 
129
+ /**
130
+ * The string-aware comment blankers, for code that reads source or a stylesheet as text.
131
+ *
132
+ * On this seam because their readers include a browser bundle (the 2D layouts read their own stylesheet at runtime) and
133
+ * contracts that must stay light. The source atom imports nothing, so it adds nothing to the budget.
134
+ */
135
+ export { blankSourceComments, blankStylesheetComments } from '../source-text/source-comments.shared.utils';
136
+
132
137
  export { WildoHeaderKeys } from '../requests/header-keys.shared';
133
138
 
134
139
  /** The public submission challenge (#1735): answers a browser form encodes and solves. Imports nothing. */
@@ -149,6 +154,16 @@ export {
149
154
  type SubmissionChallengeResponse,
150
155
  } from '../security/submission-challenge/submission-challenge.shared';
151
156
 
157
+ /**
158
+ * The CSP violation collector every application backend serves (#2867): its path and its Reporting API endpoint name.
159
+ * On this seam because the CSP composer (`@wildo-ai/platform-config-lib`) names the route in every frontend policy.
160
+ * Imports nothing.
161
+ */
162
+ export {
163
+ CSP_VIOLATION_REPORTING_ENDPOINT_NAME,
164
+ CSP_VIOLATION_REPORTS_PATH,
165
+ } from '../security/csp-violation-reports/csp-violation-reports.shared';
166
+
152
167
  /**
153
168
  * Main API mount prefix (`/api/v1`) — the SINGLE SOURCE OF TRUTH for the path
154
169
  * under which the entire main controllers registry is served. Exposed on the
@@ -222,8 +237,7 @@ export {
222
237
  } from '@wildo-ai/presets-components-models/public-runtime';
223
238
 
224
239
  /**
225
- * Provider metadata atom (provider-registration-refactor §Phase 0.1 +
226
- * §Phase 1.g). The schema is built with plain Zod (no decorator
240
+ * Provider metadata atom. The schema is built with plain Zod (no decorator
227
241
  * framework) and the type is `z.infer<…>`. Re-exported here so the
228
242
  * browser-bound `@wildo-ai/external-connectors-public/app`,
229
243
  * `@wildo-ai/external-connectors-public/techdoc`, and
@@ -232,11 +246,15 @@ export {
232
246
  * root barrel (which would boot `initZodDecorators()`).
233
247
  */
234
248
  export {
249
+ buildProviderConnectionParameterLabelKey,
250
+ buildProviderCredentialFieldLabelKey,
235
251
  buildProviderDisplayNameLabelKey,
252
+ buildProviderVendorRegistrationStepLabelKey,
236
253
  defineProviderMetadata,
237
254
  ENGINE_PROVIDER_ORIGIN,
238
255
  ProviderCatalogueProvenanceSchema,
239
256
  ProviderCatalogueSource,
257
+ ProviderCredentialFieldTextSlot,
240
258
  ProviderIdentitySchema,
241
259
  ProviderMetadataSchema,
242
260
  ProviderOriginKind,
@@ -262,12 +280,14 @@ export {
262
280
  * facets' module graph. It is a closed enum over two string members with no Zod decorators and no
263
281
  * side effects, which is the same bar the tier rule below is exported under. `ProviderComplianceDetermination` and
264
282
  * `ProviderComplianceFact` (#1708) meet the same bar: a browser facet writes an UNDETERMINED profile, or cites the
265
- * facts its evidence establishes, with their members.
283
+ * facts its evidence establishes, with their members. `ProviderProcessingRegionReachKind` (#3513) likewise: a facet states
284
+ * how each of its regions is reached.
266
285
  */
267
286
  export {
268
287
  ProviderDeploymentModel,
269
288
  ProviderComplianceDetermination,
270
289
  ProviderComplianceFact,
290
+ ProviderProcessingRegionReachKind,
271
291
  ProviderComplianceProfileSchema,
272
292
  establishedProviderComplianceProfile,
273
293
  type EstablishedProviderComplianceProfile,
@@ -476,8 +496,7 @@ export {
476
496
  export { ChatIdentityLinkHost, parseChatIdentityLinkHost } from '../inbound/chat-identity-link-host.shared.types';
477
497
 
478
498
  /**
479
- * Provider capability atoms (provider-registration-refactor §Phase 0.2
480
- * + §Phase 1.g). Closed built-in enum + open declaration-merging seam
499
+ * Provider capability atoms. Closed built-in enum + open declaration-merging seam
481
500
  * + computed union type. Pure types and `as const` — no Zod, no
482
501
  * decorators, no side effects. Required by every facet's provider
483
502
  * module shape, so it MUST live on the bundle-safe seam.
@@ -496,8 +515,7 @@ export {
496
515
  } from '../external-providers/provider-protocol.shared.schemas';
497
516
 
498
517
  /**
499
- * Generic registry composition core (provider-registration-refactor
500
- * §Phase 1.e + §Phase 1.g). Used by every facet's `compose<Facet>Providers`
518
+ * Generic registry composition core. Used by every facet's `compose<Facet>Providers`
501
519
  * wrapper (backend, frontend-app, frontend-techdoc, frontend-website).
502
520
  * The browser-bound facets need this on the bundle-safe seam; the backend
503
521
  * facet inherits via the same import path for DRY.
@@ -525,8 +543,8 @@ export {
525
543
  * whose bundle-isolation allow-list had to admit an entire authoring domain to obtain seven
526
544
  * regexes.
527
545
  *
528
- * No K-2 extraction was needed: `portable-primitives.meta-workflows.shared.schemas` imports `zod`
529
- * and nothing else, so it is already the zero-dependency atom K-2 asks for — the
546
+ * No atom-rule extraction was needed: `portable-primitives.meta-workflows.shared.schemas` imports `zod`
547
+ * and nothing else, so it is already the zero-dependency atom that rule asks for — the
530
548
  * `WildoHeaderKeys` case, re-exported whole. The meta-workflows door keeps publishing it for its
531
549
  * 34 mixed consumers; that is two SUBPATHS onto one atom, which `check:package-entrypoints` rule 1
532
550
  * does not refuse (it is root-vs-subpath), and it is what a curated bundle-safe subset IS.
@@ -53,8 +53,9 @@ export enum RagRetrievalRefusalReason {
53
53
  OPERATION_ROLES_DENIED = 'operation-roles-denied',
54
54
  /**
55
55
  * The READ authorization context for this resource could not be BUILT, so its role gate could not
56
- * be evaluated at all: the resource exposes no resolvable READ operation, or the sub-call budget
57
- * (depth / cycle detection) refused the context.
56
+ * be evaluated at all: the resource exposes no resolvable READ operation, the sub-call budget
57
+ * (depth / cycle detection) refused the context, or the store could not answer the reads that
58
+ * decide the resource's row confinement for the caller (#3066).
58
59
  *
59
60
  * Deliberately NOT folded into {@link OPERATION_ROLES_DENIED}. That one is an answer; this one is
60
61
  * the absence of a question, and reporting an unbuildable context as a role refusal would send an
@@ -354,7 +354,12 @@ export enum AssuranceProgramObligationSourceBasis {
354
354
  NONE_BY_DESIGN = "NONE_BY_DESIGN",
355
355
  }
356
356
 
357
- /** Conditional enforcement effect once a later, separately governed lifecycle assessment activates the obligation. */
357
+ /**
358
+ * What an obligation does before launch when it is not met (#55). A HARD obligation that applies (or whose applicability
359
+ * is undetermined) and is not met — an open gap, an expired acceptance, no approved coverage decision — is listed on the
360
+ * launch list (`deriveLaunchBlockers`, read through `deriveUnmetHardObligations`), which Gate 3 reads. ADVISORY never is.
361
+ * Both MARK and never block creation (`application-creation-directive.md`); arming the HARD half is Gate 3's.
362
+ */
358
363
  export enum AssuranceProgramObligationBlockingEffect {
359
364
  HARD = "HARD",
360
365
  ADVISORY = "ADVISORY",
@@ -791,9 +796,12 @@ export const AssuranceEvidenceRequirementBodySchema = z.strictObject({
791
796
  /**
792
797
  * Whether the demand applies to THIS application at all, and how a judge decides.
793
798
  *
794
- * First field on purpose. `subject-erasure-execution-record` is majority application-owned, and an
795
- * application that never built an erasure lane has not failed a control — it declared none. A body
796
- * without this field invites a nonconformity against every application that does not implement it.
799
+ * First field on purpose. A demand whose control an application may legitimately not have (an
800
+ * `externalDataPipeline` with the OWNED_COPY posture, for `erasure-propagation-record` C5) has not
801
+ * failed where it was never declared. A body without this field invites a nonconformity against every
802
+ * application that does not implement it. (`subject-erasure-execution-record` was the first such body,
803
+ * when the erasure lane was an application's to build; since #2296 the engine owns it and that demand
804
+ * applies to every application.)
797
805
  */
798
806
  applicability: z.string().trim().min(1),
799
807
  clauses: z.array(AssuranceEvidenceRequirementClauseSchema).min(1),
@@ -122,6 +122,8 @@ export interface SpecificationsCompanionExports<
122
122
  TBrandNameScreening = BrandNameScreening,
123
123
  // Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
124
124
  TServiceMethod = ServiceMethod,
125
+ // Appended STRICTLY LAST: the regimes research established for the product (#3362).
126
+ TCompliancePosture = CompliancePosture,
125
127
  > {
126
128
  resourceSpecifications: TResourceSpecifications;
127
129
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -626,8 +628,10 @@ export interface SpecificationsCompanionExports<
626
628
  */
627
629
  documentationPlan?: TApplicationDocumentationPlan;
628
630
  /**
629
- * THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
630
- * from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
631
+ * THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
632
+ * by being committed. Optional: a chapter is normally written in its own file,
633
+ * `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
634
+ * publication reads those files beside this set and merges them, refusing a chapter declared in both.
631
635
  *
632
636
  * Read by the documentation publication, which joins each body to its planned chapter and publishes
633
637
  * it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
@@ -638,6 +642,15 @@ export interface SpecificationsCompanionExports<
638
642
  * positional parameter would only add a slot for every consumer to skip.
639
643
  */
640
644
  documentationChapters?: ApplicationDocumentationChapterSet;
645
+ /**
646
+ * THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
647
+ * honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
648
+ * `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
649
+ * ignored. Optional: absent means every word is the model's.
650
+ *
651
+ * Typed directly, like `documentationChapters`: no application narrows it.
652
+ */
653
+ translationGlossary?: ApplicationTranslationGlossaryDeclaration;
641
654
  /**
642
655
  * WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
643
656
  * minion's tick may touch, and the providers this application binds (#1495). Read by
@@ -667,6 +680,12 @@ export interface SpecificationsCompanionExports<
667
680
  * playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
668
681
  */
669
682
  serviceMethod?: TServiceMethod;
683
+ /**
684
+ * WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
685
+ * compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
686
+ * creator's own compliance constraints; this carries the researched ones.
687
+ */
688
+ compliancePosture?: TCompliancePosture;
670
689
  /**
671
690
  * Accepted application-declared semantic causality between whole
672
691
  * specification-family states. This is not the registry's physical
@@ -0,0 +1,105 @@
1
+ # saas.specifications.engine-resource-sub-domain
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-specifications`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-specifications`
10
+
11
+ ```typescript
12
+ export enum EngineResourceSubDomain {
13
+ /** The application itself as a record: its metadata, versions, API keys and OAuth clients. */
14
+ APPLICATIONS = 'applications',
15
+ /** Proving who is calling and what they may delegate: sessions, MFA, SSO/SCIM, OAuth, consumable tokens. */
16
+ AUTH = 'auth',
17
+ /** Money: products, plans, subscriptions, invoices, payments and the provider events behind them. */
18
+ BILLING = 'billing',
19
+ /** What an operator must be able to SAY: governed documents, privacy notices, evidence. */
20
+ COMPLIANCE = 'compliance',
21
+ /** What the application offers and to whom: features, products, milestones. */
22
+ FEATURES = 'features',
23
+ /** Uploaded bytes and the metadata that links them to a domain row. */
24
+ FILES = 'files',
25
+ /** Work that runs: flows, actors, tasks, agents and their execution records. */
26
+ FLOWS_ACTORS = 'flows-actors',
27
+ /** Leading a user through something: onboarding, guidance flows, their state. */
28
+ GUIDANCE = 'guidance',
29
+ /** The machinery an application runs ON: jobs, seeding, ETL, webhooks, integration plumbing. */
30
+ INFRASTRUCTURE = 'infrastructure',
31
+ /** Telling someone: email, in-app notifications, their templates and delivery records. */
32
+ NOTIFICATIONS = 'notifications',
33
+ /** The tenant: organizations, their members, invitations, units and settings. */
34
+ ORGANIZATIONS = 'organizations',
35
+ /** The person: user records, profiles, preferences, roles and their assignments. */
36
+ USERS = 'users',
37
+ }
38
+
39
+ /**
40
+ * The words a READER meets for each engine sub-domain.
41
+ *
42
+ * The enum member carries a machine identity and a JSDoc meaning; a JSDoc comment is not reachable
43
+ * at runtime, so a surface that has to SHOW a sub-domain either re-invents the words or humanizes
44
+ * the value — and `flows-actors` humanized is "Flows actors", which is not what anybody would write.
45
+ * This is the same authoring the enum's docstrings already do, made reachable, so the twelve values
46
+ * are worded ONCE for every surface that presents them.
47
+ *
48
+ * `label` is the group's name; `description` is one sentence a customer can read before deciding
49
+ * whether the group is the one they want. Both are deliberately written for someone OUTSIDE the
50
+ * framework — a generated application's API reference is the first consumer — rather than for a
51
+ * framework maintainer, which is why they do not simply restate the enum's internal meanings.
52
+ *
53
+ * Exhaustive by type: a thirteenth sub-domain does not compile until it has been worded.
54
+ */
55
+ export const ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION: Readonly<Record<EngineResourceSubDomain, { readonly label: string; readonly description: string }>> = {
56
+ [EngineResourceSubDomain.APPLICATIONS]: {
57
+ label: 'Application',
58
+ description: 'The application itself as a record: its metadata, its versions, and the credentials that reach it.',
59
+ },
60
+ [EngineResourceSubDomain.AUTH]: {
61
+ label: 'Authentication and access',
62
+ description: 'Proving who is calling and what they may do on someone else\'s behalf: sessions, multi-factor, SSO, SCIM and OAuth.',
63
+ },
64
+ [EngineResourceSubDomain.BILLING]: {
65
+ label: 'Billing',
66
+ description: 'What is offered and what is owed: plans, subscriptions, invoices, payments and usage.',
67
+ },
68
+ [EngineResourceSubDomain.COMPLIANCE]: {
69
+ label: 'Compliance',
70
+ description: 'What an operator must be able to state and evidence: governed documents, privacy notices, records, and the audit trail with its export to a SIEM.',
71
+ },
72
+ [EngineResourceSubDomain.FEATURES]: {
73
+ label: 'Features and entitlements',
74
+ description: 'What the application offers and who is entitled to it.',
75
+ },
76
+ [EngineResourceSubDomain.FILES]: {
77
+ label: 'Files',
78
+ description: 'Uploaded content and the records that attach it to the rest of the application.',
79
+ },
80
+ [EngineResourceSubDomain.FLOWS_ACTORS]: {
81
+ label: 'Automation',
82
+ description: 'Work that runs on its own: flows, agents, the tasks they carry out and the record of each run.',
83
+ },
84
+ [EngineResourceSubDomain.GUIDANCE]: {
85
+ label: 'Onboarding and guidance',
86
+ description: 'Leading someone through something, and remembering how far they have got.',
87
+ },
88
+ [EngineResourceSubDomain.INFRASTRUCTURE]: {
89
+ label: 'Operations and integration',
90
+ description: 'The machinery the application runs on: scheduled work, data loading, webhooks and event delivery.',
91
+ },
92
+ [EngineResourceSubDomain.NOTIFICATIONS]: {
93
+ label: 'Notifications',
94
+ description: 'Telling someone: email, in-app messages, and the record of what was sent.',
95
+ },
96
+ [EngineResourceSubDomain.ORGANIZATIONS]: {
97
+ label: 'Organizations',
98
+ description: 'The customer account: organizations, their members, their units and their settings.',
99
+ },
100
+ [EngineResourceSubDomain.USERS]: {
101
+ label: 'People',
102
+ description: 'The person: their account, profile, preferences and what they are allowed to do.',
103
+ },
104
+ };
105
+ ```
@@ -355,7 +355,11 @@ export function resolveEffectiveDocumentRelease(
355
355
  ): GovernedDocumentRelease | undefined {
356
356
  const at = Date.parse(query.at);
357
357
  if (Number.isNaN(at)) return undefined;
358
- const inForce = releases.filter((release) =>
358
+ // Judged on the releases as ENDED by their replacements (#3127): a replaced release records no end of its own, and
359
+ // its replacement may cover another locale or jurisdiction set, so latest-wins below cannot hide it. The record
360
+ // returned is the one passed in, never the projection.
361
+ const ended = withReplacementEnds(releases);
362
+ const inForce = releases.filter((release, index) =>
359
363
  (query.requireApproved !== true || release.approvalState === GovernedDocumentReleaseApprovalState.APPROVED)
360
364
  && release.identity.document.documentRef === query.documentRef
361
365
  && release.locale === query.locale
@@ -367,7 +371,7 @@ export function resolveEffectiveDocumentRelease(
367
371
  * surface offering a release that the recorder then refuses as out of force, or worse, the
368
372
  * reverse.
369
373
  */
370
- && governedDocumentReleaseIsInForce(release, query.at));
374
+ && governedDocumentReleaseIsInForce(ended[index]!, query.at));
371
375
  return latestGovernedDocumentRelease(inForce);
372
376
  }
373
377
 
@@ -280,7 +280,10 @@ export interface ResourceOperationNotificationSpecificationCodeHandling {
280
280
  * Models the engine fan-out faithfully: every entry in the runtime
281
281
  * `userNotifications[]` array whose `channel` is NOT `EMAIL` is one in-app
282
282
  * notification delivery (FRONT_END_SUCCESS toast for the actor, WEBSOCKET push
283
- * to the activity feed, SMS / PUSH when implemented, …). Each delivery is
283
+ * to the activity feed, an SMS text to a consenting recipient's verified phone, …).
284
+ * An SMS delivery's words are NOT a text slot here: they are the label
285
+ * `notifications_custom.<identifier>.sms`, generated from the runtime declaration's
286
+ * own `text.purpose` and `text.params` (#1875). Each delivery is
284
287
  * its own (target, channel) pair at runtime; the spec layer mirrors this so
285
288
  * companion prompts know exactly which surfaces the operation actually
286
289
  * touches, and translators can author per-delivery copy when a specific
@@ -297,7 +300,7 @@ export interface ResourceOperationNotificationDeliverySpecification {
297
300
  */
298
301
  audience: string;
299
302
  /**
300
- * Channel the runtime fires through: a `CoreUserNotificationChannel` member (`EMAIL`, `WEBSOCKET`,
303
+ * Channel the runtime fires through: a `CoreUserNotificationChannel` member (`EMAIL`, `SMS`, `WEBSOCKET`,
301
304
  * `FRONT_END_SUCCESS`). Exactly the channels the dispatcher delivers — the runtime refuses any other at build
302
305
  * (#1874), so a specification naming one would describe a delivery that cannot exist.
303
306
  */
@@ -778,6 +781,18 @@ export interface ResourceOperationErrorScenarioSpecification {
778
781
  /**
779
782
  * A request/response payload example for docs + client codegen. Becomes an
780
783
  * OpenAPI example on the request body and/or the `forStatus` response.
784
+ *
785
+ * An example must be TRUE of the schema it sits beside, and the API reference generator refuses one that is not
786
+ * (#1838): a property the published schema does not have, or, in a request, a required property it leaves out. Name a
787
+ * field exactly as the resource does (`todoListId`, never `listId`), show only what THIS representation returns (a
788
+ * delete answers `{ id }`, a list `{ data, pagination }`, a `summary` row only its summary fields), and leave out of a
789
+ * request what the route's path already carries or what has a default.
790
+ *
791
+ * A variant that declares no `examples` of its own borrows the operation's. On a data-mode projection (`summary` or
792
+ * `context`), whose response has its own shape, a borrowed example that does not describe it is replaced by one
793
+ * generated from that schema rather than refused, since it was not written for it: declare the variant's own
794
+ * `examples` to show it. Any other variant (`admin`, `own`, …) answers with the operation's own representation, so a
795
+ * borrowed example is held to it exactly as on the operation.
781
796
  */
782
797
  export interface ResourceOperationExampleSpecification {
783
798
  /** Short human label, e.g. "Create with assignee". */
@@ -857,7 +872,9 @@ export interface ResourceOperationSpecification {
857
872
  /**
858
873
  * Request/response payload examples for docs + client codegen. Base examples
859
874
  * apply to every variant unless `variants.<key>.examples` provides a complete
860
- * replacement for a divergent variant response schema.
875
+ * replacement for a divergent variant response schema. Each is checked against
876
+ * the schema it illustrates when the API reference is generated (#1838; see
877
+ * {@link ResourceOperationExampleSpecification}).
861
878
  */
862
879
  examples?: ResourceOperationExampleSpecification[];
863
880
  }
@@ -100,83 +100,112 @@ export function resourceSpecification<
100
100
  : getZodObjectShape(schema)
101
101
  ) as ObjectShape<TSchema>;
102
102
 
103
- const config = configFactory({ schema, schemaShape });
104
- if (config.externalDataPipeline !== undefined) {
105
- throw new Error(
106
- 'resourceSpecification(): `externalDataPipeline` is DERIVED from the resource configuration\'s pipeline declaration and cannot be authored. '
107
- + 'Remove it from the specification; supply `resourceRelationships` in the options and the description is attached from the declaration itself.',
108
- );
109
- }
103
+ /*
104
+ * The AUTHORED callback runs OUTSIDE the capture, exactly as every `...FromDefinition` factory calls its draft
105
+ * factory outside it (#3210 re-review): a throw there is the author's module failing to evaluate — most often an
106
+ * enum read as `undefined` because a workspace package has not been re-emitted yet — which is a load error, never
107
+ * this specification being refused. Capturing it would blame the run's spec for a stale build.
108
+ */
109
+ const authoredConfig = configFactory({ schema, schemaShape });
110
+ /*
111
+ * From the derived-field refusals to the last definition-time validator, ONE capture (#3210): a reader evaluating
112
+ * the whole specifications package (the development companion) must get every OTHER resource when this one is
113
+ * refused, so inside a fault-collection window a refusal returns this specification MARKED rather than throwing
114
+ * through the package's import graph. Outside a window `captureSpecificationDefinitionFault` is the bare call and
115
+ * every refusal below throws exactly as before. See `specification-definition-faults.ts`.
116
+ */
117
+ const resourceTypeHint = extractResourceTypeHintFromFactory(_factory);
118
+ let resolvedScope: ReturnType<typeof resolveScopeAndValidatorConfig> | undefined;
119
+ const definitionFault = captureSpecificationDefinitionFault(SpecificationDefinitionKind.RESOURCE, resourceTypeHint, () => {
120
+ const config = authoredConfig;
121
+ if (config.externalDataPipeline !== undefined) {
122
+ throw new Error(
123
+ 'resourceSpecification(): `externalDataPipeline` is DERIVED from the resource configuration\'s pipeline declaration and cannot be authored. '
124
+ + 'Remove it from the specification; supply `resourceRelationships` in the options and the description is attached from the declaration itself.',
125
+ );
126
+ }
110
127
 
111
- // Resolve scope and the runtime config used by the pdfTemplates validator
112
- // from whichever signal the spec author supplied. `resourceRelationships`
113
- // is the preferred path — it materializes the resource configuration once
114
- // with the real registry rels, so scope derives from the same
115
- // `isPrimaryScope: true` signal the runtime uses, AND the validator gets
116
- // a pre-resolved config (avoiding the failing `_factory([])` call for
117
- // resources whose primary scope comes from a parent rel).
118
- if (config.recordLabelFields !== undefined) {
119
- throw new Error(
120
- 'resourceSpecification(): `recordLabelFields` is DERIVED from the resource configuration and cannot be authored (#2779). '
121
- + 'Remove it from the specification; supply `resourceRelationships` in the options and it is attached from the configuration itself.',
122
- );
123
- }
128
+ // Resolve scope and the runtime config used by the pdfTemplates validator
129
+ // from whichever signal the spec author supplied. `resourceRelationships`
130
+ // is the preferred path — it materializes the resource configuration once
131
+ // with the real registry rels, so scope derives from the same
132
+ // `isPrimaryScope: true` signal the runtime uses, AND the validator gets
133
+ // a pre-resolved config (avoiding the failing `_factory([])` call for
134
+ // resources whose primary scope comes from a parent rel).
135
+ if (config.recordLabelFields !== undefined) {
136
+ throw new Error(
137
+ 'resourceSpecification(): `recordLabelFields` is DERIVED from the resource configuration and cannot be authored (#2779). '
138
+ + 'Remove it from the specification; supply `resourceRelationships` in the options and it is attached from the configuration itself.',
139
+ );
140
+ }
124
141
 
125
- const { declaredScope, validatorResourceConfig } = resolveScopeAndValidatorConfig(
126
- _factory,
127
- options,
128
- );
142
+ resolvedScope = resolveScopeAndValidatorConfig(_factory, options);
143
+ const { declaredScope } = resolvedScope;
129
144
 
130
- validateResourceOperationsCommunications(
131
- 'operations.',
132
- config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
133
- declaredScope,
134
- );
135
- validateResourceOperationsCommunications(
136
- 'frontend.views.',
137
- config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
138
- declaredScope,
139
- );
140
- validateResourceOperationsScheduledExecution(
141
- 'operations.',
142
- config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
143
- );
144
- validateResourceOperationsErrorScenarios(
145
- 'operations.',
146
- config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
147
- );
148
- validateResourceOperationsScheduledExecution(
149
- 'frontend.views.',
150
- config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
151
- );
152
- validateResourcePdfTemplates('', config.pdfTemplates, schema, validatorResourceConfig);
153
- validateResourceCollectionExports('', config.collectionExports, Object.keys(config.operations ?? {}));
145
+ validateResourceOperationsCommunications(
146
+ 'operations.',
147
+ config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
148
+ declaredScope,
149
+ );
150
+ validateResourceOperationsCommunications(
151
+ 'frontend.views.',
152
+ config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
153
+ declaredScope,
154
+ );
155
+ validateResourceOperationsScheduledExecution(
156
+ 'operations.',
157
+ config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
158
+ );
159
+ validateResourceOperationsErrorScenarios(
160
+ 'operations.',
161
+ config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
162
+ );
163
+ validateResourceOperationsScheduledExecution(
164
+ 'frontend.views.',
165
+ config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
166
+ );
167
+ validateResourcePdfTemplates('', config.pdfTemplates, schema, resolvedScope.validatorResourceConfig);
168
+ validateResourceCollectionExports('', config.collectionExports, Object.keys(config.operations ?? {}));
154
169
 
155
- // Fail-closed shape validator for `fields` /
156
- // `additionalFieldSpecs`. Runs at module-load time so authors see
157
- // structural mistakes (`meaning` blank, `enumDeclaration` missing,
158
- // `arraySpec.elementMeaning` blank, ENUM-element array missing
159
- // `elementType.enumDeclaration`, etc.) at the call site rather than
160
- // inside a downstream rendered prompt. Registry-presence for
161
- // `foreignKeySpec` is intentionally NOT checked here — `_core` does
162
- // not see `ResourceRelationship[]`; the companion-level completeness
163
- // validator owns that cross-check.
164
- //
165
- // The resource-type hint in the prefix comes from `_factory` (either
166
- // the function's `name` stripped of the `_ResourceConfiguration_
167
- // InitializationFactory` suffix, or — for rare object-form factories —
168
- // the `resourceType` slot directly). Best-effort: when the hint cannot
169
- // be derived, the prefix falls back to the bare `resourceSpecification():`
170
- // label, matching the pre-hint behaviour.
171
- const resourceTypeHint = extractResourceTypeHintFromFactory(_factory);
172
- const fieldShapesPrefix = resourceTypeHint.length > 0
173
- ? `resourceSpecification(${resourceTypeHint}): `
174
- : 'resourceSpecification(): ';
175
- validateFieldShapes(fieldShapesPrefix, {
176
- fields: config.fields as Record<string, z.ZodTypeAny> | undefined,
177
- additionalFieldSpecs: config.additionalFieldSpecs,
170
+ // Fail-closed shape validator for `fields` /
171
+ // `additionalFieldSpecs`. Runs at module-load time so authors see
172
+ // structural mistakes (`meaning` blank, `enumDeclaration` missing,
173
+ // `arraySpec.elementMeaning` blank, ENUM-element array missing
174
+ // `elementType.enumDeclaration`, etc.) at the call site rather than
175
+ // inside a downstream rendered prompt. Registry-presence for
176
+ // `foreignKeySpec` is intentionally NOT checked here — `_core` does
177
+ // not see `ResourceRelationship[]`; the companion-level completeness
178
+ // validator owns that cross-check.
179
+ //
180
+ // The resource-type hint in the prefix comes from `_factory` (either
181
+ // the function's `name` stripped of the `_ResourceConfiguration_
182
+ // InitializationFactory` suffix, or — for rare object-form factories —
183
+ // the `resourceType` slot directly). Best-effort: when the hint cannot
184
+ // be derived, the prefix falls back to the bare `resourceSpecification():`
185
+ // label, matching the pre-hint behaviour.
186
+ const fieldShapesPrefix = resourceTypeHint.length > 0
187
+ ? `resourceSpecification(${resourceTypeHint}): `
188
+ : 'resourceSpecification(): ';
189
+ validateFieldShapes(fieldShapesPrefix, {
190
+ fields: config.fields as Record<string, z.ZodTypeAny> | undefined,
191
+ additionalFieldSpecs: config.additionalFieldSpecs,
192
+ });
178
193
  });
179
194
 
195
+ if (definitionFault !== undefined || resolvedScope === undefined) {
196
+ /*
197
+ * Refused inside a collection window. The returned object is never served: the reader drops every marked
198
+ * specification and reports the fault. It still carries what the callback produced, so a sibling factory handed
199
+ * it as a `base` (`resourceSpecificationFromFrontendConfiguration`) has a value to spread rather than a crash.
200
+ */
201
+ return markSpecificationDefinitionFault(
202
+ { ...authoredConfig, resourcePrimaryScope: resolvedScope?.declaredScope } as ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>,
203
+ definitionFault ?? { kind: SpecificationDefinitionKind.RESOURCE, key: resourceTypeHint, message: 'resourceSpecification(): the definition was refused.', authoredFrame: null },
204
+ );
205
+ }
206
+ const config = authoredConfig;
207
+ const { declaredScope, validatorResourceConfig } = resolvedScope;
208
+
180
209
  // Attach the resolved scope so the frontend-config sibling
181
210
  // (`resourceSpecificationFromFrontendConfiguration`) can read it from
182
211
  // `base.resourcePrimaryScope` and thread it into its own re-validation