@wildo-ai/framework-knowledge 1.1.10 → 1.1.11

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 (1062) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  4. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  5. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  6. package/dist/esm/framework-knowledge.definitions.js +459 -76
  7. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  9. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  10. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  11. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  12. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  13. package/dist/esm/index.d.ts +2 -0
  14. package/dist/esm/index.d.ts.map +1 -1
  15. package/dist/esm/index.js +2 -0
  16. package/dist/esm/index.js.map +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  18. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  20. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -2
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +11 -6
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +3 -3
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +3 -2
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  45. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  49. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  53. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  56. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  62. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  66. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  69. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  70. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +6 -4
  74. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  83. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  97. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  99. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  101. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  118. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  120. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -3
  124. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  125. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  126. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  127. package/dist/esm/source-anchor-grammar.js +114 -0
  128. package/dist/esm/source-anchor-grammar.js.map +1 -0
  129. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  130. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  131. package/dist/knowledge/manifest.json +8 -8
  132. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  133. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  135. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  136. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +350 -23
  137. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
  138. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
  139. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  140. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  141. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  142. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  143. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +3 -3
  144. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
  145. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
  146. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
  147. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  149. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  150. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  151. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  152. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +33 -5
  153. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  155. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -3
  156. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  157. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  158. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +97 -23
  159. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  160. package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
  161. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  163. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  164. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  165. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  166. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  167. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  168. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
  169. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  170. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  171. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  172. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  173. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  174. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  175. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  176. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  177. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +3 -3
  178. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
  180. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  181. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  182. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  183. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  184. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +4 -0
  185. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -4
  186. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  187. package/dist/knowledge/references/application-maturity.config.md +1 -1
  188. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  189. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  190. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  191. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  192. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  193. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  194. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  195. package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
  196. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  197. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  198. package/dist/knowledge/references/capability-composition.config.md +4 -3
  199. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  200. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  201. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  202. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  203. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  204. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  205. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  206. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  207. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  208. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  209. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  210. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  211. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  213. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  214. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  215. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  216. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  217. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  218. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  219. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  220. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  221. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  222. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  223. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  224. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  225. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  226. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  227. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  228. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  229. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  230. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  231. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  232. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -22
  233. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  234. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  235. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  236. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  237. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  238. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  239. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  240. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  241. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  242. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  243. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  244. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  245. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  246. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  247. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  248. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  249. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  250. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  251. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  252. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  253. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  254. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  255. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  256. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  257. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  258. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  259. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  260. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  261. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  262. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  263. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  264. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  265. package/dist/knowledge/references/experience-plan.config.md +16 -0
  266. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  267. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  268. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  269. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  270. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  271. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  272. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  273. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  274. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  275. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  276. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  277. package/dist/knowledge/references/integration-plan.config.md +21 -1
  278. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  279. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  280. package/dist/knowledge/references/placement-plan.config.md +75 -13
  281. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  282. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  283. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  284. package/dist/knowledge/references/platform.config.saas.md +106 -14
  285. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  286. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  287. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  288. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  289. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  290. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  291. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  292. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  293. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  294. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  295. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  296. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  297. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  298. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  299. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  300. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  301. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  302. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  303. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  304. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  305. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  306. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  307. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  308. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  309. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  310. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  311. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  312. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  313. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  314. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  315. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  316. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  317. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  318. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  319. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  320. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  321. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  322. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  323. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  324. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  325. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  326. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  327. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  328. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  329. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  330. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  331. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  332. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  333. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  334. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  335. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  336. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  337. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  338. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  339. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  340. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  341. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  342. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  343. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  344. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  345. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  346. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  347. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  348. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  349. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +18 -16
  350. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  351. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  352. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  353. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  354. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  355. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  356. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  357. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +10 -2
  358. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  359. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  360. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  361. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  362. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  363. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  364. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  365. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  366. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
  367. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
  368. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  369. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
  370. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  371. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  372. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  373. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  374. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  375. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  376. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  377. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  378. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  379. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  380. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  381. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  382. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  383. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  384. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  385. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  386. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  387. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  388. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  389. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  390. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  391. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  392. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  393. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  396. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  397. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  398. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  400. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  406. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  407. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  408. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  409. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  410. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  411. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  412. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  413. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  414. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  415. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  416. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  417. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  418. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  419. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  420. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  421. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  422. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  423. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  424. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  425. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  426. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  427. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +58 -6
  428. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  429. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  430. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  431. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  434. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  435. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  436. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  437. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  438. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  440. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  441. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  442. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  443. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  444. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  445. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  446. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  447. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  448. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  451. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  452. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  453. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  454. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  455. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  456. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +58 -2
  457. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  459. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  460. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  461. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  463. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  465. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  466. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  467. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  468. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  469. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  470. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  471. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  472. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  473. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  474. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  475. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  476. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  477. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  478. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  479. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -6
  480. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  481. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  482. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  483. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  484. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  485. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  486. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  487. package/dist/knowledge/references/saas.public-runtime.contract.md +34 -2
  488. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  489. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  490. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  492. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  493. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  494. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  495. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  496. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  497. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  498. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  499. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  500. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  501. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  502. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  503. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  504. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  505. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  506. package/dist/knowledge/references/saas.website.astro.label-loader.md +38 -9
  507. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  508. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  509. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  510. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  511. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  512. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  513. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  514. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  515. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  516. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  517. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  518. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  519. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  520. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  521. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  522. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  523. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  524. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  525. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  526. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  527. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  528. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  529. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  530. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  531. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  532. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  533. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  534. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  535. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  536. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  537. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  538. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  539. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  540. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  541. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  542. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  543. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  544. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  545. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  546. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  547. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  548. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  549. package/dist/knowledge/references/saas.website.config.site-context-loader.md +21 -1
  550. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  551. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  552. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  553. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  554. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  555. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  556. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  557. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  558. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  559. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  560. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  561. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  562. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  563. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  564. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  565. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  566. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  567. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  568. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  569. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  570. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  571. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  572. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  573. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  574. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  575. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  576. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  577. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  578. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  579. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  580. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  581. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  582. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  583. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  584. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  585. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  586. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  587. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  588. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  589. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  590. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  591. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  592. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  593. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  594. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  595. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  596. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  597. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  598. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  599. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  600. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  601. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  602. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  603. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  604. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  605. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  606. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  607. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  608. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  609. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  610. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  611. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  612. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  613. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  614. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  615. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  616. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  617. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  618. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  619. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  620. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  621. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  622. package/dist/knowledge/references/service-method.config.md +270 -0
  623. package/dist/knowledge/references/website-plan.config.md +544 -32
  624. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  625. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  626. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  627. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  628. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +73 -9
  629. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  630. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  631. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +75 -6
  632. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  633. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  634. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  635. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  636. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  637. package/dist/knowledge/references/zod.decorators.schema-metadata.md +4 -0
  638. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
  639. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  640. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  641. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  642. package/dist/knowledge/references/zod.factories.code.md +18 -9
  643. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  644. package/dist/knowledge/references/zod.factories.money.md +24 -15
  645. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  646. package/dist/knowledge/references/zod.factories.range.md +5 -1
  647. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  648. package/dist/knowledge/registries/framework-topics.json +2411 -139
  649. package/dist/knowledge/registries/playbooks.json +51 -30
  650. package/dist/knowledge/registries/source-tags.json +8500 -4768
  651. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  652. package/dist/knowledge/skills/INDEX.md +60 -33
  653. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  654. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  655. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  656. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  657. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  658. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  659. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  660. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  661. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  662. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  663. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  664. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  665. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  666. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  667. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  668. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  669. package/dist/knowledge/skills/application-database-migrations/SKILL.md +27 -9
  670. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  671. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
  672. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
  673. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  674. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  675. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  676. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  677. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +35 -1
  678. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  679. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +3 -0
  680. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  681. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  682. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  683. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  684. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  685. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  686. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  687. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  688. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  689. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  690. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  691. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  692. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  693. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  694. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +134 -33
  695. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  696. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  697. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  698. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  699. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  700. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  701. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  702. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  703. package/dist/knowledge/skills/config-app-shell/SKILL.md +57 -28
  704. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  705. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  706. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  707. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  708. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +17 -6
  709. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  710. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  711. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  712. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  713. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  714. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  715. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  716. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  717. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  718. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  719. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  720. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  721. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  722. package/dist/knowledge/skills/config-saas/SKILL.md +2 -0
  723. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
  724. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  725. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  726. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  727. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  728. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  729. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  730. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  731. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  732. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  733. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  734. package/dist/knowledge/skills/config-saas-backend/SKILL.md +5 -3
  735. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  736. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  737. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  738. package/dist/knowledge/skills/configure-billing/SKILL.md +14 -0
  739. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  740. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  741. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  742. package/dist/knowledge/skills/email-add-template/SKILL.md +46 -5
  743. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
  744. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  745. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  746. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  747. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  748. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  749. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  750. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  751. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  752. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  753. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  754. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +281 -20
  755. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  756. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  757. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  758. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  759. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  760. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  761. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  762. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  763. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  764. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  765. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  766. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  767. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  768. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  769. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  770. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  771. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  772. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  773. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  774. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  775. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  776. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  777. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  778. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
  779. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -14
  780. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  781. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  782. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  783. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  784. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  785. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
  786. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  787. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  788. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  789. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  790. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  791. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  792. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  793. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  794. package/dist/knowledge/skills/infra-environment-config/SKILL.md +107 -2
  795. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  796. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  797. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  798. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  799. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  800. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  801. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  802. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  803. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  804. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  805. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  806. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  807. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  808. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  809. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  810. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
  811. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
  812. package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
  813. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -1
  814. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  815. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  816. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  817. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  818. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  819. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  820. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +150 -4
  821. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  822. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  823. package/dist/knowledge/skills/module-relationships/SKILL.md +50 -27
  824. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  825. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  826. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  827. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  828. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  829. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  830. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  831. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  832. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  833. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  834. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  835. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  836. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  837. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  838. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  839. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  840. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  841. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  842. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  843. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  844. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  845. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  846. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  847. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  848. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  849. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  850. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  851. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  852. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  853. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +26 -14
  854. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  855. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  856. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  857. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  858. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  859. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  860. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  861. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  862. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  863. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +132 -55
  864. package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
  865. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -2
  866. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  867. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  868. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +102 -4
  869. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  870. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  871. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +6 -0
  872. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  873. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +18 -0
  874. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  875. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +60 -3
  876. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  877. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  878. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +1 -1
  879. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  880. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +195 -23
  881. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  882. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  883. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +176 -10
  884. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  885. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
  886. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  887. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  888. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  889. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  890. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  891. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  892. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  893. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  894. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  895. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  896. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  897. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  898. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  899. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  900. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  901. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  902. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  903. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  904. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  905. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  906. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  907. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  908. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  909. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +3 -1
  910. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  911. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  912. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +26 -10
  913. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  914. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +9 -7
  915. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  916. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +79 -6
  917. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  918. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  919. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  920. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +32 -4
  921. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  922. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +116 -66
  923. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  924. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +203 -18
  925. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  926. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
  927. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
  928. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  929. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  930. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  931. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +168 -58
  932. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  933. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  934. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  935. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  936. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  937. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  938. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  939. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  940. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  941. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  942. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  943. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +141 -32
  944. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
  945. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  946. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  947. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  948. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  949. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  950. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  951. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  952. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  953. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  954. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
  955. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  956. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +11 -4
  957. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  958. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  959. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  960. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
  961. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -192
  962. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  963. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  964. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  965. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  966. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  967. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +39 -18
  968. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  969. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  970. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  971. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  972. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  973. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  974. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  975. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  976. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  977. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  978. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  979. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  980. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  981. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  982. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  983. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  984. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  985. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  986. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  987. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +24 -3
  988. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  989. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  990. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  991. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  992. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  993. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  994. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  995. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  996. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  997. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  998. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  999. package/dist/knowledge/skills/website-section-faq/SKILL.md +561 -302
  1000. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1001. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1002. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +647 -274
  1003. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1004. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +572 -264
  1005. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1006. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1007. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1008. package/dist/knowledge/skills/website-section-hero/SKILL.md +603 -332
  1009. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1010. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1011. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1012. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1013. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1014. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1015. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1016. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1017. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1018. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1019. package/dist/knowledge/skills/website-section-pricing/SKILL.md +549 -378
  1020. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1021. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1022. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1023. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1024. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1025. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1026. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1027. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1028. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1029. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1030. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1031. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1032. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1033. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1034. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +739 -315
  1035. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1036. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1037. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1038. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1039. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1040. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1041. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1042. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1043. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1044. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1045. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1046. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1047. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1048. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1049. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1050. package/dist/knowledge/topic-index.json +16442 -8572
  1051. package/package.json +4 -4
  1052. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1053. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1054. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1055. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1056. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1057. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1058. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1059. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1060. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1061. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1062. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.integration-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,+yBAA+yB;IACzzB,eAAe,EAAE;QACf;;;;WAIG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE;KACvE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,sJAAsJ,EAAE;QAC1L,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,+DAA+D,EAAE;QACrG,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,wFAAwF,EAAE;QAC3H,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,wJAAwJ,EAAE;QACxM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,oLAAoL,EAAE;KAC7N;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,kBAAkB;YAC5B,WAAW,EAAE,qCAAqC;YAClD,aAAa,EAAE,4cAA4c;SAC5d;KACF;IACD,QAAQ,EAAE;QACR;;;;;WAKG;QACH,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;QACrC;;;;;;WAMG;QACH,eAAe,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;QACzD,WAAW,EAAE;YACX,kBAAkB;YAClB,kBAAkB;YAClB,0BAA0B;YAC1B,+BAA+B;YAC/B,0BAA0B;YAC1B,wBAAwB;YACxB,mBAAmB;YACnB,kBAAkB;SACnB;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 * The background-execution and external-reach leaf (#1495). `add-minion`, `add-worker-node`,\n * `add-worker-rust`, `add-provider` and `add-file-picker-provider` all shipped as scenarios, and\n * the decomposer was told to plan \"workers / minions and other auxiliary execution surfaces\" and\n * \"providers, external connectors, billing wiring\" — with no product kind for any of them and,\n * measured 2026-09-22, ZERO worker and minion skills in the catalog. Nothing in the journey could\n * give an application a background worker, a cron minion or a provider binding.\n *\n * It produces the integration plan. Two consumers read it, and the split is the point:\n *\n * - `bottom_up.foundation` composes the PACKAGE — one `add-worker-node`, `add-worker-rust` or\n * `add-minion` per surface, fanned out exactly as modules and resources are fanned out of the\n * domain plan. That is why the capability composition reports those three scenarios as owned by\n * the foundation rather than as undecidable, which is what they read until this family existed.\n * - `bottom_up.build-decompose` emits the WORK — one task per worker, minion and provider binding,\n * each bound to its skill through the three total maps in `_core`, and one per inbound channel\n * producing its handler, which the dispatch routes to `inbound-channels` from the product (#1832).\n *\n * The build plan keeps ONE producer, which is what makes landing decidable (#895).\n */\nexport const playbookDefinition = {\n \"ref\": \"bottom_up.integration-plan\",\n \"version\": \"0.1.0\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Background execution and external reach — decide WHAT RUNS BESIDE THE BACKEND and WHAT THIS APPLICATION REACHES OUT TO: which workers exist and on which runtime, which cron minions wake on their own and exactly which resources each one may read and write, and which providers are bound into which runtime owner's scope. Reads the requirements and feature drafts (what somebody asked for, including the work that cannot happen inside a request), the domain plan (the resources a minion's containment whitelist names) and the roadmap (what is owed when). Every surface names what it is accountable to, because a process nobody asked for is a process nobody maintains. Produces the plan; the foundation composes each package and the decomposer emits the work, each task bound to the skill its runtime or scope names.\",\n \"preconditions\": [\n /*\n * The DOMAIN PLAN is what a minion's containment is OVER: `readsResourceRefs` and\n * `writesResourceRefs` name decided resources, and a whitelist naming resources nobody decided\n * contains nothing. Its CONTENT is read, so `artifact_exists` is the honest strength (#1434).\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"requirements\", \"//\": \"What somebody asked the application to do — including the work that cannot happen inside a request, which is the only honest reason a worker exists.\" },\n { \"family\": \"feature-drafts\", \"//\": \"The drafted features whose work a background surface carries.\" },\n { \"family\": \"domain-plan\", \"//\": \"The resources a minion's containment whitelist names, and the modules a worker serves.\" },\n { \"family\": \"roadmap\", \"render\": \"map\", \"//\": \"When each phase is owed, so a surface is planned against the phase that needs it. A MAP: the phases' own rationale is not this method's input (#1424).\" },\n { \"family\": \"integration-plan\", \"//\": \"Its own family: its method refines its own prior output and keeps its worker and minion refs, which build tasks name (#1430). Input, not precondition: a first run stays eligible.\" }\n ],\n \"outputs\": [\n {\n \"family\": \"integration-plan\",\n \"schemaRef\": \"saas-specifications:IntegrationPlan\",\n \"description\": \"What this application runs beside its backend and what it reaches out to: its workers (each with its runtime, what the backend delegates to it, the routes it registers and what it is accountable to), its cron minions (each with what happens because time passed, its named behaviours, and exactly which resources its tick reads and writes), and the providers it binds into each runtime owner's scope. Every collection may be empty, and saying so is an answer.\"\n }\n ],\n \"method\": {\n /*\n * WORKSPACE_TRUTH — this method plans against CODE as well as against decisions: which workers\n * and minions the application ALREADY carries (its `applicationWorkers` / `applicationMinions`\n * buckets), and which providers its scopes already name. A plan proposing a worker the tree\n * already has emits a task that composes a package twice.\n */\n \"contextSources\": [\"workspace_truth\"],\n /*\n * TWO bodies reach this step (#1435), and they are the two the plan's central decisions depend\n * on: whether a surface is a worker or a minion, and what a minion's containment must name.\n * Both are impossible to decide from recollection — the difference is a runtime contract, and\n * the containment chain has three parts of which two are outside the minion's own package.\n * Every other skill is a contract the CODING AGENT opens when it builds the task.\n */\n \"skillBodyRefs\": [\"worker-authoring\", \"minion-authoring\"],\n \"skillRefs\": [\n \"worker-authoring\",\n \"minion-authoring\",\n \"provider-backend-package\",\n \"provider-frontend-file-picker\",\n \"provider-operation-calls\",\n \"resource-external-data\",\n \"configure-billing\",\n \"inbound-channels\"\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"]}
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.integration-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,+yBAA+yB;IACzzB,eAAe,EAAE;QACf;;;;WAIG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE;KACvE;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,sJAAsJ,EAAE;QAC1L,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,+DAA+D,EAAE;QACrG,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,wFAAwF,EAAE;QAC3H,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,wJAAwJ,EAAE;QACxM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,oLAAoL,EAAE;KAC7N;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,kBAAkB;YAC5B,WAAW,EAAE,qCAAqC;YAClD,aAAa,EAAE,4cAA4c;SAC5d;KACF;IACD,QAAQ,EAAE;QACR;;;;;;;;;;WAUG;QACH,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;QAC1D;;;;;;WAMG;QACH,eAAe,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;QACzD,WAAW,EAAE;YACX,kBAAkB;YAClB,kBAAkB;YAClB,0BAA0B;YAC1B,+BAA+B;YAC/B,0BAA0B;YAC1B,wBAAwB;YACxB,mBAAmB;YACnB,kBAAkB;SACnB;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 * The background-execution and external-reach leaf (#1495). `add-minion`, `add-worker-node`,\n * `add-worker-rust`, `add-provider` and `add-file-picker-provider` all shipped as scenarios, and\n * the decomposer was told to plan \"workers / minions and other auxiliary execution surfaces\" and\n * \"providers, external connectors, billing wiring\" — with no product kind for any of them and,\n * measured 2026-09-22, ZERO worker and minion skills in the catalog. Nothing in the journey could\n * give an application a background worker, a cron minion or a provider binding.\n *\n * It produces the integration plan. Two consumers read it, and the split is the point:\n *\n * - `bottom_up.foundation` composes the PACKAGE — one `add-worker-node`, `add-worker-rust` or\n * `add-minion` per surface, fanned out exactly as modules and resources are fanned out of the\n * domain plan. That is why the capability composition reports those three scenarios as owned by\n * the foundation rather than as undecidable, which is what they read until this family existed.\n * - `bottom_up.build-decompose` emits the WORK — one task per worker, minion and provider binding,\n * each bound to its skill through the three total maps in `_core`, and one per inbound channel\n * producing its handler, which the dispatch routes to `inbound-channels` from the product (#1832).\n *\n * The build plan keeps ONE producer, which is what makes landing decidable (#895).\n */\nexport const playbookDefinition = {\n \"ref\": \"bottom_up.integration-plan\",\n \"version\": \"0.2.0\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Background execution and external reach — decide WHAT RUNS BESIDE THE BACKEND and WHAT THIS APPLICATION REACHES OUT TO: which workers exist and on which runtime, which cron minions wake on their own and exactly which resources each one may read and write, and which providers are bound into which runtime owner's scope. Reads the requirements and feature drafts (what somebody asked for, including the work that cannot happen inside a request), the domain plan (the resources a minion's containment whitelist names) and the roadmap (what is owed when). Every surface names what it is accountable to, because a process nobody asked for is a process nobody maintains. Produces the plan; the foundation composes each package and the decomposer emits the work, each task bound to the skill its runtime or scope names.\",\n \"preconditions\": [\n /*\n * The DOMAIN PLAN is what a minion's containment is OVER: `readsResourceRefs` and\n * `writesResourceRefs` name decided resources, and a whitelist naming resources nobody decided\n * contains nothing. Its CONTENT is read, so `artifact_exists` is the honest strength (#1434).\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"requirements\", \"//\": \"What somebody asked the application to do — including the work that cannot happen inside a request, which is the only honest reason a worker exists.\" },\n { \"family\": \"feature-drafts\", \"//\": \"The drafted features whose work a background surface carries.\" },\n { \"family\": \"domain-plan\", \"//\": \"The resources a minion's containment whitelist names, and the modules a worker serves.\" },\n { \"family\": \"roadmap\", \"render\": \"map\", \"//\": \"When each phase is owed, so a surface is planned against the phase that needs it. A MAP: the phases' own rationale is not this method's input (#1424).\" },\n { \"family\": \"integration-plan\", \"//\": \"Its own family: its method refines its own prior output and keeps its worker and minion refs, which build tasks name (#1430). Input, not precondition: a first run stays eligible.\" }\n ],\n \"outputs\": [\n {\n \"family\": \"integration-plan\",\n \"schemaRef\": \"saas-specifications:IntegrationPlan\",\n \"description\": \"What this application runs beside its backend and what it reaches out to: its workers (each with its runtime, what the backend delegates to it, the routes it registers and what it is accountable to), its cron minions (each with what happens because time passed, its named behaviours, and exactly which resources its tick reads and writes), and the providers it binds into each runtime owner's scope. Every collection may be empty, and saying so is an answer.\"\n }\n ],\n \"method\": {\n /*\n * WORKSPACE_TRUTH — this method plans against CODE as well as against decisions: which workers\n * and minions the application ALREADY carries (its `applicationWorkers` / `applicationMinions`\n * buckets), and which providers its scopes already name. A plan proposing a worker the tree\n * already has emits a task that composes a package twice.\n *\n * PROVIDER_REGISTRY (#2025) — the provider modules the registry OFFERS. Since the catalogue was\n * archived (#2019) a vendor reaches an application only by being installed from the registry, so\n * the workspace alone shows what is installed and nothing that could be added: an OCR or Teams need\n * was planned against nothing, or against a vendor recalled from training that no module provides.\n */\n \"contextSources\": [\"workspace_truth\", \"provider_registry\"],\n /*\n * TWO bodies reach this step (#1435), and they are the two the plan's central decisions depend\n * on: whether a surface is a worker or a minion, and what a minion's containment must name.\n * Both are impossible to decide from recollection — the difference is a runtime contract, and\n * the containment chain has three parts of which two are outside the minion's own package.\n * Every other skill is a contract the CODING AGENT opens when it builds the task.\n */\n \"skillBodyRefs\": [\"worker-authoring\", \"minion-authoring\"],\n \"skillRefs\": [\n \"worker-authoring\",\n \"minion-authoring\",\n \"provider-backend-package\",\n \"provider-frontend-file-picker\",\n \"provider-operation-calls\",\n \"resource-external-data\",\n \"configure-billing\",\n \"inbound-channels\"\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"]}
@@ -7,9 +7,9 @@
7
7
  */
8
8
  export declare const playbookDefinition: {
9
9
  readonly ref: "bottom_up.placement-plan";
10
- readonly version: "0.1.4";
10
+ readonly version: "0.1.5";
11
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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`visibleToRoles`), when one audience only opens it. 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.";
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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`requiredRoles`), when one audience only opens it. 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
13
  readonly preconditions: readonly [{
14
14
  readonly kind: "artifact_exists";
15
15
  readonly selector: {
@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CrB,CAAC"}
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CrB,CAAC"}
@@ -7,9 +7,9 @@
7
7
  */
8
8
  export const playbookDefinition = {
9
9
  "ref": "bottom_up.placement-plan",
10
- "version": "0.1.4",
10
+ "version": "0.1.5",
11
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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`visibleToRoles`), when one audience only opens it. 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.",
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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`requiredRoles`), when one audience only opens it. 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
13
  "preconditions": [
14
14
  { "kind": "artifact_exists", "selector": { "family": "domain-plan" } }
15
15
  ],
@@ -1 +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,u3DAAu3D;IACj4D,eAAe,EAAE;QACf,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;QAC5B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,iOAAiO,EAAE;QACrT,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,oEAAoE,EAAE;KACzG;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,mCAAmC;YAChD,aAAa,EAAE,g9DAAg9D;SACh+D;KACF;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,qVAAqV;QACzW,sBAAsB,EAAE,oIAAoI;QAC5J,uBAAuB,EAAE,uPAAuP;QAChR,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,6BAA6B,CAAC;QAC5F,WAAW,EAAE;YACX,8BAA8B;YAC9B,kBAAkB;YAClB,mBAAmB;SACpB;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.4\",\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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`visibleToRoles`), when one audience only opens it. 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 \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"domain-plan\" },\n { \"family\": \"requirements\" },\n { \"family\": \"market-snapshot\", \"aspects\": [\"market.icp\", \"market.persona\"], \"//\": \"The customer profile the fit test reads (#2502): company size, the tools they run, their technical staff. Without it one run declined single sign-on for a five-person trade firm and another, from the same inputs, placed it.\" },\n { \"family\": \"vision-brief\", \"//\": \"What the product is and who it serves, which a placement must fit.\" }\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 per SUBJECT KIND and only for the kinds a caller supplies a catalog for, and the semantic authority currently supplies ENGINE_SETTINGS_DESTINATION_REFS for ENGINE_SETTINGS_DESTINATION. Unknown settings references are errors and missing settings decisions are warnings. This does not establish coverage for resource operations or application views: those kinds need their own supplied catalogues. A caller supplying no catalogue receives no coverage result, not a clean coverage result. 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 \"//contextSources2502\": \"CREATOR_STATED_FACTS — the user groups and the devices they use, which order the sidebar for the group that opens it most (#2502).\",\n \"//contextSources2502b\": \"APPLICATION_ENABLED_SURFACE — what the configuration switches on (capabilities, billing, sign-in methods), the capability leg of the fit test, dated by the configuration so a placement is offered again when SSO or billing is switched on (#2502).\",\n \"contextSources\": [\"workspace_truth\", \"creator_stated_facts\", \"application_enabled_surface\"],\n \"skillRefs\": [\n \"settings-placement-authoring\",\n \"config-app-shell\",\n \"config-navigation\",\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"]}
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,s3DAAs3D;IACh4D,eAAe,EAAE;QACf,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;QAC5B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,iOAAiO,EAAE;QACrT,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,oEAAoE,EAAE;KACzG;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,mCAAmC;YAChD,aAAa,EAAE,g9DAAg9D;SACh+D;KACF;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,qVAAqV;QACzW,sBAAsB,EAAE,oIAAoI;QAC5J,uBAAuB,EAAE,uPAAuP;QAChR,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,6BAA6B,CAAC;QAC5F,WAAW,EAAE;YACX,8BAA8B;YAC9B,kBAAkB;YAClB,mBAAmB;SACpB;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.5\",\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), the requirements (which tasks matter), the customer profile (who the customers are, which decides whether an enterprise destination belongs at all) and what the creator stated about the user groups, 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 for the settings rail and the `config-app-shell` skill for the sidebar, command palette and user menu. A sidebar group or a sidebar or palette decision may name the roles it is shown to (`requiredRoles`), when one audience only opens it. 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 \"preconditions\": [\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"domain-plan\" } }\n ],\n \"inputs\": [\n { \"family\": \"domain-plan\" },\n { \"family\": \"requirements\" },\n { \"family\": \"market-snapshot\", \"aspects\": [\"market.icp\", \"market.persona\"], \"//\": \"The customer profile the fit test reads (#2502): company size, the tools they run, their technical staff. Without it one run declined single sign-on for a five-person trade firm and another, from the same inputs, placed it.\" },\n { \"family\": \"vision-brief\", \"//\": \"What the product is and who it serves, which a placement must fit.\" }\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 per SUBJECT KIND and only for the kinds a caller supplies a catalog for, and the semantic authority currently supplies ENGINE_SETTINGS_DESTINATION_REFS for ENGINE_SETTINGS_DESTINATION. Unknown settings references are errors and missing settings decisions are warnings. This does not establish coverage for resource operations or application views: those kinds need their own supplied catalogues. A caller supplying no catalogue receives no coverage result, not a clean coverage result. 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 \"//contextSources2502\": \"CREATOR_STATED_FACTS — the user groups and the devices they use, which order the sidebar for the group that opens it most (#2502).\",\n \"//contextSources2502b\": \"APPLICATION_ENABLED_SURFACE — what the configuration switches on (capabilities, billing, sign-in methods), the capability leg of the fit test, dated by the configuration so a placement is offered again when SSO or billing is switched on (#2502).\",\n \"contextSources\": [\"workspace_truth\", \"creator_stated_facts\", \"application_enabled_surface\"],\n \"skillRefs\": [\n \"settings-placement-authoring\",\n \"config-app-shell\",\n \"config-navigation\",\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"]}
@@ -10,16 +10,22 @@
10
10
  * task and each section into a `WEBSITE_SECTION` task bound to the skill that section's KIND names,
11
11
  * because the build plan has ONE producer and a second would destroy the first's output (#895).
12
12
  *
13
- * The 23 `website-*` skills the framework ships were named by NO playbook until this one — the
13
+ * The `website-*` skills the framework ships were named by NO playbook until this one — the
14
14
  * largest finished asset in the catalog with no door. The site-level ones are this method's
15
- * `skillRefs`; the nine section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is
16
- * total over the section vocabulary, so a kind added without its skill does not compile.
15
+ * `skillRefs`; the section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is total
16
+ * over the section vocabulary, so a kind added without its skill does not compile.
17
+ *
18
+ * The plan is held to a truth bar (the method's Step 4): every capability, figure and name on the
19
+ * site is something the application declares. The marketing material cannot settle that on its own,
20
+ * so the plan also reads what the application declares about itself: its roadmap and requirements
21
+ * (what is built, what is next), its document facts (retention, recipients and their regions, the
22
+ * rights it honours) and its integration plan.
17
23
  */
18
24
  export declare const playbookDefinition: {
19
25
  readonly ref: "bottom_up.website-plan";
20
- readonly version: "0.2.1";
26
+ readonly version: "0.5.1";
21
27
  readonly phase: "bottom_up";
22
- readonly intent: "Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has, what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.";
28
+ readonly intent: "Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has and the KIND of each (home, product overview, product area, solution by role / industry / use case / company size, pricing, contact, company, security, blog — the kind derives its route, its menu placement and its essential sections), what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact, the problem, how it works, the product shown, paths by audience, comparison, facts in figures, integrations, latest posts, roadmap) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Every capability, figure and name the plan asks a section to state must be one the application declares (its roadmap, requirements, document facts and integration plan), never a claim the marketing material makes alone. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.";
23
29
  readonly preconditions: readonly [{
24
30
  readonly kind: "artifact_exists";
25
31
  readonly selector: {
@@ -54,9 +60,22 @@ export declare const playbookDefinition: {
54
60
  }, {
55
61
  readonly family: "vision-brief";
56
62
  readonly "//": "The product's own one-liner and differentiation, which a hero states before any market entry qualifies it.";
63
+ }, {
64
+ readonly family: "roadmap";
65
+ readonly "//": "What is built now and what comes next or later, in the roadmap's own horizons: a ROADMAP section states them, and a capability not built yet is planned there, never as shipped. Absent is skipped.";
57
66
  }, {
58
67
  readonly family: "requirements";
59
- readonly "//": "What the product is committed to DO (#2507). A feature section cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it.";
68
+ readonly "//": "What the product is committed to DO (#2507), so a section states a capability the requirements back rather than one the market snapshot wishes for. A section that says what the product does cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it. Absent is skipped.";
69
+ }, {
70
+ readonly family: "document-facts";
71
+ readonly "//": "How the application actually behaves with data — what it keeps and for how long, who receives it and where, which rights it honours — derived from its own declarations. The source of a security page's figures. Absent is skipped.";
72
+ }, {
73
+ readonly family: "domain-plan";
74
+ readonly aspects: readonly ["domain-plan.resource", "domain-plan.lifecycle"];
75
+ readonly "//": "The application's resources and their lifecycles, so a section's demo names a resource the application has (`demo.resourceRef`) and a status demo shows states its lifecycle declares. Absent is skipped.";
76
+ }, {
77
+ readonly family: "integration-plan";
78
+ readonly "//": "The providers, channels and protocols the application declares, so an INTEGRATIONS section names only those. Absent is skipped.";
60
79
  }, {
61
80
  readonly family: "website-plan";
62
81
  readonly "//": "Its own family: its method refines its own prior output and keeps its page refs, so it must be GIVEN that output (#1430). Input, not precondition: a first run stays eligible.";
@@ -69,7 +88,7 @@ export declare const playbookDefinition: {
69
88
  readonly method: {
70
89
  readonly contextSources: readonly ["market_fit_scores"];
71
90
  readonly skillBodyRefs: readonly ["website-page-authoring"];
72
- readonly skillRefs: readonly ["website-page-authoring", "website-navigation-authoring", "website-seo-aeo-geo", "website-label-pack", "website-marketing-metadata-extension", "market-positioning-authoring", "market-tone-of-voice", "market-proof-and-objection"];
91
+ readonly skillRefs: readonly ["website-page-authoring", "website-navigation-authoring", "website-motion-design", "website-seo-aeo-geo", "website-label-pack", "website-marketing-metadata-extension", "market-positioning-authoring", "market-tone-of-voice", "market-proof-and-objection"];
73
92
  };
74
93
  readonly executor: "companion_agent";
75
94
  readonly approval: "approve_result";
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.website-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ErB,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.website-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFrB,CAAC"}
@@ -10,16 +10,22 @@
10
10
  * task and each section into a `WEBSITE_SECTION` task bound to the skill that section's KIND names,
11
11
  * because the build plan has ONE producer and a second would destroy the first's output (#895).
12
12
  *
13
- * The 23 `website-*` skills the framework ships were named by NO playbook until this one — the
13
+ * The `website-*` skills the framework ships were named by NO playbook until this one — the
14
14
  * largest finished asset in the catalog with no door. The site-level ones are this method's
15
- * `skillRefs`; the nine section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is
16
- * total over the section vocabulary, so a kind added without its skill does not compile.
15
+ * `skillRefs`; the section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is total
16
+ * over the section vocabulary, so a kind added without its skill does not compile.
17
+ *
18
+ * The plan is held to a truth bar (the method's Step 4): every capability, figure and name on the
19
+ * site is something the application declares. The marketing material cannot settle that on its own,
20
+ * so the plan also reads what the application declares about itself: its roadmap and requirements
21
+ * (what is built, what is next), its document facts (retention, recipients and their regions, the
22
+ * rights it honours) and its integration plan.
17
23
  */
18
24
  export const playbookDefinition = {
19
25
  "ref": "bottom_up.website-plan",
20
- "version": "0.2.1",
26
+ "version": "0.5.1",
21
27
  "phase": "bottom_up",
22
- "intent": "Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has, what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.",
28
+ "intent": "Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has and the KIND of each (home, product overview, product area, solution by role / industry / use case / company size, pricing, contact, company, security, blog — the kind derives its route, its menu placement and its essential sections), what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact, the problem, how it works, the product shown, paths by audience, comparison, facts in figures, integrations, latest posts, roadmap) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Every capability, figure and name the plan asks a section to state must be one the application declares (its roadmap, requirements, document facts and integration plan), never a claim the marketing material makes alone. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.",
23
29
  "preconditions": [
24
30
  /*
25
31
  * The COMPOSITION is the readiness gate, and its CONTENT is what this method reads first: it
@@ -47,7 +53,11 @@ export const playbookDefinition = {
47
53
  { "family": "brand-brief", "render": "map", "//": "Whether the product has a name and a visual tone to present. The plan needs to know it EXISTS and who it addresses; the site's own chrome is authored by the build tasks (#1424's reading)." },
48
54
  { "family": "business-model", "//": "The pricing plans a PRICING section presents — a pricing page with no plan behind it is a page about nothing." },
49
55
  { "family": "vision-brief", "//": "The product's own one-liner and differentiation, which a hero states before any market entry qualifies it." },
50
- { "family": "requirements", "//": "What the product is committed to DO (#2507). A feature section cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it." },
56
+ { "family": "roadmap", "//": "What is built now and what comes next or later, in the roadmap's own horizons: a ROADMAP section states them, and a capability not built yet is planned there, never as shipped. Absent is skipped." },
57
+ { "family": "requirements", "//": "What the product is committed to DO (#2507), so a section states a capability the requirements back rather than one the market snapshot wishes for. A section that says what the product does cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it. Absent is skipped." },
58
+ { "family": "document-facts", "//": "How the application actually behaves with data — what it keeps and for how long, who receives it and where, which rights it honours — derived from its own declarations. The source of a security page's figures. Absent is skipped." },
59
+ { "family": "domain-plan", "aspects": ["domain-plan.resource", "domain-plan.lifecycle"], "//": "The application's resources and their lifecycles, so a section's demo names a resource the application has (`demo.resourceRef`) and a status demo shows states its lifecycle declares. Absent is skipped." },
60
+ { "family": "integration-plan", "//": "The providers, channels and protocols the application declares, so an INTEGRATIONS section names only those. Absent is skipped." },
51
61
  { "family": "website-plan", "//": "Its own family: its method refines its own prior output and keeps its page refs, so it must be GIVEN that output (#1430). Input, not precondition: a first run stays eligible." }
52
62
  ],
53
63
  "outputs": [
@@ -65,6 +75,12 @@ export const playbookDefinition = {
65
75
  * benefit's authored Kano category, so the plan orders sections on a measurement rather than on
66
76
  * the model's impression of one (#1435).
67
77
  */
78
+ /*
79
+ * Deliberately NOT `compliance_primary_facts`: that source refuses to compose when the backend cannot be
80
+ * introspected (it fails rather than let a governed document degrade to prose), and the website plan may run
81
+ * before a backend exists. A site plan must never be blocked on it. The `document-facts` input carries the same
82
+ * derived facts and is simply skipped when absent.
83
+ */
68
84
  "contextSources": ["market_fit_scores"],
69
85
  /*
70
86
  * ONE body reaches this step (#1435): `website-page-authoring` says what a page IS in this engine
@@ -76,6 +92,7 @@ export const playbookDefinition = {
76
92
  "skillRefs": [
77
93
  "website-page-authoring",
78
94
  "website-navigation-authoring",
95
+ "website-motion-design",
79
96
  "website-seo-aeo-geo",
80
97
  "website-label-pack",
81
98
  "website-marketing-metadata-extension",
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../src/playbooks/bottom_up.website-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,wBAAwB;IAC/B,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,s/BAAs/B;IAChgC,eAAe,EAAE;QACf;;;;;WAKG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,EAAE;QACjF;;;;WAIG;QACH,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACjI;;;;WAIG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE;KAC3E;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,wBAAwB,EAAE,IAAI,EAAE,8EAA8E,EAAE;QAC5H,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,+GAA+G,EAAE;QACtJ,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,6LAA6L,EAAE;QACjP,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,+GAA+G,EAAE;QACrJ,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,4GAA4G,EAAE;QAChJ,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,8LAA8L,EAAE;QAClO,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gLAAgL,EAAE;KACrN;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,cAAc;YACxB,WAAW,EAAE,iCAAiC;YAC9C,aAAa,EAAE,sbAAsb;SACtc;KACF;IACD,QAAQ,EAAE;QACR;;;;;;WAMG;QACH,gBAAgB,EAAE,CAAC,mBAAmB,CAAC;QACvC;;;;;WAKG;QACH,eAAe,EAAE,CAAC,wBAAwB,CAAC;QAC3C,WAAW,EAAE;YACX,wBAAwB;YACxB,8BAA8B;YAC9B,qBAAqB;YACrB,oBAAoB;YACpB,sCAAsC;YACtC,8BAA8B;YAC9B,sBAAsB;YACtB,4BAA4B;SAC7B;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 * The website lane's one leaf (#1492). It reads the market snapshot the top-down lane produced —\n * positioning, ICPs, tones of voice, proofs, objections, benefits — the brand brief and the\n * business model's pricing plans, and decides WHAT THE MARKETING SITE SAYS: its pages, their\n * sections in reading order, and the market entries each section draws on.\n *\n * It does NOT write the site. `bottom_up.build-decompose` turns each page into a `WEBSITE_PAGE`\n * task and each section into a `WEBSITE_SECTION` task bound to the skill that section's KIND names,\n * because the build plan has ONE producer and a second would destroy the first's output (#895).\n *\n * The 23 `website-*` skills the framework ships were named by NO playbook until this one — the\n * largest finished asset in the catalog with no door. The site-level ones are this method's\n * `skillRefs`; the nine section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is\n * total over the section vocabulary, so a kind added without its skill does not compile.\n */\nexport const playbookDefinition = {\n \"ref\": \"bottom_up.website-plan\",\n \"version\": \"0.2.1\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has, what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.\",\n \"preconditions\": [\n /*\n * The COMPOSITION is the readiness gate, and its CONTENT is what this method reads first: it\n * decides whether the application has a website at all, and this plan's disposition follows it.\n * `artifact_exists` rather than `artifact_expected` for exactly that reason — the content is\n * read, so the strength is honest (the audit's own distinction, #1434).\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"capability-composition\" } },\n /*\n * And what it DECIDED (#1606): the plan is only worth producing when the composition says the\n * application has a website. Before this gate the playbook ran anyway, only to land NOT_APPLICABLE.\n * A plan landed while the website was needed is set aside for every reader if it is later declined.\n */\n { \"kind\": \"artifact_decides\", \"selector\": { \"family\": \"capability-composition\" }, \"decision\": \"add-website\", \"equals\": \"NEEDED\" },\n /*\n * The market snapshot is the SUBSTANCE. A site planned without it would be a model inventing\n * claims about a product nobody positioned, which is the one thing every method in this lane\n * refuses.\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"market-snapshot\" } }\n ],\n \"inputs\": [\n { \"family\": \"capability-composition\", \"//\": \"Whether this application has a website, and the declaration that decided it.\" },\n { \"family\": \"market-snapshot\", \"//\": \"The substance of every section: benefits, proofs, objections, jobs, pains, ICPs, tones of voice, positioning.\" },\n { \"family\": \"brand-brief\", \"render\": \"map\", \"//\": \"Whether the product has a name and a visual tone to present. The plan needs to know it EXISTS and who it addresses; the site's own chrome is authored by the build tasks (#1424's reading).\" },\n { \"family\": \"business-model\", \"//\": \"The pricing plans a PRICING section presents — a pricing page with no plan behind it is a page about nothing.\" },\n { \"family\": \"vision-brief\", \"//\": \"The product's own one-liner and differentiation, which a hero states before any market entry qualifies it.\" },\n { \"family\": \"requirements\", \"//\": \"What the product is committed to DO (#2507). A feature section cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it.\" },\n { \"family\": \"website-plan\", \"//\": \"Its own family: its method refines its own prior output and keeps its page refs, so it must be GIVEN that output (#1430). Input, not precondition: a first run stays eligible.\" }\n ],\n \"outputs\": [\n {\n \"family\": \"website-plan\",\n \"schemaRef\": \"saas-specifications:WebsitePlan\",\n \"description\": \"What the marketing site says: a disposition (PLANNED, or NOT_APPLICABLE when the capability composition declined a website) with its rationale, and — when planned — the pages in navigation order, each with its purpose, the ICPs it is written for, its tone of voice, and its sections in reading order. Each section carries its KIND (which names the skill that authors it), what it does for the reader, and the market entries it draws on.\"\n }\n ],\n \"method\": {\n /*\n * MARKET_FIT_SCORES — the same computation `top_down.value-proposition` consumes, and for the\n * same reason: which benefits a page should lead with is a question about fit per ICP, and a\n * structured generation has no tools to compute it. The source renders the matrix beside each\n * benefit's authored Kano category, so the plan orders sections on a measurement rather than on\n * the model's impression of one (#1435).\n */\n \"contextSources\": [\"market_fit_scores\"],\n /*\n * ONE body reaches this step (#1435): `website-page-authoring` says what a page IS in this engine\n * — a manifest, a route adapter, a sections file and a label pack the build fails closed on — and\n * a plan that contradicts it plans pages nothing can author. Every other skill below is a contract\n * the CODING AGENT opens when it builds the task, so its body would be brief weight here.\n */\n \"skillBodyRefs\": [\"website-page-authoring\"],\n \"skillRefs\": [\n \"website-page-authoring\",\n \"website-navigation-authoring\",\n \"website-seo-aeo-geo\",\n \"website-label-pack\",\n \"website-marketing-metadata-extension\",\n \"market-positioning-authoring\",\n \"market-tone-of-voice\",\n \"market-proof-and-objection\"\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"]}
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/bottom_up.website-plan/playbook.definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,wBAAwB;IAC/B,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,gkDAAgkD;IAC1kD,eAAe,EAAE;QACf;;;;;WAKG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,EAAE;QACjF;;;;WAIG;QACH,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACjI;;;;WAIG;QACH,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE;KAC3E;IACD,QAAQ,EAAE;QACR,EAAE,QAAQ,EAAE,wBAAwB,EAAE,IAAI,EAAE,8EAA8E,EAAE;QAC5H,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,+GAA+G,EAAE;QACtJ,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,6LAA6L,EAAE;QACjP,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,+GAA+G,EAAE;QACrJ,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,4GAA4G,EAAE;QAChJ,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,qMAAqM,EAAE;QACpO,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gVAAgV,EAAE;QACpX,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,sOAAsO,EAAE;QAC5Q,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,EAAE,IAAI,EAAE,2MAA2M,EAAE;QAC5S,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,iIAAiI,EAAE;QACzK,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gLAAgL,EAAE;KACrN;IACD,SAAS,EAAE;QACT;YACE,QAAQ,EAAE,cAAc;YACxB,WAAW,EAAE,iCAAiC;YAC9C,aAAa,EAAE,sbAAsb;SACtc;KACF;IACD,QAAQ,EAAE;QACR;;;;;;WAMG;QACH;;;;;WAKG;QACH,gBAAgB,EAAE,CAAC,mBAAmB,CAAC;QACvC;;;;;WAKG;QACH,eAAe,EAAE,CAAC,wBAAwB,CAAC;QAC3C,WAAW,EAAE;YACX,wBAAwB;YACxB,8BAA8B;YAC9B,uBAAuB;YACvB,qBAAqB;YACrB,oBAAoB;YACpB,sCAAsC;YACtC,8BAA8B;YAC9B,sBAAsB;YACtB,4BAA4B;SAC7B;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 * The website lane's one leaf (#1492). It reads the market snapshot the top-down lane produced —\n * positioning, ICPs, tones of voice, proofs, objections, benefits — the brand brief and the\n * business model's pricing plans, and decides WHAT THE MARKETING SITE SAYS: its pages, their\n * sections in reading order, and the market entries each section draws on.\n *\n * It does NOT write the site. `bottom_up.build-decompose` turns each page into a `WEBSITE_PAGE`\n * task and each section into a `WEBSITE_SECTION` task bound to the skill that section's KIND names,\n * because the build plan has ONE producer and a second would destroy the first's output (#895).\n *\n * The `website-*` skills the framework ships were named by NO playbook until this one — the\n * largest finished asset in the catalog with no door. The site-level ones are this method's\n * `skillRefs`; the section skills are reached through `WEBSITE_SECTION_SKILL_REF`, which is total\n * over the section vocabulary, so a kind added without its skill does not compile.\n *\n * The plan is held to a truth bar (the method's Step 4): every capability, figure and name on the\n * site is something the application declares. The marketing material cannot settle that on its own,\n * so the plan also reads what the application declares about itself: its roadmap and requirements\n * (what is built, what is next), its document facts (retention, recipients and their regions, the\n * rights it honours) and its integration plan.\n */\nexport const playbookDefinition = {\n \"ref\": \"bottom_up.website-plan\",\n \"version\": \"0.5.1\",\n \"phase\": \"bottom_up\",\n \"intent\": \"Website plan — decide WHAT THE MARKETING WEBSITE SAYS for this application: which pages it has and the KIND of each (home, product overview, product area, solution by role / industry / use case / company size, pricing, contact, company, security, blog — the kind derives its route, its menu placement and its essential sections), what each page is for and who it is written for, and the sections that carry each page's argument in reading order, each drawing on the market entries the top-down lane authored (benefits, proofs, objections, jobs, pains, ICPs, tones of voice). Runs only once the capability composition decides the website is NEEDED (a declined website is never planned, and a plan landed before a later decline is set aside). A section's KIND (hero, benefits summary, benefit in detail, pricing, proof, objections answered, call to action, closing call to action, contact, the problem, how it works, the product shown, paths by audience, comparison, facts in figures, integrations, latest posts, roadmap) names the shipped `website-section-*` skill that authors it, so the build lane can bind each emitted task to its skill without a model naming folders. Every capability, figure and name the plan asks a section to state must be one the application declares (its roadmap, requirements, document facts and integration plan), never a claim the marketing material makes alone. Produces the plan; `bottom_up.build-decompose` turns it into the page and section tasks a coding agent runs, and the `add-website` composition scenario is what creates the `website/` workspace they write in.\",\n \"preconditions\": [\n /*\n * The COMPOSITION is the readiness gate, and its CONTENT is what this method reads first: it\n * decides whether the application has a website at all, and this plan's disposition follows it.\n * `artifact_exists` rather than `artifact_expected` for exactly that reason — the content is\n * read, so the strength is honest (the audit's own distinction, #1434).\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"capability-composition\" } },\n /*\n * And what it DECIDED (#1606): the plan is only worth producing when the composition says the\n * application has a website. Before this gate the playbook ran anyway, only to land NOT_APPLICABLE.\n * A plan landed while the website was needed is set aside for every reader if it is later declined.\n */\n { \"kind\": \"artifact_decides\", \"selector\": { \"family\": \"capability-composition\" }, \"decision\": \"add-website\", \"equals\": \"NEEDED\" },\n /*\n * The market snapshot is the SUBSTANCE. A site planned without it would be a model inventing\n * claims about a product nobody positioned, which is the one thing every method in this lane\n * refuses.\n */\n { \"kind\": \"artifact_exists\", \"selector\": { \"family\": \"market-snapshot\" } }\n ],\n \"inputs\": [\n { \"family\": \"capability-composition\", \"//\": \"Whether this application has a website, and the declaration that decided it.\" },\n { \"family\": \"market-snapshot\", \"//\": \"The substance of every section: benefits, proofs, objections, jobs, pains, ICPs, tones of voice, positioning.\" },\n { \"family\": \"brand-brief\", \"render\": \"map\", \"//\": \"Whether the product has a name and a visual tone to present. The plan needs to know it EXISTS and who it addresses; the site's own chrome is authored by the build tasks (#1424's reading).\" },\n { \"family\": \"business-model\", \"//\": \"The pricing plans a PRICING section presents — a pricing page with no plan behind it is a page about nothing.\" },\n { \"family\": \"vision-brief\", \"//\": \"The product's own one-liner and differentiation, which a hero states before any market entry qualifies it.\" },\n { \"family\": \"roadmap\", \"//\": \"What is built now and what comes next or later, in the roadmap's own horizons: a ROADMAP section states them, and a capability not built yet is planned there, never as shipped. Absent is skipped.\" },\n { \"family\": \"requirements\", \"//\": \"What the product is committed to DO (#2507), so a section states a capability the requirements back rather than one the market snapshot wishes for. A section that says what the product does cites the requirement its claim rests on; a market benefit alone says what a buyer wants, never that the product delivers it. Absent is skipped.\" },\n { \"family\": \"document-facts\", \"//\": \"How the application actually behaves with data — what it keeps and for how long, who receives it and where, which rights it honours — derived from its own declarations. The source of a security page's figures. Absent is skipped.\" },\n { \"family\": \"domain-plan\", \"aspects\": [\"domain-plan.resource\", \"domain-plan.lifecycle\"], \"//\": \"The application's resources and their lifecycles, so a section's demo names a resource the application has (`demo.resourceRef`) and a status demo shows states its lifecycle declares. Absent is skipped.\" },\n { \"family\": \"integration-plan\", \"//\": \"The providers, channels and protocols the application declares, so an INTEGRATIONS section names only those. Absent is skipped.\" },\n { \"family\": \"website-plan\", \"//\": \"Its own family: its method refines its own prior output and keeps its page refs, so it must be GIVEN that output (#1430). Input, not precondition: a first run stays eligible.\" }\n ],\n \"outputs\": [\n {\n \"family\": \"website-plan\",\n \"schemaRef\": \"saas-specifications:WebsitePlan\",\n \"description\": \"What the marketing site says: a disposition (PLANNED, or NOT_APPLICABLE when the capability composition declined a website) with its rationale, and — when planned — the pages in navigation order, each with its purpose, the ICPs it is written for, its tone of voice, and its sections in reading order. Each section carries its KIND (which names the skill that authors it), what it does for the reader, and the market entries it draws on.\"\n }\n ],\n \"method\": {\n /*\n * MARKET_FIT_SCORES — the same computation `top_down.value-proposition` consumes, and for the\n * same reason: which benefits a page should lead with is a question about fit per ICP, and a\n * structured generation has no tools to compute it. The source renders the matrix beside each\n * benefit's authored Kano category, so the plan orders sections on a measurement rather than on\n * the model's impression of one (#1435).\n */\n /*\n * Deliberately NOT `compliance_primary_facts`: that source refuses to compose when the backend cannot be\n * introspected (it fails rather than let a governed document degrade to prose), and the website plan may run\n * before a backend exists. A site plan must never be blocked on it. The `document-facts` input carries the same\n * derived facts and is simply skipped when absent.\n */\n \"contextSources\": [\"market_fit_scores\"],\n /*\n * ONE body reaches this step (#1435): `website-page-authoring` says what a page IS in this engine\n * — a manifest, a route adapter, a sections file and a label pack the build fails closed on — and\n * a plan that contradicts it plans pages nothing can author. Every other skill below is a contract\n * the CODING AGENT opens when it builds the task, so its body would be brief weight here.\n */\n \"skillBodyRefs\": [\"website-page-authoring\"],\n \"skillRefs\": [\n \"website-page-authoring\",\n \"website-navigation-authoring\",\n \"website-motion-design\",\n \"website-seo-aeo-geo\",\n \"website-label-pack\",\n \"website-marketing-metadata-extension\",\n \"market-positioning-authoring\",\n \"market-tone-of-voice\",\n \"market-proof-and-objection\"\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"]}
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/cross_cutting.application-creation/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqH9B,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.application-creation/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqH9B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/cross_cutting.compliance/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE9B,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.compliance/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE9B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/cross_cutting.feature-development/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C+G,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.feature-development/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C+G,CAAC"}
@@ -20,8 +20,8 @@ import { MetaWorkflow_InputRender, MetaWorkflow_Phase } from '@wildo-ai/saas-spe
20
20
  * - the TARGETS: the playbooks that refine a family (a declared `companion_agent` that reads its own output,
21
21
  * runs on its own, in the main tree). Only these may be named, and only these run first;
22
22
  * - the REFRESHES: every other standalone family producer of the main tree (the placement plan, the
23
- * capability composition, the business model, the risk register, the compliance documents), so what the
24
- * change made stale can be re-derived; and the build lane, run whole.
23
+ * capability composition, the business model, the risk register, the compliance documents, the expert
24
+ * staffing), so what the change made stale can be re-derived; and the build lane, run whole.
25
25
  * Every child re-derives a WHOLE family, which an instance may never replace, so every child runs as the
26
26
  * application (`actsOnApplication`).
27
27
  *
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/cross_cutting.refinement/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF+G,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.refinement/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyF+G,CAAC"}
@@ -20,8 +20,8 @@ import { MetaWorkflow_InputRender, MetaWorkflow_Phase, } from '@wildo-ai/saas-sp
20
20
  * - the TARGETS: the playbooks that refine a family (a declared `companion_agent` that reads its own output,
21
21
  * runs on its own, in the main tree). Only these may be named, and only these run first;
22
22
  * - the REFRESHES: every other standalone family producer of the main tree (the placement plan, the
23
- * capability composition, the business model, the risk register, the compliance documents), so what the
24
- * change made stale can be re-derived; and the build lane, run whole.
23
+ * capability composition, the business model, the risk register, the compliance documents, the expert
24
+ * staffing), so what the change made stale can be re-derived; and the build lane, run whole.
25
25
  * Every child re-derives a WHOLE family, which an instance may never replace, so every child runs as the
26
26
  * application (`actsOnApplication`).
27
27
  *
@@ -31,7 +31,7 @@ import { MetaWorkflow_InputRender, MetaWorkflow_Phase, } from '@wildo-ai/saas-sp
31
31
  */
32
32
  export const playbookDefinition = {
33
33
  ref: 'cross_cutting.refinement',
34
- version: '0.1.0',
34
+ version: '0.1.2',
35
35
  phase: MetaWorkflow_Phase.CROSS_CUTTING,
36
36
  intent: 'Refine what this line was opened for: re-derive each named family from what it already holds, guided by the purpose, then refresh what that made out of date and build it. An umbrella: it authors nothing itself. The first move is fixed: the producers of the named families. After that, select only children whose outputs are STALE, upstream before downstream, the build last. STOP when nothing is stale any more and the build has run, or when nothing eligible advances the refinement.',
37
37
  preconditions: [
@@ -67,6 +67,9 @@ export const playbookDefinition = {
67
67
  'refinement.document-facts',
68
68
  'top_down.compliance-conception',
69
69
  'top_down.risk-register',
70
+ // The firm's method refines its own prior output (#2305), so a refinement line may re-derive it.
71
+ 'top_down.service-method',
72
+ 'top_down.expert-personas',
70
73
  'top_down.business-model',
71
74
  'top_down.brand-identity',
72
75
  'top_down.scope-roadmap',
@@ -91,6 +94,9 @@ export const playbookDefinition = {
91
94
  'refinement.document-facts',
92
95
  'top_down.compliance-conception',
93
96
  'top_down.risk-register',
97
+ // The firm's method refines its own prior output (#2305), so a refinement line may re-derive it.
98
+ 'top_down.service-method',
99
+ 'top_down.expert-personas',
94
100
  'top_down.business-model',
95
101
  'top_down.brand-identity',
96
102
  'top_down.scope-roadmap',
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.refinement/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,0BAA0B;IAC/B,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,kBAAkB,CAAC,aAAa;IACvC,MAAM,EACJ,qeAAqe;IACve,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,0BAA0B,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;KAC1F;IACD,uFAAuF;IACvF,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,cAAc,EAAE;QAC1B,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAChE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAClE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAC/D,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QACnE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;KAC/D;IACD,8EAA8E;IAC9E,OAAO,EAAE,EAAE;IACX,MAAM,EAAE;QACN,SAAS,EAAE,EAAE;QACb,YAAY,EAAE;YACZ,mHAAmH;YACnH,MAAM,EAAE;gBACN,iBAAiB;gBACjB,2BAA2B;gBAC3B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,0BAA0B;gBAC1B,kCAAkC;gBAClC,2BAA2B;gBAC3B,uBAAuB;gBACvB,0CAA0C;gBAC1C,0CAA0C;gBAC1C,2BAA2B;gBAC3B,gCAAgC;gBAChC,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,4BAA4B;gBAC5B,kCAAkC;gBAClC,6BAA6B;aAC9B;YACD,iBAAiB,EAAE;gBACjB,iBAAiB;gBACjB,2BAA2B;gBAC3B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,0BAA0B;gBAC1B,kCAAkC;gBAClC,2BAA2B;gBAC3B,uBAAuB;gBACvB,0CAA0C;gBAC1C,0CAA0C;gBAC1C,2BAA2B;gBAC3B,gCAAgC;gBAChC,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,4BAA4B;gBAC5B,kCAAkC;gBAClC,6BAA6B;aAC9B;YACD,kGAAkG;YAClG,iBAAiB,EAAE,EAAE;YACrB,wBAAwB,EAAE,CAAC;YAC3B,qEAAqE;YACrE,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,UAAU;SAC9B;KACF;IACD,QAAQ,EAAE,2BAA2B,CAAC,cAAc;IACpD,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,0BAA0B,CAAC,aAAa;CACyF,CAAC","sourcesContent":["import {\n MetaWorkflow_ApprovalPolicy,\n MetaWorkflow_FailurePolicy,\n MetaWorkflow_PredicateKind,\n} from '@wildo-ai/saas-models/meta-workflows';\nimport {\n MetaWorkflow_InputRender,\n MetaWorkflow_Phase,\n type MetaWorkflowPlaybookAuthoring,\n} from '@wildo-ai/saas-specifications/application-creation';\n\n/**\n * The REFINEMENT line (#1608, epic #1602): refine one or more families the application already holds, in\n * place, beside the main line.\n *\n * An opened INSTANCE of this composite IS a refinement line (`ApplicationSecondaryLine.REFINEMENT`): its key\n * names the line, its purpose says what to improve, and its activation NAMES the families it re-derives\n * (`refinedFamilies`). It is never run as the default instance and belongs to no main line's tree.\n *\n * ## Why the main loop cannot do this\n *\n * The main lanes re-derive a family only when it is missing or its inputs moved; a family on record is left\n * alone. So nothing re-derives a landed family ON PURPOSE. This line does, through the producer that reads\n * the family's own prior output, so it refines what exists instead of re-authoring it.\n *\n * ## What it admits, and why every child acts on the application\n *\n * Two sets, derived by `collectRefinementLineRefs` and held equal to this list by the real-catalog test:\n * - the TARGETS: the playbooks that refine a family (a declared `companion_agent` that reads its own output,\n * runs on its own, in the main tree). Only these may be named, and only these run first;\n * - the REFRESHES: every other standalone family producer of the main tree (the placement plan, the\n * capability composition, the business model, the risk register, the compliance documents), so what the\n * change made stale can be re-derived; and the build lane, run whole.\n * Every child re-derives a WHOLE family, which an instance may never replace, so every child runs as the\n * application (`actsOnApplication`).\n *\n * The first round is not the selector's to choose: while a named family is not yet re-derived, the round\n * offers only its producers (`narrowRefinementRound`). After that the selector refreshes what the change made\n * stale, builds, and stops.\n */\nexport const playbookDefinition = {\n ref: 'cross_cutting.refinement',\n version: '0.1.0',\n phase: MetaWorkflow_Phase.CROSS_CUTTING,\n intent:\n 'Refine what this line was opened for: re-derive each named family from what it already holds, guided by the purpose, then refresh what that made out of date and build it. An umbrella: it authors nothing itself. The first move is fixed: the producers of the named families. After that, select only children whose outputs are STALE, upstream before downstream, the build last. STOP when nothing is stale any more and the build has run, or when nothing eligible advances the refinement.',\n preconditions: [\n { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'vision-brief' } },\n ],\n // For the SELECTOR: what exists, as maps, so it can tell what a refinement made stale.\n inputs: [\n { family: 'vision-brief' },\n { family: 'requirements', render: MetaWorkflow_InputRender.MAP },\n { family: 'feature-drafts', render: MetaWorkflow_InputRender.MAP },\n { family: 'domain-plan', render: MetaWorkflow_InputRender.MAP },\n { family: 'experience-plan', render: MetaWorkflow_InputRender.MAP },\n { family: 'build-plan', render: MetaWorkflow_InputRender.MAP },\n ],\n // Nothing — the lane's write scope is resolved transitively through `admits`.\n outputs: [],\n method: {\n skillRefs: [],\n choreography: {\n /* UNORDERED. Listed closing-move-first, the umbrellas' own trap check: read as a sequence it would build first. */\n admits: [\n 'bottom_up.build',\n 'bottom_up.build-decompose',\n 'bottom_up.documentation-plan',\n 'bottom_up.website-plan',\n 'bottom_up.integration-plan',\n 'bottom_up.placement-plan',\n 'bottom_up.capability-composition',\n 'bottom_up.experience-plan',\n 'bottom_up.domain-plan',\n 'refinement.governance-document-candidate',\n 'refinement.compliance-document-candidate',\n 'refinement.document-facts',\n 'top_down.compliance-conception',\n 'top_down.risk-register',\n 'top_down.business-model',\n 'top_down.brand-identity',\n 'top_down.scope-roadmap',\n 'top_down.feature-drafts',\n 'top_down.capability-map',\n 'top_down.value-proposition',\n 'top_down.requirements-definition',\n 'top_down.vision-elicitation',\n ],\n actsOnApplication: [\n 'bottom_up.build',\n 'bottom_up.build-decompose',\n 'bottom_up.documentation-plan',\n 'bottom_up.website-plan',\n 'bottom_up.integration-plan',\n 'bottom_up.placement-plan',\n 'bottom_up.capability-composition',\n 'bottom_up.experience-plan',\n 'bottom_up.domain-plan',\n 'refinement.governance-document-candidate',\n 'refinement.compliance-document-candidate',\n 'refinement.document-facts',\n 'top_down.compliance-conception',\n 'top_down.risk-register',\n 'top_down.business-model',\n 'top_down.brand-identity',\n 'top_down.scope-roadmap',\n 'top_down.feature-drafts',\n 'top_down.capability-map',\n 'top_down.value-proposition',\n 'top_down.requirements-definition',\n 'top_down.vision-elicitation',\n ],\n /* A round per named family, one per refresh downstream of it, and the build lane's own rounds. */\n maximumIterations: 16,\n maximumLanesPerIteration: 1,\n // The build lane is a composite: this line needs one level below it.\n maximumDepth: 2,\n maximumDurationMs: 10_800_000,\n },\n },\n approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT,\n budget: {},\n onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG,\n} satisfies Omit<MetaWorkflowPlaybookAuthoring, 'method'> & { method: Omit<NonNullable<MetaWorkflowPlaybookAuthoring['method']>, 'guidance'> };\n"]}
1
+ {"version":3,"file":"playbook.definition.js","sourceRoot":"","sources":["../../../../../src/playbooks/cross_cutting.refinement/playbook.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,0BAA0B;IAC/B,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,kBAAkB,CAAC,aAAa;IACvC,MAAM,EACJ,qeAAqe;IACve,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,0BAA0B,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;KAC1F;IACD,uFAAuF;IACvF,MAAM,EAAE;QACN,EAAE,MAAM,EAAE,cAAc,EAAE;QAC1B,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAChE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAClE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QAC/D,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;QACnE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,wBAAwB,CAAC,GAAG,EAAE;KAC/D;IACD,8EAA8E;IAC9E,OAAO,EAAE,EAAE;IACX,MAAM,EAAE;QACN,SAAS,EAAE,EAAE;QACb,YAAY,EAAE;YACZ,mHAAmH;YACnH,MAAM,EAAE;gBACN,iBAAiB;gBACjB,2BAA2B;gBAC3B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,0BAA0B;gBAC1B,kCAAkC;gBAClC,2BAA2B;gBAC3B,uBAAuB;gBACvB,0CAA0C;gBAC1C,0CAA0C;gBAC1C,2BAA2B;gBAC3B,gCAAgC;gBAChC,wBAAwB;gBACxB,iGAAiG;gBACjG,yBAAyB;gBACzB,0BAA0B;gBAC1B,yBAAyB;gBACzB,yBAAyB;gBACzB,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,4BAA4B;gBAC5B,kCAAkC;gBAClC,6BAA6B;aAC9B;YACD,iBAAiB,EAAE;gBACjB,iBAAiB;gBACjB,2BAA2B;gBAC3B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,0BAA0B;gBAC1B,kCAAkC;gBAClC,2BAA2B;gBAC3B,uBAAuB;gBACvB,0CAA0C;gBAC1C,0CAA0C;gBAC1C,2BAA2B;gBAC3B,gCAAgC;gBAChC,wBAAwB;gBACxB,iGAAiG;gBACjG,yBAAyB;gBACzB,0BAA0B;gBAC1B,yBAAyB;gBACzB,yBAAyB;gBACzB,wBAAwB;gBACxB,yBAAyB;gBACzB,yBAAyB;gBACzB,4BAA4B;gBAC5B,kCAAkC;gBAClC,6BAA6B;aAC9B;YACD,kGAAkG;YAClG,iBAAiB,EAAE,EAAE;YACrB,wBAAwB,EAAE,CAAC;YAC3B,qEAAqE;YACrE,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,UAAU;SAC9B;KACF;IACD,QAAQ,EAAE,2BAA2B,CAAC,cAAc;IACpD,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,0BAA0B,CAAC,aAAa;CACyF,CAAC","sourcesContent":["import {\n MetaWorkflow_ApprovalPolicy,\n MetaWorkflow_FailurePolicy,\n MetaWorkflow_PredicateKind,\n} from '@wildo-ai/saas-models/meta-workflows';\nimport {\n MetaWorkflow_InputRender,\n MetaWorkflow_Phase,\n type MetaWorkflowPlaybookAuthoring,\n} from '@wildo-ai/saas-specifications/application-creation';\n\n/**\n * The REFINEMENT line (#1608, epic #1602): refine one or more families the application already holds, in\n * place, beside the main line.\n *\n * An opened INSTANCE of this composite IS a refinement line (`ApplicationSecondaryLine.REFINEMENT`): its key\n * names the line, its purpose says what to improve, and its activation NAMES the families it re-derives\n * (`refinedFamilies`). It is never run as the default instance and belongs to no main line's tree.\n *\n * ## Why the main loop cannot do this\n *\n * The main lanes re-derive a family only when it is missing or its inputs moved; a family on record is left\n * alone. So nothing re-derives a landed family ON PURPOSE. This line does, through the producer that reads\n * the family's own prior output, so it refines what exists instead of re-authoring it.\n *\n * ## What it admits, and why every child acts on the application\n *\n * Two sets, derived by `collectRefinementLineRefs` and held equal to this list by the real-catalog test:\n * - the TARGETS: the playbooks that refine a family (a declared `companion_agent` that reads its own output,\n * runs on its own, in the main tree). Only these may be named, and only these run first;\n * - the REFRESHES: every other standalone family producer of the main tree (the placement plan, the\n * capability composition, the business model, the risk register, the compliance documents, the expert\n * staffing), so what the change made stale can be re-derived; and the build lane, run whole.\n * Every child re-derives a WHOLE family, which an instance may never replace, so every child runs as the\n * application (`actsOnApplication`).\n *\n * The first round is not the selector's to choose: while a named family is not yet re-derived, the round\n * offers only its producers (`narrowRefinementRound`). After that the selector refreshes what the change made\n * stale, builds, and stops.\n */\nexport const playbookDefinition = {\n ref: 'cross_cutting.refinement',\n version: '0.1.2',\n phase: MetaWorkflow_Phase.CROSS_CUTTING,\n intent:\n 'Refine what this line was opened for: re-derive each named family from what it already holds, guided by the purpose, then refresh what that made out of date and build it. An umbrella: it authors nothing itself. The first move is fixed: the producers of the named families. After that, select only children whose outputs are STALE, upstream before downstream, the build last. STOP when nothing is stale any more and the build has run, or when nothing eligible advances the refinement.',\n preconditions: [\n { kind: MetaWorkflow_PredicateKind.ARTIFACT_VALID, selector: { family: 'vision-brief' } },\n ],\n // For the SELECTOR: what exists, as maps, so it can tell what a refinement made stale.\n inputs: [\n { family: 'vision-brief' },\n { family: 'requirements', render: MetaWorkflow_InputRender.MAP },\n { family: 'feature-drafts', render: MetaWorkflow_InputRender.MAP },\n { family: 'domain-plan', render: MetaWorkflow_InputRender.MAP },\n { family: 'experience-plan', render: MetaWorkflow_InputRender.MAP },\n { family: 'build-plan', render: MetaWorkflow_InputRender.MAP },\n ],\n // Nothing — the lane's write scope is resolved transitively through `admits`.\n outputs: [],\n method: {\n skillRefs: [],\n choreography: {\n /* UNORDERED. Listed closing-move-first, the umbrellas' own trap check: read as a sequence it would build first. */\n admits: [\n 'bottom_up.build',\n 'bottom_up.build-decompose',\n 'bottom_up.documentation-plan',\n 'bottom_up.website-plan',\n 'bottom_up.integration-plan',\n 'bottom_up.placement-plan',\n 'bottom_up.capability-composition',\n 'bottom_up.experience-plan',\n 'bottom_up.domain-plan',\n 'refinement.governance-document-candidate',\n 'refinement.compliance-document-candidate',\n 'refinement.document-facts',\n 'top_down.compliance-conception',\n 'top_down.risk-register',\n // The firm's method refines its own prior output (#2305), so a refinement line may re-derive it.\n 'top_down.service-method',\n 'top_down.expert-personas',\n 'top_down.business-model',\n 'top_down.brand-identity',\n 'top_down.scope-roadmap',\n 'top_down.feature-drafts',\n 'top_down.capability-map',\n 'top_down.value-proposition',\n 'top_down.requirements-definition',\n 'top_down.vision-elicitation',\n ],\n actsOnApplication: [\n 'bottom_up.build',\n 'bottom_up.build-decompose',\n 'bottom_up.documentation-plan',\n 'bottom_up.website-plan',\n 'bottom_up.integration-plan',\n 'bottom_up.placement-plan',\n 'bottom_up.capability-composition',\n 'bottom_up.experience-plan',\n 'bottom_up.domain-plan',\n 'refinement.governance-document-candidate',\n 'refinement.compliance-document-candidate',\n 'refinement.document-facts',\n 'top_down.compliance-conception',\n 'top_down.risk-register',\n // The firm's method refines its own prior output (#2305), so a refinement line may re-derive it.\n 'top_down.service-method',\n 'top_down.expert-personas',\n 'top_down.business-model',\n 'top_down.brand-identity',\n 'top_down.scope-roadmap',\n 'top_down.feature-drafts',\n 'top_down.capability-map',\n 'top_down.value-proposition',\n 'top_down.requirements-definition',\n 'top_down.vision-elicitation',\n ],\n /* A round per named family, one per refresh downstream of it, and the build lane's own rounds. */\n maximumIterations: 16,\n maximumLanesPerIteration: 1,\n // The build lane is a composite: this line needs one level below it.\n maximumDepth: 2,\n maximumDurationMs: 10_800_000,\n },\n },\n approval: MetaWorkflow_ApprovalPolicy.APPROVE_RESULT,\n budget: {},\n onFailure: MetaWorkflow_FailurePolicy.KEEP_AND_FLAG,\n} satisfies Omit<MetaWorkflowPlaybookAuthoring, 'method'> & { method: Omit<NonNullable<MetaWorkflowPlaybookAuthoring['method']>, 'guidance'> };\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/refinement.compliance-document-candidate/playbook.definition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wCAAwC,EACxC,+BAA+B,EAC/B,gCAAgC,EAChC,sCAAsC,EACtC,0CAA0C,EAC1C,6CAA6C,EAC7C,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyErB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHW,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.compliance-document-candidate/playbook.definition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wCAAwC,EACxC,+BAA+B,EAC/B,gCAAgC,EAChC,sCAAsC,EACtC,0CAA0C,EAC1C,6CAA6C,EAC7C,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyErB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHW,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../src/playbooks/refinement.document-facts/playbook.definition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wCAAwC,EACxC,+BAA+B,EAC/B,gCAAgC,EAChC,sCAAsC,EACtC,0CAA0C,EAC1C,6CAA6C,EAC7C,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwG+G,CAAC;AAE/I;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHW,CAAC"}
1
+ {"version":3,"file":"playbook.definition.d.ts","sourceRoot":"","sources":["../../../../../src/playbooks/refinement.document-facts/playbook.definition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EAClC,wCAAwC,EACxC,+BAA+B,EAC/B,gCAAgC,EAChC,sCAAsC,EACtC,0CAA0C,EAC1C,6CAA6C,EAC7C,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAEnB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwG+G,CAAC;AAE/I;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuHW,CAAC"}
@@ -22,7 +22,7 @@ import { MetaWorkflow_ContextSource, MetaWorkflow_Phase, } from '@wildo-ai/saas-
22
22
  */
23
23
  export const playbookDefinition = {
24
24
  ref: 'refinement.document-facts',
25
- version: '0.1.0',
25
+ version: '0.1.2',
26
26
  phase: MetaWorkflow_Phase.REFINEMENT,
27
27
  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.",
28
28
  preconditions: [