@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
@@ -0,0 +1,172 @@
1
+ # Zone declaration — what one zone in a layout says about itself
2
+
3
+ Read this when authoring or changing a `NavigationLayout`'s `zones` block: what a zone does when its
4
+ last content is dismissed, how much of the zone a destination's content occupies, and the drag bounds
5
+ and responsive behaviour declared alongside them.
6
+
7
+ Read it especially before assuming a default. Three of these fields decide something only when a
8
+ SECOND zone exists, so a single-zone layout gives no feedback about whether they were understood.
9
+
10
+ ## Content width belongs to the ZONE, not to your template
11
+
12
+ Every structural zone wraps its content in a boundary that caps at the page-content width
13
+ (`--content-max-width`, 80rem by default) and centres anything wider. A detail pane is almost always
14
+ narrower than that, so in practice the content FILLS the pane — "full width, up to a maximum" — and no
15
+ component has to know how wide its pane is.
16
+
17
+ **Do not cap your own view.** A template that applies its own `max-w-*` and `mx-auto` produces a narrow
18
+ column floating inside a wide pane, and silently disagrees with the cap the zone already applies. If a
19
+ surface genuinely needs to exceed the page-content width — a wide table, a board — declare
20
+ `zoneContentMaxWidth: 'none'` on the operation or view instead.
21
+
22
+ `zoneContentFillsHeight` fills the HEIGHT as well, and is for PRIMARY only. An adjacent zone scrolls, so a
23
+ filling child there would cap at the pane's height and hide the rest; a canvas belongs in primary.
24
+
25
+ ## Import Origins
26
+
27
+ - `@wildo-ai/saas-models`
28
+
29
+ ## Source Excerpts
30
+
31
+ ### Origin Package: `@wildo-ai/saas-models`
32
+
33
+ ```typescript
34
+ *
35
+ * What happens when a zone's last content is dismissed.
36
+ * Only meaningful for secondary and companion zones (primary never empties,
37
+ * overlay auto-dismisses by definition).
38
+ */
39
+ export enum ZoneEmptyBehavior {
40
+ /**
41
+ * Zone hides, adjacent zones expand to fill the space.
42
+ * Example: closing the last detail → layout returns to list-only.
43
+ * This is the default for all non-primary zones.
44
+ */
45
+ COLLAPSE = 'collapse',
46
+ /**
47
+ * Zone stays visible with an empty-state placeholder.
48
+ * Example: "Select an item to view details" message. Keeps layout stable.
49
+ * Useful when the user frequently toggles between items.
50
+ */
51
+ EMPTY_STATE = 'emptyState',
52
+ }
53
+ ```
54
+
55
+ ### Origin Package: `@wildo-ai/saas-models`
56
+
57
+ ```typescript
58
+ *
59
+ * How much of its zone a DESTINATION's content occupies.
60
+ *
61
+ * The primary zone caps and centres its content at `var(--content-max-width, 80rem)` and gives it no
62
+ * definite-height ancestor. That is correct for almost everything a zone hosts — a form, a list, a
63
+ * settings page stretched across a 2560px monitor is unreadable — and wrong for content whose whole
64
+ * value is the space it occupies. Until this enum existed there was no way to tell the two apart, so
65
+ * a canvas had to hand-roll a viewport fraction (`h-[70vh]`), which sizes against the WINDOW rather
66
+ * than the container and therefore ignores whatever chrome sits above it.
67
+ *
68
+ * Declared per DESTINATION rather than per zone: the same primary zone hosts a list that wants the
69
+ * cap, a detail page that caps itself, and a graph that wants neither.
70
+ *
71
+ * Width and height are separable on purpose. A wide data table wants the cap gone and its natural
72
+ * height; collapsing both into one boolean would merge two meanings, and two independent booleans
73
+ * would make "full height, still capped at 80rem" representable — a combination nothing wants and
74
+ * someone would eventually author by accident.
75
+ */
76
+
77
+ /**
78
+ * Full zone configuration.
79
+ *
80
+ * Each declared zone in the layout owns its complete behavior:
81
+ * which transition fires for each operation, how content appears,
82
+ * and how the zone responds to viewport changes.
83
+ *
84
+ * Note: `minWidth`, `maxWidth`, `onEmpty` and `responsiveCollapse` are only meaningful for
85
+ * secondary and companion zones. Primary never collapses, never empties, and takes remaining space.
86
+ * Setting these on primary has no effect.
87
+ *
88
+ * ## Every field here is READ by the runtime, and that was checked rather than assumed (#211)
89
+ *
90
+ * | field | the reader |
91
+ * |---|---|
92
+ * | `contentModel` | `NavigationContentAreas.tsx` (TABBED detection) + `zone-visible-entry.ts` |
93
+ * | `transitions` | `navigation-policy-resolver.service.ts` |
94
+ * | `appearance` | `useNavigationController.ts` (`appearance.split`) + the policy resolver |
95
+ * | `minWidth` / `maxWidth` | `NavigationContentAreas.tsx` drag constraints, both split branches |
96
+ * | `onEmpty` | `zone-empty-behavior.ts` |
97
+ * | `responsiveCollapse` | `navigation-policy-resolver.service.ts` |
98
+ *
99
+ * `defaultVisible` was REMOVED by that audit: nothing read it, and its only documented meaning was
100
+ * "defaults to `true` when `split.autoSplit` is `true`" — a field defined in terms of another field
101
+ * that was also dead. What it was reaching for is `onEmpty`, which every current layout already uses
102
+ * (`zoneOccupiesSpaceWhenEmpty`) and which the runtime genuinely reads.
103
+ */
104
+ export const ZoneConfigSchema = z.object({
105
+ /**
106
+ * How this zone manages multiple items.
107
+ * - `NavigationZoneContentModel.SINGLE` (default): stack-based navigation. One item visible, back pops.
108
+ * - `NavigationZoneContentModel.TABBED`: parallel tabs. Tab bar visible, multiple items accessible.
109
+ * @default NavigationZoneContentModel.SINGLE
110
+ */
111
+ contentModel: z.enum(NavigationZoneContentModel).default(NavigationZoneContentModel.SINGLE),
112
+
113
+ /** Operation → transition mapping. Defines what happens for each user action in this zone. */
114
+ transitions: ZoneTransitionsSchema,
115
+
116
+ /** Transition → visual appearance. Only split and overlay have appearance choices. */
117
+ appearance: ZoneAppearanceSchema.optional(),
118
+
119
+ /**
120
+ * Minimum pixel width when resizing. Constrains how far this side of the
121
+ * split divider can be dragged. Only meaningful for secondary and companion zones, and only when
122
+ * that zone is resizable — `SplitConfigSchema.resizable` for secondary, `split.companion.resizable`
123
+ * for companion (independent flags).
124
+ *
125
+ * The pixel value is converted to a share of the content area and clamped to 5–70%. When OMITTED on
126
+ * a resizable zone the floor is 25% of the content area — or the zone's own ratio share, if that is
127
+ * smaller — never zero. A pane is never collapsed by dragging it: closing a pane is navigation.
128
+ *
129
+ * A declared `maxWidth` narrower than this floor lowers the floor to it. When the shown side panes ask
130
+ * for more than primary's 25% leaves, they shrink in proportion and none opens below its floor (a
131
+ * non-resizable pane's floor is 25%, or its own ratio share if smaller); primary opens at exactly 25%.
132
+ * The floors are pixels, so at a narrow window they may not fit together at all — they then give way
133
+ * to each other in proportion, and the smaller floor a pane opens at is its drag floor. Primary never
134
+ * gives way.
135
+ */
136
+ minWidth: z.number().positive().optional(),
137
+
138
+ /**
139
+ * Maximum pixel width when resizing. Constrains how far this side of the
140
+ * split divider can be dragged. Only meaningful for secondary and companion zones, and only when
141
+ * that zone is resizable — `SplitConfigSchema.resizable` for secondary, `split.companion.resizable`
142
+ * for companion (independent flags).
143
+ *
144
+ * The pixel value is converted to a share of the content area and clamped to 5–70%. When OMITTED on
145
+ * a resizable zone the ceiling is whatever leaves the primary zone 25% of the content area.
146
+ */
147
+ maxWidth: z.number().positive().optional(),
148
+
149
+ /**
150
+ * What happens when this zone's last content is dismissed (stack empty, last tab closed).
151
+ * - `ZoneEmptyBehavior.COLLAPSE` (default): zone hides, adjacent zones expand to fill.
152
+ * - `ZoneEmptyBehavior.EMPTY_STATE`: zone stays visible with placeholder ("Select an item to view details").
153
+ * Only meaningful for secondary and companion zones. Primary never empties.
154
+ */
155
+ onEmpty: z.enum(ZoneEmptyBehavior).optional(),
156
+
157
+ /**
158
+ * Responsive collapse rules: what happens when viewport shrinks below the zone's breakpoint.
159
+ * Accepts a plain `ResponsiveCollapseMode` (all breakpoints) or viewport-discriminated object.
160
+ * Only meaningful for secondary and companion zones. Primary never collapses.
161
+ *
162
+ * When viewport grows back past the breakpoint, collapsed content migrates back
163
+ * to its original zone (content is preserved).
164
+ *
165
+ * @example
166
+ * responsiveCollapse: ResponsiveCollapseMode.PUSH // always push into primary
167
+ * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY } // tablet: push, mobile: overlay
168
+ */
169
+ responsiveCollapse: viewportDiscriminatedSchema(z.enum(ResponsiveCollapseMode)).optional(),
170
+ });
171
+ export type ZoneConfig = z.infer<typeof ZoneConfigSchema>;
172
+ ```
@@ -0,0 +1,146 @@
1
+ # How a navigation decision is actually made
2
+
3
+ Everything below is the runtime's behaviour, not a convention. Read it before writing a layout, and
4
+ again before concluding that a layout is being ignored.
5
+
6
+ ## One event, ordered policy, first answer wins
7
+
8
+ The transition preference comes from the first tier that answers:
9
+
10
+ 1. **The operation's own override** — `navigationOverrides`, matched on source zone and viewport.
11
+ 2. **Authored action presentation** — an explicit operation presentation outranks broader defaults.
12
+ 3. **The relationship transition** — the declared relationship-specific move.
13
+ 4. **The viewport block** — mobile/tablet transition overrides.
14
+ 5. **The source configuration's transition map** — the zone or launch context the action comes from.
15
+ 6. **Derived action presentation** — the framework's inferred presentation, used only after authored policy.
16
+ 7. **The framework fallback.**
17
+
18
+ The resolver then applies destination rules, including embedded-surface restrictions and depth/collapse
19
+ policies. A selected transition preference alone does not guarantee the final page or overlay outcome.
20
+
21
+ **A higher tier silently outranks a lower one.** If a layout change appears to do nothing, look UP the
22
+ chain before doubting the layout: an operation-level override answers before any zone map does.
23
+
24
+ ## Where each verb puts the content
25
+
26
+ | verb | lands in | keeps the source visible |
27
+ |---|---|---|
28
+ | `push` / `replace` | the SAME zone | no — one item is visible at a time |
29
+ | `split` | the first adjacent zone (secondary, else companion) | yes — this is the list-detail pattern |
30
+ | `overlay` | the overlay layer | yes, visually; interactivity depends on the overlay's behaviour |
31
+ | `promote` | PRIMARY, clearing secondary and companion | no — it abandons the current context deliberately |
32
+ | `inplace` | nowhere — it transforms an element and changes no zone | |
33
+
34
+ `split` needs an adjacent zone to exist in the layout. If none is declared it escalates to an overlay
35
+ rather than failing, so a layout that "does not split" is usually a layout with one zone.
36
+
37
+ ## The URL contract, which decides more than it looks like it does
38
+
39
+ **Structural zones are URL-addressed. The overlay layer is not.**
40
+
41
+ Content in primary, secondary or companion gets a browser URL when its operation is `ADDRESSABLE`, so
42
+ it is linkable, survives a reload, and takes part in browser back and forward. Content in an overlay
43
+ does not: it is a transient layer above the addressed surface.
44
+
45
+ This is the trade behind choosing `overlay` for a detail. A sheet that floats over a canvas costs the
46
+ selection its URL — the reader cannot link a colleague to it, and back does not step through
47
+ selections. That may be the right trade; it should be a decision rather than a discovery.
48
+
49
+ **Which zone owns the URL depends on what is in primary.** Beside a RESOURCE primary the detail owns
50
+ it: a list's detail URL implies the list, so `/tasks/t1` reloads as list + detail. Beside anything
51
+ else — a composite view, a custom view, a chart, an engine page — the PRIMARY keeps the URL and the
52
+ detail rides as a `pane` query parameter: `/composite/board?section=runs&pane=%2Ftasks%2Ft1`. A reload
53
+ restores both; browser back closes the pane; the host's own query params (`?section=`) keep working
54
+ while the pane is open. Nothing to declare: the split transition on the zone is enough, and the
55
+ composition is chosen from what primary holds at the moment of the click.
56
+
57
+ **Query params that are not addresses are view state.** Route ownership compares destinations, not
58
+ URL strings: a view that writes `?section=` or `?dataMode=` onto its own URL keeps its zone entry (no
59
+ rebuild, no remount). Only the framework's context params (`composite_ctx_*`, `chart_ctx_*`,
60
+ `execution_ctx_*`), a chart route's url-param values and `pane` are part of the address.
61
+
62
+ ## What a layout declares that the runtime does NOT yet read
63
+
64
+ **Nothing — this list is empty, and that is the point of keeping the heading.**
65
+
66
+ `ZoneConfig.defaultVisible`, `SplitConfig.autoSplit` and `CompanionSplitConfig.orientation` were
67
+ here, and #211 removed all three from the schema rather than leaving a field that answers with
68
+ silence. `contentModel` and `maxDepth` left this list the other way, by becoming live — see the
69
+ section below.
70
+
71
+ A split layout still does not pre-open its secondary zone: it appears when something targets it, and
72
+ reappears on a deep link because URL restoration places the detail there and the list beside it.
73
+
74
+ Everything in `ZoneConfig`, `SplitConfig` and `NavigationLayout` is live.
75
+
76
+ ## Three behaviours that became live on 2026-09-08
77
+
78
+ `contentModel`, `maxDepth` and the applied half of `responsiveCollapse` were all declared, documented
79
+ and validated while no renderer read them. If you are reading older guidance that calls any of them
80
+ inert, it is stale.
81
+
82
+ - **`ZoneConfig.contentModel: TABBED` renders parallel tabs.** Every entry in the zone is a tab, all
83
+ stay mounted (so switching refetches nothing), the tab bar is visible, and the ACTIVE tab shows
84
+ rather than the top of the stack. A tabbed zone is FLAT: depth navigation from inside a tab goes to
85
+ the next zone or to an overlay. Only the active tab is URL-addressable today, so a refresh restores
86
+ one tab.
87
+ - **`NavigationLayout.maxDepth` caps push depth.** When the target zone's depth REACHES it, the push
88
+ becomes an overlay. A relationship's own `maxDepth` overrides the layout's for that chain. The
89
+ ceiling is measured against the zone the content actually lands in — so a split that collapsed into
90
+ primary answers to primary's ceiling.
91
+ - **`ZoneConfig.responsiveCollapse` places content.** Below the breakpoint a secondary or companion
92
+ zone's content goes into PRIMARY (`PUSH`) or over it (`OVERLAY`), and it remembers which zone it
93
+ came from. **Declaring nothing means `PUSH`**: the content areas render a single zone on a phone, so
94
+ an undeclared zone would silently swallow anything routed to it. Collapse applies only at a known
95
+ narrow breakpoint — an unmeasured viewport is not a narrow one.
96
+
97
+ ## Three behaviours that read backwards from their field names
98
+
99
+ - **`orientation` names the DIVIDER.** `VERTICAL` is a vertical divider, so the panes sit SIDE BY SIDE;
100
+ `HORIZONTAL` puts the second pane below. This is the opposite of what most panel libraries mean by
101
+ "direction".
102
+ - **No pane collapses on a drag, and an undeclared bound is not "unbounded".** On a resizable zone
103
+ (`split.resizable` for secondary, `split.companion.resizable` for companion — independent flags),
104
+ `minWidth`/`maxWidth` are converted to a share of the content area and clamped to 5–70%. An
105
+ undeclared `minWidth` is a 25% floor (or the zone's own ratio share, if smaller); an undeclared
106
+ `maxWidth` leaves primary its 25%. A non-resizable zone is frozen at its ratio. A pane dragged out of
107
+ sight used to keep owning the URL and reopen invisible, which is why closing is navigation, never a drag.
108
+ A declared `maxWidth` narrower than the floor lowers the floor to it.
109
+ - **Side panes that do not fit beside primary shrink to their floors, and then the floors give way.**
110
+ When the shown panes' shares total more than 75%, each shrinks in proportion and none opens below its
111
+ floor (a non-resizable pane's floor is 25%, or its ratio share if smaller); primary opens at exactly
112
+ 25%. Because floors are pixels, at a narrow window they may not fit together at all; they then give
113
+ way to each other in proportion, and the smaller share a pane opens at becomes its drag floor. Primary
114
+ never gives way: its 25% is what keeps the page the panes were opened from on screen. Panes shrunk this
115
+ way open at whole percents (a fractional floor rounds up to the next one), and the layout always totals 100%.
116
+ - **`ratio` is a percentage and the bounds are pixels**, so they agree at one container width only.
117
+ Below the crossover the opening size is clamped up to the floor rather than honouring the ratio.
118
+
119
+ ## Content width is the ZONE's decision
120
+
121
+ Every structural zone caps its content at the page-content width and centres anything wider; a detail
122
+ pane is almost always narrower than that, so content fills it. A view that applies its own `max-w-*`
123
+ and `mx-auto` fights this and produces a narrow column inside a wide pane. Declare
124
+ `zoneContentMaxWidth: 'none'` if content must exceed the cap, and `zoneContentFillsHeight` — primary only — if it must fill the
125
+ height too.
126
+
127
+ ## An UNRESOLVED destination decides nothing
128
+
129
+ `onEmpty` and `adjacentZoneOnEmpty` resolve from whatever occupies PRIMARY, and during a page or tab
130
+ change there is a moment when primary's stack has not been reconciled from the URL yet. In that moment
131
+ the destination override is absent — and an absent override is not a destination saying "collapse", it
132
+ is a question nobody has answered.
133
+
134
+ **The engine treats it as a question.** A zone reserves space when empty only once the destination is
135
+ known; until then no structure changes. A zone that HAS content still shows it immediately — having
136
+ content is a fact about the zone, not a decision owned by primary.
137
+
138
+ The consequence for an application: `onEmpty: EMPTY_STATE` on a zone whose destinations override it
139
+ with `COLLAPSE` no longer flashes a reserved pane on every navigation. Measured before the fix on a
140
+ 2400px window: the primary content area went 2312 → 1294 → 2312 within ~25ms on each tab click, so the
141
+ page jumped left and back.
142
+
143
+ **You still want the zone-level value to be the one most destinations want.** The gate removes the
144
+ flash, not the disagreement: every destination that overrides the zone still pays a real layout change
145
+ when it resolves. If most of a layout's destinations collapse, declare `COLLAPSE` on the zone and let
146
+ the list-style destinations declare `EMPTY_STATE`.
@@ -0,0 +1,141 @@
1
+ # Everything an application can configure about navigation, and where to declare it
2
+
3
+ Navigation is configured at FOUR levels, and choosing the wrong level is the most common mistake:
4
+ a rule written at the layout level applies to the whole application, and one written on an operation
5
+ applies to that operation only and outranks the layout.
6
+
7
+ | level | file / surface | scope of what you declare |
8
+ |---|---|---|
9
+ | **Application layout** | `navigationLayout` in the frontend config | every zone, every operation, the whole app |
10
+ | **Zone** | `layout.zones.<zone>` | one zone's behaviour, for every destination that uses it |
11
+ | **Destination (view)** | a composite view's authoring config | one view's relationship to the zone it occupies |
12
+ | **Destination (operation)** | `navigationOverrides` in `resourceUIBehavior(...).views` | one operation, resolved BEFORE the layout |
13
+
14
+ Read `how-navigation-resolves.md` for the precedence between them. This file is the inventory.
15
+
16
+ ---
17
+
18
+ ## 1. Application layout — `navigationLayout`
19
+
20
+ | field | what it decides | status |
21
+ |---|---|---|
22
+ | `zones.primary` | the always-present zone. Required. | live |
23
+ | `zones.secondary` | the first adjacent zone. Declaring it is what makes `split` possible at all. | live |
24
+ | `zones.companion` | a second adjacent zone for persistent side content. | live |
25
+ | `appLevel.transitions` | what a SIDEBAR / command-palette / hotkey navigation does. App-level navigation is a layout reset. | live |
26
+ | `appLevel.appearance` | appearance for app-level transitions. | live |
27
+ | `fromOverlay.transitions` | what a navigation STARTED INSIDE an overlay does. | live |
28
+ | `split` | inter-zone geometry — see §3. | live |
29
+ | `backAffordanceOwner` | `SURFACE` (the back control sits in the surface's own header) or `SHELL` (one fixed control in the app shell). One application-wide decision, so the duplication is unrepresentable. | live |
30
+ | `maxDepth` | the push ceiling. When a zone's stack depth REACHES it, the next push opens an overlay instead. A relationship's own `maxDepth` overrides it for that chain. | live |
31
+ | `[MOBILE]` / `[VERT_TABLET]` blocks | sweeping per-viewport transition overrides, merged over zone defaults. | live |
32
+
33
+ ## 2. Zone — `layout.zones.<zone>`
34
+
35
+ | field | what it decides | status |
36
+ |---|---|---|
37
+ | `transitions` | operation → verb, FROM this zone. The ordinary way navigation is configured. | live |
38
+ | `appearance.split` / `appearance.overlay` | which shape a `split` or `overlay` from this zone takes (`PANEL`/`DRAWER`, `DIALOG`/`SHEET`/`DRAWER`). Viewport-discriminable. | live |
39
+ | `onEmpty` | `COLLAPSE` (zone hides, neighbours expand) or `EMPTY_STATE` (zone stays with a placeholder). Adjacent zones only. | live |
40
+ | `minWidth` / `maxWidth` | drag bounds in pixels, converted to a share of the content area and clamped to 5–70%. Only meaningful on a resizable zone — `split.resizable` for secondary, `split.companion.resizable` for companion. **Omitting one is not "unbounded"**: an undeclared `minWidth` is a 25% floor (or the zone's ratio share, if smaller) and an undeclared `maxWidth` leaves primary 25%. No pane collapses on a drag — see `how-navigation-resolves.md`. | live |
41
+ | `responsiveCollapse` | below the breakpoint, does this zone's content `PUSH` into primary or `OVERLAY` on top. Viewport-discriminable. **Omitting it means `PUSH`** — the content areas render one zone on a phone, so a zone that declares nothing would swallow anything routed to it. | live |
42
+ | `contentModel` | `SINGLE` (top of the stack is visible, back pops) or `TABBED` (every entry is a parallel tab, tab bar visible, the ACTIVE one shows). A tabbed zone is FLAT: depth navigation from inside a tab goes to the next zone or an overlay. | live |
43
+
44
+ Every field above is read by the runtime. `defaultVisible` was on this table as **NOT READ** and was
45
+ removed from the schema in #211 — what it reached for is `onEmpty`, which is live and which every
46
+ current layout uses.
47
+
48
+ ## 3. Split geometry — `layout.split` (and `split.companion`)
49
+
50
+ | field | what it decides | status |
51
+ |---|---|---|
52
+ | `ratio` | `[primary, adjacent]` percentages at open. | live |
53
+ | `orientation` | the DIVIDER's orientation: `VERTICAL` → side by side, `HORIZONTAL` → the second pane below. | live |
54
+ | `resizable` | whether the divider can be dragged. **`false` also makes `minWidth`/`maxWidth` inert**, because a static split has no drag to bound. | live |
55
+ | `companion` | `ratio` and `resizable` again, for the companion zone. It does NOT take its own `orientation`: all zones share one panel group, whose direction comes from `split.orientation`. | live |
56
+
57
+ Every field above is read by the runtime. Two were removed from the schema in #211 because nothing
58
+ read them: `autoSplit` ("pre-open the adjacent zone on first load" — a split layout still does not,
59
+ and a deep link restores the detail beside its list without it), and `companion.orientation` (it
60
+ claimed a companion could sit BELOW the main area; honouring that needs a nested panel group, so the
61
+ field comes back when something reads it).
62
+
63
+ ## 4. Destination — per view
64
+
65
+ On a composite view's authoring config:
66
+
67
+ | field | what it decides |
68
+ |---|---|
69
+ | `adjacentZoneOnEmpty` | overrides the ZONE's `onEmpty` while this view occupies primary. A list wants its detail pane to persist; a canvas wants its width back. One zone, two destinations that disagree. |
70
+ | `zoneContentMaxWidth` | The width cap, in the shared `ResponsiveMaxWidth` vocabulary. Omitted is `'content'` (the page-content cap); `'none'` lets a board or wide table exceed it. |
71
+ | `zoneContentFillsHeight` | Whether the content fills the zone's height too — for a canvas with no intrinsic height. PRIMARY only, because an adjacent zone scrolls. |
72
+
73
+ ## 5. Destination — per operation
74
+
75
+ In `resourceUIBehavior(...)`, on a `views` entry:
76
+
77
+ | field | what it decides |
78
+ |---|---|
79
+ | `surface` | `ADDRESSABLE` (a routable page — required for a URL), `EMBEDDED` (renders inside a host, no route of its own), `API_ONLY` (headless). Navigation cannot address an operation that is not `ADDRESSABLE`. |
80
+ | `navigationOverrides[]` | the EXCEPTION. `transition`, `appearance`, `overlayBehavior`, narrowed by `fromZone` and `viewport`. First match wins, resolved ahead of the zone's map. |
81
+ | `adjacentZoneOnEmpty` / `zoneContentMaxWidth` / `zoneContentFillsHeight` | as §4, for a resource operation rather than a view. |
82
+
83
+ ### Overlay behaviour — `navigationOverrides[].overlayBehavior`
84
+
85
+ Three independent questions, and a companion panel needs all three answered:
86
+
87
+ | field | default | set it to `false` when |
88
+ |---|---|---|
89
+ | `modal` | `true` | the reader must keep working the surface behind — a detail beside a live canvas |
90
+ | `closeOnOutsideClick` | `true` | touching that surface must not dismiss. Required alongside `modal: false`: the primitive dismisses on outside pointer-down even when non-modal, so the first drag would close it |
91
+ | `showBackdrop` | `true` | the surface behind must not look DISABLED. A dimmed canvas contradicts an interactive one |
92
+
93
+ ## 6. Transition modifiers — `TransitionConfig`
94
+
95
+ A transition is either a bare verb or an object with one modifier:
96
+
97
+ | modifier | valid on | effect |
98
+ |---|---|---|
99
+ | `persistent` | `split` only | the zone survives the source navigating away, and targets COMPANION specifically rather than the default adjacent resolution. A thread panel that stays open across channels. |
100
+ | `ephemeral` | `overlay` only | auto-closes when the source zone's stack changes. A quick-inspect preview that dismisses when another item is clicked. |
101
+
102
+ `persistent` and `ephemeral` are mutually exclusive; `inplace` and `promote` accept neither.
103
+
104
+ ---
105
+
106
+ ## Width is a CHAIN of three caps — read `framework-content-width-api.md` before changing any of them
107
+
108
+ A surface that will not fill the space it was given is almost always one of three caps, applied in
109
+ sequence and owned by three different parties:
110
+
111
+ | # | Cap | Declared by |
112
+ |---|---|---|
113
+ | 1 | the zone's content boundary (page-content width) | `zoneContentMaxWidth` on the destination |
114
+ | 2 | the pane, in an adjacent zone | `ratio` / `minWidth` / `maxWidth`, plus the reader's drag |
115
+ | 3 | the reading measure inside a layout root (~42rem) | `responsiveMaxWidth` on the display or form template |
116
+
117
+ **Fixing the wrong one changes nothing visible**, because a tighter cap is still underneath — which is
118
+ exactly how this was diagnosed three times before it was measured. Read the whole chain in the browser
119
+ before deciding which level owns your case.
120
+
121
+ One behaviour in the chain is a RULE rather than a declaration, because the application has already
122
+ stated its intent: **a record surface's reading measure applies in PRIMARY and not in an adjacent
123
+ zone.** An adjacent pane is already narrow by construction — cap 2 is the application's own statement
124
+ of how wide it should be — so a further cap there cannot improve readability and only leaves a strip
125
+ the reader cannot reclaim by dragging.
126
+
127
+ And in every case: **do not set your own `max-w-*`.** It is a fourth cap, invisible to everything
128
+ above, and it disagrees with the zone the moment a pane is resized.
129
+
130
+ ## Choosing a level — the test
131
+
132
+ Ask **who disagrees**.
133
+
134
+ - Every destination behaves this way → the **zone**.
135
+ - Every zone behaves this way → the **layout**.
136
+ - One destination disagrees with the application it lives in → that **destination**.
137
+ - It only differs on small screens → a **viewport** discriminator, at whichever level above.
138
+
139
+ If the answer is "just this one view, and I cannot express it", that is the signal to reach for
140
+ `navigationOverrides` — not for component state. A selection held in `useState` and rendered as a local
141
+ panel looks identical and has no URL, no back, no zone semantics and no responsive collapse.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: config-saas
3
- description: Edit `wildo.saas.config.ts` for modules, services, engineCapabilities, provider scopes, providerConfigurations, bootstrap, and data-service prefixes. Use when the user says "add the <module-name> module", "wire a new minion/worker", "enable the <capability> capability", "switch the email provider to <x>", "turn on billing/organizations", or any change at the SaaS root that re-shapes app composition rather than touching a single resource.
3
+ description: Edit `wildo.saas.config.ts` for modules, services, engineCapabilities, provider scopes, providerConfigurations, bootstrap, data-service prefixes, and the application's compliance declarations. Use when the user says "add the <module-name> module", "wire a new minion/worker", "enable the <capability> capability", "switch the email provider to <x>", "turn on billing/organizations", "record our legal entity", "declare which jurisdictions we operate in", "set the retention schedule", or any change at the SaaS root that re-shapes app composition or states what is legally true of the application.
4
4
  ---
5
5
 
6
6
  # Config SaaS
@@ -47,6 +47,9 @@ this file as ground truth — the only place where the app declares
47
47
  - Switching runtime provider scope or provider-specific non-secret config
48
48
  - Adding a new minion / worker / library
49
49
  - Changing data-service prefixes (mongodb / redis / rabbitmq / s3)
50
+ - Declaring the application's legal posture — the operating entity, the jurisdictions it
51
+ operates in, the retention schedule, the AI-use posture, client storage, or per-provider
52
+ compliance choices (see `references/compliance-declarations.md`)
50
53
 
51
54
  ## When NOT to Use
52
55
 
@@ -73,7 +76,7 @@ entries for shape; rely on TypeScript to validate keys.
73
76
 
74
77
  `wildo.saas.config.ts` declares the application topology: services, modules,
75
78
  libraries, workers, minions, engine capabilities, provider scopes, and the `specifications` package
76
- path. The `specifications/` package carries the semantic-delta layer that
79
+ path. The `specifications/` package carries the specification layer that
77
80
  explains what that topology means.
78
81
 
79
82
  When you change `wildo.saas.config.ts` or infrastructure config files, update
@@ -128,18 +131,49 @@ What earns its place:
128
131
  - `engineCapabilities` is keyed by `EngineCapability.*` (a typed enum).
129
132
  It declares SaaS/framework activation and runtime needs only. Provider
130
133
  behavior and end-user entitlements are separate vocabularies.
131
- - `providerConfigurations` stores provider-specific protocol config, but
132
- never secret values.
133
- - `providers: defineSaaSProviders({ scopes })` declares which providers
134
- are visible to backend, companion, frontend services, minions, and
135
- workers. Provider ordering lives in explicit `selection` policies, not
136
- object key order.
134
+ - `providerConfigurations` stores provider-specific protocol config that is
135
+ the SAME in every environment — application policy such as a coding-agent
136
+ execution profile — and never secret values. A value a vendor issued against
137
+ one deployment (an OAuth client ID bound to that environment's redirect URI,
138
+ a frontend SDK DSN or site key) does NOT belong here: author it in
139
+ `infrastructure/<env>/wildo.infra.<env>.config.ts > providerConfigurations`,
140
+ which is laid over this block key by key for that environment. Written here,
141
+ one environment's identifier reaches every environment (see the
142
+ `infra-environment-config` skill).
143
+ - `providers: defineSaaSProviders({ scopes })` declares, per runtime,
144
+ which providers that runtime may use — backend, companion, frontend
145
+ services, each minion, each worker. Provider ordering lives in explicit
146
+ `selection` policies, not object key order.
147
+
148
+ **A scope decides SECRET DELIVERY, not merely visibility.** A runtime
149
+ receives the environment variables of the providers ITS OWN scope lists
150
+ and no others: a minion scoped to `openai` does not receive the
151
+ application's Stripe key, and a worker whose scope is `providers: {}`
152
+ receives no provider credential at all. That boundary is enforced
153
+ everywhere the runtime's environment is produced — its generated `.env`
154
+ and its deployed secret alike.
155
+
156
+ **It also decides whether that runtime's telemetry is authenticated**,
157
+ and this is the case authors miss, because nothing in the runtime's own
158
+ code names the provider. The OTLP exporter's auth header is composed
159
+ from the selected `OBSERVABILITY_TELEMETRY` provider's token, and that
160
+ token is a provider secret like any other — so a runtime that does not
161
+ list the provider still exports telemetry, just UNAUTHENTICATED: the
162
+ endpoint and `OTEL_ENABLED` are unaffected, only the auth header is
163
+ absent. Against an ingest that requires that header, the export is
164
+ rejected at the far end. Nothing in the application refuses and nothing
165
+ warns — the traces simply never arrive, and the runtime looks healthy.
137
166
  - `EMAIL_TRANSACTIONAL` is the single backend selection for transactional
138
167
  mail. Token-bearing durable intents use the same provider route and recover
139
168
  at-least-once; provider-native idempotency may reduce duplicates but is not
140
169
  a framework correctness prerequisite.
141
170
  - `bootstrap.firstAdmin.userTypes` lists the user types eligible to
142
171
  bootstrap the first admin — runtime reads this on first install.
172
+ Application-wide grant-controlled reads also require a different application
173
+ super-administrator to approve the request. The approving identity belongs in
174
+ the selected environment secrets (`approver`), not this bootstrap declaration.
175
+ See `local-environment-bootstrap` for fresh-local derivation, explicit non-local
176
+ credentials and provisioning an existing environment without rotating secrets.
143
177
  - `dataServices` is the **single declaration point** for prefixes /
144
178
  vhosts / bucket prefixes. Backend connection strings are derived
145
179
  from these by the platform; never hard-coded elsewhere.
@@ -155,18 +189,32 @@ What is **not** in this block (and shouldn't be):
155
189
 
156
190
  ## References
157
191
 
192
+ - `references/framework-background-work-api.md` — scheduled batches, queued jobs, workers and minions: where each runs, and why scaling job processing means scaling the backend
193
+ - `references/framework-capability-resolution-api.md` — `SELECT_ONE` vs `FAN_OUT`, and why `whenUnavailable` is not failover: nothing retries a second provider when a call to the first one fails
194
+ - `references/framework-connection-target-credentials.md` — which third-party identity a provider call acts as, how a tenant supplies its OWN credential, and why nothing is ever substituted for a missing one
195
+ - `references/framework-content-security-policy-api.md` — the `csp` block on any frontend: opt-in by absence, the generated artifact is the only one read, and why report-only without a collector does nothing
196
+ - `references/framework-value-moments-api.md` — `analytics.valueMoments`: why `role` changes three things at once, and why a declared moment with analytics off is evaluated by nothing
197
+ - `references/framework-audit-trail-config-api.md` — the `auditTrail` block: why `archiveAfterDays` is the opt-in and why setting it never shrinks the primary store
198
+ - `references/framework-systems-of-record-api.md` — `systemsOfRecord`: declaring a deployment your application reads its OWN rows out of, why it is not a provider, and the three files its name, address and credential live in
158
199
  - `references/saas-config-scope.md` — what belongs in root SaaS config
159
200
  - `references/framework-wildo-saas-config-api.md` — `WildoSaasConfigSchema` / inferred types
160
201
  - `references/framework-provider-capabilities-api.md` — engine slots and provider capability vocabulary, including durable email selection
202
+ - `references/compliance-declarations.md` — the six compliance declarations, and why an ABSENT one is never a negative answer
161
203
 
162
204
  ## Verification
163
205
 
164
206
  - [ ] Config typechecks against `WildoSaasConfigSchema` (TS, not just runtime)
165
207
  - [ ] Every key in `modules` has a matching folder under `shared-lib/src/modules/`
166
208
  - [ ] Every key in `minions` / `workers` has a matching `path` directory
167
- - [ ] Every provider used by a runtime scope has a matching declaration in `providers.scopes`
209
+ - [ ] Every provider a runtime uses has a matching declaration in that runtime's own
210
+ `providers.scopes` entry — including providers its code never names (see the next line)
211
+ - [ ] Every runtime that should export AUTHENTICATED telemetry lists the provider selected for
212
+ `EngineCapability.OBSERVABILITY_TELEMETRY` in its own scope — the backend, the companion,
213
+ and each minion and worker that should be traceable
168
214
  - [ ] `services` keys referenced by `modules[*].services` actually exist in `services`
169
215
  - [ ] Companion sees the updated module list (re-run companion introspection)
216
+ - [ ] No compliance declaration carries an invented value — every one is either the operator's
217
+ own answer or absent (absent is reported as an open gap; invented is published as fact)
170
218
 
171
219
  ### Grep invariants
172
220
 
@@ -179,11 +227,21 @@ Run from the app root:
179
227
  | **Module entries ↔ module folders agree** (must return empty) | `comm -3 <(rg -oN "^\s+'\K[a-z-]+(?='\s*:\s*\{)" wildo.saas.config.ts \| sort -u) <(ls -1 shared-lib/src/modules/ \| sort -u)` |
180
228
  | Minion / worker paths exist | `rg -oN "path:\s+'\K[^']+" wildo.saas.config.ts \| while read p; do test -d "$p" \|\| echo "MISSING: $p"; done` |
181
229
  | Each engine capability declares `enabled:` | `rg -n "EngineCapability\.[A-Z_]+\]:\s*\{" wildo.saas.config.ts \| wc -l` then `rg -c "enabled:" wildo.saas.config.ts` |
230
+ | **No placeholder in a compliance declaration** (must return empty) | `rg -n "TODO\|TBD\|PLACEHOLDER\|example\.com\|Acme" wildo.saas.config.ts` |
231
+ | Which provider is selected for telemetry | `rg -n "OBSERVABILITY_TELEMETRY\]:\s*\{" -A2 wildo.saas.config.ts` |
232
+ | **Which runtimes declare it** (compare against the runtimes that should be traceable) | `rg -n "^\s+<telemetryProviderRef>:\s*\{" wildo.saas.config.ts` |
182
233
 
183
234
  The third invariant (modules ↔ folders) is the high-signal one — a
184
235
  module declared in config without a matching folder breaks `pnpm dev`
185
236
  silently in some pipelines and blocks others on startup.
186
237
 
238
+ The last two are a READ, not a pass/fail: substitute the ref the first
239
+ returns into the second, then compare the runtimes it lists against the
240
+ runtimes you expect to be traceable. No command can decide which of your
241
+ minions should emit authenticated telemetry — but the asymmetry is
242
+ invisible until you put the two lists side by side, and the cost of
243
+ missing it does not appear until a token is provisioned.
244
+
187
245
  ## Common Rationalizations
188
246
 
189
247
  | Rationalization | Reality |
@@ -192,6 +250,12 @@ silently in some pipelines and blocks others on startup.
192
250
  | "Inline the AI provider key here" | Provider secrets MUST stay in secrets/env. Config only declares **policy** (which providers are allowed); the credentials sit in `wildo-secrets` or env. |
193
251
  | "Skip `dataServices.*` prefixes — defaults work" | Defaults collide across apps in shared infra; the prefix declaration is what isolates state per app/environment. |
194
252
  | "I'll add a new key not in the schema, the framework will pick it up" | The schema is the contract — unknown keys are dropped or error. Add the field through the framework first if a new dimension is needed. |
253
+ | "Put a placeholder entity name in now and fix it later" | A produced document quotes it as fact. An absent declaration is reported as an open gap a reader can see; an invented one is published. Leave it out. |
254
+ | "The identity needs every field, so I'll wait until I have them all" | Every part is independently declarable — record the half you know. Waiting is how the answer ends up edited into a document that a regeneration then replaces. |
255
+ | "This worker never calls the telemetry provider, so it does not need to declare it" | Its code does not, and its exporter does. The auth header is composed from that provider's secret, and a scope that omits the provider withholds the secret — so the worker exports unauthenticated, and an ingest that requires the header rejects it. Declare the provider in every runtime that should be traceable. |
256
+ | "Telemetry is infrastructure, so it is exempt from the provider scopes" | There is no exemption. A telemetry token is a provider credential and travels the same path as an API key; a runtime holds the credentials its own scope lists and no others. The alternative — every runtime silently holding the token — is the boundary the scope exists to draw. |
257
+ | "No `operatingJurisdictions` means the app is domestic-only" | Absent means nobody answered. It is not a jurisdiction claim, and no consumer may read it as one. |
258
+ | "The framework warned it knows nothing about a jurisdiction, so drop it" | The application still operates there. Removing it hides a known unknown that belongs in the document's limitations. |
195
259
 
196
260
  ## Red Flags
197
261
 
@@ -199,6 +263,19 @@ silently in some pipelines and blocks others on startup.
199
263
  - Minion / worker entry pointing at a non-existent `path` (catch with the **Minion / worker paths exist** check — must return no `MISSING:` lines).
200
264
  - Engine capability block lacking `enabled:` (catch with the **Each engine capability declares `enabled:`** check — counts must match).
201
265
  - Frontend service with no `frontendType` (implicit defaults are framework-version-dependent; declare it explicitly).
266
+ - A minion or worker expected to be traceable whose scope omits the selected
267
+ `OBSERVABILITY_TELEMETRY` provider (catch with the **which runtimes declare it** read above —
268
+ compare its output against the runtimes you expect traces from). The tell is that everything
269
+ looks healthy: the runtime starts, exports, and its traces are dropped at the collector.
270
+ - A runtime scope written as `providers: {}` for a runtime that does call a provider — an empty
271
+ scope is a valid, deliberate statement that the runtime needs no credential, so it is never
272
+ reported as a mistake.
273
+ - A compliance declaration containing a placeholder, an example domain or a plausible-looking
274
+ invented address (catch with the **No placeholder in a compliance declaration** grep — must return empty).
275
+ - `roleAllocations` collapsed to a single role when the product both hosts customer records and
276
+ holds its own account data — that is two roles over two populations, and one is misstated.
277
+ - A `jurisdictionSlug` declared with no `basis`, or a basis that restates the slug ("operates in the EU")
278
+ — the basis exists to say established/selling/holding-data, which imply different obligations.
202
279
 
203
280
  ## Related Skills
204
281