@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
@@ -213,13 +213,18 @@ export interface ResourceLayoutConfig {
213
213
  * default (`ComponentStyleTheme.actionLabelDisplayMode`). Omit a key to
214
214
  * inherit the app default for that view.
215
215
  *
216
- * Precedence: `layout.actionLabelDisplayMode[view]` → app theme default → `TOOLTIP`.
216
+ * Precedence: `layout.actionLabelDisplayMode[view]` → app theme default →
217
+ * `DEFAULT_ACTION_LABEL_DISPLAY_MODE` (`INLINE`: every direct action shows its words).
218
+ *
219
+ * Leave it unset unless the surface has a reason to differ: an action's icon is
220
+ * understood alone only for the few glyphs everyone knows, and never for the
221
+ * application's own verbs. `DROPDOWN` on SUMMARY suits a row whose verbs are all
222
+ * secondary to opening the record (every action in the `…` menu).
217
223
  *
218
224
  * @example
219
- * // Dense list rows stay icon-only; the full detail view spells actions out.
225
+ * // Rows keep every verb in the `…` menu; the record page keeps the default words.
220
226
  * actionLabelDisplayMode: {
221
- * [ResourceOperationDisplayMode.SUMMARY]: ActionLabelDisplayMode.TOOLTIP,
222
- * [ResourceOperationDisplayMode.DETAIL]: ActionLabelDisplayMode.INLINE,
227
+ * [ResourceOperationDisplayMode.SUMMARY]: ActionLabelDisplayMode.DROPDOWN,
223
228
  * }
224
229
  */
225
230
  actionLabelDisplayMode?: Partial<Record<ResourceOperationDisplayMode, ActionLabelDisplayMode>>;
@@ -230,13 +235,13 @@ export interface ResourceLayoutConfig {
230
235
  * and whether actions disabled by an unmet `enabledCondition` are hidden or
231
236
  * greyed (`disabledActionHandling`), keyed by {@link ResourceOperationDisplayMode}.
232
237
  * Omit a view (or a field) to inherit the framework default
233
- * ({@link DEFAULT_ACTION_DISCLOSURE}): SUMMARY = { max 3, hide-disabled },
238
+ * ({@link DEFAULT_ACTION_DISCLOSURE}): SUMMARY = { max 1, hide-disabled },
234
239
  * DETAIL = { max 3, show-disabled — each explains why it cannot run }.
235
240
  *
236
241
  * @example
237
- * // A busy list keeps just one action inline; the detail view keeps its default three.
242
+ * // A list whose rows have room keeps two verbs in view; the detail view keeps its default three.
238
243
  * actionDisclosure: {
239
- * [ResourceOperationDisplayMode.SUMMARY]: { maxPrimaryActions: 1 },
244
+ * [ResourceOperationDisplayMode.SUMMARY]: { maxPrimaryActions: 2 },
240
245
  * }
241
246
  */
242
247
  actionDisclosure?: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>>;
@@ -308,7 +313,7 @@ export interface ResourceLayoutConfig {
308
313
  * <>
309
314
  * {Boolean(data?.color) && <ResourceHeaderLeading><ColorDot value={String(data.color)} /></ResourceHeaderLeading>}
310
315
  * <ResourceHeaderTitle />
311
- * <DisplayField name="status" hideLabel className="w-auto" />
316
+ * <DisplayField name="status" labelPlacement="hidden" className="w-auto" />
312
317
  * {Boolean(data?.isPublic) && <Badge>{fieldLabels.isPublic}</Badge>}
313
318
  * </>
314
319
  * );
@@ -344,7 +349,7 @@ export interface ResourceLayoutConfig {
344
349
  * <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>
345
350
  * <SummaryHeader>
346
351
  * <SummaryTitle />
347
- * <DisplayField name="status" hideLabel />
352
+ * <DisplayField name="status" labelPlacement="hidden" />
348
353
  * </SummaryHeader>
349
354
  * <DisplayField name="createdAt" />
350
355
  * </SummaryLayout>
@@ -352,5 +357,34 @@ export interface ResourceLayoutConfig {
352
357
  */
353
358
  summary?: LayoutTemplate;
354
359
 
360
+ /**
361
+ * Read-failure template — rendered in place of the generic "could not load" notice when this resource's READ fails
362
+ * (#3349).
363
+ *
364
+ * For a record whose READ can fail for a reason its own administrator can act on: a stored row that no longer fits
365
+ * its schema reads as nothing at all, and a generic failure tells the one person who could correct it nothing. The
366
+ * template receives the failure and `askOperation`, which runs a read-like operation of this resource in the READ's own
367
+ * context (the same record and scope): an SSO configuration asks `describeUnreadableFields`, and lists what does not
368
+ * read. It renders inside the page's error state, where `<DisplayField>` has no record to read; words come from the i18n
369
+ * accessors. Without one, the generic notice renders.
370
+ *
371
+ * @example
372
+ * readFailure: ({ askOperation }) => <MyUnreadableNotice load={() => askOperation('describeUnreadableFields')} />
373
+ */
374
+ readFailure?: React.ComponentType<ReadFailureTemplateProps>;
375
+
376
+ }
377
+
378
+ /** What a {@link ResourceLayoutConfig.readFailure} template receives (#3349). Inside the anchor, so the props contract ships with the slot. */
379
+ export interface ReadFailureTemplateProps {
380
+ /** The failure the READ answered. */
381
+ readonly error: unknown;
382
+ /** The context the READ ran in. */
383
+ readonly resourceContext: FrontendResourceOperationContext;
384
+ /**
385
+ * Run one of this resource's operations, by identifier (its default variant), in the READ's own context, silently: the
386
+ * template answers a failure itself. Rejects when the resource declares no such operation.
387
+ */
388
+ readonly askOperation: (operationIdentifier: string) => Promise<unknown>;
355
389
  }
356
390
  ```
@@ -26,7 +26,113 @@ export enum CollectionDisplayMode {
26
26
  CARDS = 'cards',
27
27
  /** Dense table — one column per summary field via the table body. */
28
28
  TABLE = 'table',
29
+ /**
30
+ * One column per value of an enum field, each holding the cards whose row has that value (#2298): a pipeline, a
31
+ * status board. Requires `collectionDisplayConfig.board` ({@link CollectionBoardConfig}), which names the field
32
+ * and, optionally, the operation a card moved to another column calls. Each column reads its own rows under the
33
+ * collection's filters, scope and refresh, a page at a time ("load more"), and counts every row of its value.
34
+ */
35
+ BOARD = 'board',
36
+ /**
37
+ * A month grid, each row on the day its date field falls on (#2298): a schedule, due dates, appointments. Requires
38
+ * `collectionDisplayConfig.calendar` ({@link CollectionCalendarConfig}). The visible weeks are the fetch's window on
39
+ * that field, applied beside the reader's own filters, scope and realtime refresh, and every row of it is read (up to
40
+ * five pages at the LIST ceiling; beyond that a notice counts the rows not shown).
41
+ */
42
+ CALENDAR = 'calendar',
43
+ /**
44
+ * One row per record with a bar from its start to its end over the days of a month (#2298): projects, leave,
45
+ * engagements. Requires `collectionDisplayConfig.timeline` ({@link CollectionTimelineConfig}). The displayed month is
46
+ * the fetch's window (the rows overlapping it), applied beside the reader's own filters, scope and refresh.
47
+ */
48
+ TIMELINE = 'timeline',
49
+ }
50
+
51
+ /**
52
+ * How a collection shown as a BOARD ({@link CollectionDisplayMode.BOARD}) is grouped, and what moving a card does.
53
+ *
54
+ * - `groupByField` names an ENUM field the operation exposes as a filter field. The columns are its values in
55
+ * declaration order (the same vocabulary the filters panel and the quick-filter tabs read), every value has a column
56
+ * even when empty, because a column is also where a card is moved TO. A row holding no value of it sits in a
57
+ * trailing column nothing can be moved into. A field that is not an enum filter field renders the plain cards.
58
+ * - `transitionOperation` names the operation a move calls, with `{ [groupByField]: <target value> }` as its body: a
59
+ * custom transition such as `changeStatus`, or the resource's UPDATE. A plain identifier names every single-row
60
+ * variant of it, and each card calls the highest-rights variant the viewer holds whose `enabledCondition` admits that
61
+ * 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
62
+ * nobody declared. A card is movable only when the viewer holds a role the operation admits and the operation's
63
+ * `enabledCondition` admits that row, and a refused move leaves the card where it was and shows the backend's refusal.
64
+ *
65
+ * @example
66
+ * [Op.LIST, { collectionDisplayConfig: {
67
+ * displayMode: CollectionDisplayMode.BOARD,
68
+ * board: { groupByField: 'status', transitionOperation: Tickets_Operations.CHANGE_STATUS },
69
+ * } }]
70
+ */
71
+ export interface CollectionBoardConfig {
72
+ /** The ENUM filter field of the operation whose values are the columns. */
73
+ groupByField: string;
74
+ /** The operation a move calls; omitted makes the board read-only. */
75
+ transitionOperation?: OperationKey;
76
+ }
77
+ export const CollectionBoardConfigSchema: z.ZodType<CollectionBoardConfig> = z.strictObject({
78
+ groupByField: z.string().min(1),
79
+ // An `OperationKey`: an identifier, or `[identifier, variantKey]`. `z.custom` keeps the declared readonly tuple type.
80
+ transitionOperation: z.custom<OperationKey>((value) => (typeof value === 'string' && value.length > 0)
81
+ || (Array.isArray(value) && value.length === 2 && value.every((part) => typeof part === 'string' && part.length > 0))).optional(),
82
+ });
83
+
84
+ /**
85
+ * How a collection shown as a CALENDAR ({@link CollectionDisplayMode.CALENDAR}) places its rows.
86
+ *
87
+ * - `dateField` names a DATE filter field of the operation. Each row sits on the day it holds: a calendar-day field
88
+ * (`isCalendarDate()`) on that day for every reader, an instant on the reader's day in their resolved time zone. The
89
+ * weeks the grid shows become a `{ startDate, endDate }` window on that field for the fetch, narrowed further by the
90
+ * reader's own filter on it, so moving to another month asks the backend for that month's rows. A row with no date
91
+ * is not on the calendar. A field that is not a date filter field renders the plain cards.
92
+ *
93
+ * A row is one day here. A record spanning several days (a start and an end) is the TIMELINE's to show
94
+ * ({@link CollectionTimelineConfig}).
95
+ *
96
+ * @example
97
+ * [Op.LIST, { collectionDisplayConfig: {
98
+ * userSwitchableDisplayMode: true,
99
+ * calendar: { dateField: 'dueDate' },
100
+ * } }]
101
+ */
102
+ export interface CollectionCalendarConfig {
103
+ /** The DATE filter field of the operation whose day places each row. */
104
+ dateField: string;
29
105
  }
106
+ export const CollectionCalendarConfigSchema: z.ZodType<CollectionCalendarConfig> = z.strictObject({
107
+ dateField: z.string().min(1),
108
+ });
109
+
110
+ /**
111
+ * How a collection shown as a TIMELINE ({@link CollectionDisplayMode.TIMELINE}) spans its rows.
112
+ *
113
+ * - `startField` and `endField` name two DIFFERENT date filter fields of the operation. Each row's bar runs from the
114
+ * day its start falls on to the day its end falls on, both included (an end before the start draws one day), each
115
+ * field read as on the calendar: a calendar-day field on its UTC day, an instant on the reader's day.
116
+ * - The displayed month is the fetch's window: the start on or before its last day AND the end on or after its first,
117
+ * narrowed further by the reader's own filters on either field. A row missing either date is not on the timeline. A
118
+ * field that is not a date filter field renders the plain cards.
119
+ *
120
+ * @example
121
+ * [Op.LIST, { collectionDisplayConfig: {
122
+ * userSwitchableDisplayMode: true,
123
+ * timeline: { startField: 'startsOn', endField: 'endsOn' },
124
+ * } }]
125
+ */
126
+ export interface CollectionTimelineConfig {
127
+ /** The DATE filter field holding the day a row starts. */
128
+ startField: string;
129
+ /** The DATE filter field holding the day a row ends. */
130
+ endField: string;
131
+ }
132
+ export const CollectionTimelineConfigSchema: z.ZodType<CollectionTimelineConfig> = z.strictObject({
133
+ startField: z.string().min(1),
134
+ endField: z.string().min(1),
135
+ });
30
136
 
31
137
  /**
32
138
  * Whether a collection's toolbar OFFERS the free-form filters panel (the "Filters" trigger and the
@@ -53,6 +159,24 @@ export enum CollectionFilterPanelVisibility {
53
159
  HIDDEN = 'hidden',
54
160
  }
55
161
 
162
+ /** An embedding host's words for its empty block (`FrontendResourceOperationContext.emptyStateWords`, #3078). */
163
+ export interface EmbeddedCollectionEmptyStateWords {
164
+ /** What is empty, in the host's words: "Nothing awaits your decision". */
165
+ title: string;
166
+ /** An optional second line: what would put a row here. */
167
+ description?: string;
168
+ }
169
+
170
+ /**
171
+ * Whether an embedded collection offers its toolbar (`FrontendResourceOperationContext.collectionToolbar`, #3070).
172
+ */
173
+ export enum CollectionToolbarPresence {
174
+ /** The whole toolbar: search, filters, sort, tabs, pills, view toggle and Create. The default. */
175
+ OFFERED = 'offered',
176
+ /** Rows and pagination only — a block of a larger surface, refined on the collection's own page. */
177
+ HIDDEN = 'hidden',
178
+ }
179
+
56
180
  /**
57
181
  */
58
182
  /**
@@ -65,9 +189,10 @@ export enum CollectionFilterPanelVisibility {
65
189
  * preset needs no filter grammar of its own and no backend change. A window may be open on one side:
66
190
  * "before today" has no start, and the filter treats an absent bound as unbounded on every adapter.
67
191
  *
68
- * Every member is a span of WHOLE calendar days counted from today in the reader's resolved timezone
192
+ * Every member but one is a span of WHOLE calendar days counted from today in the reader's resolved timezone
69
193
  * (member, then organization, then floor), which is the only one that makes "today" true for the person
70
- * reading the screen, and the one the list's own date words use. Over an instant field the window runs
194
+ * reading the screen, and the one the list's own date words use. The exception is `BEFORE_NOW`, whose
195
+ * bound is the instant of the click (#2627); its own JSDoc says how it is read back. Over an instant field the window runs
71
196
  * between that zone's midnights; over a calendar-day field (`isCalendarDate()`) it covers those calendar
72
197
  * days, held as UTC midnights, so a due date is the same day for every reader. Both bounds are included,
73
198
  * as the backend's range filter includes them, so the window ends one millisecond before the day after
@@ -93,12 +218,68 @@ export enum CollectionFilterPresetRelativeRange {
93
218
  * same all day.
94
219
  */
95
220
  BEFORE_TODAY = 'before_today',
221
+ /**
222
+ * Every instant BEFORE NOW: "overdue" for a deadline with a TIME of day (#2627). A callback promised for 10:00 is
223
+ * overdue at 10:01, which `BEFORE_TODAY` cannot say: its whole-day window ends at the last instant of yesterday.
224
+ *
225
+ * Resolved to a window with no start that ends at the instant the pill is clicked. Because that bound is not a day
226
+ * boundary, it cannot be read back by comparing bounds as the day-bound members are (the next render's `now` is a
227
+ * different instant): the pill instead reads as ON for any window of this KIND — no start, ending at an instant
228
+ * earlier today, no later than now. A window picked in the filters panel always ends at the last instant of a day,
229
+ * so the panel can never produce one, and "Overdue" by day and "Overdue" by the minute never read as each other.
230
+ * Like "created today", the pill goes off once the day it was clicked on has ended.
231
+ *
232
+ * Over a CALENDAR-DAY field (`isCalendarDate()`) it is `BEFORE_TODAY`: a date with no time is overdue only once
233
+ * its whole day has passed, so the last day before now that has ended is yesterday.
234
+ */
235
+ BEFORE_NOW = 'before_now',
96
236
  /** Today and the six calendar days after it, in the reader's calendar: "due this week" from today. */
97
237
  NEXT_7_DAYS = 'next_7_days',
98
238
  /** Today and the twenty-nine calendar days after it, in the reader's calendar. */
99
239
  NEXT_30_DAYS = 'next_30_days',
100
240
  }
101
241
 
242
+ /**
243
+ * A RANGE OF MONTHS named relative to the current month, for a preset on a year-month field (#3444): "This quarter" on a
244
+ * list of monthly budgets must still mean this quarter next month, so it cannot be an authored pair of months.
245
+ *
246
+ * It is the month-field counterpart of {@link CollectionFilterPresetRelativeRange} and resolves the same way: when the
247
+ * pill is clicked, counted from TODAY in the reader's resolved time zone (member, then organization, then floor), the
248
+ * today the list's own date words use. A year-month value (`z_yearMonth()`, `YYYY-MM`) is a calendar label rather than
249
+ * an instant, so the window is a pair of month labels, both included: exactly the `{ startMonth, endMonth }` value the
250
+ * filters panel's two month pickers write (`Resources_Filter_YearMonthRangeSchema`), so a pill and the same months
251
+ * picked by hand are one filter, and the backend needs no grammar of its own.
252
+ *
253
+ * A separate vocabulary rather than new members of the date one, because the two resolve to different VALUES for
254
+ * different field kinds: a date window is a pair of instants for a `z.date()` field, a month window is a pair of
255
+ * `YYYY-MM` labels for a year-month field, and a member meaning one cannot be applied to the other. Rejected: a
256
+ * parameterised `{ lastMonths: n }`. Each member below is a span a person asks for by name, and a closed set is the one
257
+ * place its words and its resolution can both be checked.
258
+ *
259
+ * Every member names BOTH bounds, so a window is never open: the rolling ones include the current month, as
260
+ * "the last 7 days" includes today.
261
+ */
262
+ export enum CollectionFilterPresetRelativeMonthRange {
263
+ /** The current month. */
264
+ THIS_MONTH = 'this_month',
265
+ /** The month before the current one. */
266
+ LAST_MONTH = 'last_month',
267
+ /** The month after the current one: next month's budgets, planned ahead. */
268
+ NEXT_MONTH = 'next_month',
269
+ /** The calendar quarter holding the current month (January–March, April–June, July–September, October–December), all three months, the coming ones included. */
270
+ THIS_QUARTER = 'this_quarter',
271
+ /** The calendar quarter before the current one. */
272
+ LAST_QUARTER = 'last_quarter',
273
+ /** The current month and the two before it — a rolling quarter, including this month. */
274
+ LAST_3_MONTHS = 'last_3_months',
275
+ /** The current month and the eleven before it — a rolling year, including this month. */
276
+ LAST_12_MONTHS = 'last_12_months',
277
+ /** January of the current year through the current month. */
278
+ YEAR_TO_DATE = 'year_to_date',
279
+ /** January through December of the current year, the coming months included. */
280
+ THIS_YEAR = 'this_year',
281
+ }
282
+
102
283
  /**
103
284
  * A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
104
285
  * viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
@@ -115,25 +296,35 @@ export enum CollectionFilterPresetContextValue {
115
296
  /**
116
297
  * What a preset ASSIGNS to one filter field.
117
298
  *
118
- * Four kinds, split by WHEN the value is known:
299
+ * Split by WHEN the value is known:
119
300
  *
120
301
  * - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
121
- * which is the whole of "filter to HIGH priority";
122
- * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
123
- * answer would be wrong by tomorrow;
302
+ * which is the whole of "filter to HIGH priority". On a year-month field one `YYYY-MM` month is the range that starts
303
+ * and ends with it, and reads as the same filter as that range picked in the panel;
304
+ * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case on a DATE field, resolved when the pill is clicked,
305
+ * because an authored answer would be wrong by tomorrow;
306
+ * - a RELATIVE MONTH RANGE (`{ relativeMonthRange }`) is the same case on a YEAR-MONTH field (#3444), resolved to the
307
+ * `{ startMonth, endMonth }` pair the panel's month pickers write;
124
308
  * - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
125
309
  * backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
126
310
  * commonest threshold anyone asks for;
311
+ * - a MONTH RANGE (`{ startMonth?, endMonth? }`) is a fixed range of months, such as one fiscal year, written as the
312
+ * panel writes it;
127
313
  * - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
128
314
  * when the pill is clicked, so the same authored preset shows each viewer their own rows.
315
+ *
316
+ * The object members are STRICT. A stripping parse turned an authored `{ startMonth, endMonth }` into the numeric
317
+ * bound `{}` (#3444): a month range silently became "no bound", and the pill filtered nothing under its name.
129
318
  */
130
319
  export const CollectionFilterPresetValueSchema = z.union([
131
320
  z.string(),
132
321
  z.number(),
133
322
  z.boolean(),
134
- z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
135
- z.object({ min: z.number().optional(), max: z.number().optional() }),
136
- z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
323
+ z.strictObject({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
324
+ z.strictObject({ relativeMonthRange: z.enum(CollectionFilterPresetRelativeMonthRange) }),
325
+ z.strictObject({ min: z.number().optional(), max: z.number().optional() }),
326
+ Resources_Filter_YearMonthRangeSchema,
327
+ z.strictObject({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
137
328
  ]);
138
329
  export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
139
330
 
@@ -224,8 +415,7 @@ export enum CardLayoutStyle {
224
415
  * **Historical note (search hit):** earlier versions of this schema exposed an
225
416
  * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
226
417
  * string[]`) operation-level field that authored which resource-owned views
227
- * surfaced in this operation. That field was removed in the
228
- * `resource-owned-view-surfacing-contract.md` workstream because it duplicated
418
+ * surfaced in this operation. That field was removed because it duplicated
229
419
  * the per-view declaration sites (`compositeViews`, `chartViews`,
230
420
  * `executionViews`) and could silently disagree with them. If you are looking
231
421
  * for `additionalViews` because a doc, comment, prompt, or downstream code
@@ -461,7 +651,7 @@ export interface ResourceActionDisclosureConfig {
461
651
  /**
462
652
  * How many PRIMARY actions render as direct buttons before the remainder
463
653
  * collapse into the `…` overflow menu. Omitted inherits the framework default
464
- * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY and 3 for
654
+ * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 1 for SUMMARY and 3 for
465
655
  * DETAIL. `0` pushes every action into the menu.
466
656
  */
467
657
  maxPrimaryActions?: number;
@@ -485,8 +675,15 @@ export interface ResolvedActionDisclosure {
485
675
  * Framework defaults per view.
486
676
  *
487
677
  * - SUMMARY (dense list/table rows) HIDES actions an unmet `enabledCondition`
488
- * disables and caps direct actions at 3 before the `…` menu: on a row, a greyed
489
- * button is noise repeated N times.
678
+ * disables and caps direct actions at ONE before the `…` menu: on a row, a greyed
679
+ * button is noise repeated N times. One, because a direct action shows its WORDS by
680
+ * default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066): three labelled buttons on every
681
+ * row crowd the record's own name off a 390px phone, while one named verb and a `…`
682
+ * menu (whose entries carry their words too) fit beside it. The verb that keeps the slot
683
+ * is the first one that can run, in `displayPriority` order (`allocateActionBarSlots`).
684
+ * It was 3 icon-only buttons until 2026-10-22, which on Wonder Procurement drew a pencil,
685
+ * a paper plane and a "ban" circle per request, none of them saying what it did. On a phone
686
+ * the row keeps none (`MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS`).
490
687
  * - DETAIL (the read view, and the bulk bar's disabled-action handling) SHOWS them.
491
688
  * On the record's own action bar it also caps direct actions at 3 before the `…`
492
689
  * menu, since the record header puts them on the name's own line. The bulk bar
@@ -505,7 +702,7 @@ export interface ResolvedActionDisclosure {
505
702
  */
506
703
  export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
507
704
  [ResourceOperationDisplayMode.SUMMARY]: {
508
- maxPrimaryActions: 3,
705
+ maxPrimaryActions: 1,
509
706
  disabledActionHandling: DisabledActionHandling.HIDE,
510
707
  },
511
708
  /*
@@ -529,6 +726,30 @@ export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, Res
529
726
  },
530
727
  };
531
728
 
729
+ /**
730
+ * How many direct actions a list row keeps on a PHONE when the resource authored no cap: none — every action is
731
+ * in the row's `…` menu, which shows each action's words (#3066).
732
+ *
733
+ * One labelled verb fits beside a record's name on a desktop row; on a 390px phone it does not. Measured on Wonder
734
+ * Procurement: "Cancel Purchase Request" beside a request's status pill truncated the request's title to a few
735
+ * letters. A phone row is opened with a tap, so its verbs belong in the menu, the way established list patterns
736
+ * hide their row shortcuts on small screens. A resource that authored `actionDisclosure[SUMMARY].maxPrimaryActions`
737
+ * keeps it on every screen.
738
+ */
739
+ export const MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS = 0;
740
+
741
+ /**
742
+ * How many direct actions the record page header keeps on a PHONE when the resource authored no cap: one, beside the
743
+ * `…` menu (#3066).
744
+ *
745
+ * The header keeps three on a wider screen, and each shows its words. At 390px three labelled verbs do not fit on
746
+ * the line beneath the record's name, and they do not wrap: measured on Wonder Procurement ("Edit Draft", "Submit
747
+ * Purchase Request", "Cancel Purchase Request") and on Your Application, the third verb and the `…` menu ran off the right
748
+ * edge and could not be reached. One named verb and the menu fit; the verb is the first that can run, in
749
+ * `displayPriority` order.
750
+ */
751
+ export const MOBILE_DETAIL_MAX_PRIMARY_ACTIONS = 1;
752
+
532
753
  /**
533
754
  * Resolve the effective disclosure policy for a view: per-resource override
534
755
  * (`layout.actionDisclosure[view]`) layered over the framework default. Used by
@@ -703,6 +924,27 @@ export const ResourceOperationFrontendConfigSchema = z.object({
703
924
  collectionDisplayConfig: z.object({
704
925
  displayMode: z.enum(CollectionDisplayMode).optional(),
705
926
  userSwitchableDisplayMode: z.boolean().optional(),
927
+ /**
928
+ * The BOARD presentation: the field its columns come from and the operation a move calls. See
929
+ * {@link CollectionBoardConfig}. Required when `displayMode` is `BOARD`, and offered by the view-mode toggle beside
930
+ * CARDS and TABLE when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
931
+ * (`collectionBoardConfigurationDefect`): a board naming no field, a field that is not a filter field of the operation,
932
+ * a transition naming no operation of the resource, or a `board` no mode can reach refuses to start.
933
+ */
934
+ board: CollectionBoardConfigSchema.optional(),
935
+ /**
936
+ * The CALENDAR presentation: the date field each row sits on. See {@link CollectionCalendarConfig}. Required when
937
+ * `displayMode` is `CALENDAR`, and offered by the view-mode toggle when `userSwitchableDisplayMode` is on. Checked
938
+ * when the frontend registry is built (`collectionTemporalDisplayConfigurationDefect`).
939
+ */
940
+ calendar: CollectionCalendarConfigSchema.optional(),
941
+ /**
942
+ * The TIMELINE presentation: the date fields each row's bar starts and ends on. See
943
+ * {@link CollectionTimelineConfig}. Required when `displayMode` is `TIMELINE`, and offered by the view-mode toggle
944
+ * when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
945
+ * (`collectionTemporalDisplayConfigurationDefect`).
946
+ */
947
+ timeline: CollectionTimelineConfigSchema.optional(),
706
948
  /**
707
949
  * Promote ONE enum filter field to the collection toolbar's first line: a
708
950
  * segmented control ("All · <value> · <value> …" — the Stripe/Ignisign
@@ -734,7 +976,9 @@ export const ResourceOperationFrontendConfigSchema = z.object({
734
976
  * { ref: 'urgent', filters: { priority: 'high' } },
735
977
  * { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
736
978
  * { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
979
+ * { ref: 'callback-missed', filters: { callbackAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_NOW } } },
737
980
  * { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
981
+ * { ref: 'this-quarter', filters: { period: { relativeMonthRange: CollectionFilterPresetRelativeMonthRange.THIS_QUARTER } } },
738
982
  * ]
739
983
  */
740
984
  presetFilters: z.array(CollectionFilterPresetSchema).optional(),
@@ -172,9 +172,11 @@ export type ResourceUIBehaviorConfig<
172
172
  * moment shows keys until the next search.
173
173
  *
174
174
  * Name only what the label callback actually reads; an undeclared read still resolves wherever that section
175
- * happens to be loaded, and renders its key (a missing label that looks missing) where it is not.
175
+ * happens to be loaded, and renders its key (a missing label that looks missing) where it is not. Besides a
176
+ * `LabellingTypes` section, a name may read a vendor's words (`PROVIDER_LABEL_BUCKET`, `providers.<ref>.displayName`)
177
+ * or a system of record's (`SYSTEM_OF_RECORD_LABEL_BUCKET`, `systems_of_record.<name>.displayName`), #3166.
176
178
  */
177
- instanceLabelSections?: readonly LabellingTypes[];
179
+ instanceLabelSections?: readonly InstanceLabelSection[];
178
180
 
179
181
 
180
182
  // ── Views ──────────────────────────────────────────────────────
@@ -0,0 +1,63 @@
1
+ # saas.frontend.section-stages
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-frontend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * Binds a `SectionMode.STAGES` group to the record field that says which stage the record is at.
14
+ *
15
+ * Declared ONCE, on the group's FIRST `<Section>` (`stageBinding={…}`), like every other container parameter. The
16
+ * group's sections are the stages, in the order they are written; the binding says which stage each value of the
17
+ * field places the record at. Earlier stages read as reached, the record's own stage as current, later ones as
18
+ * not reached. Each stage shows its authored title and description and its fields; there are no buttons.
19
+ *
20
+ * - `field` names an ENUM field of the record (a dot path for a nested one).
21
+ * - `stageOfValue` maps EVERY value of that enum to the `name` of one of the group's sections. Several values may
22
+ * share a stage (every terminal outcome is the "outcome" stage). A stage no value maps to is still drawn, and is
23
+ * reached whenever a later stage is current (a request's "asked for" stage has no value of its own: a request
24
+ * that exists has been asked for).
25
+ *
26
+ * The binding is checked against the field's schema the first time the group renders, and a binding that could
27
+ * misstate a record's stage throws: a key that is not a value of the enum, a value of the enum with no stage (an
28
+ * enum member added later is reported, not silently left unplaced), a stage that is not a section of the group, a
29
+ * field that is not an enum. An empty field marks no stage.
30
+ *
31
+ * @example
32
+ * ```tsx
33
+ * <DisplayLayout>
34
+ * <Section
35
+ * name="request"
36
+ * appearance={SectionMode.STAGES}
37
+ * stageBinding={{
38
+ * field: 'status',
39
+ * stageOfValue: {
40
+ * [Status.SCHEDULED]: 'grace',
41
+ * [Status.CANCELLED]: 'outcome',
42
+ * [Status.COMPLETED]: 'outcome',
43
+ * },
44
+ * }}
45
+ * >
46
+ * <DisplayField name="userId" />
47
+ * </Section>
48
+ * <Section name="grace" appearance={SectionMode.STAGES}>
49
+ * <DisplayField name="justification" />
50
+ * </Section>
51
+ * <Section name="outcome" appearance={SectionMode.STAGES}>
52
+ * <DisplayField name="completedAt" />
53
+ * </Section>
54
+ * </DisplayLayout>
55
+ * ```
56
+ */
57
+ export interface SectionStageBinding {
58
+ /** The record field holding the stage: an enum field (dot path for a nested one). */
59
+ field: string;
60
+ /** Every value of the field → the `name` of the section (stage) that value places the record at. */
61
+ stageOfValue: Readonly<Record<string, string>>;
62
+ }
63
+ ```
@@ -103,6 +103,11 @@ export enum EngineSettingsDestinationRef {
103
103
  * (#2324): one row per task transition and webhook, with its attempts and outcome. Each person's own.
104
104
  */
105
105
  MY_AGENT_PUSH_DELIVERIES = 'my-agent-push-deliveries',
106
+ /**
107
+ * The signed-in person's own data-subject requests (#2296): a request to exercise a data-protection right (today,
108
+ * erasure of their account), its grace window, the deadline it is answered by and what was done. Each person's own.
109
+ */
110
+ MY_DATA_SUBJECT_REQUESTS = 'my-data-subject-requests',
106
111
  /** Single sign-on configuration and connections. */
107
112
  SSO = 'sso',
108
113
  /** SCIM directory provisioning configuration and tokens. */
@@ -176,6 +181,12 @@ export enum EngineSettingsDestinationRef {
176
181
  * and the provider's DNS records, verify, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs.
177
182
  */
178
183
  EMAIL_DOMAINS = 'email-domains',
184
+ /**
185
+ * The domains on which the application answers for THIS organization (#2974): claim one, publish its ownership TXT
186
+ * record, prove ownership, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs; claiming and
187
+ * proving need the plan's custom branding, which the backend refuses by name when it is missing.
188
+ */
189
+ CUSTOM_DOMAINS = 'custom-domains',
179
190
  /**
180
191
  * The addresses THIS organization — a representing organization — keeps on its own verified domain for the granting
181
192
  * organizations it serves; each routes its mail into that granting organization (#1600). Org owner/admin only. Shown
@@ -275,6 +286,15 @@ export enum EngineSettingsDestinationRef {
275
286
  * grant. So the destination shows nothing without an elevation, and says where to request one.
276
287
  */
277
288
  APPLICATION_ORGANIZATIONS = 'application-organizations',
289
+ /**
290
+ * The data-subject request queue (#2296): every person's requests the controller still owes an answer to, or that
291
+ * need an operator, soonest deadline first.
292
+ *
293
+ * Lists through `dataSubjectRequests | operator_queue`, an application-wide read of personal data, so it needs an
294
+ * application-wide access grant a second platform administrator signed, and records every read, as the tenant
295
+ * directory does. So the destination shows nothing without an elevation, and says where to request one.
296
+ */
297
+ APPLICATION_DATA_SUBJECT_REQUESTS = 'application-data-subject-requests',
278
298
  /**
279
299
  * The application-wide audit trail — every tenant's events plus the ones belonging to no tenant.
280
300
  *
@@ -310,6 +330,16 @@ export enum EngineSettingsDestinationRef {
310
330
  * a different entitlement and a different operator task.
311
331
  */
312
332
  APPLICATION_INBOUND_DELIVERIES = 'application-inbound-deliveries',
333
+ /**
334
+ * Which of the application's SMS numbers belongs to which organization (#3394): the `smsNumberAssignments` rows that
335
+ * route a received text to its organization's SMS channel handler, with Assign (CREATE) and Withdraw (DELETE).
336
+ *
337
+ * Application-scope, super-admin, because every number sits in the APPLICATION's provider account: no organization can
338
+ * prove a number is its own, so the operator assigns, and an organization never claims (the email domain's
339
+ * organization-side {@link EMAIL_DOMAINS} has a DNS proof a number lacks). Shown only where the SMS capability is
340
+ * enabled, since a number assigned in an application that receives no texts routes nothing.
341
+ */
342
+ APPLICATION_SMS_NUMBERS = 'application-sms-numbers',
313
343
  /**
314
344
  * Whether each declared retention period is being enforced (#1636): one record per retention-sweep run and
315
345
  * bound resource — what it deleted under which period, what a hold kept, and how the run ended. Read-only;
@@ -339,6 +369,18 @@ export enum EngineSettingsDestinationRef {
339
369
  * an organization's own suspensions are on {@link AGENT_POLICY}.
340
370
  */
341
371
  APPLICATION_AGENT_POLICY = 'application-agent-policy',
372
+ /**
373
+ * The APPLICATION's OWN third-party accounts (#3398, #3579): the vendor account the whole deployment acts as toward a
374
+ * provider, which a super-administrator connects, sees the standing of, and disconnects.
375
+ *
376
+ * The third owner of the same feature, beside {@link PROVIDER_CREDENTIALS} (a tenant's) and
377
+ * {@link MY_PROVIDER_CREDENTIALS} (a person's), and never merged with either: the application's grant is spent by
378
+ * every tenant's call that the application makes as itself, so it is the operator's decision, and its rows have no
379
+ * resource route (`GET /connections/linked?ownerScope=application` lists them, `DELETE /connections/application/
380
+ * {connectionRef}` ends one). Super-admin, the role those routes and the connect start leg admit. The connection
381
+ * callback returns an application-owned connection here.
382
+ */
383
+ APPLICATION_PROVIDER_CONNECTIONS = 'application-provider-connections',
342
384
  /**
343
385
  * The billing CATALOGUE the application sells — products, their prices, and promotions.
344
386
  *
@@ -196,15 +196,12 @@ export interface SettingsDestination {
196
196
  * destination the application does not place does not render, which is the whole
197
197
  * point — "we should just place things", with no automatic inference.
198
198
  *
199
- * `label` is optional and is an OVERRIDE. The resolved label otherwise comes from
200
- * the `settings_hub.sections.<ref>.label` key, so a placed section is localizable
201
- * without the application authoring an English string.
202
- *
203
- * That namespace and its resolver (`tSettingsHubSection`) EXIST and already fall
204
- * back to the authored label. What does not exist is anything that generates the
205
- * units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the
206
- * companion plans nothing for it, so today every rail label is the authored
207
- * English string. R9 is a wiring job, not a new mechanism.
199
+ * `label` is the wording INTENT and the runtime fallback. The rail renders the
200
+ * `settings_hub.sections.<ref>.label` word when the bundle has one
201
+ * (`tSettingsHubSection`), and this string when it does not. The companion plans
202
+ * that key for every placed section (`collectSettingsHubLabelKeys`) and hands this
203
+ * string to label generation as the key's purpose, so a section is worded in every
204
+ * locale from what the application wrote here. Omitted, the fallback is the ref.
208
205
  */
209
206
  export interface SettingsPlacement {
210
207
  /** The {@link SettingsDestination.ref} being placed — an engine destination or one of `destinations`. Refused at DEV startup when unknown. */