@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
@@ -53,7 +53,7 @@ touch first:
53
53
  Plus a fifth "deep" decision when something is wrong:
54
54
 
55
55
  5. **Boot wiring** — understand the order of operations inside
56
- `runDataSeedingApplicationBootstrap` (Level-A dispatch, Level-B
56
+ the startup bootstrap (Level-A dispatch, Level-B
57
57
  pre/post hooks per resource, LAZY pre-only guards per
58
58
  `(resourceType, operation)`, platform-mode skip) so you can
59
59
  explain why a seed fired, didn't fire, or fired in an unexpected
@@ -64,7 +64,7 @@ Plus a fifth "deep" decision when something is wrong:
64
64
  | Surface | Glob (relative to app root) |
65
65
  |---------|------------------------------------------------------------|
66
66
  | App config (cron tick override) | `infrastructure/local/wildo.infra.local.config.ts` (and the `infrastructure/<env>/wildo.infra.<env>.config.ts` siblings for staging / prod) — populates `dataSeeding.scheduledRerunCronSchedule` on the resolved `AppConfiguration_Shared_Schema`. |
67
- | Admin secret | `wildo-secrets/environments/<env>/secrets.json` — sets `APPLICATION_ADMIN_SECRET` in the app process env. NOT a typed schema field on `ApplicationEnvConfigurationSchema` (it is read directly from `process.env` so the surface stays self-contained to `saas-backend-lib`). |
67
+ | Admin secret | **FRAMEWORK-MANAGED — you do not author it.** `application.adminSecret` in the environment's `secrets.json` is minted (48 bytes) at `wildo setup` and filled in by the idempotent self-heal on any later `wildo config sync` / `wildo local dev`, so an environment that predates it acquires one without an operator typing anything. `wildo config sync` then emits it as `APPLICATION_ADMIN_SECRET` into the app backend's env — the local `.env`, the compose `env_file` and the k8s `{appSlug}-secret` alike, all from one producer. Read the value with `wildo secrets show` or out of the environment's `secrets.json`. NOT a typed field on `ApplicationEnvConfigurationSchema`: the two admin controllers read `process.env` directly so each surface stays self-contained to `saas-backend-lib`. |
68
68
  | Module backend record (where `schedule?` is declared) | `backend-api/src/modules/<module>/seeds/<seed-key>.seed.ts` — same authoring file `seeding-authoring` covers; the `schedule?` block is one of the optional inputs to `createDataSeedDefinition({...})`. |
69
69
  | Custom resolver registration | `backend-api/src/modules/<module>/index.ts` — the `dataSeedScopeResolvers?: Record<string, DataSeedScopeResolver>` slot on the typed `BackendDomainModule` (same record that carries `seeds`). Aggregated by `mergeBackendDomainModules` and threaded through `ApplicationInitializationConfig.dataSeedScopeResolvers`. |
70
70
  | Curl runbook | n/a (operator action) — endpoint root is `/internal/admin/data-seeding`, header is `X-Admin-Secret: <APPLICATION_ADMIN_SECRET value>`. |
@@ -150,9 +150,9 @@ The five iteration strategies determine per-tick fan-out:
150
150
  |----------|------------------|-------------------|
151
151
  | `GLOBAL` | 1 dispatch (no anchor) | `GLOBAL` only |
152
152
  | `ALL_APPLICATIONS` | 1 dispatch per `applications` row | `APPLICATION` |
153
- | `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `APPLICATION` (cross-tenant) / `ORGANIZATION` |
154
- | `ALL_USERS` | 1 dispatch per `users` row | `APPLICATION` (cross-tenant) / `USER` |
155
- | `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | every kind (incl. `CUSTOM`) — REQUIRED for `CUSTOM` |
153
+ | `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `ORGANIZATION` only |
154
+ | `ALL_USERS` | 1 dispatch per `users` row | `USER` only |
155
+ | `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | `APPLICATION`, `ORGANIZATION`, `USER`, `CUSTOM`; required for `CUSTOM` |
156
156
 
157
157
  Anchoring (N8): the cron batch runs per-app under its own
158
158
  application's process. `ALL_ORGANIZATIONS` and `ALL_USERS`
@@ -290,9 +290,11 @@ re-runs in the last 24 hours").
290
290
 
291
291
  ### Decision 5: Boot wiring (deep)
292
292
 
293
- `runDataSeedingApplicationBootstrap` is invoked once during app
294
- startup (Step 7.7). The order matters; understanding it explains
295
- every "why did this seed fire / not fire / fire twice" question.
293
+ The bootstrap runs once during app startup, in two halves: steps 1–4
294
+ (`wireDataSeedingDeclarations`) before the HTTP server listens, steps 5–7
295
+ (`runDataSeedingApplicationLifecyclePasses`) at Step 7.7. The order matters;
296
+ understanding it explains every "why did this seed fire / not fire / fire
297
+ twice" question.
296
298
 
297
299
  The bootstrap fires this sequence (each step's annotation explains
298
300
  when it runs):
@@ -393,11 +395,13 @@ seed corpus and silently break downstream ops.
393
395
 
394
396
  ### Workflow D: Tune the engine cron tick
395
397
 
396
- 1. Identify the coarsest per-seed cron in the registered corpus
397
- (`GET /seeds`, scan `schedule.cron` per seed).
398
- 2. Pick an engine tick at most as coarse as that seed (the tick
399
- bounds responsiveness — a 5-minute tick can never fire a seed
400
- whose own cron is `'* * * * *'`).
398
+ 1. Review every seed's latency and frequency requirements, starting with
399
+ the most time-sensitive seed.
400
+ 2. Choose an engine tick whose evaluation delay and coalescing are acceptable.
401
+ Both cron expressions use UTC. A minute seed on a five-minute engine tick
402
+ is due once per selected scope on that tick, not once for each minute.
403
+ The runtime tests the window `(enginePrevTickFire, tickAt]`; it does not
404
+ require an exact-time match or replay all missed occurrences after downtime.
401
405
  3. Set `dataSeeding.scheduledRerunCronSchedule` on the
402
406
  environment's `wildo.infra.<env>.config.ts` (the resolved
403
407
  `AppConfiguration_Shared_Schema.dataSeeding`).
@@ -429,14 +433,15 @@ seed corpus and silently break downstream ops.
429
433
  - [ ] Custom resolver registered in
430
434
  `BackendDomainModule.dataSeedScopeResolvers` in the same
431
435
  commit as the seed declaring it
432
- - [ ] `APPLICATION_ADMIN_SECRET` set on every environment that
433
- needs the admin surface enabled (otherwise `503
434
- INFRASTRUCTURE`)
436
+ - [ ] `APPLICATION_ADMIN_SECRET` present in the app backend's env
437
+ (otherwise `503 INFRASTRUCTURE`). Framework-managed, so the
438
+ check is that a `config sync` has RUN and the app has
439
+ RESTARTED since — not that someone authored a value
435
440
  - [ ] Operators have a tested `curl` recipe for the seed they may
436
441
  need to re-run (Workflow B)
437
442
  - [ ] `dataSeeding.scheduledRerunCronSchedule` override (if any)
438
- is at most as coarse as the coarsest per-seed cron in the
439
- registered corpus
443
+ has acceptable evaluation delay and coalescing for every seed
444
+ in the registered corpus
440
445
 
441
446
  ### Grep invariants
442
447
 
@@ -447,14 +452,13 @@ Run from the app root, substituting `<module>` and `<seed-key>`:
447
452
  | Seed declares a `schedule?` block | `rg -n "schedule:\s*\{" backend-api/src/modules/<module>/seeds/` |
448
453
  | Custom resolver registered when CUSTOM_RESOLVER used | `rg -n "dataSeedScopeResolvers:" backend-api/src/modules/<module>/index.ts` |
449
454
  | Engine cron tick override declared | `rg -n "scheduledRerunCronSchedule" infrastructure/` |
450
- | `APPLICATION_ADMIN_SECRET` provisioned | `rg -n "APPLICATION_ADMIN_SECRET" ../wildo-secrets/environments/` |
455
+ | `APPLICATION_ADMIN_SECRET` provisioned | `rg -n "adminSecret" infrastructure/<env>/secrets/secrets.json` (the `application` section) — and `rg -n "^APPLICATION_ADMIN_SECRET=" backend-api/.env` to confirm it reached the runtime |
451
456
 
452
457
  The high-signal invariants are **"`schedule?` declared in the seed
453
458
  file"** combined with **"custom resolver registered when
454
459
  `CUSTOM_RESOLVER` is the chosen strategy"** — a missing resolver
455
- silently iterates zero rows on every cron tick (no error, no
456
- failed run row, no observable signal except a flat
457
- `data_seeding_run_total` counter for that seed).
460
+ raises a configuration error during scope iteration. Inspect the batch
461
+ report and logs; no scope dispatch can succeed through that missing resolver.
458
462
 
459
463
  ## Common Rationalizations
460
464
 
@@ -463,15 +467,15 @@ failed run row, no observable signal except a flat
463
467
  | "I'll just declare `schedule?` on the LAZY seed; it'll re-run on the cron tick" | Factory rejects (`mode === LAZY` × `schedule` is N10). LAZY's contract is "first access creates the row, never re-applied" — periodic re-runs would either duplicate rows (no idempotency on the second access) or contradict the cache semantics (force a cache invalidation on every tick, which is a `force: true` re-run, which deletes COMPLETED rows). If you want periodic re-run, switch to ADDITIVE / UPGRADE / SYNC. |
464
468
  | "I'll set `force: true` on every manual re-run to be safe" | `force: true` only affects LAZY seeds (it deletes prior COMPLETED rows so the next access re-runs the body). For ADDITIVE / UPGRADE / SYNC it is a no-op. Setting it indiscriminately costs nothing on those modes but signals confusion in the `runManual` audit trail (`triggeredByUserId` + payload echoed in logs). |
465
469
  | "I'll skip `APPLICATION_ADMIN_SECRET` since the endpoints are internal" | The endpoints mount on `/internal/admin/data-seeding` but are NOT firewalled by path. Without the env var, every endpoint returns `503 INFRASTRUCTURE` (safe-default). Set the secret AND deploy behind a network-level rate limiter (LB / ingress) — there is NO in-process throttle. |
466
- | "I'll override the engine tick to `'*/30 * * * * *'` (every 30 seconds) for faster propagation" | 6-field "second-aware" cron is NOT supported by the parser. The minimum is 5-field (1-minute resolution). If you need sub-minute responsiveness, restructure the seed to fire on a Level-B trigger or LAZY access instead — those run synchronously inside the request that needs them. |
470
+ | "I'll override the engine tick to `'*/30 * * * * *'` (every 30 seconds) for faster propagation" | The parser accepts second-aware expressions, but parsing does not prove that the platform will deliver that cadence. Verify the complete scheduler path before relying on sub-minute timing. Level-B triggers or LAZY access can tie materialization to the request that needs it. |
467
471
  | "The seed's `lastRun` is RUNNING, I'll DELETE the row to retry" | The dispatcher uses `upsertByBusinessKey` on `(seedKey, scope, version)` — the next dispatcher pass (cron tick or manual re-run) PATCHES the existing RUNNING row to its terminal state. DELETE-ing the row is rarely needed; only do it when the row is `RUNNING` AND the dispatcher's recovery window has expired AND the next pass is not coming soon enough. |
468
472
 
469
473
  ## Red Flags
470
474
 
471
475
  - A seed declares `schedule?` but its `iterationStrategy` is
472
476
  `CUSTOM_RESOLVER` and no resolver is registered in the module's
473
- `dataSeedScopeResolvers` slot (silent zero-row iteration on every
474
- tick — flat `data_seeding_run_total` for that seed)
477
+ `dataSeedScopeResolvers` slot (configuration error during iteration;
478
+ inspect the batch report and logs)
475
479
  - `APPLICATION_ADMIN_SECRET` set to a low-entropy string (e.g.
476
480
  `admin123`) — the constant-time SHA-256 compare defeats the
477
481
  timing oracle but a brute-forced secret defeats the secret
@@ -484,10 +488,10 @@ failed run row, no observable signal except a flat
484
488
  run with `onOrphan: REPORT` first on production, audit the
485
489
  orphan set, THEN switch to `DELETE` (Decision 5 / Workflow C in
486
490
  `seeding-authoring`)
487
- - The cron seed isn't firing AND `(dataSeeds ?? []).some((seed) =>
488
- seed.schedule !== undefined)` is `true` AND the engine tick is
489
- coarser than the seed's own cron — the tick bounds the seed
490
- cron's resolution; tune the tick down
491
+ - A seed needs one invocation per minute but the engine evaluates every
492
+ five minutes — firings are coalesced; use minute-level evaluation. A
493
+ coarse tick alone does not explain a seed never running. Check registration,
494
+ the UTC window, selected scopes and reported dispatch errors.
491
495
 
492
496
  ## Related Skills
493
497
 
@@ -34,7 +34,7 @@ the cause from the response without consulting logs:
34
34
 
35
35
  | Response | Cause | Operator action |
36
36
  |-------------------------|--------------------------------------------------|----------------------------------------------------------------------------------|
37
- | `503 INFRASTRUCTURE` | Env var unset/empty (endpoints disabled) | Set `APPLICATION_ADMIN_SECRET` to high-entropy bytes; restart the app process |
37
+ | `503 INFRASTRUCTURE` | Env var unset/empty (endpoints disabled) | Run `wildo config sync` (the secret is framework-minted and self-healed into `secrets.json`, then emitted into the app env), then RESTART the app process — env is read at start |
38
38
  | `401 AUTHENTICATION` ("Missing X-Admin-Secret header") | Header absent on the request | Add `-H "X-Admin-Secret: $APPLICATION_ADMIN_SECRET"` to the curl |
39
39
  | `401 AUTHENTICATION` ("Invalid X-Admin-Secret") | Header present but value mismatches | Verify `$APPLICATION_ADMIN_SECRET` in the operator's shell matches the deployed value |
40
40
 
@@ -264,20 +264,28 @@ GET /seeds → find lastRun for the suspect seed
264
264
 
265
265
  ## Decision 5 (extended): Boot wiring trace
266
266
 
267
- `runDataSeedingApplicationBootstrap` is the SINGLE entry point
268
- invoked by `StartApplicationBackendService.initialize()` at
269
- Step 7.7. The order inside is the source of truth:
267
+ `StartApplicationBackendService.initialize()` runs the bootstrap in TWO
268
+ halves. Steps 1–4 (`wireDataSeedingDeclarations`) run at Step 5.9, BEFORE the
269
+ HTTP server starts listening; steps 5–7 (`runDataSeedingApplicationLifecyclePasses`)
270
+ run at Step 7.7. There is deliberately no one-call composite of the two.
271
+ The order is the source of truth:
270
272
 
271
273
  ```text
272
274
  1. registry.registerSeeds(seeds) ALWAYS
273
275
  2. scopeResolverRegistry.registerResolvers(map) ALWAYS
274
276
  3. wireLevelBResourceLifecycleHooks(...) ALWAYS — pre/post hooks per resource type
275
277
  4. wireLazyAccessGuards(...) ALWAYS — pre-only hooks per (resourceType, operation)
278
+ ── the HTTP server starts listening here ──
276
279
  5. if isPlatformMode → return platform apps-manager skips dispatch
277
280
  6. dispatcher.runApplicationLifecycle('onAppInit')
278
281
  7. dispatcher.runApplicationLifecycle('onAppVersionUpgrade')
279
282
  ```
280
283
 
284
+ Why the split: a request served before step 3 runs without its Level-B seeds,
285
+ and a missed `afterCreate` is never retried. The hooks were once wired after the
286
+ server was already answering, behind an awaited cron-job sync, and every
287
+ organization created in that window had no configuration singletons.
288
+
281
289
  ### "Why did/didn't the seed fire" — three frequent investigations
282
290
 
283
291
  **Investigation 1: "The seed is registered but didn't fire on
@@ -319,7 +327,7 @@ reveal it.
319
327
  ### Failure propagation
320
328
 
321
329
  A fatal throw from either Step 6 or Step 7 propagates UNCHANGED
322
- out of `runDataSeedingApplicationBootstrap` and out of
330
+ out of `runDataSeedingApplicationLifecyclePasses` and out of
323
331
  `StartApplicationBackendService.initialize()`. There is NO
324
332
  try/catch here — that's intentional, because:
325
333
 
@@ -15,35 +15,45 @@ seeding:scheduled-rerun`) wakes on the engine tick (default
15
15
  `'* * * * *'`, override via
16
16
  `AppConfiguration_Shared_Schema.dataSeeding.scheduledRerunCronSchedule`).
17
17
 
18
- On every tick, the batch runs the following algorithm:
18
+ The batch captures `tickAt` when handling starts. Both cron expressions are
19
+ interpreted in UTC. It derives the previous engine boundary from a backdated
20
+ cursor; the backdate scales with the configured engine interval so modest
21
+ wake-up delays can still include the intended boundary.
19
22
 
20
23
  ```text
21
- for each registered seed with schedule? defined:
22
- if cronParser(seed.schedule.cron).matches(now):
23
- scopes = expandIterationStrategy(seed.schedule.iterationStrategy)
24
- for each scope in scopes:
25
- dispatcher.runScheduled(seed, scope)
24
+ tickAt = handler start time
25
+ enginePrevTickFire = previous engine firing before the backdated cursor
26
+ for each registered seed with schedule defined:
27
+ seedNextFire = first seed firing strictly after enginePrevTickFire
28
+ if seedNextFire <= tickAt:
29
+ for each item selected by the iteration strategy:
30
+ dispatch the seed for that item's scope, origin SCHEDULED_RERUN
26
31
  ```
27
32
 
33
+ This is a UTC window `(enginePrevTickFire, tickAt]`, not an exact-time match.
34
+
35
+ | Engine cron | Seed cron | Handler starts (UTC) | Result |
36
+ |-------------|-----------|----------------------|--------|
37
+ | `*/5 * * * *` | `* * * * *` | 12:35:00 | Window (12:30, 12:35] contains minute firings; one dispatch per selected scope, not five. |
38
+ | `*/5 * * * *` | `34 12 * * *` | 12:35:00 | The 12:34 firing is due and evaluated on this tick. |
39
+ | `* * * * *` | `34 12 * * *` | 12:34:01.500 | The slightly delayed evaluation still includes 12:34. |
40
+ | `* * * * *` | `34 12 * * *` | 12:35:00 | The next window excludes 12:34; this daily seed is no longer due. |
41
+
28
42
  Three operational consequences:
29
43
 
30
- 1. **The engine tick bounds responsiveness**. A 5-minute engine
31
- tick can NEVER fire a seed whose own cron is `'* * * * *'` —
32
- the tick is what decides whether to evaluate per-seed crons.
33
- Tune the tick to the coarsest cadence that still satisfies the
34
- most frequent per-seed cron in the registered corpus.
35
- 2. **Per-seed crons are evaluated against `now`, not against the
36
- tick boundary**. If the engine tick is `'*/5 * * * *'` and a
37
- seed's cron is `'0 * * * *'` (top of the hour), the seed fires
38
- on the first tick at-or-after `:00` (so somewhere in `[:00,
39
- :05)`). Acceptable for hourly / daily seeds; problematic for
40
- sub-minute seeds (which are unsupported anyway — cron is
41
- minute-resolution).
42
- 3. **No catch-up semantics**. A missed tick (process crash, k8s
43
- restart, paused replica) does NOT replay missed seed cron
44
- evaluations. Use the manual re-run endpoint
45
- ([Decision 2](../SKILL.md#decision-2-re-run-a-seed-manually))
46
- for explicit catch-up after a deployment outage.
44
+ 1. **The engine tick bounds evaluation frequency.** A minute seed on a
45
+ five-minute engine tick can run, but its occurrences are coalesced into
46
+ one dispatch per selected scope at that evaluation. Use a minute tick
47
+ when the application needs minute-level evaluation.
48
+ 2. **Delayed evaluation is bounded.** The backdated window accommodates
49
+ modest lateness; it is not a promise that every arbitrarily late wake-up
50
+ preserves the original tick. Processing duration and scope fan-out also
51
+ affect when work completes.
52
+ 3. **There is no durable missed-occurrence replay.** The window is recomputed
53
+ from the current handling time, not the last successful run. After an
54
+ outage, occurrences outside that window are not enumerated or replayed.
55
+ Use an explicit manual rerun for reconciliation; it runs the seed now,
56
+ rather than reconstructing every missed historical firing.
47
57
 
48
58
  ## The five iteration strategies
49
59
 
@@ -56,25 +66,21 @@ shape. Five values, one alignment matrix with the seed's
56
66
  |---------------------|---------------------------------------------|--------------------------------------------------|---------------------------|
57
67
  | `GLOBAL` | 1 dispatch (no anchor) | `GLOBAL` only | No |
58
68
  | `ALL_APPLICATIONS` | 1 dispatch per `applications` row | `APPLICATION` | No |
59
- | `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `APPLICATION` (cross-tenant) / `ORGANIZATION` | No |
60
- | `ALL_USERS` | 1 dispatch per `users` row | `APPLICATION` (cross-tenant) / `USER` | No |
61
- | `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | every kind (incl. `CUSTOM`) — REQUIRED for `CUSTOM` | Yes (`customResolverKey`) |
62
-
63
- ### When `ALL_ORGANIZATIONS` / `ALL_USERS` apply to an `APPLICATION`-scope seed
64
-
65
- A seed declared with `scope.kind === APPLICATION` AND
66
- `iterationStrategy === ALL_ORGANIZATIONS` is the "cross-tenant"
67
- case: the seed itself is per-application (so the `DataSeedRun` row
68
- is per-app), but it iterates EVERY org of that app on every cron
69
- tick. Use this when the seed's body needs to apply the same
70
- materialization to every tenant under the host application
71
- (operator-side reconciliation), but the run-level outcome is
72
- attributed to the app, not to any single org.
73
-
74
- If you want one `DataSeedRun` row per org (so the ledger drill-in
75
- naturally pages per tenant), use `scope.kind === ORGANIZATION`
76
- instead — same `iterationStrategy` is allowed and gives you
77
- per-org provenance.
69
+ | `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `ORGANIZATION` only | No |
70
+ | `ALL_USERS` | 1 dispatch per `users` row | `USER` only | No |
71
+ | `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | `APPLICATION`, `ORGANIZATION`, `USER`, `CUSTOM`; required for `CUSTOM` | Yes (`customResolverKey`) |
72
+
73
+ ### Match the declared scope to the iteration target
74
+
75
+ `ALL_ORGANIZATIONS` requires an `ORGANIZATION` seed;
76
+ `ALL_USERS` requires a `USER` seed. An `APPLICATION` seed cannot use
77
+ those strategies. The factory rejects that mismatch before dispatch.
78
+ Each selected organization or user becomes the corresponding dispatch scope.
79
+
80
+ `CUSTOM_RESOLVER` selects IDs while preserving the seed's declared scope
81
+ kind. For `CUSTOM`, the declared `relatedResourceType` is also carried into
82
+ dispatch. It is not a way to turn an application-scoped seed into an
83
+ organization-scoped seed, and it is forbidden for `GLOBAL` seeds.
78
84
 
79
85
  ### When to reach for `CUSTOM_RESOLVER`
80
86
 
@@ -88,14 +94,6 @@ built-in strategies can't express:
88
94
  "every user activated in the last 30 days". Express the filter
89
95
  in the resolver body; the dispatcher iterates the resolver's
90
96
  output.
91
- - **Cross-tenant orchestration** — when the seed needs to fan out
92
- beyond the host app's child set (e.g. a platform-level seed
93
- that needs to touch every app's data). Note: the engine cron
94
- batch runs per-app, so even a custom resolver is anchored to the
95
- host app's process. Cross-app orchestration is the deliberate
96
- out-of-scope case (use an external `CronJob` invoking the
97
- manual re-run endpoint instead — see
98
- [Decision 2](../SKILL.md#decision-2-re-run-a-seed-manually)).
99
97
 
100
98
  The resolver itself is registered on the module's
101
99
  `BackendDomainModule.dataSeedScopeResolvers?: Record<string,
@@ -103,29 +101,26 @@ DataSeedScopeResolver>` slot, alongside `seeds` and `operations`.
103
101
  The key in the record is what the seed's
104
102
  `schedule.customResolverKey` references; the value is a function
105
103
  that receives the dispatcher's exec context and returns
106
- `Promise<DataSeedScope[]>`.
104
+ `Promise<readonly { readonly relatedId: string }[]>`. The seed supplies the
105
+ scope kind (and custom resource type), not the resolver. A missing registry
106
+ key raises a configuration error captured in the batch report; a registered
107
+ resolver returning an empty array legitimately selects no scopes.
107
108
 
108
109
  ## Picking an engine tick
109
110
 
110
- The default `'* * * * *'` (every minute) is the safe-default — it
111
- honours every legal per-seed cron resolution. Override only when
112
- ALL of the following are true:
113
-
114
- 1. No registered seed in the corpus needs minute-level cadence.
115
- 2. The host process is constrained on either CPU (the per-tick
116
- evaluation iterates every registered seed and may invoke
117
- custom resolvers) or memory (each fan-out dispatch loads the
118
- target row's exec context).
119
- 3. You have audited the slowest per-seed cron and the chosen
120
- engine tick is at most as coarse as that seed's cron.
111
+ The default `* * * * *` evaluates every minute. Choose a coarser engine tick
112
+ only when the resulting delay and coalescing are acceptable for every seed.
113
+ Review the most time-sensitive seed, not just the slowest schedule.
121
114
 
122
- Common overrides:
115
+ | Engine tick | Operational choice |
116
+ |-------------|--------------------|
117
+ | `* * * * *` | Minute-level evaluation; default when any seed needs that responsiveness. |
118
+ | `*/5 * * * *` | Evaluate every five minutes. More frequent seed firings are coalesced. |
119
+ | `0 * * * *` | Hourly evaluation. Use only when hourly delay and coalescing are acceptable. |
123
120
 
124
- | Engine tick | Use when … |
125
- |-----------------|-------------------------------------------------------------------------|
126
- | `'* * * * *'` | Default. Some seed in the corpus runs every minute or you don't know. |
127
- | `'*/5 * * * *'` | Every registered seed runs at least every 5 minutes (hourly / daily). |
128
- | `'0 * * * *'` | Every registered seed runs at most hourly. Reduces tick churn ~60×. |
121
+ Do not choose a coarse tick to represent one invocation per occurrence of a
122
+ finer seed cron. This batch makes a due/not-due decision per seed and tick;
123
+ it does not count and replay the occurrences inside the window.
129
124
 
130
125
  ## Mode × schedule rejection (LAZY)
131
126
 
@@ -155,14 +150,12 @@ batch under
155
150
  strategy is anchored to the host app:
156
151
 
157
152
  - `ALL_APPLICATIONS` yields every `applications` row visible to
158
- the host app's repo (typically the host app itself plus its
159
- managed children, depending on the platform mode).
153
+ the host application context.
160
154
  - `ALL_ORGANIZATIONS` / `ALL_USERS` yields every org / user
161
155
  belonging to the host app.
162
- - `CUSTOM_RESOLVER` is whatever the resolver returns — it has the
163
- full exec context of the host app, so it can technically reach
164
- cross-tenant data, but the dispatcher's per-pass `DataSeedRun`
165
- row is still attributed to the host app's process.
156
+ - `CUSTOM_RESOLVER` receives the host application context and must
157
+ enumerate scopes accessible under that context. It does not grant
158
+ cross-application access.
166
159
 
167
160
  Cross-app fan-out (e.g. "fire this seed once per app in the entire
168
161
  deployment") is NOT a supported engine-cron mode. Use an external
@@ -15,9 +15,12 @@ the data-seeding subsystem:
15
15
  - **`DataSeedRunSchema`** + **`DataSeedRunStatus`** — the persisted
16
16
  ledger of every seed pass (Decision 3) plus its terminal-status
17
17
  enum.
18
- - **`runDataSeedingApplicationBootstrap`** — the single entry
19
- point that wires registries, Level-B hooks, LAZY guards, and the
20
- Level-A dispatch passes at app startup (Decision 5).
18
+ - **`wireDataSeedingDeclarations`** + **`runDataSeedingApplicationLifecyclePasses`**
19
+ — the two startup halves (Decision 5): the first registers seeds and wires
20
+ Level-B hooks and LAZY guards before the HTTP server listens, the second runs
21
+ the Level-A dispatch passes later. There is no one-call composite: calling both
22
+ after a server is already accepting requests would reopen the window in which a
23
+ request runs without its seed hooks.
21
24
 
22
25
  The cron schedule and iteration strategy are exported through the declared
23
26
  `@wildo-ai/saas-backend-lib/data-seeding-models` entrypoint. The remaining
@@ -488,7 +491,8 @@ fire / not fire / fire twice" investigations.
488
491
 
489
492
  ```typescript
490
493
  /**
491
- * Inputs to {@link runDataSeedingApplicationBootstrap}. Kept as a typed
494
+ * Inputs to the data-seeding bootstrap halves ({@link wireDataSeedingDeclarations},
495
+ * {@link runDataSeedingApplicationLifecyclePasses}). Kept as a typed
492
496
  * record (instead of positional args) so callers from different startup
493
497
  * orchestrators stay readable when the surface grows in later phases.
494
498
  */
@@ -551,10 +555,12 @@ export interface DataSeedApplicationBootstrapInput {
551
555
  }
552
556
 
553
557
  /**
554
- * Step 7.7 — register the seed corpus and (outside platform mode) dispatch
555
- * the application-lifecycle passes (`onAppInit` then `onAppVersionUpgrade`).
558
+ * The half of the bootstrap that must be live before ANY request can reach the services registry:
559
+ * register the seed corpus and the scope resolvers, then wire the Level-B resource-lifecycle hooks and
560
+ * the LAZY-access guards. Pure in-memory wiring — no read, no write, no remote call.
561
+ *
562
+ * ## Contract of the two halves, taken together
556
563
  *
557
- * Contract:
558
564
  * - Registration ALWAYS runs (even in platform mode) so future Level-B
559
565
  * and lazy-access dispatch paths can resolve seed declarations.
560
566
  * - Dispatcher is invoked twice in order: `onAppInit` MUST precede
@@ -583,24 +589,64 @@ export interface DataSeedApplicationBootstrapInput {
583
589
  * per resource type with internal route map.
584
590
  * 5. Platform-mode skip: dispatch is suppressed for the apps-manager
585
591
  * profile (it bootstraps tenant apps which run their own pass).
592
+ *
593
+ * ## Why it is its own step, and runs before the HTTP server listens
594
+ *
595
+ * The HTTP server starts listening inside Step 6, and this wiring used to run inside Step 7.7, after
596
+ * queue-worker initialization and an AWAITED cron-job sync. Every request in between reached a services
597
+ * registry with no seed hooks: an organization created then got none of its `afterCreate` defaults
598
+ * (SSO, SCIM, SIEM-export and webhook configuration singletons), silently and permanently, because a
599
+ * post-create hook that was not registered has nothing to retry. Measured 2026-09-14 on Your Application:
600
+ * the cron sync waited ~20 minutes on a platform that was not ready, the backend answered
601
+ * `/health/ready` 200 throughout, and every organization registered in that window had no
602
+ * `organizationSsoConfig` row.
603
+ *
604
+ * So the declarations are wired where the registry becomes reachable, and only the application-lifecycle
605
+ * passes ({@link runDataSeedingApplicationLifecyclePasses}) stay at Step 7.7.
586
606
  */
587
- export async function runDataSeedingApplicationBootstrap(
588
- input: DataSeedApplicationBootstrapInput,
589
- ): Promise<void> {
590
- const {
591
- dataSeeds,
592
- dataSeedScopeResolvers,
593
- isPlatformMode,
594
- logger,
595
- logDebug,
596
- registry,
597
- scopeResolverRegistry,
598
- dispatcher,
599
- servicesRegistry,
600
- } = input;
601
-
602
- const seeds = dataSeeds ?? [];
603
- logDebug('🌱 Registering data-seed definitions...', { count: seeds.length });
607
+ export function wireDataSeedingDeclarations(
608
+ input: Pick<
609
+ DataSeedApplicationBootstrapInput,
610
+ 'dataSeeds' | 'dataSeedScopeResolvers' | 'logDebug' | 'registry' | 'scopeResolverRegistry' | 'dispatcher' | 'servicesRegistry'
611
+ > & {
612
+ /**
613
+ * Whether this runtime owns the application's DATA LIFECYCLE, and therefore whether the
614
+ * framework's own seeds belong in its registry.
615
+ *
616
+ * Only the application backend does. A MINION or WORKER runs the same bootstrap with a SCOPED
617
+ * services registry that refuses unscoped writes, and registering a Level-B seed there makes
618
+ * `wireLevelBResourceLifecycleHooks` ask for exactly that access — measured 2026-09-18, when
619
+ * registering the engine's set unconditionally crash-looped the marketing-scrapper minion with
620
+ * `Minion 'marketingScrapper' is not allowed to write resource '<unscoped-registry-access>'`.
621
+ *
622
+ * The application's OWN `dataSeeds` are registered regardless, exactly as before: what an
623
+ * application passes is its business, and this flag governs only what the FRAMEWORK adds.
624
+ */
625
+ readonly registersEngineOwnedSeeds: boolean;
626
+ },
627
+ ): void {
628
+ const { dataSeeds, dataSeedScopeResolvers, logDebug, registry, scopeResolverRegistry, dispatcher, servicesRegistry, registersEngineOwnedSeeds } = input;
629
+
630
+ /*
631
+ * FRAMEWORK-owned seeds first, then the application's.
632
+ *
633
+ * These used to be the application's job: each one spread `enterpriseAuthConfigOrgSeedDefinitions`
634
+ * and its siblings into a module of its own, and an application that did not know to do so had no
635
+ * per-scope configuration rows at all — which is exactly what the newer dogfood application did,
636
+ * leaving every SSO / SCIM / SIEM settings panel answering a 404. The framework's own defaults for
637
+ * the framework's own resources are registered by the framework.
638
+ *
639
+ * Order matters only for the duplicate refusal below: registering the engine's set FIRST means an
640
+ * application that still spreads one of them fails naming the framework's key, which is the half
641
+ * of the collision a reader can act on.
642
+ */
643
+ const engineOwned = registersEngineOwnedSeeds ? ENGINE_OWNED_DATA_SEEDS : [];
644
+ const seeds = [...engineOwned, ...(dataSeeds ?? [])];
645
+ logDebug('🌱 Registering data-seed definitions...', {
646
+ count: seeds.length,
647
+ engineOwned: engineOwned.length,
648
+ applicationOwned: (dataSeeds ?? []).length,
649
+ });
604
650
  registry.registerSeeds(seeds);
605
651
  logDebug('✅ Data-seed registry populated');
606
652
 
@@ -631,6 +677,17 @@ export async function runDataSeedingApplicationBootstrap(
631
677
  // are per-tenant request hooks, the host running the Level-A pass
632
678
  // is irrelevant to their availability at request time).
633
679
  wireLazyAccessGuards({ registry, dispatcher, servicesRegistry, logDebug });
680
+ }
681
+
682
+ /**
683
+ * Step 7.7 — the application-lifecycle passes (`onAppInit`, then `onAppVersionUpgrade`, then the
684
+ * non-fatal missing-defaults repair). Requires {@link wireDataSeedingDeclarations} to have run: the
685
+ * dispatcher resolves seeds from the registry it populated. Skipped entirely in platform mode.
686
+ */
687
+ export async function runDataSeedingApplicationLifecyclePasses(
688
+ input: Pick<DataSeedApplicationBootstrapInput, 'isPlatformMode' | 'logger' | 'logDebug' | 'dispatcher'>,
689
+ ): Promise<void> {
690
+ const { isPlatformMode, logger, logDebug, dispatcher } = input;
634
691
 
635
692
  if (isPlatformMode) {
636
693
  logDebug('🌱 Skipping application-lifecycle data-seed dispatch in platform mode (tenant apps will run their own pass via apps-manager)');
@@ -658,5 +715,21 @@ export async function runDataSeedingApplicationBootstrap(
658
715
  logger.error('❌ Data-seed application-lifecycle pass failed (fatal):', error);
659
716
  throw error;
660
717
  }
718
+
719
+ // Missing-defaults repair (#554) — after both lifecycle passes, and NON-fatal, which is the opposite
720
+ // of the passes above on purpose. Those passes create rows downstream operations need, so booting
721
+ // without them is worse than not booting. This pass only completes rows that are already readable,
722
+ // and its per-seed failures are on the ledger and retried next boot; refusing to start over it
723
+ // would make a defaults gap into an outage.
724
+ try {
725
+ const repairReport = await dispatcher.repairMissingDefaultsOnLifecycleSeededRows();
726
+ logDebug('✅ Missing-defaults repair pass complete', {
727
+ repaired: repairReport.runs.length,
728
+ alreadyRepaired: repairReport.seedsAlreadyRepaired,
729
+ failedSeedKeys: repairReport.failedSeedKeys,
730
+ });
731
+ } catch (error) {
732
+ logger.error('❌ Missing-defaults repair pass failed (non-fatal — retried on the next boot):', error);
733
+ }
661
734
  }
662
735
  ```