@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
@@ -0,0 +1,982 @@
1
+ # Page kinds — API (source-backed)
2
+
3
+ What a page's kind derives: its route, its place in the site menu, and the sections it cannot do without.
4
+
5
+ ## The page and section vocabularies
6
+
7
+ ## Import Origins
8
+
9
+ - `@wildo-ai/saas-specifications`
10
+
11
+ ## Source Excerpts
12
+
13
+ ### Origin Package: `@wildo-ai/saas-specifications`
14
+
15
+ ```typescript
16
+ *
17
+ * WHAT the application's marketing website says, page by page and section by section — the plan the
18
+ * build lane turns into website tasks (#1492).
19
+ *
20
+ * ## Why this family exists
21
+ *
22
+ * The framework ships the `website-*` skills, an `add-website` scenario and a whole engine
23
+ * (`@wildo-ai/saas-website`). Measured 2026-09-22: **no playbook named the word "website"**, so the
24
+ * largest finished asset in the catalog had no door — an application could be given a website only
25
+ * by a human running `wildo compose` and then authoring every page by hand.
26
+ *
27
+ * ## Why a PLAN rather than tasks
28
+ *
29
+ * The build plan has ONE producer (`bottom_up.build-decompose`), and that is what makes landing
30
+ * decidable: a second producer of one family destroys the first's output, which is the defect #895
31
+ * recorded for governed documents. So this family carries the DECISIONS — which pages, which
32
+ * sections, in which order, drawing on which market entries — and build-decompose turns them into
33
+ * `WEBSITE_PAGE` and `WEBSITE_SECTION` tasks.
34
+ *
35
+ * ## Why it is a MODEL's output and not a derivation
36
+ *
37
+ * Which pages a site needs is largely derivable (a pricing page follows from declared pricing
38
+ * plans), and which SECTIONS tell the story — which proofs answer which objections, in which order,
39
+ * in which tone — is composition judgement over authored market content. That is what a harnessed
40
+ * model with the market snapshot in front of it is for, and the skills that carry each section's HOW
41
+ * are shipped beside it.
42
+ */
43
+ export enum WebsitePlanVersion {
44
+ V1 = 'v1',
45
+ }
46
+
47
+ /** Stable prefix every planned page ref carries; the trusted runtime stamps it, a provider supplies only the slug. */
48
+ export const WEBSITE_PAGE_REF_PREFIX = 'page-';
49
+
50
+ /**
51
+ * WHETHER this application has a marketing website at all.
52
+ *
53
+ * Representable rather than refused: the capability composition decides whether the application gets a website, and an application that
54
+ * declines one must still be able to RECORD that — a plan that could only be produced for a site
55
+ * that exists would make "no website" an absence nobody can read, and would make the build lane's
56
+ * consumption of this family conditional on a file's existence rather than on what it says.
57
+ */
58
+ export enum WebsitePlanDisposition {
59
+ /** The application has a website and these are its pages. */
60
+ PLANNED = 'PLANNED',
61
+ /**
62
+ * The application has no marketing website; `pages` is empty and `rationale` says why.
63
+ *
64
+ * KEPT, though it is no longer the normal path (#1606): `bottom_up.website-plan` now runs only once the
65
+ * composition decides `add-website` NEEDED, so a declined website is never planned at all. This member
66
+ * stays for a plan landed before that gate, which must still read as "no pages", and for a run whose
67
+ * composition changed after it was started. Retiring it would make those plans unparseable.
68
+ */
69
+ NOT_APPLICABLE = 'NOT_APPLICABLE',
70
+ }
71
+
72
+ /**
73
+ * WHAT KIND of page this is — the question a visitor arrives with, and so its route, its place in the menu and
74
+ * the sections it cannot do without.
75
+ *
76
+ * A closed vocabulary because each member DECIDES things nothing else should be asked: the route
77
+ * (`websitePageRoutePath`), the menu placement (`websitePageMenuPlacement`) and the essentials the validator
78
+ * checks (`WEBSITE_PAGE_KIND_ESSENTIALS`). Before it, every page was a free slug with a one-sentence purpose, the
79
+ * only vocabulary was a four-row prose table (landing / pricing / features / contact), and "product page" or
80
+ * "solution page" existed nowhere in the lane.
81
+ *
82
+ * The product / solution split is how SaaS sites are actually built: Stripe's menu separates Products (named
83
+ * capabilities, one line each) from Solutions (by stage, use case, industry); a product page answers "what does
84
+ * it do", a solution page "how does it solve MY problem", problem-led and cut by role, industry, use case or company
85
+ * size. NN/g's caution about audience-based navigation is why solutions are SECONDARY to the product in the menu
86
+ * and why a solution page is named for the visitor ("For finance teams"), never instead of the product.
87
+ */
88
+ export enum WebsitePageKind {
89
+ /** The site's front door, at `/`. Exactly one. */
90
+ HOME = 'HOME',
91
+ /** The product as a whole — every area at a glance — at `/product`. At most one; the Product panel's overview. */
92
+ PRODUCT_OVERVIEW = 'PRODUCT_OVERVIEW',
93
+ /** One product area or capability, at `/product/<slug>`: what it is, how it works, what it changes. */
94
+ PRODUCT = 'PRODUCT',
95
+ /**
96
+ * The product seen from one audience's problem, at `/solutions/<slug>`: problem-led, then how the product
97
+ * answers it. Carries a `solutionAxis`, which groups the Solutions panel.
98
+ */
99
+ SOLUTION = 'SOLUTION',
100
+ /** The plans, at `/pricing`. At most one. */
101
+ PRICING = 'PRICING',
102
+ /** A way to reach a person, at `/contact`. At most one. */
103
+ CONTACT = 'CONTACT',
104
+ /** Who is behind the product and why, at `/about`. At most one. */
105
+ COMPANY = 'COMPANY',
106
+ /**
107
+ * What a buyer's security review asks, answered from the product, at `/security`. At most one. Planned when the
108
+ * application really has controls to describe — where its data is stored, how people sign in, what it records,
109
+ * how long it keeps what, the rights a person can exercise — and never as a page of badges: a certification the
110
+ * application does not hold is not on it. Joins the Product panel, beside the areas it protects.
111
+ */
112
+ TRUST = 'TRUST',
113
+ /**
114
+ * The blog's index, at `/blog`. At most one. Planned when the application publishes posts (the engine's blog
115
+ * adapter: one MDX file per post, per locale); the index lists them newest first, from their own frontmatter.
116
+ */
117
+ BLOG = 'BLOG',
118
+ }
119
+
120
+ /** How a SOLUTION page cuts the audience — the column it sits in under Solutions. */
121
+ export enum WebsiteSolutionAxis {
122
+ /** A job function: finance teams, operations leads, founders. */
123
+ ROLE = 'ROLE',
124
+ /** A sector: retail, banking, healthcare. */
125
+ INDUSTRY = 'INDUSTRY',
126
+ /** A job to be done, across roles: onboarding customers, closing the books. */
127
+ USE_CASE = 'USE_CASE',
128
+ /** A stage or size: startups, scale-ups, enterprises. */
129
+ COMPANY_SIZE = 'COMPANY_SIZE',
130
+ }
131
+
132
+ /**
133
+ * The HOME page's slug — the scaffold's starter page (`add-website` writes `landing`, mounted at `/`).
134
+ *
135
+ * Fixed, not chosen: the home page is not a new page the build adds, it is the starter it grows. A plan that named
136
+ * its home `home` would make the page task author a SECOND page at `/` beside the starter (scratch-journey did, by
137
+ * renaming files by hand). `SCAFFOLDED_WEBSITE_STARTER` reads this constant, and the plan refuses a HOME page under
138
+ * any other ref (`WEBSITE_HOME_PAGE_REF`) — the stored plan, not only the generation contract, so a plan written
139
+ * before the rule, or by hand, cannot carry one past it.
140
+ *
141
+ * A site has at most one page of each kind with a fixed route (HOME, PRODUCT_OVERVIEW, PRICING, CONTACT, COMPANY,
142
+ * TRUST, BLOG):
143
+ * that needs no list of its own, because two such pages derive one route and the plan refuses two pages on a route.
144
+ */
145
+ export const WEBSITE_HOME_PAGE_SLUG = 'landing';
146
+
147
+ /** The HOME page's stamped ref, `page-landing`: the one value a HOME page's `pageRef` may hold. */
148
+ export const WEBSITE_HOME_PAGE_REF: string = `${WEBSITE_PAGE_REF_PREFIX}${WEBSITE_HOME_PAGE_SLUG}`;
149
+
150
+ /**
151
+ * WHAT a section does on its page — a closed vocabulary, because each member names the SKILL that
152
+ * carries its authoring, and a section a skill cannot build is a section no task can land.
153
+ *
154
+ * One member per `website-section-*` skill the framework ships, which is what makes
155
+ * {@link WEBSITE_SECTION_SKILL_REF} total rather than a hand-kept list: adding a section kind
156
+ * without the skill that builds it does not compile.
157
+ */
158
+ export enum WebsiteSectionKind {
159
+ /** The page's opening promise — headline, sub-headline, primary call to action. */
160
+ HERO = 'HERO',
161
+ /** The benefits, summarised — one line each, for a reader who will not read the detail. */
162
+ FEATURE_BENEFIT_SUMMARY = 'FEATURE_BENEFIT_SUMMARY',
163
+ /** One benefit, argued — the job it advances, the pain it relieves, what the product does about it. */
164
+ FEATURE_DETAIL = 'FEATURE_DETAIL',
165
+ /** The pricing plans as the business model declares them. */
166
+ PRICING = 'PRICING',
167
+ /** Proof — logos, numbers, quotations the market snapshot authored. */
168
+ SOCIAL_PROOF = 'SOCIAL_PROOF',
169
+ /** The objections, answered. */
170
+ FAQ = 'FAQ',
171
+ /** A call to action inside the page's flow. */
172
+ CTA = 'CTA',
173
+ /** The closing call to action, at the foot of the page. */
174
+ FOOTER_CTA = 'FOOTER_CTA',
175
+ /** A way to reach a human — the inbound contact form. */
176
+ CONTACT = 'CONTACT',
177
+ /**
178
+ * The problem the audience lives with, told in their words before any product appears — the opening argument of
179
+ * a SOLUTION page, and of a home page whose visitors do not yet know they have the problem.
180
+ */
181
+ PROBLEM = 'PROBLEM',
182
+ /** How it works, in three or four steps — what the visitor does and what the product does at each. */
183
+ HOW_IT_WORKS = 'HOW_IT_WORKS',
184
+ /**
185
+ * The product itself, shown: the real interface in a frame, a bento of its key screens, or tabs across its main
186
+ * views. What makes a modern home page read as a product and not as a brochure.
187
+ */
188
+ PRODUCT_SHOWCASE = 'PRODUCT_SHOWCASE',
189
+ /**
190
+ * The paths into the site by audience — one card per SOLUTION page, each linking to it. Lets a home or product
191
+ * overview page route a visitor to the page written for them.
192
+ */
193
+ SOLUTION_PATHS = 'SOLUTION_PATHS',
194
+ /** The product against the alternatives the market snapshot names — honestly, including where it is not better. */
195
+ COMPARISON = 'COMPARISON',
196
+ /**
197
+ * Facts about the product, as figures — each one a value the application itself declares (a retention period, a
198
+ * count of operations, a storage region) with what it means. Never a measured outcome nobody measured ("40% faster"),
199
+ * never a customer count the application cannot show.
200
+ */
201
+ STATS = 'STATS',
202
+ /**
203
+ * The systems the product connects to, by name — each one a provider or protocol the application really declares,
204
+ * with what the connection does. A marquee, a catalog, or both.
205
+ */
206
+ INTEGRATIONS = 'INTEGRATIONS',
207
+ /** The newest posts of the site's blog, as cards read from the posts' own frontmatter. */
208
+ LATEST_POSTS = 'LATEST_POSTS',
209
+ /**
210
+ * What has shipped and what is next, in the open — the product's phases as the application's roadmap declares
211
+ * them. A stage that is not built is labelled as next or later, never presented as available.
212
+ */
213
+ ROADMAP = 'ROADMAP',
214
+ }
215
+
216
+ /**
217
+ * The app-knowledge skill that authors each section kind — TOTAL over the vocabulary, so a kind
218
+ * added tomorrow must name the skill that builds it or fail to compile.
219
+ *
220
+ * This is what makes the `website-section-*` skills REACHABLE. The decomposer's model writes a
221
+ * task's `skillRefs`, and nothing forces it to write the right one — so the companion's dispatch
222
+ * derives the skill from the section's KIND through {@link websiteProductSkillRefs} and hands that to
223
+ * the coding agent, rather than trusting a model to remember the skill folder names (a capability whose
224
+ * skill never reaches the agent is one the journey cannot build). Held to the
225
+ * authored catalog by a test in the framework-knowledge package — this layer cannot import the
226
+ * skills, and a ref naming no folder is a task nothing can route.
227
+ */
228
+ export const WEBSITE_SECTION_SKILL_REF: Readonly<Record<WebsiteSectionKind, string>> = {
229
+ [WebsiteSectionKind.HERO]: 'website-section-hero',
230
+ [WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY]: 'website-section-feature-benefit-summary',
231
+ [WebsiteSectionKind.FEATURE_DETAIL]: 'website-section-feature-detail',
232
+ [WebsiteSectionKind.PRICING]: 'website-section-pricing',
233
+ [WebsiteSectionKind.SOCIAL_PROOF]: 'website-section-social-proof',
234
+ [WebsiteSectionKind.FAQ]: 'website-section-faq',
235
+ [WebsiteSectionKind.CTA]: 'website-section-cta',
236
+ [WebsiteSectionKind.FOOTER_CTA]: 'website-section-footer-cta',
237
+ [WebsiteSectionKind.CONTACT]: 'website-section-contact',
238
+ [WebsiteSectionKind.PROBLEM]: 'website-section-problem',
239
+ [WebsiteSectionKind.HOW_IT_WORKS]: 'website-section-how-it-works',
240
+ [WebsiteSectionKind.PRODUCT_SHOWCASE]: 'website-section-product-showcase',
241
+ [WebsiteSectionKind.SOLUTION_PATHS]: 'website-section-solution-paths',
242
+ [WebsiteSectionKind.COMPARISON]: 'website-section-comparison',
243
+ [WebsiteSectionKind.STATS]: 'website-section-stats',
244
+ [WebsiteSectionKind.INTEGRATIONS]: 'website-section-integrations',
245
+ [WebsiteSectionKind.LATEST_POSTS]: 'website-section-latest-posts',
246
+ [WebsiteSectionKind.ROADMAP]: 'website-section-roadmap',
247
+ };
248
+
249
+ /** The app-knowledge skill that authors a website PAGE — its route, bridge, manifest and section list. */
250
+ export const WEBSITE_PAGE_SKILL_REF = 'website-page-authoring';
251
+
252
+ /**
253
+ * The skills a PAGE task is authored with, per page kind: always {@link WEBSITE_PAGE_SKILL_REF}, plus the skill
254
+ * that owns what a kind needs beyond a page. A BLOG page is a content collection, post routes, an MDX integration and
255
+ * a blog vocabulary before it is a page, and only `website-blog-authoring` teaches that wiring: bound to the page
256
+ * skill alone, the agent building a blog page was never shown it. Total over the kinds, so a kind added later decides
257
+ * its skills here rather than silently getting the page skill only.
258
+ */
259
+ export const WEBSITE_PAGE_KIND_SKILL_REFS: Readonly<Record<WebsitePageKind, readonly string[]>> = {
260
+ [WebsitePageKind.HOME]: [WEBSITE_PAGE_SKILL_REF],
261
+ [WebsitePageKind.PRODUCT_OVERVIEW]: [WEBSITE_PAGE_SKILL_REF],
262
+ [WebsitePageKind.PRODUCT]: [WEBSITE_PAGE_SKILL_REF],
263
+ [WebsitePageKind.SOLUTION]: [WEBSITE_PAGE_SKILL_REF],
264
+ [WebsitePageKind.PRICING]: [WEBSITE_PAGE_SKILL_REF],
265
+ [WebsitePageKind.CONTACT]: [WEBSITE_PAGE_SKILL_REF],
266
+ [WebsitePageKind.COMPANY]: [WEBSITE_PAGE_SKILL_REF],
267
+ [WebsitePageKind.TRUST]: [WEBSITE_PAGE_SKILL_REF],
268
+ [WebsitePageKind.BLOG]: [WEBSITE_PAGE_SKILL_REF, 'website-blog-authoring'],
269
+ };
270
+
271
+ /**
272
+ * The skills a website build product is authored with, DERIVED from the plan.
273
+ *
274
+ * A page is authored with the skills its kind names in {@link WEBSITE_PAGE_KIND_SKILL_REFS} (the page skill alone when
275
+ * the plan does not carry the page); a section with the skill its kind names in {@link WEBSITE_SECTION_SKILL_REF},
276
+ * looked up in the plan by page and section ref. A section the plan does not carry derives nothing, and the caller
277
+ * keeps whatever the task declared.
278
+ *
279
+ * Structural input, not the build-plan product type, so this family does not depend on the build
280
+ * plan's schema — the build plan depends on it.
281
+ */
282
+ export function websiteProductSkillRefs(
283
+ product: { readonly pageRef: string; readonly sectionRef?: string | undefined },
284
+ plan: WebsitePlan | undefined,
285
+ ): string[] {
286
+ const page = plan?.pages.find((entry) => entry.pageRef === product.pageRef);
287
+ if (product.sectionRef === undefined) return page === undefined ? [WEBSITE_PAGE_SKILL_REF] : [...WEBSITE_PAGE_KIND_SKILL_REFS[page.kind]];
288
+ const section = page?.sections.find((entry) => entry.sectionRef === product.sectionRef);
289
+ return section === undefined ? [] : [WEBSITE_SECTION_SKILL_REF[section.kind]];
290
+ }
291
+
292
+ /**
293
+ * The shape of every identifier the plan hands to the site: a section ref, and a page's slug (the `<slug>` of
294
+ * `page-<slug>`). Both become identifiers the website validates. `WebsiteSectionRef` and `WebsitePageRef` start with
295
+ * a letter, a page's slug also becomes its const prefix (`<SLUG>_PAGE_MANIFEST`, which must be a valid identifier),
296
+ * and a PRODUCT or SOLUTION page's slug becomes a menu item ref. A plan that accepted `360-view` produced a site the
297
+ * engine refuses to load, so the plan holds the strictest of those rules.
298
+ */
299
+ export const WEBSITE_IDENTIFIER_PATTERN_SOURCE = '[a-z][a-z0-9]*(?:-[a-z0-9]+)*';
300
+
301
+ /** A page slug's length limit: a menu ref's 48 characters, the strictest of the identifiers the slug becomes. */
302
+ export const WEBSITE_PAGE_SLUG_MAX_LENGTH = 48;
303
+
304
+ /**
305
+ * HOW a section is built: which of the website engine's blocks renders it (#2742 step 5c). The plan says what each
306
+ * section does ({@link WebsiteSectionKind}) and, here, which block does it, so a site's design is decided once in the
307
+ * plan and every section task builds the block it names rather than each choosing its own.
308
+ *
309
+ * A design decision, not a file: it names a block of the engine's vocabulary (`websiteHeroBlock`, `websiteCardGridBlock`
310
+ * … in `@wildo-ai/saas-website`), never a component, path or class the application writes. Mirrored from that package
311
+ * because this layer cannot depend on it; the companion's bridge map (`website<Name>Block` per member) is total over
312
+ * this enum and a companion test holds the two equal.
313
+ */
314
+ export enum WebsiteSectionComponent {
315
+ /** The page's opening, `websiteHeroBlock`. */
316
+ HERO = 'HERO',
317
+ /** One capability argued beside a visual, `websiteFeatureRowBlock`. */
318
+ FEATURE_ROW = 'FEATURE_ROW',
319
+ /** Cards under the section intro, `websiteCardGridBlock`. */
320
+ CARD_GRID = 'CARD_GRID',
321
+ /** Tiles, each a small looping drawing and two lines, `websiteBentoBlock`. */
322
+ BENTO = 'BENTO',
323
+ /** The product in tabs, a drawn screen per tab, `websiteProductTourBlock`. */
324
+ PRODUCT_TOUR = 'PRODUCT_TOUR',
325
+ /** A list scrolling past, `websiteMarqueeBlock`. */
326
+ MARQUEE = 'MARQUEE',
327
+ /** How it works, in order, `websiteStepsBlock`. */
328
+ STEPS = 'STEPS',
329
+ /** Facts as figures, `websiteStatsBlock`. */
330
+ STATS = 'STATS',
331
+ /** Quotations, each with whose words and where, `websiteQuoteCardsBlock`. */
332
+ QUOTE_CARDS = 'QUOTE_CARDS',
333
+ /** The roadmap's phases, `websiteRoadmapBlock`. */
334
+ ROADMAP = 'ROADMAP',
335
+ /** One card per audience, each linking to its solution page, `websiteSolutionPathsBlock`. */
336
+ SOLUTION_PATHS = 'SOLUTION_PATHS',
337
+ /** The blog's newest posts, `websiteLatestPostsBlock`. */
338
+ LATEST_POSTS = 'LATEST_POSTS',
339
+ /** The product against the alternatives, `websiteComparisonTableBlock`. */
340
+ COMPARISON_TABLE = 'COMPARISON_TABLE',
341
+ /** Facts in rows, `websiteFactTableBlock`. */
342
+ FACT_TABLE = 'FACT_TABLE',
343
+ /** Questions and answers, `websiteFaqBlock`. */
344
+ FAQ = 'FAQ',
345
+ /** A call to action as a band of its own, `websiteCtaBandBlock`. */
346
+ CTA_BAND = 'CTA_BAND',
347
+ /** The plans and their prices, `WebsitePricing` (declared by hand: its words follow the catalogue). */
348
+ PRICING = 'PRICING',
349
+ /** A block of the site's own (`defineWebsiteBlock`), for a section no engine block covers. */
350
+ SITE_BLOCK = 'SITE_BLOCK',
351
+ }
352
+
353
+ /**
354
+ * The blocks that can build each section kind, the FIRST being the one a section gets when its plan names none. TOTAL
355
+ * over the kinds, so a kind added tomorrow does not compile until somebody says which blocks build it, and a section
356
+ * naming a block outside its kind's list is refused: a FAQ drawn as a card grid is not a FAQ the skill can build.
357
+ *
358
+ * Each list is what the kind's `website-section-<kind>` skill teaches, and nothing more: the section task is bound to
359
+ * that skill, so a block it does not teach is one the agent would build without guidance. `SITE_BLOCK` is listed only
360
+ * where the skill teaches a block of the site's own (a problem in one statement, area cards with moving drawings, a
361
+ * logo band, a contact layout); a comparison is never a fact table, which that skill files under the argument it
362
+ * supports instead.
363
+ */
364
+ export const WEBSITE_SECTION_KIND_COMPONENTS: Readonly<Record<WebsiteSectionKind, readonly WebsiteSectionComponent[]>> = {
365
+ [WebsiteSectionKind.HERO]: [WebsiteSectionComponent.HERO],
366
+ [WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY]: [WebsiteSectionComponent.CARD_GRID, WebsiteSectionComponent.BENTO],
367
+ [WebsiteSectionKind.FEATURE_DETAIL]: [WebsiteSectionComponent.FEATURE_ROW, WebsiteSectionComponent.FACT_TABLE],
368
+ [WebsiteSectionKind.PRICING]: [WebsiteSectionComponent.PRICING],
369
+ [WebsiteSectionKind.SOCIAL_PROOF]: [WebsiteSectionComponent.QUOTE_CARDS, WebsiteSectionComponent.MARQUEE, WebsiteSectionComponent.SITE_BLOCK],
370
+ [WebsiteSectionKind.FAQ]: [WebsiteSectionComponent.FAQ],
371
+ [WebsiteSectionKind.CTA]: [WebsiteSectionComponent.CTA_BAND],
372
+ [WebsiteSectionKind.FOOTER_CTA]: [WebsiteSectionComponent.CTA_BAND],
373
+ // The form is the feature row's visual; a contact page laid out otherwise is a site block.
374
+ [WebsiteSectionKind.CONTACT]: [WebsiteSectionComponent.FEATURE_ROW, WebsiteSectionComponent.SITE_BLOCK],
375
+ [WebsiteSectionKind.PROBLEM]: [WebsiteSectionComponent.CARD_GRID, WebsiteSectionComponent.SITE_BLOCK],
376
+ [WebsiteSectionKind.HOW_IT_WORKS]: [WebsiteSectionComponent.STEPS],
377
+ [WebsiteSectionKind.PRODUCT_SHOWCASE]: [
378
+ WebsiteSectionComponent.PRODUCT_TOUR,
379
+ WebsiteSectionComponent.BENTO,
380
+ WebsiteSectionComponent.CARD_GRID,
381
+ WebsiteSectionComponent.SITE_BLOCK,
382
+ ],
383
+ [WebsiteSectionKind.SOLUTION_PATHS]: [WebsiteSectionComponent.SOLUTION_PATHS],
384
+ [WebsiteSectionKind.COMPARISON]: [WebsiteSectionComponent.COMPARISON_TABLE],
385
+ [WebsiteSectionKind.STATS]: [WebsiteSectionComponent.STATS],
386
+ [WebsiteSectionKind.INTEGRATIONS]: [WebsiteSectionComponent.MARQUEE, WebsiteSectionComponent.CARD_GRID],
387
+ [WebsiteSectionKind.LATEST_POSTS]: [WebsiteSectionComponent.LATEST_POSTS],
388
+ [WebsiteSectionKind.ROADMAP]: [WebsiteSectionComponent.ROADMAP],
389
+ };
390
+
391
+ /** The block a section is built with: the one its plan names, else the first its kind allows. */
392
+ export function websiteSectionComponent(section: { readonly kind: WebsiteSectionKind; readonly component?: WebsiteSectionComponent | undefined }): WebsiteSectionComponent {
393
+ return section.component ?? (WEBSITE_SECTION_KIND_COMPONENTS[section.kind][0] as WebsiteSectionComponent);
394
+ }
395
+
396
+ /**
397
+ * A block's named layout, for the blocks that have one. Each member belongs to ONE component
398
+ * ({@link WEBSITE_SECTION_VARIANT_COMPONENT}), so a variant cannot be given to a block it does not shape. Mirrors the
399
+ * engine's layout vocabularies (`WebsiteHeroLayout`, `WebsiteFeatureRowLayout`, the card grid's columns and fit,
400
+ * `WebsiteStepsLayout`, `WebsiteFaqLayout`, `WebsitePricingLayout`).
401
+ */
402
+ export enum WebsiteSectionVariant {
403
+ /** The visual below the copy, as the product's stage. */
404
+ HERO_STAGE = 'hero-stage',
405
+ /** The visual beside the copy. */
406
+ HERO_SPLIT = 'hero-split',
407
+ /** No visual: a compact opening. */
408
+ HERO_COMPACT = 'hero-compact',
409
+ /** The visual after the copy (to its right in a left-to-right page). */
410
+ FEATURE_ROW_VISUAL_END = 'feature-row-visual-end',
411
+ /** The visual before the copy, so consecutive rows zig-zag. */
412
+ FEATURE_ROW_VISUAL_START = 'feature-row-visual-start',
413
+ CARD_GRID_TWO_COLUMNS = 'card-grid-two-columns',
414
+ CARD_GRID_THREE_COLUMNS = 'card-grid-three-columns',
415
+ CARD_GRID_FOUR_COLUMNS = 'card-grid-four-columns',
416
+ /** As many columns as fit: right for a list whose length varies. */
417
+ CARD_GRID_FIT = 'card-grid-fit',
418
+ /** The steps side by side. */
419
+ STEPS_ROW = 'steps-row',
420
+ /** The steps one under another, each beside its drawing. */
421
+ STEPS_STACK = 'steps-stack',
422
+ /** The intro in a narrow column beside the questions. */
423
+ FAQ_SIDE = 'faq-side',
424
+ /** The intro above the questions. */
425
+ FAQ_STACKED = 'faq-stacked',
426
+ /** A summary of the plans, for a page that is not the pricing page. */
427
+ PRICING_TEASER = 'pricing-teaser',
428
+ /** The pricing page's plan cards. */
429
+ PRICING_PLANS = 'pricing-plans',
430
+ }
431
+
432
+ /** The component each variant shapes. Total, so a variant added without saying which block it shapes does not compile. */
433
+ export const WEBSITE_SECTION_VARIANT_COMPONENT: Readonly<Record<WebsiteSectionVariant, WebsiteSectionComponent>> = {
434
+ [WebsiteSectionVariant.HERO_STAGE]: WebsiteSectionComponent.HERO,
435
+ [WebsiteSectionVariant.HERO_SPLIT]: WebsiteSectionComponent.HERO,
436
+ [WebsiteSectionVariant.HERO_COMPACT]: WebsiteSectionComponent.HERO,
437
+ [WebsiteSectionVariant.FEATURE_ROW_VISUAL_END]: WebsiteSectionComponent.FEATURE_ROW,
438
+ [WebsiteSectionVariant.FEATURE_ROW_VISUAL_START]: WebsiteSectionComponent.FEATURE_ROW,
439
+ [WebsiteSectionVariant.CARD_GRID_TWO_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
440
+ [WebsiteSectionVariant.CARD_GRID_THREE_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
441
+ [WebsiteSectionVariant.CARD_GRID_FOUR_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
442
+ [WebsiteSectionVariant.CARD_GRID_FIT]: WebsiteSectionComponent.CARD_GRID,
443
+ [WebsiteSectionVariant.STEPS_ROW]: WebsiteSectionComponent.STEPS,
444
+ [WebsiteSectionVariant.STEPS_STACK]: WebsiteSectionComponent.STEPS,
445
+ [WebsiteSectionVariant.FAQ_SIDE]: WebsiteSectionComponent.FAQ,
446
+ [WebsiteSectionVariant.FAQ_STACKED]: WebsiteSectionComponent.FAQ,
447
+ [WebsiteSectionVariant.PRICING_TEASER]: WebsiteSectionComponent.PRICING,
448
+ [WebsiteSectionVariant.PRICING_PLANS]: WebsiteSectionComponent.PRICING,
449
+ };
450
+
451
+ /**
452
+ * The surface a section stands on, mirroring the engine's `WebsiteSurfaceTone`. Absent: the build alternates the page's
453
+ * bands. The plan sets it where the surface carries meaning: the page's turning points on INVERSE, the one loudest band
454
+ * on BRAND.
455
+ */
456
+ export enum WebsiteSectionTone {
457
+ /** The page's own background. */
458
+ DEFAULT = 'default',
459
+ /** A quiet tint: the alternating band. */
460
+ TINTED = 'tinted',
461
+ /** Dark on light: the page's turning points, the numbers, the closing call to action. */
462
+ INVERSE = 'inverse',
463
+ /** The brand's primary as the surface: the loudest band, once a page at most. */
464
+ BRAND = 'brand',
465
+ }
466
+
467
+ /**
468
+ * What a section's drawn product demo shows happening, mirroring the engine's `WebsiteDemoArchetype`: one of the nine
469
+ * shapes product demos take, each with a worked example the build's coding agent follows.
470
+ */
471
+ export enum WebsiteSectionDemoArchetype {
472
+ /** Items arrive one by one: an activity stream, a log, an inbox. */
473
+ APPEND = 'append',
474
+ /** A proposed change waits for a person, who approves it. */
475
+ APPROVAL = 'approval',
476
+ /** A question is asked and answered from the product's own records. */
477
+ QUERY_ANSWER = 'query-answer',
478
+ /** Something arriving (an email, a file) becomes a record. */
479
+ TRANSFORM = 'transform',
480
+ /** Two parties or systems are linked, and something flows between them. */
481
+ CONNECT = 'connect',
482
+ /** Items on a list are completed. */
483
+ COMPLETE_ITEMS = 'complete-items',
484
+ /** One record moves through its statuses. */
485
+ STATUS_LIFECYCLE = 'status-lifecycle',
486
+ /** Figures and charts fill in. */
487
+ DASHBOARD = 'dashboard',
488
+ /** A goal is reached and marked. */
489
+ CELEBRATE = 'celebrate',
490
+ }
491
+
492
+ /**
493
+ * The components whose section may hold a drawing of the product, so a `demo` may say what it shows. A block of the
494
+ * site's own is among them: area cards with moving drawings are taught as one, and nothing in the plan can prove a site
495
+ * block holds no drawing, so refusing its demo would refuse a true plan.
496
+ */
497
+ export const WEBSITE_SECTION_COMPONENTS_WITH_DEMO: readonly WebsiteSectionComponent[] = [
498
+ WebsiteSectionComponent.HERO,
499
+ WebsiteSectionComponent.FEATURE_ROW,
500
+ WebsiteSectionComponent.PRODUCT_TOUR,
501
+ WebsiteSectionComponent.BENTO,
502
+ WebsiteSectionComponent.SITE_BLOCK,
503
+ ];
504
+
505
+ /** A section ref's length limit: the website's `WebsiteSectionRef`. */
506
+ export const WEBSITE_SECTION_REF_MAX_LENGTH = 64;
507
+
508
+ const SlugSchema = z.string().max(WEBSITE_SECTION_REF_MAX_LENGTH).regex(new RegExp(`^${WEBSITE_IDENTIFIER_PATTERN_SOURCE}$`));
509
+ const NonEmptyStringSchema = z.string().trim().min(1);
510
+
511
+ /** One section of one page. */
512
+ export const WebsiteSectionPlanSchema = z.strictObject({
513
+ /** Unique across the site (named after its page when two pages would share it); the section's id in `website/src/sections/<pageRef>.sections.tsx`. */
514
+ sectionRef: SlugSchema,
515
+ kind: z.enum(WebsiteSectionKind).systemEnum('WebsiteSectionKind'),
516
+ /** What this section has to do for the reader, in one sentence. */
517
+ purpose: NonEmptyStringSchema,
518
+ /**
519
+ * The market-snapshot entries this section draws on — benefit, proof, objection, job, pain, ICP
520
+ * or tone refs, as the snapshot authored them.
521
+ *
522
+ * Traceability, never scope authority, exactly as a build task's `servesRefs`: a section that
523
+ * names no market entry is a section somebody invented, and a reader can check every one of these
524
+ * against the snapshot. Not refused when empty — a hero's headline may legitimately be the
525
+ * vision's own one-liner — but the judge reads it.
526
+ */
527
+ drawsOnRefs: z.array(NonEmptyStringSchema).default([]),
528
+ /**
529
+ * The requirements this section's CAPABILITY claims rest on, by their refs (#2507): functional or non-functional.
530
+ * A citation, named like `valuePillars[].backedByBenefitRefs`, not a delivery like a roadmap phase's field.
531
+ *
532
+ * A market benefit says what a buyer wants; it does not say the product does it. One generated site promised
533
+ * "country workflow guidance with its limits stated", drawn from a market benefit, while the product shipped an
534
+ * empty place for an administrator to write guidance. A section that says the product DOES something cites the
535
+ * requirement behind it. The citation is necessary, not sufficient: a requirement is a commitment, so when the
536
+ * section is built its author is told whether the tasks serving each cited requirement have landed, whether a run
537
+ * reported it still unmet, and which roadmap phase delivers it. Only what has been delivered is described as
538
+ * available; the rest is described as planned.
539
+ *
540
+ * Reported when empty on a kind whose job is to say what the product does ({@link WEBSITE_SECTION_KIND_CLAIMS_CAPABILITY},
541
+ * `CAPABILITY_CLAIM_UNBACKED`). Any other kind may cite requirements too, and one that cites none describes no capability
542
+ * as available.
543
+ */
544
+ backedByRequirementRefs: z.array(NonEmptyStringSchema).default([]),
545
+ /** The block that builds it, among those its kind allows ({@link WEBSITE_SECTION_KIND_COMPONENTS}); absent: the kind's first. */
546
+ component: z.enum(WebsiteSectionComponent).systemEnum('WebsiteSectionComponent').optional(),
547
+ /** The block's layout, when it has named ones; it must shape the section's component. */
548
+ variant: z.enum(WebsiteSectionVariant).systemEnum('WebsiteSectionVariant').optional(),
549
+ /** The surface it stands on; absent: the build alternates the page's bands. */
550
+ tone: z.enum(WebsiteSectionTone).systemEnum('WebsiteSectionTone').optional(),
551
+ /**
552
+ * What its drawing of the product shows happening, for a component that holds one
553
+ * ({@link WEBSITE_SECTION_COMPONENTS_WITH_DEMO}): the archetype, the resource it is drawn from (its ref in the domain
554
+ * plan, the form the build plan's `resourceRef` takes, so the build binds the drawing to that resource's real fields
555
+ * and values), and the moment in one sentence. The demo shows what the product does, so a showcase or feature detail
556
+ * without one is reported, and a `resourceRef` the domain plan does not declare is noted by the definition coherence
557
+ * check.
558
+ */
559
+ demo: z
560
+ .strictObject({
561
+ archetype: z.enum(WebsiteSectionDemoArchetype).systemEnum('WebsiteSectionDemoArchetype'),
562
+ resourceRef: SlugSchema.optional(),
563
+ moment: NonEmptyStringSchema,
564
+ })
565
+ .optional(),
566
+ });
567
+ export type WebsiteSectionPlan = z.infer<typeof WebsiteSectionPlanSchema>;
568
+
569
+ /**
570
+ * Whether a section kind's job is to say what the product DOES (#2507): such a section is reported when it cites no
571
+ * requirement (`CAPABILITY_CLAIM_UNBACKED`), and its author is told it has nothing behind it. The build-time boundary
572
+ * binds every kind alike: a hero, a pricing table or an FAQ answer describes as available only what its own citations
573
+ * back. This table decides only which kinds are expected to cite.
574
+ *
575
+ * Total over the vocabulary, so a kind added tomorrow does not compile until somebody says whether it makes a claim. A
576
+ * list of the two feature kinds missed the showcase, how-it-works, comparison and integrations sections the page kinds
577
+ * added (2026-10-05), each of which says what the product does.
578
+ */
579
+ export const WEBSITE_SECTION_KIND_CLAIMS_CAPABILITY: Readonly<Record<WebsiteSectionKind, boolean>> = {
580
+ // The page's promise. Its claim is the one the sections below it argue and cite.
581
+ [WebsiteSectionKind.HERO]: false,
582
+ [WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY]: true,
583
+ [WebsiteSectionKind.FEATURE_DETAIL]: true,
584
+ // The plans as the business model declares them.
585
+ [WebsiteSectionKind.PRICING]: false,
586
+ // Proof the market snapshot authored, not a statement of what the product does.
587
+ [WebsiteSectionKind.SOCIAL_PROOF]: false,
588
+ [WebsiteSectionKind.FAQ]: false,
589
+ [WebsiteSectionKind.CTA]: false,
590
+ [WebsiteSectionKind.FOOTER_CTA]: false,
591
+ [WebsiteSectionKind.CONTACT]: false,
592
+ // The audience's problem, told before any product appears.
593
+ [WebsiteSectionKind.PROBLEM]: false,
594
+ // What the product does at each step.
595
+ [WebsiteSectionKind.HOW_IT_WORKS]: true,
596
+ // The product's own screens: what they show is what it does.
597
+ [WebsiteSectionKind.PRODUCT_SHOWCASE]: true,
598
+ // Navigation, not argument: each card names an audience and links to the SOLUTION page that makes the case.
599
+ [WebsiteSectionKind.SOLUTION_PATHS]: false,
600
+ // The product against its alternatives, which says what it does better.
601
+ [WebsiteSectionKind.COMPARISON]: true,
602
+ // Figures the application declares (a retention period, a region), facts rather than capabilities.
603
+ [WebsiteSectionKind.STATS]: false,
604
+ // What each connection does. The integration plan says a provider is declared; a requirement says the build delivers it.
605
+ [WebsiteSectionKind.INTEGRATIONS]: true,
606
+ [WebsiteSectionKind.LATEST_POSTS]: false,
607
+ // Phases as the roadmap declares them, with nothing unbuilt presented as available.
608
+ [WebsiteSectionKind.ROADMAP]: false,
609
+ };
610
+
611
+ /** One page of the marketing site. */
612
+ export const WebsitePagePlanSchema = z.strictObject({
613
+ /** `page-<slug>`, stamped by the trusted runtime; the route and the sections file are named from it. */
614
+ pageRef: z
615
+ .string()
616
+ .max(WEBSITE_PAGE_REF_PREFIX.length + WEBSITE_PAGE_SLUG_MAX_LENGTH)
617
+ .regex(new RegExp(`^${WEBSITE_PAGE_REF_PREFIX}${WEBSITE_IDENTIFIER_PATTERN_SOURCE}$`)),
618
+ /** What kind of page this is; decides its route, its menu placement and its essential sections. */
619
+ kind: z.enum(WebsitePageKind).systemEnum('WebsitePageKind'),
620
+ /** How a SOLUTION page cuts its audience. Required on a SOLUTION page, refused on any other. */
621
+ solutionAxis: z.enum(WebsiteSolutionAxis).systemEnum('WebsiteSolutionAxis').optional(),
622
+ /** What this page is for — the question a visitor arrives with. */
623
+ purpose: NonEmptyStringSchema,
624
+ /**
625
+ * The ICPs this page is written for, by their market-snapshot refs. A page written for everybody
626
+ * is written for nobody, and the positioning the market pass produced is per ICP.
627
+ */
628
+ audienceIcpRefs: z.array(NonEmptyStringSchema).default([]),
629
+ /** The tone of voice this page speaks in, by its market-snapshot ref. */
630
+ toneOfVoiceRef: NonEmptyStringSchema.optional(),
631
+ /**
632
+ * Its sections, IN READING ORDER. At least one, because a page with no section renders nothing —
633
+ * the same vacuity rule the build plan's `tasks` and the requirements' `functional` carry.
634
+ */
635
+ sections: z.array(WebsiteSectionPlanSchema).min(1),
636
+ /**
637
+ * The section a visitor remembers the page by, one of its own (#2742): the one the build gives the most care and the
638
+ * richest drawing. Its surface is its own `tone`, like any section's. Absent: no section is singled out.
639
+ */
640
+ signatureSectionRef: SlugSchema.optional(),
641
+ });
642
+ export type WebsitePagePlan = z.infer<typeof WebsitePagePlanSchema>;
643
+
644
+ /**
645
+ * The ways a section's design fields would make the plan FALSE, each refused: a block its kind cannot be built with, a
646
+ * layout of another block, a demo on a block that holds no drawing. One function, read by the stored plan's refinement,
647
+ * which the generation contract's normalizer parses its output through, so the model is held to what the plan is.
648
+ */
649
+ export function websiteSectionDesignIssues(
650
+ section: Pick<WebsiteSectionPlan, 'kind' | 'component' | 'variant' | 'demo'>,
651
+ ): readonly { readonly field: 'component' | 'variant' | 'demo'; readonly message: string }[] {
652
+ const issues: { field: 'component' | 'variant' | 'demo'; message: string }[] = [];
653
+ const allowed = WEBSITE_SECTION_KIND_COMPONENTS[section.kind];
654
+ if (section.component !== undefined && !allowed.includes(section.component)) {
655
+ issues.push({ field: 'component', message: `a ${section.kind} section is built with ${allowed.join(' / ')}, not ${section.component}` });
656
+ }
657
+ const component = websiteSectionComponent(section);
658
+ if (section.variant !== undefined && WEBSITE_SECTION_VARIANT_COMPONENT[section.variant] !== component) {
659
+ issues.push({ field: 'variant', message: `the variant ${section.variant} shapes a ${WEBSITE_SECTION_VARIANT_COMPONENT[section.variant]}, and this section is a ${component}` });
660
+ }
661
+ if (section.demo !== undefined && !WEBSITE_SECTION_COMPONENTS_WITH_DEMO.includes(component)) {
662
+ issues.push({ field: 'demo', message: `a ${component} holds no drawing of the product, so it has no demo (${WEBSITE_SECTION_COMPONENTS_WITH_DEMO.join(' / ')} do)` });
663
+ }
664
+ return issues;
665
+ }
666
+
667
+ /**
668
+ * THE website-plan payload.
669
+ *
670
+ * **Artifact-family id: `website-plan`.** Produced by `bottom_up.website-plan`, consumed by
671
+ * `bottom_up.build-decompose`, which emits one `WEBSITE_PAGE` task per page and one
672
+ * `WEBSITE_SECTION` task per section, each bound to the skill its kind names.
673
+ */
674
+ export const WebsitePlanSchema = z.object({
675
+ version: z.enum(WebsitePlanVersion).default(WebsitePlanVersion.V1),
676
+ disposition: z.enum(WebsitePlanDisposition).systemEnum('WebsitePlanDisposition'),
677
+ /** Why this application has a website and what it is for — or why it has none. */
678
+ rationale: NonEmptyStringSchema,
679
+ /** The pages, in navigation order. Empty exactly when the disposition is NOT_APPLICABLE. */
680
+ pages: z.array(WebsitePagePlanSchema).default([]),
681
+ }).superRefine((plan, context) => {
682
+ /*
683
+ * The two halves of the disposition must agree with the content, in BOTH directions. A
684
+ * NOT_APPLICABLE plan carrying pages would be applied by build-decompose against a `website/`
685
+ * workspace the composition never composed; a PLANNED plan with no page is the vacuity an empty
686
+ * artifact always is — it overwrites a real plan with nothing and reads as "done".
687
+ */
688
+ if (plan.disposition === WebsitePlanDisposition.NOT_APPLICABLE && plan.pages.length > 0) {
689
+ context.addIssue({ code: 'custom', message: 'a NOT_APPLICABLE website plan cannot carry pages; the application has no website to put them on', path: ['pages'] });
690
+ }
691
+ if (plan.disposition === WebsitePlanDisposition.PLANNED && plan.pages.length === 0) {
692
+ context.addIssue({ code: 'custom', message: 'a PLANNED website plan must carry at least one page; planning no page is a refusal, not a plan', path: ['pages'] });
693
+ }
694
+ const pageRefs = new Set<string>();
695
+ const routes = new Map<string, string>();
696
+ plan.pages.forEach((page, pageIndex) => {
697
+ if (pageRefs.has(page.pageRef)) {
698
+ context.addIssue({ code: 'custom', message: `duplicate page ref "${page.pageRef}"`, path: ['pages', pageIndex, 'pageRef'] });
699
+ }
700
+ pageRefs.add(page.pageRef);
701
+ // Two pages on one route: a second HOME, PRICING, … or two PRODUCT pages with one slug. The build could
702
+ // only mount one of them, so the plan is not one a site can be built from.
703
+ const route = websitePageRoutePath(page);
704
+ const holder = routes.get(route);
705
+ if (holder !== undefined) {
706
+ context.addIssue({ code: 'custom', message: `pages "${holder}" and "${page.pageRef}" both derive the route "${route}"`, path: ['pages', pageIndex, 'kind'] });
707
+ }
708
+ routes.set(route, page.pageRef);
709
+ if (page.kind === WebsitePageKind.HOME && page.pageRef !== WEBSITE_HOME_PAGE_REF) {
710
+ context.addIssue({
711
+ code: 'custom',
712
+ message: `the HOME page's ref is "${WEBSITE_HOME_PAGE_REF}" — the scaffold's starter page at "/", which the home page grows rather than replaces; got "${page.pageRef}"`,
713
+ path: ['pages', pageIndex, 'pageRef'],
714
+ });
715
+ }
716
+ if (page.kind === WebsitePageKind.SOLUTION && page.solutionAxis === undefined) {
717
+ context.addIssue({ code: 'custom', message: `SOLUTION page "${page.pageRef}" names no solutionAxis, so it has no column under Solutions`, path: ['pages', pageIndex, 'solutionAxis'] });
718
+ }
719
+ if (page.kind !== WebsitePageKind.SOLUTION && page.solutionAxis !== undefined) {
720
+ context.addIssue({ code: 'custom', message: `page "${page.pageRef}" is ${page.kind}; only a SOLUTION page carries a solutionAxis`, path: ['pages', pageIndex, 'solutionAxis'] });
721
+ }
722
+ const sectionRefs = new Set<string>();
723
+ page.sections.forEach((section, sectionIndex) => {
724
+ if (sectionRefs.has(section.sectionRef)) {
725
+ context.addIssue({ code: 'custom', message: `page "${page.pageRef}" declares the section "${section.sectionRef}" twice`, path: ['pages', pageIndex, 'sections', sectionIndex, 'sectionRef'] });
726
+ }
727
+ sectionRefs.add(section.sectionRef);
728
+ for (const issue of websiteSectionDesignIssues(section)) {
729
+ context.addIssue({ code: 'custom', message: `section "${section.sectionRef}" on "${page.pageRef}": ${issue.message}`, path: ['pages', pageIndex, 'sections', sectionIndex, issue.field] });
730
+ }
731
+ });
732
+ if (page.signatureSectionRef !== undefined && !sectionRefs.has(page.signatureSectionRef)) {
733
+ context.addIssue({
734
+ code: 'custom',
735
+ message: `page "${page.pageRef}" names "${page.signatureSectionRef}" as its signature section, which is not one of its sections`,
736
+ path: ['pages', pageIndex, 'signatureSectionRef'],
737
+ });
738
+ }
739
+ });
740
+ /*
741
+ * Section refs are unique across the SITE, not only within a page. The build collects every section by its ref
742
+ * (`collectExpectedLabelKeysFromSections`), and two sections sharing one carry different label keys (each rooted at
743
+ * its own page), so the site fails to build. A ref therefore names its page when two pages would share one
744
+ * (`landing-hero`, `pricing-hero`) — most pages open on a HERO (the plan warns when one does not), so this is the common
745
+ * case, not an edge.
746
+ */
747
+ const pageOfSectionRef = new Map<string, string>();
748
+ plan.pages.forEach((page, pageIndex) => {
749
+ page.sections.forEach((section, sectionIndex) => {
750
+ const firstPage = pageOfSectionRef.get(section.sectionRef);
751
+ if (firstPage !== undefined && firstPage !== page.pageRef) {
752
+ context.addIssue({
753
+ code: 'custom',
754
+ message: `the section "${section.sectionRef}" is declared on pages "${firstPage}" and "${page.pageRef}"; a section ref names one section of the site, so name each after its page (e.g. "${page.pageRef.replace(WEBSITE_PAGE_REF_PREFIX, '')}-${section.sectionRef}")`,
755
+ path: ['pages', pageIndex, 'sections', sectionIndex, 'sectionRef'],
756
+ });
757
+ }
758
+ if (firstPage === undefined) pageOfSectionRef.set(section.sectionRef, page.pageRef);
759
+ });
760
+ });
761
+ /*
762
+ * A latest-posts list reads the blog's posts, and the posts live in the content collection the BLOG page's task
763
+ * sets up. A plan that lists posts and has no blog asks for a section nothing can fill.
764
+ */
765
+ if (!plan.pages.some((page) => page.kind === WebsitePageKind.BLOG)) {
766
+ plan.pages.forEach((page, pageIndex) => {
767
+ page.sections.forEach((section, sectionIndex) => {
768
+ if (section.kind === WebsiteSectionKind.LATEST_POSTS) {
769
+ context.addIssue({
770
+ code: 'custom',
771
+ message: `page "${page.pageRef}" lists the latest posts, and the plan has no BLOG page to hold them`,
772
+ path: ['pages', pageIndex, 'sections', sectionIndex, 'kind'],
773
+ });
774
+ }
775
+ });
776
+ });
777
+ }
778
+ });
779
+ export type WebsitePlan = z.infer<typeof WebsitePlanSchema>;
780
+ ```
781
+
782
+ ## Routes
783
+
784
+ ## Import Origins
785
+
786
+ - `@wildo-ai/saas-specifications`
787
+
788
+ ## Source Excerpts
789
+
790
+ ### Origin Package: `@wildo-ai/saas-specifications`
791
+
792
+ ```typescript
793
+ *
794
+ * A page's route, DERIVED from its kind and slug — never chosen per site, so every generated site has the same
795
+ * URL shape (`/product/<slug>`, `/solutions/<slug>`, `/pricing`) and nobody is asked to pick one.
796
+ */
797
+ export function websitePageRoutePath(page: Pick<WebsitePagePlan, 'pageRef' | 'kind'>): string {
798
+ const slug = page.pageRef.startsWith(WEBSITE_PAGE_REF_PREFIX) ? page.pageRef.slice(WEBSITE_PAGE_REF_PREFIX.length) : page.pageRef;
799
+ switch (page.kind) {
800
+ case WebsitePageKind.HOME:
801
+ return '/';
802
+ case WebsitePageKind.PRODUCT_OVERVIEW:
803
+ return '/product';
804
+ case WebsitePageKind.PRODUCT:
805
+ return `/product/${slug}`;
806
+ case WebsitePageKind.SOLUTION:
807
+ return `/solutions/${slug}`;
808
+ case WebsitePageKind.PRICING:
809
+ return '/pricing';
810
+ case WebsitePageKind.CONTACT:
811
+ return '/contact';
812
+ case WebsitePageKind.COMPANY:
813
+ return '/about';
814
+ case WebsitePageKind.TRUST:
815
+ return '/security';
816
+ case WebsitePageKind.BLOG:
817
+ return '/blog';
818
+ }
819
+ }
820
+ ```
821
+
822
+ ## Menu placement
823
+
824
+ ## Import Origins
825
+
826
+ - `@wildo-ai/saas-specifications`
827
+
828
+ ## Source Excerpts
829
+
830
+ ### Origin Package: `@wildo-ai/saas-specifications`
831
+
832
+ ```typescript
833
+ *
834
+ * Where a page sits in the site menu (`website/src/site-menu.ts`), DERIVED from the plan.
835
+ *
836
+ * | page kind | placement |
837
+ * |---|---|
838
+ * | HOME | none — the brand mark links home |
839
+ * | PRODUCT | an item of the `product` panel, group `product` |
840
+ * | PRODUCT_OVERVIEW | the `product` panel's overview link; a direct `product` link when the panel has no item (no page of a `WEBSITE_PRODUCT_PANEL_ITEM_KINDS` kind) |
841
+ * | SOLUTION | an item of the `solutions` panel, in the group of its axis (`by-role`, `by-industry`, …) |
842
+ * | TRUST | an item of the `product` panel, group `trust` — security is asked about beside the product it protects |
843
+ * | PRICING, BLOG, COMPANY, CONTACT | a direct link (`pricing`, `blog`, `company`, `contact`) |
844
+ *
845
+ * Top-level order is fixed, and is `WebsiteMenuEntryRef`'s order: product, solutions, pricing, blog, company,
846
+ * contact.
847
+ */
848
+ export enum WebsiteMenuPlacementKind {
849
+ /** Not in the menu: the brand mark is the way home. */
850
+ BRAND = 'BRAND',
851
+ /** A direct top-level link. */
852
+ LINK = 'LINK',
853
+ /** An item inside a panel's group. */
854
+ PANEL_ITEM = 'PANEL_ITEM',
855
+ /** The footer link of a panel ("See the whole product"). */
856
+ PANEL_OVERVIEW = 'PANEL_OVERVIEW',
857
+ }
858
+
859
+ /** The top-level menu entries a plan can produce, in the order they appear. */
860
+ export enum WebsiteMenuEntryRef {
861
+ PRODUCT = 'product',
862
+ SOLUTIONS = 'solutions',
863
+ PRICING = 'pricing',
864
+ BLOG = 'blog',
865
+ COMPANY = 'company',
866
+ CONTACT = 'contact',
867
+ }
868
+
869
+ /** The top-level order a menu's entries take, as words an instruction can quote: `WebsiteMenuEntryRef`'s order. */
870
+ export const WEBSITE_MENU_ENTRY_ORDER: readonly WebsiteMenuEntryRef[] = Object.values(WebsiteMenuEntryRef);
871
+
872
+ /** The group a SOLUTION page joins under Solutions, per axis. Total over `WebsiteSolutionAxis`. */
873
+ export const WEBSITE_SOLUTION_AXIS_GROUP_REF: Readonly<Record<WebsiteSolutionAxis, string>> = {
874
+ [WebsiteSolutionAxis.ROLE]: 'by-role',
875
+ [WebsiteSolutionAxis.INDUSTRY]: 'by-industry',
876
+ [WebsiteSolutionAxis.USE_CASE]: 'by-use-case',
877
+ [WebsiteSolutionAxis.COMPANY_SIZE]: 'by-company-size',
878
+ };
879
+
880
+ /** The group every PRODUCT page joins in the product panel. */
881
+ export const WEBSITE_PRODUCT_GROUP_REF = 'product';
882
+
883
+ /** The group a TRUST page joins in the product panel: apart from the areas, because it answers a different question. */
884
+ export const WEBSITE_TRUST_GROUP_REF = 'trust';
885
+
886
+ /**
887
+ * The page kinds whose page becomes an ITEM of the Product panel: the product's areas and the page about trusting it.
888
+ * One source for the placement below and for every reader that asks whether the panel has items (the overview's own
889
+ * placement, the dispatch host's task ordering), so a kind added to the panel changes all of them at once. A plan with
890
+ * an overview and a security page but no product area used to link the overview directly while placing security in
891
+ * a panel that, by that rule, did not exist.
892
+ */
893
+ export const WEBSITE_PRODUCT_PANEL_ITEM_KINDS: readonly WebsitePageKind[] = [WebsitePageKind.PRODUCT, WebsitePageKind.TRUST];
894
+
895
+ export interface WebsitePageMenuPlacement {
896
+ readonly placement: WebsiteMenuPlacementKind;
897
+ /** The top-level entry; absent for BRAND. */
898
+ readonly entryRef?: WebsiteMenuEntryRef;
899
+ /** The group inside the panel, for PANEL_ITEM. */
900
+ readonly groupRef?: string;
901
+ /** The item's ref inside its group (the page slug), for PANEL_ITEM. */
902
+ readonly itemRef?: string;
903
+ /** The page's route, which the menu link carries. */
904
+ readonly routePath: string;
905
+ }
906
+
907
+ export function websitePageMenuPlacement(page: WebsitePagePlan, plan: WebsitePlan): WebsitePageMenuPlacement {
908
+ const routePath = websitePageRoutePath(page);
909
+ const slug = page.pageRef.slice(WEBSITE_PAGE_REF_PREFIX.length);
910
+ switch (page.kind) {
911
+ case WebsitePageKind.HOME:
912
+ return { placement: WebsiteMenuPlacementKind.BRAND, routePath };
913
+ case WebsitePageKind.PRODUCT:
914
+ return { placement: WebsiteMenuPlacementKind.PANEL_ITEM, entryRef: WebsiteMenuEntryRef.PRODUCT, groupRef: WEBSITE_PRODUCT_GROUP_REF, itemRef: slug, routePath };
915
+ case WebsitePageKind.PRODUCT_OVERVIEW:
916
+ return plan.pages.some((other) => WEBSITE_PRODUCT_PANEL_ITEM_KINDS.includes(other.kind))
917
+ ? { placement: WebsiteMenuPlacementKind.PANEL_OVERVIEW, entryRef: WebsiteMenuEntryRef.PRODUCT, routePath }
918
+ : { placement: WebsiteMenuPlacementKind.LINK, entryRef: WebsiteMenuEntryRef.PRODUCT, routePath };
919
+ case WebsitePageKind.SOLUTION:
920
+ return {
921
+ placement: WebsiteMenuPlacementKind.PANEL_ITEM,
922
+ entryRef: WebsiteMenuEntryRef.SOLUTIONS,
923
+ groupRef: WEBSITE_SOLUTION_AXIS_GROUP_REF[page.solutionAxis ?? WebsiteSolutionAxis.USE_CASE],
924
+ itemRef: slug,
925
+ routePath,
926
+ };
927
+ case WebsitePageKind.PRICING:
928
+ return { placement: WebsiteMenuPlacementKind.LINK, entryRef: WebsiteMenuEntryRef.PRICING, routePath };
929
+ case WebsitePageKind.COMPANY:
930
+ return { placement: WebsiteMenuPlacementKind.LINK, entryRef: WebsiteMenuEntryRef.COMPANY, routePath };
931
+ case WebsitePageKind.CONTACT:
932
+ return { placement: WebsiteMenuPlacementKind.LINK, entryRef: WebsiteMenuEntryRef.CONTACT, routePath };
933
+ case WebsitePageKind.TRUST:
934
+ return { placement: WebsiteMenuPlacementKind.PANEL_ITEM, entryRef: WebsiteMenuEntryRef.PRODUCT, groupRef: WEBSITE_TRUST_GROUP_REF, itemRef: slug, routePath };
935
+ case WebsitePageKind.BLOG:
936
+ return { placement: WebsiteMenuPlacementKind.LINK, entryRef: WebsiteMenuEntryRef.BLOG, routePath };
937
+ }
938
+ }
939
+ ```
940
+
941
+ ## Essentials per kind
942
+
943
+ ## Import Origins
944
+
945
+ - `@wildo-ai/saas-specifications`
946
+
947
+ ## Source Excerpts
948
+
949
+ ### Origin Package: `@wildo-ai/saas-specifications`
950
+
951
+ ```typescript
952
+ *
953
+ * The sections a page of each kind cannot do without: for each kind, a list of ALTERNATIVES groups, and the page
954
+ * must carry at least one kind from every group. Deliberately few — essentials, not a recipe: a product page must
955
+ * show how the product works and offer a next step; a solution page must name the problem before the product.
956
+ */
957
+ export const WEBSITE_PAGE_KIND_ESSENTIALS: Readonly<Record<WebsitePageKind, readonly (readonly WebsiteSectionKind[])[]>> = {
958
+ [WebsitePageKind.HOME]: [
959
+ [WebsiteSectionKind.PRODUCT_SHOWCASE, WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY, WebsiteSectionKind.HOW_IT_WORKS],
960
+ [WebsiteSectionKind.FOOTER_CTA, WebsiteSectionKind.CTA],
961
+ ],
962
+ [WebsitePageKind.PRODUCT_OVERVIEW]: [
963
+ [WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY, WebsiteSectionKind.PRODUCT_SHOWCASE],
964
+ [WebsiteSectionKind.FOOTER_CTA, WebsiteSectionKind.CTA],
965
+ ],
966
+ [WebsitePageKind.PRODUCT]: [
967
+ [WebsiteSectionKind.HOW_IT_WORKS, WebsiteSectionKind.FEATURE_DETAIL, WebsiteSectionKind.PRODUCT_SHOWCASE],
968
+ [WebsiteSectionKind.FOOTER_CTA, WebsiteSectionKind.CTA],
969
+ ],
970
+ [WebsitePageKind.SOLUTION]: [
971
+ [WebsiteSectionKind.PROBLEM],
972
+ [WebsiteSectionKind.FEATURE_DETAIL, WebsiteSectionKind.HOW_IT_WORKS, WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY],
973
+ [WebsiteSectionKind.FOOTER_CTA, WebsiteSectionKind.CTA],
974
+ ],
975
+ [WebsitePageKind.PRICING]: [[WebsiteSectionKind.PRICING]],
976
+ [WebsitePageKind.CONTACT]: [[WebsiteSectionKind.CONTACT]],
977
+ [WebsitePageKind.COMPANY]: [],
978
+ // A security page describes the controls: one of them argued, or all of them summarised, or their figures.
979
+ [WebsitePageKind.TRUST]: [[WebsiteSectionKind.FEATURE_DETAIL, WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY, WebsiteSectionKind.STATS]],
980
+ [WebsitePageKind.BLOG]: [[WebsiteSectionKind.LATEST_POSTS]],
981
+ };
982
+ ```