@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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: resource-add-module
3
- description: Scaffold a new application module slice (folders + index files + module-registration objects) across `shared-lib`, `app`, `specifications`, and (when applicable) `backend-api`, then declare it in `wildo.saas.config.ts > modules` with the explicit `services: [...]` array. Use when the user says "add a new module", "create a `<name>` module", "scaffold a bounded context", "wire a new domain area", "add a new feature slice", or "split this domain into its own module" — NOT when adding a single resource inside an existing module.
3
+ description: Scaffold a new application module slice (folders + index files + module-registration objects) across `shared-lib`, `frontend`, `specifications`, and (when applicable) `backend-api`, then declare it in `wildo.saas.config.ts > modules` with the explicit `services: [...]` array. Use when the user says "add a new module", "create a `<name>` module", "scaffold a bounded context", "wire a new domain area", "add a new feature slice", or "split this domain into its own module" — NOT when adding a single resource inside an existing module.
4
4
  ---
5
5
 
6
6
  # Resource Add Module — Scaffold Workflow
@@ -17,306 +17,157 @@ Read and apply these patterns from the application-developer point of view:
17
17
  - how the application should avoid mixing frontend, backend, and infrastructure concerns
18
18
 
19
19
 
20
- > **Framework rule.** A module is the **unit of cross-runtime
21
- > ownership** in Wildo. A single module folder appears in **up to 4
22
- > sibling trees** (`shared-lib/src/modules/<m>/`,
23
- > `frontend/src/modules/<m>/`, `specifications/src/modules/<m>/`,
24
- > `backend-api/src/modules/<m>/`) and is declared **once** in
25
- > `wildo.saas.config.ts > modules` with an explicit
26
- > `services: ['backendApi', 'app', …]` array that gates which
27
- > runtimes load it. Each per-runtime tree exports a typed
28
- > registration object (`SharedSaaSModule` /
29
- > `BackendOwnedModule` / `ModuleBusinessSemantics`) that the engine
30
- > wires automatically — the consumer authors the slice; the engine
31
- > owns the wiring contract.
32
-
33
20
  ## Overview
34
21
 
35
- This skill creates a **new module slice**: parallel folders, typed
36
- registration objects, and the single `wildo.saas.config.ts > modules`
37
- entry that gates them. It deliberately mirrors a chosen reference
38
- module's topology rather than inventing a one-off layout — every
39
- tool and skill that walks the module tree assumes each module
40
- shares the same per-runtime shape.
41
-
42
- A module declared in `wildo.saas.config.ts > modules` but missing
43
- from a per-runtime tree it lists in `services: [...]` is a build
44
- break (the runtime fails to find its `BackendDomainModule` /
45
- `SharedSaaSModule` registration). Conversely, a per-runtime folder
46
- that isn't declared in `modules` is dead code (the engine never
47
- loads it).
48
-
49
- ## App Paths
50
-
51
- The installed `@wildo-ai/*` packages provide the framework contracts. Module
52
- scaffolding touches the consumer app at:
22
+ Create a module that owns a coherent business area across the application's packages.
23
+ The SaaS configuration declares its service bindings; source registries supply its actual
24
+ contributions. Both are required. A folder or a config entry alone does not complete registration.
53
25
 
54
- | Surface | Glob (relative to app root) | Required for |
55
- |---|---|---|
56
- | Saas-config root | `wildo.saas.config.ts` | every module (single source of truth for which runtimes load the module) |
57
- | Shared-lib slice | `shared-lib/src/modules/<module>/index.ts` (`SharedSaaSModule`) | every module (resources, relationships, milestones) |
58
- | Shared-lib resources sub-tree | `shared-lib/src/modules/<module>/resources/**` | every module that owns resources (the dominant case) |
59
- | App slice | `frontend/src/modules/<module>/index.ts` (+ `resources/`, `app-level-views/`) | every module the `app` runtime loads |
60
- | App UI behavior | `frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx` | every resource the `app` runtime renders |
61
- | Specifications slice | `specifications/src/modules/<module>/index.ts` (`ModuleBusinessSemantics`) + `resources/`, `composite-views/`, `milestones/` | every module that has spec coverage (typical) |
62
- | Backend slice | `backend-api/src/modules/<module>/index.ts` (`BackendOwnedModule`) + `resources/`, `addons/`, `emails/` (i18n is engine-owned — no per-module `i18n/` directory) | every module the `backendApi` runtime loads |
26
+ Prefer the installed `add-module` composition scenario for the standard cross-package shape.
27
+ It creates shared, specifications, backend and frontend slices, updates the static registries,
28
+ and binds the module to `backendApi` and `app`. Resources are added afterwards.
29
+ For a different service topology or existing files, follow the manual workflow below together
30
+ with the canonical `module-registration` skill.
63
31
 
64
32
  ## When to Use
65
33
 
66
- - **Adding a new bounded context** to an app (e.g. user says "add a
67
- `billing` module", "create a `notifications` module",
68
- "scaffold a new domain for support tickets").
69
- - **Cloning the topology** of an existing module to host a new
70
- feature slice that needs its own resources / specs / backend
71
- surface.
72
- - **Splitting an oversized module** in two — both halves go through
73
- this skill; deletion of the old module is a separate concern.
74
- - The user explicitly mentions any of: `wildo.saas.config.ts >
75
- modules`, `SharedSaaSModule`, `BackendOwnedModule`,
76
- `ModuleBusinessSemantics`, "module registration", "new domain
77
- area", or "new feature slice".
34
+ - Create a new bounded context, feature slice or business module.
35
+ - Split an existing module while preserving each contribution's ownership and registrations.
78
36
 
79
37
  ## When NOT to Use
80
38
 
81
- - **Adding a single resource inside an existing module** — use
82
- `resource-add-resource`. A resource lives under a module's
83
- `resources/` tree, never as a sibling of `modules/`.
84
- - **Changing only SaaS-wide service lists** (`services` map at the
85
- saas-config root) without a new module — use `config-saas`.
86
- - **Module-registration mechanics** for a module that already exists
87
- (rename, move between modules, fix the `services: [...]` array) —
88
- use `module-registration` directly.
89
- - **Companion-export wiring** for an already-scaffolded module — use
90
- `module-companion-exports`.
91
- - **Engine or platform work** — out of scope for app skills; the
92
- engine packages (`@wildo-ai/saas-models`,
93
- `@wildo-ai/saas-backend-lib`, `@wildo-ai/saas-specifications`,
94
- `@wildo-ai/platform-config-lib`) own the schemas this skill
95
- writes against.
39
+ - Add a resource to an existing module: use `resource-add-resource`.
40
+ - Repair or move an existing registration: use `module-registration`.
41
+ - Change global services or providers: use `config-saas`.
42
+ - Edit the framework itself: this skill addresses an application checkout.
96
43
 
97
- ## Workflow
98
-
99
- ### Step 1: Pick a reference module
44
+ ## App Paths
100
45
 
101
- Find the most structurally similar existing module in this app
102
- (`<reference_module>`). The choice drives every subsequent step —
103
- copy its **folder topology + registration shape**, not its
104
- business content. Use the `## App Paths` table above to enumerate
105
- which trees the reference module actually populates; the new
106
- module copies exactly that subset.
46
+ | Surface | Application path | Contract |
47
+ |---|---|---|
48
+ | SaaS declaration | `wildo.saas.config.ts` | Module key and explicit `services`; the standard scenario edits the exported `applicationModules` map consumed by the configuration |
49
+ | Shared contribution | `shared-lib/src/modules/<module>/index.ts` | Default `SharedSaaSModule` export |
50
+ | Shared registration | `shared-lib/src/modules-registry.shared.ts` | Imported identifier in `applicationSharedModules` |
51
+ | Frontend contribution | `frontend/src/modules/<module>/index.ts` | Default `FrontendModule` export |
52
+ | Frontend registration | `frontend/src/modules/index.ts` | Imported identifier in `applicationFrontendModules`; consumed by `modules-registry.frontend.ts` |
53
+ | Specifications | `specifications/src/modules/<module>/index.ts` | Named `<moduleCamel>ModuleBusinessSemantics` export, with `relatedModuleId` |
54
+ | Specifications registration | `specifications/src/module-registry.specification.ts` | Named import in `applicationModuleBusinessSemantics` |
55
+ | Backend contribution | `backend-api/src/modules/<module>/index.ts` | Default application-local `BackendOwnedModule` export |
56
+ | Backend discovery | `backend-api/src/modules/index.ts` | `scanSubdirDefaultExports` discovers emitted immediate-child index files and merges their backend contributions |
107
57
 
108
- If the app has no existing modules, start from the application module template
109
- and the source-backed module references (see
110
- `## Worked Example` below).
58
+ ## Workflow
111
59
 
112
- ### Step 2: Decide the runtime gates
60
+ ### Step 1: Discover the standard scaffold
113
61
 
114
- Open `wildo.saas.config.ts > modules` and decide which services
115
- the new module loads in. The default is `['backendApi', 'app']`
116
- for a domain module that has both server-side operations and a
117
- frontend. A docs-only module might use `['app']`; a
118
- worker-only module might use `['backendApi']`. The `services`
119
- array is the **single switch** that opts a runtime into loading
120
- the module — no other wiring gates it.
62
+ Run `wildo compose` in the application to list its installed scenarios. Read
63
+ `references/framework-composition-scenarios-api.md` for complete module and resource invocations.
64
+ Use this application's actual shared package name, module identifiers and business semantics.
65
+ Preview with `--dry-run`, inspect every write and edit, then apply. A later invocation computes
66
+ a fresh plan. The scenario is a scaffold, not a migration or a transaction.
121
67
 
122
- ### Step 3: Create parallel folders
68
+ ### Step 2: Choose the service topology
123
69
 
124
- Mirror the reference module's tree in each runtime the new
125
- `services: [...]` array names, plus `specifications/src/modules/`
126
- if the app uses spec coverage. Apply the per-surface convention
127
- from `## App Paths`. Do NOT create folders for runtimes the new
128
- module is NOT declared for (dead code).
70
+ For manual creation, inspect a comparable module and the application's actual loaders.
71
+ Choose the services that need the contribution. `backendApi` plus `app` is the standard
72
+ full module; a frontend-only contribution does not need a fabricated backend or shared owner.
73
+ A worker is a separate service binding, not another name for `backendApi`.
129
74
 
130
- Run `references/module-scaffold-layout.md` for the package-level
131
- checklist if you are unsure which sub-folders the reference
132
- module ships.
75
+ The `services` declaration supplies bootstrap topology. It does not replace the static
76
+ shared/frontend/specification registrations or backend discovery described above.
133
77
 
134
- ### Step 4: Author the typed registration objects
78
+ ### Step 3: Author the per-layer contributions
135
79
 
136
- For each per-runtime slice, author the index file that exports
137
- the typed registration object (the engine reads these by name —
138
- the symbol is implicit, the type is explicit):
80
+ Mirror the required shapes, not another module's business content. Keep the module folder,
81
+ SaaS configuration key, contribution `moduleId` and semantics `relatedModuleId` aligned.
139
82
 
140
- | Tree | Type imported from | Object shape |
141
- |---|---|---|
142
- | `shared-lib/src/modules/<m>/index.ts` | `@wildo-ai/saas-models` | `SharedSaaSModule` (`moduleId`, `kind`, `resourceConfigurations`, `resourceFieldIdentifiers`, `resourceRelationships`, optional `customMilestoneDefinitions`) |
143
- | `backend-api/src/modules/<m>/index.ts` | `@wildo-ai/saas-backend-lib` (+ app-local `BackendOwnedModule`) | `BackendOwnedModule` (`moduleId`, `kind`, `backendModule` extending the shared module with `flowsActors`, `emailTemplateDefinitions`). `customLabels` is engine-owned (single owner via `scanCustomLabelsDirectory`) — do NOT set it on domain modules. |
144
- | `specifications/src/modules/<m>/index.ts` | `@wildo-ai/saas-specifications` | `ModuleBusinessSemantics` (`relatedModuleId`, `purpose`, `businessCapability`, `businessDomain`, `primaryActors`, `mainResources`, `supportingResources`, `integrationSurfaces`) |
145
- | `frontend/src/modules/<m>/index.ts` | (consumer-side; mirrors the reference module) | App entry that re-exports `resources/` + `app-level-views/` |
146
-
147
- The `moduleId` value MUST equal the folder name AND the key used
148
- in `wildo.saas.config.ts > modules` — three-way string equality.
149
-
150
- ### Step 5: Declare the module in `wildo.saas.config.ts`
151
-
152
- Add the entry to the `modules` map of `defineSaasConfig({...})`:
153
-
154
- <!-- TIER C WAIVER: 7-non-blank-line `ts` block showing the exact saas-config `modules` map insertion shape required by `ApplicationModulesSchema`. This inline block is the consumer-facing template with `<new_module>` placeholder + the explicit `services` / `haveSamlIntegration` keys the schema requires. Keep it as Tier C until a focused, stable application example is deliberately anchored. -->
155
- ```ts
156
- modules: {
157
- '<new_module>': {
158
- services: ['backendApi', 'app'],
159
- haveSamlIntegration: false,
160
- },
161
- // existing modules unchanged
162
- },
163
- ```
83
+ - Shared: author the `SharedSaaSModule`, resource configurations, field identifiers and relationships.
84
+ - Frontend: author a `FrontendModule` containing resource UI behavior, composite views and the
85
+ intended app-shell contribution. Re-exporting a resources barrel is not a frontend registration.
86
+ - Backend: author the application-local `BackendOwnedModule` and its `backendModule` contribution.
87
+ Follow existing addon wiring for actors and email templates. Labels are engine-owned;
88
+ do not add a per-module `customLabels` owner or `i18n/` directory.
89
+ - Specifications: export the named `ModuleBusinessSemantics` value and the applicable resource/view
90
+ specification maps. This slice does not require a default export.
164
91
 
165
- The string key MUST match `moduleId` in every per-runtime
166
- registration object from Step 4.
92
+ Read `references/framework-new-module-wiring-api.md` for the source-backed contracts and
93
+ `references/module-scaffold-layout.md` for the layout checklist.
167
94
 
168
- ### Step 6: Smoke-check imports + registration
95
+ ### Step 4: Register the contributions and declare the binding
169
96
 
170
- Boot each affected runtime once. The engine loads the per-runtime
171
- registration objects by walking `wildo.saas.config.ts > modules`
172
- and resolving each entry via the conventional path
173
- (`<runtime>/src/modules/<moduleId>/index.ts`). A missing
174
- registration export (or a `moduleId` mismatch) throws at boot
175
- with the failing path in the message.
97
+ Follow `module-registration` for loader details. For the standard scaffold:
176
98
 
177
- Add a trivial export from the new module (e.g. an enum or
178
- type-only export) and import it from the app bootstrap path used
179
- by sibling modules — the loud-failure boot prevents silent
180
- mis-registration.
99
+ 1. Import the shared default export into `shared-lib/src/modules-registry.shared.ts` and append
100
+ its identifier to `applicationSharedModules`. Expose the module through the shared package's
101
+ existing public entrypoint.
102
+ 2. Import the named semantics export into `specifications/src/module-registry.specification.ts`
103
+ and append it to `applicationModuleBusinessSemantics`. Update the specifications public entrypoint.
104
+ 3. For a frontend contribution, import its default export into `frontend/src/modules/index.ts`
105
+ and append it to `applicationFrontendModules`. Keep the array static; an import alone is insufficient.
106
+ 4. For a backend contribution, supply the default `BackendOwnedModule` in its module index.
107
+ Do not add an import to the backend scanner. Ensure the compiler publishes the emitted index:
108
+ a source folder alone is not a discoverable runtime module.
109
+ 5. Add the module key and intended `services` to the SaaS configuration's module map. In the standard
110
+ scaffold this is the exported `applicationModules` object. Missing configuration can leave the
111
+ module absent from bootstrap/provider-runtime descriptors despite source registration.
181
112
 
182
- ### Step 7: Smoke-check the audit invariants
113
+ ### Step 5: Verify the loaded result
183
114
 
184
- Run the grep invariants in `## Verification` below. Each one is
185
- designed to catch a specific drift the engine doesn't catch at
186
- boot (e.g. shared-lib slice present but missing from `services:
187
- [...]`, leaving the module loaded by the bundler but never
188
- exercised by any runtime).
115
+ Check each intended runtime independently after its compiler has published the new files.
116
+ Inspect the actual registry for the module and exercise a contribution once one exists.
117
+ A missing registration can hide a contribution or fail startup; do not assume every mismatch
118
+ produces a particular boot error. Static membership and a successful typecheck do not prove
119
+ that a running process has loaded the latest module.
189
120
 
190
121
  ## Worked Example
191
122
 
192
- An application can ship several declared modules. A representative cross-runtime
193
- domain module demonstrates the same relationship, while
194
- `example-dev` demonstrates an app-only contribution with no fabricated
195
- shared/backend owners.
196
-
197
- | Step | Source-backed reference | File |
198
- |---|---|---|
199
- | Saas-config entry | Root SaaS composition contract | `wildo.saas.config.ts` (`modules` declares the runtime service bindings for each module) |
200
- | Shared-lib registration | `example.module.registration.shared` | `shared-lib/src/modules/tasks-manager/index.ts` (full `SharedSaaSModule` value) |
201
- | Backend-api registration | `example.backend.addon-wiring.module` | `backend-api/src/modules/tasks-manager/index.ts` (full `BackendOwnedModule` value, illustrates how `flowsActors` / `emailTemplateDefinitions` compose onto the shared `BackendDomainModule`; note `customLabels` is intentionally absent — engine-owned via `scanCustomLabelsDirectory`) |
202
- | Specifications semantics | (none — read directly) | `specifications/src/modules/tasks-manager/index.ts` (`tasksManagerModuleBusinessSemantics` value) |
123
+ For a standard customer-support module, use the complete command in
124
+ `references/framework-composition-scenarios-api.md`. It creates an empty module with coherent
125
+ registration, then the resource command adds support tickets to its shared and specification layers.
126
+ Add business-specific operations and UI behavior through their own authoring workflows.
203
127
 
204
- Promote any of these to a Tier A `example.module.*`
205
- anchor when you need to inline the snippet inside this skill.
128
+ ## Verification
206
129
 
207
- ## References
130
+ - [ ] Folder, configuration key, `moduleId` and `relatedModuleId` agree.
131
+ - [ ] Each intended service has the required contribution; no unrelated service is invented.
132
+ - [ ] Shared and frontend defaults are imported into their static arrays where applicable.
133
+ - [ ] Named specifications semantics are included in `applicationModuleBusinessSemantics`.
134
+ - [ ] Backend discovery sees the emitted default owner and its expected backend contribution.
135
+ - [ ] The SaaS configuration contains the module binding, separate from source registration.
136
+ - [ ] Public entrypoints expose the intended shared and specification declarations.
137
+ - [ ] Package checks pass and the relevant running application surface uses the contribution.
138
+
139
+ Locate the standard registration anchors from the application root:
140
+
141
+ ```bash
142
+ rg -n 'applicationSharedModules' shared-lib/src/modules-registry.shared.ts
143
+ rg -n 'applicationFrontendModules' frontend/src/modules/index.ts
144
+ rg -n 'applicationModuleBusinessSemantics' specifications/src/module-registry.specification.ts
145
+ rg -n 'scanSubdirDefaultExports' backend-api/src/modules/index.ts
146
+ rg -n 'applicationModules|services' wildo.saas.config.ts
147
+ ```
208
148
 
209
- - `references/module-scaffold-layout.md` — package-level
210
- expectations and the per-surface checklist.
211
- - `references/framework-new-module-wiring-api.md` —
212
- `ApplicationModulesSchema` (saas-config side) +
213
- `SharedSaaSModule` (shared-lib side) anchored API surface
214
- delivered by the declared package contracts.
215
- - `module-registration` skill —
216
- `references/framework-domain-modules-api.md` for the full
217
- cross-runtime module contracts (use when editing an existing
218
- registration object, not when scaffolding from scratch).
149
+ These searches locate owners; inspect list membership and runtime output rather than treating
150
+ matching text as proof of successful loading. For a custom topology, follow its actual owner paths.
219
151
 
220
- ## Verification
152
+ ## Red Flags
221
153
 
222
- - [ ] **Three-way string equality.** Folder name = `moduleId`
223
- in every registration object = key in
224
- `wildo.saas.config.ts > modules`.
225
- - [ ] **Runtime gating is explicit.** `services: [...]` is
226
- authored deliberately (not omitted to "default to all"); it
227
- lists exactly the runtimes that have a per-runtime slice.
228
- - [ ] **No orphan slices.** Every per-runtime
229
- `<runtime>/src/modules/<moduleId>/index.ts` corresponds to
230
- a runtime listed in `services: [...]`. Conversely, every
231
- runtime in `services: [...]` has a corresponding
232
- `index.ts`.
233
- - [ ] **Typed registration object exported by default.** Each
234
- per-runtime `index.ts` has `export default <module>` (the
235
- engine resolves the registration via the default export).
236
- - [ ] **Reference module's topology preserved.** Every
237
- sub-folder the reference module ships (e.g. `addons/`,
238
- `i18n/`, `emails/`) is either present in the new module or
239
- consciously omitted with reason (don't ship empty
240
- sub-folders that mislead future readers).
241
- - [ ] **No circular imports** at first resource addition (the
242
- `<module>/resources/index.ts` re-export chain is
243
- acyclic).
244
- - [ ] **Specifications path exists** if the app uses spec
245
- coverage — `specifications/src/modules/<m>/index.ts`
246
- exports a `ModuleBusinessSemantics` value.
247
- - [ ] **Boot smoke-test passes.** Each runtime in `services:
248
- [...]` boots without "module not found" / "moduleId
249
- mismatch" errors.
250
-
251
- ### Grep invariants
252
-
253
- | Invariant | Command |
254
- |---|---|
255
- | Module declared in saas-config | `rg -n "^\\s*'<module>'\\s*:" wildo.saas.config.ts` (must return ≥1 inside the `modules` map) |
256
- | Default export per runtime | `rg -n "^export default " <runtime>/src/modules/<module>/index.ts` (must return exactly 1 per runtime in `services: [...]`) |
257
- | `moduleId` matches folder | `rg -n "moduleId:\\s*'<module>'" {shared-lib,backend-api,app}/src/modules/<module>/index.ts` (must return ≥1 per runtime in `services: [...]` that uses the field) |
258
- | Specs `relatedModuleId` matches | `rg -n "relatedModuleId:\\s*'<module>'" specifications/src/modules/<module>/index.ts` (must return ≥1 if the spec slice exists) |
259
- | No orphan per-runtime slice | `ls -d {shared-lib,backend-api,app,specifications}/src/modules/<module>/ 2>/dev/null` cross-checked against the `services: [...]` array (each listed runtime must appear; specifications is conventionally always present if the app uses specs) |
260
-
261
- ## Common Rationalizations
262
-
263
- | Rationalization | Reality |
264
- |---|---|
265
- | "I'll register the module later, after I get the resource shape right." | Unregistered modules are invisible — every dependency the resource graph adds (relationships, labels, milestones, backend addons) is silently dropped by the engine until registration lands. Register first; iterate the resource shape inside a registered module. |
266
- | "Shared-lib alone is enough — I can wire the app and backend later." | App-side resources (`ui-behavior.tsx`, custom views) and backend-side ops (`flowsActors`, `emailTemplateDefinitions`) live in their own per-runtime trees. Skipping them now means the resource technically exists but renders nothing in the app and serves no operations on the backend. Add the parallel folders even if their `index.ts` re-exports an empty barrel — it makes the omission deliberate. |
267
- | "I'll skip the `services: [...]` array and let the framework default to all." | The schema requires it; `defineSaasConfig` rejects the saas-config at parse time. The array is the **single switch** that gates which runtimes load the module — there's no implicit default that makes architectural sense. |
268
- | "I'll re-use the reference module's `moduleId` constant by importing it." | `moduleId` is a string literal that MUST equal the folder name AND the saas-config key — three-way string equality. Importing a constant breaks the symmetry and hides the literal from the grep invariants above. Author the literal three times; the loud-failure boot catches mismatches immediately. |
269
- | "I'll author the spec-side `ModuleBusinessSemantics` later — the engine doesn't need it to boot." | True for boot, false for the audit. The spec-side value is the source of truth for `purpose` / `businessCapability` / `primaryActors` consumed by every downstream skill that reads spec semantics (resource specs reference module semantics for cross-resource reasoning). Skipping it leaves the module structurally valid but semantically opaque. |
270
- | "I'll put the new module's resources directly under `shared-lib/src/modules/` (no `<module>/` parent)." | The engine resolves modules by walking `<runtime>/src/modules/<moduleId>/`. A flat layout breaks resolution for every runtime — the loud-failure boot will tell you which one first, but all of them break. |
154
+ - A new slice exists but is absent from the required static registry or SaaS declaration.
155
+ - Specifications are expected to default-export semantics instead of using the named import.
156
+ - The backend scanner is edited to add a manual module list.
157
+ - A running process is checked before the new emitted module has been published.
158
+ - Empty copied folders, stale exports or a duplicated label owner remain from the reference module.
271
159
 
272
- ## Red Flags
160
+ ## References
273
161
 
274
- 1. **A new folder appears under any `src/modules/` tree but
275
- `wildo.saas.config.ts > modules` is unchanged** — module is
276
- dead code; maps to Verification: "**Three-way string
277
- equality**" + boot smoke-test.
278
- 2. **`services: ['backendApi']` declared but no
279
- `backend-api/src/modules/<m>/index.ts` exists** (or vice
280
- versa) — runtime fails to load at boot; maps to Verification:
281
- "**No orphan slices**".
282
- 3. **Per-runtime `index.ts` lacks a default export** — engine
283
- throws "registration object not found"; maps to Verification:
284
- "**Typed registration object exported by default**" + grep
285
- invariant "Default export per runtime".
286
- 4. **Sub-folders copied wholesale from the reference module
287
- without populating them** (e.g. an empty `emails/` directory
288
- that never ships any template) — misleads future readers and
289
- leaves dangling barrel exports nobody can resolve;
290
- maps to Verification: "**Reference module's topology
291
- preserved**" with conscious omission.
292
- 5. **Spec-side `ModuleBusinessSemantics.relatedModuleId`
293
- doesn't match the folder name** — silent semantic drift; the
294
- engine doesn't catch it (no boot-time validation), but
295
- downstream skills consuming spec semantics will load
296
- semantics for the wrong module; maps to grep invariant
297
- "Specs `relatedModuleId` matches".
298
- 6. **A second module is added in the same change-set without
299
- running the workflow per-module** — the per-module
300
- verification invariants don't compose; running them once
301
- against "both modules" passes silently while one of the two
302
- is half-wired. Apply the workflow per-module.
162
+ - `references/framework-composition-scenarios-api.md` — complete commands, preview and collision behavior.
163
+ - `references/module-scaffold-layout.md` — package layout and explicit registration checklist.
164
+ - `references/framework-new-module-wiring-api.md` — source-backed SaaS and shared module contracts.
303
165
 
304
166
  ## Related Skills
305
167
 
306
- - `resource-add-resource` — add a single resource inside this
307
- (or any existing) module's `resources/` tree.
308
- - `module-registration` — edit registration objects after
309
- scaffolding (rename, change `services: [...]`, move between
310
- apps).
311
- - `module-companion-exports` — wire the per-runtime barrel
312
- exports (`./resources`, `./addons`, `./emails`, `./i18n`)
313
- the engine and the audit expect.
314
- - `config-saas` — change the saas-config-root surfaces
315
- (`services` map, `engineCapabilities`, `providers`, `dataServices`)
316
- that this skill leaves untouched.
317
- - `backend-addon-wiring` — once the backend slice exists, wire
318
- `flowsActors` / `emailTemplateDefinitions` via the addon
319
- convention (i18n is engine-owned; do not add `customLabels`).
320
- - `i18n-label-generation` — engine-owned per-unit labels that
321
- the spec slice's `mainResources` reference (single owner via
322
- `scanCustomLabelsDirectory`).
168
+ - `module-registration` — canonical per-layer loader and registration workflow.
169
+ - `resource-add-resource` — resources inside an existing module.
170
+ - `module-companion-exports` — companion-visible contributions.
171
+ - `config-saas` — service/module bindings and global configuration.
172
+ - `backend-addon-wiring` — actors and email contributions.
173
+ - `i18n-label-generation` — engine-owned labels.
@@ -0,0 +1,133 @@
1
+ # Framework Composition Scenarios API
2
+
3
+ `wildo compose <scenario>` — the one-command form for growing a slice this application does not yet
4
+ have. It writes the same layers this skill's manual workflow describes, in one call.
5
+
6
+ ```bash
7
+ wildo compose
8
+ wildo compose add-module --dry-run \
9
+ --var moduleId=customer-support --var moduleCamel=customerSupport \
10
+ --var modulePascal=CustomerSupport \
11
+ --var purpose="Organize customer requests and their resolution" \
12
+ --var businessCapability="Resolve customer requests" \
13
+ --var businessDomain=customer-service --var sharedLibPackage=@service-desk/shared-lib
14
+ wildo compose add-resource --dry-run \
15
+ --var moduleId=customer-support --var modulePascal=CustomerSupport \
16
+ --var resourceDir=support-tickets --var resourceCamel=supportTickets \
17
+ --var resourcePascal=SupportTickets --var resourceTypeMember=SUPPORT_TICKETS \
18
+ --var resourceIdField=supportTicketId --var primaryScope=organizations \
19
+ --var purpose="A customer request awaiting resolution" \
20
+ --var sharedLibPackage=@service-desk/shared-lib
21
+ ```
22
+
23
+ These examples use an application whose shared package is `@service-desk/shared-lib`.
24
+ Replace that value with this application's actual package name. Inspect the module preview,
25
+ then repeat its command without `--dry-run` to create it before previewing the resource.
26
+ The resource scenario expects the module's registration files to exist. It creates the shared
27
+ resource and specification; it does not author custom frontend behavior or backend implementations.
28
+ Use the variable names from the installed scenario manifest: `moduleName` and `resourceName`
29
+ are not aliases for the identifier fields above and are rejected.
30
+
31
+ ## Discover the installed scenarios
32
+
33
+ **`wildo compose` with no arguments prints the scenarios available to this application.**
34
+ Delivered scenarios under `./.wildo-saas/templates/scenarios/` take precedence per scenario ref;
35
+ a resolved framework checkout can supply refs absent from that mirror. Run the list before assuming a slice has no one-command
36
+ form, because the catalogue is delivered per application and grows: any list written into prose —
37
+ including this one — is a copy of a moving population and will be behind it.
38
+
39
+ The catalogue is much wider than modules and resources. It covers whole slices an application may
40
+ not have yet, and hand-scaffolding one of those is a great deal of work a single command already
41
+ does: a documentation portal, a marketing website, an additional environment, a background worker or
42
+ a minion, a provider of several kinds, and a custom operation. If you are about to create a new
43
+ top-level package or a new workspace slice by hand, run `wildo compose` first.
44
+
45
+ An unknown ref is refused by name, and the refusal tells you to run the bare command — so a mistyped
46
+ scenario costs one line, never a partial write.
47
+
48
+ ## Run `--dry-run` first on anything you have run before
49
+
50
+ It prints the whole plan — which writes would be SKIPPED as byte-identical, and which would COLLIDE —
51
+ without touching the tree.
52
+
53
+ ## ⚠️ A scenario is not a migration
54
+
55
+ It writes a file it has not written before, or it refuses. There is no merge, no three-way diff, and
56
+ the engine records nothing about what it previously wrote.
57
+
58
+ **If you edit a generated template target so it differs from the newly rendered bytes,
59
+ re-running that scenario reports a collision and applies nothing.** Git is the undo and the merge, not the tool.
60
+
61
+ **The refusal is whole-scenario, not per-file.** One collision anywhere stops the entire apply. That
62
+ is deliberate — a half-applied scenario leaves a piece registered and absent, or present and
63
+ unregistered — but it means one unrelated local edit blocks everything else in the plan.
64
+
65
+ Byte-identical generated targets are skipped rather than colliding. Declared edits to existing
66
+ files have their own edit semantics; those files are not treated as generated-file collisions.
67
+ A missing or mistyped variable refuses before application planning, because a scenario
68
+ applied with a guessed variable writes plausible wrong content into real application source.
69
+
70
+ ## What the website scenarios leave you
71
+
72
+ They handle English and leave other languages to you. A new page, section or locale each end by
73
+ naming the label packs and route copies still to write — and the site build REFUSES on a missing
74
+ label rather than rendering the key, so the work is enforced rather than forgotten. A new locale is
75
+ seeded with English starter keys, untranslated.
76
+
77
+ ## Choosing between this and the manual workflow
78
+
79
+ The scenario is faster and gets every layer registered at once. The manual workflow in this skill is
80
+ the right choice when the slice must differ from the template, or when the target files already
81
+ exist — because that is exactly the case the scenario refuses.
82
+
83
+ ## Composition Scenario Apply
84
+
85
+ ## Import Origins
86
+
87
+ - `@wildo-ai/application-creation-runtime`
88
+
89
+ ## Source Excerpts
90
+
91
+ ### Origin Package: `@wildo-ai/application-creation-runtime`
92
+
93
+ ```typescript
94
+ *
95
+ * `wildo compose <scenario>` — how an application GROWS a slice it does not yet have: a module, a
96
+ * resource, a marketing page, a website section, a locale.
97
+ *
98
+ * `--dry-run` prints the whole plan, including which writes would be skipped as identical and which
99
+ * would collide, without touching the tree. Prefer it before any scenario you have run before.
100
+ *
101
+ * ⚠️ **A scenario is NOT a migration, and this is the part that surprises people.** It writes a file
102
+ * it has not written before, or it refuses. There is no merge, no three-way diff, and the engine
103
+ * records nothing about what it previously wrote — so once you edit a composed file, re-running that
104
+ * scenario reports a collision and applies NOTHING. Git is the undo and the merge.
105
+ *
106
+ * The refusal is WHOLE-SCENARIO, not per-file: one collision anywhere stops the entire apply. That is
107
+ * deliberate — a half-applied scenario leaves a piece registered and absent, or present and
108
+ * unregistered — but it means an unrelated local edit blocks everything else in the plan.
109
+ *
110
+ * Byte-identical targets are SKIPPED rather than colliding, which is what makes an unedited re-run
111
+ * idempotent. And a missing or mistyped variable REFUSES before any file is read, because a scenario
112
+ * applied with a guessed variable writes plausible wrong content into real application source.
113
+ *
114
+ * Composition-scenario apply engine (V2-P1). Plain functions over the real tree, in the Nx-devkit
115
+ * mold the industry study recommended: the MANIFEST is declarative, the ENGINE is imperative, and
116
+ * dry-run falls out of the collect-then-write split — `planCompositionScenario` computes every
117
+ * byte without touching the filesystem, `applyCompositionScenarioPlan` writes an already-refused-
118
+ * or-approved plan.
119
+ *
120
+ * ## The three invariants
121
+ *
122
+ * 1. **Fail closed on variables.** Unknown supplied names, missing required names, kind or
123
+ * pattern violations all REFUSE before any file is read — a scenario applied with a guessed
124
+ * variable writes plausible wrong content into a real application.
125
+ * 2. **Never half-apply.** Any target that exists with DIFFERENT bytes puts the whole apply into
126
+ * refusal (`collisions`); nothing is written. Byte-identical targets are SKIPPED, which is what
127
+ * makes re-running a scenario idempotent (the Hygen `skip_if` lesson, made structural instead
128
+ * of per-template).
129
+ * 3. **Ownership transfers on write.** An applied file belongs to the application from that
130
+ * moment; the engine records nothing and re-running against edited output refuses rather than
131
+ * merging (git is the undo and the merge — one-source-of-truth Rule 0).
132
+ *
133
+ ```
@@ -53,6 +53,18 @@ export interface SharedSaaSModule extends SharedDomainModule {
53
53
  defaultProfile?: string;
54
54
  unavailabilityPolicy?: Partial<FeatureConfiguration['unavailabilityPolicy']>;
55
55
  };
56
+ /**
57
+ * Progression milestones this module owns.
58
+ *
59
+ * ⚠️ **Milestones need the ANALYTICS capability enabled to appear at all.** The frontend fetches
60
+ * milestone definitions only when analytics is on and returns an empty list otherwise, so with it
61
+ * off the definitions never arrive and the progression tracker renders nothing — declared
62
+ * correctly, and invisible.
63
+ *
64
+ * Enabling analytics with an EMPTY provider list is what lights up the internal progression plane
65
+ * without any telemetry leaving the application. That is the configuration to reach for when an
66
+ * application wants progression and not tracking.
67
+ */
56
68
  customMilestoneDefinitions?: MilestoneDefinition[];
57
69
  productDefinitions?: ProductDefinition[];
58
70
  /**
@@ -61,6 +73,19 @@ export interface SharedSaaSModule extends SharedDomainModule {
61
73
  * an "incomplete todos" count). Aggregated across modules by
62
74
  * `buildSharedSaaSModulesRegistry` and threaded into the app init config, so a
63
75
  * module owns its badge concern end-to-end with no app-level wiring.
76
+ *
77
+ * The framework ships NO badges of its own — every badge in an application is one that application
78
+ * declared.
79
+ *
80
+ * Two limits worth knowing before designing around one. A badge is scoped to a USER or to an
81
+ * ORGANIZATION and to nothing else; there is no application-wide scope. And a DERIVED badge is
82
+ * recomputed off the resource operation's own dispatch, so a change written by some other route
83
+ * does not move it — a client sees the corrected count on its next connection rather than
84
+ * immediately.
85
+ *
86
+ * A badge reference that does not resolve renders nothing, deliberately. The configuration
87
+ * verifier is what makes that loud: an unresolvable badge reference on a launcher item is reported
88
+ * when the application's navigation content is checked.
64
89
  */
65
90
  notificationBadgeDefinitions?: NotificationBadgeDefinition[];
66
91
  }