@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,23 +38,32 @@ import {
38
38
  type OpenApiGenerationInput,
39
39
  type OpenApiGenerationProjectorStats,
40
40
  type OperationProjection,
41
+ type ApiReferenceResourceCategory,
41
42
  type ResourceTag,
42
43
  type TechnicalDocGenerateOpenApiResult,
43
44
  type ApplicationConnectionServer,
44
45
  type ApplicationAuthenticationDocumentationSource,
45
46
  type ApplicationMcpToolSource,
46
47
  type ApplicationWebhookEventSource,
48
+ OPENAPI_AUTHORED_EXAMPLE_ERROR_NAME,
47
49
  } from '@wildo-ai/saas-technical-doc/companion';
48
50
  import {
49
51
  createApiReferenceLinkIndex,
50
52
  getTechnicalDocumentationApiReferenceTargetAvailability,
51
53
  resolveTechnicalDocumentationApiReferenceLink,
52
54
  TechnicalDocumentationApiReferenceTargetAvailability,
55
+ isApiReferenceEngineCategoryAssignment,
53
56
  type WildoTechnicalDocConfig,
54
57
  } from '@wildo-ai/saas-technical-doc';
55
- import type { TechnicalDocumentationApiReferenceTargetV1 } from '@wildo-ai/saas-specifications/technical-documentation';
58
+ import { ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION, EngineResourceSubDomain } from '@wildo-ai/saas-specifications';
59
+ import {
60
+ ApplicationDocumentationChapterSetSchema,
61
+ mergeApplicationDocumentationChapters,
62
+ type TechnicalDocumentationApiReferenceTargetV1,
63
+ } from '@wildo-ai/saas-specifications/technical-documentation';
56
64
  import { createConservedApiReferenceModel } from '@wildo-ai/saas-technical-doc/openapi-reference-model';
57
65
 
66
+ import { APPLICATION_DOCUMENTATION_CHAPTER_FILES_PATH, readApplicationDocumentationChapterFiles } from './technical-documentation-chapter-files.companion';
58
67
  import { TechnicalDocumentationPilotCompanionService } from './technical-documentation-pilot.companion.service';
59
68
  import { COMPANION_SERVICE_TYPES } from '../../core/inject/models/service-types';
60
69
  import type { CompanionContext } from '../../core/context/companion-context';
@@ -67,8 +76,9 @@ import type {
67
76
  TechnicalDocumentationEnvironmentIdentityInput,
68
77
  } from './technical-documentation-environment-identity.companion.service';
69
78
  import { getCompanionConfiguredPrimaryLanguage } from '../../core/config/primary-language.companion.utils';
70
- import { loadSpecificationsCompanionExports } from '../../core/context/companion-package-loaders.companion';
71
- import { readPerUnitLabels, resolvePerUnitFilePath } from '../../i18n-labelling/utils/per-unit-file.utils';
79
+ import { assertSpecificationWritePermitted } from '@wildo-ai/application-creation-runtime';
80
+ import { readSpecificationsForRewrite } from '../../core/context/companion-package-loaders.companion';
81
+ import { BACKEND_I18N_TREE_RELATIVE_PATH, readPerUnitLabels, resolvePerUnitFilePath } from '../../i18n-labelling/utils/per-unit-file.utils';
72
82
  import { ROLE_LABELLING_UNIT_FILE_PATH_HINT } from '../../i18n-labelling/utils/role-lifecycle-keys.utils';
73
83
 
74
84
  /**
@@ -82,7 +92,7 @@ export type {
82
92
 
83
93
  /**
84
94
  * Conventional file name for the per-service technical-documentation
85
- * configuration (Step 7.5 refactor — `saas-technical-doc.md`). Authored
95
+ * configuration. Authored
86
96
  * at the docs service root next to `package.json` / `docusaurus.config.ts`.
87
97
  *
88
98
  * Discovery is "by convention, not by configuration":
@@ -236,7 +246,7 @@ export class TechnicalDocCompanionService {
236
246
  * The application's documentation plan and its authored chapter bodies (#874), exactly as the
237
247
  * specifications package exports them. Parsed by the engine projector, not here.
238
248
  *
239
- * Read from the WORKING TREE — `loadSpecificationsCompanionExports` evaluates what the developer is
249
+ * Read from the WORKING TREE — `loadSpecificationsCompanionData` evaluates what the developer is
240
250
  * writing — exactly as every other specification-derived page is, so an uncommitted chapter can be
241
251
  * previewed. Acceptance is git's, not this method's: a chapter is accepted when its source and the
242
252
  * regenerated portal output are committed together.
@@ -250,10 +260,23 @@ export class TechnicalDocCompanionService {
250
260
  readonly documentationChapters?: unknown;
251
261
  }> {
252
262
  if (!this.companionContext.resolvedSpecifications) return {};
253
- const specifications = await loadSpecificationsCompanionExports(this.companionContext);
263
+ // One evaluation, and refused on any fault (#3258): a short read publishes without chapters the application accepted.
264
+ const read = await readSpecificationsForRewrite(this.companionContext, (exports) => exports);
265
+ assertSpecificationWritePermitted(read.basis, { packageRelativePath: 'The published documentation', fileExists: true, dryRun: false });
266
+ const documentationPlan = read.value?.documentationPlan;
267
+ /*
268
+ * The chapter FILES beside the inline set (#3204): one file per chapter, which nothing imports, merged here and
269
+ * refused on a chapter declared twice. Merged only when a file exists, so an application that writes its chapters
270
+ * inline keeps passing them to the projector exactly as it wrote them.
271
+ */
272
+ const inlineChapters = read.value?.documentationChapters;
273
+ const chapterFiles = await readApplicationDocumentationChapterFiles(this.companionContext.resolvedSpecifications.packageRoot);
274
+ const documentationChapters = chapterFiles.length === 0
275
+ ? inlineChapters
276
+ : mergeApplicationDocumentationChapters(inlineChapters === undefined ? undefined : ApplicationDocumentationChapterSetSchema.parse(inlineChapters), chapterFiles);
254
277
  return {
255
- ...(specifications.documentationPlan === undefined ? {} : { documentationPlan: specifications.documentationPlan }),
256
- ...(specifications.documentationChapters === undefined ? {} : { documentationChapters: specifications.documentationChapters }),
278
+ ...(documentationPlan === undefined ? {} : { documentationPlan }),
279
+ ...(documentationChapters === undefined ? {} : { documentationChapters }),
257
280
  };
258
281
  }
259
282
 
@@ -370,7 +393,7 @@ export class TechnicalDocCompanionService {
370
393
  if (generated.derivation.plannedChapterRefsWithoutBody.length > 0) {
371
394
  this.logger.warn('technical-documentation: planned chapters with no authored body are not published yet', {
372
395
  chapterRefs: generated.derivation.plannedChapterRefsWithoutBody,
373
- authoredIn: 'specifications/src/technical-documentation/index.ts',
396
+ authoredIn: `${APPLICATION_DOCUMENTATION_CHAPTER_FILES_PATH}/<chapterRef>.ts`,
374
397
  });
375
398
  }
376
399
  if (generated.derivation.authoredChapterRefsWithoutPlan.length > 0) {
@@ -479,7 +502,7 @@ export class TechnicalDocCompanionService {
479
502
  * can pass it straight through as JSON.
480
503
  *
481
504
  * The method does NOT short-circuit on a "disabled docs site" —
482
- * after the Step 7.5 refactor there is no `enabled` flag anywhere
505
+ * there is no `enabled` flag anywhere
483
506
  * (file presence under a TECH_DOC service IS the enable signal).
484
507
  * If the docs service or its `wildo.tech-doc.config.ts` is missing,
485
508
  * {@link loadTechnicalDocConfig} fails closed with a CONFIGURATION
@@ -549,6 +572,7 @@ export class TechnicalDocCompanionService {
549
572
  }> {
550
573
  const noProblems: ApiReferenceResourceCategoryProblems = {
551
574
  duplicateCategoryIds: [], resourcesInSeveralCategories: [], repeatedAssignments: [], unavailableAssignments: [], uncategorisedResourceNames: [],
575
+ engineResourceAssignments: [], categoriesShadowingEngine: [], unknownEngineCategories: [],
552
576
  };
553
577
  const techDocService = Object.values(this.companionContext.saasConfig.services)
554
578
  .find((service) => service.frontendType === AppFrontendType.TECH_DOC);
@@ -602,13 +626,22 @@ export class TechnicalDocCompanionService {
602
626
  ...(apiDocResources !== undefined ? { apiDocResources } : {}),
603
627
  ...(excludedCoreResourceTypes !== undefined ? { excludedCoreResourceTypes } : {}),
604
628
  };
629
+ /*
630
+ * `verifyAgainstSource` (#1775): every caller of this door either writes a committed artifact
631
+ * (`publishOpenApiReference`, `publishManagedDocumentation`) or predicts one (`wildo docs check`,
632
+ * the bundle derivation publication shares). A held answer compiled against a tree that has since
633
+ * moved is therefore never acceptable here. Without the option, a failed recompile after an engine
634
+ * change serves the pre-change derivation, and a publish wrote a byte-identical `api.json` and
635
+ * reported it current (measured 2026-09-26). With it, that recompile's failure is what comes back,
636
+ * and the throw below names it.
637
+ */
605
638
  const introspection = await this.companionIntrospectionService.requestInfo({
606
639
  serviceKey: this.pickProjectorCarrierServiceKey(),
607
640
  behavior: 'openapi-generation-input',
608
641
  // Thread both the authored core-resource selection and the canonical
609
642
  // runtime feature exclusions across the JSON-safe subprocess boundary.
610
643
  ...(Object.keys(input).length > 0 ? { input } : {}),
611
- });
644
+ }, { verifyAgainstSource: true });
612
645
 
613
646
  if (introspection.success === false) {
614
647
  const failure = introspection;
@@ -660,13 +693,12 @@ export class TechnicalDocCompanionService {
660
693
  /**
661
694
  * Compose the subprocess projection with the
662
695
  * `WildoSaasConfig`-derived metadata the parent process owns +
663
- * the per-service `wildo.tech-doc.config.ts` block (Step 7.5
664
- * refactor — `saas-technical-doc.md`).
696
+ * the per-service `wildo.tech-doc.config.ts` block.
665
697
  *
666
698
  * The `publicMarketingTitle` projected into `openapi.info.title`
667
699
  * comes from the per-service config (NOT from
668
700
  * `WildoSaasConfig.technicalDoc?.publicMarketingTitle` — that root-
669
- * level field was removed in Step 7.5 in favor of co-locating the
701
+ * level field was removed in favor of co-locating the
670
702
  * tech-doc-specific config with the engine package that owns it).
671
703
  *
672
704
  * Re-parses the result through `OpenApiGenerationInputSchema`
@@ -732,7 +764,7 @@ export class TechnicalDocCompanionService {
732
764
  * (unique) `frontendType: TECH_DOC` service declared in
733
765
  * `wildo.saas.config.ts`.
734
766
  *
735
- * Discovery contract (Step 7.5 refactor — `saas-technical-doc.md`):
767
+ * Discovery contract:
736
768
  *
737
769
  * - The TECH_DOC service is identified by `frontendType === TECH_DOC`,
738
770
  * NOT by service key. This decouples the companion from any
@@ -883,7 +915,7 @@ export class TechnicalDocCompanionService {
883
915
  throw new Error(`technical-documentation role labels require a declared backend service key: ${backendServiceKey}`);
884
916
  }
885
917
  const primaryLocale = getCompanionConfiguredPrimaryLanguage(this.appConfigService.config);
886
- const i18nRoot = path.resolve(this.companionContext.saasRoot, backendService.path, 'src/engine/i18n');
918
+ const i18nRoot = path.resolve(this.companionContext.saasRoot, backendService.path, BACKEND_I18N_TREE_RELATIVE_PATH);
887
919
  const roleLabelsPath = resolvePerUnitFilePath({
888
920
  i18nRoot,
889
921
  unit: { filePathHint: ROLE_LABELLING_UNIT_FILE_PATH_HINT },
@@ -927,10 +959,12 @@ export class TechnicalDocCompanionService {
927
959
  * A resource with no public route is in it too (the generator drops its empty group only after categorisation), so it
928
960
  * still needs a category.
929
961
  *
930
- * All five are the application's own configuration, never a fault of the companion: a category id declared twice, a
962
+ * All eight are the application's own configuration, never a fault of the companion: a category id declared twice, a
931
963
  * resource placed in two different categories, a resource listed twice in one category (`<categoryId>:<resourceName>`),
932
- * a category naming a resource the reference does not document (`<categoryId>:<resourceName>`), and a documented
933
- * resource with no category from the config or from the engine.
964
+ * a category naming a resource the reference does not document (`<categoryId>:<resourceName>`), a documented resource
965
+ * with no category from the config or from the engine, and the three #1840 added: an entry naming a resource the
966
+ * ENGINE already categorises (`<categoryId>:<resourceName>`), an application category whose id or label is an engine
967
+ * category's (its id), and an `engineCategory` that is no engine category (the value).
934
968
  */
935
969
  export interface ApiReferenceResourceCategoryProblems {
936
970
  readonly duplicateCategoryIds: readonly string[];
@@ -938,6 +972,9 @@ export interface ApiReferenceResourceCategoryProblems {
938
972
  readonly repeatedAssignments: readonly string[];
939
973
  readonly unavailableAssignments: readonly string[];
940
974
  readonly uncategorisedResourceNames: readonly string[];
975
+ readonly engineResourceAssignments: readonly string[];
976
+ readonly categoriesShadowingEngine: readonly string[];
977
+ readonly unknownEngineCategories: readonly string[];
941
978
  }
942
979
 
943
980
  export function hasApiReferenceResourceCategoryProblems(findings: ApiReferenceResourceCategoryProblems): boolean {
@@ -945,7 +982,10 @@ export function hasApiReferenceResourceCategoryProblems(findings: ApiReferenceRe
945
982
  || findings.resourcesInSeveralCategories.length > 0
946
983
  || findings.repeatedAssignments.length > 0
947
984
  || findings.unavailableAssignments.length > 0
948
- || findings.uncategorisedResourceNames.length > 0;
985
+ || findings.uncategorisedResourceNames.length > 0
986
+ || findings.engineResourceAssignments.length > 0
987
+ || findings.categoriesShadowingEngine.length > 0
988
+ || findings.unknownEngineCategories.length > 0;
949
989
  }
950
990
 
951
991
  /** Every problem in one sentence per kind, so a refusal names all of them at once rather than the first. */
@@ -966,6 +1006,15 @@ export function describeApiReferenceResourceCategoryProblems(findings: ApiRefere
966
1006
  if (findings.uncategorisedResourceNames.length > 0) {
967
1007
  sentences.push(`API-reference resources have no category, from this config or from the engine: ${findings.uncategorisedResourceNames.join(', ')}`);
968
1008
  }
1009
+ if (findings.engineResourceAssignments.length > 0) {
1010
+ sentences.push(`API-reference categories name engine resources, which the engine groups itself: ${findings.engineResourceAssignments.join(', ')}`);
1011
+ }
1012
+ if (findings.categoriesShadowingEngine.length > 0) {
1013
+ sentences.push(`API-reference categories repeat an engine category's id or label (file the resources with engineCategory instead): ${findings.categoriesShadowingEngine.join(', ')}`);
1014
+ }
1015
+ if (findings.unknownEngineCategories.length > 0) {
1016
+ sentences.push(`API-reference engineCategory values name no engine category (${ENGINE_API_REFERENCE_CATEGORY_IDS.join(', ')}): ${findings.unknownEngineCategories.join(', ')}`);
1017
+ }
969
1018
  return sentences.join('. ');
970
1019
  }
971
1020
 
@@ -983,35 +1032,121 @@ export class ApiReferenceResourceCategoryError extends Error {
983
1032
  }
984
1033
  }
985
1034
 
1035
+ /**
1036
+ * The sentence a caller is owed when the documentation lane REFUSES what the application declares, or `undefined` when
1037
+ * `error` is not such a refusal (a broken host, a full disk: left to the caller's internal path).
1038
+ *
1039
+ * The ONE predicate every door asks (#3462). A documentation refusal is raised by the documentation routes
1040
+ * (`answerTechnicalDocFailure`) and, through the build's DOCUMENTATION_PUBLICATION generation step, by every door that
1041
+ * dispatches a build synchronously: the companion's build routes (`forwardBuildDispatchError`) and the workbench
1042
+ * board's verbs (`translateCreationPlaneDispatchError`). Each door used to keep its own list, so #1838's example refusal
1043
+ * reached the build routes as a bare 500 and the board recognised neither refusal. Adding a documentation refusal here
1044
+ * is the whole change; no door can be left behind.
1045
+ *
1046
+ * Matched by NAME, the property that survives every boundary the error can cross (the generator lives in another
1047
+ * package, and a second copy of a class would defeat `instanceof`). Rejected: a marker interface or a common base class
1048
+ * across the two packages, which would make `saas-technical-doc` depend on a companion type for no gain over the name.
1049
+ *
1050
+ * - The category refusal (#1891) names resources to add to or remove from `apiReferenceResourceCategories`; the
1051
+ * sentence appends where that configuration lives and how to check it.
1052
+ * - The authored-example refusal (#1838) names each example untrue of its schema (operation, where it is attached, its
1053
+ * title, the offending path); its own message already says to correct the operation's `examples`.
1054
+ */
1055
+ export function describeDocumentationLaneRefusal(error: unknown): string | undefined {
1056
+ const name = (error as { name?: unknown } | null | undefined)?.name;
1057
+ if (name === API_REFERENCE_RESOURCE_CATEGORY_ERROR_NAME) {
1058
+ return `${(error as Error).message}. Fix apiReferenceResourceCategories in the documentation service's wildo.tech-doc.config.ts, then run \`wildo docs check\`.`;
1059
+ }
1060
+ if (name === OPENAPI_AUTHORED_EXAMPLE_ERROR_NAME) return (error as Error).message;
1061
+ return undefined;
1062
+ }
1063
+
1064
+ /** The engine's API-reference categories, in declaration order: the values an `engineCategory` may name. */
1065
+ const ENGINE_API_REFERENCE_CATEGORY_IDS: readonly string[] = Object.values(EngineResourceSubDomain);
1066
+
1067
+ type ApiReferenceResourceCategoryAssignments = NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>;
1068
+
1069
+ /**
1070
+ * The category an assignment puts its resources in. An engine reference takes the engine's own words, so the group
1071
+ * reads identically whichever side a resource came from; `undefined` when the reference names no engine category.
1072
+ */
1073
+ function resolveAssignedCategory(assignment: ApiReferenceResourceCategoryAssignments[number]): ApiReferenceResourceCategory | undefined {
1074
+ if (isApiReferenceEngineCategoryAssignment(assignment)) {
1075
+ if (!ENGINE_API_REFERENCE_CATEGORY_IDS.includes(assignment.engineCategory)) return undefined;
1076
+ const documentation = ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION[assignment.engineCategory as EngineResourceSubDomain];
1077
+ return { id: assignment.engineCategory, label: documentation.label, description: documentation.description };
1078
+ }
1079
+ return {
1080
+ id: assignment.id,
1081
+ label: assignment.label,
1082
+ ...(assignment.description === undefined ? {} : { description: assignment.description }),
1083
+ };
1084
+ }
1085
+
1086
+ /** The id an assignment groups under: an application category's own id, or the engine category it names. */
1087
+ function assignedCategoryId(assignment: ApiReferenceResourceCategoryAssignments[number]): string {
1088
+ return isApiReferenceEngineCategoryAssignment(assignment) ? assignment.engineCategory : assignment.id;
1089
+ }
1090
+
1091
+ /**
1092
+ * Case and spacing do not make a different word: "notifications " is the engine's "Notifications". Only the same word
1093
+ * is refused; a near-synonym ("Notifications and webhooks") is left to the author, as no rule can tell it from a
1094
+ * genuinely different part of the product.
1095
+ */
1096
+ function normalizedCategoryLabel(label: string): string {
1097
+ return label.trim().replace(/\s+/g, ' ').toLowerCase();
1098
+ }
1099
+
986
1100
  /**
987
1101
  * Checks the application's categories against the resource tags the projector resolved, and reports every problem
988
1102
  * instead of stopping at the first. See {@link applyApiReferenceResourceCategories} for the completeness rule.
989
1103
  */
990
1104
  export function findApiReferenceResourceCategoryProblems(
991
1105
  resourceTags: readonly ResourceTag[],
992
- categories: NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>,
1106
+ categories: ApiReferenceResourceCategoryAssignments,
993
1107
  ): ApiReferenceResourceCategoryProblems {
994
1108
  const tagsByName = new Map(resourceTags.map((tag) => [tag.name, tag]));
995
1109
  // The projector's own invariant, not the application's configuration: it stays an internal error.
996
1110
  if (tagsByName.size !== resourceTags.length) throw new Error('OpenAPI resource tags must be unique before category assignment');
997
1111
 
1112
+ const engineLabels = new Set(Object.values(ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION).map((documentation) => normalizedCategoryLabel(documentation.label)));
998
1113
  const seenCategoryIds = new Set<string>();
999
1114
  const duplicateCategoryIds = new Set<string>();
1115
+ const categoriesShadowingEngine = new Set<string>();
1116
+ const unknownEngineCategories = new Set<string>();
1000
1117
  /** Per resource, the DISTINCT category ids naming it; a second listing under the same id is a repeated assignment. */
1001
1118
  const categoryIdsByResourceName = new Map<string, Set<string>>();
1002
1119
  const repeatedAssignments = new Set<string>();
1003
1120
  const unavailableAssignments: string[] = [];
1121
+ const engineResourceAssignments: string[] = [];
1004
1122
  for (const category of categories) {
1005
- if (seenCategoryIds.has(category.id)) duplicateCategoryIds.add(category.id);
1006
- seenCategoryIds.add(category.id);
1123
+ const categoryId = assignedCategoryId(category);
1124
+ if (seenCategoryIds.has(categoryId)) duplicateCategoryIds.add(categoryId);
1125
+ seenCategoryIds.add(categoryId);
1126
+ if (isApiReferenceEngineCategoryAssignment(category)) {
1127
+ if (!ENGINE_API_REFERENCE_CATEGORY_IDS.includes(category.engineCategory)) unknownEngineCategories.add(category.engineCategory);
1128
+ } else if (ENGINE_API_REFERENCE_CATEGORY_IDS.includes(category.id) || engineLabels.has(normalizedCategoryLabel(category.label))) {
1129
+ categoriesShadowingEngine.add(category.id);
1130
+ }
1007
1131
  for (const resourceName of category.resourceNames) {
1008
- if (!tagsByName.has(resourceName)) {
1009
- unavailableAssignments.push(`${category.id}:${resourceName}`);
1132
+ const tag = tagsByName.get(resourceName);
1133
+ if (tag === undefined) {
1134
+ unavailableAssignments.push(`${categoryId}:${resourceName}`);
1135
+ continue;
1136
+ }
1137
+ /*
1138
+ * A tag reaching this join with a category already carries the ENGINE's (the projector sets one only for an
1139
+ * engine resource, from the engine's own specification; the manual route groups likewise). Moving it is what
1140
+ * #1840 measured: an application re-filing engine resources into its own taxonomy leaves every engine resource
1141
+ * added later in the engine's group, beside the application's twin of it.
1142
+ */
1143
+ if (tag.category !== undefined) {
1144
+ engineResourceAssignments.push(`${categoryId}:${resourceName}`);
1010
1145
  continue;
1011
1146
  }
1012
1147
  const categoryIds = categoryIdsByResourceName.get(resourceName) ?? new Set<string>();
1013
- if (categoryIds.has(category.id)) repeatedAssignments.add(`${category.id}:${resourceName}`);
1014
- categoryIds.add(category.id);
1148
+ if (categoryIds.has(categoryId)) repeatedAssignments.add(`${categoryId}:${resourceName}`);
1149
+ categoryIds.add(categoryId);
1015
1150
  categoryIdsByResourceName.set(resourceName, categoryIds);
1016
1151
  }
1017
1152
  }
@@ -1027,32 +1162,38 @@ export function findApiReferenceResourceCategoryProblems(
1027
1162
  .filter((tag) => !categoryIdsByResourceName.has(tag.name) && tag.category === undefined)
1028
1163
  .map((tag) => tag.name)
1029
1164
  .sort(),
1165
+ engineResourceAssignments: engineResourceAssignments.sort(),
1166
+ categoriesShadowingEngine: [...categoriesShadowingEngine].sort(),
1167
+ unknownEngineCategories: [...unknownEngineCategories].sort(),
1030
1168
  };
1031
1169
  }
1032
1170
 
1033
1171
  /**
1034
- * Attaches the documentation config's explicit API taxonomy to the resolved
1035
- * resource tags before OpenAPI generation.
1172
+ * Attaches the application's API-reference categories to the resolved resource tags before OpenAPI generation.
1036
1173
  *
1037
- * The operation subprocess owns the resolved resource inventory and
1038
- * specification facts; the TECH_DOC config owns an application's editorial
1039
- * navigation taxonomy. Joining them here keeps both truths in their proper
1040
- * owners, then makes the OpenAPI document the sole transport to the browser.
1041
- * Once an application elects to declare categories, an exact inventory join is
1042
- * required: an uncategorised new resource or a stale config name must stop
1043
- * publication instead of quietly producing a misleading partial navigation.
1174
+ * The operation subprocess owns the resolved resource inventory and specification facts, and gives every ENGINE
1175
+ * resource its category from the engine's own vocabulary (`projectResourceTag`). The TECH_DOC config owns how the
1176
+ * APPLICATION's resources are grouped. Joining them here keeps both truths in their owners, then makes the OpenAPI
1177
+ * document the sole transport to the browser. Once an application declares categories, the join is exact: an
1178
+ * uncategorised new resource or a stale config name stops publication instead of producing a partial navigation.
1044
1179
  *
1045
- * The completeness rule is about the RESULT, not about this config: a resource
1046
- * satisfies it either by being assigned here or by already carrying the
1047
- * engine's own sub-domain category (`projectResourceTag`). That distinction is
1048
- * what makes the declaration usable at all — a generated application publishes
1049
- * roughly eight resources of its own beside fifty-two of the engine's, so a
1050
- * rule demanding the config name every one of them means an application must
1051
- * hand-classify the engine's catalogue, and re-classify it whenever the engine
1052
- * grows. Wonder CRM opted out entirely for that reason and rendered its whole
1053
- * reference as one flat list. An explicit assignment still WINS over the
1054
- * engine's default, so an application that wants its own product-shaped
1055
- * taxonomy across engine and application resources keeps it.
1180
+ * The completeness rule is about the RESULT: a resource satisfies it by being assigned here or by carrying the
1181
+ * engine's category. An application publishes roughly eight resources of its own beside fifty-two of the engine's, so
1182
+ * a rule demanding the config name every one of them would make it hand-classify the engine's catalogue. Wonder CRM
1183
+ * opted out entirely for that reason until the engine categorised its own (#1891).
1184
+ *
1185
+ * ## Why an application may no longer move an engine resource (#1840)
1186
+ *
1187
+ * It could, until #1840: an explicit assignment won over the engine's category. Your Application used that to re-file the
1188
+ * engine catalogue into a taxonomy of its own, written once, and every engine resource added afterwards fell into the
1189
+ * engine's group beside the application's twin of it. Measured on its reference: 21 groups, 8 of them single, and five
1190
+ * near-duplicate pairs ("Notifications and webhooks" / "Notifications", "Organization management" / "Organizations",
1191
+ * "Automation and agents" / "Automation"…). A taxonomy that overrides another can only stay whole while someone
1192
+ * re-reads the other one at every change, which nobody does; so there is one vocabulary for the engine's resources,
1193
+ * the engine's, and the application files its OWN resources either into an application category or, by
1194
+ * `engineCategory`, into the engine's. Rejected: keeping the override and refusing a PARTIAL one (a sub-domain must be
1195
+ * re-filed whole or not at all). It still breaks the day the engine adds a resource, turning drift into a refusal in an
1196
+ * application that did nothing, and it keeps two vocabularies for one thing.
1056
1197
  */
1057
1198
  export function applyApiReferenceResourceCategories(
1058
1199
  resourceTags: readonly ResourceTag[],
@@ -1061,24 +1202,15 @@ export function applyApiReferenceResourceCategories(
1061
1202
  if (categories === undefined) return [...resourceTags];
1062
1203
  const findings = findApiReferenceResourceCategoryProblems(resourceTags, categories);
1063
1204
  if (hasApiReferenceResourceCategoryProblems(findings)) throw new ApiReferenceResourceCategoryError(findings);
1064
- /*
1065
- * `NonNullable<…>` before `[number]`: the config field is OPTIONAL, so its type is
1066
- * `Array | undefined` and indexing `| undefined` with `[number]` is not a thing (#352). The guard
1067
- * at the top narrows the VALUE, which a type expression cannot see.
1068
- */
1069
- const categoryByResourceName = new Map<string, NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>[number]>();
1070
- for (const category of categories) for (const resourceName of category.resourceNames) categoryByResourceName.set(resourceName, category);
1205
+ const categoryByResourceName = new Map<string, ApiReferenceResourceCategory>();
1206
+ for (const category of categories) {
1207
+ // Every engine reference resolves here: an unknown one is a finding, refused above.
1208
+ const resolved = resolveAssignedCategory(category)!;
1209
+ for (const resourceName of category.resourceNames) categoryByResourceName.set(resourceName, resolved);
1210
+ }
1071
1211
  return resourceTags.map((tag) => {
1072
1212
  const category = categoryByResourceName.get(tag.name);
1073
- if (category === undefined) return { ...tag };
1074
- return {
1075
- ...tag,
1076
- category: {
1077
- id: category.id,
1078
- label: category.label,
1079
- ...(category.description === undefined ? {} : { description: category.description }),
1080
- },
1081
- };
1213
+ return category === undefined ? { ...tag } : { ...tag, category: { ...category } };
1082
1214
  });
1083
1215
  }
1084
1216
 
@@ -0,0 +1,105 @@
1
+ # domain-plan.record-partition
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-specifications`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-specifications`
10
+
11
+ ```typescript
12
+ *
13
+ * Whether an outside system's records are SPLIT BY LEGAL ENTITY: an ERP holding several companies of one group
14
+ * (Odoo companies, NetSuite subsidiaries), whose requirements say each subsidiary sees only its own records ("each
15
+ * subsidiary sees its own suppliers").
16
+ *
17
+ * ## Two halves, and the plan decides only one of them
18
+ *
19
+ * WHETHER the records are split is a product fact the requirements state, and the model says it
20
+ * (`splitByLegalEntity` on the generation contract). HOW the system splits them (which field carries the entity) is a
21
+ * fact about the VENDOR, which its system-of-record facet declares (`partition`), and the model never states it:
22
+ * the generation normalizer LAYS IT DOWN from the facet ({@link layDownDomainPlanRecordPartition}). So the plan can say
23
+ * a split the system cannot make only as `CANNOT_BE_SPLIT`, never as a partition nobody declared.
24
+ *
25
+ * Which unit each entity maps to is not a plan decision either: it is the operator's assignment of each remote partition
26
+ * to an organization unit at runtime (`systemOfRecordPartitionAssignments`), and the confinements already say which
27
+ * resources follow units.
28
+ *
29
+ * ## What each member makes the build do
30
+ *
31
+ * The split is a property of the system's INSTANCE (`systemsOfRecord.<name>.partition: true`), so every resource read from
32
+ * one instance is split alike, and the validator refuses two entries of one system that disagree. The binding task
33
+ * declares the flag ({@link domainPlanRecordPartitionPartitionsInstance}), and a copied resource then stamps each row's
34
+ * unit and entity key on its pipeline (`partitionUnitLocalField`, `partitionKeyLocalField`).
35
+ *
36
+ * Exported from `@wildo-ai/saas-specifications/application-creation`, with the domain plan's other schemas.
37
+ */
38
+ export enum DomainPlanRecordPartition {
39
+ /** The requirements do not split the records: every member who may read the resource sees every entity's records. */
40
+ NOT_SPLIT = 'NOT_SPLIT',
41
+ /**
42
+ * Split by legal entity on the field the system's EFFECTIVE facet declares (`partitionField`, laid down from the facet,
43
+ * a facet augmentation the instance opted into included): the instance is partitioned, and a member sees the entities assigned to the units they hold a role in.
44
+ */
45
+ BY_LEGAL_ENTITY = 'BY_LEGAL_ENTITY',
46
+ /**
47
+ * The requirements split the records by legal entity, and the system's effective facet (its base facet and any
48
+ * augmentation its instance opted into) declares no partition the engine can confine on (none at all, a path-segment
49
+ * partition, or no facet of that kind). The records cannot be split: every
50
+ * member who may read the resource sees every entity's records. The plan says so rather than claiming a split, and the
51
+ * validator warns.
52
+ */
53
+ CANNOT_BE_SPLIT = 'CANNOT_BE_SPLIT',
54
+ /**
55
+ * The requirements split the records by legal entity, and the facets could not be read when the plan was written (an
56
+ * application that has not installed the facet library yet), or the engine's resolution refused the system's facet. The plan records the request without a partition field;
57
+ * the build still partitions the instance, and the backend refuses `partition: true` at startup on a vendor whose facet
58
+ * declares none, so the split is confirmed there or refused by name. The validator warns.
59
+ */
60
+ UNCONFIRMED = 'UNCONFIRMED',
61
+ }
62
+
63
+ /**
64
+ * Whether a record partition makes the system's INSTANCE partitioned (`partition: true`): what the binding task declares
65
+ * and its landing probe compares. Total over {@link DomainPlanRecordPartition} (no default), so a member added tomorrow is
66
+ * a compile error here until somebody decides.
67
+ */
68
+ export function domainPlanRecordPartitionPartitionsInstance(partition: DomainPlanRecordPartition): boolean {
69
+ switch (partition) {
70
+ case DomainPlanRecordPartition.BY_LEGAL_ENTITY:
71
+ case DomainPlanRecordPartition.UNCONFIRMED:
72
+ return true;
73
+ case DomainPlanRecordPartition.NOT_SPLIT:
74
+ case DomainPlanRecordPartition.CANNOT_BE_SPLIT:
75
+ return false;
76
+ }
77
+ }
78
+ ```
79
+
80
+ ### Origin Package: `@wildo-ai/saas-specifications`
81
+
82
+ ```typescript
83
+ *
84
+ * LAYS DOWN one record location's partition from the facet, never from the model: the model says only whether
85
+ * the requirements split the records (`splitByLegalEntity`). A split on a kind whose facet declares a confinable partition
86
+ * is `BY_LEGAL_ENTITY` on that facet's field; on a kind whose facet declares none, or that has no facet, it is
87
+ * `CANNOT_BE_SPLIT`; with no facets read (`partitionFields` undefined), or a kind whose facet could not be resolved, it is
88
+ * `UNCONFIRMED`. The facets are the application's effective ones, a facet augmentation's partition included. Pure.
89
+ */
90
+ export function layDownDomainPlanRecordPartition(input: {
91
+ readonly systemOfRecordKind: string;
92
+ readonly splitByLegalEntity: boolean;
93
+ readonly partitionFields: DomainPlanSystemOfRecordPartitionFields | undefined;
94
+ }): { readonly partition: DomainPlanRecordPartition; readonly partitionField?: string } {
95
+ if (!input.splitByLegalEntity) return { partition: DomainPlanRecordPartition.NOT_SPLIT };
96
+ if (input.partitionFields === undefined) return { partition: DomainPlanRecordPartition.UNCONFIRMED };
97
+ if (!Object.hasOwn(input.partitionFields, input.systemOfRecordKind)) return { partition: DomainPlanRecordPartition.CANNOT_BE_SPLIT };
98
+ const field = input.partitionFields[input.systemOfRecordKind];
99
+ if (typeof field === 'string') return { partition: DomainPlanRecordPartition.BY_LEGAL_ENTITY, partitionField: field };
100
+ // A refusal is a value (see `DomainPlanSystemOfRecordPartitionFields`); `null` is a facet with no partition.
101
+ return field !== null && typeof field === 'object'
102
+ ? { partition: DomainPlanRecordPartition.UNCONFIRMED }
103
+ : { partition: DomainPlanRecordPartition.CANNOT_BE_SPLIT };
104
+ }
105
+ ```
@@ -98,8 +98,10 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
98
98
  'node:path',
99
99
  /**
100
100
  * `node:module` and `node:url` — the blog's React MDX integration (`blog-react-mdx.integration.ts`, on the
101
- * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/mdx` with `createRequire`,
101
+ * `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/markdown-remark` with `createRequire`,
102
102
  * and names the site root in its refusal with `fileURLToPath`. It runs in `astro.config.ts`, never in an island.
103
+ * The blog-cover resolver's `own-dependency-specifier.ts` (#2997) uses both too, inside the site's prerender
104
+ * chunks: it resolves `sharp` from this package's installed copy where the bundled bare import cannot.
103
105
  */
104
106
  'node:module',
105
107
  'node:url',