@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (803) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +170 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -72,6 +72,7 @@ Before editing, decide which follow-up surfaces are required:
72
72
  | User-facing primitive field | Required | Maybe | Required | Required | Required |
73
73
  | Enum field | Required | Maybe | Required with explicit enum UI | Required with enum semantics | Required for field + values |
74
74
  | FK/reference field | Required | Required | Required if user-facing | Required if meaningful to companion | Required if user-facing |
75
+ | Month-grain period (`z_yearMonth()`) | Required | Add it to `filterFields` if lists are filtered by month | No — the factory declares its display and edit | Required | Field label only |
75
76
  | Discriminator / variant field | Required | Required | Often required | Required | Usually required |
76
77
 
77
78
  Do not continue until you know which columns are "yes" for this field.
@@ -90,6 +91,12 @@ Apply `resource-schema-authoring` for the shared-layer change. At minimum:
90
91
  from your schema without a name for it. Same shape as the FK invariant below: the declaration
91
92
  marks, the barrel resolves
92
93
  - use a special `z_*` factory when the field is a framework domain type
94
+ - a period whose grain is the month (a budget month, a billing month) is `z_yearMonth()`, stored `YYYY-MM`, never a
95
+ `z.date()` on the 1st. A `filterFields` entry for it may stay `z.string()`: the list panel reads the row's
96
+ declaration and offers a month picker, and the applied filter reads "October 2026". To filter by a RANGE of
97
+ months ("October to December"), declare `Resources_Filter_YearMonthRangeSchema` (from `@wildo-ai/saas-models`)
98
+ instead: the panel offers two month pickers, both months are included, and one month (`YYYY-MM`) is still
99
+ accepted. The factory refuses it on a field that is not `z_yearMonth()`
93
100
 
94
101
  If engine source is unavailable, load `resource-schema-authoring` and use its
95
102
  source-backed references for the actual framework decorator, factory, and
@@ -91,6 +91,35 @@ export interface BackendOnlyFieldParams {
91
91
  * material is attributable.
92
92
  */
93
93
  isReturnedAtCreation?: boolean;
94
+ /**
95
+ * `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
96
+ * carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
97
+ * every request and response DTO, every listing and every model or tool output.
98
+ *
99
+ * Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
100
+ * as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
101
+ * not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
102
+ * routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
103
+ * personal data. Without this declaration such a row reached its subject with that substance withheld.
104
+ *
105
+ * Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
106
+ * token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
107
+ * reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
108
+ * withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
109
+ *
110
+ * A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
111
+ * by the subject through any request, so it is outside what Art. 20 covers.
112
+ *
113
+ * Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
114
+ * `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
115
+ * `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
116
+ *
117
+ * spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
118
+ *
119
+ * assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
120
+ * export only by this declaration, never by loosening the floor.
121
+ */
122
+ disclosedToSubject?: true;
94
123
  }
95
124
 
96
125
  /**
@@ -268,6 +297,40 @@ export interface BusinessKeySetParams {
268
297
  conflictMessageReference?: string;
269
298
  }
270
299
 
300
+ /**
301
+ * One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
302
+ *
303
+ * Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
304
+ * organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
305
+ * the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
306
+ * filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
307
+ * organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
308
+ *
309
+ * Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
310
+ * an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
311
+ * filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
312
+ * PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
313
+ *
314
+ * Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
315
+ * on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
316
+ * `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
317
+ * object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
318
+ * honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
319
+ * served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
320
+ * supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
321
+ * variants: declare it on a resource whose main schema is a plain object.
322
+ *
323
+ * @example
324
+ * // one tenant's trail, optionally of one event type, newest first
325
+ * z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
326
+ * .compoundIndex(['organizationId', 'eventType', 'createdAt'])
327
+ * .compoundIndex(['organizationId', 'createdAt'])
328
+ */
329
+ export interface CompoundIndexParams {
330
+ /** The indexed fields, in index order: equality filters first, the sort field last. */
331
+ fields: string[];
332
+ }
333
+
271
334
  /**
272
335
  * Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
273
336
  *
@@ -417,7 +480,113 @@ export enum CollectionDisplayMode {
417
480
  CARDS = 'cards',
418
481
  /** Dense table — one column per summary field via the table body. */
419
482
  TABLE = 'table',
483
+ /**
484
+ * One column per value of an enum field, each holding the cards whose row has that value (#2298): a pipeline, a
485
+ * status board. Requires `collectionDisplayConfig.board` ({@link CollectionBoardConfig}), which names the field
486
+ * and, optionally, the operation a card moved to another column calls. Each column reads its own rows under the
487
+ * collection's filters, scope and refresh, a page at a time ("load more"), and counts every row of its value.
488
+ */
489
+ BOARD = 'board',
490
+ /**
491
+ * A month grid, each row on the day its date field falls on (#2298): a schedule, due dates, appointments. Requires
492
+ * `collectionDisplayConfig.calendar` ({@link CollectionCalendarConfig}). The visible weeks are the fetch's window on
493
+ * that field, applied beside the reader's own filters, scope and realtime refresh, and every row of it is read (up to
494
+ * five pages at the LIST ceiling; beyond that a notice counts the rows not shown).
495
+ */
496
+ CALENDAR = 'calendar',
497
+ /**
498
+ * One row per record with a bar from its start to its end over the days of a month (#2298): projects, leave,
499
+ * engagements. Requires `collectionDisplayConfig.timeline` ({@link CollectionTimelineConfig}). The displayed month is
500
+ * the fetch's window (the rows overlapping it), applied beside the reader's own filters, scope and refresh.
501
+ */
502
+ TIMELINE = 'timeline',
503
+ }
504
+
505
+ /**
506
+ * How a collection shown as a BOARD ({@link CollectionDisplayMode.BOARD}) is grouped, and what moving a card does.
507
+ *
508
+ * - `groupByField` names an ENUM field the operation exposes as a filter field. The columns are its values in
509
+ * declaration order (the same vocabulary the filters panel and the quick-filter tabs read), every value has a column
510
+ * even when empty, because a column is also where a card is moved TO. A row holding no value of it sits in a
511
+ * trailing column nothing can be moved into. A field that is not an enum filter field renders the plain cards.
512
+ * - `transitionOperation` names the operation a move calls, with `{ [groupByField]: <target value> }` as its body: a
513
+ * custom transition such as `changeStatus`, or the resource's UPDATE. A plain identifier names every single-row
514
+ * variant of it, and each card calls the highest-rights variant the viewer holds whose `enabledCondition` admits that
515
+ * row, as the action bar does; `[identifier, variantKey]` names one variant only. Omitted, the board is read-only: a card is never moved through an operation
516
+ * nobody declared. A card is movable only when the viewer holds a role the operation admits and the operation's
517
+ * `enabledCondition` admits that row, and a refused move leaves the card where it was and shows the backend's refusal.
518
+ *
519
+ * @example
520
+ * [Op.LIST, { collectionDisplayConfig: {
521
+ * displayMode: CollectionDisplayMode.BOARD,
522
+ * board: { groupByField: 'status', transitionOperation: Tickets_Operations.CHANGE_STATUS },
523
+ * } }]
524
+ */
525
+ export interface CollectionBoardConfig {
526
+ /** The ENUM filter field of the operation whose values are the columns. */
527
+ groupByField: string;
528
+ /** The operation a move calls; omitted makes the board read-only. */
529
+ transitionOperation?: OperationKey;
530
+ }
531
+ export const CollectionBoardConfigSchema: z.ZodType<CollectionBoardConfig> = z.strictObject({
532
+ groupByField: z.string().min(1),
533
+ // An `OperationKey`: an identifier, or `[identifier, variantKey]`. `z.custom` keeps the declared readonly tuple type.
534
+ transitionOperation: z.custom<OperationKey>((value) => (typeof value === 'string' && value.length > 0)
535
+ || (Array.isArray(value) && value.length === 2 && value.every((part) => typeof part === 'string' && part.length > 0))).optional(),
536
+ });
537
+
538
+ /**
539
+ * How a collection shown as a CALENDAR ({@link CollectionDisplayMode.CALENDAR}) places its rows.
540
+ *
541
+ * - `dateField` names a DATE filter field of the operation. Each row sits on the day it holds: a calendar-day field
542
+ * (`isCalendarDate()`) on that day for every reader, an instant on the reader's day in their resolved time zone. The
543
+ * weeks the grid shows become a `{ startDate, endDate }` window on that field for the fetch, narrowed further by the
544
+ * reader's own filter on it, so moving to another month asks the backend for that month's rows. A row with no date
545
+ * is not on the calendar. A field that is not a date filter field renders the plain cards.
546
+ *
547
+ * A row is one day here. A record spanning several days (a start and an end) is the TIMELINE's to show
548
+ * ({@link CollectionTimelineConfig}).
549
+ *
550
+ * @example
551
+ * [Op.LIST, { collectionDisplayConfig: {
552
+ * userSwitchableDisplayMode: true,
553
+ * calendar: { dateField: 'dueDate' },
554
+ * } }]
555
+ */
556
+ export interface CollectionCalendarConfig {
557
+ /** The DATE filter field of the operation whose day places each row. */
558
+ dateField: string;
559
+ }
560
+ export const CollectionCalendarConfigSchema: z.ZodType<CollectionCalendarConfig> = z.strictObject({
561
+ dateField: z.string().min(1),
562
+ });
563
+
564
+ /**
565
+ * How a collection shown as a TIMELINE ({@link CollectionDisplayMode.TIMELINE}) spans its rows.
566
+ *
567
+ * - `startField` and `endField` name two DIFFERENT date filter fields of the operation. Each row's bar runs from the
568
+ * day its start falls on to the day its end falls on, both included (an end before the start draws one day), each
569
+ * field read as on the calendar: a calendar-day field on its UTC day, an instant on the reader's day.
570
+ * - The displayed month is the fetch's window: the start on or before its last day AND the end on or after its first,
571
+ * narrowed further by the reader's own filters on either field. A row missing either date is not on the timeline. A
572
+ * field that is not a date filter field renders the plain cards.
573
+ *
574
+ * @example
575
+ * [Op.LIST, { collectionDisplayConfig: {
576
+ * userSwitchableDisplayMode: true,
577
+ * timeline: { startField: 'startsOn', endField: 'endsOn' },
578
+ * } }]
579
+ */
580
+ export interface CollectionTimelineConfig {
581
+ /** The DATE filter field holding the day a row starts. */
582
+ startField: string;
583
+ /** The DATE filter field holding the day a row ends. */
584
+ endField: string;
420
585
  }
586
+ export const CollectionTimelineConfigSchema: z.ZodType<CollectionTimelineConfig> = z.strictObject({
587
+ startField: z.string().min(1),
588
+ endField: z.string().min(1),
589
+ });
421
590
 
422
591
  /**
423
592
  * Whether a collection's toolbar OFFERS the free-form filters panel (the "Filters" trigger and the
@@ -444,6 +613,24 @@ export enum CollectionFilterPanelVisibility {
444
613
  HIDDEN = 'hidden',
445
614
  }
446
615
 
616
+ /** An embedding host's words for its empty block (`FrontendResourceOperationContext.emptyStateWords`, #3078). */
617
+ export interface EmbeddedCollectionEmptyStateWords {
618
+ /** What is empty, in the host's words: "Nothing awaits your decision". */
619
+ title: string;
620
+ /** An optional second line: what would put a row here. */
621
+ description?: string;
622
+ }
623
+
624
+ /**
625
+ * Whether an embedded collection offers its toolbar (`FrontendResourceOperationContext.collectionToolbar`, #3070).
626
+ */
627
+ export enum CollectionToolbarPresence {
628
+ /** The whole toolbar: search, filters, sort, tabs, pills, view toggle and Create. The default. */
629
+ OFFERED = 'offered',
630
+ /** Rows and pagination only — a block of a larger surface, refined on the collection's own page. */
631
+ HIDDEN = 'hidden',
632
+ }
633
+
447
634
  /**
448
635
  */
449
636
  /**
@@ -456,9 +643,10 @@ export enum CollectionFilterPanelVisibility {
456
643
  * preset needs no filter grammar of its own and no backend change. A window may be open on one side:
457
644
  * "before today" has no start, and the filter treats an absent bound as unbounded on every adapter.
458
645
  *
459
- * Every member is a span of WHOLE calendar days counted from today in the reader's resolved timezone
646
+ * Every member but one is a span of WHOLE calendar days counted from today in the reader's resolved timezone
460
647
  * (member, then organization, then floor), which is the only one that makes "today" true for the person
461
- * reading the screen, and the one the list's own date words use. Over an instant field the window runs
648
+ * reading the screen, and the one the list's own date words use. The exception is `BEFORE_NOW`, whose
649
+ * bound is the instant of the click (#2627); its own JSDoc says how it is read back. Over an instant field the window runs
462
650
  * between that zone's midnights; over a calendar-day field (`isCalendarDate()`) it covers those calendar
463
651
  * days, held as UTC midnights, so a due date is the same day for every reader. Both bounds are included,
464
652
  * as the backend's range filter includes them, so the window ends one millisecond before the day after
@@ -484,12 +672,68 @@ export enum CollectionFilterPresetRelativeRange {
484
672
  * same all day.
485
673
  */
486
674
  BEFORE_TODAY = 'before_today',
675
+ /**
676
+ * Every instant BEFORE NOW: "overdue" for a deadline with a TIME of day (#2627). A callback promised for 10:00 is
677
+ * overdue at 10:01, which `BEFORE_TODAY` cannot say: its whole-day window ends at the last instant of yesterday.
678
+ *
679
+ * Resolved to a window with no start that ends at the instant the pill is clicked. Because that bound is not a day
680
+ * boundary, it cannot be read back by comparing bounds as the day-bound members are (the next render's `now` is a
681
+ * different instant): the pill instead reads as ON for any window of this KIND — no start, ending at an instant
682
+ * earlier today, no later than now. A window picked in the filters panel always ends at the last instant of a day,
683
+ * so the panel can never produce one, and "Overdue" by day and "Overdue" by the minute never read as each other.
684
+ * Like "created today", the pill goes off once the day it was clicked on has ended.
685
+ *
686
+ * Over a CALENDAR-DAY field (`isCalendarDate()`) it is `BEFORE_TODAY`: a date with no time is overdue only once
687
+ * its whole day has passed, so the last day before now that has ended is yesterday.
688
+ */
689
+ BEFORE_NOW = 'before_now',
487
690
  /** Today and the six calendar days after it, in the reader's calendar: "due this week" from today. */
488
691
  NEXT_7_DAYS = 'next_7_days',
489
692
  /** Today and the twenty-nine calendar days after it, in the reader's calendar. */
490
693
  NEXT_30_DAYS = 'next_30_days',
491
694
  }
492
695
 
696
+ /**
697
+ * A RANGE OF MONTHS named relative to the current month, for a preset on a year-month field (#3444): "This quarter" on a
698
+ * list of monthly budgets must still mean this quarter next month, so it cannot be an authored pair of months.
699
+ *
700
+ * It is the month-field counterpart of {@link CollectionFilterPresetRelativeRange} and resolves the same way: when the
701
+ * pill is clicked, counted from TODAY in the reader's resolved time zone (member, then organization, then floor), the
702
+ * today the list's own date words use. A year-month value (`z_yearMonth()`, `YYYY-MM`) is a calendar label rather than
703
+ * an instant, so the window is a pair of month labels, both included: exactly the `{ startMonth, endMonth }` value the
704
+ * filters panel's two month pickers write (`Resources_Filter_YearMonthRangeSchema`), so a pill and the same months
705
+ * picked by hand are one filter, and the backend needs no grammar of its own.
706
+ *
707
+ * A separate vocabulary rather than new members of the date one, because the two resolve to different VALUES for
708
+ * different field kinds: a date window is a pair of instants for a `z.date()` field, a month window is a pair of
709
+ * `YYYY-MM` labels for a year-month field, and a member meaning one cannot be applied to the other. Rejected: a
710
+ * parameterised `{ lastMonths: n }`. Each member below is a span a person asks for by name, and a closed set is the one
711
+ * place its words and its resolution can both be checked.
712
+ *
713
+ * Every member names BOTH bounds, so a window is never open: the rolling ones include the current month, as
714
+ * "the last 7 days" includes today.
715
+ */
716
+ export enum CollectionFilterPresetRelativeMonthRange {
717
+ /** The current month. */
718
+ THIS_MONTH = 'this_month',
719
+ /** The month before the current one. */
720
+ LAST_MONTH = 'last_month',
721
+ /** The month after the current one: next month's budgets, planned ahead. */
722
+ NEXT_MONTH = 'next_month',
723
+ /** The calendar quarter holding the current month (January–March, April–June, July–September, October–December), all three months, the coming ones included. */
724
+ THIS_QUARTER = 'this_quarter',
725
+ /** The calendar quarter before the current one. */
726
+ LAST_QUARTER = 'last_quarter',
727
+ /** The current month and the two before it — a rolling quarter, including this month. */
728
+ LAST_3_MONTHS = 'last_3_months',
729
+ /** The current month and the eleven before it — a rolling year, including this month. */
730
+ LAST_12_MONTHS = 'last_12_months',
731
+ /** January of the current year through the current month. */
732
+ YEAR_TO_DATE = 'year_to_date',
733
+ /** January through December of the current year, the coming months included. */
734
+ THIS_YEAR = 'this_year',
735
+ }
736
+
493
737
  /**
494
738
  * A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
495
739
  * viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
@@ -506,25 +750,35 @@ export enum CollectionFilterPresetContextValue {
506
750
  /**
507
751
  * What a preset ASSIGNS to one filter field.
508
752
  *
509
- * Four kinds, split by WHEN the value is known:
753
+ * Split by WHEN the value is known:
510
754
  *
511
755
  * - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
512
- * which is the whole of "filter to HIGH priority";
513
- * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
514
- * answer would be wrong by tomorrow;
756
+ * which is the whole of "filter to HIGH priority". On a year-month field one `YYYY-MM` month is the range that starts
757
+ * and ends with it, and reads as the same filter as that range picked in the panel;
758
+ * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case on a DATE field, resolved when the pill is clicked,
759
+ * because an authored answer would be wrong by tomorrow;
760
+ * - a RELATIVE MONTH RANGE (`{ relativeMonthRange }`) is the same case on a YEAR-MONTH field (#3444), resolved to the
761
+ * `{ startMonth, endMonth }` pair the panel's month pickers write;
515
762
  * - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
516
763
  * backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
517
764
  * commonest threshold anyone asks for;
765
+ * - a MONTH RANGE (`{ startMonth?, endMonth? }`) is a fixed range of months, such as one fiscal year, written as the
766
+ * panel writes it;
518
767
  * - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
519
768
  * when the pill is clicked, so the same authored preset shows each viewer their own rows.
769
+ *
770
+ * The object members are STRICT. A stripping parse turned an authored `{ startMonth, endMonth }` into the numeric
771
+ * bound `{}` (#3444): a month range silently became "no bound", and the pill filtered nothing under its name.
520
772
  */
521
773
  export const CollectionFilterPresetValueSchema = z.union([
522
774
  z.string(),
523
775
  z.number(),
524
776
  z.boolean(),
525
- z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
526
- z.object({ min: z.number().optional(), max: z.number().optional() }),
527
- z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
777
+ z.strictObject({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
778
+ z.strictObject({ relativeMonthRange: z.enum(CollectionFilterPresetRelativeMonthRange) }),
779
+ z.strictObject({ min: z.number().optional(), max: z.number().optional() }),
780
+ Resources_Filter_YearMonthRangeSchema,
781
+ z.strictObject({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
528
782
  ]);
529
783
  export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
530
784
 
@@ -615,8 +869,7 @@ export enum CardLayoutStyle {
615
869
  * **Historical note (search hit):** earlier versions of this schema exposed an
616
870
  * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
617
871
  * string[]`) operation-level field that authored which resource-owned views
618
- * surfaced in this operation. That field was removed in the
619
- * `resource-owned-view-surfacing-contract.md` workstream because it duplicated
872
+ * surfaced in this operation. That field was removed because it duplicated
620
873
  * the per-view declaration sites (`compositeViews`, `chartViews`,
621
874
  * `executionViews`) and could silently disagree with them. If you are looking
622
875
  * for `additionalViews` because a doc, comment, prompt, or downstream code
@@ -852,7 +1105,7 @@ export interface ResourceActionDisclosureConfig {
852
1105
  /**
853
1106
  * How many PRIMARY actions render as direct buttons before the remainder
854
1107
  * collapse into the `…` overflow menu. Omitted inherits the framework default
855
- * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY and 3 for
1108
+ * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 1 for SUMMARY and 3 for
856
1109
  * DETAIL. `0` pushes every action into the menu.
857
1110
  */
858
1111
  maxPrimaryActions?: number;
@@ -876,8 +1129,15 @@ export interface ResolvedActionDisclosure {
876
1129
  * Framework defaults per view.
877
1130
  *
878
1131
  * - SUMMARY (dense list/table rows) HIDES actions an unmet `enabledCondition`
879
- * disables and caps direct actions at 3 before the `…` menu: on a row, a greyed
880
- * button is noise repeated N times.
1132
+ * disables and caps direct actions at ONE before the `…` menu: on a row, a greyed
1133
+ * button is noise repeated N times. One, because a direct action shows its WORDS by
1134
+ * default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066): three labelled buttons on every
1135
+ * row crowd the record's own name off a 390px phone, while one named verb and a `…`
1136
+ * menu (whose entries carry their words too) fit beside it. The verb that keeps the slot
1137
+ * is the first one that can run, in `displayPriority` order (`allocateActionBarSlots`).
1138
+ * It was 3 icon-only buttons until 2026-10-22, which on Wonder Procurement drew a pencil,
1139
+ * a paper plane and a "ban" circle per request, none of them saying what it did. On a phone
1140
+ * the row keeps none (`MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS`).
881
1141
  * - DETAIL (the read view, and the bulk bar's disabled-action handling) SHOWS them.
882
1142
  * On the record's own action bar it also caps direct actions at 3 before the `…`
883
1143
  * menu, since the record header puts them on the name's own line. The bulk bar
@@ -896,7 +1156,7 @@ export interface ResolvedActionDisclosure {
896
1156
  */
897
1157
  export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
898
1158
  [ResourceOperationDisplayMode.SUMMARY]: {
899
- maxPrimaryActions: 3,
1159
+ maxPrimaryActions: 1,
900
1160
  disabledActionHandling: DisabledActionHandling.HIDE,
901
1161
  },
902
1162
  /*
@@ -920,6 +1180,30 @@ export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, Res
920
1180
  },
921
1181
  };
922
1182
 
1183
+ /**
1184
+ * How many direct actions a list row keeps on a PHONE when the resource authored no cap: none — every action is
1185
+ * in the row's `…` menu, which shows each action's words (#3066).
1186
+ *
1187
+ * One labelled verb fits beside a record's name on a desktop row; on a 390px phone it does not. Measured on Wonder
1188
+ * Procurement: "Cancel Purchase Request" beside a request's status pill truncated the request's title to a few
1189
+ * letters. A phone row is opened with a tap, so its verbs belong in the menu, the way established list patterns
1190
+ * hide their row shortcuts on small screens. A resource that authored `actionDisclosure[SUMMARY].maxPrimaryActions`
1191
+ * keeps it on every screen.
1192
+ */
1193
+ export const MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS = 0;
1194
+
1195
+ /**
1196
+ * How many direct actions the record page header keeps on a PHONE when the resource authored no cap: one, beside the
1197
+ * `…` menu (#3066).
1198
+ *
1199
+ * The header keeps three on a wider screen, and each shows its words. At 390px three labelled verbs do not fit on
1200
+ * the line beneath the record's name, and they do not wrap: measured on Wonder Procurement ("Edit Draft", "Submit
1201
+ * Purchase Request", "Cancel Purchase Request") and on Your Application, the third verb and the `…` menu ran off the right
1202
+ * edge and could not be reached. One named verb and the menu fit; the verb is the first that can run, in
1203
+ * `displayPriority` order.
1204
+ */
1205
+ export const MOBILE_DETAIL_MAX_PRIMARY_ACTIONS = 1;
1206
+
923
1207
  /**
924
1208
  * Resolve the effective disclosure policy for a view: per-resource override
925
1209
  * (`layout.actionDisclosure[view]`) layered over the framework default. Used by
@@ -1094,6 +1378,27 @@ export const ResourceOperationFrontendConfigSchema = z.object({
1094
1378
  collectionDisplayConfig: z.object({
1095
1379
  displayMode: z.enum(CollectionDisplayMode).optional(),
1096
1380
  userSwitchableDisplayMode: z.boolean().optional(),
1381
+ /**
1382
+ * The BOARD presentation: the field its columns come from and the operation a move calls. See
1383
+ * {@link CollectionBoardConfig}. Required when `displayMode` is `BOARD`, and offered by the view-mode toggle beside
1384
+ * CARDS and TABLE when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
1385
+ * (`collectionBoardConfigurationDefect`): a board naming no field, a field that is not a filter field of the operation,
1386
+ * a transition naming no operation of the resource, or a `board` no mode can reach refuses to start.
1387
+ */
1388
+ board: CollectionBoardConfigSchema.optional(),
1389
+ /**
1390
+ * The CALENDAR presentation: the date field each row sits on. See {@link CollectionCalendarConfig}. Required when
1391
+ * `displayMode` is `CALENDAR`, and offered by the view-mode toggle when `userSwitchableDisplayMode` is on. Checked
1392
+ * when the frontend registry is built (`collectionTemporalDisplayConfigurationDefect`).
1393
+ */
1394
+ calendar: CollectionCalendarConfigSchema.optional(),
1395
+ /**
1396
+ * The TIMELINE presentation: the date fields each row's bar starts and ends on. See
1397
+ * {@link CollectionTimelineConfig}. Required when `displayMode` is `TIMELINE`, and offered by the view-mode toggle
1398
+ * when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
1399
+ * (`collectionTemporalDisplayConfigurationDefect`).
1400
+ */
1401
+ timeline: CollectionTimelineConfigSchema.optional(),
1097
1402
  /**
1098
1403
  * Promote ONE enum filter field to the collection toolbar's first line: a
1099
1404
  * segmented control ("All · <value> · <value> …" — the Stripe/Ignisign
@@ -1125,7 +1430,9 @@ export const ResourceOperationFrontendConfigSchema = z.object({
1125
1430
  * { ref: 'urgent', filters: { priority: 'high' } },
1126
1431
  * { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
1127
1432
  * { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
1433
+ * { ref: 'callback-missed', filters: { callbackAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_NOW } } },
1128
1434
  * { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
1435
+ * { ref: 'this-quarter', filters: { period: { relativeMonthRange: CollectionFilterPresetRelativeMonthRange.THIS_QUARTER } } },
1129
1436
  * ]
1130
1437
  */
1131
1438
  presetFilters: z.array(CollectionFilterPresetSchema).optional(),
@@ -115,10 +115,6 @@ export const moduleResourcesConfigurationsFactoryMap: ResourceConfiguration_Init
115
115
  [TasksManager_ResourceType.TEAM_GOALS]: teamGoals_ResourceConfiguration_InitializationFactory,
116
116
  [TasksManager_ResourceType.ORGANIZATION_ESCALATION_CONTACTS]: organizationEscalationContacts_ResourceConfiguration_InitializationFactory,
117
117
  [TasksManager_ResourceType.ORGANIZATION_ESCALATION_POLICIES]: organizationEscalationPolicies_ResourceConfiguration_InitializationFactory,
118
- [TasksManager_ResourceType.EXTERNAL_CUSTOMERS]: externalCustomers_ResourceConfiguration_InitializationFactory,
119
- [TasksManager_ResourceType.BILLABLE_SERVICES]: billableServices_ResourceConfiguration_InitializationFactory,
120
- [TasksManager_ResourceType.CUSTOMER_INVOICES]: customerInvoices_ResourceConfiguration_InitializationFactory,
121
- [TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS]: accountErasureRequests_ResourceConfiguration_InitializationFactory,
122
118
  [TasksManager_ResourceType.KNOWLEDGE_DOCUMENTS]: knowledgeDocuments_ResourceConfiguration_InitializationFactory,
123
119
  [TasksManager_ResourceType.TODO_LIST_REMINDER_RULES]: todoListReminderRules_ResourceConfiguration_InitializationFactory,
124
120
  [TasksManager_ResourceType.EXPENSE_RECEIPTS]: expenseReceipts_ResourceConfiguration_InitializationFactory,
@@ -202,9 +198,16 @@ check as owed rather than skipping it.
202
198
  `wildo.tech-doc.config.ts`, and `wildo docs publish` refuses until every
203
199
  documented resource is in one category. Add the resource's name (its
204
200
  `<Module>_ResourceType` value) to the `resourceNames` of the category it
205
- belongs in.
201
+ belongs in. When the framework already names that part of the product
202
+ (notifications, organizations, compliance…), file it there with an
203
+ `{ engineCategory: '<id>', resourceNames: [...] }` entry rather than
204
+ declaring a category of the same name: a category may not repeat a
205
+ framework category's id or label. The ids and their labels are in
206
+ `references/framework-engine-api-reference-categories-api.md`.
206
207
  - A category "names" a resource the reference does not document: you RENAMED
207
208
  or REMOVED a resource. Edit the same list.
209
+ - A category names "an engine resource": framework resources are grouped by
210
+ the framework and cannot be listed. Remove the name.
208
211
 
209
212
  Without the companion, look for a declaration, not just the word (a generated
210
213
  documentation config mentions the key in a comment):
@@ -225,6 +228,7 @@ module barrel (`index.ts`) if siblings re-export theirs.
225
228
 
226
229
  - `references/scaffold-surfaces-checklist.md` — surface checklist before "done"
227
230
  - `references/framework-new-resource-core-config-api.md` — source-backed core operation / resource type / builder params
231
+ - `references/framework-engine-api-reference-categories-api.md` — source-backed framework API-reference categories (`engineCategory` ids and labels)
228
232
  - `resource-config-wiring` → `references/framework-saas-models-resource-config-api.md` — typed config surface when authoring `resources-config`
229
233
  - `resource-config-wiring` → `references/framework-personal-data-declaration-api.md` — **read once per new resource**: do its rows describe a person, and the four ways to answer
230
234
 
@@ -0,0 +1,119 @@
1
+ # Framework API-reference categories (source)
2
+
3
+ Read this when the documentation service's `wildo.tech-doc.config.ts` declares
4
+ `apiReferenceResourceCategories` and a new resource belongs to a part of the
5
+ product the framework already names.
6
+
7
+ - Each `EngineResourceSubDomain` value is a category the framework already uses
8
+ for its own resources; the matching `label` is the heading a reader sees.
9
+ - File the new resource there with
10
+ `{ engineCategory: '<value>', resourceNames: ['<resource>'] }`. The entry
11
+ takes the framework's label and description, so the resource joins that
12
+ group instead of starting a second one.
13
+ - Declare a category of your own (`id`, `label`, `description`) only for a part
14
+ the framework has no word for. Its id and label may not repeat a value or a
15
+ label below.
16
+
17
+ ## Import Origins
18
+
19
+ - `@wildo-ai/saas-specifications`
20
+
21
+ ## Source Excerpts
22
+
23
+ ### Origin Package: `@wildo-ai/saas-specifications`
24
+
25
+ ```typescript
26
+ export enum EngineResourceSubDomain {
27
+ /** The application itself as a record: its metadata, versions, API keys and OAuth clients. */
28
+ APPLICATIONS = 'applications',
29
+ /** Proving who is calling and what they may delegate: sessions, MFA, SSO/SCIM, OAuth, consumable tokens. */
30
+ AUTH = 'auth',
31
+ /** Money: products, plans, subscriptions, invoices, payments and the provider events behind them. */
32
+ BILLING = 'billing',
33
+ /** What an operator must be able to SAY: governed documents, privacy notices, evidence. */
34
+ COMPLIANCE = 'compliance',
35
+ /** What the application offers and to whom: features, products, milestones. */
36
+ FEATURES = 'features',
37
+ /** Uploaded bytes and the metadata that links them to a domain row. */
38
+ FILES = 'files',
39
+ /** Work that runs: flows, actors, tasks, agents and their execution records. */
40
+ FLOWS_ACTORS = 'flows-actors',
41
+ /** Leading a user through something: onboarding, guidance flows, their state. */
42
+ GUIDANCE = 'guidance',
43
+ /** The machinery an application runs ON: jobs, seeding, ETL, webhooks, integration plumbing. */
44
+ INFRASTRUCTURE = 'infrastructure',
45
+ /** Telling someone: email, in-app notifications, their templates and delivery records. */
46
+ NOTIFICATIONS = 'notifications',
47
+ /** The tenant: organizations, their members, invitations, units and settings. */
48
+ ORGANIZATIONS = 'organizations',
49
+ /** The person: user records, profiles, preferences, roles and their assignments. */
50
+ USERS = 'users',
51
+ }
52
+
53
+ /**
54
+ * The words a READER meets for each engine sub-domain.
55
+ *
56
+ * The enum member carries a machine identity and a JSDoc meaning; a JSDoc comment is not reachable
57
+ * at runtime, so a surface that has to SHOW a sub-domain either re-invents the words or humanizes
58
+ * the value — and `flows-actors` humanized is "Flows actors", which is not what anybody would write.
59
+ * This is the same authoring the enum's docstrings already do, made reachable, so the twelve values
60
+ * are worded ONCE for every surface that presents them.
61
+ *
62
+ * `label` is the group's name; `description` is one sentence a customer can read before deciding
63
+ * whether the group is the one they want. Both are deliberately written for someone OUTSIDE the
64
+ * framework — a generated application's API reference is the first consumer — rather than for a
65
+ * framework maintainer, which is why they do not simply restate the enum's internal meanings.
66
+ *
67
+ * Exhaustive by type: a thirteenth sub-domain does not compile until it has been worded.
68
+ */
69
+ export const ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION: Readonly<Record<EngineResourceSubDomain, { readonly label: string; readonly description: string }>> = {
70
+ [EngineResourceSubDomain.APPLICATIONS]: {
71
+ label: 'Application',
72
+ description: 'The application itself as a record: its metadata, its versions, and the credentials that reach it.',
73
+ },
74
+ [EngineResourceSubDomain.AUTH]: {
75
+ label: 'Authentication and access',
76
+ description: 'Proving who is calling and what they may do on someone else\'s behalf: sessions, multi-factor, SSO, SCIM and OAuth.',
77
+ },
78
+ [EngineResourceSubDomain.BILLING]: {
79
+ label: 'Billing',
80
+ description: 'What is offered and what is owed: plans, subscriptions, invoices, payments and usage.',
81
+ },
82
+ [EngineResourceSubDomain.COMPLIANCE]: {
83
+ label: 'Compliance',
84
+ 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.',
85
+ },
86
+ [EngineResourceSubDomain.FEATURES]: {
87
+ label: 'Features and entitlements',
88
+ description: 'What the application offers and who is entitled to it.',
89
+ },
90
+ [EngineResourceSubDomain.FILES]: {
91
+ label: 'Files',
92
+ description: 'Uploaded content and the records that attach it to the rest of the application.',
93
+ },
94
+ [EngineResourceSubDomain.FLOWS_ACTORS]: {
95
+ label: 'Automation',
96
+ description: 'Work that runs on its own: flows, agents, the tasks they carry out and the record of each run.',
97
+ },
98
+ [EngineResourceSubDomain.GUIDANCE]: {
99
+ label: 'Onboarding and guidance',
100
+ description: 'Leading someone through something, and remembering how far they have got.',
101
+ },
102
+ [EngineResourceSubDomain.INFRASTRUCTURE]: {
103
+ label: 'Operations and integration',
104
+ description: 'The machinery the application runs on: scheduled work, data loading, webhooks and event delivery.',
105
+ },
106
+ [EngineResourceSubDomain.NOTIFICATIONS]: {
107
+ label: 'Notifications',
108
+ description: 'Telling someone: email, in-app messages, and the record of what was sent.',
109
+ },
110
+ [EngineResourceSubDomain.ORGANIZATIONS]: {
111
+ label: 'Organizations',
112
+ description: 'The customer account: organizations, their members, their units and their settings.',
113
+ },
114
+ [EngineResourceSubDomain.USERS]: {
115
+ label: 'People',
116
+ description: 'The person: their account, profile, preferences and what they are allowed to do.',
117
+ },
118
+ };
119
+ ```