@wildo-ai/framework-knowledge 1.1.9 → 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 (1163) 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/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  5. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  6. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  8. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  9. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  10. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  11. package/dist/esm/framework-knowledge.definitions.js +543 -80
  12. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  13. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  14. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  15. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  16. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  17. package/dist/esm/index.d.ts +2 -0
  18. package/dist/esm/index.d.ts.map +1 -1
  19. package/dist/esm/index.js +2 -0
  20. package/dist/esm/index.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  22. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +138 -21
  27. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +89 -9
  41. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +6 -5
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +6 -4
  45. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  53. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +28 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
  57. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  69. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  73. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -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 +11 -9
  79. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  81. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  83. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  85. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  87. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.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.definition/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  94. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +34 -7
  96. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  100. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  101. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  102. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +14 -6
  104. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  107. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  109. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  111. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  113. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  114. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  115. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  116. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +15 -3
  118. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  119. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  120. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  121. package/dist/esm/source-anchor-grammar.js +114 -0
  122. package/dist/esm/source-anchor-grammar.js.map +1 -0
  123. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  124. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  125. package/dist/knowledge/manifest.json +8 -8
  126. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  127. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  128. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  129. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  130. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
  131. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
  132. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
  133. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  134. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  135. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  136. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  137. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
  138. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  139. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  140. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
  141. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
  142. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
  143. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
  144. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  145. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  147. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
  149. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  150. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
  151. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
  152. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  153. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  154. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
  155. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  156. package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
  157. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
  158. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  159. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
  160. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  161. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  162. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  163. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  164. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
  165. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  166. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  167. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  168. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  169. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  170. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  171. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  172. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  173. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  174. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  175. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  176. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
  177. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  178. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  180. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  181. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  182. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
  183. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  184. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
  185. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  186. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  187. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  188. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
  189. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  190. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  191. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  192. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  193. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  194. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  195. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  196. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  197. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  198. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  199. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  200. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
  201. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
  202. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  203. package/dist/knowledge/references/application-maturity.config.md +1 -1
  204. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  205. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  206. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  207. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  208. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  209. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  210. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  211. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  212. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  213. package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
  214. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  215. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  216. package/dist/knowledge/references/capability-composition.config.md +4 -3
  217. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  218. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  219. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  220. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  221. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  222. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  223. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  224. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  225. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  226. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  227. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
  228. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  229. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
  230. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  231. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  232. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  233. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  234. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  235. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  236. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  237. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  238. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  239. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  240. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  241. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  242. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  243. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  244. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  245. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  246. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  247. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  248. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  249. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  250. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  251. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  252. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  253. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  254. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  255. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  256. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  257. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  258. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  259. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  260. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  261. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  262. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
  263. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  264. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  265. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  266. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  267. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  268. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  269. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  270. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  271. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  272. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  273. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  274. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  275. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  276. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  277. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  278. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  279. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  280. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  281. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  282. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  283. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  284. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  285. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  286. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  287. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  288. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  289. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  290. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  291. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  292. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  293. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  294. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  295. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  296. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  297. package/dist/knowledge/references/experience-plan.config.md +76 -7
  298. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  299. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  300. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  301. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  302. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  303. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  304. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  305. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  306. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  307. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  308. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  309. package/dist/knowledge/references/integration-plan.config.md +21 -1
  310. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  311. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  312. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  313. package/dist/knowledge/references/placement-plan.config.md +107 -2
  314. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  315. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  316. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  317. package/dist/knowledge/references/platform.config.saas.md +106 -14
  318. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  319. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  320. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  321. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  322. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  323. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  324. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  325. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  326. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  327. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  328. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  329. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  330. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  331. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  332. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  333. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  334. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  335. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  336. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  337. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  338. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  339. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  340. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  341. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  342. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  343. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  344. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  345. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  346. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  348. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  349. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  350. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  351. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  352. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  353. package/dist/knowledge/references/saas.backend.email.send.md +84 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  355. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  358. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  359. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  360. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  361. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  363. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  364. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  365. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  366. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  367. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  368. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  369. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  370. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  371. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  372. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  373. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  374. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  375. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  376. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  377. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  378. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  380. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  381. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  382. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  383. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  384. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  385. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  386. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  387. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  388. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  389. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  390. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  391. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  392. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  393. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  394. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
  395. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  396. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  397. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  398. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  399. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  400. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  401. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  402. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
  403. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
  404. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
  405. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  406. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  407. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  408. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  409. package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
  410. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  411. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
  412. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
  413. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  414. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  415. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
  416. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  417. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  418. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  419. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  420. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  421. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  422. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  423. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  424. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  425. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  426. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  427. package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
  428. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  429. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  430. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  431. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  432. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  433. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  434. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  435. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  436. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  437. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  438. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  439. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  440. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  441. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  442. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  443. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  444. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  445. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  446. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  447. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  448. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  449. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  450. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  451. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  452. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  453. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  454. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  455. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  456. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  457. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  458. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  459. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  460. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  461. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  462. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  463. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  464. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  465. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  466. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  467. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  468. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  469. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  470. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  471. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  472. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  473. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
  474. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  475. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  476. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  477. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  478. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  479. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  480. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  481. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  482. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  483. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  484. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  485. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  486. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  487. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  488. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  489. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  490. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  491. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  492. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  493. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  494. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  495. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  496. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  497. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  498. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  499. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  500. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  501. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  502. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
  503. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  504. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  505. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  506. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  507. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  508. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  509. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  510. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  511. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  512. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  513. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  514. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  515. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  516. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  517. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  518. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  519. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  520. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  521. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  522. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  523. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  524. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  525. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  526. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  527. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  528. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  529. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  530. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  531. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  532. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  533. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  534. package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
  535. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  536. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  537. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  538. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  539. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  540. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  541. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  542. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  543. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  544. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  545. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  546. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  547. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  548. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  549. package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
  550. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  551. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  552. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  553. package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
  554. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  555. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  556. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  557. package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
  558. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  559. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  560. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  561. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  562. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  563. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  564. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  565. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  566. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  567. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  568. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  569. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  570. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  571. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  572. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  573. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  574. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  575. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  576. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  577. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  578. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  579. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  580. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  581. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  582. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  583. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  584. package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
  585. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  586. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  587. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  588. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  589. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  590. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  591. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  592. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  593. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  594. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  595. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  596. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  597. package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
  598. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  599. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  600. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  601. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  602. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  603. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  604. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  605. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  606. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  607. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  608. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  609. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  610. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  611. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  612. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  613. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  614. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  615. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  616. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  617. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  618. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  619. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  620. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  621. package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
  622. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  623. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  624. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  625. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  626. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  627. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  628. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  629. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  630. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  631. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  632. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  633. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  634. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  635. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  636. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  637. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  638. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  639. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  640. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  641. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  642. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  643. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  644. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  645. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  646. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  647. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  648. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  649. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  650. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  651. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  652. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  653. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  654. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  655. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  656. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  657. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  658. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  659. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  660. package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
  661. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  662. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  663. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  664. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  665. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  666. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  667. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  668. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  669. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  670. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  671. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  672. package/dist/knowledge/references/service-method.config.md +270 -0
  673. package/dist/knowledge/references/website-plan.config.md +561 -23
  674. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  675. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  676. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  677. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  678. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
  679. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  680. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  681. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
  682. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  683. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  684. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  685. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  686. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  687. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  688. package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
  689. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
  690. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  691. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  692. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
  693. package/dist/knowledge/references/zod.factories.code.md +18 -8
  694. package/dist/knowledge/references/zod.factories.duration.md +23 -13
  695. package/dist/knowledge/references/zod.factories.money.md +24 -14
  696. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  697. package/dist/knowledge/references/zod.factories.range.md +5 -1
  698. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  699. package/dist/knowledge/registries/framework-topics.json +2854 -246
  700. package/dist/knowledge/registries/playbooks.json +57 -36
  701. package/dist/knowledge/registries/source-tags.json +8863 -4569
  702. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  703. package/dist/knowledge/rules/live-context-door.md +1 -1
  704. package/dist/knowledge/skills/INDEX.md +63 -34
  705. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  706. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  707. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  708. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  709. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  710. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  711. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  712. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  713. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  714. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  715. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  716. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  717. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  718. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  719. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  720. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  721. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  722. package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
  723. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  724. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  725. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  726. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  727. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
  728. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  729. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  730. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  731. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  732. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
  733. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  734. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  735. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
  736. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  737. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  738. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  739. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  740. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  741. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  742. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
  743. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  744. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  745. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  746. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  747. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  748. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  749. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  750. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  751. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  752. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  753. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
  754. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  755. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  756. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  757. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  758. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  759. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  760. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  761. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  762. package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
  763. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  764. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  765. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  766. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  767. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
  768. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
  769. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  770. package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
  771. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  772. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  773. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  774. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  775. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  776. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  777. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  778. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  779. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  780. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  781. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  782. package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
  783. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
  784. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
  785. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  786. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  787. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  788. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  789. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  790. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  791. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  792. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  793. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  794. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
  795. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  796. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  797. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  798. package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
  799. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  800. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  801. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  802. package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
  803. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  804. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
  805. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  806. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  807. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  808. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  809. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  810. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  811. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  812. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  813. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  814. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  815. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  816. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  817. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  818. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
  819. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  820. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  821. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  822. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  823. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  824. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  825. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  826. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  827. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  828. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  829. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  830. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  831. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  832. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  833. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  834. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  835. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  836. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  837. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
  838. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  839. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  840. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  841. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
  842. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
  843. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
  844. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  845. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  846. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  847. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  848. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
  849. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
  850. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  851. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  852. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  853. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  854. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  855. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  856. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  857. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  858. package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
  859. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  860. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  861. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  862. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  863. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  864. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  865. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  866. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  867. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  868. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  869. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  870. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  871. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  872. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  873. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  874. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  875. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  876. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  877. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  878. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  879. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  880. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
  881. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
  882. package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
  883. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
  884. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  885. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  886. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  887. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  888. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  889. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  890. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  891. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  892. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  893. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  894. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  895. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  896. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  897. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  898. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  899. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
  900. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  901. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  902. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  903. package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
  904. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  905. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  906. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  907. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  908. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  909. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  910. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  911. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  912. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  913. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  914. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  915. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  916. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  917. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  918. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  919. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
  920. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  921. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  922. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  923. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  924. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  925. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  926. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  927. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  928. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  929. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
  930. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  931. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  932. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  933. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  934. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
  935. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  936. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  937. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  938. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  939. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  940. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  941. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
  942. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  943. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  944. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  945. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
  946. package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
  947. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
  948. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  949. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  950. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
  951. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  952. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  953. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
  954. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  955. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
  956. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  957. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
  958. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  959. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  960. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  961. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  962. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
  963. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  964. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  965. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
  966. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  967. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  968. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
  969. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  970. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  971. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  972. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
  973. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  974. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  975. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  976. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  977. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  978. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  979. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  980. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  981. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  982. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  983. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  984. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  985. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  986. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  987. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  988. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  989. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  990. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  991. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  992. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
  993. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  994. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  995. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
  996. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  997. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
  998. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  999. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  1000. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
  1001. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  1002. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  1003. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  1004. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
  1005. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  1006. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
  1007. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  1008. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
  1009. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  1010. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  1011. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  1012. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  1013. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
  1014. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
  1015. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  1016. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  1017. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  1018. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
  1019. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  1020. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  1021. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  1022. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  1023. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  1024. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  1025. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  1026. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  1027. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  1028. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  1029. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  1030. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  1031. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  1032. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  1033. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  1034. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
  1035. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
  1036. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  1037. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  1038. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  1039. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  1040. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  1041. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
  1042. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  1043. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  1044. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  1045. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  1046. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  1047. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  1048. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  1049. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
  1050. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
  1051. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  1052. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  1053. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  1054. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
  1055. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  1056. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
  1057. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
  1058. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  1059. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
  1060. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
  1061. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
  1062. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  1063. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  1064. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  1065. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  1066. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  1067. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
  1068. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  1069. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  1070. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
  1071. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
  1072. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
  1073. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  1074. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  1075. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
  1076. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
  1077. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  1078. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  1079. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  1080. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
  1081. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  1082. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
  1083. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  1084. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
  1085. package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
  1086. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  1087. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
  1088. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  1089. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  1090. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  1091. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
  1092. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  1093. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  1094. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  1095. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  1096. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  1097. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  1098. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  1099. package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
  1100. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1101. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1102. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
  1103. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1104. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
  1105. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1106. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1107. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1108. package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
  1109. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1110. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1111. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1112. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1113. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1114. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1115. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1116. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1117. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1118. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1119. package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
  1120. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1121. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1122. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1123. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1124. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1125. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1126. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1127. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1128. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1129. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1130. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1131. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1132. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1133. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1134. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
  1135. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1136. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1137. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1138. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1139. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1140. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1141. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1142. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1143. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
  1144. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1145. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
  1146. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
  1147. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1148. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1149. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1150. package/dist/knowledge/topic-index.json +17305 -8263
  1151. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1152. package/package.json +4 -4
  1153. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1154. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1155. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1156. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1157. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1158. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1159. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1160. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1161. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1162. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1163. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: website-section-cta
3
- description: Author a mid-page call-to-action band using `defineWebsiteSection({ category: WebsiteSectionCategory.CTA, … })`. Use when the user says "add a CTA section", "write a 'sign up' band", "compose a mid-page CTA with headline + button", or "customize the conversion CTA layout".
3
+ description: Author a mid-page call-to-action band by configuring the engine's `websiteCtaBandBlock` (`websiteCtaBandBlock.section({ category: WebsiteSectionCategory.CTA, config })`) on a lighter tone than the page's close, its actions pointed by `WebsiteLinkTo`, its words derived from the config. Use when the user says "add a CTA section", "write a 'sign up' band", "compose a mid-page CTA with headline + button", or "customize the conversion CTA layout".
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -20,15 +20,16 @@ Read and apply these patterns from the application-developer point of view:
20
20
 
21
21
  # Website Section — Authoring API (source-backed)
22
22
 
23
- Shared API excerpts for every `website_section_<category>` skill. The
23
+ Shared API excerpts for every `website-section-<category>` skill. The
24
24
  contract is identical across categories; the per-category guidance lives
25
25
  in each skill's own `SKILL.md`.
26
26
 
27
27
  ## Category vocabulary (closed enum)
28
28
 
29
- The `category` field on `defineWebsiteSection` is a closed enum, not a
30
- free string. Adding a new value requires seeding a matching
31
- `website_section_<value>` skill folder (1:1 invariant).
29
+ The `category` of a section (`category` in `block.section(...)`) is a closed enum, not a
30
+ free string. Adding a new value requires a matching
31
+ `website-section-<value>` skill (`RAW` is covered by
32
+ `website-factory-advanced`).
32
33
 
33
34
  ## Import Origins
34
35
 
@@ -68,8 +69,9 @@ free string. Adding a new value requires seeding a matching
68
69
  * (`website-factory-advanced` skill) which bypasses the category
69
70
  * vocabulary entirely.
70
71
  *
71
- * **Adding a value**: requires (a) a new entry here and (b) a matching
72
- * `website_section_<value>` skill stub. Removing a value
72
+ * **Adding a value**: requires (a) a new entry here, (b) the matching member of
73
+ * the website plan's `WebsiteSectionKind`, and (c) its `website-section-<value>`
74
+ * skill, which `WEBSITE_SECTION_SKILL_REF` must name or the plan does not compile. Removing a value
73
75
  * is a labelled rename — every consumer's
74
76
  * `defineWebsiteSection({ category: … })` declaration breaks at compile
75
77
  * time, which is the desired loud failure.
@@ -84,6 +86,24 @@ export enum WebsiteSectionCategory {
84
86
  SOCIAL_PROOF = 'social-proof',
85
87
  FAQ = 'faq',
86
88
  FOOTER_CTA = 'footer-cta',
89
+ /** The problem the audience lives with, before any product appears (a solution page's opening argument). */
90
+ PROBLEM = 'problem',
91
+ /** How it works, in three or four steps. */
92
+ HOW_IT_WORKS = 'how-it-works',
93
+ /** The product itself, shown: its real interface framed, a bento of key screens, or tabs across its views. */
94
+ PRODUCT_SHOWCASE = 'product-showcase',
95
+ /** One card per audience, each linking to the solution page written for it. */
96
+ SOLUTION_PATHS = 'solution-paths',
97
+ /** The product against the alternatives, honestly. */
98
+ COMPARISON = 'comparison',
99
+ /** Facts about the product as figures, each one a value the application declares. */
100
+ STATS = 'stats',
101
+ /** The systems the product connects to, by name, each one a provider or protocol the application declares. */
102
+ INTEGRATIONS = 'integrations',
103
+ /** The newest posts of the site's blog, read from the posts' own frontmatter. */
104
+ LATEST_POSTS = 'latest-posts',
105
+ /** What has shipped and what is next, as the application's roadmap declares it. */
106
+ ROADMAP = 'roadmap',
87
107
  /**
88
108
  * Escape hatch for sections that don't fit any standard category
89
109
  * (third-party widgets, custom one-off marketing pieces). Authors should
@@ -105,8 +125,9 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
105
125
  The schema declares the **observable contract** the page-manifest
106
126
  registration, the label-pack validator, `renderPageStructuredData` and
107
127
  the structured-data audit depend on. The
108
- factory layer adds type-preserving generics on top so JSX usage keeps
109
- compile-time prop checking.
128
+ factory adds what the schema cannot express: `Component` takes no props
129
+ (the page mounts it as `<Component />`), so a component that requires
130
+ one is refused at compile time.
110
131
 
111
132
  ## Import Origins
112
133
 
@@ -119,28 +140,29 @@ compile-time prop checking.
119
140
  ```typescript
120
141
  *
121
142
  * `WebsiteSectionDefinition` — the runtime contract returned by the
122
- * `defineWebsiteSection({ … })` factory (authored as a separate
123
- * `core/define-website-section.tsx` module in Phase 2 because it carries
124
- * React types in its inputs). The shape is declared in `schemas/`
125
- * because it is the **observable contract** the page-manifest
143
+ * `defineWebsiteSection({ … })` factory (which lives apart from this
144
+ * schema because its input carries React types). The shape is declared
145
+ * with the schemas because it is the **observable contract** the page-manifest
126
146
  * registration, the label-pack validator, `renderPageStructuredData` and the
127
147
  * structured-data audit depend on.
128
148
  *
129
- * **Shape rationale** (each field carries semantic weight — see
130
- * `design-philosophy.mdc`):
149
+ * **Shape rationale** (each field carries semantic weight):
131
150
  *
132
- * - `sectionRef` — the section's identity inside its hosting page.
133
- * Uniqueness is enforced **per page** at manifest registration time
134
- * (a section can be reused with the same `sectionRef` across pages
135
- * when its label-key root is intentionally shared).
151
+ * - `sectionRef` — the section's identity across the SITE. The build
152
+ * collects every section by its ref (`collectExpectedLabelKeysFromSections`)
153
+ * and refuses two sections that share one with different label keys,
154
+ * which two pages' sections always have (each key is rooted at its own
155
+ * page). So a ref names its page when two pages would share one
156
+ * (`landing-hero`, `pricing-hero`); the manifest registry additionally
157
+ * refuses a ref listed twice on one page.
136
158
  * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
137
159
  * for skill-mapping and analytics labelling. It does NOT select the
138
160
  * section's structured data.
139
161
  * - `expectedLabelKeys` — the **fully-composed** label keys the section
140
- * commits to consuming. The plan originally proposed leaf-relative
141
- * keys (`'headline'`) resolved at runtime against the
142
- * page+section context, but storing the fully-composed key on the
143
- * definition has three concrete benefits:
162
+ * commits to consuming. Leaf-relative keys (`'headline'`) resolved at
163
+ * runtime against the page+section context would also work, but
164
+ * storing the fully-composed key on the definition has three concrete
165
+ * benefits:
144
166
  * 1. The label-pack validator (`validateLabelPackAgainstManifest`)
145
167
  * runs as a pure function with no need to walk the JSX tree at
146
168
  * build time to discover the leaf-to-key resolution.
@@ -163,15 +185,15 @@ compile-time prop checking.
163
185
  * valid HTML id that is also URL-fragment-safe: a letter, then
164
186
  * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
187
  * to keep, like the id attribute it becomes.
166
- * - `Component` — the React component that renders the section. Typed
167
- * as `ComponentType<unknown>` here because schema-layer cannot lock
168
- * the component's prop shape (props vary per section). The factory
169
- * function (`defineWebsiteSection<TProps>(…)`) preserves the precise
170
- * prop type at the consumer call site via generics; this schema only
171
- * guards the runtime shape of "is callable as a React component".
188
+ * - `Component` — the React component that renders the section. The
189
+ * page mounts it with NO props (`<WebsitePageSections>`), which the
190
+ * factory (`defineWebsiteSection`, `WebsiteSectionComponentProps`) enforces at
191
+ * compile time; this schema only guards the runtime shape of "is
192
+ * callable as a React component".
172
193
  * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
173
- * builder library invokes at static-build time to materialize JSON-LD
174
- * for the section. The return type is intentionally `unknown` here;
194
+ * builder library invokes on the server to materialize JSON-LD for the
195
+ * section, handing it the page it renders on (`WebsiteStructuredDataContext`).
196
+ * The return type is intentionally `unknown` here;
175
197
  * nothing narrows it by `category` — the section returns whatever
176
198
  * vocabulary it emits, and `wildo website audit` reconciles that
177
199
  * against the application's Schema.org catalog.
@@ -202,25 +224,23 @@ export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSch
202
224
  /**
203
225
  * Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
204
226
  * `getStructuredData` are typed precisely on the factory return type
205
- * (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred
227
+ * (`defineWebsiteSection`); the schema-inferred
206
228
  * type is the lowest common denominator used at the persistence /
207
229
  * validation boundary only.
208
230
  *
209
231
  * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
210
232
  * React component props are CONTRAVARIANT in `ComponentType<T>` —
211
- * a narrower `ComponentType<{ foo: string }>` is NOT assignable to
212
- * `ComponentType<unknown>` (because a caller could pass an `unknown`
213
- * the narrower component cannot accept). This made every consumer
214
- * who built sections via `defineWebsiteSection<TProps>(…)` unable
215
- * to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to
216
- * helpers typed against the bare `WebsiteSectionDefinition` —
217
- * collectors, validators, and registries. Using `any` here is the
218
- * exact escape hatch the React typings themselves use for
219
- * heterogeneous component containers (`React.forwardRef`,
220
- * `React.lazy`'s internal component slot, etc.) and matches the
221
- * runtime contract: the framework NEVER instantiates these
222
- * components directly with arbitrary props — the consumer's JSX
223
- * supplies the right props at the call site.
233
+ * the factory's `ComponentType<WebsiteSectionComponentProps>` is NOT
234
+ * assignable to `ComponentType<unknown>` (because a caller could pass
235
+ * an `unknown` the narrower component cannot accept). That would stop
236
+ * every `TypedWebsiteSectionDefinition` from reaching the helpers typed
237
+ * against the bare `WebsiteSectionDefinition` — collectors, validators,
238
+ * and registries. `any` is the escape hatch the React typings
239
+ * themselves use for heterogeneous component containers
240
+ * (`React.forwardRef`, `React.lazy`'s internal component slot, etc.).
241
+ * It widens nothing at runtime: the page mounts every section
242
+ * component as `<Component />`, with no props, and
243
+ * `defineWebsiteSection` refuses a component that requires one.
224
244
  */
225
245
  export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
226
246
  Component: ComponentType<any>;
@@ -235,23 +255,76 @@ export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSection
235
255
  * optional fields per entity; locking them in TS would be both
236
256
  * impractical and brittle as Schema.org evolves). The companion
237
257
  * catalog reconciliation surface catches missing-required and
238
- * deprecated-field-used at the SEMANTIC layer (warning-only per
239
- * D-AG4), so the runtime type stays loose.
258
+ * deprecated-field-used at the SEMANTIC layer (warnings; failures
259
+ * under `wildo website audit --strict`), so the runtime type stays loose.
240
260
  *
241
261
  * Returns `null`, `undefined`, or `[]` when the section has no
242
262
  * structured-data contribution for the current state — the
243
263
  * renderer short-circuits all three.
264
+ *
265
+ * **The context** (`WebsiteStructuredDataContext`): the page's locale,
266
+ * refs, route and origin, and `label(slot)` — the section's own words
267
+ * in that locale. Structured data restates what the section shows, so a
268
+ * section with words (an FAQ, a product description) reads them here,
269
+ * once per locale and on the server only, rather than hard-coding one
270
+ * language or importing every locale's pack into the browser bundle. A
271
+ * function that declares no parameter is still accepted: a payload with
272
+ * no words (a site-wide `Organization` id) needs no context.
244
273
  */
245
- getStructuredData?: () => WebsiteStructuredDataReturn;
274
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
246
275
  }
247
276
  ```
248
277
 
249
- ## `defineWebsiteSection<TProps>` factory
250
-
251
- Always use the factory — never build a `WebsiteSectionDefinition`
252
- literal by hand. The factory parses inputs through the schema (single
253
- audited validation chokepoint) AND preserves the caller's `TProps` so
254
- JSX composition stays strongly typed.
278
+ ## Structured data reads the section's words through its context
279
+
280
+ `getStructuredData` receives the page the section is published on, a
281
+ `WebsiteStructuredDataContext` (from `@wildo-ai/saas-website`), and runs
282
+ on the server only:
283
+
284
+ - `label(slot)` — the section's word for `slot` in the page's locale,
285
+ the key `useWebsiteLabel(slot)` reads in the component. It throws when
286
+ the locale's pack has no word, so a raw key is never published.
287
+ - `pageUrl` — the page's URL in this locale, for `url` and `@id`;
288
+ `siteOrigin` — the site's public origin, for site-wide `@id`s;
289
+ `locale` — for `inLanguage`.
290
+
291
+ A word the section shows reaches its JSON-LD only through `label(slot)`:
292
+ never typed into the payload (one language on every locale's page) and
293
+ never read from a label pack imported into the sections file (every
294
+ visitor downloads the pack). A payload with no words may keep
295
+ `() => …`. The route passes the context
296
+ (`renderPageStructuredData({ sections, context: runtime.structuredData })`),
297
+ and `wildo website audit` checks every route a page is published at, in
298
+ that route's locale, as the page renders it. The full contract is in the `website-seo-aeo-geo` skill.
299
+
300
+ ## How a section is defined: a configured block
301
+
302
+ When the section comes from the website plan, its `design` already names the block, its layout, its surface and what
303
+ its demo shows, and says whether it is the page's signature section. Build what it names; the guidance below is for
304
+ the fields the plan left open. When the section is built, look at it: `wildo website look <route> --all-locales`
305
+ photographs the page in every locale the site serves, at a desktop and a phone width, and runs an accessibility pass; judge the pictures against the
306
+ `website-building-blocks` skill's `references/website-visual-quality-rubric.md` and fix every violation it lists.
307
+
308
+ A section is almost always one of the engine's blocks, CONFIGURED:
309
+ `websiteHeroBlock.section({ pageRef, sectionRef, category, config })`,
310
+ `websiteCardGridBlock.section({ …, band, intro, config })`. The block
311
+ renders `config` (its props), and the section's words are derived from
312
+ the same `config`, so a section cannot declare a word it does not render.
313
+ `band` and `intro` are accepted only by the blocks that take them, and
314
+ `nodeSlots` declares the words a node inside the config reads (a drawing,
315
+ a form). A section no engine block covers is a block of the site's own,
316
+ `defineWebsiteBlock({ surface, heading, slots, Component })`, with the
317
+ same `.section(...)`. Pricing is the one exception: its words follow the
318
+ plans the catalogue publishes, so it is declared with
319
+ `defineWebsiteBlockSection` and `websitePricingSlots`. The
320
+ `website-building-blocks` skill lists every block and what each takes.
321
+
322
+ Underneath, every one of these calls the `defineWebsiteSection` factory
323
+ below. Never build a `WebsiteSectionDefinition` literal by hand: the
324
+ factory parses inputs through the schema (single audited validation
325
+ chokepoint) and types `Component` as taking NO props
326
+ (`WebsiteSectionComponentProps`), since the page mounts each section as
327
+ `<Component />`. A configured block binds its config for you.
255
328
 
256
329
  ## Import Origins
257
330
 
@@ -263,11 +336,18 @@ JSX composition stays strongly typed.
263
336
 
264
337
  ```typescript
265
338
  *
266
- * Input shape consumed by `defineWebsiteSection<TProps>`. Mirrors
267
- * `WebsiteSectionDefinition` but keeps `Component` typed against the
268
- * caller-supplied generic so the precise prop shape survives end-to-end
269
- * (the consumer's `<HeroSection />` JSX can keep its strongly-typed
270
- * props after going through the factory).
339
+ * The props a section component receives: NONE. A page renders its sections through
340
+ * `<WebsitePageSections>`, which mounts each one as `<Component />` — nothing composes a section with props. A
341
+ * component that requires one is therefore refused by `defineWebsiteSection` at compile time; before this type, it
342
+ * compiled and then read `undefined` on the live page. A section reads what it
343
+ * shows from its labels (`useWebsiteLabel`), the page runtime (`useWebsiteRuntime`) and module constants; a variant of
344
+ * a shared body or block is BOUND in the definition (`Component: () => <WebsiteHero layout={WebsiteHeroLayout.STAGE} visual={<ProductShot />} />`).
345
+ */
346
+ export type WebsiteSectionComponentProps = Record<string, never>;
347
+
348
+ /**
349
+ * Input shape consumed by `defineWebsiteSection`. Mirrors `WebsiteSectionDefinition`, with `Component` a component
350
+ * that takes no props (`WebsiteSectionComponentProps`): one that requires a prop is refused at compile time.
271
351
  *
272
352
  * **String inputs vs. branded inputs**: `sectionRef` and
273
353
  * `expectedLabelKeys` accept raw strings as well as already-branded
@@ -276,7 +356,7 @@ JSX composition stays strongly typed.
276
356
  * ergonomic drag of forcing every section author to remember to call
277
357
  * `WebsiteSectionRefSchema.parse(...)` in their definition.
278
358
  */
279
- export interface DefineWebsiteSectionInput<TProps> {
359
+ export interface DefineWebsiteSectionInput<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps> {
280
360
  sectionRef: WebsiteSectionRef | string;
281
361
  category: WebsiteSectionCategory;
282
362
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
@@ -286,32 +366,24 @@ export interface DefineWebsiteSectionInput<TProps> {
286
366
  /**
287
367
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
288
368
  * full authoring contract. The factory passes the function through
289
- * unchanged; the framework invokes it at static-build time and
290
- * forwards the return value to `renderPageStructuredData()`.
369
+ * unchanged; `renderPageStructuredData()` invokes it on the server with
370
+ * the page's `WebsiteStructuredDataContext`.
291
371
  */
292
- getStructuredData?: () => WebsiteStructuredDataReturn;
372
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
293
373
  }
294
374
 
295
375
  /**
296
- * Return shape of `defineWebsiteSection<TProps>`. Identical to
297
- * `WebsiteSectionDefinition` except `Component` retains the
298
- * caller-supplied generic prop shape rather than the schema's
299
- * lowest-common-denominator `ComponentType<unknown>`.
300
- *
301
- * **Why this matters**: a consumer's `pageComponent` JSX composes
302
- * sections like `<HERO_SECTION.Component {...heroProps} />`. Without
303
- * preserving `TProps`, the spread would be untyped and a renamed prop
304
- * would silently miss the type system. With `TProps` preserved, the
305
- * call site fails to compile the moment the prop contract drifts.
376
+ * Return shape of `defineWebsiteSection`. Identical to `WebsiteSectionDefinition` except `Component` is typed as the
377
+ * prop-less component it is, rather than the schema's lowest-common-denominator `ComponentType<any>`.
306
378
  */
307
- export interface TypedWebsiteSectionDefinition<TProps>
379
+ export interface TypedWebsiteSectionDefinition<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>
308
380
  extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
309
381
  Component: ComponentType<TProps>;
310
- getStructuredData?: () => WebsiteStructuredDataReturn;
382
+ getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
311
383
  }
312
384
 
313
385
  /**
314
- * `defineWebsiteSection<TProps>` — factory that materializes a
386
+ * `defineWebsiteSection` — factory that materializes a
315
387
  * `WebsiteSectionDefinition` from authored input.
316
388
  *
317
389
  * **Two responsibilities**, one entry point:
@@ -319,9 +391,11 @@ export interface TypedWebsiteSectionDefinition<TProps>
319
391
  * `WebsiteSectionDefinitionSchema` so brand checks, regex
320
392
  * validations, and array refinements run at module load time
321
393
  * (not at render time, not at build-output time).
322
- * 2. Type preservation — returns an object whose `Component` field
323
- * keeps the caller-supplied `TProps`, so JSX usage of the
324
- * returned section retains compile-time prop checking.
394
+ * 2. The props contract — `Component` takes no props, because the
395
+ * page mounts it as `<Component />`. A component that requires a
396
+ * prop fails to compile here rather than reading `undefined` live.
397
+ * The type parameter exists so an explicit type argument equal to
398
+ * `WebsiteSectionComponentProps` stays valid; it cannot be widened.
325
399
  *
326
400
  * **Why a factory instead of constructing the literal directly**:
327
401
  * - Consumers don't have to remember to parse refs / keys
@@ -329,25 +403,22 @@ export interface TypedWebsiteSectionDefinition<TProps>
329
403
  * - The schema parse provides a single audited validation chokepoint,
330
404
  * and the parsed `expectedLabelKeys` are what `wildo website audit`
331
405
  * checks every locale pack against, without re-entering the React graph.
332
- * - The factory is the documented authoring API the
333
- * `website_factory_authoring` skill targets — keeping the
406
+ * - The factory is the documented authoring API every
407
+ * `website-section-*` skill teaches — keeping the
334
408
  * authoring surface narrow lets the framework evolve the
335
409
  * internal schema (add fields, refinements) without churning
336
410
  * every section definition in every consumer app.
337
411
  *
338
412
  * @param input section authoring input (see `DefineWebsiteSectionInput`).
339
- * @returns a `TypedWebsiteSectionDefinition<TProps>` with `Component`
340
- * preserved at the precise prop type.
413
+ * @returns a `TypedWebsiteSectionDefinition` whose `Component` takes no props.
341
414
  *
342
415
  * @example
343
- * interface HeroProps {
344
- * headlineKey: WebsiteLabelKey;
345
- * subheadlineKey: WebsiteLabelKey;
346
- * }
347
- * function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
416
+ * function HeroSection() {
417
+ * const headline = useWebsiteLabel('headline');
418
+ * const subheadline = useWebsiteLabel('subheadline');
348
419
  * // …
349
420
  * }
350
- * export const HERO_SECTION = defineWebsiteSection<HeroProps>({
421
+ * export const HERO_SECTION = defineWebsiteSection({
351
422
  * sectionRef: 'hero',
352
423
  * category: WebsiteSectionCategory.HERO,
353
424
  * expectedLabelKeys: [
@@ -357,7 +428,7 @@ export interface TypedWebsiteSectionDefinition<TProps>
357
428
  * Component: HeroSection,
358
429
  * });
359
430
  */
360
- export function defineWebsiteSection<TProps>(
431
+ export function defineWebsiteSection<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>(
361
432
  input: DefineWebsiteSectionInput<TProps>,
362
433
  ): TypedWebsiteSectionDefinition<TProps> {
363
434
  const parsed = WebsiteSectionDefinitionSchema.parse({
@@ -370,8 +441,8 @@ export function defineWebsiteSection<TProps>(
370
441
  });
371
442
  /**
372
443
  * Re-attach `Component` and `getStructuredData` from the original
373
- * input so the precise generic types survive — `parsed.Component`
374
- * is `unknown` per the schema's `z.unknown()` contract.
444
+ * input so they keep their declared types — `parsed.Component` is
445
+ * `unknown` per the schema's `z.unknown()` contract.
375
446
  */
376
447
  return {
377
448
  sectionRef: parsed.sectionRef,
@@ -388,9 +459,12 @@ export function defineWebsiteSection<TProps>(
388
459
 
389
460
  Inside the section's React component, always read labels via
390
461
  `useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
391
- ambient page+section context to produce the fully-qualified
392
- `WebsiteLabelKey` and validates it against the section's
393
- `expectedLabelKeys` declaration.
462
+ ambient page+section context into the fully-qualified `WebsiteLabelKey`
463
+ and looks it up in the page's label pack; a missing word logs a warning
464
+ and renders the raw key. It does not consult `expectedLabelKeys`: the
465
+ build checks every locale pack against the keys the section DECLARES
466
+ there, so a key the component reads without declaring it is never
467
+ checked — declare every slot it reads.
394
468
 
395
469
  ## Import Origins
396
470
 
@@ -412,10 +486,12 @@ ambient page+section context to produce the fully-qualified
412
486
  * **Author ergonomics**: section authors call
413
487
  * `useWebsiteLabel('headline')` from inside their section component
414
488
  * without ever typing the page or section ref — the hook reads them
415
- * from context. This keeps section components portable across pages
416
- * (the same `<HeroSection />` can be reused on `landing` and on a
417
- * dedicated `/about` page; only the surrounding `<WebsiteSection
418
- * sectionRef="hero">` differs, and the label keys re-root accordingly).
489
+ * from the context the page layout and the surrounding `<WebsiteSection>`
490
+ * provide. The keys therefore follow the page a section renders on, while
491
+ * the section's declared `expectedLabelKeys` name one page: a section
492
+ * belongs to one page, and the website plan refuses a section ref
493
+ * declared on two. Share the BLOCK (a component reading slots) between
494
+ * pages, and give each page its own section around it.
419
495
  *
420
496
  * **Fail-loud diagnostics** for missing keys: returns the composed key
421
497
  * itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
@@ -478,8 +554,8 @@ export function useWebsiteLabel(slotPath: string): string {
478
554
  The framework's `<WebsiteSection>` wrapper is what the page composition
479
555
  mounts to host a section's component. It provides
480
556
  `WebsiteSectionContext`, renders a semantic `<section>` with
481
- `data-section-ref` and `data-section-category`, and forwards a11y
482
- pass-throughs (`aria-labelledby`, `role`, etc.).
557
+ `data-section-ref` and `data-section-category`, and forwards the a11y
558
+ pass-throughs it declares (`ariaLabel`, `ariaLabelledBy`).
483
559
 
484
560
  ## Import Origins
485
561
 
@@ -505,10 +581,11 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
505
581
  * sections without parsing className conventions. Optional
506
582
  * `id` prop wires up anchor-link navigation
507
583
  * (`<a href="#pricing">`).
508
- * 3. **Provides a styling seam** — `className` is forwarded to the
509
- * `<section>` element so designers can apply utility-class
510
- * decorations (background, padding, max-width container) without
511
- * having to compose multiple wrappers.
584
+ * 3. **Provides a styling seam** — the data attributes above are
585
+ * what a site's CSS styles a section by. `className` is forwarded
586
+ * to the `<section>` element only when a site renders
587
+ * `WebsiteSection` itself; `WebsitePageSections`, which wraps every
588
+ * section of a page, passes none.
512
589
  *
513
590
  * **Why NOT render a `<div>` instead of `<section>`**: marketing
514
591
  * pages benefit from semantic landmarks for SEO scoring and
@@ -517,13 +594,13 @@ pass-throughs (`aria-labelledby`, `role`, etc.).
517
594
  * a `<div>` with the same data-attribute carries the same metadata
518
595
  * but loses the landmark benefit.
519
596
  *
520
- * **Why expose `as` is NOT a prop**: switching the rendered tag
597
+ * **Why `as` is NOT a prop**: switching the rendered tag
521
598
  * (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
522
- * is legitimate but rare enough to be worth a separate primitive
523
- * (Phase 4: `<WebsiteAside>`, `<WebsiteArticle>`). Keeping
524
- * `WebsiteSection` rendered as a literal `<section>` removes a
525
- * rarely-used prop from the section-author API and keeps the SEO
526
- * landmark contract guaranteed at the type level.
599
+ * is legitimate but rare; a section that needs one renders that
600
+ * element inside its body. Keeping `WebsiteSection` rendered as a
601
+ * literal `<section>` removes a rarely-used prop from the
602
+ * section-author API and keeps the SEO landmark contract guaranteed
603
+ * at the type level.
527
604
  */
528
605
  export interface WebsiteSectionProps {
529
606
  /**
@@ -550,21 +627,22 @@ export interface WebsiteSectionProps {
550
627
  */
551
628
  id?: string;
552
629
  /**
553
- * Optional className applied to the `<section>` element. Used by
554
- * designers for layout / spacing utilities. Section components
555
- * themselves should NOT pass className through to this wrapper —
556
- * keep the styling responsibility at the page-composition level.
630
+ * Optional className applied to the `<section>` element, for a site
631
+ * that renders `WebsiteSection` itself. `WebsitePageSections` passes
632
+ * none: a page's sections are styled through `[data-section-ref]` /
633
+ * `[data-section-category]`.
557
634
  */
558
635
  className?: string;
559
636
  /**
560
- * The section's body. Typically a single section component
561
- * (`<HeroSection {…heroProps} />`). May be plain JSX for one-off
562
- * sections that don't justify a `defineWebsiteSection` factory call.
637
+ * The section's body: the section's own component, which takes no
638
+ * props (`<HeroSection />`; see `WebsiteSectionComponentProps`). May be
639
+ * plain JSX for one-off sections that don't justify a
640
+ * `defineWebsiteSection` factory call.
563
641
  */
564
642
  children: ReactNode;
565
643
  /**
566
- * Pass-through `aria-*` / `role` attributes for sections that need
567
- * to refine their landmark semantics (eg. `aria-label="Featured
644
+ * Pass-through `aria-label` / `aria-labelledby` (the only two it
645
+ * forwards) for sections that need to refine their landmark semantics (eg. `aria-label="Featured
568
646
  * customer logos"` on a logo wall).
569
647
  */
570
648
  ariaLabel?: string;
@@ -619,12 +697,17 @@ WebsiteSection.displayName = 'WebsiteSection';
619
697
  ```
620
698
 
621
699
 
622
- > **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
623
- > CTA component**. This skill documents the authoring pattern via
624
- > `defineWebsiteSection<TProps>`. The CTA category is the canonical
625
- > mid-page conversion band (use `website-section-footer-cta` for the
626
- > last-impression pre-footer band, and `website-section-hero` for the
627
- > top-of-page first-impression band).
700
+ > **Framework rule**: the installed `@wildo-ai/saas-website` package ships the call to
701
+ > action as a configurable building block, `websiteCtaBandBlock`: a band of its own with an
702
+ > optional eyebrow, the heading, an optional sentence and the actions centred, any surface
703
+ > tone and room, its reveal and its look read from the site's theme. The section IS the
704
+ > block, configured — `websiteCtaBandBlock.section({ pageRef, sectionRef, category, config })`
705
+ > — and its words are derived from that same `config`. Its tone defaults to `INVERSE`, the
706
+ > page's close; a mid-page CTA sets a lighter `tone` in its config. This skill covers what a
707
+ > mid-page CTA must SAY and CARRY — its category, its one ask, its destination, its (absent)
708
+ > structured data and its `llms.txt` contribution. How blocks are configured in general is
709
+ > `website-building-blocks`; the last-impression band is `website-section-footer-cta`, the
710
+ > first impression `website-section-hero`.
628
711
 
629
712
  ## Overview
630
713
 
@@ -635,6 +718,15 @@ Authors should think of it as "one thing to ask for" — one primary
635
718
  button, optionally one secondary low-commitment alternative. Anything
636
719
  more belongs in a different section type.
637
720
 
721
+ The same block closes the page (`website-section-footer-cta`), so what tells
722
+ the two apart is the category and the weight: the mid-page band sits on
723
+ `WebsiteSurfaceTone.TINTED` (or `BRAND` for a louder ask, `DEFAULT` for a quiet
724
+ one), leaving `INVERSE` to the page's close, which stays the strongest band.
725
+
726
+ The call-to-action band draws its own surface and carries its own heading
727
+ (`WebsiteBlockSurface.OWN`, `WebsiteBlockHeading.OWN`), so its section takes no
728
+ `band` and no `intro`: the tone, the room and the eyebrow are all in its `config`.
729
+
638
730
  What the category does — and, for structured data, does not — decide:
639
731
 
640
732
  1. **SEO/AEO/GEO** — `category: CTA` does not have a
@@ -648,18 +740,19 @@ What the category does — and, for structured data, does not — decide:
648
740
 
649
741
  | Surface | Glob (relative to app root) |
650
742
  |---|---|
651
- | Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
743
+ | The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
744
+ | The site's config builder for the band (its motif, its primary action) and its section factory | `website/src/sections/kit/**` |
652
745
  | Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
653
746
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
747
+ | The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
654
748
 
655
749
  ## When to Use
656
750
 
657
751
  - A focused mid-page conversion ask (one primary action).
658
- - The destination is the SaaS app sign-up / demo booking / contact
659
- form.
752
+ - The destination is the application's sign-up / demo booking / contact
753
+ page.
660
754
  - The CTA is repeated on more than one page with locale-dependent
661
- copy (the section definition stays the same; the manifest
662
- declaration changes per page).
755
+ copy (each page declares its own section, with its own `sectionRef`).
663
756
 
664
757
  ## When NOT to Use
665
758
 
@@ -668,43 +761,85 @@ What the category does — and, for structured data, does not — decide:
668
761
  - Lead-capture form (visitor types email/topic) →
669
762
  `website-section-contact` (which wires into the `InboundContact`
670
763
  CREATE flow).
671
- - A CTA that needs a custom animated reveal / scroll-watcher →
672
- `website-factory-advanced`.
764
+ - The band's colours or spacing → `website-theme-authoring`; the block reads them from the theme.
765
+ - A reveal on the CTA band → the block already rises in as it scrolls into view; adjust it
766
+ through its config's `motion` (`website-motion-design`), within the page's motion budget —
767
+ the CTA stays this skill.
673
768
 
674
769
  ## Workflow
675
770
 
676
771
  ### Step 1: Decide the CTA's audience and destination
677
772
 
678
773
  Per-page CTAs typically map to one of: sign-up, demo, contact,
679
- download. Pick a stable `sectionRef` that reflects the audience
680
- ("sign-up", "book-demo") rather than the visual ("blue-button"); the
681
- ref is the analytics + label-pack contract.
774
+ download. Pick a stable `sectionRef` that reflects the page and the
775
+ audience (`pricing-book-demo`, `landing-start-trial`) rather than the
776
+ visual ("blue-button"); the ref is the analytics + label-pack contract.
682
777
 
683
- ### Step 2: Wire the destination URL
778
+ ### Step 2: Point the actions with `WebsiteLinkTo`
684
779
 
685
- If the destination is a SaaS-app route (sign-up, app dashboard), the
686
- CTA's `href` should target the cross-frontend handoff URL so the
687
- parent-domain anonymous-session UUID is carried into the app's
688
- sign-up flow (see the `website-anonymous-session` skill).
780
+ Each action is a `WebsiteLinkTo`, the same union the site menu uses:
689
781
 
690
- ### Step 3: Author the component + factory call
782
+ | Destination | `WebsiteLinkTo` |
783
+ |---|---|
784
+ | The application's sign-up (or sign-in, home) | `{ kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }` |
785
+ | A page of this site (`/contact`, `/pricing`) | `{ kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' }` |
786
+ | Somewhere else (a booking tool) | `{ kind: WebsiteMenuLinkKind.EXTERNAL, href }` |
787
+
788
+ `ApplicationEntryPoint` comes from `@wildo-ai/saas-models/public-runtime`. The
789
+ block resolves an `APPLICATION` link on this environment's `appOrigin` and a
790
+ `PAGE` link with the visitor's locale prefix, the same way the site header
791
+ does. Nothing is added to the URL: a visitor's anonymous session reaches the
792
+ application in its parent-domain cookie (see the `website-anonymous-session`
793
+ skill). Never write an application URL or a locale prefix by hand.
794
+
795
+ ### Step 3: Configure the band as the section
796
+
797
+ The section is `websiteCtaBandBlock.section({ pageRef, sectionRef, category:
798
+ WebsiteSectionCategory.CTA, config })`, where `config` is the band's props
799
+ (`WebsiteCtaBandProps`):
800
+
801
+ - `tone` — the lighter surface for a mid-page ask (`TINTED`, `BRAND`, `DEFAULT`; never
802
+ `INVERSE`, which is the page's close);
803
+ - `spacing` — `WebsiteBandSpacing.DEFAULT`, or `COMPACT` for an ask that should not
804
+ dominate the sections around it;
805
+ - `eyebrow` (`false` by default: `true` adds a short label above the heading) and `body`
806
+ (`true` by default: `false` for a heading and buttons alone);
807
+ - `primaryAction`, `secondaryAction` (both optional, Step 2);
808
+ - `headingLevel` (2, or 3 when nested under another section's heading), `decoration`
809
+ (the site's motif, rendered `aria-hidden`) and `motion`.
810
+
811
+ The section takes no `band` and no `intro`: the band draws its own surface and heading,
812
+ and the block's type refuses both.
813
+
814
+ ### Step 4: Let the words follow the config
815
+
816
+ The band reads `eyebrow` (when `eyebrow` is true), `heading`, `body` (unless `body` is
817
+ false), and `cta.primary` / `cta.secondary` for the actions given, as
818
+ `website.<page>.<section>.<slot>` keys. The section derives exactly that list from the
819
+ `config`: add a secondary action and its `cta.secondary` word is declared; drop the body
820
+ and its word goes. Nothing is listed by hand. Author the words per locale in the label
821
+ pack (`website-label-pack`).
822
+
823
+ ### Step 5: Compose into a page
691
824
 
692
- The component reads label leaves; the variant (`banner` / `boxed` /
693
- `split`) is a typed prop. Always wrap with
694
- `defineWebsiteSection<TProps>` so the factory parses + preserves
695
- types.
825
+ Multiple CTA sections can coexist on a page — each must have a
826
+ unique `sectionRef`. Two consecutive sections on the same tone read as one band
827
+ (the second drops its top padding), so give the CTA a tone that differs from its
828
+ neighbours when it should stand apart.
696
829
 
697
- ### Step 4: Compose into a page
830
+ ### Step 6: Make it this site's own without forking the block
698
831
 
699
- Multiple CTA sections can coexist on a page — each must have a
700
- unique `sectionRef`.
832
+ In this order: the theme (`website-theme-authoring`), the config of Step 3, a config
833
+ builder in the site's kit that fixes its motif and primary action once (and returns
834
+ `WebsiteCtaBandProps`), and last an ordinary CSS rule on a hook
835
+ (`[data-website-band-role='cta'][data-website-tone='tinted'] [data-website-block='cta']`).
836
+ The block's CSS is in the `wildo-website` cascade layer, so an unlayered site rule wins
837
+ without `!important`; read colours from the current tone.
701
838
 
702
- **Stop** after the CTA renders and the cross-frontend handoff
703
- carries the parent-domain anonymous-session UUID through to the
704
- SaaS app sign-up; if the click loses attribution, **return to
705
- Step 2** — `primaryHref` must be sourced from the page's URL
706
- builder (`D16` / `website-anonymous-session` carrier), not a
707
- hardcoded URL.
839
+ **Stop** after the CTA renders and its primary action opens the
840
+ application's sign-up page on this environment's `appOrigin`; if it
841
+ opens a typed URL or a 404, **return to Step 2** — the link is a
842
+ `WebsiteLinkTo`, never typed.
708
843
 
709
844
  ## Contribution to `llms.txt`
710
845
 
@@ -719,128 +854,157 @@ inside the relevant page block in `website/src/content/llms.txt`.
719
854
 
720
855
  ## Worked Example
721
856
 
722
- <!-- TIER C WAIVER: This block IS the canonical mid-page CTA contract — `category: WebsiteSectionCategory.CTA`, the `variant: 'banner' | 'boxed' | 'split'` typed-prop pattern called out in Step 3, the `primaryHref` cross-frontend handoff prop, and the `expectedLabelKeys` rooted at `website.<page>.<sectionRef>.<leaf>` shape that the Verification + Common Rationalizations sections below name explicitly. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
857
+ The page's close is the same block, configured from the site's config builder; the
858
+ mid-page ask has the same shape, with its own category and a lighter tone in its config:
859
+
860
+
861
+ ## Usage Example
862
+
723
863
  ```tsx
724
- // website/src/sections/<page>.sections.tsx
725
- import {
726
- defineWebsiteSection,
727
- useWebsiteLabel,
728
- WebsiteButton,
729
- WebsiteHeading,
730
- WebsiteSectionCategory,
731
- WebsiteText,
732
- } from '@wildo-ai/saas-website';
733
-
734
- interface CtaSectionProps {
735
- variant: 'banner' | 'boxed' | 'split';
736
- /** Sign-up / demo / contact destination URL (already cross-frontend-handoff-aware). */
737
- primaryHref: string;
738
- secondaryHref?: string;
739
- }
864
+ export const LANDING_FINAL_CTA_SECTION = websiteCtaBandBlock.section({
865
+ pageRef: PAGE_REF,
866
+ sectionRef: 'landing-final-cta',
867
+ category: WebsiteSectionCategory.FOOTER_CTA,
868
+ config: finalCtaConfig('/contact'),
869
+ });
870
+ ```
740
871
 
741
- function CtaSectionComponent({ variant, primaryHref, secondaryHref }: CtaSectionProps) {
742
- const headline = useWebsiteLabel('headline');
743
- const subheadline = useWebsiteLabel('subheadline');
744
- const primaryCta = useWebsiteLabel('primary-cta');
745
- const secondaryCta = useWebsiteLabel('secondary-cta');
872
+ `finalCtaConfig` is a config builder in the site's kit: it returns the band's props with
873
+ the site's motif as `decoration` and its two actions, so every page's close is one call
874
+ (`website-section-footer-cta` shows the builder).
746
875
 
747
- return (
748
- <div data-variant={variant} className="cta">
749
- <div className="cta__copy">
750
- <WebsiteHeading level={2} variant="title">{headline}</WebsiteHeading>
751
- <WebsiteText variant="lead">{subheadline}</WebsiteText>
752
- </div>
753
- <div className="cta__actions">
754
- <WebsiteButton href={primaryHref} variant="primary">{primaryCta}</WebsiteButton>
755
- {secondaryHref && (
756
- <WebsiteButton href={secondaryHref} variant="secondary">{secondaryCta}</WebsiteButton>
757
- )}
758
- </div>
759
- </div>
760
- );
761
- }
876
+ A mid-page ask written in place, with its tone, room and eyebrow in the config:
762
877
 
763
- export const CTA_SECTION = defineWebsiteSection<CtaSectionProps>({
764
- sectionRef: 'mid-cta',
878
+ <!-- TIER C WAIVER: no anchored application usage configures `websiteCtaBandBlock` as a MID-PAGE ask; the anchored close above keeps the block's default INVERSE tone. This block shows what Step 3 and the Verification below reference: `category: WebsiteSectionCategory.CTA`, a non-inverse `tone` with `COMPACT` spacing and an eyebrow in the config, and the actions as `WebsiteLinkTo` values. Keep it inline until a mid-page CTA is deliberately anchored. -->
879
+ ```tsx
880
+ // website/src/sections/<page>.sections.tsx
881
+ export const LANDING_START_TRIAL_SECTION = websiteCtaBandBlock.section({
882
+ pageRef: 'landing',
883
+ sectionRef: 'landing-start-trial',
765
884
  category: WebsiteSectionCategory.CTA,
766
- expectedLabelKeys: [
767
- 'website.landing.mid-cta.headline',
768
- 'website.landing.mid-cta.subheadline',
769
- 'website.landing.mid-cta.primary-cta',
770
- 'website.landing.mid-cta.secondary-cta',
771
- ],
772
- Component: CtaSectionComponent,
885
+ // TINTED leaves INVERSE to the page's close. Words: eyebrow, heading, body, cta.primary, cta.secondary.
886
+ config: {
887
+ tone: WebsiteSurfaceTone.TINTED,
888
+ spacing: WebsiteBandSpacing.COMPACT,
889
+ eyebrow: true,
890
+ primaryAction: { kind: WebsiteMenuLinkKind.APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP },
891
+ secondaryAction: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' },
892
+ },
773
893
  });
774
894
  ```
775
895
 
896
+ The section holds no heading markup, no button row, no URL and no list of its words:
897
+ the band, its centring, its buttons, both links and the five words come from the block
898
+ and its config.
899
+
776
900
  ## Structured-data contract
777
901
 
778
902
  The `CTA` category does not own a dedicated JSON-LD vocabulary. If the
779
- CTA represents the page's primary user action, the page-level
780
- `getStructuredData` (on `WebPage`) may reference it via
903
+ CTA represents the page's primary user action, a page-level `WebPage`
904
+ payload (the route's `pagePayloads`) may reference it via
781
905
  `potentialAction`/`mainEntity`. Keep unrelated vocabularies
782
906
  (`Product`, `FAQPage`, etc.) in the sections that own them — nothing
783
907
  rejects them here, since the audit checks each payload against the
784
908
  catalog and never against the section's category.
785
909
 
786
910
  In practice: leave `getStructuredData` undefined unless you have a
787
- specific page-level action you want crawlers to surface.
911
+ specific page-level action you want crawlers to surface. If you do, pass it
912
+ to `websiteCtaBandBlock.section(...)`; its words (the action's `name`) come
913
+ from `label(slot)` of the context the function receives —
914
+ `label('cta.primary')` is the button's own word — never a typed string; see
915
+ `website-seo-aeo-geo`.
788
916
 
789
917
  ## References
790
918
 
791
919
  - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
920
+ - `../website-building-blocks/references/framework-website-blocks-api.md` — source-backed `defineWebsiteBlock`, `websiteCtaBandBlock`, the `WebsiteCtaBand` props and their words, `WebsiteLinkTo` and the stylesheet hooks.
792
921
 
793
922
  ## Verification
794
923
 
795
924
  - [ ] `category: WebsiteSectionCategory.CTA` (typed enum).
796
- - [ ] `sectionRef` reflects the audience/intent (e.g. `mid-cta`,
797
- `book-demo`), not the visual style.
925
+ - [ ] `sectionRef` reflects the page and the intent (e.g. `landing-start-trial`,
926
+ `pricing-book-demo`), not the visual style.
798
927
  - [ ] If multiple CTAs share a page, each has a unique `sectionRef`.
799
- - [ ] `primaryHref` to a SaaS-app route uses the cross-frontend
800
- handoff carrier (`website-anonymous-session`).
801
- - [ ] All visible strings come from `useWebsiteLabel('<leaf>')`.
802
- - [ ] Variant choice is a typed prop, not a label key.
928
+ - [ ] The section is `websiteCtaBandBlock.section(...)` (or a site factory calling it) —
929
+ no hand-built heading and button row, no `<WebsiteCtaBand>` in a hand-written
930
+ component, no `defineWebsiteBlockSection` with a slot list.
931
+ - [ ] The config's `tone` is set and is not `INVERSE`, which is the page's close.
932
+ - [ ] Every action is a `WebsiteLinkTo` (`APPLICATION` with an `entryPoint`, `PAGE` with a
933
+ `routePath`, or `EXTERNAL`); no typed `href`, no application URL, no locale prefix.
934
+ - [ ] One primary action at most, and at most one secondary.
935
+ - [ ] No word of the band is listed by hand: the section derives them from the config.
936
+ - [ ] The look is adjusted through the theme, the config, or a rule on a `data-website-*`
937
+ hook — no copied band markup, no `!important`, no raw colour.
803
938
 
804
939
  ### Grep invariants
805
940
 
806
- | Invariant | Command |
807
- |---|---|
808
- | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
809
- | Category enum (no string literal) | `rg -n "category: 'cta'" website/src/sections/<page>.sections.tsx` (must return empty) |
810
- | No hardcoded sign-up URL outside the cross-frontend carrier | `rg -n "href=\"https?://" website/src/sections/<page>.sections.tsx` (must return empty — pass URLs as props) |
811
- | Labels via leaf-relative hook | `rg -n "useWebsiteLabel\\(" website/src/sections/<page>.sections.tsx` (must return ≥1 per visible string) |
941
+ `npx astro check` in `website/` must pass: the block's `section(...)` type refuses a
942
+ `band` or an `intro` for this block. Then, from the app root:
943
+
944
+ ```bash
945
+ # The band is configured as a section (must return >= 1, in the page file or a kit factory)
946
+ rg -n "websiteCtaBandBlock\.section\(" website/src/sections
947
+
948
+ # No hand composition of the band (review each hit: only a site block's own `defineWebsiteBlock` may render it)
949
+ rg -n "<WebsiteCtaBand\b" website/src/sections
950
+
951
+ # No hand-listed words (review each hit: only a site block's own `defineWebsiteBlock` slots may call it)
952
+ rg -n "websiteCtaBandSlots\(" website/src/sections
953
+
954
+ # Sections declared by hand rather than configured (expect pricing only)
955
+ rg -n "defineWebsiteBlockSection\(" website/src/sections
956
+
957
+ # Category enum, no string literal (must return empty)
958
+ rg -n "category: 'cta'" website/src/sections/<page>.sections.tsx
959
+
960
+ # No typed link (must return empty: an action is a WebsiteLinkTo)
961
+ rg -n "href=" website/src/sections/<page>.sections.tsx
962
+
963
+ # INVERSE is the page's close (review each hit in a websiteCtaBandBlock config: only a FOOTER_CTA close takes it; other blocks' bands may)
964
+ rg -n "WebsiteSurfaceTone\.INVERSE" website/src/sections
965
+
966
+ # !important or a raw colour against the block (must return empty)
967
+ rg -n '!important|#[0-9a-fA-F]{3,8}\b' website/src/styles
968
+ ```
812
969
 
813
970
  ## Common Rationalizations
814
971
 
815
972
  | Rationalization | Reality |
816
973
  |---|---|
817
974
  | "Two primary CTAs are fine" | Funnel ambiguity tanks conversion. Use one primary + one secondary, or split into two CTA sections with distinct intents. |
818
- | "I'll hardcode the sign-up URL" | The destination is per-environment AND must thread the parent-domain anonymous-session UUID. Pass it as a prop sourced from the page's URL builder. |
819
- | "Variant is fine as a label" | Layout/visual variant is a typed prop. Label keys are user-visible strings. |
820
- | "I'll use `sectionRef: 'cta'` on every page so I don't have to think" | The ref is the analytics funnel-step grouping and the `expectedLabelKeys` namespace; reusing it across pages collapses the funnel into a single bucket and lets two pages compete for the same label keys. Pick an audience-driven ref per page (`book-demo`, `start-trial`, `mid-cta`). |
975
+ | "I'll hardcode the sign-up URL" | The application's origin differs per environment and its sign-up path is the application's to name. `{ kind: APPLICATION, entryPoint: ApplicationEntryPoint.SIGN_UP }` resolves both; the anonymous session needs nothing in the URL, since its parent-domain cookie carries it. |
976
+ | "I'll copy the band's JSX to change its layout" | The copy stops following the theme, the motion vocabulary and every fix to the block. Change the config's tone or spacing, the theme, or one rule on a `data-website-*` hook. |
977
+ | "I'll wrap `<WebsiteCtaBand>` in a component and list its words beside it" | Then the words are listed apart from what renders, and drift the day an action is added. Configure `websiteCtaBandBlock.section(...)`; the words follow the config. |
978
+ | "The mid-page CTA can be on the dark band too" | `INVERSE` is the page's close. Two inverse asks compete, and the closing one stops reading as the last word. Give the mid-page config a lighter tone. |
979
+ | "I'll put the band on a `band: { tone }` like the other sections" | The call-to-action band draws its own surface, so its section takes no `band`: the tone goes in its config. `npx astro check` refuses a `band` here. |
980
+ | "I'll use `sectionRef: 'cta'` on every page so I don't have to think" | The ref names one section of the whole site: it is the `data-section-ref` analytics tooling groups by and the namespace of its label keys, and the website plan refuses a ref declared on two pages. Name it after its page and intent (`pricing-book-demo`, `landing-start-trial`). |
821
981
 
822
982
  ## Red Flags
823
983
 
824
- - A CTA pointing directly at `https://app.example.com/signup` with no
825
- cross-frontend handoff — first-touch attribution and
826
- marketing-metadata propagation are lost. Use the
827
- `website-anonymous-session` carrier. Catch with the
828
- `href="https?://"` grep invariant above (must return empty).
829
- - Three or more CTAs in the same `<CTA_SECTION>` instance — split
830
- into separate sections with their own `sectionRef`.
831
- - Hardcoded headline / subheadline / CTA strings inside the JSX
832
- (no `useWebsiteLabel('<leaf>')`) — the label-pack validator cannot
833
- audit unreferenced inline strings; missing translations ship
834
- silently. Catch with the `useWebsiteLabel` grep invariant above
835
- (must return ≥1 per visible string).
984
+ - A CTA pointing at a typed `https://app.example.com/signup` or `"/signup"` — it names
985
+ one environment and a path the application may not serve, and skips the locale prefix.
986
+ Catch with the "No typed link" grep above (must return empty).
987
+ - A hand-built heading and button row (`<div className="cta">`, `WebsiteButton`s, a
988
+ `<WebsiteCtaBand>` inside a hand-written section component) instead of the configured
989
+ block — catch with the "No hand composition" grep above.
990
+ - CTA words listed by hand (`websiteCtaBandSlots(...)`, `expectedLabelKeys: [...]`, or a
991
+ `defineWebsiteBlockSection` with a `slots` list) — catch with the "No hand-listed words"
992
+ and `defineWebsiteBlockSection` greps above.
993
+ - A mid-page CTA on `INVERSE` — catch with the INVERSE grep above.
994
+ - Three or more actions in one CTA section — the block renders one primary and one secondary,
995
+ so a third means a hand-built button row; catch it with the "No hand composition" grep
996
+ above, and split into separate sections with their own `sectionRef`.
997
+ - `!important` or a raw colour in a rule against the band — catch with the last grep above.
836
998
 
837
999
  ## Related Skills
838
1000
 
1001
+ - `website-building-blocks` — how the engine's blocks are configured as sections, derive their words and are adjusted without forking.
839
1002
  - `website-page-authoring` — composing the CTA into a page manifest.
840
1003
  - `website-label-pack` — authoring the EN/FR strings.
1004
+ - `website-theme-authoring` — the tones and the look the band reads.
841
1005
  - `website-section-hero` — top-of-page first-impression sibling.
842
- - `website-section-footer-cta` — pre-footer last-impression sibling.
843
- - `website-anonymous-session` — cross-frontend handoff carrier for
844
- CTA destinations.
1006
+ - `website-section-footer-cta` — pre-footer last-impression sibling, the same block on the inverse band.
1007
+ - `website-anonymous-session` — the anonymous session the application
1008
+ continues after a CTA's sign-up.
845
1009
  - `website-inbound-contact-forms` — when the CTA is a form (email /
846
1010
  topic capture), use the dedicated contact-section skill instead.