@wildo-ai/framework-knowledge 1.1.4 → 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 (848) 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 +227 -6
  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/framework-knowledge.schemas.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  11. package/dist/esm/index.d.ts.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  13. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  17. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  19. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  38. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  39. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  40. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  41. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  43. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  45. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  47. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  48. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  49. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  51. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  53. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  55. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  57. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  58. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  59. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  60. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  62. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  67. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  68. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  70. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  74. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  78. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  79. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  81. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  82. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  83. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  85. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  87. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  88. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  89. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  90. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  91. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  93. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  95. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  97. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  99. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  101. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  103. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  105. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  107. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  109. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  110. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  111. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  113. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  115. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  117. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  119. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  121. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  122. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  123. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  124. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  125. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  126. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  127. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  128. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  129. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  130. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  131. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  132. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  133. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  134. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  135. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  137. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  138. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  139. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  140. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  141. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  143. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  145. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  147. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  151. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  154. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  161. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  165. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  169. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  171. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  172. package/dist/knowledge/manifest.json +9 -8
  173. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  174. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  175. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  176. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  179. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  180. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  181. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  182. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  183. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  184. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  185. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  186. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  187. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  188. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  189. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  190. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  191. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  192. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  193. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  194. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  195. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  196. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  197. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  198. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  199. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  200. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  201. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  202. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  203. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  204. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  205. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  206. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  207. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  208. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  209. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  210. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  211. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  212. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  214. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  215. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  216. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  217. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  218. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  219. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  220. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  221. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  222. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  223. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  224. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  225. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  226. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  227. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  228. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  229. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  230. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  234. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  235. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  237. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  238. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  239. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  240. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  241. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  242. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  243. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  244. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  245. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  246. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  247. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  248. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  249. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  250. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  251. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  252. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  253. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  254. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  255. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  256. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  257. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  258. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  259. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  260. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  261. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  262. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  263. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  264. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  267. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  268. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  269. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  270. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  272. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  273. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  274. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  275. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  276. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  277. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  278. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  279. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  280. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  281. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  282. package/dist/knowledge/references/application-maturity.config.md +319 -0
  283. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  284. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  285. package/dist/knowledge/references/brand.asset.config.md +8 -16
  286. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  287. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  288. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  289. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  291. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  294. package/dist/knowledge/references/capability-composition.config.md +155 -0
  295. package/dist/knowledge/references/cli.market.utils.md +1 -0
  296. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  297. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  298. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  299. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  300. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  301. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  302. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  303. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  304. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  305. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  306. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  307. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  308. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  309. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  310. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  311. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  312. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  313. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  314. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  315. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  316. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  317. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  318. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  319. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  320. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  321. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  322. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  323. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  324. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  325. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  326. package/dist/knowledge/references/experience-plan.config.md +311 -0
  327. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  328. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  329. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  330. package/dist/knowledge/references/integration-plan.config.md +185 -0
  331. package/dist/knowledge/references/market.alternative.config.md +1 -1
  332. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  333. package/dist/knowledge/references/market.channel.config.md +3 -3
  334. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  335. package/dist/knowledge/references/market.gain.config.md +1 -1
  336. package/dist/knowledge/references/market.icp.config.md +2 -2
  337. package/dist/knowledge/references/market.job.config.md +1 -1
  338. package/dist/knowledge/references/market.message-template.config.md +2 -2
  339. package/dist/knowledge/references/market.objection.config.md +1 -1
  340. package/dist/knowledge/references/market.pain.config.md +1 -1
  341. package/dist/knowledge/references/market.persona.config.md +2 -2
  342. package/dist/knowledge/references/market.proof.config.md +1 -1
  343. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  345. package/dist/knowledge/references/market.trigger.config.md +1 -1
  346. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  347. package/dist/knowledge/references/placement-plan.config.md +369 -0
  348. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  349. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  350. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  351. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  352. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  353. package/dist/knowledge/references/platform.config.saas.md +261 -9
  354. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  355. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  356. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  357. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  358. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  359. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  361. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  362. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  363. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  364. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  365. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  366. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  367. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  368. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  369. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  370. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  371. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  372. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  373. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  374. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  375. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  376. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  377. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  378. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  379. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  380. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  381. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  382. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  384. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  385. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  386. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  387. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  388. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  389. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  390. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  391. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  392. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  393. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  395. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  396. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  397. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  398. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  399. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  400. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  401. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  402. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  403. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  404. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  405. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  406. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  407. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  408. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  409. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  410. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  411. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  412. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  413. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  414. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  415. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  416. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  417. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  418. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  419. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  420. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  421. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  422. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  423. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  425. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  428. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  429. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  430. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  431. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  432. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  433. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  434. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  435. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  436. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  437. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  438. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  439. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  440. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  441. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  442. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  443. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  444. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  445. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  446. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  447. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  448. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  449. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  450. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  451. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  452. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  453. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  458. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  459. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  460. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  461. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  465. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  466. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  469. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  470. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  472. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  473. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  474. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  475. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  476. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  477. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  478. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  479. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  480. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  481. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  482. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  483. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  484. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  485. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  486. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  487. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  488. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  489. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  490. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  491. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  492. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  493. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  494. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  495. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  496. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  497. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  498. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  499. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  500. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  501. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  502. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  503. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  504. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  505. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  506. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  507. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  508. package/dist/knowledge/references/website-plan.config.md +205 -0
  509. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  510. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  511. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  512. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  513. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  514. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  515. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  516. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  517. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  518. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  519. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  520. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  521. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  522. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  523. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  524. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  525. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  526. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  527. package/dist/knowledge/references/zod.factories.address.md +118 -0
  528. package/dist/knowledge/references/zod.factories.code.md +2 -0
  529. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  530. package/dist/knowledge/references/zod.factories.money.md +2 -0
  531. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  532. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  533. package/dist/knowledge/registries/framework-topics.json +1215 -11
  534. package/dist/knowledge/registries/playbooks.json +454 -50
  535. package/dist/knowledge/registries/source-tags.json +3153 -1043
  536. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  537. package/dist/knowledge/rules/live-context-door.md +108 -0
  538. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  539. package/dist/knowledge/skills/INDEX.md +46 -11
  540. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  541. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  542. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  543. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  544. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  545. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  546. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  547. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  548. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  549. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  550. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  551. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  552. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  553. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  554. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  555. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  556. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  557. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  558. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  559. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  560. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  561. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  562. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  563. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  564. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  565. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  566. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  567. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  568. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  569. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  570. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  571. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  572. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  573. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  574. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  575. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  576. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  577. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  578. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  579. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  580. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  581. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  582. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  583. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  584. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  585. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  586. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  589. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  590. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  591. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  592. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  593. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  594. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  595. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  596. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  597. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  598. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  599. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  600. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  601. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  602. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  603. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  604. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  605. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  606. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  607. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  608. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  609. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  610. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  611. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  612. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  613. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  614. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  615. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  616. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  617. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  618. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  619. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  620. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  621. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  622. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  623. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  624. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  625. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  626. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  627. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  628. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  629. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  630. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  631. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  632. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  633. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  634. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  635. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  636. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  637. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  638. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  639. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  640. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  641. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  642. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  643. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  644. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  645. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  646. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  647. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  648. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  649. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  650. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  651. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  652. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  653. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  654. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  655. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  656. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  657. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  658. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  659. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  660. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  661. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  662. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  663. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  664. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  665. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  666. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  667. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  668. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  669. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  670. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  671. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  672. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  673. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  674. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  675. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  676. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  677. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  678. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  679. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  680. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  681. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  682. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  683. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  684. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  685. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  686. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  687. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  688. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  689. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  690. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  691. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  692. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  693. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  694. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  695. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  696. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  697. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  698. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  699. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  700. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  701. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  702. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  703. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  704. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  705. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  706. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  707. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  708. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  709. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  710. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  711. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  712. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  713. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  714. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  715. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  716. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  717. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  718. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  719. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  720. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  721. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  722. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  723. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  724. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  725. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  726. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  727. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  728. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  736. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  737. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  738. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  739. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  740. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  741. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  742. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  743. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  744. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  745. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  746. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  747. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  748. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  749. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  750. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  751. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  752. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  753. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  754. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  755. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  756. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  757. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  758. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  759. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  760. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  762. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  763. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  765. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  766. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  767. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  768. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  769. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  770. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  771. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  772. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  773. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  774. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  775. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  776. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  777. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  778. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  779. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  780. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  781. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  782. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  783. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  784. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  785. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  786. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  787. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  788. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  789. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  790. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  791. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  792. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  793. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  794. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  795. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  796. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  797. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  798. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  799. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  800. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  801. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  802. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  803. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  804. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  805. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  806. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  807. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  808. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  809. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  810. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  811. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  812. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  813. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  814. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  815. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  816. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  817. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  818. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  819. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  820. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  821. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  822. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  823. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  824. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  825. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  826. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  827. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  828. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  829. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  830. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  831. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  832. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  833. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  834. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  835. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  836. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  837. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  838. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  839. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  840. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  841. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  842. package/dist/knowledge/topic-index.json +5335 -1010
  843. package/dist/tsconfig.build.tsbuildinfo +1 -1
  844. package/dist/tsconfig.tsbuildinfo +1 -1
  845. package/package.json +4 -4
  846. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  847. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  848. /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: local-environment-bootstrap
3
- description: Drive the registered local project lifecycle with the `wildo` CLI — `wildo setup` (mint the environment generation), `wildo local init` (non-destructively initialize or repair infra + platform + application projections), `wildo local reinit` (wipe backing data then run the same initialization journey), `wildo local dev` (start app runtimes), `wildo local up/down/reset`, and `wildo config sync`. Use when the user says "initialize my project", "repair broken platform state", "my Mongo volume was reset", "set up my local stack", "reinitialize from empty data", "regenerate runtime env files", or "I edited wildo.infra.local.config.ts".
3
+ description: Drive the registered local project lifecycle with the `wildo` CLI — `wildo setup` (mint the environment generation), `wildo local init` (non-destructively initialize or repair infra + platform + application projections), `wildo local reinit` (framework-developer-only wipe then initialization), `wildo local dev` (start app runtimes), `wildo local up/down/reset`, and `wildo config sync`. Use when the user says "initialize my project", "add an application to the running platform", "repair broken platform state", "my Mongo volume was reset", "set up my local stack", "reinitialize from empty data", "regenerate runtime env files", "check my config without changing anything" (`wildo config validate`), "set a service port / toggle a capability flag" (`wildo config mutate`), "diagnose my local stack" (`wildo local doctor`), "is what I am running even current", "upgrade to a newer Wildo release" (`wildo update`), "align my dependencies" (`wildo align-deps`), or "I edited wildo.infra.local.config.ts".
4
4
  ---
5
5
 
6
6
  # Local Environment Bootstrap
@@ -43,9 +43,9 @@ everything below:
43
43
  state, native platform processes, one application registration snapshot,
44
44
  every runtime env projection, and a signed platform-to-platform config read.
45
45
  A stale on-disk marker or an open port is not accepted as proof.
46
- 4. **Destructive actions are opt-in.** `--force` only skips confirmations;
47
- it does **not** rotate secrets. Rotating credentials in `secrets.json`
48
- requires `--rotate-secrets` (explicit). Wiping bind-mounted data
46
+ 4. **Destructive actions are opt-in.** Flags are command-specific: setup `--force`
47
+ requests reconfiguration while preserving existing credentials. Setup has no
48
+ `--rotate-secrets` option; credential rotation belongs to the commands that explicitly offer it. Wiping bind-mounted data
49
49
  requires `wildo local reset` (explicit). Anything else is non-destructive
50
50
  by default.
51
51
 
@@ -57,14 +57,14 @@ what regenerates it.
57
57
 
58
58
  | Kind | Examples | Owner | Regenerated by | Safe to delete? |
59
59
  |------|----------|-------|----------------|-----------------|
60
- | **Authored** (in git) | `./infrastructure/<env>/wildo.infra.<env>.config.ts`, `./wildo.saas.config.ts` | You (the app developer) | Never — hand-edited | No — version-controlled truth |
61
- | **Authored secrets** (out of git) | `./infrastructure/<env>/secrets/secrets.json` (or your chosen secrets path) | You + the `wildo setup` wizard | Only by `wildo setup` or `wildo config sync --rotate-secrets` | No by default — destructive rotation is opt-in |
60
+ | **Authored** (in git) | `./infrastructure/local/wildo.infra.local.config.ts` or `./infrastructure/<env>/wildo.infra.remote.config.ts`, `./wildo.saas.config.ts` | You (the app developer) | Never — hand-edited | No — version-controlled truth |
61
+ | **Authored secrets** (out of git) | `./infrastructure/<env>/secrets/secrets.json` (or your chosen secrets path) | You + the `wildo setup` wizard | Setup and ordinary non-CI sync can provision missing material or regenerate incomplete credential groups; complete existing groups are preserved without explicit rotation | No by default — destructive rotation is opt-in |
62
62
  | **Generated runtime artifacts** | `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` | The `wildo` CLI | `wildo local init` / `wildo local up` (self-heal missing files) or scoped `wildo config sync` | Yes — they regenerate from the authored sources |
63
63
  | **Local state + data** | `./.wildo-saas/state/environments.json`, `./.wildo-saas/local_data/<service>/`, `./.wildo-saas/runtime-signals/` | The `wildo` CLI + dev companion | `wildo local init` recreates runtime state; data accumulates across non-destructive restarts | State: yes; **data: only through `wildo local reset` or `wildo local reinit`** after processes and containers stop |
64
64
 
65
65
  **Rule of thumb:** If the file lives under `./.wildo-saas/` it is generated
66
66
  or runtime data — the CLI rebuilds it. Everything outside `./.wildo-saas/`
67
- that the CLI touches (`wildo.infra.<env>.config.ts`, `secrets.json`) is
67
+ that the CLI touches (`wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts`, `secrets.json`) is
68
68
  **authored truth** and must never be deleted as a "fix attempt".
69
69
 
70
70
  The dividing line matters because the most common recovery action — wipe
@@ -99,8 +99,10 @@ deployed environment shares them).
99
99
  - The user wants to rotate local credentials (rare; explicit opt-in)
100
100
  - Platform/application state is absent, partial, or inconsistent and must be
101
101
  repaired without deleting backing data (`wildo local init`)
102
+ - Another application must register against an already-running shared platform
103
+ (`wildo local init --register-only`)
102
104
  - The user wants a full local wipe and verified reinitialization
103
- (`wildo local reinit`, with explicit confirmation or `--force`)
105
+ (framework-developer-only `wildo local reinit`, with explicit confirmation or `--force`)
104
106
 
105
107
  ## When NOT to Use
106
108
 
@@ -119,23 +121,51 @@ deployed environment shares them).
119
121
 
120
122
  ### Step 1: Classify the situation
121
123
 
122
- Pick the right path before running any command. The five cases below
123
- cover ~95% of asks. Read the row that matches the user's phrasing.
124
+ Pick the right path before running any command. Read the row that matches
125
+ the user's situation, including whether another application owns the running platform.
124
126
 
125
127
  | Situation | Right command |
126
128
  |-----------|---------------|
129
+ | This application's `wildo.infra.<env>.config.ts` declares an `infrastructureHost` | Start the platform FROM THE HOST (`cd <host> && wildo local dev`), then `wildo local init` and `wildo local dev` here — both register and attach only |
130
+ | "Add this application while another application uses the running platform" | `wildo local init --register-only` (application registration and runtime projections only; existing healthy platform required) |
127
131
  | "Initialize this project" / "repair broken Mongo-mounted platform state" | `wildo local init` (canonical non-destructive convergence + executable verification) |
128
132
  | "Start my local stack" / "spin up only the dev infra" | `wildo local up` (infra only; self-heals missing artifacts) |
129
133
  | "Stop the stack but keep my local data" | `wildo local down` |
130
- | "Wipe everything and return to a verified initialized project" | `wildo local reinit` (same wipe as reset, then the same journey as `local init`) |
134
+ | "Wipe everything and return to a verified initialized project" | Framework developers: `wildo local reinit`. Application creators: explicitly authorized `wildo local reset`, then separate `wildo local init` |
131
135
  | "Stop everything and leave it empty" | `wildo local reset` |
132
136
  | "I edited `wildo.infra.<env>.config.ts` and need to re-render compose" | `wildo config sync --domain manifest` then `wildo local up` (or just `wildo local up` — it will re-render if the file is missing) |
133
- | "I added a new backing service / changed runtime / changed `publicDomain` and the env state needs re-seeding" | `wildo setup` (re-runs the wizard, hydrates `env.backingServices` / `serviceAuth` / `logging` from the authored config) |
137
+ | "I edited an existing local environment’s backing service or public address" | `wildo config sync` reconciles supported authored local state before rendering; use `wildo setup` for initial state/secrets or a reported unsupported setup path |
134
138
 
135
139
  If the user is describing a symptom rather than an action ("the dev
136
140
  companion can't reach mongodb", "the stack won't start"), read
137
141
  `references/local-environment-troubleshooting.md` first to triage.
138
142
 
143
+ A live `wildo local dev` owner blocks full initialization because convergence
144
+ stops tracked processes and rewrites the shared platform generation. For a
145
+ second application, use `--register-only`; do not stop the first application
146
+ or retry with a wipe to get past this guard. Full convergence belongs to a
147
+ separate, intentional repair of the platform.
148
+
149
+ **An application HOSTED on another's infrastructure** (its environment descriptor is
150
+ `defineHostedInfraEnvConfig` with an `infrastructureHost`) owns no shared substrate, so the
151
+ commands behave differently and always name the host when they refuse:
152
+
153
+ - `wildo local init` registers the application against the host's platform and materializes
154
+ its own runtime env files — never stops, recreates or initializes anything shared.
155
+ - `wildo local dev` attaches: it verifies the host's containers are running and refuses to
156
+ start them. Start the host first.
157
+ - `wildo local up`, `down`, `reset` and `reinit` refuse: they act on the host's containers and
158
+ data. Run them from the host. `wildo dev stop-all` stops only this application's processes.
159
+ - `wildo config sync` writes only this application's targets; the shared compose project,
160
+ `.env.wildo-platform`, platform-service env files and manifests are the host's.
161
+ - Shared credentials come from the host's `infrastructure/<env>/secrets/secrets.json`; this
162
+ application's `secrets.json` keeps only `admin`, `approver`, `application` and `providerEnv`.
163
+ `--rotate-secrets` here rotates only those; rotate shared credentials from the host.
164
+
165
+ Do not "fix" a hosted application's refusal by removing `infrastructureHost` or copying the
166
+ host's backing services into it: that recreates the host's containers over this application's
167
+ data directory under the same container names.
168
+
139
169
  ### Step 2: Confirm the artifact taxonomy before any destructive action
140
170
 
141
171
  Before deleting anything, identify which kind of artifact it is using
@@ -155,6 +185,12 @@ the taxonomy table above. Concretely:
155
185
 
156
186
  `wildo` flags follow a consistent posture:
157
187
 
188
+ - `--register-only` (on `wildo local init`) — register the targeted application
189
+ and materialize its runtime env projections against the existing platform.
190
+ Requires an active LOCAL environment, its setup-generated config and secrets,
191
+ and the configured platform endpoints to be healthy and reachable. It does
192
+ not start or repair shared services. Add `--app <application-slug>` when the
193
+ workspace exposes several targets.
158
194
  - `-y` / `--yes` — skip Y/n prompts (safe: just confirms what would
159
195
  otherwise be confirmed)
160
196
  - `--force` — skip safety prompts on operations that overwrite existing
@@ -170,9 +206,33 @@ the taxonomy table above. Concretely:
170
206
  Read `references/wildo-cli-bootstrap-commands.md` for the full command
171
207
  reference and flag matrix.
172
208
 
209
+ ### Prepare the approving administrator
210
+
211
+ Application-wide grant-controlled reads need approval from a different application super-administrator; requests always start pending. This is not a blanket grant requirement on every application-scoped operation. Tenant grants instead follow the customer's approval posture and usable-owner branch.
212
+
213
+ A fresh `wildo init` with no existing local secrets accepts `WILDO_INIT_APPROVER_EMAIL`, `WILDO_INIT_APPROVER_FIRSTNAME`, `WILDO_INIT_APPROVER_LASTNAME` and `WILDO_INIT_APPROVER_PASSWORD` together. Without explicit inputs it derives a separate `+approver` identity sharing the first administrator's development password. This enables one developer to exercise both identities; it is not evidence of two-person approval.
214
+
215
+ Existing secrets are preserved. Fresh `wildo setup` resolves the approving administrator by the same local explicit-or-derived policy as fresh local init; non-local setup requires explicit inputs. Setup reconfiguration preserves existing administrator and approver identities and passwords, and fills a missing approver through that policy. Completed setup remains a no-op unless reconfiguration is requested. Generic additive secret provisioning does not invent an absent identity. To prepare an existing environment, author `approver.email`, `approver.firstName`, `approver.lastName` and `approver.password` in its selected secrets store, preserving every unrelated value. For a targeted identity-only repair, edit that block directly; setup reconfiguration also regenerates infrastructure configuration and may deploy Kubernetes, so it is broader than adding an identity. Do not rotate secrets. For an already-running local platform, use `wildo local init --register-only` afterwards to forward the identity into application seeding. Check the seeding outcome and actual approving account; repeated seeding preserves an existing approver's password. Non-local environments require an explicitly supplied identity and use their own provisioning workflow.
216
+
217
+ ### Distinguish registration, schema preparation and first records
218
+
219
+ Registration prepares the selected application's platform records, requested service access and key material. Runtime files are projections of that prepared target. This does not deploy its workloads or establish that an application is serving traffic.
220
+
221
+ For a PostgreSQL application with schema migrations, the CLI registers with application seeding deferred, applies the application's migrations, then registers again with seeding required. The second registration also applies role grants to the tables that now exist; replacing it with a seed-only step would omit that provisioning work. Follow the CLI workflow rather than invoking its internal helpers separately.
222
+
223
+ Read the returned `appDatabaseSeeding` outcome at the phase that produced it:
224
+
225
+ | Outcome | What it proves | Next interpretation |
226
+ | --- | --- | --- |
227
+ | `DEFERRED` | Application bootstrap rows were deliberately skipped | Expected before schema preparation, not completion after it |
228
+ | `SEEDED` | Bootstrap rows exist in the application's own database | Still verify authenticated runtime configuration and the actual workload separately |
229
+ | `NO_PERSISTENCE_TARGET` | No application persistence target was resolved | Diagnose the selected database target; migration or retry alone cannot supply one |
230
+
231
+ This is a seeding outcome, not a per-service readiness report or an infrastructure transaction receipt. Registration uses upserts to support repeat attempts, but provisioning stages can have independent outcomes. Inspect required services and the selected initialization path's authenticated config-read completion boundary. Treat explicit override or credential rotation as separate operator actions, not routine repair.
232
+
173
233
  ### Step 4: Verify the project generation
174
234
 
175
- For project initialization or repair, run `wildo local init` and require its
235
+ For full project initialization or repair, run `wildo local init` and require its
176
236
  final coherent-generation result. Before returning zero it waits for backing
177
237
  services, runs idempotent apps-manager INIT, validates canonical app/config/
178
238
  secrets state, readiness-gates every native platform service, registers the
@@ -180,6 +240,12 @@ application once, emits every backend/companion/frontend/worker/minion env
180
240
  projection from that snapshot, and executes a signed platform-to-platform
181
241
  managed-config read.
182
242
 
243
+ For registration into an existing platform, keep `--register-only` on the
244
+ verification command. Require the same signed managed-config postcondition
245
+ and reported backend/companion/frontend/worker/minion target projections.
246
+ This verifies the selected application's registration and runtime material;
247
+ it does not claim to have repaired or reinitialized the shared platform.
248
+
183
249
  Use `docker ps` as supporting infrastructure evidence, not as initialization
184
250
  proof:
185
251
 
@@ -189,27 +255,43 @@ docker ps --filter "name=wildo" --format "table {{.Names}}\t{{.Status}}"
189
255
 
190
256
  Every service the authored config declared with `BackingServiceSource.SELF`
191
257
  should appear (`wildo-mongodb`, `wildo-valkey`, `wildo-rabbitmq`,
192
- `wildo-minio`, `wildo-gotenberg`, `wildo-clamav`, …) with `Status` either
258
+ `wildo-minio`, `wildo-clamav`, …) with `Status` either
193
259
  `healthy` or `health: starting` (clamav has a long signature-DB warm-up
194
260
  period — `start_period: 120s`).
195
261
 
196
- If a declared service is **not** listed, the env state was not seeded
197
- with `backingServices` from the authored config — re-run `wildo setup`
198
- (see Step 1, last row). If a service is listed but unhealthy, read
262
+ If a declared self-hosted service is **not** listed, compare the authored declaration, selected environment state and generated workload. For supported local state, run `wildo config sync` and inspect its reconciliation result before startup; use setup only when state/secrets are missing or the reported unsupported path requires it. If a service is listed but unhealthy, read
199
263
  `references/local-environment-troubleshooting.md`.
200
264
 
201
265
  ### Step 5: Handoff
202
266
 
203
- - For day-to-day app work, run `wildo local dev` after `wildo local init`.
267
+ - For day-to-day app work, run `wildo local dev` after the selected initialization
268
+ path (`wildo local init`, or `wildo local init --register-only` for a second app).
204
269
  Initialization and runtime supervision are distinct: `local init` leaves
205
270
  backing services and the platform control plane ready; `local dev` starts
206
271
  application runtimes and reconciles initialization idempotently.
207
272
  - If the user is iterating on `wildo.infra.<env>.config.ts`, they will
208
- re-enter this skill at Step 1 row 4 / 5 each time they change the
273
+ re-enter this skill at the matching Step 1 configuration-change row when they change the
209
274
  file. **Editing the file alone does not regenerate compose** —
210
275
  authored truth is decoupled from rendered artifacts on purpose, so
211
276
  the AI must drive the regeneration.
212
277
 
278
+ ## Reading and stopping a running stack
279
+
280
+ Three commands beyond the lifecycle verbs, useful in the loop rather than at setup:
281
+
282
+ | command | what it is for |
283
+ |---|---|
284
+ | `wildo local logs` | tail the infrastructure services |
285
+ | `wildo local dev-status` | a VERSIONED SNAPSHOT DOCUMENT — emitted for a tool to read, not a person. Prefer it over `local status` when you are the one consuming the answer |
286
+ | `wildo dev force-stop` | reap orphaned watchers and LEAVE INFRASTRUCTURE ALONE — the right stop when watchers are stuck and the backing services are healthy |
287
+
288
+ `wildo local dev-status` is the one to reach for as an agent: `local status` is written for a person,
289
+ and this emits a structured document with a version on it, so parsing it is not screen-scraping.
290
+
291
+ `wildo dev force-stop` is narrower than it sounds and that is the point — it does not take the stack
292
+ down, so it is safe when the diagnosis is "watchers are wedged" rather than "the environment is
293
+ broken".
294
+
213
295
  ## Worked Example
214
296
 
215
297
  The canonical lifecycle is **setup once → initialize repeatedly**, with
@@ -219,19 +301,32 @@ come back here for the per-command rationale.
219
301
 
220
302
  What earns each line:
221
303
 
222
- - `wildo -y setup` is the way to re-seed the environment when the
223
- authored config has changed shape (new backing service, new
224
- `publicDomain`, runtime swap). It walks the prompts but does NOT
225
- rotate `secrets.json` unless you explicitly answer "yes" to the
226
- rotation prompt or pass `--rotate-secrets`. Re-running setup is the
227
- only way to repopulate `env.backingServices` from
228
- `wildo.infra.<env>.config.ts` — manual file edits to the rendered
229
- compose are not detected.
304
+ - `wildo -y setup` initializes missing environment state and secrets, or
305
+ follows an explicit setup-required diagnostic. It walks the setup prompts and preserves existing
306
+ credentials. Setup has neither a credential-rotation prompt nor a `--rotate-secrets` option.
307
+ An unreadable or invalid existing secrets file stops setup rather than authorizing replacement.
308
+ - For an existing supported LOCAL environment, non-CI `wildo config sync`
309
+ reconciles the authored descriptor into generated config and environment state
310
+ before rendering. Local runtime bootstrap also refreshes those authored inputs.
311
+ Setup is therefore not the only way to refresh `backingServices`.
312
+ - That reconciliation skips non-local environments, missing registry state and
313
+ missing authored descriptors. CI reconstructs its configuration through its own
314
+ path. Unsupported authored reconstruction (currently Atlas metadata) explicitly
315
+ retains the generated snapshot; an invalid or mismatched authored file is an
316
+ error and stops sync rather than silently reusing old configuration.
317
+ - Refresh assigns the authored `backingServices` object when present. If the whole
318
+ object is absent, the existing value is retained; omission is not a general
319
+ delete operation. Review the resolved state and rendered workloads after a change.
320
+ Editing generated Compose files cannot update the authored source.
230
321
  - `wildo local init` owns the complete convergence boundary. It regenerates
231
322
  missing artifacts, starts and gates infrastructure, reconciles platform
232
323
  credentials/database state, registers the application once, emits every
233
324
  runtime target, and executes the signed config-read postcondition.
234
- - `wildo local reinit` performs the registered reset first and then delegates
325
+ - `wildo local init --register-only` adds the selected application to an
326
+ existing healthy platform. It reconciles that application's registration,
327
+ credentials and runtime env targets, then verifies the signed config read;
328
+ it bypasses shared process cleanup, backing-service convergence and platform INIT.
329
+ - In framework-developer context only, `wildo local reinit` performs the backing-data wipe first and then delegates
235
330
  to that same initialization journey. It is the clean-room recovery command;
236
331
  there is no second bootstrap implementation to drift.
237
332
 
@@ -239,11 +334,10 @@ What this loop does **not** do:
239
334
 
240
335
  - Does **not** rotate secrets. The `secrets.json` written in a previous
241
336
  `wildo setup` is reused. To rotate, run `wildo config sync
242
- --rotate-secrets` (explicit opt-in) or answer the rotation prompt
243
- during `wildo setup`.
337
+ --rotate-secrets` (explicit opt-in). Setup preserves existing credentials.
244
338
  - `wildo local init` does **not** wipe backing-service data or rotate authored
245
339
  secrets. It can repair platform-owned records and generated projections.
246
- - `wildo local reinit` **does** wipe `./.wildo-saas/local_data/<service>/`, but
340
+ - Framework-developer-only `wildo local reinit` **does** wipe `./.wildo-saas/local_data/<service>/`, but
247
341
  still preserves authored `secrets.json` unless secret rotation was separately
248
342
  and explicitly requested.
249
343
 
@@ -252,9 +346,14 @@ What this loop does **not** do:
252
346
  - `references/initialization-recovery-recipe.md` — setup, non-destructive
253
347
  initialization/repair, destructive reinitialization, runtime start, and reset
254
348
  - `references/wildo-cli-bootstrap-commands.md` — full command reference
255
- for `wildo setup`, `wildo local init/reinit/up/down/reset`, `wildo config sync`,
256
- including the flag matrix and the `--force` vs `--rotate-secrets`
257
- distinction
349
+ for `wildo setup`, `wildo local dev/init/reinit/up/down/reset/doctor/status/logs`,
350
+ `wildo dev force-stop`, and `wildo config sync/validate/mutate/reapply-declaration`,
351
+ including the flag matrix, the `--force` vs `--rotate-secrets`
352
+ distinction, and the "I changed X → run Y" routing table
353
+ - `references/framework-upgrade-and-dependency-alignment.md` — `wildo update`
354
+ (move the CLI and this application to a release, and what it owes afterwards),
355
+ then `wildo align-deps`: why the second install is not optional, and the
356
+ undeclared-peer trap that no repeated install can fix
258
357
  - `references/local-environment-troubleshooting.md` — symptom-driven
259
358
  triage for the most common failure modes (missing manifest, missing
260
359
  config.json, arm64 image incompatibilities, docker-credential-helper
@@ -266,6 +365,11 @@ What this loop does **not** do:
266
365
 
267
366
  ## Verification
268
367
 
368
+ For `--register-only`, verify the selected app's active environment, existing config/secrets,
369
+ reported runtime targets and signed config-read result. The compose/service convergence
370
+ checks below apply to full initialization; do not run full init merely to satisfy them
371
+ while another app owns a healthy shared platform.
372
+
269
373
  - [ ] `./.wildo-saas/state/environments.json` exists and `currentEnvironment`
270
374
  points to the env you bootstrapped
271
375
  - [ ] `./.wildo-saas/state/environments.json` `environments.<env>.backingServices`
@@ -281,7 +385,8 @@ What this loop does **not** do:
281
385
  - [ ] `docker ps --filter "name=wildo"` shows every declared service
282
386
  `Up` and `healthy` (or `health: starting` for clamav during the
283
387
  first 2 minutes)
284
- - [ ] `wildo local init` exits zero and reports that the platform JWT/config
388
+ - [ ] The selected init command (including `--register-only` for a live shared
389
+ platform) exits zero and reports that the platform JWT/config
285
390
  postcondition was verified
286
391
  - [ ] `./.wildo-saas/logs/local/platform-apps-manager-init.log` contains the
287
392
  INIT generation diagnostic when reconciliation fails
@@ -307,23 +412,25 @@ Run from the app root, substituting `<env>` (typically `local`):
307
412
  | **No secret values** in the authored infra config (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.<env>.config.ts` |
308
413
  | `secrets.json` has not been re-written by an unintended sync | `git status --porcelain infrastructure/<env>/secrets/secrets.json` (should be empty unless you explicitly rotated) |
309
414
 
310
- The high-signal invariants are **`backingServices` populated in
311
- `environments.json`** combined with **every declared service block
312
- present in the compose file with non-empty port mappings** — drift in
313
- either direction means `wildo setup` did not seed the env state from
314
- the authored config (the original cause of "I added clamav and it
315
- didn't show up in compose").
415
+ Compare the authored hosting choices, the selected environment's
416
+ `backingServices` state and the generated workloads together. Each enabled
417
+ self-hosted service should have its expected workload and resolved ports;
418
+ managed services should not gain a local container. A mismatch calls for
419
+ checking the sync reconciliation result and selected environment, rather
420
+ than assuming setup failed. Missing initial state or secrets still requires
421
+ setup; supported local edits can be refreshed by config sync.
316
422
 
317
423
  ## Common Rationalizations
318
424
 
319
425
  | Rationalization | Reality |
320
426
  |-----------------|---------|
321
- | "I'll just hand-edit `docker-compose.wildo-platform.yml` to add the missing service" | The file is regenerated from `wildo.infra.<env>.config.ts` on every `wildo config sync` and on every self-heal pass of `wildo local up`. Add the service to the **authored** config and re-run `wildo setup` (to re-seed `env.backingServices`) followed by `wildo local up`. Hand edits to generated files are silently overwritten — and the developer who comes after you will not know why the change reverted. |
427
+ | "Full init refuses while another app is running; I should stop it" | For second-app onboarding, use `wildo local init --register-only` with existing config/secrets and a healthy platform. The live-owner refusal protects shared services; it does not require an outage for application registration. |
428
+ | "I'll just hand-edit `docker-compose.wildo-platform.yml` to add the missing service" | The file is regenerated from `wildo.infra.<env>.config.ts` on every `wildo config sync` and on every self-heal pass of `wildo local up`. Add the service to the **authored** config and run `wildo config sync` for supported local state, then the intended startup command. Inspect any skipped/unsupported result; initial or missing setup state still requires `wildo setup`. Hand edits to generated files are silently overwritten — and the developer who comes after you will not know why the change reverted. |
322
429
  | "`wildo local up` says config.json is missing — let me create it manually" | Creating `config.json` by hand drifts it from the authored truth and from the schema. The CLI's runtime-bootstrap pre-flight regenerates `config.json` from `wildo.infra.<env>.config.ts` automatically when it is missing — re-running `wildo local up` rebuilds it. If the pre-flight fails, the right fix is to make the authored config valid, not to fabricate the generated artifact. |
323
- | "`--force` will fix it; it always works" | `--force` is documented as **only** skipping confirmation prompts. It does NOT trigger destructive operations that have an explicit dedicated flag (`--rotate-secrets`). Using `--force` to "make it work" without understanding what it will overwrite leads to silent rotation of generated artifacts, not silent rotation of secrets — but it also conditions you to ignore the prompts you should be reading. Read the prompt; pick the explicit flag. |
430
+ | "`--force` will fix it; it always works" | `--force` is command-specific: on setup it requests reconfiguration, not credential rotation; other commands may use it to skip confirmations. It does NOT substitute for an explicit destructive-operation flag. Using `--force` to "make it work" without understanding what it will overwrite leads to silent rotation of generated artifacts, not silent rotation of secrets — but it also conditions you to ignore the prompts you should be reading. Read the prompt; pick the explicit flag. |
324
431
  | "I'll delete `secrets.json` and let `wildo setup` recreate it" | Deleting `secrets.json` is the most destructive action available — it rotates every credential the file holds, breaking any deployed environment that shares them and forcing re-issuance of OIDC client secrets, S3 access keys, JWT signing material, etc. Use `wildo config sync --rotate-secrets` only when rotation is the *intent*, not as a recovery mechanism. For recovery, restore from the secrets backup or from a teammate's checkout. |
325
432
  | "I'll `rm -rf ./.wildo-saas/local_data` to reset mongodb" | Deleting bind-mounted data while the container is running can corrupt the mount and leave mongodb wedged. Use `wildo local reset` — it runs `docker compose down` first, then `rm -rf`s `local_data/<service>/`. The composed sequence is the contract; the raw `rm -rf` is not. |
326
- | "All containers are healthy, so initialization is complete" | Container health proves only the backing-service plane. It does not prove platform credentials, Mongo records, app registration, generated env projections, or JWT verification-key coherence. Run `wildo local init`; its signed config read is the executable completion boundary. |
433
+ | "All containers are healthy, so initialization is complete" | Container health proves only the backing-service plane. It does not prove platform credentials, Mongo records, app registration, generated env projections, or JWT verification-key coherence. Run the selected initialization path: `wildo local init --register-only` for application registration into a healthy live platform, or full `wildo local init` for platform convergence without a live owner. Require its signed config-read completion boundary. |
327
434
  | "The clamav image hangs forever on Apple Silicon, so let me skip it" | Cisco only publishes `clamav/clamav` for `linux/amd64` (no arm64 manifest), so `docker compose pull` would fail on Apple Silicon. The compose template already pins `platform: linux/amd64` for clamav so it runs under Rosetta. If clamav still hangs, it is the Docker Desktop credential helper (`docker-credential-desktop get`), not clamav itself — read the troubleshooting reference. |
328
435
 
329
436
  ## Red Flags
@@ -342,8 +449,8 @@ didn't show up in compose").
342
449
  - A backing service in `wildo.infra.<env>.config.ts` that does not
343
450
  appear under `services:` in the compose file (catch with the
344
451
  **Compose file declares every authored backing service** Verification
345
- step — means `wildo setup` did not re-seed `env.backingServices` from
346
- the authored config; re-run `wildo setup` to fix)
452
+ step — inspect the selected environment, authored hosting choice and sync
453
+ reconciliation result; a missing workload alone does not identify a setup failure)
347
454
  - `wildo local up` exits 0 but `docker ps --filter "name=wildo"` is
348
455
  empty (catch with the **`docker ps`** Verification step — typically
349
456
  means `docker compose` itself failed silently while the CLI's
@@ -0,0 +1,119 @@
1
+ # Moving to a new framework release — `wildo update`
2
+
3
+ Run it inside this application:
4
+
5
+ ```bash
6
+ wildo update --check # CLI, application and target release — changes nothing
7
+ wildo update # move to the latest release
8
+ wildo update --to <version> # move to an exact release, up or down (from 1.1.5 on)
9
+ wildo update --tag <tag> # follow another published channel (e.g. next)
10
+ ```
11
+
12
+ It moves the two homes of a release, in this order:
13
+
14
+ 1. **The CLI.** The scaffold templates, the compose and k8s templates and the platform image tag
15
+ travel with it. The new one is installed beside the current one, verified, and only then made
16
+ the one `wildo` runs; the previous one is removed on the next update.
17
+ 2. **This application**, run by the NEW CLI: every `@wildo-ai/*` pin in `pnpm.overrides`, the
18
+ companion and workbench drops (the workbench drop is created if this application predates it), `pnpm install` → dependency alignment → `pnpm install`, the delivered templates,
19
+ docs, skills and rules, and the deploy manifests (`config sync --domain manifest`).
20
+
21
+ It restarts nothing. Afterwards `wildo local up` puts the platform on the release's image, and
22
+ restarting `wildo local dev` runs the application and its companion on the new packages.
23
+
24
+ ## When the release asks for something this application does not declare
25
+
26
+ A release can make a declaration REQUIRED that older applications do not have. `wildo update` then
27
+ lists each field (`organizationTypes: Invalid input: expected record, received undefined`) and skips
28
+ the manifest step. The update itself has succeeded; the application owes a declaration.
29
+
30
+ Add it to `wildo.saas.config.ts`. The current scaffold's version of that file is delivered at
31
+ `.wildo-saas/templates/skeleton/wildo.saas.config.ts.init.hbs` — use it as the reference for the
32
+ shape, and choose the VALUES for this application: they are usually product decisions (a tenancy
33
+ model, which user types administer), which is why nothing writes them for you. Then run
34
+ `wildo config sync`.
35
+
36
+ ## What it will not touch
37
+
38
+ - **A framework linked from a checkout** (`file:` pins) — that application follows the checkout.
39
+ - **A CLI it did not install** — if `wildo` came from `npm install -g`, upgrade it the same way; the
40
+ update will not write beside, or clean, a directory it does not own.
41
+ - **A release older than 1.1.5** — the first one that has `wildo update`. Installing an older one
42
+ this way would leave a CLI that cannot update itself; use the installer's `--cli-version` instead.
43
+
44
+ ## What runs underneath: `wildo align-deps`
45
+
46
+ When this application was scaffolded, the third-party versions it pins and the peer dependencies each
47
+ of its packages declares were computed from the framework **at that moment**. Nothing recomputes them
48
+ afterwards unless something asks — `wildo update` asks on every release. `wildo align-deps` is the
49
+ command that re-derives them, and you can run it on its own; it needs no framework checkout.
50
+
51
+ ## The order by hand, and why the second install is not optional
52
+
53
+ `wildo update` does this for you. By hand it is:
54
+
55
+ ```bash
56
+ # 1. bump the @wildo-ai/* entries in this application's pnpm.overrides
57
+ pnpm install # 2. the new pin set can only be READ once it is on disk
58
+ wildo align-deps --write # 3. re-derive pins and peer declarations
59
+ pnpm install # 4. the peer half takes effect only now
60
+ ```
61
+
62
+ Step 2 comes before step 3 because the command derives everything from the `@wildo-ai` packages
63
+ resolved in this application's own tree. It cannot report on a release that is not installed yet.
64
+
65
+ Step 4 is required because `align-deps` **writes manifests only**. It does not install, so the
66
+ lockfile is unchanged until you install again.
67
+
68
+ ## Run it once after the very first install too
69
+
70
+ A freshly scaffolded application legitimately needs one alignment run. Scaffolding writes pins from
71
+ the framework **checkout** while pinning the framework itself to the **published release**, and those
72
+ two disagree whenever the checkout is ahead of the last release — which, between releases, is always.
73
+ This is expected, not a defect.
74
+
75
+ ## Default is read-only
76
+
77
+ ```bash
78
+ wildo align-deps # report; exits NON-ZERO on drift
79
+ wildo align-deps --write # apply
80
+ ```
81
+
82
+ ## The trap: a peer nobody declares can never be re-resolved
83
+
84
+ This is the failure worth understanding, because every obvious remedy does nothing.
85
+
86
+ An override rewrites a version some manifest **wrote down**. It never creates one. So a peer
87
+ dependency that no manifest declares is resolved automatically once, that resolution is recorded, and
88
+ it is then never re-derived downward. Running the same install again — repeatedly, or with `--force`
89
+ — changes nothing.
90
+
91
+ The symptom arrives much later: a version range narrows, and a resolution frozen months earlier
92
+ starts reading as a live version conflict. At that point **the code looks like the culprit and is
93
+ not.** The fix is to move the SPECIFIER, which is what `align-deps` does by declaring the peer.
94
+
95
+ A related finding it reports and you should not dismiss: **a peer declared at a concrete version
96
+ rather than as `*`.** The framework's pin then cannot reach it, so a later version bump silently will
97
+ not land. Declare framework-managed peers as `"*"` and let the override decide the version.
98
+
99
+ ## What it will not do, deliberately
100
+
101
+ - **It never changes a framework version.** Which release to adopt is your decision, stated as
102
+ `wildo update --to`; everything else follows mechanically from it.
103
+ - **It never removes a name.** A managed name the closure does not require may still be this
104
+ application's own dependency. An early version that pruned "surplus" entries stripped real
105
+ dependencies out of two packages.
106
+ - It does not install (above).
107
+
108
+ ## Exclusions are yours
109
+
110
+ The exclusions file is seeded into the application when it is scaffolded, and it is the right owner:
111
+ this application knows which names its own toolchain controls, and it is the party that breaks when
112
+ the judgement is wrong. Add a name there — with the measurement that justifies it — rather than
113
+ fighting the report.
114
+
115
+ ## New workspace packages are born aligned
116
+
117
+ A composition scenario that creates a new package inside this application (a website, a
118
+ documentation site, a background worker) reads a delivered copy of the peer closure, so it starts
119
+ with the peers it needs declared rather than with none. You do not have to hand-declare them.
@@ -10,14 +10,17 @@ Mongo deletion commands.
10
10
  wildo setup --non-interactive # CI/headless; requires admin seed env vars
11
11
  # or: wildo setup # interactive developer setup
12
12
 
13
- # Normal first initialization and every non-destructive repair attempt.
13
+ # First initialization or shared-platform repair without a live owner.
14
14
  wildo local init
15
15
 
16
- # Start application runtimes after the verified initialization boundary.
16
+ # For a healthy existing platform, register only the selected application instead:
17
+ wildo local init --register-only
18
+
19
+ # In a local Compose environment, start application runtimes after initialization.
17
20
  wildo local dev
18
21
  ```
19
22
 
20
- When local backing data itself must be discarded, use the composed command:
23
+ When local backing data itself must be discarded, framework developers can use the composed command. It requires a targeted application root, resolved framework path and framework-developer mode; `--force` does not bypass those checks. Application creators can explicitly run `local reset`, then `local init` separately:
21
24
 
22
25
  ```bash
23
26
  # Stops graph-supervised/tracked processes, performs the same wipe as reset,
@@ -39,7 +42,7 @@ wildo local reset --force
39
42
  |---|---|
40
43
  | Authored environment state and secrets | `wildo setup` |
41
44
  | Generated config/compose/env artifacts | runtime bootstrap inside `wildo local init` (or scoped `wildo config sync`) |
42
- | Backing services and initializer readiness | `wildo local init` / `wildo local reinit` |
45
+ | Backing services and initializer readiness | `wildo local init` for both audiences; `wildo local reinit` for framework developers only |
43
46
  | Platform credentials, canonical Mongo records, native service readiness | apps-manager INIT + platform lifecycle inside `wildo local init` |
44
47
  | Application registration and all runtime projections | application bootstrap inside `wildo local init` |
45
48
  | Executable completion proof | signed platform-to-platform managed-config read inside `wildo local init` |