@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

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 (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -83,12 +83,18 @@ export interface BackendOnlyFieldParams {
83
83
  * then stripped from all subsequent READ operations.
84
84
  * Useful for secrets, API keys, etc. that should only be returned once.
85
85
  *
86
- * This is also the framework's ONLY disclosure-audit trigger: a field that carries it emits one
86
+ * This is one of the framework's two disclosure-audit triggers: a field that carries it emits one
87
87
  * `FIELD_ACCESS` audit event at the moment it is first (and last) exposed. That pairing is not a
88
- * coincidence — first exposure is the only point at which a backend-only field crosses the client
88
+ * coincidence: first exposure is the only point at which a backend-only field crosses the client
89
89
  * boundary at all, so it is the only point at which "this value left the system" is a true claim.
90
90
  *
91
- * Scope limit worth knowing before relying on it: the audit event is raised from the TOP-LEVEL
91
+ * The other trigger is `.isEphemeral()`, which fires on ANY operation rather than only on create,
92
+ * so a rotate or a regenerate that hands the secret over again is recorded too. The two answer
93
+ * different questions and neither implies the other: this one names the stored artifact, the
94
+ * ephemeral marker names the value actually handed over. A field may carry either, both, or
95
+ * neither, and one marked both is audited once.
96
+ *
97
+ * Scope limit worth knowing before relying on either: the audit event is raised from the TOP-LEVEL
92
98
  * shape of the response DTO. A single `CREATE` is the reliably covered case; do not assume a
93
99
  * bulk-create response gives you the same guarantee without checking.
94
100
  *
@@ -305,13 +311,6 @@ export interface UniqueFieldParams {
305
311
  */
306
312
  sparse?: boolean;
307
313
 
308
- /**
309
- * Custom error message to show when uniqueness is violated.
310
- * Supports placeholder {fieldName} which is replaced with the actual field name.
311
- * @example "This {fieldName} is already taken"
312
- */
313
- errorMessage?: string;
314
-
315
314
  /**
316
315
  * The custom message reference the API returns when THIS field's unique index is violated.
317
316
  *
@@ -389,8 +388,28 @@ export interface BusinessKeySetParams {
389
388
  /**
390
389
  *
391
390
  * Parameters for the ttl decorator.
392
- * Marks a Date field for TTL (Time To Live) expiration in MongoDB.
393
- * MongoDB will automatically delete documents when the TTL expires.
391
+ *
392
+ * Declares a ROW LIFETIME: rows of this resource are deleted once the instant derived from this
393
+ * Date field has passed. This is storage limitation — a compliance surface — not housekeeping, so
394
+ * the declaration is ADAPTER-NEUTRAL and means the same thing wherever the resource is stored.
395
+ *
396
+ * How the deletion happens differs, and you do not choose it:
397
+ * - on MongoDB, a native index expires the rows;
398
+ * - on PostgreSQL there is no equivalent, so a scheduled sweep deletes them in bounded batches.
399
+ *
400
+ * The sweep is registered whichever store is in use, so a resource that declares a lifetime is
401
+ * enforced on both. Do NOT read the MongoDB index as the mechanism and conclude the declaration is
402
+ * inert elsewhere.
403
+ *
404
+ * Two consequences worth knowing before you declare one:
405
+ * - the sweep is deliberately bounded per run, so a table receiving rows faster than they expire
406
+ * stays above its target until the rate changes; it reports when it stops early;
407
+ * - a resource CANNOT declare both a lifetime and retrieval-source fields (`.ragSource()`). That
408
+ * pair is refused at startup, because rows expiring under a native index leave with no
409
+ * application code running, so the derived search chunks could never be removed with them.
410
+ *
411
+ * This is unrelated to `retentionPolicy`, which decides what an ERASURE does to a row that must
412
+ * SURVIVE. This one decides whether the row lives at all.
394
413
  *
395
414
  * @example
396
415
  * createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
@@ -761,6 +780,32 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
761
780
  currentMetadata[ZodDecorator.PORTABILITY_PROVENANCE] = raw;
762
781
  break;
763
782
  }
783
+ case ZodDecorator.DATA_CATEGORIES: {
784
+ // NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A single value (the
785
+ // common case) and an array both store a deduped ARRAY, so every reader sees one shape and
786
+ // `getDataCategories` answers "is this field categorized?" by presence alone.
787
+ //
788
+ // Fail LOUD on an empty declaration. An UNCATEGORIZED field is a legitimate, common state —
789
+ // most fields are not personal data — and the gap report is built on ABSENCE. A stored empty
790
+ // array would read back as declared-with-no-categories, which is invisible to a report
791
+ // looking for absence: the field would be silently excluded from the notice while looking
792
+ // annotated to anyone reading the schema.
793
+ //
794
+ // WHETHER each value is a real `PersonalDataCategory` member is checked by the resource
795
+ // factory's boot guard, which owns the enum — this layer knows only that non-empty strings
796
+ // were declared.
797
+ const raw = p as unknown;
798
+ const authored: readonly unknown[] = Array.isArray(raw) ? raw : [raw];
799
+ if (authored.length === 0 || authored.some((value) => typeof value !== 'string' || value.trim().length === 0)) {
800
+ throw new Error(
801
+ `dataCategories(categories) requires at least one non-empty PersonalDataCategory value (received ${JSON.stringify(raw)}). ` +
802
+ `A field that holds no personal data carries NO declaration — absence is what a category gap report reads. ` +
803
+ `An empty declaration looks annotated and discloses nothing.`,
804
+ );
805
+ }
806
+ currentMetadata[ZodDecorator.DATA_CATEGORIES] = [...new Set(authored as readonly string[])];
807
+ break;
808
+ }
764
809
  case ZodDecorator.IS_AUDIT_EVIDENCE:
765
810
  currentMetadata[ZodDecorator.IS_AUDIT_EVIDENCE] = true;
766
811
  break;
@@ -1012,7 +1057,22 @@ function wrapInstanceMethodsForMetadata(schema: any): void {
1012
1057
 
1013
1058
 
1014
1059
 
1015
- export function addChainableMethods<T extends z.ZodTypeAny>(schema: T): T {
1060
+ /**
1061
+ * Install, per instance, every decorator `ZodDecorator_ApplyableType` admits for this schema.
1062
+ *
1063
+ * `decoratorTypeName` overrides the CONSTRUCTOR NAME the map is consulted with, and exists for
1064
+ * factories whose output is not the Zod type it behaves as. `z_phone()` is the case: it ends in
1065
+ * `.pipe(z.string())`, so its constructor is `ZodPipe` — a name that appears in NO entry of the
1066
+ * map. Every decorator was therefore skipped, and `z_phone()` shipped carrying **zero** of them
1067
+ * while `DecoratedPhoneSchema` declared eight, so `z_phone().isDBIndexed()` type-checked and threw
1068
+ * `TypeError`. Measured 2026-09-17: 0 decorators against 27–36 on every other factory.
1069
+ *
1070
+ * The override is deliberately an explicit ARGUMENT rather than an automatic unwrap of `ZodPipe`.
1071
+ * A pipe's decorator surface is a statement about what the factory built, which only the factory
1072
+ * knows: unwrapping generically would hand the string surface to every pipe in the framework,
1073
+ * including ones whose output is not a string at all.
1074
+ */
1075
+ export function addChainableMethods<T extends z.ZodTypeAny>(schema: T, decoratorTypeName?: string): T {
1016
1076
  const decoratedSchema = schema as DecoratedPrimitiveZodType<T>;
1017
1077
 
1018
1078
  // CRITICAL: Wrap instance methods that return new instances to preserve metadata
@@ -1023,7 +1083,7 @@ export function addChainableMethods<T extends z.ZodTypeAny>(schema: T): T {
1023
1083
  }
1024
1084
  }
1025
1085
 
1026
- const ctorName = (decoratedSchema as any)?.constructor?.name as string | undefined;
1086
+ const ctorName = decoratorTypeName ?? ((decoratedSchema as any)?.constructor?.name as string | undefined);
1027
1087
 
1028
1088
  for (const decorator of Object.values(ZodDecorator)) {
1029
1089
  const applyable = ZodDecorator_ApplyableType[decorator];
@@ -52,11 +52,34 @@ not a singleton.
52
52
 
53
53
  For a singleton, the database itself enforces **at most one row per scope**, so
54
54
  code that reads "the config for this org" can rely on a single row. The
55
- framework keeps that row *present* by seeding a disabled-default at scope
56
- creation (and, for a few auth configs, lazily materialising it on first read),
57
- so a singleton read returns the honest "feature available, switched off" state
58
- rather than a missing-row error. You do not manage that lifecycle — you consume
59
- the guaranteed single row.
55
+ framework keeps that row *present* by seeding a disabled-default (and, for a few
56
+ auth configs, lazily materialising it on first read), so a singleton read returns
57
+ the honest "feature available, switched off" state rather than a missing-row
58
+ error. You do not manage that lifecycle — you consume the guaranteed single row,
59
+ and you do not register those seeds: the framework registers its own.
60
+
61
+ ### When you author your OWN polymorphic singleton, the two scopes need
62
+ ### different triggers — and getting this wrong is invisible
63
+
64
+ If you declare a per-scope singleton of your own, you also own its seed, and the
65
+ ORG and APPLICATION variants are **not symmetric**:
66
+
67
+ | Scope | Trigger | Why |
68
+ |---|---|---|
69
+ | per-organization | `RESOURCE_LIFECYCLE` / `AFTER_CREATE` on `organizations` | Organizations keep being created, so the hook keeps firing and every new tenant gets its row |
70
+ | per-application | `ON_APP_INIT` | There is exactly **one** application row and it is created **once**, at the very first boot |
71
+
72
+ An `AFTER_CREATE` trigger on the application therefore fires once in the lifetime
73
+ of a deployment. It is correct on a brand-new database and **unreachable
74
+ everywhere else** — an application whose row already exists can never receive
75
+ that seed, and nothing reports it. What you see is a settings panel that answers
76
+ "couldn't load details" forever, because a singleton read of a row that does not
77
+ exist is a 404.
78
+
79
+ Use `ON_APP_INIT` with `anchorEntriesToScopeForeignKey: true`, which materialises
80
+ the resolved scope FK onto each entry's **business key** (never onto `data` — the
81
+ FK in both places makes the upsert conflict). A computed `entry({ triggeringRow })`
82
+ is not available to you there and is not needed.
60
83
 
61
84
  ## Recognizing them
62
85
 
@@ -44,6 +44,31 @@ export const TodoSchemaFamily = createSchemaFamily({
44
44
  });
45
45
  ```
46
46
 
47
+ ## Two checks that do NOT fire, and what they cost
48
+
49
+ `createSchemaFamily` validates a great deal at declaration time — a discriminator the base does not
50
+ contain, a value claimed by both the base and a variant, an enum value nothing accounts for. Two
51
+ gaps are worth knowing, because in both the family is legal and the check is simply silent.
52
+
53
+ **Exhaustiveness is only checked when the discriminator is an ENUM.** The validator reads the
54
+ discriminator field's enum values to decide what is unaccounted for; a discriminator declared as a
55
+ plain `z.string()` yields none, so the check returns without asserting anything. A family
56
+ discriminated on a free string is accepted and permanently unchecked — adding a variant later, or
57
+ forgetting one, is caught by nothing.
58
+
59
+ > Declare the discriminator as a named enum, and you get the exhaustiveness check for free. This is
60
+ > the practical reason to prefer one, beyond the vocabulary rule.
61
+
62
+ **At runtime an unrecognized discriminator value resolves to the BASE schema, not an error.** When a
63
+ row's value matches no variant and is not a declared base value, the resolver returns the main
64
+ schema rather than refusing. That deliberately keeps a read of an unexpected row working — but it
65
+ means a value that reached storage outside the declared set is validated, stripped and summarized
66
+ against the base, so variant-only fields on that row are invisible rather than reported.
67
+
68
+ The two compound: a free-string discriminator has no declaration-time check AND a silent runtime
69
+ fallback, so a typo'd variant value can round-trip through the application without anything
70
+ noticing. If the discriminator cannot be an enum, add your own check on the way in.
71
+
47
72
  ## Review Checklist
48
73
 
49
74
  Before finishing a variant-related change, ask:
@@ -8,7 +8,7 @@ Use this file when you already know the field belongs in
8
8
  | Field concern | Typical shared-layer decorators | Notes |
9
9
  |---------------|---------------------------------|-------|
10
10
  | Primary identifier | `.isPrimaryKey()` and often `.isSummaryField()` | Keep the resource identifiable in lists and references. |
11
- | Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` | Common for `organizationId`, `createdByUserId`, and similar fields. |
11
+ | Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` | Common for `organizationId`, `createdByUserId`, and similar fields. Add `.optional()` to `createdByUserId` (and `updatedByUserId`): the engine stamps it from the acting USER, a machine principal (MCP, A2A, client credentials, workers) has none, and the backend reports a required one at startup. |
12
12
  | User-visible summary field | `.isSummaryField()` | Use when the field should appear in list views or FK displays. |
13
13
  | Immutable after creation | `.excludeFromUpdate()` | Use for ownership or one-time setup fields. |
14
14
  | Server-managed field | `.excludeFromCreate()` and often `.excludeFromUpdate()` | Typical for timestamps and values the client must not control. |
@@ -12,9 +12,21 @@ flattened into a plain primitive.
12
12
  | `z_range(type, options?)` | `{ from, to }` | Number/date/time intervals |
13
13
  | `z_duration(options?)` | `{ value, unit }` | Durations that must keep unit meaning |
14
14
  | `z_phone(options?)` | normalized phone string | Phone numbers with dedicated formatting/validation semantics |
15
+ | `z_address(options?)` | `{ line1, line2?, city, state?, postalCode?, country, coordinates? }` | Postal addresses that must be validated, normalized, compared (`isSameAddress`) or carry a geocode |
15
16
  | `z_code(options?)` | `{ content, language }` | Code snippets or editable code payloads |
16
17
  | `z_bigdecimal(options?)` | decimal string | Arbitrary precision numeric values |
17
18
 
19
+ ## Not a factory: `versioned` / `z_foreignKeyVersioned`
20
+
21
+ `@wildo-ai/zod-decorators` also exports `versioned` and `z_foreignKeyVersioned`, and the names
22
+ promise more than they deliver. **Nothing in the framework consumes them** — there is no versioned
23
+ storage, no revision history, no as-of read, and no engine resource declares one.
24
+
25
+ They are schema helpers, not a versioning capability. Do not select one because a requirement asks
26
+ for document versions or an audit history: you would get an ordinary field whose name implies a
27
+ mechanism that does not exist. Model the requirement explicitly instead — a child resource carrying
28
+ the revisions, or a retained row (see `framework-erasure-scrub-treatments-api.md`).
29
+
18
30
  ## Shared-Layer Rule
19
31
 
20
32
  These helpers still belong to the shared schema layer because they define
@@ -27,6 +39,28 @@ budget: z_money()
27
39
  .excludeFromUpdate(),
28
40
  ```
29
41
 
42
+ ## Virus scanning on a `z_file` field
43
+
44
+ `scanPolicy` decides whether an upload is scanned before anyone can download it:
45
+
46
+ | Value | Behaviour |
47
+ |---|---|
48
+ | omitted | Inherit the application default, which is derived from whether a scanner is reachable at all — provisioning the scanner service IS the opt-in, and there is no separate switch. |
49
+ | `'required'` | Always scan this field. If no scanner can run, the upload request still succeeds but the file ends `failed` and is never served. |
50
+ | `'skip'` | Never scan this field, even when the application has a scanner. |
51
+
52
+ A scanned upload moves through `scanning` to `clean`, or to `infected` / `quarantined`, or to
53
+ `failed`. Only `clean` (and the unscanned `uploaded`, `linked`, `orphaned`) are downloadable, so the
54
+ bytes are unreachable while the scan runs and permanently after an infected verdict.
55
+
56
+ Two startup refusals to expect:
57
+
58
+ - a field declaring `scanPolicy: 'required'` while the virus scanner is not configured — set
59
+ `CLAMAV_HOST` (the port has a default), or remove the policy;
60
+ - `YARA_ENABLED` set without `YARA_HOST` — the pattern scanner is enabled and unreachable.
61
+
62
+ A PDF-generated `z_file` cannot carry `scanPolicy`; it is an upload option.
63
+
30
64
  ## Do Not Flatten Them
31
65
 
32
66
  Avoid replacing a domain factory with a plain primitive just because it is
@@ -68,15 +68,17 @@ and reference it from the `views: [...]` map.
68
68
  **Typical:** `./frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`
69
69
 
70
70
  Use the same builder pattern (`resourceUIBehavior`, `sh`, `fieldDisplay`,
71
- etc.) as sibling resources. If unsure, open the file next door and
72
- mirror its top-level shape — module, helpers, `fields`, `views`,
73
- `layout`, `relationshipOverrides` — and only diverge with a reason.
71
+ etc.) as sibling resources. If a sibling exists, mirror its top-level
72
+ shape — module, helpers, `fields`, `views`, `layout`,
73
+ `relationshipOverrides` — and only diverge with a reason. The first
74
+ resource of a new application has no sibling; its surfaces are decided
75
+ from the resource itself (Step 7).
74
76
 
75
77
  ### Step 2: Classify the UI change
76
78
 
77
79
  | Need | Read next |
78
80
  |-------------------------------------|---------------------------------------------------------------------------------|
79
- | Layout / sections | Mirror sibling resource structure |
81
+ | Layout / sections / chrome | Step 7 — decide each surface; `references/surface-decisions.md` |
80
82
  | Operation keys / `ResourceUIBehaviorConfig` / preset map | `references/framework-frontend-resource-ui-contracts-api.md` |
81
83
  | Enum visuals + modes | `references/framework-enum-frontend-handling-api.md` |
82
84
  | Display vs edit mode vocabulary | `references/framework-display-edit-modes-api.md` |
@@ -112,7 +114,10 @@ SEARCH); **custom** operations have **no** default and render a placeholder
112
114
  `lucide-react` component (e.g. `icon: CheckSquare`). Every resource needs one.
113
115
  - **Custom-operation icon** — set `iconOverride` on the operation's entry in
114
116
  `views: [...]`, e.g.
115
- `[MyOps.ARCHIVE, { isAddressable: false, iconOverride: Archive }]`.
117
+ `[MyOps.ARCHIVE, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Archive }]`.
118
+ Import `ResourceOperationFrontendSurface` from `@wildo-ai/saas-models`.
119
+ `EMBEDDED` gives the action an interface without a standalone route; use
120
+ `ADDRESSABLE` for a linkable page or `API_ONLY` for an operation with no UI.
116
121
  - Pass a component **reference** (`iconOverride: Archive`) — never a JSX element
117
122
  (`<Archive />`). `IconLike` is `ComponentType | string`, so a
118
123
  `StandardIconReference` string is also valid, but a `lucide-react` component is
@@ -124,9 +129,28 @@ In development, an unconfigured operation logs a one-time
124
129
  `[IconRegistry] Operation "<resource>:<op>" has no icon …` warning — treat any
125
130
  such warning as a missing `iconOverride`.
126
131
 
127
- ### Step 7: Compose the surface with a layout template (when relevant)
132
+ ### Step 7: Decide each surface, and state the decision (always)
128
133
 
129
- Only when the generated default cannot express what the surface needs. Classify first:
134
+ Every resource decides its **read**, **form**, **summary** and **header** surfaces,
135
+ and its fields' chrome. Each ends as either a template with its reason, or **the
136
+ framework default with its reason**. Both are legitimate. A surface nobody thought
137
+ about is not: without a template the framework lists the schema's fields in
138
+ declaration order, and that order is not an argument about what a reader looks at
139
+ first.
140
+
141
+ State the decision in the JSDoc at the top of the file, one line per surface. With
142
+ no sibling to mirror, derive it from the resource: its identity, its standing (a
143
+ status goes beside the name), which fields are read or written at different times,
144
+ and which related records a reader needs here.
145
+
146
+ **The default is FEWER sections.** A named section earns its place only when its
147
+ fields are read at a different time, by a different reader, as a progression, or
148
+ opened on their own. Never group by field type ("Dates", "Metadata"), and never put
149
+ a heading over one or two fields. Read `references/surface-decisions.md` before
150
+ adding a section: it holds the tests, a chrome table, and a rejected
151
+ over-separated layout beside the accepted one.
152
+
153
+ Once decided, place things:
130
154
 
131
155
  | What you need | Where it goes |
132
156
  |---|---|
@@ -134,7 +158,7 @@ Only when the generated default cannot express what the surface needs. Classify
134
158
  | Field grouping / ordering on the detail or form surface | `layout.display` / `layout.edit` |
135
159
  | The card + FK-popover summary | `layout.summary` |
136
160
  | WHICH related resources appear on the detail surface, in what order | `layout.display`, placing them — see Step 7b |
137
- | Nothing above applies | author no template — the generated one is the correct default |
161
+ | Nothing above applies | author no template, and say in the JSDoc why the default already says it |
138
162
 
139
163
  Do NOT restate a field in two surfaces: a value shown on the header identity line
140
164
  should leave the display strip, or the second copy reads as a different fact.
@@ -205,6 +229,99 @@ edit: { editMode: StringEditMode.MARKDOWN },
205
229
 
206
230
  ## Worked Example
207
231
 
232
+ ### A surface decision, stated
233
+
234
+ This resource's read surface is a timeline and its form is an accordion. The header
235
+ JSDoc says why, and it says why the form has no `history` section:
236
+
237
+
238
+ ## Usage Example
239
+
240
+ ```tsx
241
+ /**
242
+ * Team Goals — resource UI behavior.
243
+ *
244
+ * A department's quarterly objective. It had no authored template, so it rendered through the
245
+ * generated layout; what the generated layout cannot express is that a goal is read and written at
246
+ * two different TIMES, by people asking two different questions.
247
+ *
248
+ * The read surface is a TIMELINE, and that is not decoration: a goal genuinely progresses — it is
249
+ * SET, it then has a standing (`DRAFT → ACTIVE → ACHIEVED | ABANDONED`), and it carries the dates of
250
+ * those transitions. Those three sections are the same fact at three points in its life, which is
251
+ * exactly the shape a timeline renders and a stack of headings flattens.
252
+ *
253
+ * The form is an ACCORDION for the complementary reason: the two halves are used at different times.
254
+ * Writing the goal happens once — a title and up to a thousand characters of description. Re-stating
255
+ * where it stands happens repeatedly, and an accordion lets someone reach the second without
256
+ * scrolling past the first every time.
257
+ */
258
+ ```
259
+
260
+ ## Usage Example
261
+
262
+ ```tsx
263
+ layout: {
264
+ refs: { sections: ['intent', 'standing', 'history'] },
265
+ defaultChromeMode: {
266
+ display: DisplayChromeMode.STACKED,
267
+ summary: DisplayChromeMode.INLINE,
268
+ edit: EditChromeMode.STACKED,
269
+ },
270
+
271
+ /*
272
+ * TIMELINE — the three sections are one goal at three points in its life, so they are
273
+ * rendered as a progression rather than as peers. Sections sharing a container mode are
274
+ * grouped at the first occurrence, which is why all three carry it.
275
+ */
276
+ display: () => (
277
+ <DisplayLayout>
278
+ <Section name="intent" appearance={SectionMode.TIMELINE}>
279
+ <DisplayField name="title" />
280
+ <DisplayField name="description" />
281
+ <DisplayField name="organizationUnitId" />
282
+ </Section>
283
+ <Section name="standing" appearance={SectionMode.TIMELINE}>
284
+ <DisplayField name="status" />
285
+ <DisplayField name="supportingDocuments" />
286
+ </Section>
287
+ <Section name="history" appearance={SectionMode.TIMELINE}>
288
+ <DisplayField name="createdAt" />
289
+ <DisplayField name="updatedAt" />
290
+ </Section>
291
+ </DisplayLayout>
292
+ ),
293
+
294
+ /*
295
+ * ACCORDION — independently collapsible, because the goal's prose is written once and its
296
+ * standing is revisited every week. `history` is absent here: both dates are
297
+ * `excludeFromCreate`/`excludeFromUpdate`, so a form section for them would be a heading
298
+ * over nothing.
299
+ */
300
+ edit: () => (
301
+ <FormLayout>
302
+ <Section name="intent" appearance={SectionMode.ACCORDION}>
303
+ <FormField name="title" />
304
+ <FormField name="description" />
305
+ </Section>
306
+ <Section name="standing" appearance={SectionMode.ACCORDION}>
307
+ <FormField name="organizationUnitId" />
308
+ <FormField name="status" />
309
+ <FormField name="supportingDocuments" />
310
+ </Section>
311
+ </FormLayout>
312
+ ),
313
+ ```
314
+
315
+ - Every section passes a test from `references/surface-decisions.md`: the read
316
+ sections are one goal at three points in its life, and the form sections are
317
+ written at two different times (once, then weekly).
318
+ - The reasoning sits where the next editor reads it first. A section added later
319
+ without such a reason stands out against it.
320
+ - `refs.sections` lists exactly the names the templates use. Each one also owes a
321
+ specification slot.
322
+
323
+ ### An enum badge
324
+
208
325
  The `priority` enum on an application's `todos` resource shows the
209
326
  canonical enum-with-badge pattern: explicit `displayMode`, paired
210
327
  `edit` config, one `BadgeSemanticVariant.*` per value (no hex codes,
@@ -262,14 +379,32 @@ while leaving the core operations to inherit framework defaults:
262
379
  // or it renders the placeholder "missing icon". Pair related actions with
263
380
  // mirrored icons (assign/unassign, recurring/one-time).
264
381
  views: [
265
- // Create is an OVERLAY (the "new" affordance opens a modal; the URL stays on
266
- // the collection). It is intentionally NON-addressable: core CREATE adds no
267
- // URL segment, so an addressable create would resolve to the bare collection
268
- // path `…/todos` and collide with LIST — shadowing the listing on refresh.
382
+ // Create is an OVERLAY: the "new" affordance opens a modal and the URL stays on the
383
+ // collection. A PRODUCT choice — a todo is captured in a second, from the list you are already
384
+ // looking at, and sending that through a page navigation and back costs more than it gives.
385
+ //
386
+ // It is NOT a routing necessity, and the reason recorded here until 2026-09-18 said otherwise:
387
+ // that "core CREATE adds no URL segment, so an addressable create would resolve to the bare
388
+ // collection path and collide with LIST". That is true of the BACKEND, which differentiates
389
+ // LIST from CREATE by HTTP method — and false of the frontend, which has appended an explicit
390
+ // `create` segment for exactly this reason since `2d9d7f28`, the very commit this comment was
391
+ // written in. The application's other addressable creates prove it: `team-goals/create`,
392
+ // `knowledge-documents/create` and `organization-escalation-policies/create` all resolve, and
393
+ // none of them shadows its listing.
394
+ //
395
+ // The consequence of the choice is worth keeping in view: no `/todos/create` route exists, so
396
+ // that URL falls to the sibling `/todos/:todoId` and is caught by `AppRouter`'s
397
+ // reserved-operation-keyword guard, which exists because that capture once render-looped and
398
+ // froze the tab (2026-06-27). Typing it and getting "not a resource id" is the guard working.
269
399
  [Op.CREATE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
270
400
  [Op.READ, {
271
401
  surface: ResourceOperationFrontendSurface.ADDRESSABLE,
272
402
  customView: TodoReadCustomView,
403
+ // Opening a todo from the collection SPLITS: the list stays beside it, so
404
+ // "which one was I comparing this against" survives the click. A todo list is
405
+ // read by scanning and then drilling, repeatedly — the one navigation shape
406
+ // where replacing the collection costs the reader their place every time.
407
+ navigationOverrides: [{ transition: NavigationTransition.SPLIT }],
273
408
  }],
274
409
  [Op.LIST, {
275
410
  surface: ResourceOperationFrontendSurface.ADDRESSABLE,
@@ -280,16 +415,82 @@ while leaving the core operations to inherit framework defaults:
280
415
  collectionDisplayConfig: {
281
416
  selectable: true,
282
417
  cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END },
418
+ // Status is the axis a todo list is READ along — "what is still open?" is
419
+ // the first question. `quickFilterField` promotes it to a tab strip above
420
+ // the toolbar writing the same server-side filter the panel would.
421
+ quickFilterField: 'status',
422
+ /*
423
+ * PRESET PILLS — the additive sibling of the exclusive status tabs above them.
424
+ *
425
+ * Both surfaces write the same server-side filter state, and the split is what each one
426
+ * MEANS: the tabs answer "which slice of this list am I in" and are mutually exclusive;
427
+ * these answer "and narrow it to…", cross fields, and can be on together. Urgency and
428
+ * recency are the two questions a todo list gets asked that its status tabs cannot.
429
+ *
430
+ * `created-today` is declared as a RELATIVE window rather than a pair of dates, because
431
+ * a preset is authored once and clicked forever — an authored pair would be wrong by
432
+ * tomorrow. It resolves against the viewer's own clock at the moment the pill is
433
+ * pressed, and goes off by itself when the day rolls over.
434
+ */
435
+ presetFilters: [
436
+ { ref: 'urgent', filters: { priority: Todos_Priority.URGENT } },
437
+ { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
438
+ { ref: 'touched-this-week', filters: { updatedAt: { relativeRange: CollectionFilterPresetRelativeRange.LAST_7_DAYS } } },
439
+ ],
283
440
  },
284
441
  }],
285
442
  [Op.SEARCH, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
286
443
  [Op.UPDATE, { surface: ResourceOperationFrontendSurface.ADDRESSABLE }],
287
- [Op.DELETE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
288
- [Todos_Operations.CHANGE_STATUS, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: CircleDot }],
289
- [Todos_Operations.ASSIGN, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: UserPlus }],
290
- [Todos_Operations.UNASSIGN, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: UserMinus }],
291
- [Todos_Operations.SET_AS_RECURRING, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Repeat }],
292
- [Todos_Operations.SET_AS_ONE_TIME, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Repeat1 }],
444
+ [Op.DELETE, { surface: ResourceOperationFrontendSurface.EMBEDDED, hasDescription: true }],
445
+ // INLINE: the row itself becomes the form, neighbours still visible. Chosen because status is
446
+ // exactly the axis a person COMPARES across rows — an overlay would cover the very todos that
447
+ // made them act on this one, which is the contract INLINE states. Single scalar enum field, so
448
+ // the row has room for it. On a todo DETAIL page there is no collection above the action and no
449
+ // row to transform, so it degrades to an overlay by design (`resolveActionPresentationTransition`).
450
+ [Todos_Operations.CHANGE_STATUS, {
451
+ surface: ResourceOperationFrontendSurface.EMBEDDED,
452
+ iconOverride: CircleDot,
453
+ actionPresentation: ResourceOperationActionPresentation.INLINE,
454
+ // Explicit ORDER in the bar. Status is the verb reached for most often on a
455
+ // todo, so it leads; assignment follows. Without this the bar orders by
456
+ // registration, which is an artefact of how the config file was written
457
+ // rather than of how the actions are used — and `actionDisclosure` caps the
458
+ // summary bar at three, so ordering decides WHICH three survive.
459
+ displayPriority: 10,
460
+ // Changing status is what a person came to the todo to DO. Every other verb
461
+ // on the bar is incidental to that, so it carries the accent rather than
462
+ // sitting visually level with "unassign".
463
+ actionVariant: ButtonVariants_Variant.ACCENT,
464
+ }],
465
+ // POPOVER: a small panel anchored to the button. This is the enum's own worked idiom —
466
+ // "assign to…" — and the operation fits it exactly: ONE field (`assignedToUserId`) and a SINGLE
467
+ // variant, so the bar can always anchor it. Multi-variant would render a subgroup, which cannot
468
+ // anchor a panel. Where the bar collapses it into the `…` overflow it degrades to an overlay.
469
+ [Todos_Operations.ASSIGN, {
470
+ surface: ResourceOperationFrontendSurface.EMBEDDED,
471
+ iconOverride: UserPlus,
472
+ actionPresentation: ResourceOperationActionPresentation.POPOVER,
473
+ displayPriority: 20,
474
+ }],
475
+ // These three pair off with ASSIGN and with each other: exactly one of
476
+ // ASSIGN/UNASSIGN applies to a todo, and exactly one of
477
+ // SET_AS_RECURRING/SET_AS_ONE_TIME. `WHEN_AVAILABLE` drops the inapplicable
478
+ // one rather than greying it, so the bar offers the verb that can run.
479
+ [Todos_Operations.UNASSIGN, {
480
+ surface: ResourceOperationFrontendSurface.EMBEDDED,
481
+ iconOverride: UserMinus,
482
+ actionVisibility: ActionVisibility.WHEN_AVAILABLE,
483
+ }],
484
+ [Todos_Operations.SET_AS_RECURRING, {
485
+ surface: ResourceOperationFrontendSurface.EMBEDDED,
486
+ iconOverride: Repeat,
487
+ actionVisibility: ActionVisibility.WHEN_AVAILABLE,
488
+ }],
489
+ [Todos_Operations.SET_AS_ONE_TIME, {
490
+ surface: ResourceOperationFrontendSurface.EMBEDDED,
491
+ iconOverride: Repeat1,
492
+ actionVisibility: ActionVisibility.WHEN_AVAILABLE,
493
+ }],
293
494
  ],
294
495
  ```
295
496
 
@@ -310,11 +511,14 @@ while leaving the core operations to inherit framework defaults:
310
511
  - `references/framework-primitive-ui-api.md` — source-backed primitive UI base
311
512
  - `references/framework-per-primitive-ui-api.md` — source-backed per-type UI
312
513
  - `references/framework-foreign-key-ui-api.md` — source-backed FK reference display & picker row modes (`LABEL` / `SUMMARY`)
514
+ - `references/surface-decisions.md` — deciding each surface without a sibling to mirror, when a section earns its place, the chrome decision table, and a rejected over-separated layout beside the accepted one
313
515
  - `references/framework-resource-layout-templates-api.md` — source-backed `layout.{edit,display,summary,header}`, the `layout.refs` manifest, and `<ResourceHeaderTitle />`
314
516
  - `references/framework-related-resource-embeds-api.md` — source-backed `RelatedResourceSections`, the `EmbedRelated*` family, `viaForeignKey` edge disambiguation, preview, and descent bounding
315
517
 
316
518
  ## Verification
317
519
 
520
+ - [ ] The file opens with a JSDoc stating the decision for each surface (read, form, summary, header): the template's reason, or why the default is right
521
+ - [ ] Every named `<Section>` passes a test in `references/surface-decisions.md` (different time, different reader, a progression, or independent use), and none groups fields by type
318
522
  - [ ] No structural decorators added; the schema file is unchanged unless the change was coordinated through `resource-schema-authoring`
319
523
  - [ ] Every enum field has explicit `display.displayMode` AND a `values: { ... }` map (no silent default rendering)
320
524
  - [ ] Per-value enum chrome uses framework enums (`BadgeSemanticVariant`, etc.) — no hex codes or Tailwind classes
@@ -339,6 +543,14 @@ Run from the app root and substitute the resource path:
339
543
  | Every UI field exists in the schema | `comm -23 <(rg -oN "^\s*(\w+):\s*sh\." frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u) <(rg -oN "^\s*(\w+):\s*z\." shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u)` |
340
544
  | No `isForeignKey` / `isDBIndexed` / `excludeFrom*` accidentally added here | `rg -n "isForeignKey\|isDBIndexed\|excludeFrom" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
341
545
 
546
+ Surface-decision invariants:
547
+
548
+ | Invariant | Command |
549
+ |---|---|
550
+ | The file opens with a decision JSDoc (first line is `/**`) | `head -1 frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
551
+ | Named sections, to check each against the tests (list them; each needs a stated reason) | `rg -n "<Section[^>]*name=" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
552
+ | No section named after a field type (should be empty) | `rg -n "<Section[^>]*name=\"(dates\|metadata\|details\|info\|other)\"" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
553
+
342
554
  Related-resource placement invariants:
343
555
 
344
556
  | Invariant | Command |
@@ -355,6 +567,9 @@ Icon invariants (same resource-path substitution):
355
567
 
356
568
  | Rationalization | Reality |
357
569
  |--------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
570
+ | "The generated default expresses everything; no template needed" | Maybe, but only if you can say why. A default nobody decided is the order the schema was typed in. State it in the JSDoc, or author the template. |
571
+ | "More sections make it more organized" | A heading over one or two fields is a box, not structure. The default is fewer sections; each one must pass a test and costs three places. |
572
+ | "I'll mirror the sibling resource's layout" | The first resource of a new application has no sibling. Derive the surface from this resource's identity, standing and timing. |
358
573
  | "Default enum rendering is fine" | The framework requires explicit UI choices for enums in Wildo apps; an unconfigured enum is a UX defect, not a graceful fallback. |
359
574
  | "I'll just use a hex code / Tailwind class for this badge color" | Per-value chrome must come from `BadgeSemanticVariant` (or the matching framework enum); raw colors break theming and dark mode. |
360
575
  | "I'll copy the layout from another module without checking operations" | Operation ids referenced under `views: [...]` must exist in **this** resource's `*.resources-config.ts`; copy-paste silently breaks routing. |
@@ -365,6 +580,8 @@ Icon invariants (same resource-path substitution):
365
580
 
366
581
  ## Red Flags
367
582
 
583
+ - The file has no decision JSDoc at the top, so its surfaces are defaults nobody chose (catch with the "decision JSDoc" check above)
584
+ - A section is named after a field type, or holds one or two fields with no stated reason (catch with the "section named after a field type" grep above)
368
585
  - UI references a field absent from the schema (catch with the "every UI field exists in schema" grep above)
369
586
  - An enum field has no explicit `displayMode` or no `values: { ... }` map (silent default rendering)
370
587
  - Per-value chrome uses a hex code or `className: 'bg-...'` instead of `BadgeSemanticVariant.*` (catch with the "no raw color strings" / "no Tailwind class smuggling" greps)
@@ -387,3 +604,4 @@ Icon invariants (same resource-path substitution):
387
604
  - `spec-update-after-change` — companion-facing semantics
388
605
  - `i18n-rerun-pipeline` — translation and label workflow
389
606
  - `views-add-custom-view` — when default view chrome is not enough
607
+ - `frontend-component-catalog` — which framework component renders what, and its props, when a surface needs an element beyond the field chrome