@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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 (1167) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -87,5 +87,24 @@ export interface FrameworkKnowledgeSkillSummary {
87
87
  * Sorted by name so a brief built twice from one artifact is byte-identical.
88
88
  */
89
89
  export declare function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[];
90
+ /**
91
+ * One compiled skill's BODY — the `SKILL.md` a method means when it says "follow the `X` skill".
92
+ *
93
+ * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:
94
+ * that projection is for CHOOSING between skills and carries one line each, and a method that has
95
+ * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods
96
+ * instructed their model to follow a named skill "for the exact field contracts" while only its
97
+ * purpose line ever reached the brief (#1435).
98
+ *
99
+ * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those
100
+ * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs
101
+ * them, and a structured generation cannot open anything — inlining them would put tens of
102
+ * kilobytes of material nobody asked for into every brief. What the body says about them stays
103
+ * true for the coding agent that later executes the work.
104
+ *
105
+ * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than
106
+ * rendering an empty section that reads like a skill with nothing in it.
107
+ */
108
+ export declare function readFrameworkKnowledgeSkillBody(skillName: string): string | null;
90
109
  export declare function getFrameworkKnowledgeSkillsIndex(): string | null;
91
110
  //# sourceMappingURL=framework-knowledge.loader.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,yCAAyC,EAEzC,sDAAsD,EACtD,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAE1B,uCAAuC,EACvC,oCAAoC,EACpC,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwC,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAoExH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,qCAAqC,IAAI,8BAA8B,CAAC,0BAA0B,CAAC,CAalH;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAE1E;AAED,wBAAgB,gCAAgC,IAAI,oCAAoC,EAAE,CAEzF;AAED,wBAAgB,+BAA+B,IAAI,4BAA4B,CAE9E;AAED,wBAAgB,4BAA4B,IAAI,iCAAiC,EAAE,CAElF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAyB1F;AAED,wBAAgB,6BAA6B,CAAC,aAAa,SAAS,8BAA8B,EAChG,YAAY,EAAE,aAAa,GAC1B,6BAA6B,CAAC,aAAa,CAAC,CAE9C;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,uCAAuC,EAAE,CAK3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAmD5F;AAED,4EAA4E;AAC5E,wBAAgB,6CAA6C,IAAI,sDAAsD,EAAE,CAGxH;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,yCAAyC,GAAG,IAAI,CA0B5I;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sDAAsD,CACpE,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,8BAA8B,CAAC,OAAO,CAAC,GAAG,IAAI,CAWhD;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,IAAI,8BAA8B,EAAE,CAsBvF;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAQhE"}
1
+ {"version":3,"file":"framework-knowledge.loader.d.ts","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yCAAyC,EAEzC,sDAAsD,EACtD,0BAA0B,EAC1B,8BAA8B,EAC9B,0BAA0B,EAE1B,uCAAuC,EACvC,oCAAoC,EACpC,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,iCAAiC,EAClC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwC,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAsFxH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,qCAAqC,IAAI,8BAA8B,CAAC,0BAA0B,CAAC,CAalH;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAE1E;AAED,wBAAgB,gCAAgC,IAAI,oCAAoC,EAAE,CAEzF;AAED,wBAAgB,+BAA+B,IAAI,4BAA4B,CAE9E;AAED,wBAAgB,4BAA4B,IAAI,iCAAiC,EAAE,CAElF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAyB1F;AAED,wBAAgB,6BAA6B,CAAC,aAAa,SAAS,8BAA8B,EAChG,YAAY,EAAE,aAAa,GAC1B,6BAA6B,CAAC,aAAa,CAAC,CAE9C;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,uCAAuC,EAAE,CAK3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAmD5F;AAED,4EAA4E;AAC5E,wBAAgB,6CAA6C,IAAI,sDAAsD,EAAE,CAGxH;AAED;;;;;;GAMG;AACH,wBAAgB,4CAA4C,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,yCAAyC,GAAG,IAAI,CA0B5I;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sDAAsD,CACpE,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,8BAA8B,CAAC,OAAO,CAAC,GAAG,IAAI,CAWhD;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,IAAI,8BAA8B,EAAE,CAsBvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhF;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAQhE"}
@@ -1,8 +1,8 @@
1
1
  import { existsSync, readFileSync, readdirSync } from 'node:fs';
2
2
  import { isAbsolute, normalize, resolve } from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
- import { describeCaughtError } from '@wildo-ai/saas-backend-lib';
5
4
  import { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';
5
+ import { describeCaughtError } from '@wildo-ai/saas-models';
6
6
  /**
7
7
  * This package is intentionally consumed from compiled `dist/esm`.
8
8
  * Resolving relative to `import.meta.url` keeps local package-preview and
@@ -46,6 +46,23 @@ function readBinaryKnowledgeAsset(relativePath) {
46
46
  assertKnowledgeAssetExists(assetPath, relativePath);
47
47
  return readFileSync(assetPath);
48
48
  }
49
+ /**
50
+ * The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.
51
+ *
52
+ * `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from
53
+ * the backend library. The backend library's copy was imported here twice — before #1412, and again by
54
+ * the #1518 sweep that made the helper mandatory at every catch — and each time that one import made
55
+ * this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency
56
+ * (everything else this package takes from it is an erased `import type` in the playbook definitions),
57
+ * a devDependency is not installed for a consumer of the published package, and a VALUE import on a
58
+ * public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`
59
+ * pins it.
60
+ *
61
+ * The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native
62
+ * `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to
63
+ * cover a call into the engine: put that call behind its own catch in a package allowed to depend on
64
+ * the engine at runtime.
65
+ */
49
66
  function parseJsonKnowledgeBytes(bytes, relativePath) {
50
67
  try {
51
68
  return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
@@ -280,6 +297,35 @@ export function listFrameworkKnowledgeSkillSummaries() {
280
297
  }
281
298
  return summaries.sort((left, right) => left.name.localeCompare(right.name));
282
299
  }
300
+ /**
301
+ * One compiled skill's BODY — the `SKILL.md` a method means when it says "follow the `X` skill".
302
+ *
303
+ * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:
304
+ * that projection is for CHOOSING between skills and carries one line each, and a method that has
305
+ * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods
306
+ * instructed their model to follow a named skill "for the exact field contracts" while only its
307
+ * purpose line ever reached the brief (#1435).
308
+ *
309
+ * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those
310
+ * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs
311
+ * them, and a structured generation cannot open anything — inlining them would put tens of
312
+ * kilobytes of material nobody asked for into every brief. What the body says about them stays
313
+ * true for the coding agent that later executes the work.
314
+ *
315
+ * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than
316
+ * rendering an empty section that reads like a skill with nothing in it.
317
+ */
318
+ export function readFrameworkKnowledgeSkillBody(skillName) {
319
+ // A name is a folder, so anything path-shaped would escape the skills directory. Refused rather
320
+ // than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.
321
+ if (!/^[a-z0-9-]+$/u.test(skillName))
322
+ return null;
323
+ const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;
324
+ const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;
325
+ if (!existsSync(resolveKnowledgeAssetPath(skillPath)))
326
+ return null;
327
+ return readTextKnowledgeAsset(skillPath);
328
+ }
283
329
  export function getFrameworkKnowledgeSkillsIndex() {
284
330
  const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;
285
331
  if (!skillsIndexPath) {
@@ -1 +1 @@
1
- {"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { describeCaughtError } from '@wildo-ai/saas-backend-lib';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
1
+ {"version":3,"file":"framework-knowledge.loader.js","sourceRoot":"","sources":["../../../src/framework-knowledge.loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { createHash } from 'node:crypto';\nimport { isAbsolute, normalize, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type {\n FrameworkKnowledgeAssuranceAuthorityBasis,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistry,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry,\n FrameworkKnowledgeManifest,\n FrameworkKnowledgeJsonArtifact,\n FrameworkKnowledgePlaybook,\n FrameworkKnowledgePlaybookRegistry,\n FrameworkKnowledgePlaybookRegistryEntry,\n FrameworkKnowledgeRegistryDescriptor,\n FrameworkKnowledgeRegistryMap,\n FrameworkKnowledgeTopic,\n FrameworkKnowledgeTopicIndex,\n FrameworkKnowledgeTopicIndexEntry,\n} from './framework-knowledge.schemas.js';\nimport { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';\n\nimport { describeCaughtError } from '@wildo-ai/saas-models';\n/**\n * This package is intentionally consumed from compiled `dist/esm`.\n * Resolving relative to `import.meta.url` keeps local package-preview and\n * published npm consumption on the same `dist/knowledge` seam.\n */\nfunction getFrameworkKnowledgeDirectoryPath(): string {\n return fileURLToPath(new URL('../knowledge/', import.meta.url));\n}\n\nfunction normalizeKnowledgeAssetRelativePath(relativePath: string): string {\n const normalizedRelativePath = normalize(relativePath).replaceAll('\\\\', '/');\n\n if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {\n throw new Error('Framework knowledge asset paths must not be empty.');\n }\n\n if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {\n throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: \"${relativePath}\".`);\n }\n\n return normalizedRelativePath;\n}\n\nfunction resolveKnowledgeAssetPath(relativePath: string): string {\n const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);\n return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);\n}\n\nfunction assertKnowledgeAssetExists(assetPath: string, relativePath: string): void {\n if (existsSync(assetPath)) {\n return;\n }\n\n throw new Error(\n `Missing framework knowledge asset \"${relativePath}\" at \"${assetPath}\". Run \"wildo fwk generate-docs\" to materialize the package payload before consuming it.`,\n );\n}\n\nfunction readJsonKnowledgeAsset<T>(relativePath: string): T {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return JSON.parse(readFileSync(assetPath, 'utf8')) as T;\n}\n\nfunction readTextKnowledgeAsset(relativePath: string): string {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath, 'utf8');\n}\n\nfunction readBinaryKnowledgeAsset(relativePath: string): Uint8Array {\n const assetPath = resolveKnowledgeAssetPath(relativePath);\n assertKnowledgeAssetExists(assetPath, relativePath);\n return readFileSync(assetPath);\n}\n\n/**\n * The ONLY `catch` in this loader, and where its describer comes from matters more than the catch.\n *\n * `describeCaughtError` is imported from `@wildo-ai/saas-models`, a real dependency, and never from\n * the backend library. The backend library's copy was imported here twice — before #1412, and again by\n * the #1518 sweep that made the helper mandatory at every catch — and each time that one import made\n * this package UNLOADABLE for a published consumer: `@wildo-ai/saas-backend-lib` is a devDependency\n * (everything else this package takes from it is an erased `import type` in the playbook definitions),\n * a devDependency is not installed for a consumer of the published package, and a VALUE import on a\n * public entrypoint turns that into a resolution failure at load. `published-entrypoint-dependencies`\n * pins it.\n *\n * The try block is a `TextDecoder.decode` and a `JSON.parse`, so what it catches is a native\n * `TypeError` or `SyntaxError`, which the describer renders as its message. Do not widen the block to\n * cover a call into the engine: put that call behind its own catch in a package allowed to depend on\n * the engine at runtime.\n */\nfunction parseJsonKnowledgeBytes(bytes: Uint8Array, relativePath: string): unknown {\n try {\n return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)) as unknown;\n } catch (error) {\n throw new Error(\n `Framework knowledge asset \"${relativePath}\" is not valid UTF-8 JSON: ${describeCaughtError(error)}`,\n );\n }\n}\n\nexport function resolveFrameworkKnowledgeAssetPath(relativePath: string): string {\n return resolveKnowledgeAssetPath(relativePath);\n}\n\nexport function getFrameworkKnowledgeManifestArtifact(): FrameworkKnowledgeJsonArtifact<FrameworkKnowledgeManifest> {\n const bytes = readBinaryKnowledgeAsset('manifest.json');\n const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json') as FrameworkKnowledgeManifest;\n if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {\n throw new Error(`Unsupported Framework Knowledge artifact version \"${manifest.artifactVersion}\"; expected \"${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}\".`);\n }\n const assuranceAuthorityBasisRegistry = manifest.registries.find(\n (registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n );\n if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {\n throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');\n }\n return { value: manifest, bytes };\n}\n\nexport function getFrameworkKnowledgeManifest(): FrameworkKnowledgeManifest {\n return getFrameworkKnowledgeManifestArtifact().value;\n}\n\nexport function listFrameworkKnowledgeRegistries(): FrameworkKnowledgeRegistryDescriptor[] {\n return getFrameworkKnowledgeManifest().registries;\n}\n\nexport function getFrameworkKnowledgeTopicIndex(): FrameworkKnowledgeTopicIndex {\n return readJsonKnowledgeAsset<FrameworkKnowledgeTopicIndex>('topic-index.json');\n}\n\nexport function listFrameworkKnowledgeTopics(): FrameworkKnowledgeTopicIndexEntry[] {\n return getFrameworkKnowledgeTopicIndex().topics;\n}\n\nexport function getFrameworkKnowledgeTopic(topicId: string): FrameworkKnowledgeTopic | null {\n const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);\n\n if (!topicEntry) {\n return null;\n }\n\n const referencesByFile = Object.fromEntries(\n topicEntry.referenceFiles.map((referenceFileName) => [\n referenceFileName,\n readTextKnowledgeAsset(`references/${referenceFileName}`),\n ]),\n ) as Record<string, string>;\n const skillsByFile = Object.fromEntries(\n topicEntry.skillFiles.map((skillFileName) => [\n skillFileName,\n readTextKnowledgeAsset(`skills/${skillFileName}`),\n ]),\n ) as Record<string, string>;\n\n return {\n entry: topicEntry,\n referencesByFile,\n skillsByFile,\n };\n}\n\nexport function getFrameworkKnowledgeRegistry<TRegistryName extends FrameworkKnowledgeRegistryName>(\n registryName: TRegistryName,\n): FrameworkKnowledgeRegistryMap[TRegistryName] {\n return readJsonKnowledgeAsset<FrameworkKnowledgeRegistryMap[TRegistryName]>(`registries/${registryName}.json`);\n}\n\n/**\n * Lists the compiled meta-workflow playbooks from the `playbooks` registry,\n * sorted by `ref` for stable iteration.\n */\nexport function listFrameworkKnowledgePlaybooks(): FrameworkKnowledgePlaybookRegistryEntry[] {\n const registry = readJsonKnowledgeAsset<FrameworkKnowledgePlaybookRegistry>(\n `registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`,\n );\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));\n}\n\n/**\n * Hydrates one compiled playbook by its `ref` (the folder name under\n * `playbooks/`). Returns `null` when the ref is not in the registry.\n *\n * The returned `playbook` is the generator-validated compiled\n * `playbook.json` (with `method.guidance` inlined from the rendered\n * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from\n * `@wildo-ai/saas-specifications` to recover the typed contract — this package\n * cannot carry that dependency itself.\n */\nexport function getFrameworkKnowledgePlaybook(ref: string): FrameworkKnowledgePlaybook | null {\n const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);\n\n if (!entry) {\n return null;\n }\n\n const evaluationProtocol = entry.evaluationProtocol\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),\n bytes,\n };\n })()\n : null;\n const evaluationTreatment = entry.evaluationTreatment\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),\n bytes,\n };\n })()\n : null;\n const structuredArtifactAction = entry.structuredArtifactAction\n ? (() => {\n const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);\n return {\n value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),\n bytes,\n };\n })()\n : null;\n\n if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {\n throw new Error(`Framework knowledge playbook \"${ref}\" must carry both evaluation protocol and treatment artifacts or neither.`);\n }\n const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);\n const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);\n\n return {\n entry,\n playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),\n playbookBytes,\n methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),\n methodBytes,\n evaluationProtocol,\n evaluationTreatment,\n structuredArtifactAction,\n };\n}\n\n/** Lists portable assurance-authority bases in stable ref/version order. */\nexport function listFrameworkKnowledgeAssuranceAuthorityBases(): FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry[] {\n const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES) as FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);\n}\n\n/**\n * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.\n *\n * `ref@version` is the whole identity — the compatibility generation an application pins. The\n * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a\n * registry shipped in the same payload.\n */\nexport function getFrameworkKnowledgeAssuranceAuthorityBasis(ref: string, version?: number): FrameworkKnowledgeAssuranceAuthorityBasis | null {\n const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter(\n (entry) => entry.ref === ref && (version === undefined || entry.version === version),\n );\n if (candidates.length === 0) return null;\n if (candidates.length !== 1) throw new Error(`Framework Knowledge assurance-authority basis \"${ref}\" is ambiguous without an exact version.`);\n const entry = candidates[0]!;\n const bytes = readBinaryKnowledgeAsset(entry.filePath);\n const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);\n if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" is not a JSON object.`);\n }\n const basisRecord = basis as Record<string, unknown>;\n const implementationRevision = basisRecord.implementationRevision;\n if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" has no implementation revision object.`);\n }\n const implementationRevisionRecord = implementationRevision as Record<string, unknown>;\n if (\n basisRecord.basisRef !== entry.ref ||\n basisRecord.basisVersion !== entry.version ||\n implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef\n ) {\n throw new Error(`Framework Knowledge assurance-authority basis \"${entry.ref}\" does not match its registry identity.`);\n }\n return { entry, basis, bytes };\n}\n\n/**\n * The rights-classified WILDO-objective → external-source mapping shipped beside one basis (#266).\n *\n * ## What it answers, and the question it deliberately does not\n *\n * Which external requirement each WILDO objective was bound to, under whose review, with the\n * attribution notices each source's rights record demands — and which objectives are recorded\n * UNMAPPED, with a reason. It says nothing about whether an application MEETS any of them: that is a\n * programme's coverage decision, and reading a mapping as conformity is the misreading the rights\n * boundary exists to prevent.\n *\n * ## `null` means the payload predates the mapping, NOT that nothing is mapped\n *\n * The registry field is optional because a payload generated before #266 carries none, and a caller\n * must not read that absence as \"this basis binds no external source\" — the two are opposite claims.\n * A payload that DOES carry one and cannot be read throws instead, because that is a broken payload\n * rather than an old one.\n */\nexport function getFrameworkKnowledgeAssuranceExternalFrameworkMapping(\n ref: string,\n version?: number,\n): FrameworkKnowledgeJsonArtifact<unknown> | null {\n const basis = getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version);\n if (basis === null) return null;\n const filePath = basis.entry.externalFrameworkMappingFilePath;\n if (filePath === undefined) return null;\n const bytes = readBinaryKnowledgeAsset(filePath);\n const value = parseJsonKnowledgeBytes(bytes, filePath);\n if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n throw new Error(`Framework Knowledge external-framework mapping for \"${basis.entry.ref}\" is not a JSON object.`);\n }\n return { value, bytes };\n}\n\n/**\n * Returns the compiled skills router (`skills/INDEX.md`) — the single\n * catalog the AI router reads to pick a skill from a user phrasing.\n * Returns `null` when the payload was generated without an authored\n * `src/skills/INDEX.md` (audit Rule 8 warns on that state).\n */\n/**\n * One compiled skill, reduced to what a MODEL choosing between skills needs.\n *\n * `purpose` is the description's leading clause — what the skill DOES — with the\n * `Use when \"…\"` trigger half deliberately dropped. That half exists so a host router can\n * match a human's utterance; a playbook binding a build TASK to a skill is answering a\n * different question, and the triggers trade ~2x the bytes for phrasing it cannot use.\n */\nexport interface FrameworkKnowledgeSkillSummary {\n readonly name: string;\n readonly purpose: string;\n}\n\n/**\n * Every compiled skill's name and purpose — the catalog a generation call must choose from.\n *\n * Exists because a playbook METHOD can instruct a model to \"route through the skills index\"\n * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO\n * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54\n * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task\n * the dispatch playbook cannot run.\n *\n * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is\n * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104\n * skills and drops nothing a chooser needs.\n *\n * Sorted by name so a brief built twice from one artifact is byte-identical.\n */\nexport function listFrameworkKnowledgeSkillSummaries(): FrameworkKnowledgeSkillSummary[] {\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);\n if (!existsSync(absoluteSkillsDirectory)) {\n return [];\n }\n const summaries: FrameworkKnowledgeSkillSummary[] = [];\n for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {\n if (!entry.isDirectory()) continue;\n const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) continue;\n const frontmatter = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/.exec(readTextKnowledgeAsset(skillPath));\n if (!frontmatter) continue;\n const name = /^name:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n const description = /^description:\\s*(.+)$/m.exec(frontmatter[1]!)?.[1]?.trim();\n if (!name || !description) continue;\n const unquoted = description.replace(/^[\"']|[\"']$/g, '');\n // The trigger half starts at \"Use when\"; everything before it is the purpose.\n const purpose = unquoted.split(/\\s*Use when/)[0]!.trim();\n summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });\n }\n return summaries.sort((left, right) => left.name.localeCompare(right.name));\n}\n\n/**\n * One compiled skill's BODY — the `SKILL.md` a method means when it says \"follow the `X` skill\".\n *\n * Distinct from {@link listFrameworkKnowledgeSkillSummaries}, which answers a different question:\n * that projection is for CHOOSING between skills and carries one line each, and a method that has\n * already chosen needs the contract rather than the choice. Measured 2026-09-22, three methods\n * instructed their model to follow a named skill \"for the exact field contracts\" while only its\n * purpose line ever reached the brief (#1435).\n *\n * The BODY ONLY. A skill folder also carries `references/`, `examples/` and `scripts/`, and those\n * are deliberately not returned: they are the on-demand tier a CODING agent opens when it needs\n * them, and a structured generation cannot open anything — inlining them would put tens of\n * kilobytes of material nobody asked for into every brief. What the body says about them stays\n * true for the coding agent that later executes the work.\n *\n * `null` for a name no skill folder answers to, so a caller can report a dangling ref rather than\n * rendering an empty section that reads like a skill with nothing in it.\n */\nexport function readFrameworkKnowledgeSkillBody(skillName: string): string | null {\n // A name is a folder, so anything path-shaped would escape the skills directory. Refused rather\n // than sanitized: every real caller passes an authored `skillRefs` entry, which is `[a-z0-9-]+`.\n if (!/^[a-z0-9-]+$/u.test(skillName)) return null;\n const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;\n const skillPath = `${skillsDirectory}/${skillName}/SKILL.md`;\n if (!existsSync(resolveKnowledgeAssetPath(skillPath))) return null;\n return readTextKnowledgeAsset(skillPath);\n}\n\nexport function getFrameworkKnowledgeSkillsIndex(): string | null {\n const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;\n\n if (!skillsIndexPath) {\n return null;\n }\n\n return readTextKnowledgeAsset(skillsIndexPath);\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
1
+ {"version":3,"file":"framework-knowledge.schemas.js","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAExD,MAAM,CAAN,IAAY,8BAKX;AALD,WAAY,8BAA8B;IACxC,6DAA2B,CAAA;IAC3B,uEAAqC,CAAA;IACrC,yDAAuB,CAAA;IACvB,yFAAuD,CAAA;AACzD,CAAC,EALW,8BAA8B,KAA9B,8BAA8B,QAKzC;AAED,MAAM,CAAN,IAAY,qCAGX;AAHD,WAAY,qCAAqC;IAC/C,gEAAuB,CAAA;IACvB,kEAAyB,CAAA;AAC3B,CAAC,EAHW,qCAAqC,KAArC,qCAAqC,QAGhD;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,sCAEX;AAFD,WAAY,sCAAsC;IAChD,+GAAqE,CAAA;AACvE,CAAC,EAFW,sCAAsC,KAAtC,sCAAsC,QAEjD","sourcesContent":["export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';\n\nexport enum FrameworkKnowledgeRegistryName {\n SOURCE_TAGS = 'source-tags',\n FRAMEWORK_TOPICS = 'framework-topics',\n PLAYBOOKS = 'playbooks',\n ASSURANCE_AUTHORITY_BASES = 'assurance-authority-bases',\n}\n\nexport enum FrameworkKnowledgeSourceReferenceKind {\n FULL_FILE = 'full-file',\n PART_RANGE = 'part-range',\n}\n\n/**\n * The JSON-v1 authoring format was retired (and its member deleted) at the\n * first-activation hard cut; every authored playbook is an effect-free native\n * TypeScript declaration.\n */\nexport enum FrameworkKnowledgePlaybookSourceFormat {\n EFFECT_FREE_TYPESCRIPT_MODULE_V1 = 'EFFECT_FREE_TYPESCRIPT_MODULE_V1',\n}\n\n/**\n * Directory/file inventory of the compiled payload, mirrored 1:1 by the\n * generator-local `FrameworkKnowledgeManifestShape` in\n * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.\n * The two shapes are deliberately duplicated (the audit/generator must stay\n * buildless w.r.t. this package) — extending one WITHOUT the other silently\n * ships a payload the typed loader cannot see. Keep them in lockstep.\n */\nexport interface FrameworkKnowledgePayloadInventory {\n topicIndexPath: string;\n registriesDirectory: string;\n referencesDirectory: string;\n skillsDirectory: string;\n /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */\n playbooksDirectory: string;\n /** Compiled application-creation transition route home. */\n /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */\n assuranceAuthorityBasesDirectory: string;\n /**\n * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.\n *\n * Distinct from a skill: a skill is reached when the router matches a request description, which\n * requires the agent to already suspect the topic. A rule is policy that must be present when the\n * agent opens a matching file, without being asked for.\n *\n * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been\n * documented and never built, so a payload generated before that carries none. A required field\n * would make every previously generated payload unloadable to fix a delivery gap.\n */\n rulesDirectory?: string;\n /**\n * Compiled skills router (`skills/INDEX.md`), rendered from the authored\n * `src/skills/INDEX.md` — the single router truth. Absent when the authored\n * catalog file does not exist (audit Rule 8 warns on that state). It is\n * deliberately NOT attached to any topic entry: the catalog is cross-topic\n * and `getFrameworkKnowledgeTopic` would misfile it.\n */\n skillsIndexPath?: string;\n}\n\nexport interface FrameworkKnowledgeRegistryDescriptor {\n registryName: FrameworkKnowledgeRegistryName;\n filePath: string;\n description: string;\n entryCount: number;\n}\n\nexport interface FrameworkKnowledgeManifest {\n artifactVersion: string;\n frameworkVersion: string;\n generatorVersion: string;\n generatedAt: string;\n packageName: string;\n topicCount: number;\n referenceFileCount: number;\n payload: FrameworkKnowledgePayloadInventory;\n registries: FrameworkKnowledgeRegistryDescriptor[];\n}\n\nexport interface FrameworkKnowledgeSourceReference {\n kind: FrameworkKnowledgeSourceReferenceKind;\n tagName: string;\n filePath: string;\n startLine?: number;\n endLine?: number;\n}\n\nexport interface FrameworkKnowledgeTopicIndexEntry {\n topicId: string;\n title: string;\n tags: string[];\n facets: string[];\n categories: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n referenceFiles: string[];\n skillFiles: string[];\n registryKeys: FrameworkKnowledgeRegistryName[];\n}\n\nexport interface FrameworkKnowledgeTopicIndex {\n topics: FrameworkKnowledgeTopicIndexEntry[];\n}\n\nexport interface FrameworkKnowledgeTopic {\n entry: FrameworkKnowledgeTopicIndexEntry;\n referencesByFile: Record<string, string>;\n skillsByFile: Record<string, string>;\n}\n\nexport interface FrameworkKnowledgeTopicRegistryEntry {\n topicId: string;\n title: string;\n categories: string[];\n referenceFilePath?: string;\n sourceReferenceCount: number;\n}\n\nexport interface FrameworkKnowledgeSourceTagRegistryEntry {\n referenceFilePath: string;\n skillFilePath?: string;\n extractedAt: string;\n facets: string[];\n sourceReferences: FrameworkKnowledgeSourceReference[];\n}\n\n/**\n * One compiled meta-workflow playbook, as listed in the `playbooks` registry.\n *\n * Enum-backed playbook fields (`phase`, `executor`) are\n * surfaced as plain strings here: this package has zero dependencies by\n * design, so it cannot import the `MetaWorkflow_*` enums from\n * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse\n * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with\n * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already\n * validated it, so the parse is a type-recovery step, not a trust boundary.\n */\nexport interface FrameworkKnowledgePlaybookRegistryEntry {\n ref: string;\n version: string;\n phase: string;\n /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */\n executor?: string;\n intent: string;\n /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */\n skillRefs: string[];\n /** Payload-relative path of the compiled `playbook.json`. */\n playbookFilePath: string;\n /** Payload-relative path of the rendered `method.md`. */\n methodFilePath: string;\n /** Canonical structured authoring format used to compile this entry. */\n sourceFormat: FrameworkKnowledgePlaybookSourceFormat;\n evaluationProtocol?: {\n protocolRef: string;\n protocolVersion: number;\n filePath: string;\n };\n evaluationTreatment?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n structuredArtifactAction?: {\n definitionRef: string;\n definitionVersion: number;\n filePath: string;\n };\n}\n\n/**\n * Zero-dependency registry identity for one compiled assurance-authority basis.\n *\n * `ref@version` IS the identity: `version` is the declared compatibility generation. The three\n * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —\n * they compared the compiled payload against a registry that ships in the same payload, and the\n * basis digest additionally forced every consuming application to re-accept its controls on any\n * engine byte movement (`.claude/rules/one-source-of-truth.md`).\n */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {\n ref: string;\n version: number;\n sourceRevisionRef: string;\n filePath: string;\n /**\n * The rights-classified WILDO-objective → external-source mapping DERIVED from this basis (#266).\n *\n * Beside the basis rather than in its own channel because it is a projection of exactly these\n * bytes: derived in the same pass, from the same value, so it cannot describe a different basis\n * than the one it ships with. A separate channel would be free to disagree, and a mapping is read\n * precisely by people who cannot check it.\n *\n * OPTIONAL for the same reason `rulesDirectory` is: a payload generated before this existed carries\n * none, and a required field would make every one of them unloadable to fix a delivery gap.\n */\n externalFrameworkMappingFilePath?: string;\n}\n\n/** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */\nexport interface FrameworkKnowledgeAssuranceAuthorityBasis {\n entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;\n basis: unknown;\n bytes: Uint8Array;\n}\n\n/** Exact JSON artifact bytes plus their parsed zero-dependency projection. */\nexport interface FrameworkKnowledgeJsonArtifact<TValue> {\n value: TValue;\n bytes: Uint8Array;\n}\n\n/**\n * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.\n */\nexport interface FrameworkKnowledgePlaybook {\n entry: FrameworkKnowledgePlaybookRegistryEntry;\n /**\n * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`\n * content (with `method.guidance` inlined from the rendered `method.md`).\n * Typed `unknown` because this package cannot depend on\n * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to\n * recover the typed contract.\n */\n playbook: unknown;\n /** Exact compiled `playbook.json` bytes used for source provenance. */\n playbookBytes: Uint8Array;\n /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */\n methodMarkdown: string;\n /** Exact rendered `method.md` bytes used for source provenance. */\n methodBytes: Uint8Array;\n /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationProtocol: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */\n evaluationTreatment: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */\n structuredArtifactAction: {\n value: unknown;\n bytes: Uint8Array;\n } | null;\n}\n\nexport interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {\n name: TName;\n metadata?: Record<string, unknown>;\n entries: Record<string, TEntry>;\n}\n\nexport type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.SOURCE_TAGS,\n FrameworkKnowledgeSourceTagRegistryEntry\n>;\n\nexport type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS,\n FrameworkKnowledgeTopicRegistryEntry\n>;\n\nexport type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.PLAYBOOKS,\n FrameworkKnowledgePlaybookRegistryEntry\n>;\n\nexport type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<\n FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES,\n FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry\n>;\n\nexport interface FrameworkKnowledgeRegistryMap {\n [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;\n [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;\n [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;\n [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;\n}\n\nexport type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC"}
@@ -18,7 +18,7 @@
18
18
  */
19
19
  export declare const playbookDefinition: {
20
20
  readonly ref: "bottom_up.assemble-verify";
21
- readonly version: "0.3.0";
21
+ readonly version: "0.3.1";
22
22
  readonly phase: "bottom_up";
23
23
  readonly intent: "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.";
24
24
  readonly preconditions: readonly [{
@@ -32,7 +32,7 @@ export declare const playbookDefinition: {
32
32
  }];
33
33
  readonly outputs: readonly [];
34
34
  readonly method: {
35
- readonly skillRefs: readonly ["journey-status", "journey-report", "journey-approve", "application-database-migrations"];
35
+ readonly skillRefs: readonly ["application-database-migrations"];
36
36
  };
37
37
  readonly executor: "deterministic_cli";
38
38
  readonly approval: "approve_result";
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CAoCrB,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;CAiCrB,CAAC"}
@@ -18,7 +18,7 @@
18
18
  */
19
19
  export const playbookDefinition = {
20
20
  "ref": "bottom_up.assemble-verify",
21
- "version": "0.3.0",
21
+ "version": "0.3.1",
22
22
  "phase": "bottom_up",
23
23
  "intent": "Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.",
24
24
  "preconditions": [
@@ -30,9 +30,6 @@ export const playbookDefinition = {
30
30
  "outputs": [],
31
31
  "method": {
32
32
  "skillRefs": [
33
- "journey-status",
34
- "journey-report",
35
- "journey-approve",
36
33
  "application-database-migrations"
37
34
  ]
38
35
  },
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,uoEAAuoE;IACjpE,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;KACtE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,YAAY,EAAE;KAC3B;IACD,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE;QACR,WAAW,EAAE;YACX,gBAAgB;YAChB,gBAAgB;YAChB,iBAAiB;YACjB,iCAAiC;SAClC;KACF;IACD,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B;;;;;;;OAOG;IACH,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,OAAO;KACzB;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for topic 7 — the app-wide assemble/verify step.\n *\n * REBUILT rather than restored (issue #147). A playbook of this ref existed from\n * 2026-07-10 and was deleted on 2026-08-25 with the app-creation digest\n * demolition; the question it asked went with it, even though answering \"does\n * the built application assemble?\" needs no digests. Restoring it verbatim was\n * rejected: it declared the retired `COMPOSITE` executor, depended on two\n * families the demolition removed (`foundation-manifest`, `build-verification`),\n * and its method was explicit that NONE of its checks were actually run by the\n * runner — `// TODO CLI COMMAND:` placeholders and \"companion affordances that\n * do not exist yet\".\n *\n * What is different now is that the checks RUN. `DETERMINISTIC_CLI` is honoured\n * by the runtime as of #147, and the check refs below resolve through the same\n * closed `APPLICATION_CODING_TASK_VERIFICATION_CATALOG` a coding task uses, so\n * an unknown ref is refused rather than silently skipped.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.assemble-verify\",\n \"version\": \"0.3.0\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.\",\n \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"build-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"build-plan\" }\n ],\n \"outputs\": [],\n \"method\": {\n \"skillRefs\": [\n \"journey-status\",\n \"journey-report\",\n \"journey-approve\",\n \"application-database-migrations\"\n ]\n },\n \"executor\": \"deterministic_cli\",\n \"approval\": \"approve_result\",\n /*\n * Token and model-call ceilings are OMITTED, not zeroed.\n *\n * Every field here is optional, and this tier makes no model calls at all — it runs typechecks in\n * a subprocess. Declaring `maxModelCalls: 0` is rejected by the schema (positive only), and\n * declaring `1` to satisfy it would state a ceiling nobody chose for a resource that is never\n * consumed. What IS bounded is wall-clock and how many times the step may run.\n */\n \"budget\": {\n \"maxRuns\": 40,\n \"maxDurationMs\": 3600000\n },\n \"onFailure\": \"keep_and_flag\",\n} as const;\n"]}
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.assemble-verify/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,2BAA2B;IAClC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,uoEAAuoE;IACjpE,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;KACtE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,YAAY,EAAE;KAC3B;IACD,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE;QACR,WAAW,EAAE;YACX,iCAAiC;SAClC;KACF;IACD,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,gBAAgB;IAC5B;;;;;;;OAOG;IACH,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,OAAO;KACzB;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for topic 7 — the app-wide assemble/verify step.\n *\n * REBUILT rather than restored (issue #147). A playbook of this ref existed from\n * 2026-07-10 and was deleted on 2026-08-25 with the app-creation digest\n * demolition; the question it asked went with it, even though answering \"does\n * the built application assemble?\" needs no digests. Restoring it verbatim was\n * rejected: it declared the retired `COMPOSITE` executor, depended on two\n * families the demolition removed (`foundation-manifest`, `build-verification`),\n * and its method was explicit that NONE of its checks were actually run by the\n * runner — `// TODO CLI COMMAND:` placeholders and \"companion affordances that\n * do not exist yet\".\n *\n * What is different now is that the checks RUN. `DETERMINISTIC_CLI` is honoured\n * by the runtime as of #147, and the check refs below resolve through the same\n * closed `APPLICATION_CODING_TASK_VERIFICATION_CATALOG` a coding task uses, so\n * an unknown ref is refused rather than silently skipped.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.assemble-verify\",\n \"version\": \"0.3.1\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Bottom-up assemble & verify — the FINAL bottom-up step and the capstone of the build: the pivot from having BUILT the application (the decompose / dispatch / scale loop authored its modules, resources, config and integrations) to answering ONE mechanical question — does the built application ASSEMBLE? It runs the deterministic verification set over the application's four workspace packages (specifications, shared-lib, backend-api, frontend) OUTSIDE any coding agent, and reports a per-check outcome. It fixes NOTHING: a failure is surfaced for a refinement re-dispatch, which is a different playbook's job, and it authors no schemas and writes no code. Deliberately DISTINCT from the refinement phase's coverage audit, which also binds topic 7 but asks a SEMANTIC question (does the built app match the intent — specs diffed against introspected reality). This playbook never diffs intent against reality; if you are judging coverage you are in the refinement lane. Scope honesty for v0.3: the check set is the whole-application TYPECHECK across the four packages — the question 'does it compile as one program', which no per-task check can answer because the dispatch lane typechecks only the package a task mutated — PLUS the schema-plan drift gate (`check:schema-plan-in-sync`), which asks whether the modelled resources have migrations behind them. The second is not a variant of the first: on a PostgreSQL-backed application a table exists only because a migration built it, so a resource whose migration was never generated compiles green in all four packages and then refuses to boot on `postgresql_table_schema_mismatch` — invisible to a typecheck, because no type in the program knows whether a table exists. It is safe on MongoDB applications and on unbuilt trees because it resolves three outcomes (not adopted / could-not-ask / decided) rather than reading an exit code. A boot probe, the whole test suite, `wildo config validate` and OpenAPI/docs regeneration are NOT in this set: each needs a running stack or a companion affordance that does not exist, and declaring them here without running them is exactly what made the deleted version of this playbook inert.\",\n \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"build-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"build-plan\" }\n ],\n \"outputs\": [],\n \"method\": {\n \"skillRefs\": [\n \"application-database-migrations\"\n ]\n },\n \"executor\": \"deterministic_cli\",\n \"approval\": \"approve_result\",\n /*\n * Token and model-call ceilings are OMITTED, not zeroed.\n *\n * Every field here is optional, and this tier makes no model calls at all — it runs typechecks in\n * a subprocess. Declaring `maxModelCalls: 0` is rejected by the schema (positive only), and\n * declaring `1` to satisfy it would state a ceiling nobody chose for a resource that is never\n * consumed. What IS bounded is wall-clock and how many times the step may run.\n */\n \"budget\": {\n \"maxRuns\": 40,\n \"maxDurationMs\": 3600000\n },\n \"onFailure\": \"keep_and_flag\",\n} as const;\n"]}
@@ -0,0 +1,135 @@
1
+ import { MetaWorkflow_ApprovalPolicy, MetaWorkflow_EvaluationVerdict, MetaWorkflow_FailurePolicy, MetaWorkflow_PredicateKind } from '@wildo-ai/saas-models/meta-workflows';
2
+ import { MetaWorkflow_InputRender, MetaWorkflow_Phase } from '@wildo-ai/saas-specifications/application-creation';
3
+ /**
4
+ * The BUILD LANE — from an accepted conception to a built, verified application and its maturity
5
+ * reading (#1501, epic #1506).
6
+ *
7
+ * Until this existed `build-decompose`, `build-dispatch` and `assemble-verify` were driven by hand or
8
+ * by `dispatch_next`: a task that could not land was re-offered until the loop guard stopped it, a
9
+ * coherence GAP found after the build had no way back to conception, and the lane ended on four
10
+ * typechecks with no reading of what was built against what was required. This lane runs the three
11
+ * as one choreography — decompose, then dispatch until the plan is exhausted, then assemble — and it
12
+ * will end on the maturity reading (#1496): a stage against the requirements, never a "done".
13
+ *
14
+ * ## The lane's OWN gate is the conception lane's output
15
+ *
16
+ * READINESS on the placement plan, which is the last family the conception lane lands and the one
17
+ * the decomposer only EXPECTS on its own (`artifact_expected`, so a standalone decompose may run
18
+ * without it — which is how an application came to have no navigation, #1265 R-6). Gating the lane
19
+ * at READINESS is what makes "the decomposer cannot start before placement has landed" true for a
20
+ * build driven through the lane: the leaf keeps its own sequencing gate and its own explicit-run
21
+ * door, and the lane will not open until placement is on record. The domain plan is declared for the
22
+ * same reason, and both are declared as inputs (audit rule 24).
23
+ *
24
+ * ## The dispatch LOOP is the child being re-offered, on purpose
25
+ *
26
+ * `build-dispatch` is a `CODING_AGENT` step: one run dispatches ONE ready task (a coding run, or a
27
+ * companion-owned generation step — labels, logo, emails, seeds — routed by the task's own target
28
+ * kind), waits for it, and reports. It lands no family, so the runtime never marks it delivered and
29
+ * offers it again every round: that IS the loop. The plan's readiness is re-derived from git each
30
+ * time, so a task accepted between two rounds unblocks its dependents without anyone re-planning.
31
+ *
32
+ * ## How the lane SEES its own work, and where it ends
33
+ *
34
+ * Both halves were measured missing on this lane's first live run and both are now built (#1501):
35
+ *
36
+ * - **A dispatch child reports what it did**, as a step value under `dispatch:<ref>` — the task, its
37
+ * kind, how its coding run settled, and how much of the plan is left. Before that a child which
38
+ * lands no family returned nothing into the run's scope, so the round history carried the objective
39
+ * and no outcome: over twenty live rounds the selector narrated task names it could not have seen
40
+ * and finally instructed the child to "inspect the recorded D4 outcome for the immediately preceding
41
+ * dispatch" — the composite asking to be told what it should have been handed.
42
+ * - **An exhausted plan withholds dispatch** rather than failing it. `BUILD_PLAN_EXHAUSTED` is the
43
+ * twin of `NOTHING_TO_DECOMPOSE` one step down the same plan, and READINESS where that one is
44
+ * SEQUENCING: re-decomposing a finished plan succeeds, dispatching one cannot, and only READINESS
45
+ * ends the loop inside an explicitly-run lane, where sequencing is bypassed. So the round that
46
+ * used to re-offer a dispatch that threw now offers `assemble-verify`, and the lane ends there.
47
+ * - **A plan whose every ready task is stuck withholds dispatch too.** `BUILD_PLAN_BLOCKED_ON_STUCK_TASKS`
48
+ * is exhaustion's twin for "tasks remain, and none that is ready can run": the dispatcher refuses
49
+ * before starting one, so the lane stops offering it and says which tasks hold it, instead of
50
+ * failing a dispatch every round (#1547).
51
+ *
52
+ * What is still a report rather than a route: a task that cannot land (parked on a question, or
53
+ * refused) re-opens `bottom_up.build-decompose` in refine mode only once a verdict routes (#1498),
54
+ * and that declaration belongs on a revise child rather than on this lane.
55
+ *
56
+ * ## `build-scale` is admitted, and today it runs as a dispatch
57
+ *
58
+ * Admitted in c6a1a235 (#1273) because nothing else could ever reach it. This section used to argue
59
+ * the opposite, and it was left standing beside that admission — a lane saying two things at once.
60
+ * What is true now: `build-scale` declares the same executor as `build-dispatch` and runs through
61
+ * the same single-flight branch, one ready task per run. The wave its method describes does not
62
+ * exist yet (the runtime says so where it reports a dispatch, and `remainingReadyTaskRefs` keeps a
63
+ * scale run from reading as a wave it never ran). #1528 owns building it. Until then the method
64
+ * tells the selector to prefer `build-dispatch`, so the two names do not compete for one act.
65
+ *
66
+ * ## The lane ENDS on the maturity reading (#1496, admitted 2026-09-22 when its leaf landed)
67
+ *
68
+ * `bottom_up.assemble-verify` answers whether what was built ASSEMBLES — four typechecks and a
69
+ * migration probe, its own method saying it "does not boot the application, run its test suite".
70
+ * `bottom_up.maturity-reading` answers the question that makes the lane worth running: which of the
71
+ * application's own requirements are addressed, by what evidence, and what STAGE that puts it at.
72
+ *
73
+ * Paul, 2026-09-22: *"there are no 'Done' for an app, there are a measurement face to requirements,
74
+ * with some stage … this measurement should be evolutive."* So the lane's closing decision is read
75
+ * against the reading, and a run that stops short of it has not finished — which is why it is listed
76
+ * FIRST in `admits`, where the trap check puts the closing move.
77
+ *
78
+ * **Only this lane admits it, deliberately.** Its own gate is `artifact_exists: requirements`, so it
79
+ * could be offered far earlier — and a reading of an application nobody has conceived says "nothing is
80
+ * addressed", which is true and worth nothing. A second admitter would also let one root run land the
81
+ * same reading twice from the same inputs, because a nested lane's delivered set is its own. The root's
82
+ * ending is the boundary decision READ AGAINST whatever reading is on record, not a second reading.
83
+ *
84
+ * The surface lanes' work (UX #1493, website #1492, documentation #1494, integration #1495) feeds the
85
+ * same task graph through DECOMPOSITION rather than through new children here — their plans are the
86
+ * conception lane's, and the decomposer declares all of them as inputs.
87
+ *
88
+ * ## Loop-back — declared when the mechanism exists
89
+ *
90
+ * | signal | re-opens | how, once it can |
91
+ * |---|---|---|
92
+ * | a task that cannot land (parked, refused, failed twice) | `bottom_up.build-decompose` in refine mode | verdict routing (#1498) on the dispatch report |
93
+ * | a coherence GAP naming a module or relationship | `bottom_up.domain-plan`, through the root | the root routes it to the conception lane (#1503, after #1497) |
94
+ * | a domain plan or placement newer than the landed build plan | `bottom_up.build-decompose` | ALREADY WORKS — the decompose completion gate re-opens on any newer upstream commit |
95
+ */
96
+ export declare const playbookDefinition: {
97
+ ref: string;
98
+ version: string;
99
+ phase: MetaWorkflow_Phase.BOTTOM_UP;
100
+ intent: string;
101
+ preconditions: {
102
+ kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID;
103
+ selector: {
104
+ family: string;
105
+ };
106
+ }[];
107
+ inputs: {
108
+ family: string;
109
+ render: MetaWorkflow_InputRender.MAP;
110
+ }[];
111
+ outputs: any[];
112
+ stepOutputs: {
113
+ ref: string;
114
+ condensation: string;
115
+ }[];
116
+ method: {
117
+ skillRefs: any[];
118
+ choreography: {
119
+ admits: string[];
120
+ maximumIterations: number;
121
+ maximumLanesPerIteration: number;
122
+ maximumDurationMs: number;
123
+ reopenOnVerdict: {
124
+ whenVerdictOf: string;
125
+ criterionRef: string;
126
+ verdicts: MetaWorkflow_EvaluationVerdict.GAP[];
127
+ reopen: string[];
128
+ }[];
129
+ };
130
+ };
131
+ approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT;
132
+ budget: {};
133
+ onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG;
134
+ };
135
+ //# sourceMappingURL=playbook.definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.build/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkH9B,CAAC"}