@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -38,7 +38,113 @@ export enum CollectionDisplayMode {
38
38
  CARDS = 'cards',
39
39
  /** Dense table — one column per summary field via the table body. */
40
40
  TABLE = 'table',
41
+ /**
42
+ * One column per value of an enum field, each holding the cards whose row has that value (#2298): a pipeline, a
43
+ * status board. Requires `collectionDisplayConfig.board` ({@link CollectionBoardConfig}), which names the field
44
+ * and, optionally, the operation a card moved to another column calls. Each column reads its own rows under the
45
+ * collection's filters, scope and refresh, a page at a time ("load more"), and counts every row of its value.
46
+ */
47
+ BOARD = 'board',
48
+ /**
49
+ * A month grid, each row on the day its date field falls on (#2298): a schedule, due dates, appointments. Requires
50
+ * `collectionDisplayConfig.calendar` ({@link CollectionCalendarConfig}). The visible weeks are the fetch's window on
51
+ * that field, applied beside the reader's own filters, scope and realtime refresh, and every row of it is read (up to
52
+ * five pages at the LIST ceiling; beyond that a notice counts the rows not shown).
53
+ */
54
+ CALENDAR = 'calendar',
55
+ /**
56
+ * One row per record with a bar from its start to its end over the days of a month (#2298): projects, leave,
57
+ * engagements. Requires `collectionDisplayConfig.timeline` ({@link CollectionTimelineConfig}). The displayed month is
58
+ * the fetch's window (the rows overlapping it), applied beside the reader's own filters, scope and refresh.
59
+ */
60
+ TIMELINE = 'timeline',
61
+ }
62
+
63
+ /**
64
+ * How a collection shown as a BOARD ({@link CollectionDisplayMode.BOARD}) is grouped, and what moving a card does.
65
+ *
66
+ * - `groupByField` names an ENUM field the operation exposes as a filter field. The columns are its values in
67
+ * declaration order (the same vocabulary the filters panel and the quick-filter tabs read), every value has a column
68
+ * even when empty, because a column is also where a card is moved TO. A row holding no value of it sits in a
69
+ * trailing column nothing can be moved into. A field that is not an enum filter field renders the plain cards.
70
+ * - `transitionOperation` names the operation a move calls, with `{ [groupByField]: <target value> }` as its body: a
71
+ * custom transition such as `changeStatus`, or the resource's UPDATE. A plain identifier names every single-row
72
+ * variant of it, and each card calls the highest-rights variant the viewer holds whose `enabledCondition` admits that
73
+ * 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
74
+ * nobody declared. A card is movable only when the viewer holds a role the operation admits and the operation's
75
+ * `enabledCondition` admits that row, and a refused move leaves the card where it was and shows the backend's refusal.
76
+ *
77
+ * @example
78
+ * [Op.LIST, { collectionDisplayConfig: {
79
+ * displayMode: CollectionDisplayMode.BOARD,
80
+ * board: { groupByField: 'status', transitionOperation: Tickets_Operations.CHANGE_STATUS },
81
+ * } }]
82
+ */
83
+ export interface CollectionBoardConfig {
84
+ /** The ENUM filter field of the operation whose values are the columns. */
85
+ groupByField: string;
86
+ /** The operation a move calls; omitted makes the board read-only. */
87
+ transitionOperation?: OperationKey;
88
+ }
89
+ export const CollectionBoardConfigSchema: z.ZodType<CollectionBoardConfig> = z.strictObject({
90
+ groupByField: z.string().min(1),
91
+ // An `OperationKey`: an identifier, or `[identifier, variantKey]`. `z.custom` keeps the declared readonly tuple type.
92
+ transitionOperation: z.custom<OperationKey>((value) => (typeof value === 'string' && value.length > 0)
93
+ || (Array.isArray(value) && value.length === 2 && value.every((part) => typeof part === 'string' && part.length > 0))).optional(),
94
+ });
95
+
96
+ /**
97
+ * How a collection shown as a CALENDAR ({@link CollectionDisplayMode.CALENDAR}) places its rows.
98
+ *
99
+ * - `dateField` names a DATE filter field of the operation. Each row sits on the day it holds: a calendar-day field
100
+ * (`isCalendarDate()`) on that day for every reader, an instant on the reader's day in their resolved time zone. The
101
+ * weeks the grid shows become a `{ startDate, endDate }` window on that field for the fetch, narrowed further by the
102
+ * reader's own filter on it, so moving to another month asks the backend for that month's rows. A row with no date
103
+ * is not on the calendar. A field that is not a date filter field renders the plain cards.
104
+ *
105
+ * A row is one day here. A record spanning several days (a start and an end) is the TIMELINE's to show
106
+ * ({@link CollectionTimelineConfig}).
107
+ *
108
+ * @example
109
+ * [Op.LIST, { collectionDisplayConfig: {
110
+ * userSwitchableDisplayMode: true,
111
+ * calendar: { dateField: 'dueDate' },
112
+ * } }]
113
+ */
114
+ export interface CollectionCalendarConfig {
115
+ /** The DATE filter field of the operation whose day places each row. */
116
+ dateField: string;
41
117
  }
118
+ export const CollectionCalendarConfigSchema: z.ZodType<CollectionCalendarConfig> = z.strictObject({
119
+ dateField: z.string().min(1),
120
+ });
121
+
122
+ /**
123
+ * How a collection shown as a TIMELINE ({@link CollectionDisplayMode.TIMELINE}) spans its rows.
124
+ *
125
+ * - `startField` and `endField` name two DIFFERENT date filter fields of the operation. Each row's bar runs from the
126
+ * day its start falls on to the day its end falls on, both included (an end before the start draws one day), each
127
+ * field read as on the calendar: a calendar-day field on its UTC day, an instant on the reader's day.
128
+ * - The displayed month is the fetch's window: the start on or before its last day AND the end on or after its first,
129
+ * narrowed further by the reader's own filters on either field. A row missing either date is not on the timeline. A
130
+ * field that is not a date filter field renders the plain cards.
131
+ *
132
+ * @example
133
+ * [Op.LIST, { collectionDisplayConfig: {
134
+ * userSwitchableDisplayMode: true,
135
+ * timeline: { startField: 'startsOn', endField: 'endsOn' },
136
+ * } }]
137
+ */
138
+ export interface CollectionTimelineConfig {
139
+ /** The DATE filter field holding the day a row starts. */
140
+ startField: string;
141
+ /** The DATE filter field holding the day a row ends. */
142
+ endField: string;
143
+ }
144
+ export const CollectionTimelineConfigSchema: z.ZodType<CollectionTimelineConfig> = z.strictObject({
145
+ startField: z.string().min(1),
146
+ endField: z.string().min(1),
147
+ });
42
148
 
43
149
  /**
44
150
  * Whether a collection's toolbar OFFERS the free-form filters panel (the "Filters" trigger and the
@@ -65,6 +171,24 @@ export enum CollectionFilterPanelVisibility {
65
171
  HIDDEN = 'hidden',
66
172
  }
67
173
 
174
+ /** An embedding host's words for its empty block (`FrontendResourceOperationContext.emptyStateWords`, #3078). */
175
+ export interface EmbeddedCollectionEmptyStateWords {
176
+ /** What is empty, in the host's words: "Nothing awaits your decision". */
177
+ title: string;
178
+ /** An optional second line: what would put a row here. */
179
+ description?: string;
180
+ }
181
+
182
+ /**
183
+ * Whether an embedded collection offers its toolbar (`FrontendResourceOperationContext.collectionToolbar`, #3070).
184
+ */
185
+ export enum CollectionToolbarPresence {
186
+ /** The whole toolbar: search, filters, sort, tabs, pills, view toggle and Create. The default. */
187
+ OFFERED = 'offered',
188
+ /** Rows and pagination only — a block of a larger surface, refined on the collection's own page. */
189
+ HIDDEN = 'hidden',
190
+ }
191
+
68
192
  /**
69
193
  */
70
194
  /**
@@ -77,9 +201,10 @@ export enum CollectionFilterPanelVisibility {
77
201
  * preset needs no filter grammar of its own and no backend change. A window may be open on one side:
78
202
  * "before today" has no start, and the filter treats an absent bound as unbounded on every adapter.
79
203
  *
80
- * Every member is a span of WHOLE calendar days counted from today in the reader's resolved timezone
204
+ * Every member but one is a span of WHOLE calendar days counted from today in the reader's resolved timezone
81
205
  * (member, then organization, then floor), which is the only one that makes "today" true for the person
82
- * reading the screen, and the one the list's own date words use. Over an instant field the window runs
206
+ * reading the screen, and the one the list's own date words use. The exception is `BEFORE_NOW`, whose
207
+ * bound is the instant of the click (#2627); its own JSDoc says how it is read back. Over an instant field the window runs
83
208
  * between that zone's midnights; over a calendar-day field (`isCalendarDate()`) it covers those calendar
84
209
  * days, held as UTC midnights, so a due date is the same day for every reader. Both bounds are included,
85
210
  * as the backend's range filter includes them, so the window ends one millisecond before the day after
@@ -105,12 +230,68 @@ export enum CollectionFilterPresetRelativeRange {
105
230
  * same all day.
106
231
  */
107
232
  BEFORE_TODAY = 'before_today',
233
+ /**
234
+ * Every instant BEFORE NOW: "overdue" for a deadline with a TIME of day (#2627). A callback promised for 10:00 is
235
+ * overdue at 10:01, which `BEFORE_TODAY` cannot say: its whole-day window ends at the last instant of yesterday.
236
+ *
237
+ * Resolved to a window with no start that ends at the instant the pill is clicked. Because that bound is not a day
238
+ * boundary, it cannot be read back by comparing bounds as the day-bound members are (the next render's `now` is a
239
+ * different instant): the pill instead reads as ON for any window of this KIND — no start, ending at an instant
240
+ * earlier today, no later than now. A window picked in the filters panel always ends at the last instant of a day,
241
+ * so the panel can never produce one, and "Overdue" by day and "Overdue" by the minute never read as each other.
242
+ * Like "created today", the pill goes off once the day it was clicked on has ended.
243
+ *
244
+ * Over a CALENDAR-DAY field (`isCalendarDate()`) it is `BEFORE_TODAY`: a date with no time is overdue only once
245
+ * its whole day has passed, so the last day before now that has ended is yesterday.
246
+ */
247
+ BEFORE_NOW = 'before_now',
108
248
  /** Today and the six calendar days after it, in the reader's calendar: "due this week" from today. */
109
249
  NEXT_7_DAYS = 'next_7_days',
110
250
  /** Today and the twenty-nine calendar days after it, in the reader's calendar. */
111
251
  NEXT_30_DAYS = 'next_30_days',
112
252
  }
113
253
 
254
+ /**
255
+ * A RANGE OF MONTHS named relative to the current month, for a preset on a year-month field (#3444): "This quarter" on a
256
+ * list of monthly budgets must still mean this quarter next month, so it cannot be an authored pair of months.
257
+ *
258
+ * It is the month-field counterpart of {@link CollectionFilterPresetRelativeRange} and resolves the same way: when the
259
+ * pill is clicked, counted from TODAY in the reader's resolved time zone (member, then organization, then floor), the
260
+ * today the list's own date words use. A year-month value (`z_yearMonth()`, `YYYY-MM`) is a calendar label rather than
261
+ * an instant, so the window is a pair of month labels, both included: exactly the `{ startMonth, endMonth }` value the
262
+ * filters panel's two month pickers write (`Resources_Filter_YearMonthRangeSchema`), so a pill and the same months
263
+ * picked by hand are one filter, and the backend needs no grammar of its own.
264
+ *
265
+ * A separate vocabulary rather than new members of the date one, because the two resolve to different VALUES for
266
+ * different field kinds: a date window is a pair of instants for a `z.date()` field, a month window is a pair of
267
+ * `YYYY-MM` labels for a year-month field, and a member meaning one cannot be applied to the other. Rejected: a
268
+ * parameterised `{ lastMonths: n }`. Each member below is a span a person asks for by name, and a closed set is the one
269
+ * place its words and its resolution can both be checked.
270
+ *
271
+ * Every member names BOTH bounds, so a window is never open: the rolling ones include the current month, as
272
+ * "the last 7 days" includes today.
273
+ */
274
+ export enum CollectionFilterPresetRelativeMonthRange {
275
+ /** The current month. */
276
+ THIS_MONTH = 'this_month',
277
+ /** The month before the current one. */
278
+ LAST_MONTH = 'last_month',
279
+ /** The month after the current one: next month's budgets, planned ahead. */
280
+ NEXT_MONTH = 'next_month',
281
+ /** The calendar quarter holding the current month (January–March, April–June, July–September, October–December), all three months, the coming ones included. */
282
+ THIS_QUARTER = 'this_quarter',
283
+ /** The calendar quarter before the current one. */
284
+ LAST_QUARTER = 'last_quarter',
285
+ /** The current month and the two before it — a rolling quarter, including this month. */
286
+ LAST_3_MONTHS = 'last_3_months',
287
+ /** The current month and the eleven before it — a rolling year, including this month. */
288
+ LAST_12_MONTHS = 'last_12_months',
289
+ /** January of the current year through the current month. */
290
+ YEAR_TO_DATE = 'year_to_date',
291
+ /** January through December of the current year, the coming months included. */
292
+ THIS_YEAR = 'this_year',
293
+ }
294
+
114
295
  /**
115
296
  * A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
116
297
  * viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
@@ -127,25 +308,35 @@ export enum CollectionFilterPresetContextValue {
127
308
  /**
128
309
  * What a preset ASSIGNS to one filter field.
129
310
  *
130
- * Four kinds, split by WHEN the value is known:
311
+ * Split by WHEN the value is known:
131
312
  *
132
313
  * - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
133
- * which is the whole of "filter to HIGH priority";
134
- * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
135
- * answer would be wrong by tomorrow;
314
+ * which is the whole of "filter to HIGH priority". On a year-month field one `YYYY-MM` month is the range that starts
315
+ * and ends with it, and reads as the same filter as that range picked in the panel;
316
+ * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case on a DATE field, resolved when the pill is clicked,
317
+ * because an authored answer would be wrong by tomorrow;
318
+ * - a RELATIVE MONTH RANGE (`{ relativeMonthRange }`) is the same case on a YEAR-MONTH field (#3444), resolved to the
319
+ * `{ startMonth, endMonth }` pair the panel's month pickers write;
136
320
  * - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
137
321
  * backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
138
322
  * commonest threshold anyone asks for;
323
+ * - a MONTH RANGE (`{ startMonth?, endMonth? }`) is a fixed range of months, such as one fiscal year, written as the
324
+ * panel writes it;
139
325
  * - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
140
326
  * when the pill is clicked, so the same authored preset shows each viewer their own rows.
327
+ *
328
+ * The object members are STRICT. A stripping parse turned an authored `{ startMonth, endMonth }` into the numeric
329
+ * bound `{}` (#3444): a month range silently became "no bound", and the pill filtered nothing under its name.
141
330
  */
142
331
  export const CollectionFilterPresetValueSchema = z.union([
143
332
  z.string(),
144
333
  z.number(),
145
334
  z.boolean(),
146
- z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
147
- z.object({ min: z.number().optional(), max: z.number().optional() }),
148
- z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
335
+ z.strictObject({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
336
+ z.strictObject({ relativeMonthRange: z.enum(CollectionFilterPresetRelativeMonthRange) }),
337
+ z.strictObject({ min: z.number().optional(), max: z.number().optional() }),
338
+ Resources_Filter_YearMonthRangeSchema,
339
+ z.strictObject({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
149
340
  ]);
150
341
  export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
151
342
 
@@ -236,8 +427,7 @@ export enum CardLayoutStyle {
236
427
  * **Historical note (search hit):** earlier versions of this schema exposed an
237
428
  * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
238
429
  * string[]`) operation-level field that authored which resource-owned views
239
- * surfaced in this operation. That field was removed in the
240
- * `resource-owned-view-surfacing-contract.md` workstream because it duplicated
430
+ * surfaced in this operation. That field was removed because it duplicated
241
431
  * the per-view declaration sites (`compositeViews`, `chartViews`,
242
432
  * `executionViews`) and could silently disagree with them. If you are looking
243
433
  * for `additionalViews` because a doc, comment, prompt, or downstream code
@@ -473,7 +663,7 @@ export interface ResourceActionDisclosureConfig {
473
663
  /**
474
664
  * How many PRIMARY actions render as direct buttons before the remainder
475
665
  * collapse into the `…` overflow menu. Omitted inherits the framework default
476
- * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY and 3 for
666
+ * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 1 for SUMMARY and 3 for
477
667
  * DETAIL. `0` pushes every action into the menu.
478
668
  */
479
669
  maxPrimaryActions?: number;
@@ -497,8 +687,15 @@ export interface ResolvedActionDisclosure {
497
687
  * Framework defaults per view.
498
688
  *
499
689
  * - SUMMARY (dense list/table rows) HIDES actions an unmet `enabledCondition`
500
- * disables and caps direct actions at 3 before the `…` menu: on a row, a greyed
501
- * button is noise repeated N times.
690
+ * disables and caps direct actions at ONE before the `…` menu: on a row, a greyed
691
+ * button is noise repeated N times. One, because a direct action shows its WORDS by
692
+ * default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066): three labelled buttons on every
693
+ * row crowd the record's own name off a 390px phone, while one named verb and a `…`
694
+ * menu (whose entries carry their words too) fit beside it. The verb that keeps the slot
695
+ * is the first one that can run, in `displayPriority` order (`allocateActionBarSlots`).
696
+ * It was 3 icon-only buttons until 2026-10-22, which on Wonder Procurement drew a pencil,
697
+ * a paper plane and a "ban" circle per request, none of them saying what it did. On a phone
698
+ * the row keeps none (`MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS`).
502
699
  * - DETAIL (the read view, and the bulk bar's disabled-action handling) SHOWS them.
503
700
  * On the record's own action bar it also caps direct actions at 3 before the `…`
504
701
  * menu, since the record header puts them on the name's own line. The bulk bar
@@ -517,7 +714,7 @@ export interface ResolvedActionDisclosure {
517
714
  */
518
715
  export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
519
716
  [ResourceOperationDisplayMode.SUMMARY]: {
520
- maxPrimaryActions: 3,
717
+ maxPrimaryActions: 1,
521
718
  disabledActionHandling: DisabledActionHandling.HIDE,
522
719
  },
523
720
  /*
@@ -541,6 +738,30 @@ export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, Res
541
738
  },
542
739
  };
543
740
 
741
+ /**
742
+ * How many direct actions a list row keeps on a PHONE when the resource authored no cap: none — every action is
743
+ * in the row's `…` menu, which shows each action's words (#3066).
744
+ *
745
+ * One labelled verb fits beside a record's name on a desktop row; on a 390px phone it does not. Measured on Wonder
746
+ * Procurement: "Cancel Purchase Request" beside a request's status pill truncated the request's title to a few
747
+ * letters. A phone row is opened with a tap, so its verbs belong in the menu, the way established list patterns
748
+ * hide their row shortcuts on small screens. A resource that authored `actionDisclosure[SUMMARY].maxPrimaryActions`
749
+ * keeps it on every screen.
750
+ */
751
+ export const MOBILE_SUMMARY_MAX_PRIMARY_ACTIONS = 0;
752
+
753
+ /**
754
+ * How many direct actions the record page header keeps on a PHONE when the resource authored no cap: one, beside the
755
+ * `…` menu (#3066).
756
+ *
757
+ * The header keeps three on a wider screen, and each shows its words. At 390px three labelled verbs do not fit on
758
+ * the line beneath the record's name, and they do not wrap: measured on Wonder Procurement ("Edit Draft", "Submit
759
+ * Purchase Request", "Cancel Purchase Request") and on Your Application, the third verb and the `…` menu ran off the right
760
+ * edge and could not be reached. One named verb and the menu fit; the verb is the first that can run, in
761
+ * `displayPriority` order.
762
+ */
763
+ export const MOBILE_DETAIL_MAX_PRIMARY_ACTIONS = 1;
764
+
544
765
  /**
545
766
  * Resolve the effective disclosure policy for a view: per-resource override
546
767
  * (`layout.actionDisclosure[view]`) layered over the framework default. Used by
@@ -715,6 +936,27 @@ export const ResourceOperationFrontendConfigSchema = z.object({
715
936
  collectionDisplayConfig: z.object({
716
937
  displayMode: z.enum(CollectionDisplayMode).optional(),
717
938
  userSwitchableDisplayMode: z.boolean().optional(),
939
+ /**
940
+ * The BOARD presentation: the field its columns come from and the operation a move calls. See
941
+ * {@link CollectionBoardConfig}. Required when `displayMode` is `BOARD`, and offered by the view-mode toggle beside
942
+ * CARDS and TABLE when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
943
+ * (`collectionBoardConfigurationDefect`): a board naming no field, a field that is not a filter field of the operation,
944
+ * a transition naming no operation of the resource, or a `board` no mode can reach refuses to start.
945
+ */
946
+ board: CollectionBoardConfigSchema.optional(),
947
+ /**
948
+ * The CALENDAR presentation: the date field each row sits on. See {@link CollectionCalendarConfig}. Required when
949
+ * `displayMode` is `CALENDAR`, and offered by the view-mode toggle when `userSwitchableDisplayMode` is on. Checked
950
+ * when the frontend registry is built (`collectionTemporalDisplayConfigurationDefect`).
951
+ */
952
+ calendar: CollectionCalendarConfigSchema.optional(),
953
+ /**
954
+ * The TIMELINE presentation: the date fields each row's bar starts and ends on. See
955
+ * {@link CollectionTimelineConfig}. Required when `displayMode` is `TIMELINE`, and offered by the view-mode toggle
956
+ * when `userSwitchableDisplayMode` is on. Checked when the frontend registry is built
957
+ * (`collectionTemporalDisplayConfigurationDefect`).
958
+ */
959
+ timeline: CollectionTimelineConfigSchema.optional(),
718
960
  /**
719
961
  * Promote ONE enum filter field to the collection toolbar's first line: a
720
962
  * segmented control ("All · <value> · <value> …" — the Stripe/Ignisign
@@ -746,7 +988,9 @@ export const ResourceOperationFrontendConfigSchema = z.object({
746
988
  * { ref: 'urgent', filters: { priority: 'high' } },
747
989
  * { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
748
990
  * { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
991
+ * { ref: 'callback-missed', filters: { callbackAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_NOW } } },
749
992
  * { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
993
+ * { ref: 'this-quarter', filters: { period: { relativeMonthRange: CollectionFilterPresetRelativeMonthRange.THIS_QUARTER } } },
750
994
  * ]
751
995
  */
752
996
  presetFilters: z.array(CollectionFilterPresetSchema).optional(),
@@ -0,0 +1,110 @@
1
+ # Telling a backend refusal apart in a catch (source)
2
+
3
+ - Read before writing a `catch` around an action, a save or any request a view starts itself.
4
+ - `isBackendRefusalShownToUser(error)`: the global error handler already showed it as a toast. Restore your state
5
+ (a pending flag, a loading flag) and add nothing of your own, or the person reads the same refusal twice. Never
6
+ rethrow it: a rethrow reaches the global handler again as an uncaught error.
7
+ - `isFinalBackendRefusal(error)`: a 4xx other than 408, 425 and 429. Sending the same request again gets the same
8
+ answer, so offer no "Try again". A network failure, a timeout or a 5xx is not final.
9
+ - `isBackendRefusal(error)`: the backend authored the failure, so `customMessageReference`, `context` and
10
+ `requestOutcome` are there to branch on a specific refusal. `false` for a network failure, a cancellation or a
11
+ proxy's error page.
12
+ - These are the frontend's predicates. `isWildoBackendError` from `@wildo-ai/saas-models` is the backend's: it is
13
+ false for every refusal that arrives over HTTP, so a frontend branch keyed on it never runs.
14
+ - What you do show comes from `useUserFacingErrorMessage()` (see `framework-user-facing-error-message-api.md`), never
15
+ from `error.message`.
16
+
17
+ ## Import Origins
18
+
19
+ - `@wildo-ai/saas-frontend-lib`
20
+
21
+ ## Source Excerpts
22
+
23
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
24
+
25
+ ```typescript
26
+ /**
27
+ * A refusal the backend authored, as a frontend `catch` receives it: the fields the HTTP client adds to a rejected
28
+ * request when the backend answered with its error envelope. Narrow a caught value to it with the predicates below,
29
+ * all imported from `@wildo-ai/saas-frontend-lib`. Never use `isWildoBackendError` (from `@wildo-ai/saas-models`) in
30
+ * frontend code: it recognises the backend's own error object, which never crosses HTTP, so it is false for every
31
+ * refusal a view can catch.
32
+ */
33
+ export interface BackendRefusal {
34
+ /** The response's HTTP status. */
35
+ readonly httpStatus: number;
36
+ /** The envelope's `type`. Its presence is what says the backend authored the refusal. */
37
+ readonly errorType: ErrorType;
38
+ /** The envelope's `customMessageReference`: the refusal's words in `errors_messages`. Absent on a bare envelope. */
39
+ readonly customMessageReference?: string;
40
+ /** Whether the refused request took effect, when the server knows (#3004). */
41
+ readonly requestOutcome?: ErrorRequestOutcome;
42
+ /** The envelope's sanitized `details` (an allow-listed `code`, `versionConflict`, `inForceReleases`, …). */
43
+ readonly context?: Readonly<Record<string, unknown>>;
44
+ /** Field-level validation errors, when the envelope names fields. */
45
+ readonly validationErrors?: Readonly<Record<string, unknown>>;
46
+ /** The `WildoError_Frontend` `handleHttpError` built from it, once retries are exhausted. */
47
+ readonly wildoError?: WildoError_Frontend;
48
+ /** Whether `handleHttpError` emitted it to the global error handler. */
49
+ readonly wildoErrorEventEmitted?: boolean;
50
+ }
51
+ ```
52
+
53
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
54
+
55
+ ```typescript
56
+ /**
57
+ * Whether a caught value is a refusal the backend authored: a rejected request whose response carried the backend's
58
+ * error envelope. False for a network failure, a cancellation, a timeout, a client-side error, and a response that is
59
+ * not the backend's envelope (a proxy's HTML 502).
60
+ */
61
+ export function isBackendRefusal(error: unknown): error is BackendRefusal {
62
+ if (error === null || typeof error !== 'object') return false;
63
+ const candidate = error as { httpStatus?: unknown; errorType?: unknown };
64
+ return typeof candidate.httpStatus === 'number' && typeof candidate.errorType === 'string' && ERROR_TYPES.has(candidate.errorType);
65
+ }
66
+
67
+ /**
68
+ * The statuses that say "send it again later" (RFC 9110 §15.5.9 408; RFC 8470 425; RFC 6585 §4 429). Every other 4xx
69
+ * is a refusal that sending the same request again cannot change.
70
+ */
71
+ export const RETRYABLE_CLIENT_ERROR_STATUSES: ReadonlySet<number> = new Set([408, 425, 429]);
72
+
73
+ /**
74
+ * Whether sending the same request again cannot change the answer: a backend refusal with a 4xx status other than
75
+ * {@link RETRYABLE_CLIENT_ERROR_STATUSES}. A 5xx is the server failing, and may clear on its own.
76
+ */
77
+ export function isFinalBackendRefusal(error: unknown): error is BackendRefusal {
78
+ return isBackendRefusal(error)
79
+ && error.httpStatus >= 400 && error.httpStatus < 500
80
+ && !RETRYABLE_CLIENT_ERROR_STATUSES.has(error.httpStatus);
81
+ }
82
+ ```
83
+
84
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
85
+
86
+ ```typescript
87
+ /**
88
+ * Whether the global error handler shows this error to the person as a notification: not silenced by the request
89
+ * (`suppressUserDisplay`), not hidden by the HTTP behaviour matrix (`showToUser`), and asking for a notification. The
90
+ * ONE statement of that rule: `GlobalErrorHandler` decides its toast with it.
91
+ */
92
+ export function wildoErrorIsShownToUser(wildoError: Pick<WildoError_Frontend, 'showToUser' | 'suppressUserDisplay' | 'frontendActions'>): boolean {
93
+ if (wildoError.suppressUserDisplay === true || wildoError.showToUser === false) return false;
94
+ const actions = (wildoError.frontendActions ?? []) as readonly ErrorActionFrontend[];
95
+ return actions.includes(ErrorActionFrontend.NOTIFY) || actions.includes(ErrorActionFrontend.SHOW_TOAST);
96
+ }
97
+
98
+ /**
99
+ * Whether the person has already been told about this refusal by the global error handler, so the catch should
100
+ * restore its state and add nothing. Two cases count as told without a toast of this request's own: an identical
101
+ * error the handler suppressed as a duplicate (the first one was shown), and a refusal that ended the session, which
102
+ * the sign-in page explains.
103
+ */
104
+ export function isBackendRefusalShownToUser(error: unknown): error is BackendRefusal {
105
+ return isBackendRefusal(error)
106
+ && error.wildoErrorEventEmitted === true
107
+ && error.wildoError !== undefined
108
+ && wildoErrorIsShownToUser(error.wildoError);
109
+ }
110
+ ```
@@ -102,6 +102,12 @@ does. The facet decides four things you therefore do not:
102
102
  unfinished: nothing about a vendor can be guessed from its name, so an engine that accepted one would
103
103
  be inventing a dialect and an auth scheme.
104
104
 
105
+ **On a developer machine the instance is the simulator fleet.** Once the instance is declared, run
106
+ `wildo local sor-addresses --write`, then `wildo local sor-secrets`, then `wildo local sor-simulators`. Ports, addresses and
107
+ test secrets are derived, never written by hand, and the records served come from
108
+ `system-of-record-simulators/fleet.dataset.ts` (`--scaffold-dataset` starts one). Read
109
+ `references/local-test-doubles.md`.
110
+
105
111
  #### Choosing: a named vendor, or the generic `odata`
106
112
 
107
113
  The library describes **seven** vendors — `odoo`, `microsoft-dataverse`,
@@ -240,7 +246,7 @@ parts of it are not guessable —
240
246
  `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, which a client must not answer by resending;
241
247
  - no bulk write, no nested child writes, no queued write, no write inside a transaction;
242
248
  - whether your dialect can write at all is the engine's — a binding opening a verb its dialect cannot
243
- send is refused at startup, naming the dialect. Odoo (`ODOO_JSONRPC`), OData v4 (`ODATA`) and
249
+ send is refused at startup, naming the dialect. Odoo (`ODOO_JSONRPC` and `ODOO_JSON2`), OData v4 (`ODATA`) and
244
250
  REST_JSON write; OData v2 (`ODATA_V2`) reads only, and SAP S/4HANA does not write (its CSRF-token
245
251
  handshake is not performed). A REST_JSON
246
252
  binding DECLARES each write it opens — `operations.create` / `update` / `delete`, a method and a
@@ -396,9 +402,21 @@ A package discovery does not walk by name (another scope's, or yours not named `
396
402
  listed in `providers.packages`, and your backend package
397
403
  must depend on it. Only a FIELD partition can be confined. Read `references/facet-augmentations.md`.
398
404
 
399
- **Who maps a partition to a unit is an operator**, through
400
- `systemOfRecordPartitionAssignments`. See the `authorization-unit-narrowing`
401
- skill for that door and for what it means to a caller.
405
+ **Assign every partition to a unit, or its rows never load.** A partition no unit holds is
406
+ refused by the copy-in pipeline ("remote partition is assigned to no organization unit") and
407
+ read by nobody through a read-through. Declare the assignment of each partition you know in the
408
+ organization identity declaration (`systemOfRecordPartitions`, one `{ system, remoteKey, unitKey }`
409
+ per partition), so every environment assigns them at its first boot; startup refuses a binding to an
410
+ instance that is not partitioned. An operator assigns a partition the declaration does not name, and
411
+ moves one, through `systemOfRecordPartitionAssignments`. Read `references/partition-from-the-domain-plan.md`,
412
+ and the `authorization-unit-narrowing` skill for the declaration and for what an assignment means to a caller.
413
+
414
+ **When the domain plan decided it.** A record location in the domain plan carries `partition`
415
+ (`NOT_SPLIT`, `BY_LEGAL_ENTITY`, `CANNOT_BE_SPLIT`, `UNCONFIRMED`), and the binding task names
416
+ `partitioned`. The plan decides only whether the records are split; the field they split on comes from
417
+ the vendor's effective facet (a facet augmentation an instance opts into included), never from the plan's author. The task partitions the instance exactly as
418
+ `partitioned` says, and its landing check holds it to the instance's flag, a copy's partition stamp,
419
+ and the vendor's ability to split. Read `references/partition-from-the-domain-plan.md`.
402
420
 
403
421
  ### What each lane owes
404
422
 
@@ -914,11 +932,15 @@ export enum ExternalDataFieldCoercion {
914
932
  NONE = 'none',
915
933
  /**
916
934
  * Odoo spells an ABSENT value as boolean `false` — a mapped string field would otherwise store
917
- * literal `false`. Applied by DEFAULT for ODOO_JSONRPC sources; declaring it on another dialect
935
+ * literal `false`. Applied by DEFAULT for Odoo sources (either dialect, #3391); declaring it on another dialect
918
936
  * is refused (the name is Odoo's semantics, not a generic null-coalesce).
919
937
  */
920
938
  ODOO_FALSE_AS_NULL = 'odoo-false-as-null',
921
- /** Parse a strict-ISO datetime string into a Date for a date-typed local field. */
939
+ /**
940
+ * Parse a datetime string into a Date for a date-typed local field. RFC 3339 only: a full-date, or a date-time with
941
+ * seconds and its offset (`Z` or `±hh:mm`); a value with no offset names no instant and rejects the row. On an Odoo
942
+ * source, Odoo's own `'YYYY-MM-DD HH:MM:SS'` is read too, as the UTC instant Odoo means by it (#3485).
943
+ */
922
944
  ISO_STRING_TO_DATE = 'iso-string-to-date',
923
945
  }
924
946
 
@@ -1351,13 +1373,16 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
1351
1373
  export type ExternalDataIncrementalExtractionDeclaration = z.infer<typeof ExternalDataIncrementalExtractionDeclarationSchema>;
1352
1374
 
1353
1375
  /**
1354
- * The dialect each incremental mode is spoken over. A `Record` over the enum so a mode added without
1355
- * its dialect is a compile error rather than a declaration the coherence check silently waves through.
1376
+ * The dialects each incremental mode is spoken over. A `Record` over the enum so a mode added without
1377
+ * its dialects is a compile error rather than a declaration the coherence check silently waves through.
1378
+ *
1379
+ * A LIST per mode since #3391: `write_date` is a column of Odoo's ORM, not of a wire, so it is read the same way
1380
+ * through `/jsonrpc` and through JSON-2 — one mode, two dialects. Kept in the order the dialects were added.
1356
1381
  */
1357
- export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT: Readonly<Record<ExternalDataIncrementalExtractionMode, HttpApiTransportDialect>> = {
1358
- [ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: HttpApiTransportDialect.ODOO_JSONRPC,
1359
- [ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: HttpApiTransportDialect.ODATA,
1360
- [ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: HttpApiTransportDialect.ODATA,
1382
+ export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECTS: Readonly<Record<ExternalDataIncrementalExtractionMode, readonly HttpApiTransportDialect[]>> = {
1383
+ [ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: [HttpApiTransportDialect.ODOO_JSONRPC, HttpApiTransportDialect.ODOO_JSON2],
1384
+ [ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: [HttpApiTransportDialect.ODATA],
1385
+ [ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: [HttpApiTransportDialect.ODATA],
1361
1386
  };
1362
1387
  ```
1363
1388
 
@@ -1549,6 +1574,9 @@ export const ExternalDataPipelineDeclarationSchema = z.strictObject({
1549
1574
 
1550
1575
  ## References
1551
1576
 
1577
+ - `references/local-test-doubles.md` — running the declared instances on a developer machine: the simulator fleet,
1578
+ the three `wildo local sor-*` commands, the application's port block, the dataset the faces serve, and where the
1579
+ fleet comes from (the `@wildo-ai/provider-simulators` devDependency, or a framework checkout).
1552
1580
  - `references/framework-external-data-pipeline-api.md` — the pipeline declaration contract, its
1553
1581
  authored vocabulary, and the coercions.
1554
1582
  - `references/framework-http-api-binding-api.md` — the virtual-resource binding contract and its
@@ -1564,6 +1592,9 @@ export const ExternalDataPipelineDeclarationSchema = z.strictObject({
1564
1592
  partitions, incremental modes, actions), asked instead of restated per vendor.
1565
1593
  - `references/system-of-record-actions.md` — running a declared ERP action (Odoo `action_post`, an
1566
1594
  OData action): the declaration, who may run it on which record, its one HTTP door, and its codes.
1595
+ - `references/presenting-a-copy-and-a-read-through.md` — when one concept lives in BOTH lanes: one navigation
1596
+ entry, the copy as the list people choose from, the read-through below it for who may read the source system, and
1597
+ no card that shows the source system's key alone.
1567
1598
  - `references/lane-selection.md` — the choice in Step 1 at more depth, including what each lane
1568
1599
  gives up and the industry precedent.
1569
1600
  - `references/pipeline-destination-schema.md` — the destination schema rules, and what each refusal
@@ -1589,6 +1620,9 @@ export const ExternalDataPipelineDeclarationSchema = z.strictObject({
1589
1620
  - `references/remote-references.md` — `REMOTE_REFERENCE`: turning an Odoo many2one or an OData
1590
1621
  navigation key into a real local foreign key, the pending set, `REJECT_ROW`, and the orphan-cascade
1591
1622
  refusal.
1623
+ - `references/partition-from-the-domain-plan.md` — a system's split by legal entity as the domain plan
1624
+ records it: the four `partition` outcomes, why the field comes only from the facet, what a binding task
1625
+ with `partitioned: true` writes, and the three reasons its landing check holds it back.
1592
1626
  - `references/facet-augmentations.md` — adding a partition or a credential kind to a vendor facet a
1593
1627
  package does not own: the augmentation record, the per-instance `facetAugmentations` opt-in, and what
1594
1628
  is refused at boot.
@@ -45,7 +45,7 @@ import { ExternalDataConflictPolicy, HttpApiTransportDialect, SystemOfRecordSubj
45
45
  externalDataPipeline: {
46
46
  direction: ExternalDataPipelineDirection.BIDIRECTIONAL,
47
47
  binding: {
48
- dialect: HttpApiTransportDialect.ODOO_JSONRPC, system: 'odoo', entityRef: 'res.partner',
48
+ dialect: HttpApiTransportDialect.ODOO_JSON2, system: 'odoo', entityRef: 'res.partner',
49
49
  keyFields: [{ localField: 'id', remoteField: 'id', codec: HttpApiKeyComponentCodec.INTEGER }],
50
50
  subjectRights: { posture: SystemOfRecordSubjectRightsPosture.NO_SUBJECT_DATA },
51
51
  writableVerbs: [HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE],