@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 @@
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.foundation/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,sBAAsB;IAC7B,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,87CAA87C;IACx8C,kBAAkB,EAAE,CAAC,kCAAkC,CAAC;IACxD,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE;QAC5C,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE;QACtE,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE;KACxE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,aAAa,EAAE;QAC3B,EAAE,QAAQ,EAAE,cAAc,EAAE;QAC5B,EAAE,QAAQ,EAAE,iBAAiB,EAAE;QAC/B,EAAE,QAAQ,EAAE,gBAAgB,EAAE;QAC9B,EAAE,QAAQ,EAAE,cAAc,EAAE;QAC5B,EAAE,QAAQ,EAAE,SAAS,EAAE;KACxB;IACD,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE;QACR,WAAW,EAAE;YACX,gBAAgB;YAChB,aAAa;YACb,qBAAqB;YACrB,0BAA0B;YAC1B,6BAA6B;SAC9B;QACD,aAAa,EAAE;YACb,WAAW,EAAE;gBACX;;;;;;;;;mBASG;gBACH;oBACE,KAAK,EAAE,eAAe;oBACtB,UAAU,EAAE,2NAA2N;oBACvO,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC;iBACtC;aACF;SACF;KACF;IACC,UAAU,EAAE,gBAAgB;IAC9B,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;KACb;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for this reusable application-creation method.\n *\n * The structured method remains intentionally rich: its intent, inputs, output\n * contracts, elicitation, deterministic verification and skill routing are the\n * application knowledge a later generic assessment loop composes. This source\n * intentionally omits the superseded per-playbook evaluation-treatment object;\n * generation records that absence rather than fabricating legacy judge behavior.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.foundation\",\n \"version\": \"0.2.0\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Bottom-up foundation — turn the approved domain plan + the top-down definition set into a configured, bootable application skeleton. Reads the domain-plan (the module decomposition + per-module resource inventory) and the vision-brief (whose compliance/vision constraints drive which engine capabilities to enable), then: (1) authors ./wildo.saas.config.ts for real — the engine capabilities (derived from compliance/vision), the modules (from the domain plan), and the providers (matched to the declared capabilities); (2) materializes the app skeleton (app/ shared-lib/ backend-api/ specifications/ + the module registries); (3) installs app-knowledge; (4) runs the deterministic bring-up — wildo setup --non-interactive, then wildo local init. This is a v1 SCAFFOLD METHOD describing the foundation SEQUENCE: skeleton materialization and app-knowledge installation remain deferred greenfield tooling, while headless setup and verified local initialization are registered commands once the app structure exists. It emits NO artifact: the deliverable is the app itself (the authored config + materialized skeleton + verified initialization), and the reasons behind each capability/module/provider choice are recorded as comments in the config the next reader opens. The foundation-manifest family it used to emit was retired 2026-08-25 with the app-creation verification/digest aspect. Runs after the domain plan is approved and the journey is in the bottom_up phase.\",\n \"functionalTopics\": [\"configure_application_foundation\"],\n \"preconditions\": [\n { \"kind\": \"phase_is\", \"phase\": \"bottom_up\" },\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } },\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"vision-brief\" } }\n ],\n \"inputs\": [\n { \"family\": \"domain-plan\" },\n { \"family\": \"vision-brief\" },\n { \"family\": \"market-snapshot\" },\n { \"family\": \"business-model\" },\n { \"family\": \"requirements\" },\n { \"family\": \"roadmap\" }\n ],\n \"outputs\": [],\n \"method\": {\n \"skillRefs\": [\n \"journey-status\",\n \"config-saas\",\n \"module-registration\",\n \"infra-environment-config\",\n \"local-environment-bootstrap\"\n ],\n \"elicitation\": {\n \"questions\": [\n /*\n * THE FALLBACK, since 2026-08-28. `bottom_up.domain-plan` now asks this and carries the\n * answer in the committed plan (`DomainPlanOutputSet.tenancy`), because the plan MODELS\n * tenancy — wonder-crm's invented a workspace module and a membership before anyone was\n * asked — so asking after the model is shaped lets a second answer contradict it.\n *\n * The executor reads the plan first and reaches this question only for a plan authored\n * before the field existed. Keep it: those plans are real (wonder-crm, wonder-todos) and\n * must stay composable.\n */\n {\n \"ref\": \"primary-scope\",\n \"question\": \"What is the application's tenancy model? Answer `organizations` when users collaborate inside shared workspaces/teams (this enables the ORGANIZATIONS engine capability), or `users` when every user's data is their own.\",\n \"kind\": \"choice\",\n \"options\": [\"organizations\", \"users\"]\n }\n ]\n }\n },\n \"approval\": \"approve_result\",\n \"budget\": {\n \"maxRuns\": 3\n },\n \"onFailure\": \"keep_and_flag\"\n} as const;\n"]}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Canonical native declaration for this reusable application-creation method.
3
+ *
4
+ * Placement is a DECISION the creator should not have to make. This playbook
5
+ * produces it as an artifact, with a per-decision rationale, so a later reader
6
+ * can ask "why is this here?" without re-deriving the answer.
7
+ */
8
+ export declare const playbookDefinition: {
9
+ readonly ref: "bottom_up.placement-plan";
10
+ readonly version: "0.1.0";
11
+ readonly phase: "bottom_up";
12
+ readonly intent: "Decide WHERE every settings destination, resource operation and application view sits in the application shell, and WHY. Reads the domain plan (the modules, their resources and what they mean) and the requirements (which tasks matter), and produces a PLACEMENT PLAN: for each subject, either a PLACED decision naming one surface (the settings hub rail, the sidebar, the user menu, the command palette) and its address on that surface, or an explicit DECLINED decision with a reason. Both carry a rationale. It also declares the GROUPS that should exist on the grouped surfaces (settings rail categories, sidebar sections) with the product purpose behind each, which is what grounds their generated labels in authored intent instead of filler. This playbook DECIDES placement; it does NOT author configuration — turning a decision into `frontend/src/config/settings-hub.config.ts` and `app-shell.config.ts` is a coding task the build lane dispatches through the `settings-placement-authoring` skill. It runs BEFORE build-decompose, which consumes the plan and emits those tasks — the reverse order would be a cycle, since build-decompose is what produces the build plan. It writes no TypeScript, invents no destination refs, and authors no labels. It exists because the alternative is the framework defaulting placement, which is what made an application's settings rail unauthorable: nothing is placed implicitly, so a subject nobody decided about is a visible coverage gap rather than a silent framework default.";
13
+ readonly functionalTopics: readonly ["shape_user_experience"];
14
+ readonly preconditions: readonly [{
15
+ readonly kind: "phase_is";
16
+ readonly phase: "bottom_up";
17
+ }, {
18
+ readonly kind: "artifact_exists";
19
+ readonly selector: {
20
+ readonly family: "domain-plan";
21
+ };
22
+ }];
23
+ readonly inputs: readonly [{
24
+ readonly family: "domain-plan";
25
+ }, {
26
+ readonly family: "requirements";
27
+ }];
28
+ readonly outputs: readonly [{
29
+ readonly family: "placement-plan";
30
+ readonly schemaRef: "saas-specifications:PlacementPlan";
31
+ readonly description: "The placement decision — `groups[]` (the containers that should exist on the grouped surfaces, each with the product purpose behind it) plus `decisions[]` (one per subject PER SURFACE: a stable `decisionRef`, the `PlacementSubject` being placed — an engine settings destination by ref, a resource operation, or an app view — a `PlacementDisposition` of PLACED or DECLINED, the surface-discriminated `PlacementAddress` when placed, and a REQUIRED `rationale` on both arms). Each decision also carries a REQUIRED `origin` — `DELIBERATED` or `REVISED` — which the trusted runtime stamps `DELIBERATED`; it is not representable in the provider-facing generation shape, because a panel run IS the panel's judgement and a model cannot declare its own output a human revision. A later edit that changes a decision sets `origin: REVISED` and records the panel's own reasoning in `supersedes.rationale`, so the artifact stops asserting panel reasoning for a decision the panel never took. Typed by the `_core` `placement-plan` family (`PlacementPlan`); the provider answers the strict `PlacementPlanGeneration` shape and the trusted runtime stamps refs and version. `validatePlacementPlan` is the deterministic validator: one subject placed twice on the SAME surface is a hard floor (the plan contradicts itself), while an empty group and an order collision are authoring warnings. Its coverage checks run only when the caller supplies the destination catalog, so a run without one reports no coverage result rather than a clean one. The plan carries no file path, config key or label string — those belong to the coding task that authors the config.";
32
+ }];
33
+ readonly method: {
34
+ readonly "//contextSources": "WORKSPACE_TRUTH — placement is decided against what EXISTS: the real engine settings destinations, the real resources and their operations, and the shell surfaces the application already has. A planner working from the definition artifacts alone invents destination refs that resolve to nothing, and every decision it emits is unplaceable.";
35
+ readonly contextSources: readonly ["workspace_truth"];
36
+ readonly skillRefs: readonly ["settings-placement-authoring", "config-app-shell", "config-navigation", "journey-status"];
37
+ readonly "//deliberation": "Placement is DECIDED BY A PANEL, not elicited from the creator: the arrangement that is right for an application has several defensible answers, and the creator is the person least equipped to choose between them before the app exists. The information-architect OWNS the domain (so it derives the rubric); the design-system-guardian sits as the coherence memory, because where a thing goes must not fork the pattern the shipped surfaces already taught users. Three candidates, because the criteria trade off against each other — first-run discoverability, the daily-use path, and category convention pull in different directions and a single pass silently picks one.";
38
+ readonly deliberation: {
39
+ readonly workDomain: "information_architecture";
40
+ readonly reviewerRoleRefs: readonly ["information-architect", "design-system-guardian"];
41
+ readonly coordinatorRoleRef: "design-system-guardian";
42
+ readonly rubricDeriverRoleRef: "information-architect";
43
+ readonly candidateCount: 3;
44
+ };
45
+ };
46
+ readonly executor: "companion_agent";
47
+ readonly approval: "approve_result";
48
+ readonly budget: {
49
+ readonly maxRuns: 3;
50
+ };
51
+ readonly onFailure: "keep_and_flag";
52
+ };
53
+ //# sourceMappingURL=playbook.definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.placement-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CrB,CAAC"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Canonical native declaration for this reusable application-creation method.
3
+ *
4
+ * Placement is a DECISION the creator should not have to make. This playbook
5
+ * produces it as an artifact, with a per-decision rationale, so a later reader
6
+ * can ask "why is this here?" without re-deriving the answer.
7
+ */
8
+ export const playbookDefinition = {
9
+ "ref": "bottom_up.placement-plan",
10
+ "version": "0.1.0",
11
+ "phase": "bottom_up",
12
+ "intent": "Decide WHERE every settings destination, resource operation and application view sits in the application shell, and WHY. Reads the domain plan (the modules, their resources and what they mean) and the requirements (which tasks matter), and produces a PLACEMENT PLAN: for each subject, either a PLACED decision naming one surface (the settings hub rail, the sidebar, the user menu, the command palette) and its address on that surface, or an explicit DECLINED decision with a reason. Both carry a rationale. It also declares the GROUPS that should exist on the grouped surfaces (settings rail categories, sidebar sections) with the product purpose behind each, which is what grounds their generated labels in authored intent instead of filler. This playbook DECIDES placement; it does NOT author configuration — turning a decision into `frontend/src/config/settings-hub.config.ts` and `app-shell.config.ts` is a coding task the build lane dispatches through the `settings-placement-authoring` skill. It runs BEFORE build-decompose, which consumes the plan and emits those tasks — the reverse order would be a cycle, since build-decompose is what produces the build plan. It writes no TypeScript, invents no destination refs, and authors no labels. It exists because the alternative is the framework defaulting placement, which is what made an application's settings rail unauthorable: nothing is placed implicitly, so a subject nobody decided about is a visible coverage gap rather than a silent framework default.",
13
+ "functionalTopics": ["shape_user_experience"],
14
+ "preconditions": [
15
+ { "kind": "phase_is", "phase": "bottom_up" },
16
+ { "kind": "artifact_exists", "selector": { "family": "domain-plan" } }
17
+ ],
18
+ "inputs": [
19
+ { "family": "domain-plan" },
20
+ { "family": "requirements" }
21
+ ],
22
+ "outputs": [
23
+ {
24
+ "family": "placement-plan",
25
+ "schemaRef": "saas-specifications:PlacementPlan",
26
+ "description": "The placement decision — `groups[]` (the containers that should exist on the grouped surfaces, each with the product purpose behind it) plus `decisions[]` (one per subject PER SURFACE: a stable `decisionRef`, the `PlacementSubject` being placed — an engine settings destination by ref, a resource operation, or an app view — a `PlacementDisposition` of PLACED or DECLINED, the surface-discriminated `PlacementAddress` when placed, and a REQUIRED `rationale` on both arms). Each decision also carries a REQUIRED `origin` — `DELIBERATED` or `REVISED` — which the trusted runtime stamps `DELIBERATED`; it is not representable in the provider-facing generation shape, because a panel run IS the panel's judgement and a model cannot declare its own output a human revision. A later edit that changes a decision sets `origin: REVISED` and records the panel's own reasoning in `supersedes.rationale`, so the artifact stops asserting panel reasoning for a decision the panel never took. Typed by the `_core` `placement-plan` family (`PlacementPlan`); the provider answers the strict `PlacementPlanGeneration` shape and the trusted runtime stamps refs and version. `validatePlacementPlan` is the deterministic validator: one subject placed twice on the SAME surface is a hard floor (the plan contradicts itself), while an empty group and an order collision are authoring warnings. Its coverage checks run only when the caller supplies the destination catalog, so a run without one reports no coverage result rather than a clean one. The plan carries no file path, config key or label string — those belong to the coding task that authors the config."
27
+ }
28
+ ],
29
+ "method": {
30
+ "//contextSources": "WORKSPACE_TRUTH — placement is decided against what EXISTS: the real engine settings destinations, the real resources and their operations, and the shell surfaces the application already has. A planner working from the definition artifacts alone invents destination refs that resolve to nothing, and every decision it emits is unplaceable.",
31
+ "contextSources": ["workspace_truth"],
32
+ "skillRefs": [
33
+ "settings-placement-authoring",
34
+ "config-app-shell",
35
+ "config-navigation",
36
+ "journey-status"
37
+ ],
38
+ "//deliberation": "Placement is DECIDED BY A PANEL, not elicited from the creator: the arrangement that is right for an application has several defensible answers, and the creator is the person least equipped to choose between them before the app exists. The information-architect OWNS the domain (so it derives the rubric); the design-system-guardian sits as the coherence memory, because where a thing goes must not fork the pattern the shipped surfaces already taught users. Three candidates, because the criteria trade off against each other — first-run discoverability, the daily-use path, and category convention pull in different directions and a single pass silently picks one.",
39
+ "deliberation": {
40
+ "workDomain": "information_architecture",
41
+ "reviewerRoleRefs": ["information-architect", "design-system-guardian"],
42
+ "coordinatorRoleRef": "design-system-guardian",
43
+ "rubricDeriverRoleRef": "information-architect",
44
+ "candidateCount": 3
45
+ }
46
+ },
47
+ "executor": "companion_agent",
48
+ "approval": "approve_result",
49
+ "budget": {
50
+ "maxRuns": 3
51
+ },
52
+ "onFailure": "keep_and_flag"
53
+ };
54
+ //# sourceMappingURL=playbook.definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.placement-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,0BAA0B;IACjC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,2+CAA2+C;IACr/C,kBAAkB,EAAE,CAAC,uBAAuB,CAAC;IAC7C,eAAe,EAAE;QACf,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE;QAC5C,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE;KACvE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,aAAa,EAAE;QAC3B,EAAE,QAAQ,EAAE,cAAc,EAAE;KAC7B;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,mCAAmC;YAChD,aAAa,EAAE,0mDAA0mD;SAC1nD;KACF;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,qVAAqV;QACzW,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;QACrC,WAAW,EAAE;YACX,8BAA8B;YAC9B,kBAAkB;YAClB,mBAAmB;YACnB,gBAAgB;SACjB;QACD,gBAAgB,EAAE,4pBAA4pB;QAC9qB,cAAc,EAAE;YACd,YAAY,EAAE,0BAA0B;YACxC,kBAAkB,EAAE,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;YACvE,oBAAoB,EAAE,wBAAwB;YAC9C,sBAAsB,EAAE,uBAAuB;YAC/C,gBAAgB,EAAE,CAAC;SACpB;KACF;IACD,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;KACb;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for this reusable application-creation method.\n *\n * Placement is a DECISION the creator should not have to make. This playbook\n * produces it as an artifact, with a per-decision rationale, so a later reader\n * can ask \"why is this here?\" without re-deriving the answer.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"bottom_up.placement-plan\",\n \"version\": \"0.1.0\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Decide WHERE every settings destination, resource operation and application view sits in the application shell, and WHY. Reads the domain plan (the modules, their resources and what they mean) and the requirements (which tasks matter), and produces a PLACEMENT PLAN: for each subject, either a PLACED decision naming one surface (the settings hub rail, the sidebar, the user menu, the command palette) and its address on that surface, or an explicit DECLINED decision with a reason. Both carry a rationale. It also declares the GROUPS that should exist on the grouped surfaces (settings rail categories, sidebar sections) with the product purpose behind each, which is what grounds their generated labels in authored intent instead of filler. This playbook DECIDES placement; it does NOT author configuration — turning a decision into `frontend/src/config/settings-hub.config.ts` and `app-shell.config.ts` is a coding task the build lane dispatches through the `settings-placement-authoring` skill. It runs BEFORE build-decompose, which consumes the plan and emits those tasks — the reverse order would be a cycle, since build-decompose is what produces the build plan. It writes no TypeScript, invents no destination refs, and authors no labels. It exists because the alternative is the framework defaulting placement, which is what made an application's settings rail unauthorable: nothing is placed implicitly, so a subject nobody decided about is a visible coverage gap rather than a silent framework default.\",\n \"functionalTopics\": [\"shape_user_experience\"],\n \"preconditions\": [\n { \"kind\": \"phase_is\", \"phase\": \"bottom_up\" },\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"domain-plan\" },\n { \"family\": \"requirements\" }\n ],\n \"outputs\": [\n {\n \"family\": \"placement-plan\",\n \"schemaRef\": \"saas-specifications:PlacementPlan\",\n \"description\": \"The placement decision — `groups[]` (the containers that should exist on the grouped surfaces, each with the product purpose behind it) plus `decisions[]` (one per subject PER SURFACE: a stable `decisionRef`, the `PlacementSubject` being placed — an engine settings destination by ref, a resource operation, or an app view — a `PlacementDisposition` of PLACED or DECLINED, the surface-discriminated `PlacementAddress` when placed, and a REQUIRED `rationale` on both arms). Each decision also carries a REQUIRED `origin` — `DELIBERATED` or `REVISED` — which the trusted runtime stamps `DELIBERATED`; it is not representable in the provider-facing generation shape, because a panel run IS the panel's judgement and a model cannot declare its own output a human revision. A later edit that changes a decision sets `origin: REVISED` and records the panel's own reasoning in `supersedes.rationale`, so the artifact stops asserting panel reasoning for a decision the panel never took. Typed by the `_core` `placement-plan` family (`PlacementPlan`); the provider answers the strict `PlacementPlanGeneration` shape and the trusted runtime stamps refs and version. `validatePlacementPlan` is the deterministic validator: one subject placed twice on the SAME surface is a hard floor (the plan contradicts itself), while an empty group and an order collision are authoring warnings. Its coverage checks run only when the caller supplies the destination catalog, so a run without one reports no coverage result rather than a clean one. The plan carries no file path, config key or label string — those belong to the coding task that authors the config.\"\n }\n ],\n \"method\": {\n \"//contextSources\": \"WORKSPACE_TRUTH — placement is decided against what EXISTS: the real engine settings destinations, the real resources and their operations, and the shell surfaces the application already has. A planner working from the definition artifacts alone invents destination refs that resolve to nothing, and every decision it emits is unplaceable.\",\n \"contextSources\": [\"workspace_truth\"],\n \"skillRefs\": [\n \"settings-placement-authoring\",\n \"config-app-shell\",\n \"config-navigation\",\n \"journey-status\"\n ],\n \"//deliberation\": \"Placement is DECIDED BY A PANEL, not elicited from the creator: the arrangement that is right for an application has several defensible answers, and the creator is the person least equipped to choose between them before the app exists. The information-architect OWNS the domain (so it derives the rubric); the design-system-guardian sits as the coherence memory, because where a thing goes must not fork the pattern the shipped surfaces already taught users. Three candidates, because the criteria trade off against each other — first-run discoverability, the daily-use path, and category convention pull in different directions and a single pass silently picks one.\",\n \"deliberation\": {\n \"workDomain\": \"information_architecture\",\n \"reviewerRoleRefs\": [\"information-architect\", \"design-system-guardian\"],\n \"coordinatorRoleRef\": \"design-system-guardian\",\n \"rubricDeriverRoleRef\": \"information-architect\",\n \"candidateCount\": 3\n }\n },\n \"executor\": \"companion_agent\",\n \"approval\": \"approve_result\",\n \"budget\": {\n \"maxRuns\": 3\n },\n \"onFailure\": \"keep_and_flag\"\n} as const;\n"]}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Canonical native declaration for this reusable application-creation method.
3
+ *
4
+ * Migrated from the retired JSON-v1 authoring format at the first-activation
5
+ * hard cut (same ref@version — the companion's assurance-document candidate
6
+ * preparation pins `refinement.compliance-document-candidate@0.1.0` in the
7
+ * installed Framework Knowledge and fails closed without it). This source
8
+ * intentionally omits the superseded per-playbook evaluation-treatment object;
9
+ * generation records that absence rather than fabricating legacy judge behavior.
10
+ */
11
+ export declare const playbookDefinition: {
12
+ readonly ref: "refinement.compliance-document-candidate";
13
+ readonly version: "0.1.0";
14
+ readonly phase: "refinement";
15
+ readonly intent: "Propose structured privacy-notice or service-terms candidate content from the application's accepted document facts. The companion agent may draft prose but cannot invent a fact, decide a legal question, approve, release or publish the document: every clause it writes is checked against the `document-facts` family, and a clause asserting a fact the application never declared is refused before it becomes a file.";
16
+ readonly functionalTopics: readonly [];
17
+ readonly preconditions: readonly [{
18
+ readonly kind: "artifact_expected";
19
+ readonly selector: {
20
+ readonly family: "document-facts";
21
+ };
22
+ }];
23
+ readonly inputs: readonly [{
24
+ readonly family: "document-facts";
25
+ }];
26
+ readonly outputs: readonly [{
27
+ readonly family: "compliance-document-candidate";
28
+ readonly schemaRef: "saas-specifications:ComplianceDocumentCandidate";
29
+ readonly description: "An untrusted structured content proposal that lands as a FILE for a human to read and commit. Its clauses are validated against the application's accepted document facts before the write; landing is never an approval, a release or a publication. Nothing is sealed — the draft is accepted by being committed.";
30
+ }];
31
+ readonly method: {
32
+ readonly "//contextSources": "DOCUMENT_BLUEPRINT — this playbook DRAFTS a governed document, and the catalog is the only thing that says what one must contain. Measured 2026-08-30: `document-definition:public.privacy-notice` requires eight facts; wonder-crm's generated notice declared twenty and matched NONE of them, scoring zero dangling citations throughout — internally consistent, and addressing none of what a privacy notice is obliged to address. The catalog had held the answer since it was written and had no runtime lookup of any kind, while this playbook's own skill instructed the drafter to \"Read the definition and blueprint\": a step it was told to perform and given nothing to perform it on. Deliberately NOT COMPLIANCE_PRIMARY_FACTS: that source carries raw resource declarations and belongs to `refinement.document-facts`, which declares it. A drafter given mechanism directly could write a clause resting on something the application never DECLARED, which is precisely what the fact-binding check exists to refuse — this playbook reads the declared `document-facts` family and nothing beneath it.";
33
+ readonly contextSources: readonly ["document_blueprint"];
34
+ readonly skillRefs: readonly ["compliance-document-authoring"];
35
+ };
36
+ readonly executor: "companion_agent";
37
+ readonly approval: "approve_result";
38
+ readonly budget: {
39
+ readonly maxRuns: 3;
40
+ };
41
+ readonly onFailure: "keep_and_flag";
42
+ };
43
+ //# sourceMappingURL=playbook.definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.compliance-document-candidate/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DrB,CAAC"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Canonical native declaration for this reusable application-creation method.
3
+ *
4
+ * Migrated from the retired JSON-v1 authoring format at the first-activation
5
+ * hard cut (same ref@version — the companion's assurance-document candidate
6
+ * preparation pins `refinement.compliance-document-candidate@0.1.0` in the
7
+ * installed Framework Knowledge and fails closed without it). This source
8
+ * intentionally omits the superseded per-playbook evaluation-treatment object;
9
+ * generation records that absence rather than fabricating legacy judge behavior.
10
+ */
11
+ export const playbookDefinition = {
12
+ "ref": "refinement.compliance-document-candidate",
13
+ "version": "0.1.0",
14
+ "phase": "refinement",
15
+ "intent": "Propose structured privacy-notice or service-terms candidate content from the application's accepted document facts. The companion agent may draft prose but cannot invent a fact, decide a legal question, approve, release or publish the document: every clause it writes is checked against the `document-facts` family, and a clause asserting a fact the application never declared is refused before it becomes a file.",
16
+ "functionalTopics": [],
17
+ "preconditions": [
18
+ {
19
+ /*
20
+ * The facts this draft SHOULD rest on — expected first, never a gate.
21
+ *
22
+ * Three revisions, and the middle one is the instructive part:
23
+ *
24
+ * 1. Until 2026-08-28 this gated on `compliance-document-fact-projection`, a host-computed
25
+ * projection sealed with a projector identity, source-head digests and per-contribution
26
+ * authority receipts. `artifact_valid` reads LANDED families and a host-computed projection
27
+ * never lands, so the precondition could never be satisfied: this playbook, and with it the
28
+ * whole `refinement` phase, was permanently ineligible from the day it was authored, and
29
+ * nothing reported it because an ineligible playbook never reaches the board. The projection
30
+ * went with the digest demolition (`.claude/rules/one-source-of-truth.md`, Rule 0).
31
+ * 2. It was then re-gated onto `document-facts` with `artifact_valid`, which made it reachable
32
+ * — and blocking. That is the wrong posture for a compliance document: an application must be
33
+ * able to produce its privacy notice today, with the statements it cannot yet establish
34
+ * marked incomplete, and complete them later. A document nobody can produce is worth less
35
+ * than one that states precisely what is missing.
36
+ * 3. `artifact_expected` (SEQUENCING) says facts come first while letting a human run proceed
37
+ * past it. What the old projection PROTECTED — a document may not assert what nobody
38
+ * established — is unaffected: it is a cross-reference check between this draft and the
39
+ * facts file, run before the write, and it refuses INVENTION rather than incompleteness.
40
+ */
41
+ "kind": "artifact_expected",
42
+ "selector": {
43
+ "family": "document-facts"
44
+ }
45
+ }
46
+ ],
47
+ "inputs": [
48
+ {
49
+ "family": "document-facts"
50
+ }
51
+ ],
52
+ "outputs": [
53
+ {
54
+ "family": "compliance-document-candidate",
55
+ "schemaRef": "saas-specifications:ComplianceDocumentCandidate",
56
+ "description": "An untrusted structured content proposal that lands as a FILE for a human to read and commit. Its clauses are validated against the application's accepted document facts before the write; landing is never an approval, a release or a publication. Nothing is sealed \u2014 the draft is accepted by being committed."
57
+ }
58
+ ],
59
+ "method": {
60
+ "//contextSources": "DOCUMENT_BLUEPRINT \u2014 this playbook DRAFTS a governed document, and the catalog is the only thing that says what one must contain. Measured 2026-08-30: `document-definition:public.privacy-notice` requires eight facts; wonder-crm's generated notice declared twenty and matched NONE of them, scoring zero dangling citations throughout \u2014 internally consistent, and addressing none of what a privacy notice is obliged to address. The catalog had held the answer since it was written and had no runtime lookup of any kind, while this playbook's own skill instructed the drafter to \"Read the definition and blueprint\": a step it was told to perform and given nothing to perform it on. Deliberately NOT COMPLIANCE_PRIMARY_FACTS: that source carries raw resource declarations and belongs to `refinement.document-facts`, which declares it. A drafter given mechanism directly could write a clause resting on something the application never DECLARED, which is precisely what the fact-binding check exists to refuse \u2014 this playbook reads the declared `document-facts` family and nothing beneath it.",
61
+ "contextSources": ["document_blueprint"],
62
+ "skillRefs": [
63
+ "compliance-document-authoring"
64
+ ]
65
+ },
66
+ "executor": "companion_agent",
67
+ "approval": "approve_result",
68
+ "budget": {
69
+ "maxRuns": 3
70
+ },
71
+ "onFailure": "keep_and_flag"
72
+ };
73
+ //# sourceMappingURL=playbook.definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.compliance-document-candidate/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC/B;IACE,KAAK,EAAE,0CAA0C;IACjD,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,gaAAga;IAC1a,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE;QACf;YACE;;;;;;;;;;;;;;;;;;;;;eAqBG;YACH,MAAM,EAAE,mBAAmB;YAC3B,UAAU,EAAE;gBACV,QAAQ,EAAE,gBAAgB;aAC3B;SACF;KACF;IACD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,+BAA+B;YACzC,WAAW,EAAE,iDAAiD;YAC9D,aAAa,EAAE,0TAA0T;SAC1U;KACF;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,glCAAglC;QACpmC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,WAAW,EAAE;YACX,+BAA+B;SAChC;KACF;IACD,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE;QACR,SAAS,EAAE,CAAC;KACb;IACD,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["/**\n * Canonical native declaration for this reusable application-creation method.\n *\n * Migrated from the retired JSON-v1 authoring format at the first-activation\n * hard cut (same ref@version — the companion's assurance-document candidate\n * preparation pins `refinement.compliance-document-candidate@0.1.0` in the\n * installed Framework Knowledge and fails closed without it). This source\n * intentionally omits the superseded per-playbook evaluation-treatment object;\n * generation records that absence rather than fabricating legacy judge behavior.\n */\nexport const playbookDefinition =\n{\n \"ref\": \"refinement.compliance-document-candidate\",\n \"version\": \"0.1.0\",\n \"phase\": \"refinement\",\n \"intent\": \"Propose structured privacy-notice or service-terms candidate content from the application's accepted document facts. The companion agent may draft prose but cannot invent a fact, decide a legal question, approve, release or publish the document: every clause it writes is checked against the `document-facts` family, and a clause asserting a fact the application never declared is refused before it becomes a file.\",\n \"functionalTopics\": [],\n \"preconditions\": [\n {\n /*\n * The facts this draft SHOULD rest on — expected first, never a gate.\n *\n * Three revisions, and the middle one is the instructive part:\n *\n * 1. Until 2026-08-28 this gated on `compliance-document-fact-projection`, a host-computed\n * projection sealed with a projector identity, source-head digests and per-contribution\n * authority receipts. `artifact_valid` reads LANDED families and a host-computed projection\n * never lands, so the precondition could never be satisfied: this playbook, and with it the\n * whole `refinement` phase, was permanently ineligible from the day it was authored, and\n * nothing reported it because an ineligible playbook never reaches the board. The projection\n * went with the digest demolition (`.claude/rules/one-source-of-truth.md`, Rule 0).\n * 2. It was then re-gated onto `document-facts` with `artifact_valid`, which made it reachable\n * — and blocking. That is the wrong posture for a compliance document: an application must be\n * able to produce its privacy notice today, with the statements it cannot yet establish\n * marked incomplete, and complete them later. A document nobody can produce is worth less\n * than one that states precisely what is missing.\n * 3. `artifact_expected` (SEQUENCING) says facts come first while letting a human run proceed\n * past it. What the old projection PROTECTED — a document may not assert what nobody\n * established — is unaffected: it is a cross-reference check between this draft and the\n * facts file, run before the write, and it refuses INVENTION rather than incompleteness.\n */\n \"kind\": \"artifact_expected\",\n \"selector\": {\n \"family\": \"document-facts\"\n }\n }\n ],\n \"inputs\": [\n {\n \"family\": \"document-facts\"\n }\n ],\n \"outputs\": [\n {\n \"family\": \"compliance-document-candidate\",\n \"schemaRef\": \"saas-specifications:ComplianceDocumentCandidate\",\n \"description\": \"An untrusted structured content proposal that lands as a FILE for a human to read and commit. Its clauses are validated against the application's accepted document facts before the write; landing is never an approval, a release or a publication. Nothing is sealed \\u2014 the draft is accepted by being committed.\"\n }\n ],\n \"method\": {\n \"//contextSources\": \"DOCUMENT_BLUEPRINT \\u2014 this playbook DRAFTS a governed document, and the catalog is the only thing that says what one must contain. Measured 2026-08-30: `document-definition:public.privacy-notice` requires eight facts; wonder-crm's generated notice declared twenty and matched NONE of them, scoring zero dangling citations throughout \\u2014 internally consistent, and addressing none of what a privacy notice is obliged to address. The catalog had held the answer since it was written and had no runtime lookup of any kind, while this playbook's own skill instructed the drafter to \\\"Read the definition and blueprint\\\": a step it was told to perform and given nothing to perform it on. Deliberately NOT COMPLIANCE_PRIMARY_FACTS: that source carries raw resource declarations and belongs to `refinement.document-facts`, which declares it. A drafter given mechanism directly could write a clause resting on something the application never DECLARED, which is precisely what the fact-binding check exists to refuse \\u2014 this playbook reads the declared `document-facts` family and nothing beneath it.\",\n \"contextSources\": [\"document_blueprint\"],\n \"skillRefs\": [\n \"compliance-document-authoring\"\n ]\n },\n \"executor\": \"companion_agent\",\n \"approval\": \"approve_result\",\n \"budget\": {\n \"maxRuns\": 3\n },\n \"onFailure\": \"keep_and_flag\"\n} as const;\n"]}
@@ -0,0 +1,53 @@
1
+ import { MetaWorkflow_ApprovalPolicy, MetaWorkflow_ContextSource, MetaWorkflow_Executor, MetaWorkflow_FailurePolicy, MetaWorkflow_Phase, MetaWorkflow_PredicateKind } from '@wildo-ai/saas-specifications/application-creation';
2
+ /**
3
+ * Canonical native declaration for this reusable application-creation method.
4
+ *
5
+ * ## Why this playbook exists
6
+ *
7
+ * `refinement.compliance-document-candidate` drafts a governed document, and a governed document may
8
+ * not assert anything about the application that nobody established. Until 2026-08-28 the fact set it
9
+ * rested on was a HOST-COMPUTED projection sealed with a projector identity, source-head digests and
10
+ * per-contribution authority receipts — none of it branchable on git, all of it deleted
11
+ * (`.claude/rules/one-source-of-truth.md`, Rule 0).
12
+ *
13
+ * The candidate playbook was left gating on that projection, which is why it — and with it the whole
14
+ * `refinement` phase — had been permanently ineligible since it was authored: `artifact_valid` reads
15
+ * LANDED families, and a host-computed projection never lands.
16
+ *
17
+ * This is the replacement, and it is deliberately ordinary: the facts become a FILE the application
18
+ * commits, like every other family. What used to be enforced by a seal is now enforced by a pure
19
+ * cross-reference check at the drafting boundary — a clause citing a fact this file does not declare
20
+ * is refused before it can be written.
21
+ */
22
+ export declare const playbookDefinition: {
23
+ ref: string;
24
+ version: string;
25
+ phase: MetaWorkflow_Phase.REFINEMENT;
26
+ intent: string;
27
+ functionalTopics: any[];
28
+ preconditions: {
29
+ kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID;
30
+ selector: {
31
+ family: string;
32
+ };
33
+ }[];
34
+ inputs: {
35
+ family: string;
36
+ }[];
37
+ outputs: {
38
+ family: string;
39
+ schemaRef: string;
40
+ description: string;
41
+ }[];
42
+ method: {
43
+ contextSources: (MetaWorkflow_ContextSource.COMPLIANCE_PRIMARY_FACTS | MetaWorkflow_ContextSource.DOCUMENT_FACT_OBLIGATIONS)[];
44
+ skillRefs: string[];
45
+ };
46
+ executor: MetaWorkflow_Executor.COMPANION_AGENT;
47
+ approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT;
48
+ budget: {
49
+ maxRuns: number;
50
+ };
51
+ onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG;
52
+ };
53
+ //# sourceMappingURL=playbook.definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.document-facts/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAE3B,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6F+G,CAAC"}
@@ -0,0 +1,114 @@
1
+ import { MetaWorkflow_ApprovalPolicy, MetaWorkflow_ContextSource, MetaWorkflow_Executor, MetaWorkflow_FailurePolicy, MetaWorkflow_Phase, MetaWorkflow_PredicateKind, } from '@wildo-ai/saas-specifications/application-creation';
2
+ /**
3
+ * Canonical native declaration for this reusable application-creation method.
4
+ *
5
+ * ## Why this playbook exists
6
+ *
7
+ * `refinement.compliance-document-candidate` drafts a governed document, and a governed document may
8
+ * not assert anything about the application that nobody established. Until 2026-08-28 the fact set it
9
+ * rested on was a HOST-COMPUTED projection sealed with a projector identity, source-head digests and
10
+ * per-contribution authority receipts — none of it branchable on git, all of it deleted
11
+ * (`.claude/rules/one-source-of-truth.md`, Rule 0).
12
+ *
13
+ * The candidate playbook was left gating on that projection, which is why it — and with it the whole
14
+ * `refinement` phase — had been permanently ineligible since it was authored: `artifact_valid` reads
15
+ * LANDED families, and a host-computed projection never lands.
16
+ *
17
+ * This is the replacement, and it is deliberately ordinary: the facts become a FILE the application
18
+ * commits, like every other family. What used to be enforced by a seal is now enforced by a pure
19
+ * cross-reference check at the drafting boundary — a clause citing a fact this file does not declare
20
+ * is refused before it can be written.
21
+ */
22
+ export const playbookDefinition = {
23
+ ref: 'refinement.document-facts',
24
+ version: '0.1.0',
25
+ phase: MetaWorkflow_Phase.REFINEMENT,
26
+ intent: "Derive the application's governed-document FACTS from truth it has already accepted — its vision (including the compliance regimes the posture pass recorded), its domain and its requirements — and land them as the `document-facts` family. A fact is a plain statement about how this application actually behaves: what data it holds, how long it keeps it, who it discloses to, what rights it honours. This produces the raw material a privacy notice or service terms is drafted FROM; it never drafts the document, never decides a legal question, and never states a fact the application's own code and accepted specifications do not support. Mechanism facts — retention treatment, data-subject kind, subject export — are read from the resource configurations, which declare what the application will actually do to a row; specifications supply purpose, not mechanism.",
27
+ functionalTopics: [],
28
+ preconditions: [
29
+ /*
30
+ * There is deliberately NO `PHASE_IS` gate, and its absence is the fix for #116.
31
+ *
32
+ * This playbook gated on `PHASE_IS: REFINEMENT` from the day it was authored. `deriveJourneyPhase`
33
+ * returns only TOP_DOWN or BOTTOM_UP, so that precondition could never be satisfied and the
34
+ * unattended loop could never select this playbook — while nothing reported it, because an
35
+ * ineligible playbook never reaches the eligibility board. Audit rule 27 now catches the shape at
36
+ * PR time.
37
+ *
38
+ * Fixed the same way its sibling `refinement.compliance-document-candidate` was on 2026-08-28:
39
+ * gate on the ARTIFACTS the pass actually needs, not on a phase. That is also the direction the
40
+ * design takes generally — phases are first-run scaffolding, and an evolving application is not in
41
+ * a phase, it is in a state, and the state is the tree. The two `ARTIFACT_VALID` gates below are
42
+ * the real readiness requirement and are unchanged; nothing about when this pass is SAFE to run
43
+ * depended on the phase.
44
+ */
45
+ /*
46
+ * The vision is required rather than merely declared: `top_down.compliance-posture` records each
47
+ * applicable regime as a `compliance`-kind constraint there, and those constraints are what tell
48
+ * this pass WHICH facts a later document will need. A derivation with no regime in view produces a
49
+ * plausible generic fact set — the exact failure `compliance-document-system.md` forbids ("do not
50
+ * generate legal text from a generic SaaS category when application facts are absent").
51
+ */
52
+ { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'vision-brief' } },
53
+ /*
54
+ * The domain plan is where the application's resources and their data actually live. Retention,
55
+ * data categories and disclosure facts are read from it; without it this pass would be inventing
56
+ * what the product stores.
57
+ */
58
+ { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'domain-plan' } },
59
+ ],
60
+ inputs: [{ family: 'vision-brief' }, { family: 'domain-plan' }, { family: 'requirements' }],
61
+ outputs: [{
62
+ family: 'document-facts',
63
+ schemaRef: 'saas-specifications:ApplicationDocumentFactSpecification',
64
+ description: "The application's declared governed-document facts, one declaration per fact, each either KNOWN with its value or NOT_APPLICABLE with a reason. Authority is APPLICATION_SPECIFICATION throughout: these are facts the application's own accepted specifications establish. A fact needing a named human decision is deliberately ABSENT rather than dressed in an authority nobody holds.",
65
+ }],
66
+ method: {
67
+ /*
68
+ * The resource declarations reach the brief through this, and nothing else does.
69
+ *
70
+ * This playbook's intent and its method have said since the day they were authored that mechanism
71
+ * facts "are read from the resource configurations". They were not: the `compliance-primary-facts`
72
+ * behavior existed and answered correctly, and no playbook declared it, so the derivation the
73
+ * method describes could not happen. Its first live run (wonder-crm, 2026-08-29) landed two facts,
74
+ * both paraphrased from vision prose, neither citing a declaration — a schema-valid artifact that
75
+ * was wrong about where it came from, which is the one failure mode a governed document cannot
76
+ * survive.
77
+ *
78
+ * NOT `WORKSPACE_TRUTH`: that section carries module ids and schema FIELD NAMES for a build
79
+ * planner. A field's name says nothing about whether erasing its subject scrubs it.
80
+ *
81
+ * The run immediately after wiring it landed a fact reading "contact records are retained and
82
+ * impersonalized on erasure; workspace, workspace-member, company, pipeline-stage, deal, next-step
83
+ * and interaction are declared RETAIN_ONLY" — per resource, from the declarations. The run before
84
+ * it, on the same application and the same method prose, had produced two paraphrases of the
85
+ * vision. Nothing about the guidance changed; the evidence arrived.
86
+ */
87
+ /*
88
+ * DOCUMENT_FACT_OBLIGATIONS supplies the second half, and it is the one this playbook had never
89
+ * been given: the NAMES.
90
+ *
91
+ * COMPLIANCE_PRIMARY_FACTS made the answers true — the run after wiring it landed a per-resource
92
+ * erasure fact instead of two paraphrases of the vision. It did nothing about what those answers
93
+ * are CALLED, and a fact's ref is stamped from the slug this playbook chooses. Measured 2026-08-30:
94
+ * twenty facts declared, ZERO of the eight a privacy notice requires, because the names were
95
+ * semantically adjacent and lexically disjoint. True answers, uncitable.
96
+ *
97
+ * The method below already asks for stable descriptive slugs and names three of the eight as
98
+ * examples, and has since 2026-08-28. That is prose, and the churn was measured with it in place.
99
+ * This supplies the closed set itself, which the engine catalog has held all along.
100
+ */
101
+ contextSources: [MetaWorkflow_ContextSource.COMPLIANCE_PRIMARY_FACTS, MetaWorkflow_ContextSource.DOCUMENT_FACT_OBLIGATIONS],
102
+ skillRefs: ['journey-status'],
103
+ },
104
+ executor: MetaWorkflow_Executor.COMPANION_AGENT,
105
+ approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT,
106
+ budget: { maxRuns: 3 },
107
+ onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG,
108
+ /*
109
+ * `guidance` is deliberately absent: the method prose is the single source of truth in `method.md`,
110
+ * and the generator renders it (partials + references expanded) and injects it as `method.guidance`.
111
+ * Declaring it here would be a second copy that drifts — the folder contract rejects an inline one.
112
+ */
113
+ };
114
+ //# sourceMappingURL=playbook.definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.document-facts/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,GAE3B,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,2BAA2B;IAChC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,kBAAkB,CAAC,UAAU;IACpC,MAAM,EACJ,i2BAAi2B;IACn2B,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE;QACb;;;;;;;;;;;;;;;WAeG;QACH;;;;;;WAMG;QACH,EAAE,IAAI,EAAE,0BAA0B,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;QACzF;;;;WAIG;QACH,EAAE,IAAI,EAAE,0BAA0B,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE;KACzF;IACD,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC3F,OAAO,EAAE,CAAC;YACR,MAAM,EAAE,gBAAgB;YACxB,SAAS,EAAE,0DAA0D;YACrE,WAAW,EACT,4XAA4X;SAC/X,CAAC;IACF,MAAM,EAAE;QACN;;;;;;;;;;;;;;;;;;;WAmBG;QACH;;;;;;;;;;;;;WAaG;QACH,cAAc,EAAE,CAAC,0BAA0B,CAAC,wBAAwB,EAAE,0BAA0B,CAAC,yBAAyB,CAAC;QAC3H,SAAS,EAAE,CAAC,gBAAgB,CAAC;KAC9B;IACD,QAAQ,EAAE,qBAAqB,CAAC,eAAe;IAC/C,QAAQ,EAAE,2BAA2B,CAAC,cAAc;IACpD,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IACtB,SAAS,EAAE,0BAA0B,CAAC,aAAa;IACnD;;;;OAIG;CACyI,CAAC","sourcesContent":["import {\n MetaWorkflow_ApprovalPolicy,\n MetaWorkflow_ContextSource,\n MetaWorkflow_Executor,\n MetaWorkflow_FailurePolicy,\n MetaWorkflow_Phase,\n MetaWorkflow_PredicateKind,\n type MetaWorkflowPlaybookAuthoring,\n} from '@wildo-ai/saas-specifications/application-creation';\n\n/**\n * Canonical native declaration for this reusable application-creation method.\n *\n * ## Why this playbook exists\n *\n * `refinement.compliance-document-candidate` drafts a governed document, and a governed document may\n * not assert anything about the application that nobody established. Until 2026-08-28 the fact set it\n * rested on was a HOST-COMPUTED projection sealed with a projector identity, source-head digests and\n * per-contribution authority receipts — none of it branchable on git, all of it deleted\n * (`.claude/rules/one-source-of-truth.md`, Rule 0).\n *\n * The candidate playbook was left gating on that projection, which is why it — and with it the whole\n * `refinement` phase — had been permanently ineligible since it was authored: `artifact_valid` reads\n * LANDED families, and a host-computed projection never lands.\n *\n * This is the replacement, and it is deliberately ordinary: the facts become a FILE the application\n * commits, like every other family. What used to be enforced by a seal is now enforced by a pure\n * cross-reference check at the drafting boundary — a clause citing a fact this file does not declare\n * is refused before it can be written.\n */\nexport const playbookDefinition = {\n ref: 'refinement.document-facts',\n version: '0.1.0',\n phase: MetaWorkflow_Phase.REFINEMENT,\n intent:\n \"Derive the application's governed-document FACTS from truth it has already accepted — its vision (including the compliance regimes the posture pass recorded), its domain and its requirements — and land them as the `document-facts` family. A fact is a plain statement about how this application actually behaves: what data it holds, how long it keeps it, who it discloses to, what rights it honours. This produces the raw material a privacy notice or service terms is drafted FROM; it never drafts the document, never decides a legal question, and never states a fact the application's own code and accepted specifications do not support. Mechanism facts — retention treatment, data-subject kind, subject export — are read from the resource configurations, which declare what the application will actually do to a row; specifications supply purpose, not mechanism.\",\n functionalTopics: [],\n preconditions: [\n /*\n * There is deliberately NO `PHASE_IS` gate, and its absence is the fix for #116.\n *\n * This playbook gated on `PHASE_IS: REFINEMENT` from the day it was authored. `deriveJourneyPhase`\n * returns only TOP_DOWN or BOTTOM_UP, so that precondition could never be satisfied and the\n * unattended loop could never select this playbook — while nothing reported it, because an\n * ineligible playbook never reaches the eligibility board. Audit rule 27 now catches the shape at\n * PR time.\n *\n * Fixed the same way its sibling `refinement.compliance-document-candidate` was on 2026-08-28:\n * gate on the ARTIFACTS the pass actually needs, not on a phase. That is also the direction the\n * design takes generally — phases are first-run scaffolding, and an evolving application is not in\n * a phase, it is in a state, and the state is the tree. The two `ARTIFACT_VALID` gates below are\n * the real readiness requirement and are unchanged; nothing about when this pass is SAFE to run\n * depended on the phase.\n */\n /*\n * The vision is required rather than merely declared: `top_down.compliance-posture` records each\n * applicable regime as a `compliance`-kind constraint there, and those constraints are what tell\n * this pass WHICH facts a later document will need. A derivation with no regime in view produces a\n * plausible generic fact set — the exact failure `compliance-document-system.md` forbids (\"do not\n * generate legal text from a generic SaaS category when application facts are absent\").\n */\n { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'vision-brief' } },\n /*\n * The domain plan is where the application's resources and their data actually live. Retention,\n * data categories and disclosure facts are read from it; without it this pass would be inventing\n * what the product stores.\n */\n { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'domain-plan' } },\n ],\n inputs: [{ family: 'vision-brief' }, { family: 'domain-plan' }, { family: 'requirements' }],\n outputs: [{\n family: 'document-facts',\n schemaRef: 'saas-specifications:ApplicationDocumentFactSpecification',\n description:\n \"The application's declared governed-document facts, one declaration per fact, each either KNOWN with its value or NOT_APPLICABLE with a reason. Authority is APPLICATION_SPECIFICATION throughout: these are facts the application's own accepted specifications establish. A fact needing a named human decision is deliberately ABSENT rather than dressed in an authority nobody holds.\",\n }],\n method: {\n /*\n * The resource declarations reach the brief through this, and nothing else does.\n *\n * This playbook's intent and its method have said since the day they were authored that mechanism\n * facts \"are read from the resource configurations\". They were not: the `compliance-primary-facts`\n * behavior existed and answered correctly, and no playbook declared it, so the derivation the\n * method describes could not happen. Its first live run (wonder-crm, 2026-08-29) landed two facts,\n * both paraphrased from vision prose, neither citing a declaration — a schema-valid artifact that\n * was wrong about where it came from, which is the one failure mode a governed document cannot\n * survive.\n *\n * NOT `WORKSPACE_TRUTH`: that section carries module ids and schema FIELD NAMES for a build\n * planner. A field's name says nothing about whether erasing its subject scrubs it.\n *\n * The run immediately after wiring it landed a fact reading \"contact records are retained and\n * impersonalized on erasure; workspace, workspace-member, company, pipeline-stage, deal, next-step\n * and interaction are declared RETAIN_ONLY\" — per resource, from the declarations. The run before\n * it, on the same application and the same method prose, had produced two paraphrases of the\n * vision. Nothing about the guidance changed; the evidence arrived.\n */\n /*\n * DOCUMENT_FACT_OBLIGATIONS supplies the second half, and it is the one this playbook had never\n * been given: the NAMES.\n *\n * COMPLIANCE_PRIMARY_FACTS made the answers true — the run after wiring it landed a per-resource\n * erasure fact instead of two paraphrases of the vision. It did nothing about what those answers\n * are CALLED, and a fact's ref is stamped from the slug this playbook chooses. Measured 2026-08-30:\n * twenty facts declared, ZERO of the eight a privacy notice requires, because the names were\n * semantically adjacent and lexically disjoint. True answers, uncitable.\n *\n * The method below already asks for stable descriptive slugs and names three of the eight as\n * examples, and has since 2026-08-28. That is prose, and the churn was measured with it in place.\n * This supplies the closed set itself, which the engine catalog has held all along.\n */\n contextSources: [MetaWorkflow_ContextSource.COMPLIANCE_PRIMARY_FACTS, MetaWorkflow_ContextSource.DOCUMENT_FACT_OBLIGATIONS],\n skillRefs: ['journey-status'],\n },\n executor: MetaWorkflow_Executor.COMPANION_AGENT,\n approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT,\n budget: { maxRuns: 3 },\n onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG,\n /*\n * `guidance` is deliberately absent: the method prose is the single source of truth in `method.md`,\n * and the generator renders it (partials + references expanded) and injects it as `method.guidance`.\n * Declaring it here would be a second copy that drifts — the folder contract rejects an inline one.\n */\n} satisfies Omit<MetaWorkflowPlaybookAuthoring, 'method'> & { method: Omit<NonNullable<MetaWorkflowPlaybookAuthoring['method']>, 'guidance'> };\n"]}
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Canonical native declaration for this reusable application-creation method.
3
+ *
4
+ * The structured method remains intentionally rich: its intent, inputs, output
5
+ * contracts, elicitation, deterministic verification and skill routing are the
6
+ * application knowledge a later generic assessment loop composes. This source
7
+ * intentionally omits the superseded per-playbook evaluation-treatment object;
8
+ * generation records that absence rather than fabricating legacy judge behavior.
9
+ */
10
+ export declare const playbookDefinition: {
11
+ readonly ref: "top_down.brand-identity";
12
+ readonly version: "0.1.0";
13
+ readonly phase: "top_down";
14
+ readonly intent: "Brand-identity elicitation: draw the product's VISUAL identity out of the creator — the brand name, the logo creative direction (mark type, motifs, symbolism, imagery don'ts, background), and the visual tone (style keywords, mood, color story) — and capture it as a single validated BrandSnapshot (the `brand-brief` artifact family). The visual counterpart to the vision (intent) and market (verbal voice) briefs: it derives symbolism from the VisionSnapshot's idea/mission and, when a MarketSnapshot exists, translates its verbal `tonesOfVoice` into a visual register. The emitted brand-brief is the INPUT the companion logo step generates the master logo + derived assets from, and via `BrandSnapshot.resolvedAssets` the single source of truth every logo/favicon/brand-image consumer resolves against. Progressive: may persist a partially-directed brand (logoDirection/visualTone optional) and resume. v1 scaffold methodology — iterate the interview.";
15
+ readonly functionalTopics: readonly [];
16
+ readonly preconditions: readonly [{
17
+ readonly kind: "phase_is";
18
+ readonly phase: "top_down";
19
+ }, {
20
+ readonly kind: "artifact_exists";
21
+ readonly selector: {
22
+ readonly family: "vision-brief";
23
+ };
24
+ }];
25
+ readonly inputs: readonly [{
26
+ readonly family: "vision-brief";
27
+ }, {
28
+ readonly family: "market-snapshot";
29
+ readonly intent: "voice";
30
+ }];
31
+ readonly outputs: readonly [{
32
+ readonly family: "brand-brief";
33
+ readonly schemaRef: "saas-specifications:BrandSnapshot";
34
+ readonly description: "The visual-identity artifact — one BrandSnapshot per product (name + logo direction + visual tone; resolvedAssets left empty for the companion logo step to populate). Read by the companion logo generation step (which produces the master + derived assets) and, via resolvedAssets, by every downstream logo/favicon/brand-image consumer. Validated by validateBrandSnapshot.";
35
+ }];
36
+ readonly method: {
37
+ readonly skillRefs: readonly ["journey-status", "brand-logo-authoring"];
38
+ readonly elicitation: {
39
+ readonly questions: readonly [{
40
+ readonly ref: "brand-name";
41
+ readonly question: "What is the exact, case-sensitive brand name the logo should render (e.g. \"Northstar Tasks\")? This is the string every surface prints.";
42
+ readonly kind: "free_text";
43
+ }, {
44
+ readonly ref: "brand-tagline";
45
+ readonly question: "Is there a tagline / supporting line to lock up with the name (e.g. \"Ship the week, not the meeting.\")? Answer \"none\" if not.";
46
+ readonly kind: "free_text";
47
+ }, {
48
+ readonly ref: "logo-mark-type";
49
+ readonly question: "Which logo archetype fits the brand? A combination mark (symbol + wordmark) is the safe default — it yields both a header lockup and a square app icon.";
50
+ readonly kind: "choice";
51
+ readonly options: readonly ["combination_mark", "wordmark", "lettermark", "pictorial_mark", "abstract_mark", "emblem", "mascot"];
52
+ }, {
53
+ readonly ref: "logo-motifs";
54
+ readonly question: "What concrete visual elements should the mark include (short noun phrases, e.g. \"a rising checkmark\", \"concentric rings\")? Answer \"none\" to leave it open.";
55
+ readonly kind: "free_text";
56
+ }, {
57
+ readonly ref: "logo-symbolism";
58
+ readonly question: "What meaning should the mark evoke (e.g. \"momentum\", \"clarity\", \"trust\")? Derive this from the product's mission / idea rather than inventing it.";
59
+ readonly kind: "free_text";
60
+ }, {
61
+ readonly ref: "logo-avoid";
62
+ readonly question: "What imagery should the mark AVOID (e.g. \"no gradients\", \"no literal robots\", \"no clip-art gears\")? These are the negative-prompt guardrails that keep the output usable.";
63
+ readonly kind: "free_text";
64
+ }, {
65
+ readonly ref: "logo-background";
66
+ readonly question: "How should the master logo be composed? A transparent, isolated mark is the default — it rasterizes cleanly into favicons and monochrome / dark-light variants. Choose otherwise only if the brand truly needs it.";
67
+ readonly kind: "choice";
68
+ readonly options: readonly ["transparent_isolated", "solid_field", "contextual_scene"];
69
+ }, {
70
+ readonly ref: "visual-style-keywords";
71
+ readonly question: "In 3–7 concrete adjectives, what should the brand LOOK like (e.g. \"geometric\", \"minimal\", \"warm\", \"editorial\")?";
72
+ readonly kind: "free_text";
73
+ }, {
74
+ readonly ref: "visual-mood";
75
+ readonly question: "In one sentence, what feeling should the imagery leave (e.g. \"calm, precise, quietly confident\")?";
76
+ readonly kind: "free_text";
77
+ }, {
78
+ readonly ref: "visual-color-intent";
79
+ readonly question: "Describe the color story in prose (e.g. \"cool blues grounded by a warm accent\"). Prose, not hex — the concrete palette lives in the design system.";
80
+ readonly kind: "free_text";
81
+ }, {
82
+ readonly ref: "visual-color-seeds";
83
+ readonly question: "Has the brand already committed to specific hex colors that the mark must agree with? If so, list them; otherwise answer \"none\" and let the design system own the palette.";
84
+ readonly kind: "free_text";
85
+ }];
86
+ };
87
+ };
88
+ readonly executor: "companion_agent";
89
+ readonly approval: "approve_result";
90
+ readonly budget: {
91
+ readonly maxRuns: 3;
92
+ };
93
+ readonly onFailure: "keep_and_flag";
94
+ };
95
+ //# sourceMappingURL=playbook.definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/top_down.brand-identity/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FrB,CAAC"}