@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -22,13 +22,15 @@ import {
22
22
  resolveFeatureGatedCoreResourceExclusions,
23
23
  describeCaughtError,
24
24
  } from '@wildo-ai/saas-backend-lib';
25
- import { CoreResourceType, ErrorCustomMessageReference, ErrorType } from '@wildo-ai/saas-models';
25
+ import { AuthMethod, CoreResourceType, ErrorCustomMessageReference, ErrorType, getEnabledMethods } from '@wildo-ai/saas-models';
26
26
  import { AppFrontendType, loadConfig } from '@wildo-ai/platform-config-lib';
27
27
  import {
28
+ assertApplicationDocumentationChapterApiReferencesResolve,
28
29
  generateOpenApiDocuments,
29
30
  resolveTechnicalDocumentationForbiddenPublicSentinels,
30
31
  resolveTechnicalDocumentationOutputBudgets,
31
32
  OpenApiGenerationInputSchema,
33
+ applyAuthoredRoleLabelsToOperationAccess,
32
34
  resolveApplicationOrganizationRoleDocumentation,
33
35
  type ApplicationOrganizationRoleDocumentationSource,
34
36
  type ApplicationOrganizationUnitResourceDocumentation,
@@ -37,12 +39,19 @@ import {
37
39
  type OperationProjection,
38
40
  type ResourceTag,
39
41
  type TechnicalDocGenerateOpenApiResult,
42
+ type ApplicationConnectionServer,
43
+ type ApplicationAuthenticationDocumentationSource,
44
+ type ApplicationMcpToolSource,
45
+ type ApplicationWebhookEventSource,
40
46
  } from '@wildo-ai/saas-technical-doc/companion';
41
47
  import {
42
48
  createApiReferenceLinkIndex,
49
+ getTechnicalDocumentationApiReferenceTargetAvailability,
43
50
  resolveTechnicalDocumentationApiReferenceLink,
51
+ TechnicalDocumentationApiReferenceTargetAvailability,
44
52
  type WildoTechnicalDocConfig,
45
53
  } from '@wildo-ai/saas-technical-doc';
54
+ import type { TechnicalDocumentationApiReferenceTargetV1 } from '@wildo-ai/saas-specifications/technical-documentation';
46
55
  import { createConservedApiReferenceModel } from '@wildo-ai/saas-technical-doc/openapi-reference-model';
47
56
 
48
57
  import { TechnicalDocumentationPilotCompanionService } from './technical-documentation-pilot.companion.service';
@@ -57,6 +66,7 @@ import type {
57
66
  TechnicalDocumentationEnvironmentIdentityInput,
58
67
  } from './technical-documentation-environment-identity.companion.service';
59
68
  import { getCompanionConfiguredPrimaryLanguage } from '../../core/config/primary-language.companion.utils';
69
+ import { loadSpecificationsCompanionExports } from '../../core/context/companion-package-loaders.companion';
60
70
  import { readPerUnitLabels, resolvePerUnitFilePath } from '../../i18n-labelling/utils/per-unit-file.utils';
61
71
  import { ROLE_LABELLING_UNIT_FILE_PATH_HINT } from '../../i18n-labelling/utils/role-lifecycle-keys.utils';
62
72
 
@@ -104,6 +114,13 @@ interface OpenApiGenerationInputSubprocessOutput {
104
114
  /** Source-derived application activation facts; independent from the API-reference selection. */
105
115
  readonly hasConfiguredMcpToolOperations: boolean;
106
116
  readonly hasConfiguredA2aSkills: boolean;
117
+ /**
118
+ * The two integration inventories the same walk collects. Row types come from the ENGINE, not
119
+ * from the subprocess module, so this mirror cannot drift on their shape while the parent still
120
+ * never loads subprocess code.
121
+ */
122
+ readonly mcpTools: readonly ApplicationMcpToolSource[];
123
+ readonly webhookEvents: readonly ApplicationWebhookEventSource[];
107
124
  /**
108
125
  * Source-derived role semantics cross the subprocess boundary unchanged.
109
126
  * The parent then joins the application's primary-locale labels before a
@@ -121,6 +138,15 @@ interface OpenApiGenerationInputSubprocessOutput {
121
138
  * projector's wire shape; see `openapi-generation-input.behavior.ts`.
122
139
  */
123
140
  resourceTags: ResourceTag[];
141
+ /**
142
+ * Which of those resources come from the application's OWN registry rather than the core map.
143
+ *
144
+ * Optional on this mirror, and read with a `?? []` at the call site, because the parent must not
145
+ * import subprocess code: an older projector build reaching a newer parent is a real state
146
+ * during a watch cycle, and it should publish documentation with no domain section rather than
147
+ * throw on a field it has never heard of.
148
+ */
149
+ applicationOwnedResourceIdentifiers?: string[];
124
150
  stats: OpenApiGenerationProjectorStats;
125
151
  }
126
152
 
@@ -147,13 +173,17 @@ export class TechnicalDocCompanionService {
147
173
 
148
174
 
149
175
  /**
150
- * Produces one framework private derivation, including the resolved
151
- * organization-role inventory, and its public pre-render bundle.
152
- * The caller selects the environment backend service; the companion resolves
153
- * the environment identity and source-derived operation-exposure evidence.
154
- * It does not read accepted application-family state or select application
155
- * documentation. The role inventory is a narrow configuration projection,
156
- * not an application-authored use-case selection.
176
+ * Produces one private derivation, including the resolved organization-role
177
+ * inventory and the chapters the application authored, and its public
178
+ * pre-render bundle. The caller selects the environment backend service; the
179
+ * companion resolves the environment identity and source-derived
180
+ * operation-exposure evidence.
181
+ *
182
+ * The ONE application-family input is the documentation-chapter pair — the
183
+ * accepted plan and the chapter bodies joined to it (#874), read from the
184
+ * specifications package's companion exports. It never selects documentation
185
+ * on the application's behalf: an authored page exists because the
186
+ * application's own plan declares it.
157
187
  */
158
188
  public async deriveApplicationDocumentationBundles(
159
189
  input: TechnicalDocumentationEnvironmentIdentityInput,
@@ -165,14 +195,143 @@ export class TechnicalDocCompanionService {
165
195
  excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
166
196
  );
167
197
  const organizationRoles = await this.resolveApplicationOrganizationRoles(input.backendServiceKey, subprocessOutput.organizationRoles);
198
+ return this.deriveFromProjection(input, subprocessOutput, technicalDocConfig, organizationRoles);
199
+ }
200
+
201
+ /**
202
+ * The ONE assembly of a derivation's inputs, shared by the bundle route and by managed publication
203
+ * so the two cannot disagree about what the portal is derived from — including the application's
204
+ * authored documentation chapters (#874), which reach the derivation only through here.
205
+ */
206
+ private async deriveFromProjection(
207
+ input: TechnicalDocumentationEnvironmentIdentityInput,
208
+ subprocessOutput: OpenApiGenerationInputSubprocessOutput,
209
+ technicalDocConfig: WildoTechnicalDocConfig,
210
+ organizationRoles: Awaited<ReturnType<TechnicalDocCompanionService['resolveApplicationOrganizationRoles']>>,
211
+ ): Promise<TechnicalDocumentationApplicationDerivationResult> {
168
212
  return this.applicationDerivationService.deriveAuthorizedBundles({
169
213
  ...input,
170
- operations: subprocessOutput.operations,
214
+ operations: applyAuthoredRoleLabelsToOperationAccess(subprocessOutput.operations, TechnicalDocCompanionService.roleLabels(organizationRoles)),
171
215
  hasConfiguredMcpToolOperations: subprocessOutput.hasConfiguredMcpToolOperations,
172
216
  hasConfiguredA2aSkills: subprocessOutput.hasConfiguredA2aSkills,
173
217
  organizationRoles,
174
218
  organizationUnitAwareResources: subprocessOutput.organizationUnitAwareResources,
219
+ ...this.resolveApplicationConnectionInputs(technicalDocConfig),
220
+ authentication: this.resolveApplicationAuthenticationInputs(),
221
+ integration: { mcpTools: subprocessOutput.mcpTools, webhookEvents: subprocessOutput.webhookEvents },
222
+ /*
223
+ * The CATEGORISED tags, not the raw ones. The categoriser is what attaches the application's
224
+ * own grouping and validates it (every published resource named exactly once, no unknown
225
+ * names), so passing the raw list would silently drop the grouping and put the whole domain
226
+ * in one unnamed pile.
227
+ */
228
+ resourceTags: applyApiReferenceResourceCategories(subprocessOutput.resourceTags, technicalDocConfig.apiReferenceResourceCategories),
229
+ applicationOwnedResourceIdentifiers: subprocessOutput.applicationOwnedResourceIdentifiers ?? [],
230
+ ...await this.resolveAuthoredDocumentationChapters(),
231
+ });
232
+ }
233
+
234
+ /**
235
+ * The application's documentation plan and its authored chapter bodies (#874), exactly as the
236
+ * specifications package exports them. Parsed by the engine projector, not here.
237
+ *
238
+ * Read from the WORKING TREE — `loadSpecificationsCompanionExports` evaluates what the developer is
239
+ * writing — exactly as every other specification-derived page is, so an uncommitted chapter can be
240
+ * previewed. Acceptance is git's, not this method's: a chapter is accepted when its source and the
241
+ * regenerated portal output are committed together.
242
+ *
243
+ * An application with no specifications package has authored nothing, and publishes its derived
244
+ * pages alone. One that HAS a package that fails to load is a refusal rather than an absence:
245
+ * publishing without its chapters would silently drop pages the application accepted.
246
+ */
247
+ private async resolveAuthoredDocumentationChapters(): Promise<{
248
+ readonly documentationPlan?: unknown;
249
+ readonly documentationChapters?: unknown;
250
+ }> {
251
+ if (!this.companionContext.resolvedSpecifications) return {};
252
+ const specifications = await loadSpecificationsCompanionExports(this.companionContext);
253
+ return {
254
+ ...(specifications.documentationPlan === undefined ? {} : { documentationPlan: specifications.documentationPlan }),
255
+ ...(specifications.documentationChapters === undefined ? {} : { documentationChapters: specifications.documentationChapters }),
256
+ };
257
+ }
258
+
259
+ /**
260
+ * The application facts the documentation names instead of hedging: the product's own name and
261
+ * the base URLs it publishes.
262
+ *
263
+ * The name is what a customer calls the product — `displayName` from `wildo.saas.config.ts`,
264
+ * falling back to the application's `name`. Deliberately NOT `publicMarketingTitle`: that is the documentation SITE's
265
+ * title ("Your Application — Technical Documentation") and reads wrong inside a sentence.
266
+ *
267
+ * The base URLs are the ones the application already authors for its API reference, so the
268
+ * guides and the reference name the same origins by construction.
269
+ */
270
+ private resolveApplicationConnectionInputs(technicalDocConfig: WildoTechnicalDocConfig): {
271
+ applicationName: string;
272
+ apiServers: readonly ApplicationConnectionServer[];
273
+ } {
274
+ const saasConfig = this.companionContext.saasConfig;
275
+ const applicationName = saasConfig.displayName?.trim() || saasConfig.name.trim();
276
+ if (applicationName.length === 0) {
277
+ throw new Error('technical-documentation requires the application to declare a name (displayName or name in wildo.saas.config.ts)');
278
+ }
279
+ return {
280
+ applicationName,
281
+ apiServers: (technicalDocConfig.apiServers ?? []).map((server) => ({
282
+ url: server.url,
283
+ ...(server.description === undefined ? {} : { description: server.description }),
284
+ })),
285
+ };
286
+ }
287
+
288
+ /**
289
+ * The sign-in policy this application actually applies, per user type.
290
+ *
291
+ * Read from `userTypes[<key>].auth`, which is where all authentication policy lives — there are
292
+ * no global defaults. Enabled methods go through `getEnabledMethods`, the same helper the runtime
293
+ * uses, rather than re-reading the boolean-or-object shorthand here; and they are ordered by the
294
+ * engine's own enum so two applications list the same methods in the same order.
295
+ */
296
+ private resolveApplicationAuthenticationInputs(): ApplicationAuthenticationDocumentationSource {
297
+ const userTypes = Object.entries(this.appConfigService.config.userTypes ?? {}).map(([userTypeKey, definition]) => {
298
+ const auth = definition.auth;
299
+ const enabled = getEnabledMethods(auth.authMethodsEnabled);
300
+ return {
301
+ userTypeKey,
302
+ enabledMethods: Object.values(AuthMethod).filter((method) => enabled.has(method)),
303
+ multifactor: {
304
+ required: auth.mfaPolicy.requireMFA,
305
+ strongRequired: auth.mfaPolicy.requireStrongMFA,
306
+ enrollmentGracePeriodDays: auth.mfaPolicy.enrollmentGracePeriodDays,
307
+ passkeyExemptFromMultifactor: auth.mfaPolicy.passkeyExemptFromMFA,
308
+ ...(auth.mfaPolicy.acceptableMFAMethods === undefined ? {} : { acceptableMethods: auth.mfaPolicy.acceptableMFAMethods }),
309
+ },
310
+ password: {
311
+ minLength: auth.passwordPolicy.minLength,
312
+ maxLength: auth.passwordPolicy.maxLength,
313
+ requireUppercase: auth.passwordPolicy.requireUppercase,
314
+ requireLowercase: auth.passwordPolicy.requireLowercase,
315
+ requireNumbers: auth.passwordPolicy.requireNumbers,
316
+ requireSpecialChars: auth.passwordPolicy.requireSpecialChars,
317
+ expiryDays: auth.passwordPolicy.expiryDays,
318
+ },
319
+ session: {
320
+ durationMinutes: auth.sessionDurationMinutes,
321
+ ...(auth.maxConcurrentSessions === undefined ? {} : { maxConcurrentSessions: auth.maxConcurrentSessions }),
322
+ },
323
+ lockout: {
324
+ maxLoginAttempts: auth.lockoutPolicy.maxLoginAttempts,
325
+ lockoutDurationMinutes: auth.lockoutPolicy.lockoutDurationMinutes,
326
+ progressive: auth.lockoutPolicy.progressiveLockout,
327
+ maxProgressiveLockoutHours: auth.lockoutPolicy.maxProgressiveLockoutHours,
328
+ },
329
+ };
175
330
  });
331
+ if (userTypes.length === 0) {
332
+ throw new Error('technical-documentation requires the application to declare at least one user type');
333
+ }
334
+ return { userTypes };
176
335
  }
177
336
 
178
337
  /**
@@ -201,24 +360,73 @@ export class TechnicalDocCompanionService {
201
360
  createConservedApiReferenceModel(section);
202
361
  }
203
362
  const apiReferenceLinkIndex = createApiReferenceLinkIndex(generated.documents.sections);
363
+ /*
364
+ * BEFORE anything is written: an authored chapter citing a contract the rendered reference does
365
+ * not carry fails the whole publication, where an engine page's missing target merely degrades
366
+ * below. The asymmetry is deliberate and explained at the assertion.
367
+ */
368
+ assertApplicationDocumentationChapterApiReferencesResolve(generated.derivation.publicBundle, apiReferenceLinkIndex);
369
+ if (generated.derivation.plannedChapterRefsWithoutBody.length > 0) {
370
+ this.logger.warn('technical-documentation: planned chapters with no authored body are not published yet', {
371
+ chapterRefs: generated.derivation.plannedChapterRefsWithoutBody,
372
+ authoredIn: 'specifications/src/technical-documentation/index.ts',
373
+ });
374
+ }
375
+ if (generated.derivation.authoredChapterRefsWithoutPlan.length > 0) {
376
+ this.logger.warn('technical-documentation: authored chapters the documentation plan does not declare are withheld', {
377
+ chapterRefs: generated.derivation.authoredChapterRefsWithoutPlan,
378
+ declareIn: 'specifications/src/documentation-plan/index.ts',
379
+ });
380
+ }
204
381
  const publisher = new TechnicalDocumentationPilotCompanionService(this.companionContext.saasRoot);
205
382
  await publisher.publishOpenApiDocuments({
206
383
  documents: generated.documents,
207
384
  sourceUnitRefs: [`technical-documentation:source/openapi/${this.companionContext.saasConfig.slug}`],
208
385
  });
209
386
 
210
- return publisher.generateValidateAndPublish({
387
+ /*
388
+ * A guide may link to an API-reference target this application does not publish — the engine
389
+ * hardcodes 43 `apiReferenceTargets` naming engine resources an application may feature-gate
390
+ * off. Those links DEGRADE to plain text and the rest of the portal publishes (#472).
391
+ *
392
+ * Reporting is the half that keeps the degradation from becoming the next silent gap: every
393
+ * dropped target is collected here and named after publication, so an author sees which links
394
+ * their configuration removed rather than discovering a thinner portal.
395
+ */
396
+ const degradedApiReferenceTargets: string[] = [];
397
+ const resolveApiReferenceTarget = (target: TechnicalDocumentationApiReferenceTargetV1): string | null => {
398
+ if (getTechnicalDocumentationApiReferenceTargetAvailability(apiReferenceLinkIndex, target)
399
+ === TechnicalDocumentationApiReferenceTargetAvailability.UNAVAILABLE) {
400
+ degradedApiReferenceTargets.push(JSON.stringify(target));
401
+ return null;
402
+ }
403
+ return resolveTechnicalDocumentationApiReferenceLink(apiReferenceLinkIndex, target);
404
+ };
405
+
406
+ const publication = await publisher.generateValidateAndPublish({
211
407
  derivation: generated.derivation,
212
408
  supportedApiVersion: technicalDocConfig.supportedApiVersion,
213
409
  forbiddenPublicSentinels: resolveTechnicalDocumentationForbiddenPublicSentinels(
214
410
  technicalDocConfig.forbiddenPublicSentinels,
215
411
  ),
216
412
  budgets: resolveTechnicalDocumentationOutputBudgets(technicalDocConfig.outputBudgets),
217
- resolveApiReferenceTarget: (target) => resolveTechnicalDocumentationApiReferenceLink(apiReferenceLinkIndex, target),
413
+ resolveApiReferenceTarget,
218
414
  ...(input.refuseProvisionalAssets === undefined
219
415
  ? {}
220
416
  : { refuseProvisionalAssets: input.refuseProvisionalAssets }),
221
417
  });
418
+
419
+ if (degradedApiReferenceTargets.length > 0) {
420
+ // Deduplicated: one target linked from several guides is ONE configuration fact, and
421
+ // repeating it per link would bury the distinct ones.
422
+ const distinct = [...new Set(degradedApiReferenceTargets)].sort();
423
+ this.logger.warn('technical-documentation API-reference links degraded to plain text — this application does not publish these targets', {
424
+ count: distinct.length,
425
+ targets: distinct,
426
+ });
427
+ }
428
+
429
+ return publication;
222
430
  }
223
431
 
224
432
  /**
@@ -248,15 +456,12 @@ export class TechnicalDocCompanionService {
248
456
  excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
249
457
  );
250
458
  const organizationRoles = await this.resolveApplicationOrganizationRoles(input.backendServiceKey, subprocessOutput.organizationRoles);
251
- const derivation = await this.applicationDerivationService.deriveAuthorizedBundles({
252
- ...input,
253
- operations: subprocessOutput.operations,
254
- hasConfiguredMcpToolOperations: subprocessOutput.hasConfiguredMcpToolOperations,
255
- hasConfiguredA2aSkills: subprocessOutput.hasConfiguredA2aSkills,
256
- organizationRoles,
257
- organizationUnitAwareResources: subprocessOutput.organizationUnitAwareResources,
258
- });
259
- const generationInput = this.assembleGenerationInput(subprocessOutput, technicalDocConfig);
459
+ const derivation = await this.deriveFromProjection(input, subprocessOutput, technicalDocConfig, organizationRoles);
460
+ const generationInput = this.assembleGenerationInput(
461
+ subprocessOutput,
462
+ technicalDocConfig,
463
+ TechnicalDocCompanionService.roleLabels(organizationRoles),
464
+ );
260
465
 
261
466
  return Object.freeze({
262
467
  derivation,
@@ -293,7 +498,11 @@ export class TechnicalDocCompanionService {
293
498
  technicalDocConfig.apiDocResources,
294
499
  excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
295
500
  );
296
- const generationInput = this.assembleGenerationInput(subprocessOutput, technicalDocConfig);
501
+ const generationInput = this.assembleGenerationInput(
502
+ subprocessOutput,
503
+ technicalDocConfig,
504
+ await this.resolveRoleLabelsBestEffort(subprocessOutput.organizationRoles),
505
+ );
297
506
  const documents = generateOpenApiDocuments(generationInput);
298
507
 
299
508
  this.logDebug('technical-doc generate-openapi — success', {
@@ -372,22 +581,31 @@ export class TechnicalDocCompanionService {
372
581
  }
373
582
 
374
583
  const data: unknown = introspection.data;
375
- if (
376
- !isPlainObject(data)
377
- || !Array.isArray(data.operations)
378
- || typeof data.hasConfiguredMcpToolOperations !== 'boolean'
379
- || typeof data.hasConfiguredA2aSkills !== 'boolean'
380
- || !isPlainObject(data.errorResponseSchema)
381
- || !Array.isArray(data.resourceTags)
382
- || !Array.isArray(data.organizationRoles)
383
- || !Array.isArray(data.organizationUnitAwareResources)
384
- || !isOpenApiGenerationProjectorStats(data.stats)
385
- ) {
584
+ /*
585
+ * Collect EVERY unmet expectation rather than short-circuiting on the first, and name each one.
586
+ * The previous form was a single `||` chain whose message listed all eight expectations and
587
+ * identified none of them, so a real refusal — the row-conservation clause, once the projector
588
+ * grew a second producer of operations — presented as an opaque 500 and had to be re-derived by
589
+ * hand from a running companion. Which clause refused, and on which numbers, is knowable here.
590
+ */
591
+ const violations: string[] = [];
592
+ if (!isPlainObject(data)) {
593
+ violations.push(`payload: expected an object, received ${describeReceivedValue(data)}`);
594
+ } else {
595
+ if (!Array.isArray(data.operations)) violations.push(`operations: expected OperationProjection[], received ${describeReceivedValue(data.operations)}`);
596
+ if (typeof data.hasConfiguredMcpToolOperations !== 'boolean') violations.push(`hasConfiguredMcpToolOperations: expected boolean, received ${describeReceivedValue(data.hasConfiguredMcpToolOperations)}`);
597
+ if (typeof data.hasConfiguredA2aSkills !== 'boolean') violations.push(`hasConfiguredA2aSkills: expected boolean, received ${describeReceivedValue(data.hasConfiguredA2aSkills)}`);
598
+ if (!isPlainObject(data.errorResponseSchema)) violations.push(`errorResponseSchema: expected object, received ${describeReceivedValue(data.errorResponseSchema)}`);
599
+ if (!Array.isArray(data.resourceTags)) violations.push(`resourceTags: expected ResourceTag[], received ${describeReceivedValue(data.resourceTags)}`);
600
+ if (!Array.isArray(data.organizationRoles)) violations.push(`organizationRoles: expected OrganizationRole[], received ${describeReceivedValue(data.organizationRoles)}`);
601
+ if (!Array.isArray(data.organizationUnitAwareResources)) violations.push(`organizationUnitAwareResources: expected OrganizationUnitAwareResource[], received ${describeReceivedValue(data.organizationUnitAwareResources)}`);
602
+ violations.push(...describeOpenApiGenerationProjectorStatsViolations(data.stats));
603
+ }
604
+ if (violations.length > 0) {
386
605
  throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
387
606
  customMessageReference: ErrorCustomMessageReference.INTERNAL,
388
607
  context: {
389
- message: 'openapi-generation-input subprocess returned a malformed payload — expected '
390
- + '`{ operations: OperationProjection[], hasConfiguredMcpToolOperations: boolean, hasConfiguredA2aSkills: boolean, organizationRoles: OrganizationRole[], organizationUnitAwareResources: OrganizationUnitAwareResource[], errorResponseSchema: object, resourceTags: ResourceTag[], stats: { ... } }`.',
608
+ message: `openapi-generation-input subprocess returned a malformed payload — ${violations.join('; ')}`,
391
609
  },
392
610
  });
393
611
  }
@@ -417,6 +635,7 @@ export class TechnicalDocCompanionService {
417
635
  private assembleGenerationInput(
418
636
  subprocessOutput: OpenApiGenerationInputSubprocessOutput,
419
637
  technicalDocConfig: WildoTechnicalDocConfig,
638
+ roleLabelsByRole: Readonly<Record<string, string>>,
420
639
  ): OpenApiGenerationInput {
421
640
  const saasConfig = this.companionContext.saasConfig;
422
641
  const candidateInput: OpenApiGenerationInput = {
@@ -426,7 +645,7 @@ export class TechnicalDocCompanionService {
426
645
  ...(technicalDocConfig.publicMarketingTitle
427
646
  ? { publicMarketingTitle: technicalDocConfig.publicMarketingTitle }
428
647
  : {}),
429
- operations: subprocessOutput.operations,
648
+ operations: [...applyAuthoredRoleLabelsToOperationAccess(subprocessOutput.operations, roleLabelsByRole)],
430
649
  errorResponseSchema: subprocessOutput.errorResponseSchema,
431
650
  ...(subprocessOutput.resourceTags && subprocessOutput.resourceTags.length > 0
432
651
  ? { resourceTags: applyApiReferenceResourceCategories(subprocessOutput.resourceTags, technicalDocConfig.apiReferenceResourceCategories) }
@@ -548,7 +767,12 @@ export class TechnicalDocCompanionService {
548
767
 
549
768
  let loaded: WildoTechnicalDocConfig;
550
769
  try {
551
- loaded = await loadConfig<WildoTechnicalDocConfig>(techDocConfigPath);
770
+ // `freshModuleCache` is what makes the docblock's "evaluated for every request" true. Calling
771
+ // `loadConfig` again is NOT enough on its own: jiti's module cache is process-global, so
772
+ // without this the second evaluation returns the first one's result and a valid taxonomy,
773
+ // server or overview edit stays invisible until an unrelated restart — precisely the outcome
774
+ // the contract above rejects. Same defect as issue #170, different read site.
775
+ loaded = await loadConfig<WildoTechnicalDocConfig>(techDocConfigPath, { freshModuleCache: true });
552
776
  } catch (e) {
553
777
  throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
554
778
  customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
@@ -572,6 +796,37 @@ export class TechnicalDocCompanionService {
572
796
  * member-management interface, so an incomplete label unit blocks
573
797
  * publication instead of falling back to a prettified role token.
574
798
  */
799
+ /**
800
+ * The authored label per role, as the join needs it.
801
+ *
802
+ * Reached only AFTER {@link resolveApplicationOrganizationRoles}, which refuses a role whose
803
+ * primary-locale label the application has not generated — so on this path every role has one.
804
+ */
805
+ private static roleLabels(roles: readonly { readonly role: string; readonly label: string }[]): Readonly<Record<string, string>> {
806
+ return Object.fromEntries(roles.map((role) => [role.role, role.label]));
807
+ }
808
+
809
+ /**
810
+ * The same labels for the READ door, WITHOUT the refusal.
811
+ *
812
+ * `generateOpenApiDocuments` generates a document and writes nothing. Failing it closed because an
813
+ * application has not generated its role labels yet would make a read unavailable for an authoring
814
+ * gap whose remedy is elsewhere — a read path must never fail closed on something whose remedy it
815
+ * cannot reach. Publication keeps the refusal, which is where it belongs; here a role with
816
+ * no authored label keeps its token.
817
+ */
818
+ private async resolveRoleLabelsBestEffort(roles: readonly ApplicationOrganizationRoleDocumentationSource[]): Promise<Readonly<Record<string, string>>> {
819
+ try {
820
+ const resolved = await this.resolveApplicationOrganizationRoles(this.pickProjectorCarrierServiceKey(), roles);
821
+ return TechnicalDocCompanionService.roleLabels(resolved);
822
+ } catch (error) {
823
+ this.logDebug('technical-doc generate-openapi — role labels unavailable, roles keep their tokens', {
824
+ reason: describeCaughtError(error),
825
+ });
826
+ return {};
827
+ }
828
+ }
829
+
575
830
  private async resolveApplicationOrganizationRoles(
576
831
  backendServiceKey: string,
577
832
  roles: readonly ApplicationOrganizationRoleDocumentationSource[],
@@ -614,13 +869,6 @@ export class TechnicalDocCompanionService {
614
869
  }
615
870
  return backendServiceKey;
616
871
  }
617
-
618
- private pickFrontendApplicationServiceKey(): string {
619
- const frontendServiceKey = Object.entries(this.companionContext.servicesByKey)
620
- .find(([, service]) => service.frontendType === AppFrontendType.SAAS_APP)?.[0];
621
- if (!frontendServiceKey) throw new Error('technical-documentation frontend runtime evidence requires one SAAS_APP service');
622
- return frontendServiceKey;
623
- }
624
872
  }
625
873
 
626
874
  /**
@@ -634,6 +882,18 @@ export class TechnicalDocCompanionService {
634
882
  * Once an application elects to declare categories, an exact inventory join is
635
883
  * required: an uncategorised new resource or a stale config name must stop
636
884
  * publication instead of quietly producing a misleading partial navigation.
885
+ *
886
+ * The completeness rule is about the RESULT, not about this config: a resource
887
+ * satisfies it either by being assigned here or by already carrying the
888
+ * engine's own sub-domain category (`projectResourceTag`). That distinction is
889
+ * what makes the declaration usable at all — a generated application publishes
890
+ * roughly eight resources of its own beside fifty-two of the engine's, so a
891
+ * rule demanding the config name every one of them means an application must
892
+ * hand-classify the engine's catalogue, and re-classify it whenever the engine
893
+ * grows. Wonder CRM opted out entirely for that reason and rendered its whole
894
+ * reference as one flat list. An explicit assignment still WINS over the
895
+ * engine's default, so an application that wants its own product-shaped
896
+ * taxonomy across engine and application resources keeps it.
637
897
  */
638
898
  export function applyApiReferenceResourceCategories(
639
899
  resourceTags: readonly ResourceTag[],
@@ -643,7 +903,12 @@ export function applyApiReferenceResourceCategories(
643
903
  const tagsByName = new Map(resourceTags.map((tag) => [tag.name, tag]));
644
904
  if (tagsByName.size !== resourceTags.length) throw new Error('OpenAPI resource tags must be unique before category assignment');
645
905
 
646
- const categoryByResourceName = new Map<string, WildoTechnicalDocConfig['apiReferenceResourceCategories'][number]>();
906
+ /*
907
+ * `NonNullable<…>` before `[number]`: the config field is OPTIONAL, so its type is
908
+ * `Array | undefined` and indexing `| undefined` with `[number]` is not a thing (#352). The guard
909
+ * three lines up narrows the VALUE, which a type expression cannot see.
910
+ */
911
+ const categoryByResourceName = new Map<string, NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>[number]>();
647
912
  const categoryIds = new Set<string>();
648
913
  const unavailableResourceNames: string[] = [];
649
914
  for (const category of categories) {
@@ -662,12 +927,16 @@ export function applyApiReferenceResourceCategories(
662
927
  if (unavailableResourceNames.length > 0) {
663
928
  throw new Error(`API-reference categories name unavailable resources: ${unavailableResourceNames.sort().join(', ')}`);
664
929
  }
665
- const unassignedResourceNames = [...tagsByName.keys()].filter((resourceName) => !categoryByResourceName.has(resourceName)).sort();
666
- if (unassignedResourceNames.length > 0) {
667
- throw new Error(`API-reference resources have no configured category: ${unassignedResourceNames.join(', ')}`);
930
+ const uncategorisedResourceNames = resourceTags
931
+ .filter((tag) => !categoryByResourceName.has(tag.name) && tag.category === undefined)
932
+ .map((tag) => tag.name)
933
+ .sort();
934
+ if (uncategorisedResourceNames.length > 0) {
935
+ throw new Error(`API-reference resources have no category, from this config or from the engine: ${uncategorisedResourceNames.join(', ')}`);
668
936
  }
669
937
  return resourceTags.map((tag) => {
670
- const category = categoryByResourceName.get(tag.name)!;
938
+ const category = categoryByResourceName.get(tag.name);
939
+ if (category === undefined) return { ...tag };
671
940
  return {
672
941
  ...tag,
673
942
  category: {
@@ -693,8 +962,20 @@ function isNonNegativeInteger(value: unknown): value is number {
693
962
  * flattening it; this parent-side join prevents a future projector filter,
694
963
  * collapse or mapper change from merely adjusting a count while dropping the
695
964
  * operation that the count represented.
965
+ *
966
+ * TOTAL OVER THE PROJECTOR'S PRODUCERS, and that is the part that has to be
967
+ * maintained. The registry inventory is a bijection onto its own rows; the
968
+ * manual controller-route catalog contributes rows that are deliberately not in
969
+ * that inventory and are counted separately. So the identity is
970
+ * `registry + manual = payload`, with every registry entry present. Written
971
+ * flat (`registry = payload`) it silently became false the day the manual
972
+ * family was added, and refused every publication in the whole fleet.
973
+ *
974
+ * A future third producer belongs in this sum as its own named term. Do NOT
975
+ * relax the equality to an inequality or a subset test to accommodate one — the
976
+ * whole value of this join is that a dropped operation cannot hide inside slack.
696
977
  */
697
- function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenerationInputSubprocessOutput): void {
978
+ export function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenerationInputSubprocessOutput): void {
698
979
  const key = (entry: {
699
980
  readonly identity: {
700
981
  readonly contractVersion: number;
@@ -724,53 +1005,112 @@ function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenera
724
1005
  section: operation.consumerApiSection,
725
1006
  roles: operation.roles,
726
1007
  })));
727
- if (
728
- source.size !== output.stats.resolvedExternalHttpOperations.length
729
- || projections.size !== output.operations.length
730
- || source.size !== projections.size
731
- || [...source].some((entry) => !projections.has(entry))
732
- ) {
733
- throw new Error('openapi-generation-input subprocess violated resolved HTTP operation → projection conservation');
1008
+ const manualRowCount = output.stats.manualControllerRouteRowCount;
1009
+ const violations: string[] = [];
1010
+ if (source.size !== output.stats.resolvedExternalHttpOperations.length) {
1011
+ violations.push(
1012
+ `stats.resolvedExternalHttpOperations contains duplicate identities: ${output.stats.resolvedExternalHttpOperations.length} entries collapse to ${source.size} distinct keys`,
1013
+ );
1014
+ }
1015
+ if (projections.size !== output.operations.length) {
1016
+ violations.push(
1017
+ `operations contains duplicate identities: ${output.operations.length} rows collapse to ${projections.size} distinct keys`,
1018
+ );
1019
+ }
1020
+ if (projections.size !== source.size + manualRowCount) {
1021
+ violations.push(
1022
+ `row conservation: ${projections.size} distinct projected rows ≠ ${source.size} registry-resolved + ${manualRowCount} manual controller-route rows (${source.size + manualRowCount})`,
1023
+ );
1024
+ }
1025
+ const dropped = [...source].filter((entry) => !projections.has(entry));
1026
+ if (dropped.length > 0) {
1027
+ violations.push(
1028
+ `${dropped.length} registry-resolved HTTP operation(s) reached no projection row; first: ${dropped[0]}`,
1029
+ );
1030
+ }
1031
+ if (violations.length > 0) {
1032
+ throw new Error(
1033
+ `openapi-generation-input subprocess violated resolved HTTP operation → projection conservation — ${violations.join('; ')}`,
1034
+ );
734
1035
  }
735
1036
  }
736
1037
 
737
- /** Validate the complete diagnostics object received from the subprocess. */
738
- function isOpenApiGenerationProjectorStats(value: unknown): value is OpenApiGenerationProjectorStats {
739
- if (!isPlainObject(value)) return false;
740
- if (
741
- !isNonNegativeInteger(value.resourceCount)
742
- || !isNonNegativeInteger(value.consideredOperationCount)
743
- || !isNonNegativeInteger(value.projectedRowCount)
744
- || !Array.isArray(value.resolvedExternalHttpOperations)
745
- || !isNonNegativeInteger(value.skippedOperationWithoutInitiatorInfosCount)
746
- || !Array.isArray(value.skippedOperationsWithoutInitiatorInfos)
747
- ) {
1038
+ /**
1039
+ * Validate the complete diagnostics object received from the subprocess, and
1040
+ * REPORT WHICH EXPECTATION FAILED.
1041
+ *
1042
+ * This used to be a boolean type predicate feeding one `||` chain, so the
1043
+ * caller could only say that some one of eight expectations was unmet. When the
1044
+ * payload really did stop conserving rows, establishing WHICH clause refused
1045
+ * cost a companion log, an auth token, a hand-driven introspection call and a
1046
+ * predicate-by-predicate comparison — for a fact the guard held in its hand at
1047
+ * the moment it threw. A guard that refuses without naming the failed clause
1048
+ * charges an investigation every time it fires, so this returns the clause and
1049
+ * its two numbers instead.
1050
+ *
1051
+ * @returns one message per unmet expectation; empty means the value is a
1052
+ * well-formed {@link OpenApiGenerationProjectorStats}.
1053
+ */
1054
+ export function describeOpenApiGenerationProjectorStatsViolations(value: unknown): string[] {
1055
+ if (!isPlainObject(value)) return [`stats: expected an object, received ${describeReceivedValue(value)}`];
1056
+
1057
+ const violations: string[] = [];
1058
+ const requireNonNegativeInteger = (field: keyof OpenApiGenerationProjectorStats): boolean => {
1059
+ if (isNonNegativeInteger(value[field])) return true;
1060
+ violations.push(`stats.${field}: expected a non-negative integer, received ${describeReceivedValue(value[field])}`);
1061
+ return false;
1062
+ };
1063
+ const requireArray = (field: string): boolean => {
1064
+ if (Array.isArray(value[field])) return true;
1065
+ violations.push(`stats.${field}: expected an array, received ${describeReceivedValue(value[field])}`);
748
1066
  return false;
1067
+ };
1068
+
1069
+ const hasProjectedRowCount = requireNonNegativeInteger('projectedRowCount');
1070
+ const hasManualRowCount = requireNonNegativeInteger('manualControllerRouteRowCount');
1071
+ requireNonNegativeInteger('resourceCount');
1072
+ requireNonNegativeInteger('consideredOperationCount');
1073
+ requireNonNegativeInteger('skippedOperationWithoutInitiatorInfosCount');
1074
+ const hasResolvedOperations = requireArray('resolvedExternalHttpOperations');
1075
+ const hasSkippedOperations = requireArray('skippedOperationsWithoutInitiatorInfos');
1076
+
1077
+ if (hasResolvedOperations && hasManualRowCount && hasProjectedRowCount) {
1078
+ /*
1079
+ * The projector has TWO producers of `OperationProjection` rows and this is where their sum is
1080
+ * checked, so the message names all three terms. Compare the identity join in
1081
+ * `assertResolvedHttpOperationProjectionConservation`, which checks the same statement against
1082
+ * the actual rows rather than against the counts — a count can be adjusted, identities cannot.
1083
+ */
1084
+ const resolved = (value.resolvedExternalHttpOperations as unknown[]).length;
1085
+ const manual = value.manualControllerRouteRowCount as number;
1086
+ const projected = value.projectedRowCount as number;
1087
+ if (resolved + manual !== projected) {
1088
+ violations.push(
1089
+ `stats row conservation: resolvedExternalHttpOperations (${resolved}) + manualControllerRouteRowCount (${manual}) = ${resolved + manual}, but projectedRowCount is ${projected}`,
1090
+ );
1091
+ }
749
1092
  }
750
1093
 
751
- if (
752
- value.resolvedExternalHttpOperations.length !== value.projectedRowCount
753
- || !value.resolvedExternalHttpOperations.every((entry) =>
754
- isPlainObject(entry)
755
- && isPlainObject(entry.identity)
756
- && typeof entry.section === 'string'
757
- && Array.isArray(entry.roles)
758
- && entry.roles.every((role) => typeof role === 'string'))
759
- ) {
760
- return false;
1094
+ if (hasResolvedOperations && !(value.resolvedExternalHttpOperations as unknown[]).every((entry) =>
1095
+ isPlainObject(entry)
1096
+ && isPlainObject(entry.identity)
1097
+ && typeof entry.section === 'string'
1098
+ && Array.isArray(entry.roles)
1099
+ && entry.roles.every((role) => typeof role === 'string'))) {
1100
+ violations.push('stats.resolvedExternalHttpOperations: every entry must be `{ identity: object, section: string, roles: string[] }`');
761
1101
  }
762
1102
 
763
- if (
764
- value.excludedCoreResources !== undefined
765
- && (
1103
+ if (value.excludedCoreResources !== undefined) {
1104
+ if (
766
1105
  !Array.isArray(value.excludedCoreResources)
767
1106
  || !value.excludedCoreResources.every((entry) =>
768
1107
  typeof entry === 'string' && Object.values(CoreResourceType).includes(entry as CoreResourceType))
769
- )
770
- ) {
771
- return false;
1108
+ ) {
1109
+ violations.push('stats.excludedCoreResources: expected an array of CoreResourceType values');
1110
+ }
772
1111
  }
773
- if (!value.skippedOperationsWithoutInitiatorInfos.every((entry) =>
1112
+
1113
+ if (hasSkippedOperations && !(value.skippedOperationsWithoutInitiatorInfos as unknown[]).every((entry) =>
774
1114
  isPlainObject(entry)
775
1115
  && typeof entry.resourceIdentifier === 'string'
776
1116
  && typeof entry.operationIdentifier === 'string'
@@ -778,20 +1118,20 @@ function isOpenApiGenerationProjectorStats(value: unknown): value is OpenApiGene
778
1118
  && (entry.variantKey === undefined || typeof entry.variantKey === 'string')
779
1119
  && (entry.isOperationDefault === undefined || typeof entry.isOperationDefault === 'boolean')
780
1120
  && (entry.isBulkOperation === undefined || typeof entry.isBulkOperation === 'boolean'))) {
781
- return false;
1121
+ violations.push('stats.skippedOperationsWithoutInitiatorInfos: every entry must carry string `resourceIdentifier`, `operationIdentifier` and `variantType`');
782
1122
  }
783
- if (
784
- value.skippedCoreResources !== undefined
785
- && (
1123
+
1124
+ if (value.skippedCoreResources !== undefined) {
1125
+ if (
786
1126
  !Array.isArray(value.skippedCoreResources)
787
1127
  || !value.skippedCoreResources.every((entry) => isPlainObject(entry) && typeof entry.resourceType === 'string' && typeof entry.reason === 'string')
788
- )
789
- ) {
790
- return false;
1128
+ ) {
1129
+ violations.push('stats.skippedCoreResources: expected an array of `{ resourceType: string, reason: string }`');
1130
+ }
791
1131
  }
792
- if (
793
- value.collapsedCoreOperations !== undefined
794
- && (
1132
+
1133
+ if (value.collapsedCoreOperations !== undefined) {
1134
+ if (
795
1135
  !Array.isArray(value.collapsedCoreOperations)
796
1136
  || !value.collapsedCoreOperations.every((entry) =>
797
1137
  isPlainObject(entry)
@@ -799,11 +1139,26 @@ function isOpenApiGenerationProjectorStats(value: unknown): value is OpenApiGene
799
1139
  && typeof entry.operationKey === 'string'
800
1140
  && typeof entry.httpVerb === 'string'
801
1141
  && typeof entry.path === 'string')
802
- )
803
- ) {
804
- return false;
1142
+ ) {
1143
+ violations.push('stats.collapsedCoreOperations: expected an array of `{ resourceType, operationKey, httpVerb, path }` strings');
1144
+ }
805
1145
  }
806
1146
 
807
- return true;
1147
+ return violations;
1148
+ }
1149
+
1150
+ /**
1151
+ * A short, safe rendering of a rejected value for a diagnostic message.
1152
+ *
1153
+ * Type plus a bounded preview: the point of the message is to tell the reader
1154
+ * whether the field is absent, the wrong type, or the right type with a wrong
1155
+ * value, and the first two are invisible if only the type is printed.
1156
+ */
1157
+ function describeReceivedValue(value: unknown): string {
1158
+ if (value === undefined) return 'undefined (absent)';
1159
+ if (value === null) return 'null';
1160
+ if (Array.isArray(value)) return `an array of ${value.length}`;
1161
+ if (typeof value === 'object') return 'an object';
1162
+ return `${typeof value} ${JSON.stringify(value)?.slice(0, 40) ?? ''}`.trim();
808
1163
  }
809
1164
  ```