@wildo-ai/framework-knowledge 1.1.0

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 (922) hide show
  1. package/LICENSE +34 -0
  2. package/dist/esm/.builder.pid +9 -0
  3. package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
  4. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
  5. package/dist/esm/framework-knowledge.definitions.js +1571 -0
  6. package/dist/esm/framework-knowledge.definitions.js.map +1 -0
  7. package/dist/esm/framework-knowledge.loader.d.ts +72 -0
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
  9. package/dist/esm/framework-knowledge.loader.js +258 -0
  10. package/dist/esm/framework-knowledge.loader.js.map +1 -0
  11. package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
  12. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
  13. package/dist/esm/framework-knowledge.schemas.js +23 -0
  14. package/dist/esm/framework-knowledge.schemas.js.map +1 -0
  15. package/dist/esm/index.d.ts +4 -0
  16. package/dist/esm/index.d.ts.map +1 -0
  17. package/dist/esm/index.js +4 -0
  18. package/dist/esm/index.js.map +1 -0
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
  27. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
  30. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
  32. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
  33. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
  34. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
  35. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
  36. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
  37. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
  38. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
  40. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
  42. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
  43. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
  44. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
  45. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
  46. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
  47. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
  48. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
  51. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
  52. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
  53. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
  54. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
  55. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
  56. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
  57. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
  58. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
  59. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
  60. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
  62. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
  64. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
  66. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
  68. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
  70. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
  72. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
  73. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
  74. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
  75. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
  76. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
  77. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
  78. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
  79. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
  80. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
  82. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
  84. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
  85. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
  86. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
  87. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
  88. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
  89. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
  90. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
  91. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
  92. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
  94. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
  96. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
  98. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
  100. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
  103. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
  104. package/dist/knowledge/manifest.json +45 -0
  105. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
  106. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
  107. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
  108. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
  109. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
  110. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
  111. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
  113. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
  118. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
  119. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
  122. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
  123. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
  124. package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
  125. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
  126. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
  127. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
  128. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
  129. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
  130. package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
  131. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
  132. package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
  133. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
  134. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
  135. package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
  136. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
  137. package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
  138. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
  139. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
  140. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
  141. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
  142. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  143. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
  144. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  145. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
  150. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
  152. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
  153. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
  154. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
  157. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
  158. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
  159. package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
  160. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
  161. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
  162. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
  163. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
  164. package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
  165. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
  166. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
  167. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
  168. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
  169. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
  170. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
  171. package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
  172. package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
  173. package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
  174. package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
  175. package/dist/knowledge/references/assertions.references.conventions.md +92 -0
  176. package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
  177. package/dist/knowledge/references/assertions.specification.config.md +287 -0
  178. package/dist/knowledge/references/brand.asset.config.md +167 -0
  179. package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
  180. package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
  181. package/dist/knowledge/references/brand.name.config.md +46 -0
  182. package/dist/knowledge/references/brand.snapshot.config.md +76 -0
  183. package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
  184. package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
  185. package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
  186. package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
  187. package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
  188. package/dist/knowledge/references/business-model.references.conventions.md +99 -0
  189. package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
  190. package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
  191. package/dist/knowledge/references/cli.market.generate-command.md +230 -0
  192. package/dist/knowledge/references/cli.market.utils.md +147 -0
  193. package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
  194. package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
  195. package/dist/knowledge/references/companion.market.generation-service.md +270 -0
  196. package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
  197. package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
  198. package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
  199. package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
  200. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
  201. package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
  202. package/dist/knowledge/references/engine.saas-website.config.md +331 -0
  203. package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
  204. package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
  205. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
  206. package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
  207. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
  208. package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
  209. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
  210. package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
  211. package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
  213. package/dist/knowledge/references/example.config.design-system.full.md +162 -0
  214. package/dist/knowledge/references/example.config.navigation.full.md +71 -0
  215. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
  216. package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
  217. package/dist/knowledge/references/example.email.template.minimal.md +54 -0
  218. package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
  219. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
  220. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
  221. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
  222. package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
  223. package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
  224. package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
  225. package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
  226. package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
  227. package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
  228. package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
  229. package/dist/knowledge/references/example.market.category.config.md +71 -0
  230. package/dist/knowledge/references/example.market.channel.community.md +39 -0
  231. package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
  232. package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
  233. package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
  234. package/dist/knowledge/references/example.market.icp.individual.md +82 -0
  235. package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
  236. package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
  237. package/dist/knowledge/references/example.market.job.emotional.md +27 -0
  238. package/dist/knowledge/references/example.market.job.functional.md +28 -0
  239. package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
  240. package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
  241. package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
  242. package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
  243. package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
  244. package/dist/knowledge/references/example.market.proof.metric.md +39 -0
  245. package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
  246. package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
  247. package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
  248. package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
  249. package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
  250. package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
  251. package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
  252. package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
  253. package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
  254. package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
  255. package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
  256. package/dist/knowledge/references/example.module.registration.shared.md +16 -0
  257. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
  258. package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
  259. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
  260. package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
  261. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
  262. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
  263. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
  264. package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
  265. package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
  266. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
  267. package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
  268. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
  269. package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
  270. package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
  271. package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
  272. package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
  273. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
  274. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
  275. package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
  276. package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
  277. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
  278. package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
  279. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
  280. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
  281. package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
  282. package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
  283. package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
  284. package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
  285. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
  286. package/dist/knowledge/references/market.alternative.config.md +68 -0
  287. package/dist/knowledge/references/market.alternative.kind.md +32 -0
  288. package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
  289. package/dist/knowledge/references/market.buying-journey.config.md +43 -0
  290. package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
  291. package/dist/knowledge/references/market.category.config.md +63 -0
  292. package/dist/knowledge/references/market.channel.config.md +59 -0
  293. package/dist/knowledge/references/market.channel.kind.md +49 -0
  294. package/dist/knowledge/references/market.context-block.builder.md +544 -0
  295. package/dist/knowledge/references/market.context-block.response.md +57 -0
  296. package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
  297. package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
  298. package/dist/knowledge/references/market.gain.config.md +50 -0
  299. package/dist/knowledge/references/market.generation.response.md +108 -0
  300. package/dist/knowledge/references/market.icp.config.md +162 -0
  301. package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
  302. package/dist/knowledge/references/market.inherit-from.md +74 -0
  303. package/dist/knowledge/references/market.is-benefit-available.md +58 -0
  304. package/dist/knowledge/references/market.job.config.md +48 -0
  305. package/dist/knowledge/references/market.message-template.config.md +86 -0
  306. package/dist/knowledge/references/market.objection.config.md +56 -0
  307. package/dist/knowledge/references/market.objection.kind.md +34 -0
  308. package/dist/knowledge/references/market.pain.config.md +50 -0
  309. package/dist/knowledge/references/market.persona.config.md +64 -0
  310. package/dist/knowledge/references/market.positioning.config.md +84 -0
  311. package/dist/knowledge/references/market.proof.config.md +48 -0
  312. package/dist/knowledge/references/market.proof.kind.md +34 -0
  313. package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
  314. package/dist/knowledge/references/market.scoring.fit.md +215 -0
  315. package/dist/knowledge/references/market.snapshot.config.md +34 -0
  316. package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
  317. package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
  318. package/dist/knowledge/references/market.trigger.config.md +45 -0
  319. package/dist/knowledge/references/market.trigger.kind.md +35 -0
  320. package/dist/knowledge/references/placement-plan.config.md +330 -0
  321. package/dist/knowledge/references/platform.config.application-database.md +74 -0
  322. package/dist/knowledge/references/platform.config.application-modules.md +30 -0
  323. package/dist/knowledge/references/platform.config.backing-services.md +266 -0
  324. package/dist/knowledge/references/platform.config.cdn.md +167 -0
  325. package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
  326. package/dist/knowledge/references/platform.config.saas.md +405 -0
  327. package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
  328. package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
  329. package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
  330. package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
  331. package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
  332. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
  333. package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
  334. package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
  335. package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
  336. package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
  337. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
  338. package/dist/knowledge/references/requirements.references.conventions.md +125 -0
  339. package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
  340. package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
  341. package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
  342. package/dist/knowledge/references/roadmap.phase.config.md +149 -0
  343. package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
  344. package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
  345. package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
  346. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
  347. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
  348. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
  349. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
  350. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
  351. package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
  352. package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
  355. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
  358. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
  359. package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
  360. package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
  361. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
  362. package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
  363. package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
  364. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
  365. package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
  366. package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
  367. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
  368. package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
  369. package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
  370. package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
  371. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
  372. package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
  373. package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
  374. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
  375. package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
  376. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
  377. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
  378. package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
  379. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
  380. package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
  381. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
  382. package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
  383. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
  385. package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
  386. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
  388. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
  389. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
  391. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
  392. package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
  393. package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
  395. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
  396. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
  397. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
  398. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
  399. package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
  400. package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
  401. package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
  402. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
  403. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
  404. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
  405. package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
  406. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
  407. package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
  408. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
  409. package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
  410. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
  411. package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
  412. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
  413. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
  414. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
  415. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
  416. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
  417. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
  418. package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
  419. package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
  420. package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
  421. package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
  422. package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
  423. package/dist/knowledge/references/saas.models.error-type.md +45 -0
  424. package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
  425. package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
  429. package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
  430. package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
  431. package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
  433. package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
  434. package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
  435. package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
  437. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
  438. package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
  439. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
  440. package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
  442. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
  443. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
  444. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
  445. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
  446. package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
  447. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
  449. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
  450. package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
  451. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
  452. package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
  453. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
  454. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
  455. package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
  456. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
  457. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
  458. package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
  459. package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
  460. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
  461. package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
  462. package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
  463. package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
  464. package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
  465. package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
  466. package/dist/knowledge/references/saas.models.resource-type.md +24 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
  468. package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
  469. package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
  470. package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
  471. package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
  472. package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
  474. package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
  475. package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
  476. package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
  477. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
  478. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
  479. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
  480. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
  481. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
  482. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
  483. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
  484. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
  485. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
  486. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
  487. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
  488. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
  489. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
  490. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
  492. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
  493. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
  494. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
  495. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
  496. package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
  497. package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
  498. package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
  499. package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
  500. package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
  501. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
  502. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
  503. package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
  504. package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
  505. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
  506. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
  507. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
  508. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
  509. package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
  510. package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
  511. package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
  512. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
  513. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
  514. package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
  515. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
  516. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
  517. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
  518. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
  519. package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
  520. package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
  521. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
  522. package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
  523. package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
  524. package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
  525. package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
  526. package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
  527. package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
  528. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
  529. package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
  530. package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
  531. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
  532. package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
  533. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
  534. package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
  535. package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
  536. package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
  537. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
  538. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
  539. package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
  540. package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
  541. package/dist/knowledge/references/saas.website.page.context.md +57 -0
  542. package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
  543. package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
  544. package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
  545. package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
  546. package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
  547. package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
  548. package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
  549. package/dist/knowledge/references/saas.website.refs.page.md +56 -0
  550. package/dist/knowledge/references/saas.website.refs.section.md +57 -0
  551. package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
  552. package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
  553. package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
  554. package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
  555. package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
  556. package/dist/knowledge/references/saas.website.section.component.md +138 -0
  557. package/dist/knowledge/references/saas.website.section.context.md +63 -0
  558. package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
  559. package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
  560. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
  561. package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
  562. package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
  563. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
  564. package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
  565. package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
  566. package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
  567. package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
  568. package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
  569. package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
  570. package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
  571. package/dist/knowledge/references/vision.constraint.config.md +66 -0
  572. package/dist/knowledge/references/vision.idea.config.md +45 -0
  573. package/dist/knowledge/references/vision.mission.config.md +46 -0
  574. package/dist/knowledge/references/vision.problem.config.md +51 -0
  575. package/dist/knowledge/references/vision.references.conventions.md +115 -0
  576. package/dist/knowledge/references/vision.snapshot.config.md +85 -0
  577. package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
  578. package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
  579. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
  580. package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
  581. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  582. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
  583. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
  584. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
  585. package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
  586. package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
  587. package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
  588. package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
  589. package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
  590. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
  591. package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
  592. package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
  593. package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
  594. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
  595. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
  596. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
  597. package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
  598. package/dist/knowledge/references/zod.factories.code.md +127 -0
  599. package/dist/knowledge/references/zod.factories.duration.md +246 -0
  600. package/dist/knowledge/references/zod.factories.money.md +166 -0
  601. package/dist/knowledge/references/zod.factories.phone.md +88 -0
  602. package/dist/knowledge/references/zod.factories.range.md +174 -0
  603. package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
  604. package/dist/knowledge/registries/framework-topics.json +5212 -0
  605. package/dist/knowledge/registries/playbooks.json +488 -0
  606. package/dist/knowledge/registries/source-tags.json +7664 -0
  607. package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
  608. package/dist/knowledge/skills/INDEX.md +349 -0
  609. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
  610. package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
  611. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
  612. package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
  613. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
  614. package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
  615. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
  616. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  617. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
  618. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
  619. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
  620. package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
  621. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
  622. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
  623. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
  624. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
  625. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
  626. package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
  627. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
  628. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
  629. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
  630. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
  631. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
  632. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
  633. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
  634. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
  635. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
  636. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
  637. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
  638. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
  639. package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
  640. package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
  641. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
  642. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
  643. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
  644. package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
  645. package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
  646. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
  647. package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
  648. package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
  649. package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
  650. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
  651. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
  652. package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
  653. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
  654. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
  655. package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
  656. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
  657. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
  658. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  659. package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
  660. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
  661. package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
  662. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
  663. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
  664. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
  665. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
  666. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
  667. package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
  668. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
  669. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
  670. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
  671. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
  672. package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
  673. package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
  674. package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
  675. package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
  676. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
  677. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
  678. package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
  679. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
  680. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
  681. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
  682. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
  683. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
  684. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
  685. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
  686. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
  687. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
  688. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
  689. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
  690. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
  691. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
  692. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
  693. package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
  694. package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
  695. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
  696. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
  697. package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
  698. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
  699. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
  700. package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
  701. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
  702. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
  703. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
  704. package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
  705. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
  706. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
  707. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
  708. package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
  709. package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
  710. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
  711. package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
  712. package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
  713. package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
  714. package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
  715. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
  716. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
  717. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
  718. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
  719. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
  720. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
  721. package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
  722. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
  723. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
  724. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
  725. package/dist/knowledge/skills/market-category/SKILL.md +290 -0
  726. package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
  727. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
  728. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
  729. package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
  730. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
  731. package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
  732. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
  733. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
  734. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
  735. package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
  736. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
  737. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
  738. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
  739. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
  740. package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
  741. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
  742. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
  743. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
  744. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
  745. package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
  746. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
  747. package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
  748. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
  749. package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
  750. package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
  751. package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
  752. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
  753. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
  754. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
  755. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
  756. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
  757. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
  758. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
  759. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
  760. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
  761. package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
  762. package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
  763. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
  764. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
  765. package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
  766. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
  767. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
  768. package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
  769. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
  770. package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
  771. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
  772. package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
  773. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
  774. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
  775. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
  776. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
  777. package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
  778. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
  779. package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
  780. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
  781. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
  782. package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
  783. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
  784. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
  785. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
  786. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
  787. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
  788. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
  789. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
  790. package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
  791. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
  792. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
  793. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
  794. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
  795. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
  796. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
  797. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
  798. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
  799. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
  800. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
  801. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  802. package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
  803. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
  804. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
  805. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
  806. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
  807. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
  808. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
  809. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
  810. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
  811. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
  812. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
  813. package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
  814. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
  815. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
  816. package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
  817. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
  818. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
  819. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
  820. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
  821. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
  822. package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
  823. package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
  824. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
  825. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
  826. package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
  827. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
  828. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
  829. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
  830. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
  831. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
  832. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
  833. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
  834. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
  835. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
  836. package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
  837. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
  838. package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
  839. package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
  840. package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
  841. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
  842. package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
  843. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
  844. package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
  845. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
  846. package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
  847. package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
  848. package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
  849. package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
  850. package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
  851. package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
  852. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
  853. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
  854. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
  855. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
  856. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
  857. package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
  858. package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
  859. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
  860. package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
  861. package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
  862. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
  863. package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
  864. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
  865. package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
  866. package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
  867. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
  868. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
  869. package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
  870. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
  871. package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
  872. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
  873. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
  874. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
  875. package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
  876. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
  877. package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
  878. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
  879. package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
  880. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
  881. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
  882. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
  883. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
  884. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
  885. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
  886. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
  887. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
  888. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
  889. package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
  890. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
  891. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
  892. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
  893. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
  894. package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
  895. package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
  896. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
  897. package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
  898. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
  899. package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
  900. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
  901. package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
  902. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
  903. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
  904. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
  905. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
  906. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
  907. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
  908. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
  909. package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
  910. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
  911. package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
  912. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
  913. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
  914. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
  915. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
  916. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
  917. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
  918. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
  919. package/dist/knowledge/topic-index.json +17510 -0
  920. package/dist/tsconfig.build.tsbuildinfo +1 -0
  921. package/dist/tsconfig.tsbuildinfo +1 -0
  922. package/package.json +49 -0
@@ -0,0 +1,258 @@
1
+ import { existsSync, readFileSync, readdirSync } from 'node:fs';
2
+ import { isAbsolute, normalize, resolve } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { describeCaughtError } from '@wildo-ai/saas-backend-lib';
5
+ import { FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION, FrameworkKnowledgeRegistryName } from './framework-knowledge.schemas.js';
6
+ /**
7
+ * This package is intentionally consumed from compiled `dist/esm`.
8
+ * Resolving relative to `import.meta.url` keeps local package-preview and
9
+ * published npm consumption on the same `dist/knowledge` seam.
10
+ */
11
+ function getFrameworkKnowledgeDirectoryPath() {
12
+ return fileURLToPath(new URL('../knowledge/', import.meta.url));
13
+ }
14
+ function normalizeKnowledgeAssetRelativePath(relativePath) {
15
+ const normalizedRelativePath = normalize(relativePath).replaceAll('\\', '/');
16
+ if (normalizedRelativePath.length === 0 || normalizedRelativePath === '.') {
17
+ throw new Error('Framework knowledge asset paths must not be empty.');
18
+ }
19
+ if (isAbsolute(normalizedRelativePath) || normalizedRelativePath === '..' || normalizedRelativePath.startsWith('../')) {
20
+ throw new Error(`Framework knowledge asset paths must stay inside the knowledge payload: "${relativePath}".`);
21
+ }
22
+ return normalizedRelativePath;
23
+ }
24
+ function resolveKnowledgeAssetPath(relativePath) {
25
+ const normalizedRelativePath = normalizeKnowledgeAssetRelativePath(relativePath);
26
+ return resolve(getFrameworkKnowledgeDirectoryPath(), normalizedRelativePath);
27
+ }
28
+ function assertKnowledgeAssetExists(assetPath, relativePath) {
29
+ if (existsSync(assetPath)) {
30
+ return;
31
+ }
32
+ throw new Error(`Missing framework knowledge asset "${relativePath}" at "${assetPath}". Run "wildo fwk generate-docs" to materialize the package payload before consuming it.`);
33
+ }
34
+ function readJsonKnowledgeAsset(relativePath) {
35
+ const assetPath = resolveKnowledgeAssetPath(relativePath);
36
+ assertKnowledgeAssetExists(assetPath, relativePath);
37
+ return JSON.parse(readFileSync(assetPath, 'utf8'));
38
+ }
39
+ function readTextKnowledgeAsset(relativePath) {
40
+ const assetPath = resolveKnowledgeAssetPath(relativePath);
41
+ assertKnowledgeAssetExists(assetPath, relativePath);
42
+ return readFileSync(assetPath, 'utf8');
43
+ }
44
+ function readBinaryKnowledgeAsset(relativePath) {
45
+ const assetPath = resolveKnowledgeAssetPath(relativePath);
46
+ assertKnowledgeAssetExists(assetPath, relativePath);
47
+ return readFileSync(assetPath);
48
+ }
49
+ function parseJsonKnowledgeBytes(bytes, relativePath) {
50
+ try {
51
+ return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
52
+ }
53
+ catch (error) {
54
+ throw new Error(`Framework knowledge asset "${relativePath}" is not valid UTF-8 JSON: ${describeCaughtError(error)}`);
55
+ }
56
+ }
57
+ export function resolveFrameworkKnowledgeAssetPath(relativePath) {
58
+ return resolveKnowledgeAssetPath(relativePath);
59
+ }
60
+ export function getFrameworkKnowledgeManifestArtifact() {
61
+ const bytes = readBinaryKnowledgeAsset('manifest.json');
62
+ const manifest = parseJsonKnowledgeBytes(bytes, 'manifest.json');
63
+ if (manifest.artifactVersion !== FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION) {
64
+ throw new Error(`Unsupported Framework Knowledge artifact version "${manifest.artifactVersion}"; expected "${FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION}".`);
65
+ }
66
+ const assuranceAuthorityBasisRegistry = manifest.registries.find((registry) => registry.registryName === FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES);
67
+ if (!manifest.payload.assuranceAuthorityBasesDirectory || !assuranceAuthorityBasisRegistry) {
68
+ throw new Error('Framework Knowledge artifact version 3 requires an assurance-authority-basis payload and registry.');
69
+ }
70
+ return { value: manifest, bytes };
71
+ }
72
+ export function getFrameworkKnowledgeManifest() {
73
+ return getFrameworkKnowledgeManifestArtifact().value;
74
+ }
75
+ export function listFrameworkKnowledgeRegistries() {
76
+ return getFrameworkKnowledgeManifest().registries;
77
+ }
78
+ export function getFrameworkKnowledgeTopicIndex() {
79
+ return readJsonKnowledgeAsset('topic-index.json');
80
+ }
81
+ export function listFrameworkKnowledgeTopics() {
82
+ return getFrameworkKnowledgeTopicIndex().topics;
83
+ }
84
+ export function getFrameworkKnowledgeTopic(topicId) {
85
+ const topicEntry = listFrameworkKnowledgeTopics().find((entry) => entry.topicId === topicId);
86
+ if (!topicEntry) {
87
+ return null;
88
+ }
89
+ const referencesByFile = Object.fromEntries(topicEntry.referenceFiles.map((referenceFileName) => [
90
+ referenceFileName,
91
+ readTextKnowledgeAsset(`references/${referenceFileName}`),
92
+ ]));
93
+ const skillsByFile = Object.fromEntries(topicEntry.skillFiles.map((skillFileName) => [
94
+ skillFileName,
95
+ readTextKnowledgeAsset(`skills/${skillFileName}`),
96
+ ]));
97
+ return {
98
+ entry: topicEntry,
99
+ referencesByFile,
100
+ skillsByFile,
101
+ };
102
+ }
103
+ export function getFrameworkKnowledgeRegistry(registryName) {
104
+ return readJsonKnowledgeAsset(`registries/${registryName}.json`);
105
+ }
106
+ /**
107
+ * Lists the compiled meta-workflow playbooks from the `playbooks` registry,
108
+ * sorted by `ref` for stable iteration.
109
+ */
110
+ export function listFrameworkKnowledgePlaybooks() {
111
+ const registry = readJsonKnowledgeAsset(`registries/${FrameworkKnowledgeRegistryName.PLAYBOOKS}.json`);
112
+ return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref));
113
+ }
114
+ /**
115
+ * Hydrates one compiled playbook by its `ref` (the folder name under
116
+ * `playbooks/`). Returns `null` when the ref is not in the registry.
117
+ *
118
+ * The returned `playbook` is the generator-validated compiled
119
+ * `playbook.json` (with `method.guidance` inlined from the rendered
120
+ * `method.md`); parse it with `MetaWorkflowPlaybookSchema` from
121
+ * `@wildo-ai/saas-specifications` to recover the typed contract — this package
122
+ * cannot carry that dependency itself.
123
+ */
124
+ export function getFrameworkKnowledgePlaybook(ref) {
125
+ const entry = listFrameworkKnowledgePlaybooks().find((candidate) => candidate.ref === ref);
126
+ if (!entry) {
127
+ return null;
128
+ }
129
+ const evaluationProtocol = entry.evaluationProtocol
130
+ ? (() => {
131
+ const bytes = readBinaryKnowledgeAsset(entry.evaluationProtocol.filePath);
132
+ return {
133
+ value: parseJsonKnowledgeBytes(bytes, entry.evaluationProtocol.filePath),
134
+ bytes,
135
+ };
136
+ })()
137
+ : null;
138
+ const evaluationTreatment = entry.evaluationTreatment
139
+ ? (() => {
140
+ const bytes = readBinaryKnowledgeAsset(entry.evaluationTreatment.filePath);
141
+ return {
142
+ value: parseJsonKnowledgeBytes(bytes, entry.evaluationTreatment.filePath),
143
+ bytes,
144
+ };
145
+ })()
146
+ : null;
147
+ const structuredArtifactAction = entry.structuredArtifactAction
148
+ ? (() => {
149
+ const bytes = readBinaryKnowledgeAsset(entry.structuredArtifactAction.filePath);
150
+ return {
151
+ value: parseJsonKnowledgeBytes(bytes, entry.structuredArtifactAction.filePath),
152
+ bytes,
153
+ };
154
+ })()
155
+ : null;
156
+ if ((evaluationProtocol === null) !== (evaluationTreatment === null)) {
157
+ throw new Error(`Framework knowledge playbook "${ref}" must carry both evaluation protocol and treatment artifacts or neither.`);
158
+ }
159
+ const playbookBytes = readBinaryKnowledgeAsset(entry.playbookFilePath);
160
+ const methodBytes = readBinaryKnowledgeAsset(entry.methodFilePath);
161
+ return {
162
+ entry,
163
+ playbook: parseJsonKnowledgeBytes(playbookBytes, entry.playbookFilePath),
164
+ playbookBytes,
165
+ methodMarkdown: new TextDecoder('utf-8', { fatal: true }).decode(methodBytes),
166
+ methodBytes,
167
+ evaluationProtocol,
168
+ evaluationTreatment,
169
+ structuredArtifactAction,
170
+ };
171
+ }
172
+ /** Lists portable assurance-authority bases in stable ref/version order. */
173
+ export function listFrameworkKnowledgeAssuranceAuthorityBases() {
174
+ const registry = getFrameworkKnowledgeRegistry(FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES);
175
+ return Object.values(registry.entries).sort((left, right) => left.ref.localeCompare(right.ref) || left.version - right.version);
176
+ }
177
+ /**
178
+ * Hydrates one framework assurance-authority basis selected by ref and compatibility generation.
179
+ *
180
+ * `ref@version` is the whole identity — the compatibility generation an application pins. The
181
+ * raw-byte digest verification here was removed 2026-08-27: it compared a payload file against a
182
+ * registry shipped in the same payload.
183
+ */
184
+ export function getFrameworkKnowledgeAssuranceAuthorityBasis(ref, version) {
185
+ const candidates = listFrameworkKnowledgeAssuranceAuthorityBases().filter((entry) => entry.ref === ref && (version === undefined || entry.version === version));
186
+ if (candidates.length === 0)
187
+ return null;
188
+ if (candidates.length !== 1)
189
+ throw new Error(`Framework Knowledge assurance-authority basis "${ref}" is ambiguous without an exact version.`);
190
+ const entry = candidates[0];
191
+ const bytes = readBinaryKnowledgeAsset(entry.filePath);
192
+ const basis = parseJsonKnowledgeBytes(bytes, entry.filePath);
193
+ if (basis === null || typeof basis !== 'object' || Array.isArray(basis)) {
194
+ throw new Error(`Framework Knowledge assurance-authority basis "${entry.ref}" is not a JSON object.`);
195
+ }
196
+ const basisRecord = basis;
197
+ const implementationRevision = basisRecord.implementationRevision;
198
+ if (implementationRevision === null || typeof implementationRevision !== 'object' || Array.isArray(implementationRevision)) {
199
+ throw new Error(`Framework Knowledge assurance-authority basis "${entry.ref}" has no implementation revision object.`);
200
+ }
201
+ const implementationRevisionRecord = implementationRevision;
202
+ if (basisRecord.basisRef !== entry.ref ||
203
+ basisRecord.basisVersion !== entry.version ||
204
+ implementationRevisionRecord.sourceRevisionRef !== entry.sourceRevisionRef) {
205
+ throw new Error(`Framework Knowledge assurance-authority basis "${entry.ref}" does not match its registry identity.`);
206
+ }
207
+ return { entry, basis, bytes };
208
+ }
209
+ /**
210
+ * Every compiled skill's name and purpose — the catalog a generation call must choose from.
211
+ *
212
+ * Exists because a playbook METHOD can instruct a model to "route through the skills index"
213
+ * while the model has never been shown one: measured 2026-08-27, `skillRefs` appeared ZERO
214
+ * times in the companion's brief composition, so `bottom_up.build-decompose` was binding 54
215
+ * tasks to skill names it was recalling rather than reading. A dangling skill ref is a task
216
+ * the dispatch playbook cannot run.
217
+ *
218
+ * The compiled `skills/INDEX.md` is the ROUTER and is not what a prompt should carry — it is
219
+ * 76KB, more than the whole rest of a decompose brief. This projection is ~25KB for 104
220
+ * skills and drops nothing a chooser needs.
221
+ *
222
+ * Sorted by name so a brief built twice from one artifact is byte-identical.
223
+ */
224
+ export function listFrameworkKnowledgeSkillSummaries() {
225
+ const skillsDirectory = getFrameworkKnowledgeManifest().payload.skillsDirectory;
226
+ const absoluteSkillsDirectory = resolveKnowledgeAssetPath(skillsDirectory);
227
+ if (!existsSync(absoluteSkillsDirectory)) {
228
+ return [];
229
+ }
230
+ const summaries = [];
231
+ for (const entry of readdirSync(absoluteSkillsDirectory, { withFileTypes: true })) {
232
+ if (!entry.isDirectory())
233
+ continue;
234
+ const skillPath = `${skillsDirectory}/${entry.name}/SKILL.md`;
235
+ if (!existsSync(resolveKnowledgeAssetPath(skillPath)))
236
+ continue;
237
+ const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/.exec(readTextKnowledgeAsset(skillPath));
238
+ if (!frontmatter)
239
+ continue;
240
+ const name = /^name:\s*(.+)$/m.exec(frontmatter[1])?.[1]?.trim();
241
+ const description = /^description:\s*(.+)$/m.exec(frontmatter[1])?.[1]?.trim();
242
+ if (!name || !description)
243
+ continue;
244
+ const unquoted = description.replace(/^["']|["']$/g, '');
245
+ // The trigger half starts at "Use when"; everything before it is the purpose.
246
+ const purpose = unquoted.split(/\s*Use when/)[0].trim();
247
+ summaries.push({ name, purpose: purpose.length > 0 ? purpose : unquoted });
248
+ }
249
+ return summaries.sort((left, right) => left.name.localeCompare(right.name));
250
+ }
251
+ export function getFrameworkKnowledgeSkillsIndex() {
252
+ const skillsIndexPath = getFrameworkKnowledgeManifest().payload.skillsIndexPath;
253
+ if (!skillsIndexPath) {
254
+ return null;
255
+ }
256
+ return readTextKnowledgeAsset(skillsIndexPath);
257
+ }
258
+ //# sourceMappingURL=framework-knowledge.loader.js.map
@@ -0,0 +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 * 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"]}
@@ -0,0 +1,236 @@
1
+ export declare const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = "3";
2
+ export declare enum FrameworkKnowledgeRegistryName {
3
+ SOURCE_TAGS = "source-tags",
4
+ FRAMEWORK_TOPICS = "framework-topics",
5
+ PLAYBOOKS = "playbooks",
6
+ ASSURANCE_AUTHORITY_BASES = "assurance-authority-bases"
7
+ }
8
+ export declare enum FrameworkKnowledgeSourceReferenceKind {
9
+ FULL_FILE = "full-file",
10
+ PART_RANGE = "part-range"
11
+ }
12
+ /**
13
+ * The JSON-v1 authoring format was retired (and its member deleted) at the
14
+ * first-activation hard cut; every authored playbook is an effect-free native
15
+ * TypeScript declaration.
16
+ */
17
+ export declare enum FrameworkKnowledgePlaybookSourceFormat {
18
+ EFFECT_FREE_TYPESCRIPT_MODULE_V1 = "EFFECT_FREE_TYPESCRIPT_MODULE_V1"
19
+ }
20
+ /**
21
+ * Directory/file inventory of the compiled payload, mirrored 1:1 by the
22
+ * generator-local `FrameworkKnowledgeManifestShape` in
23
+ * `wildo-cli/src/services/framework/framework-knowledge-generation.service.ts`.
24
+ * The two shapes are deliberately duplicated (the audit/generator must stay
25
+ * buildless w.r.t. this package) — extending one WITHOUT the other silently
26
+ * ships a payload the typed loader cannot see. Keep them in lockstep.
27
+ */
28
+ export interface FrameworkKnowledgePayloadInventory {
29
+ topicIndexPath: string;
30
+ registriesDirectory: string;
31
+ referencesDirectory: string;
32
+ skillsDirectory: string;
33
+ /** Compiled meta-workflow playbooks home (`playbooks/<ref>/playbook.json` + `method.md`). */
34
+ playbooksDirectory: string;
35
+ /** Compiled application-creation transition route home. */
36
+ /** Compiled, portable assurance-authority bases; published bytes never contain repository source paths. */
37
+ assuranceAuthorityBasesDirectory: string;
38
+ /**
39
+ * Compiled ALWAYS-ON rules home (`rules/*.md`), installed into an application's `.claude/rules/`.
40
+ *
41
+ * Distinct from a skill: a skill is reached when the router matches a request description, which
42
+ * requires the agent to already suspect the topic. A rule is policy that must be present when the
43
+ * agent opens a matching file, without being asked for.
44
+ *
45
+ * OPTIONAL, unlike its siblings: it was introduced by issue #98 after the channel had been
46
+ * documented and never built, so a payload generated before that carries none. A required field
47
+ * would make every previously generated payload unloadable to fix a delivery gap.
48
+ */
49
+ rulesDirectory?: string;
50
+ /**
51
+ * Compiled skills router (`skills/INDEX.md`), rendered from the authored
52
+ * `src/skills/INDEX.md` — the single router truth. Absent when the authored
53
+ * catalog file does not exist (audit Rule 8 warns on that state). It is
54
+ * deliberately NOT attached to any topic entry: the catalog is cross-topic
55
+ * and `getFrameworkKnowledgeTopic` would misfile it.
56
+ */
57
+ skillsIndexPath?: string;
58
+ }
59
+ export interface FrameworkKnowledgeRegistryDescriptor {
60
+ registryName: FrameworkKnowledgeRegistryName;
61
+ filePath: string;
62
+ description: string;
63
+ entryCount: number;
64
+ }
65
+ export interface FrameworkKnowledgeManifest {
66
+ artifactVersion: string;
67
+ frameworkVersion: string;
68
+ generatorVersion: string;
69
+ generatedAt: string;
70
+ packageName: string;
71
+ topicCount: number;
72
+ referenceFileCount: number;
73
+ payload: FrameworkKnowledgePayloadInventory;
74
+ registries: FrameworkKnowledgeRegistryDescriptor[];
75
+ }
76
+ export interface FrameworkKnowledgeSourceReference {
77
+ kind: FrameworkKnowledgeSourceReferenceKind;
78
+ tagName: string;
79
+ filePath: string;
80
+ startLine?: number;
81
+ endLine?: number;
82
+ }
83
+ export interface FrameworkKnowledgeTopicIndexEntry {
84
+ topicId: string;
85
+ title: string;
86
+ tags: string[];
87
+ facets: string[];
88
+ categories: string[];
89
+ sourceReferences: FrameworkKnowledgeSourceReference[];
90
+ referenceFiles: string[];
91
+ skillFiles: string[];
92
+ registryKeys: FrameworkKnowledgeRegistryName[];
93
+ }
94
+ export interface FrameworkKnowledgeTopicIndex {
95
+ topics: FrameworkKnowledgeTopicIndexEntry[];
96
+ }
97
+ export interface FrameworkKnowledgeTopic {
98
+ entry: FrameworkKnowledgeTopicIndexEntry;
99
+ referencesByFile: Record<string, string>;
100
+ skillsByFile: Record<string, string>;
101
+ }
102
+ export interface FrameworkKnowledgeTopicRegistryEntry {
103
+ topicId: string;
104
+ title: string;
105
+ categories: string[];
106
+ referenceFilePath?: string;
107
+ sourceReferenceCount: number;
108
+ }
109
+ export interface FrameworkKnowledgeSourceTagRegistryEntry {
110
+ referenceFilePath: string;
111
+ skillFilePath?: string;
112
+ extractedAt: string;
113
+ facets: string[];
114
+ sourceReferences: FrameworkKnowledgeSourceReference[];
115
+ }
116
+ /**
117
+ * One compiled meta-workflow playbook, as listed in the `playbooks` registry.
118
+ *
119
+ * Enum-backed playbook fields (`phase`, `executor`, `functionalTopics`) are
120
+ * surfaced as plain strings here: this package has zero dependencies by
121
+ * design, so it cannot import the `MetaWorkflow_*` enums from
122
+ * `@wildo-ai/saas-specifications`. Consumers that need the typed contract must parse
123
+ * the playbook JSON (see {@link FrameworkKnowledgePlaybook.playbook}) with
124
+ * `MetaWorkflowPlaybookSchema` at their own seam — the generator has already
125
+ * validated it, so the parse is a type-recovery step, not a trust boundary.
126
+ */
127
+ export interface FrameworkKnowledgePlaybookRegistryEntry {
128
+ ref: string;
129
+ version: string;
130
+ phase: string;
131
+ /** Absent when the playbook runs no single tier — see `MetaWorkflow_Executor` (#115). */
132
+ executor?: string;
133
+ intent: string;
134
+ functionalTopics: string[];
135
+ /** App-knowledge skill ids the playbook's method delegates the technical HOW to. */
136
+ skillRefs: string[];
137
+ /** Payload-relative path of the compiled `playbook.json`. */
138
+ playbookFilePath: string;
139
+ /** Payload-relative path of the rendered `method.md`. */
140
+ methodFilePath: string;
141
+ /** Canonical structured authoring format used to compile this entry. */
142
+ sourceFormat: FrameworkKnowledgePlaybookSourceFormat;
143
+ evaluationProtocol?: {
144
+ protocolRef: string;
145
+ protocolVersion: number;
146
+ filePath: string;
147
+ };
148
+ evaluationTreatment?: {
149
+ definitionRef: string;
150
+ definitionVersion: number;
151
+ filePath: string;
152
+ };
153
+ structuredArtifactAction?: {
154
+ definitionRef: string;
155
+ definitionVersion: number;
156
+ filePath: string;
157
+ };
158
+ }
159
+ /**
160
+ * Zero-dependency registry identity for one compiled assurance-authority basis.
161
+ *
162
+ * `ref@version` IS the identity: `version` is the declared compatibility generation. The three
163
+ * content digests this carried (basis, source revision, artifact bytes) were removed 2026-08-27 —
164
+ * they compared the compiled payload against a registry that ships in the same payload, and the
165
+ * basis digest additionally forced every consuming application to re-accept its controls on any
166
+ * engine byte movement (`.claude/rules/one-source-of-truth.md`).
167
+ */
168
+ export interface FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry {
169
+ ref: string;
170
+ version: number;
171
+ sourceRevisionRef: string;
172
+ filePath: string;
173
+ }
174
+ /** Portable authority-basis bytes; consumers recover the typed assurance contract at their semantic boundary. */
175
+ export interface FrameworkKnowledgeAssuranceAuthorityBasis {
176
+ entry: FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry;
177
+ basis: unknown;
178
+ bytes: Uint8Array;
179
+ }
180
+ /** Exact JSON artifact bytes plus their parsed zero-dependency projection. */
181
+ export interface FrameworkKnowledgeJsonArtifact<TValue> {
182
+ value: TValue;
183
+ bytes: Uint8Array;
184
+ }
185
+ /**
186
+ * Hydrated playbook returned by `getFrameworkKnowledgePlaybook(ref)`.
187
+ */
188
+ export interface FrameworkKnowledgePlaybook {
189
+ entry: FrameworkKnowledgePlaybookRegistryEntry;
190
+ /**
191
+ * Parsed compiled `playbook.json` — schema-valid `MetaWorkflowPlaybook`
192
+ * content (with `method.guidance` inlined from the rendered `method.md`).
193
+ * Typed `unknown` because this package cannot depend on
194
+ * `@wildo-ai/saas-specifications`; parse with `MetaWorkflowPlaybookSchema` to
195
+ * recover the typed contract.
196
+ */
197
+ playbook: unknown;
198
+ /** Exact compiled `playbook.json` bytes used for source provenance. */
199
+ playbookBytes: Uint8Array;
200
+ /** Rendered `method.md` prose (same content as `playbook.method.guidance`). */
201
+ methodMarkdown: string;
202
+ /** Exact rendered `method.md` bytes used for source provenance. */
203
+ methodBytes: Uint8Array;
204
+ /** Exact compiled protocol bytes and parsed value, absent for contained JSON-v1 entries. */
205
+ evaluationProtocol: {
206
+ value: unknown;
207
+ bytes: Uint8Array;
208
+ } | null;
209
+ /** Exact compiled treatment bytes and parsed value, absent for contained JSON-v1 entries. */
210
+ evaluationTreatment: {
211
+ value: unknown;
212
+ bytes: Uint8Array;
213
+ } | null;
214
+ /** Exact compiled structured-artifact Action bytes, when the playbook declares one. */
215
+ structuredArtifactAction: {
216
+ value: unknown;
217
+ bytes: Uint8Array;
218
+ } | null;
219
+ }
220
+ export interface FrameworkKnowledgeRegistryBase<TName extends FrameworkKnowledgeRegistryName, TEntry> {
221
+ name: TName;
222
+ metadata?: Record<string, unknown>;
223
+ entries: Record<string, TEntry>;
224
+ }
225
+ export type FrameworkKnowledgeSourceTagRegistry = FrameworkKnowledgeRegistryBase<FrameworkKnowledgeRegistryName.SOURCE_TAGS, FrameworkKnowledgeSourceTagRegistryEntry>;
226
+ export type FrameworkKnowledgeTopicRegistry = FrameworkKnowledgeRegistryBase<FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS, FrameworkKnowledgeTopicRegistryEntry>;
227
+ export type FrameworkKnowledgePlaybookRegistry = FrameworkKnowledgeRegistryBase<FrameworkKnowledgeRegistryName.PLAYBOOKS, FrameworkKnowledgePlaybookRegistryEntry>;
228
+ export type FrameworkKnowledgeAssuranceAuthorityBasisRegistry = FrameworkKnowledgeRegistryBase<FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES, FrameworkKnowledgeAssuranceAuthorityBasisRegistryEntry>;
229
+ export interface FrameworkKnowledgeRegistryMap {
230
+ [FrameworkKnowledgeRegistryName.SOURCE_TAGS]: FrameworkKnowledgeSourceTagRegistry;
231
+ [FrameworkKnowledgeRegistryName.FRAMEWORK_TOPICS]: FrameworkKnowledgeTopicRegistry;
232
+ [FrameworkKnowledgeRegistryName.PLAYBOOKS]: FrameworkKnowledgePlaybookRegistry;
233
+ [FrameworkKnowledgeRegistryName.ASSURANCE_AUTHORITY_BASES]: FrameworkKnowledgeAssuranceAuthorityBasisRegistry;
234
+ }
235
+ export type FrameworkKnowledgeRegistry = FrameworkKnowledgeRegistryMap[FrameworkKnowledgeRegistryName];
236
+ //# sourceMappingURL=framework-knowledge.schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"framework-knowledge.schemas.d.ts","sourceRoot":"","sources":["../../../src/framework-knowledge.schemas.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ export const FRAMEWORK_KNOWLEDGE_ARTIFACT_VERSION = '3';
2
+ export var FrameworkKnowledgeRegistryName;
3
+ (function (FrameworkKnowledgeRegistryName) {
4
+ FrameworkKnowledgeRegistryName["SOURCE_TAGS"] = "source-tags";
5
+ FrameworkKnowledgeRegistryName["FRAMEWORK_TOPICS"] = "framework-topics";
6
+ FrameworkKnowledgeRegistryName["PLAYBOOKS"] = "playbooks";
7
+ FrameworkKnowledgeRegistryName["ASSURANCE_AUTHORITY_BASES"] = "assurance-authority-bases";
8
+ })(FrameworkKnowledgeRegistryName || (FrameworkKnowledgeRegistryName = {}));
9
+ export var FrameworkKnowledgeSourceReferenceKind;
10
+ (function (FrameworkKnowledgeSourceReferenceKind) {
11
+ FrameworkKnowledgeSourceReferenceKind["FULL_FILE"] = "full-file";
12
+ FrameworkKnowledgeSourceReferenceKind["PART_RANGE"] = "part-range";
13
+ })(FrameworkKnowledgeSourceReferenceKind || (FrameworkKnowledgeSourceReferenceKind = {}));
14
+ /**
15
+ * The JSON-v1 authoring format was retired (and its member deleted) at the
16
+ * first-activation hard cut; every authored playbook is an effect-free native
17
+ * TypeScript declaration.
18
+ */
19
+ export var FrameworkKnowledgePlaybookSourceFormat;
20
+ (function (FrameworkKnowledgePlaybookSourceFormat) {
21
+ FrameworkKnowledgePlaybookSourceFormat["EFFECT_FREE_TYPESCRIPT_MODULE_V1"] = "EFFECT_FREE_TYPESCRIPT_MODULE_V1";
22
+ })(FrameworkKnowledgePlaybookSourceFormat || (FrameworkKnowledgePlaybookSourceFormat = {}));
23
+ //# sourceMappingURL=framework-knowledge.schemas.js.map
@@ -0,0 +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`, `functionalTopics`) 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 functionalTopics: 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\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"]}
@@ -0,0 +1,4 @@
1
+ export * from './framework-knowledge.schemas.js';
2
+ export * from './framework-knowledge.definitions.js';
3
+ export * from './framework-knowledge.loader.js';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,4 @@
1
+ export * from './framework-knowledge.schemas.js';
2
+ export * from './framework-knowledge.definitions.js';
3
+ export * from './framework-knowledge.loader.js';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC","sourcesContent":["export * from './framework-knowledge.schemas.js';\nexport * from './framework-knowledge.definitions.js';\nexport * from './framework-knowledge.loader.js';\n"]}