@wildo-ai/framework-knowledge 1.1.10 → 1.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1062) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  4. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  5. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  6. package/dist/esm/framework-knowledge.definitions.js +459 -76
  7. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  9. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  10. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  11. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  12. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  13. package/dist/esm/index.d.ts +2 -0
  14. package/dist/esm/index.d.ts.map +1 -1
  15. package/dist/esm/index.js +2 -0
  16. package/dist/esm/index.js.map +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  18. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  20. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -2
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +11 -6
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +3 -3
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +3 -2
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  45. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  49. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +2 -2
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
  53. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  56. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  62. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  66. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  69. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  70. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +6 -4
  74. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  83. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  97. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
  99. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
  101. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  110. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  118. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  120. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -3
  124. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  125. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  126. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  127. package/dist/esm/source-anchor-grammar.js +114 -0
  128. package/dist/esm/source-anchor-grammar.js.map +1 -0
  129. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  130. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  131. package/dist/knowledge/manifest.json +8 -8
  132. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  133. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  135. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  136. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +350 -23
  137. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
  138. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
  139. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  140. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  141. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  142. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  143. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +3 -3
  144. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
  145. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
  146. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
  147. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  149. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  150. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  151. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  152. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +33 -5
  153. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
  155. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -3
  156. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  157. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  158. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +97 -23
  159. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  160. package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
  161. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  163. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  164. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  165. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  166. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  167. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
  168. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
  169. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  170. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  171. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  172. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  173. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  174. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  175. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  176. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  177. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +3 -3
  178. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
  180. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  181. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  182. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  183. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  184. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +4 -0
  185. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -4
  186. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  187. package/dist/knowledge/references/application-maturity.config.md +1 -1
  188. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  189. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  190. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  191. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  192. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  193. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  194. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  195. package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
  196. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  197. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  198. package/dist/knowledge/references/capability-composition.config.md +4 -3
  199. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  200. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  201. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  202. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  203. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  204. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  205. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  206. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
  207. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
  208. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  209. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  210. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  211. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  213. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  214. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  215. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  216. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  217. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  218. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  219. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  220. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  221. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  222. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  223. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  224. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  225. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  226. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  227. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  228. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  229. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  230. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  231. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  232. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -22
  233. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  234. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  235. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  236. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  237. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  238. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  239. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  240. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  241. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  242. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  243. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  244. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  245. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  246. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  247. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  248. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  249. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  250. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  251. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  252. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  253. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  254. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  255. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  256. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  257. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  258. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  259. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  260. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  261. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  262. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  263. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  264. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  265. package/dist/knowledge/references/experience-plan.config.md +16 -0
  266. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  267. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  268. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  269. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  270. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  271. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  272. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  273. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  274. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  275. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  276. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  277. package/dist/knowledge/references/integration-plan.config.md +21 -1
  278. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  279. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  280. package/dist/knowledge/references/placement-plan.config.md +75 -13
  281. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  282. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  283. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  284. package/dist/knowledge/references/platform.config.saas.md +106 -14
  285. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  286. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  287. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  288. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  289. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  290. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  291. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  292. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  293. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  294. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  295. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  296. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  297. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  298. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  299. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  300. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  301. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  302. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  303. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  304. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  305. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  306. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  307. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  308. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  309. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  310. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  311. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  312. package/dist/knowledge/references/saas.backend.email.send.md +7 -0
  313. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  314. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  315. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  316. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  317. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  318. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  319. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  320. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  321. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  322. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  323. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  324. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  325. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  326. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  327. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  328. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  329. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  330. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  331. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  332. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  333. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  334. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  335. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  336. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  337. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  338. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  339. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  340. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  341. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  342. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  343. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  344. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  345. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  346. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  347. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  348. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  349. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +18 -16
  350. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  351. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  352. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  353. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  354. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  355. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  356. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  357. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +10 -2
  358. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
  359. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
  360. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  361. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  362. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  363. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  364. package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
  365. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  366. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
  367. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
  368. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  369. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
  370. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  371. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  372. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  373. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  374. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  375. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  376. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  377. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  378. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  379. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  380. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  381. package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
  382. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  383. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  384. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  385. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  386. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  387. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  388. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  389. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  390. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  391. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  392. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  393. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  396. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  397. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  398. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  400. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  405. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  406. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  407. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  408. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  409. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  410. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  411. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  412. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  413. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  414. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  415. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  416. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  417. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  418. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  419. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  420. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  421. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  422. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  423. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  424. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  425. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  426. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  427. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +58 -6
  428. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  429. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  430. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  431. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  434. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  435. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  436. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  437. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  438. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  440. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  441. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  442. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  443. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  444. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  445. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  446. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  447. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  448. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  451. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  452. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  453. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  454. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  455. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  456. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +58 -2
  457. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  459. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  460. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  461. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  463. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  465. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  466. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  467. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  468. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  469. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  470. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  471. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  472. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  473. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  474. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  475. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  476. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  477. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  478. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  479. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -6
  480. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  481. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  482. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  483. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  484. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  485. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  486. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  487. package/dist/knowledge/references/saas.public-runtime.contract.md +34 -2
  488. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  489. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  490. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  492. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  493. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  494. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  495. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  496. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  497. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  498. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  499. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  500. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  501. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  502. package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
  503. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  504. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  505. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  506. package/dist/knowledge/references/saas.website.astro.label-loader.md +38 -9
  507. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  508. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  509. package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
  510. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  511. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  512. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  513. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  514. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  515. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  516. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  517. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  518. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  519. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  520. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  521. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  522. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  523. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  524. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  525. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  526. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  527. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  528. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  529. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  530. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  531. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  532. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  533. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  534. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  535. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  536. package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
  537. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  538. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  539. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  540. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  541. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  542. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  543. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  544. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  545. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  546. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  547. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  548. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  549. package/dist/knowledge/references/saas.website.config.site-context-loader.md +21 -1
  550. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  551. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  552. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  553. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  554. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  555. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  556. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  557. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  558. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  559. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  560. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  561. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  562. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  563. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  564. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  565. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  566. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  567. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  568. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  569. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  570. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  571. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  572. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  573. package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
  574. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  575. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  576. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  577. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  578. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  579. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  580. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  581. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  582. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  583. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  584. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  585. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  586. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  587. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  588. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  589. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  590. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  591. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  592. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  593. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  594. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  595. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  596. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  597. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  598. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  599. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  600. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  601. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  602. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  603. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  604. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  605. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  606. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  607. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  608. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  609. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  610. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  611. package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
  612. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  613. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  614. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  615. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  616. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  617. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  618. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  619. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  620. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  621. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  622. package/dist/knowledge/references/service-method.config.md +270 -0
  623. package/dist/knowledge/references/website-plan.config.md +544 -32
  624. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  625. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  626. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  627. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  628. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +73 -9
  629. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  630. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  631. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +75 -6
  632. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  633. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  634. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  635. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  636. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  637. package/dist/knowledge/references/zod.decorators.schema-metadata.md +4 -0
  638. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
  639. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  640. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  641. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
  642. package/dist/knowledge/references/zod.factories.code.md +18 -9
  643. package/dist/knowledge/references/zod.factories.duration.md +23 -14
  644. package/dist/knowledge/references/zod.factories.money.md +24 -15
  645. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  646. package/dist/knowledge/references/zod.factories.range.md +5 -1
  647. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  648. package/dist/knowledge/registries/framework-topics.json +2411 -139
  649. package/dist/knowledge/registries/playbooks.json +51 -30
  650. package/dist/knowledge/registries/source-tags.json +8500 -4768
  651. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  652. package/dist/knowledge/skills/INDEX.md +60 -33
  653. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  654. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  655. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  656. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  657. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  658. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  659. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  660. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  661. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  662. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  663. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  664. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  665. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  666. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  667. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  668. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  669. package/dist/knowledge/skills/application-database-migrations/SKILL.md +27 -9
  670. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  671. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
  672. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
  673. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  674. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  675. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  676. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  677. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +35 -1
  678. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  679. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +3 -0
  680. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  681. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  682. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  683. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  684. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  685. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  686. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
  687. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  688. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  689. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  690. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  691. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  692. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  693. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  694. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +134 -33
  695. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  696. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  697. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  698. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  699. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  700. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  701. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  702. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  703. package/dist/knowledge/skills/config-app-shell/SKILL.md +57 -28
  704. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  705. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  706. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  707. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  708. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +17 -6
  709. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
  710. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  711. package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
  712. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  713. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  714. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  715. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  716. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  717. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  718. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  719. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  720. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  721. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  722. package/dist/knowledge/skills/config-saas/SKILL.md +2 -0
  723. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
  724. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
  725. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  726. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  727. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  728. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  729. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  730. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  731. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  732. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  733. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  734. package/dist/knowledge/skills/config-saas-backend/SKILL.md +5 -3
  735. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  736. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  737. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  738. package/dist/knowledge/skills/configure-billing/SKILL.md +14 -0
  739. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  740. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  741. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  742. package/dist/knowledge/skills/email-add-template/SKILL.md +46 -5
  743. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
  744. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  745. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  746. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  747. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  748. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  749. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  750. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  751. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  752. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  753. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  754. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +281 -20
  755. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  756. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  757. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  758. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  759. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  760. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  761. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  762. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  763. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  764. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  765. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  766. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  767. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  768. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  769. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  770. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  771. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  772. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  773. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
  774. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  775. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  776. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  777. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
  778. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
  779. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -14
  780. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  781. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  782. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  783. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  784. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
  785. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
  786. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  787. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  788. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  789. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  790. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  791. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  792. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  793. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  794. package/dist/knowledge/skills/infra-environment-config/SKILL.md +107 -2
  795. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  796. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  797. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  798. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  799. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  800. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  801. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  802. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  803. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  804. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  805. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  806. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  807. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  808. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  809. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  810. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
  811. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
  812. package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
  813. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -1
  814. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  815. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  816. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  817. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  818. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  819. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  820. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +150 -4
  821. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  822. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  823. package/dist/knowledge/skills/module-relationships/SKILL.md +50 -27
  824. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  825. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  826. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  827. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  828. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  829. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  830. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  831. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  832. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  833. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  834. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  835. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  836. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  837. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  838. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
  839. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  840. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  841. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  842. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  843. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  844. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  845. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  846. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  847. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  848. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
  849. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  850. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  851. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  852. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  853. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +26 -14
  854. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  855. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  856. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  857. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  858. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  859. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  860. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
  861. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  862. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  863. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +132 -55
  864. package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
  865. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -2
  866. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  867. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  868. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +102 -4
  869. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  870. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  871. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +6 -0
  872. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  873. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +18 -0
  874. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  875. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +60 -3
  876. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  877. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  878. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +1 -1
  879. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  880. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +195 -23
  881. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  882. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  883. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +176 -10
  884. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  885. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
  886. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  887. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  888. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  889. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
  890. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  891. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  892. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  893. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  894. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  895. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  896. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  897. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  898. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  899. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  900. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  901. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  902. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  903. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  904. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  905. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  906. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  907. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  908. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  909. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +3 -1
  910. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  911. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  912. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +26 -10
  913. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  914. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +9 -7
  915. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  916. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +79 -6
  917. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  918. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  919. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  920. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +32 -4
  921. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  922. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +116 -66
  923. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  924. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +203 -18
  925. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  926. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
  927. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
  928. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  929. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  930. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  931. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +168 -58
  932. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  933. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  934. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  935. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  936. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  937. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  938. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  939. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  940. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  941. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  942. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  943. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +141 -32
  944. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
  945. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  946. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  947. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  948. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
  949. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  950. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  951. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
  952. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
  953. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  954. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
  955. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  956. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +11 -4
  957. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
  958. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  959. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
  960. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
  961. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -192
  962. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  963. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  964. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  965. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  966. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  967. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +39 -18
  968. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  969. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  970. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
  971. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
  972. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
  973. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  974. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  975. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
  976. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
  977. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  978. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  979. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  980. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
  981. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  982. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
  983. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  984. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
  985. package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
  986. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  987. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +24 -3
  988. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  989. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  990. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  991. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
  992. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  993. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  994. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  995. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  996. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  997. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  998. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  999. package/dist/knowledge/skills/website-section-faq/SKILL.md +561 -302
  1000. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1001. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1002. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +647 -274
  1003. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1004. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +572 -264
  1005. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1006. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1007. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1008. package/dist/knowledge/skills/website-section-hero/SKILL.md +603 -332
  1009. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1010. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1011. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1012. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1013. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1014. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1015. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1016. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1017. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1018. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1019. package/dist/knowledge/skills/website-section-pricing/SKILL.md +549 -378
  1020. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1021. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1022. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1023. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1024. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1025. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1026. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1027. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1028. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1029. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1030. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1031. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1032. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1033. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1034. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +739 -315
  1035. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1036. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1037. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1038. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1039. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1040. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1041. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1042. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1043. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
  1044. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1045. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
  1046. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
  1047. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1048. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1049. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1050. package/dist/knowledge/topic-index.json +16442 -8572
  1051. package/package.json +4 -4
  1052. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1053. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1054. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1055. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1056. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1057. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1058. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1059. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1060. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1061. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1062. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: website-blog-authoring
3
- description: Author marketing blog posts as per-locale MDX files (`src/content/blog/<locale>/<slug>.mdx`) with strict Zod-4 frontmatter validation, automatic `Article` Open Graph emission, and consumer-authored MDX tags (e.g. `<CTASection ref="post-cta" />`) bridged through `<WebsiteMdxProvider>`. Use when the user says "add a blog post", "publish an MDX article", "wire the blog adapter", "register a new MDX tag for blog posts", or "configure blog frontmatter".
3
+ description: Author marketing blog posts as per-locale MDX files (`src/content/blog/<locale>/<slug>.mdx`) with strict Zod-4 frontmatter validation, automatic `og:type=article` metadata and `BlogPosting` JSON-LD, and consumer-authored MDX tags (e.g. `<CTASection ref="post-cta" />`) bridged through `<WebsiteMdxProvider>`. Use when the user says "add a blog post", "publish an MDX article", "wire the blog adapter", "register a new MDX tag for blog posts", or "configure blog frontmatter".
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -37,8 +37,7 @@ Read and apply these patterns from the application-developer point of view:
37
37
  ## Overview
38
38
 
39
39
  A blog post in this framework is **a fully-localized MDX file**, NOT
40
- a label-pack-keyed structural page (Q16=B in
41
- the application website contract). Per-locale MDX is the right
40
+ a label-pack-keyed structural page. Per-locale MDX is the right
42
41
  shape because:
43
42
 
44
43
  - blog copy is long-form and locale-divergent (forcing it through a
@@ -52,7 +51,7 @@ shape because:
52
51
  can read labels and dispatch analytics like any other consumer-
53
52
  authored section.
54
53
 
55
- The framework's per-locale **bridge island** (Phase 7 D-6 Option A)
54
+ The framework's per-locale **bridge island**
56
55
  encapsulates the entire post tree (BlogPost + MDX body + embedded
57
56
  sections) inside ONE React island per route. This is the structural
58
57
  fix for Astro's React-context propagation gap (`<MDXProvider>`
@@ -66,15 +65,18 @@ the consumer's website module at these paths:
66
65
 
67
66
  | Surface | Glob (relative to app root) |
68
67
  |---|---|
69
- | Per-locale MDX bodies | `website/src/content/blog/<locale>/<slug>.mdx` |
70
- | Astro content-collection registry | `website/src/content/config.ts` |
71
- | MDX integration registration | `website/astro.config.ts` (registers `mdx()` BEFORE `react()`) |
68
+ | Per-locale MDX bodies | `website/src/content/blog/<locale>/<slug>.mdx` (`<locale>` is the folder's segment, the code lower-cased: `en-gb` for `en-GB`; the frontmatter's `locale` keeps the code) |
69
+ | Astro content-collection registry | `website/src/content.config.ts` (Astro 5+; `src/content/config.ts` is the legacy path) |
70
+ | MDX integration registration | `website/astro.config.ts` (registers `mdx()`, `websiteBlogReactMdx()`, `react()`, in that order) |
72
71
  | Per-locale bridge module | `website/src/pages-impl/blog-post-<locale>.bridge.tsx` |
73
72
  | MDX-tag → component registry | `website/src/pages-impl/blog-post.mdx-components.tsx` |
74
73
  | Page manifest (headless) | `website/src/pages-impl/blog-post.page.tsx` |
75
74
  | Section definitions used inside posts | `website/src/sections/blog.sections.tsx` |
76
75
  | Per-locale `[slug].astro` shell | `website/src/pages/blog/[slug].astro` (default locale, unprefixed) |
77
76
  | | `website/src/pages/<other-locale>/blog/[slug].astro` |
77
+ | Blog vocabulary (authors with their kind, tags) | `website/src/blog-vocabulary.ts` |
78
+ | Posts' JSON-LD as the audit reads it | `website/src/structured-data/page-payloads.ts` |
79
+ | Covers (1200×630 PNG or JPEG) | `website/public/blog/covers/<slug>.png` |
78
80
  | Label pack (per locale) | `website/src/i18n/<locale>.json` |
79
81
 
80
82
  ## When to Use
@@ -92,33 +94,55 @@ the consumer's website module at these paths:
92
94
 
93
95
  - **Knowledge-base / docs** — use a dedicated docs surface; the blog
94
96
  adapter is opinionated about "publication-shaped" content
95
- (`Article` Open Graph, single `BLOG_POST_PAGE_REF`).
97
+ (`og:type=article`, `BlogPosting`, single `BLOG_POST_PAGE_REF`).
96
98
  - **In-product help articles** — those belong inside the SaaS app,
97
99
  not the marketing site.
98
100
  - **Single one-off article** — over-investment; a static page
99
101
  (`website-page-authoring`) with rich copy is simpler.
100
- - **Headless-CMS-sourced posts** — out of scope per Phase 7 D-5
101
- (scope minimization). The collection config helper is currently
102
- filesystem-only.
102
+ - **Headless-CMS-sourced posts** — not supported: the collection
103
+ config helper is filesystem-only.
103
104
 
104
105
  ## Workflow
105
106
 
106
107
  ### Step 1: Wire the MDX integration once per site
107
108
 
108
- In `website/astro.config.ts`, register `@astrojs/mdx` BEFORE
109
- `@astrojs/react`. Order matters — MDX must compile `.mdx` files into
110
- JSX before the React integration sees them.
109
+ In `website/astro.config.ts`, register `mdx()`, then `websiteBlogReactMdx()` (from
110
+ `@wildo-ai/saas-website/astro`), then `react()`:
111
111
 
112
- In `website/src/content/config.ts`, define the `blog` collection
113
- using `buildBlogPostCollectionConfig({ astroZ: z })` (Path Z — the
114
- collection schema is a passthrough record, the strict Zod-4
115
- validation runs at render time inside `<BlogPost>`).
112
+ ```ts
113
+ integrations: [mdx(), websiteBlogReactMdx(), react()],
114
+ ```
115
+
116
+ A post's body renders INSIDE the page's React island, and `@astrojs/mdx` compiles an `.mdx` file to Astro JSX, which
117
+ React cannot render: without the second integration every post page shows its header and no body. The integration
118
+ compiles for React only the imports the bridges make with the query `?website-react-mdx` (Step 5); the content
119
+ collection keeps using the plain `.mdx` id. It also tells Vite to optimize `@mdx-js/react` at startup, which the
120
+ dependency scan cannot see.
121
+
122
+ It compiles them with the MDX compiler `@astrojs/mdx` already ships and exactly two remark plugins, `remark-gfm`
123
+ (tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else of the site's Markdown
124
+ setup reaches a post body: the site's own remark and rehype plugins do not apply, and neither do Astro's defaults —
125
+ no Shiki code highlighting, no heading ids. Style code blocks, and give headings an anchor if a post needs one, in
126
+ the components `BLOG_POST_MDX_COMPONENTS` maps (Step 4).
127
+
128
+ In `website/src/content.config.ts`, define the `blog` collection by
129
+ spreading `buildBlogPostCollectionConfig({ astroZ: z, glob })` — `z` from
130
+ `astro:content`, `glob` from `astro/loaders`. The engine supplies the
131
+ content-layer LOADER (every `src/content/blog/<locale>/*.mdx`, each id'd by
132
+ its path) and the schema (a passthrough record; the strict Zod-4
133
+ validation runs at render time inside `<BlogPost>`). Never write
134
+ `type: 'content'`: Astro 6 removed legacy collections, and such a collection
135
+ loads EMPTY with no error, so every post answers 404. Never let the id default
136
+ to the frontmatter `slug`: a post's translations share their slug, and the
137
+ second would silently overwrite the first.
116
138
 
117
139
  ### Step 2: Define the headless page manifest
118
140
 
119
141
  Author `website/src/pages-impl/blog-post.page.tsx`:
120
142
 
121
- - `ref: BLOG_POST_PAGE_REF` (re-exported from `@wildo-ai/saas-website/astro-island`),
143
+ - `ref: BLOG_POST_PAGE_REF` (from `@wildo-ai/saas-website`: a plain constant, which loads nothing of the MDX graph;
144
+ the bridge factory, `createWebsiteBlogPostBridgeIsland`, comes from the blog-only `@wildo-ai/saas-website/mdx`, and
145
+ `/astro-island` deliberately does not export it, so a site with no blog never loads that graph),
122
146
  - `routePath: '/blog/[slug]'`,
123
147
  - `pageComponent: BlogPostPageStub` — a stub that throws if ever
124
148
  mounted (the framework renders `<BlogPost>` directly via the
@@ -140,8 +164,8 @@ Drop a `BLOG_POST_*_SECTION` definition into
140
164
  `website/src/sections/blog.sections.tsx` using the same
141
165
  `defineWebsiteSection({ category, expectedLabelKeys, Component })`
142
166
  shape every other section uses. Use `WebsiteSectionCategory.FOOTER_CTA`
143
- (or another existing enum value that fits) — the blog dogfood does
144
- NOT introduce a new category.
167
+ (or another existing enum value that fits) — a section embedded in a
168
+ post does NOT need a new category.
145
169
 
146
170
  Append `BLOG_POST_SECTIONS` to `WEBSITE_SECTIONS` (the
147
171
  aggregate registry the label-pack validator scans).
@@ -159,12 +183,16 @@ section can compose the absolute key from the ambient context.
159
183
 
160
184
  For each locale, `website/src/pages-impl/blog-post-<locale>.bridge.tsx`
161
185
  exports a single `BlogPostXxBridgeIsland` built from
162
- `createWebsiteBlogPostBridgeIsland({...})`. The factory closes over:
163
-
164
- - `slugToMdxBody` — built from `import.meta.glob('../content/blog/<locale>/*.mdx', { eager: true })`
165
- (the glob pattern MUST be a single string literal — Vite parses
166
- it AST-side at build time);
167
- - `navigation: WEBSITE_ROOT_CONFIG.navigation`;
186
+ `createWebsiteBlogPostBridgeIsland({...})` (from `@wildo-ai/saas-website/mdx`). The factory closes over:
187
+
188
+ - `slugToMdxBody` — built from
189
+ `import.meta.glob('../content/blog/<locale>/*.mdx', { eager: true, query: '?website-react-mdx' })`
190
+ (the pattern AND the options MUST be literals — Vite parses them AST-side at build time, so the query is written
191
+ out rather than imported; `WEBSITE_REACT_MDX_QUERY`, exported from `@wildo-ai/saas-website/mdx`, names the same
192
+ string for code that inspects a module id, and cannot stand in for the literal here). Without the query the glob
193
+ imports `@astrojs/mdx`'s Astro-JSX module, which the React island cannot render;
194
+ - `frontendProviderModules` — the site's generated provider modules, as every page bridge passes them;
195
+ - `navigation: { headerComponent: HeaderComponent, footerComponent: FooterComponent }`, imported directly (the root config's graph would pull every page into this island);
168
196
  - `mdxComponents: BLOG_POST_MDX_COMPONENTS`.
169
197
 
170
198
  Per-locale separation keeps each route's island bundle tight (an FR
@@ -177,22 +205,75 @@ the per-render primitive props:
177
205
 
178
206
  - `slug={frontmatter.slug}` — looked up against the bridge's
179
207
  `slugToMdxBody` map at island render time;
180
- - `rawFrontmatter={entry.data}` — re-validated by `<BlogPost>` on
208
+ - `rawFrontmatter={entry.data}` and `source={entry.id}` — re-validated by `<BlogPost>` on
181
209
  the React side;
210
+ - `cover={cover}`, from `await resolveWebsiteBlogPostCover(frontmatter)` (`@wildo-ai/saas-website/astro`): the
211
+ post's cover with its size, measured from `public/` for a site path. `<BlogPost>` draws the cover through
212
+ `WebsiteImage` at that size and refuses a post whose frontmatter names a cover it was given no size for;
182
213
  - `locale` / `defaultLocale` / `labelPack` / `designTokens` /
183
214
  `skipToMainContentLabelKey` from `loadWebsitePageRuntime(...)` +
184
- `WEBSITE_SITE_CONTEXT.rootConfig`.
215
+ `WEBSITE_SITE_CONTEXT.rootConfig`, where `loadWebsitePageRuntime` also receives
216
+ `routeParams: Astro.params`: the route is templated, so its parameters are what make the page's
217
+ structured-data context name this post's URL (a section that reads `pageUrl` without them is refused);
218
+ - `locales` (every locale the site ships) and `pageLocales` (the locales this post exists in), so the language
219
+ switcher sends a reader whose language has no translation to that language's home page;
220
+ - `routePath` (`/blog/<slug>`), and `appOrigin` and `frontendProviders` from `WEBSITE_SITE_CONTEXT`, as on every
221
+ page route.
185
222
 
186
223
  `getStaticPaths()` reads the `blog` collection, parses each
187
- entry's frontmatter (the collection schema is passthrough — Path Z),
224
+ entry's frontmatter (the collection schema is passthrough),
188
225
  filters by `frontmatter.locale === <this-locale>`, and emits
189
- `{ params: { slug }, props: { entry } }` for each match.
226
+ `{ params: { slug }, props: { entry, pageLocales } }` for each match.
227
+
228
+ The shell renders the head with `renderBlogPostHeadHtml({ …, frontmatter, words })`, where `words` is
229
+ `resolveWebsiteBlogPostWords({ authorRef, tags, vocabulary: BLOG_VOCABULARY, labelPack: runtime.labelPack })`: the
230
+ author's name and kind and each tag's word, which the head publishes as `article:author`, `article:tag` and the
231
+ JSON-LD `author` / `keywords`. It refuses an author or a tag the vocabulary does not declare — metadata a search
232
+ engine indexes must never carry a ref. `buildBlogPostStructuredDataPayload` (from `@wildo-ai/saas-website/astro`),
233
+ which a site calls in `structured-data/page-payloads.ts` so `wildo website audit` sees each post's `BlogPosting`,
234
+ requires the same `words`.
235
+
236
+ ### Step 6b: Declare the blog vocabulary — authors and tags by their words
237
+
238
+ A post names its author and tags by REF (`founding-team`, `security`): identifiers, never shown. Declare them once in
239
+ `website/src/blog-vocabulary.ts`:
240
+
241
+ ```ts
242
+ export const BLOG_VOCABULARY: WebsiteBlogVocabulary = {
243
+ authors: { 'founding-team': WebsiteBlogAuthorKind.ORGANIZATION },
244
+ tags: ['product', 'security'],
245
+ };
246
+ ```
247
+
248
+ Add `...websiteBlogVocabularyLabelKeys(BLOG_VOCABULARY)` to the root config's `chromeLabelKeys`, and author each
249
+ key in every pack: `website.chrome.blog-author.<ref>` (the byline's name) and `website.chrome.blog-tag.<tag>` (the
250
+ chip's word). The author's KIND is what the JSON-LD publishes: a team writing as itself is an `ORGANIZATION`, never a
251
+ person. `<BlogPost>` shows the byline and tags by these words and the date in the page's locale
252
+ (`formatWebsitePublicationDate`); a ref nobody authored shows as its key, which the label-pack check refuses at
253
+ build start.
254
+
255
+ ### Step 6c: The blog index and the BLOG page
256
+
257
+ A BLOG page (`/blog`) and a home page's latest posts read the **blog index**: the route builds it with
258
+ `await buildWebsiteBlogIndex(await getCollection('blog'), { locale, limit })` (from `@wildo-ai/saas-website/astro`:
259
+ it is build-time and async, because it resolves each listed post's cover with its size, measured from the file for a
260
+ site path) and passes it to the page bridge as
261
+ `blogIndex`; a section reads it with `useWebsiteBlogIndex()`, each entry carrying its `cover` with its size. See
262
+ `website-section-latest-posts`.
190
263
 
191
264
  ### Step 7: Author the MDX bodies
192
265
 
193
266
  Per-post: `website/src/content/blog/<locale>/<slug>.mdx` with the
194
267
  required frontmatter (see structured-data contract below) and a
195
- body that may embed any registered MDX tag inline:
268
+ body that may embed any registered MDX tag inline. The body's headings start at `##`: `<BlogPost>` renders the
269
+ frontmatter `title` as the page's only `<h1>`, so a `#` in the body is a second one.
270
+
271
+ Write what the product does today. A post is read as the company's word: every capability, figure and date in it
272
+ must be true of the application when it is published, and a plan is written as a plan.
273
+
274
+ A cover is a 1200×630 PNG or JPEG in `website/public/blog/covers/<slug>.png`, named in the frontmatter as the site
275
+ path `/blog/covers/<slug>.png` (the head renderer makes it absolute for `og:image`; most social networks do not read
276
+ SVG there). An illustration without text needs no translation, so both locales share it.
196
277
 
197
278
  ```mdx
198
279
  ## Section heading
@@ -209,6 +290,16 @@ section ref is hard-coded inside `BLOG_POST_MDX_COMPONENTS`; the
209
290
  attribute is informational only (a future evolution could multiplex
210
291
  variants from the prop).
211
292
 
293
+ ### Step 7b: Leave the post's look to the theme
294
+
295
+ The engine draws the post from the site's theme: the article at the prose measure, the title at the section
296
+ heading's size, the cover, summary, byline and tags, and the prose's headings, lists, tables and quotes. A band the body
297
+ embeds stands inside the column, inset and rounded. So a post needs no stylesheet of its own. A site that reads its
298
+ posts differently writes a few unlayered rules against `article[data-website-blog-post-slug]` and the
299
+ `data-website-blog-post-*` hooks (`-cover`, `-summary`, `-meta`, `-author`, `-tags`), and nothing else. That site
300
+ stylesheet is unlayered, so a bare `article p` also beats the engine's colour for the summary in the post's opening.
301
+ Scope a body rule to the article's direct children (`article[data-website-blog-post-slug] > p`).
302
+
212
303
  ### Step 8: Author the label pack entries
213
304
 
214
305
  Add the section's `expectedLabelKeys` (and the page manifest's
@@ -218,18 +309,22 @@ build if ANY locale is missing one of the declared keys.
218
309
 
219
310
  ## Worked Example
220
311
 
221
- <!-- TIER C WAIVER: This block IS the canonical blog-adapter wiring — it shows BOTH the per-locale bridge factory call (closing over `slugToMdxBody` from a static-string-literal `import.meta.glob`, the navigation, and the MDX-tag registry) AND the matching `[slug].astro` shell (Path-Z `parseBlogPostFrontmatter` inside `getStaticPaths` for typed locale/slug access, frontmatter-driven `renderBlogPostHeadHtml`, single React island via `client:load`). The `<CTASection ref="post-cta" />` MDX tag closes the loop with `BLOG_POST_MDX_COMPONENTS`. Verification check #1 (`createWebsiteBlogPostBridgeIsland` per locale) and Common Rationalization #2 (single bridge factory call per locale) both reference this shape. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
312
+ <!-- TIER C WAIVER: This block IS the canonical blog-adapter wiring — it shows BOTH the per-locale bridge factory call (closing over `slugToMdxBody` from a static-string-literal `import.meta.glob` carrying the `?website-react-mdx` query, the provider modules, the navigation and the MDX-tag registry, all from `@wildo-ai/saas-website/mdx`) AND the matching `[slug].astro` shell (`parseBlogPostFrontmatter` inside `getStaticPaths` for typed locale/slug access, `renderBlogPostHeadHtml` with the post's `words` resolved through the blog vocabulary, a single React island via `client:load`). The MDX file closes the loop: `##` headings only, tags the vocabulary declares, a PNG cover, and the `<CTASection ref="post-cta" />` tag `BLOG_POST_MDX_COMPONENTS` registers. Verification and the grep invariants below check exactly this shape. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
222
313
  ```tsx
223
314
  // website/src/pages-impl/blog-post-en.bridge.tsx
224
315
  import type { ComponentType } from 'react';
225
316
 
226
- import { createWebsiteBlogPostBridgeIsland } from '@wildo-ai/saas-website/astro-island';
317
+ import { createWebsiteBlogPostBridgeIsland } from '@wildo-ai/saas-website/mdx';
227
318
 
228
- import { WEBSITE_ROOT_CONFIG } from '../website-root.config';
319
+ import { generatedFrontendProviderModules } from '../generated/frontend-providers.generated';
320
+ import { FooterComponent } from '../components/FooterComponent';
321
+ import { HeaderComponent } from '../components/HeaderComponent';
229
322
  import { BLOG_POST_MDX_COMPONENTS } from './blog-post.mdx-components';
230
323
 
231
324
  const rawModules = import.meta.glob('../content/blog/en/*.mdx', {
232
325
  eager: true,
326
+ // Compiled for React by `websiteBlogReactMdx()`; a literal, because Vite takes nothing else here.
327
+ query: '?website-react-mdx',
233
328
  }) as Record<string, { default: ComponentType<unknown> }>;
234
329
 
235
330
  const slugToMdxBody: Record<string, ComponentType<unknown>> = {};
@@ -239,8 +334,9 @@ for (const [path, mod] of Object.entries(rawModules)) {
239
334
  }
240
335
 
241
336
  export const BlogPostEnBridgeIsland = createWebsiteBlogPostBridgeIsland({
337
+ frontendProviderModules: generatedFrontendProviderModules,
242
338
  slugToMdxBody,
243
- navigation: WEBSITE_ROOT_CONFIG.navigation,
339
+ navigation: { headerComponent: HeaderComponent, footerComponent: FooterComponent },
244
340
  mdxComponents: BLOG_POST_MDX_COMPONENTS,
245
341
  });
246
342
  ```
@@ -253,40 +349,58 @@ import {
253
349
  loadWebsitePageRuntime,
254
350
  renderBlogPostHeadHtml,
255
351
  renderWebsiteDesignTokensCss,
352
+ resolveWebsiteBlogPostCover,
256
353
  } from '@wildo-ai/saas-website/astro';
354
+ import { resolveWebsiteBlogPostWords } from '@wildo-ai/saas-website';
257
355
  import { parseBlogPostFrontmatter } from '@wildo-ai/saas-website/mdx';
258
356
  import { BlogPostEnBridgeIsland } from '@/pages-impl/blog-post-en.bridge';
259
357
  import { BLOG_POST_PAGE_MANIFEST } from '@/pages-impl/blog-post.page';
358
+ import { BLOG_VOCABULARY } from '@/blog-vocabulary';
260
359
  import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
261
360
 
262
361
  export async function getStaticPaths() {
263
362
  const posts = await getCollection('blog');
264
363
  const defaultLocale = WEBSITE_SITE_CONTEXT.websiteConfig.defaultLocale;
265
- return posts
266
- .map((post) => ({
267
- post,
268
- frontmatter: parseBlogPostFrontmatter(post.data, { source: post.id }),
269
- }))
364
+ const parsed = posts.map((post) => ({
365
+ post,
366
+ frontmatter: parseBlogPostFrontmatter(post.data, { source: post.id }),
367
+ }));
368
+ return parsed
270
369
  .filter(({ frontmatter }) => frontmatter.locale === defaultLocale)
271
370
  .map(({ post, frontmatter }) => ({
272
371
  params: { slug: frontmatter.slug as string },
273
- props: { entry: post },
372
+ props: {
373
+ entry: post,
374
+ // The locales this post is translated into; the language switcher sends the others home.
375
+ pageLocales: parsed.filter((other) => other.frontmatter.slug === frontmatter.slug).map((other) => other.frontmatter.locale),
376
+ },
274
377
  }));
275
378
  }
276
379
 
277
- const { entry } = Astro.props;
380
+ const { entry, pageLocales } = Astro.props;
278
381
  const runtime = loadWebsitePageRuntime({
279
382
  manifest: BLOG_POST_PAGE_MANIFEST,
280
383
  siteContext: WEBSITE_SITE_CONTEXT,
281
384
  labelPacksDir: './src/i18n',
282
385
  astroLocale: Astro.currentLocale,
386
+ // The route is templated: its parameters make the page's structured-data context name THIS post's URL.
387
+ routeParams: Astro.params,
283
388
  });
284
389
  const frontmatter = parseBlogPostFrontmatter(entry.data, { source: entry.id });
390
+ // The cover with its size: measured from public/ for a site path, read from the frontmatter for a remote image.
391
+ const cover = await resolveWebsiteBlogPostCover(frontmatter);
285
392
  const headHtml = renderBlogPostHeadHtml({
286
393
  siteContext: WEBSITE_SITE_CONTEXT,
287
394
  locale: runtime.locale,
288
395
  routePath: `/blog/${frontmatter.slug}`,
289
396
  frontmatter,
397
+ // The author and tags as words, never their refs: they are published as article metadata and JSON-LD.
398
+ words: resolveWebsiteBlogPostWords({
399
+ authorRef: frontmatter.authorRef,
400
+ tags: frontmatter.tags,
401
+ vocabulary: BLOG_VOCABULARY,
402
+ labelPack: runtime.labelPack,
403
+ }),
290
404
  });
291
405
  const designTokensCss = renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootConfig.designTokens);
292
406
  ---
@@ -303,14 +417,20 @@ const designTokensCss = renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootCo
303
417
  client:load
304
418
  slug={frontmatter.slug}
305
419
  rawFrontmatter={entry.data}
420
+ cover={cover}
306
421
  source={entry.id}
307
422
  locale={runtime.locale}
308
423
  defaultLocale={runtime.defaultLocale}
424
+ locales={WEBSITE_SITE_CONTEXT.websiteConfig.locales.map((entry) => entry.locale)}
425
+ pageLocales={pageLocales}
426
+ routePath={`/blog/${frontmatter.slug}`}
427
+ appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}
309
428
  labelPack={runtime.labelPack}
310
429
  designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
311
430
  skipToMainContentLabelKey={WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey}
312
- appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}
431
+ frontendProviders={WEBSITE_SITE_CONTEXT.frontendProviders}
313
432
  legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}
433
+ servedPublicDocumentRefs={WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs}
314
434
  />
315
435
  </body>
316
436
  </html>
@@ -326,10 +446,10 @@ publishedAt: 2026-04-15T09:00:00.000Z
326
446
  authorRef: founding-team
327
447
  tags:
328
448
  - product
329
- - launch
449
+ coverImageUrl: /blog/covers/application-launching-early-access.png
330
450
  ---
331
451
 
332
- # Why we built Northstar Tasks
452
+ ## Why we built Northstar Tasks
333
453
 
334
454
  Most task trackers were designed for individuals first…
335
455
 
@@ -340,6 +460,10 @@ Most task trackers were designed for individuals first…
340
460
  Early access is invite-only this quarter while we onboard each team personally.
341
461
  ```
342
462
 
463
+ The body opens at `##`: the frontmatter `title` is the page's only `<h1>`. `founding-team` and `product` are both
464
+ declared in `BLOG_VOCABULARY` (Step 6b); a tag it does not declare makes `resolveWebsiteBlogPostWords` throw, and the
465
+ route fails to build.
466
+
343
467
  ## Frontmatter contract
344
468
 
345
469
  Every post's frontmatter MUST satisfy `BlogPostFrontmatterSchema`
@@ -355,9 +479,10 @@ references file below for the excerpt.
355
479
  | `slug` | ✅ | Lowercase kebab-case, ≤ 96 chars. Cross-locale identity. MUST match the filename. |
356
480
  | `locale` | ✅ | `AvailableLanguage` enum value (e.g. `en`, `fr`). MUST match the parent directory. |
357
481
  | `publishedAt` | ✅ | ISO-8601 date-time string. Renders into `article:published_time`. |
358
- | `authorRef` | ✅ | Lowercase kebab-case, ≤ 64 chars. Free identifier (no author registry yet). |
359
- | `tags` | ✅ | Array of lowercase kebab-case tags (may be empty). Renders into repeated `article:tag` lines. |
360
- | `coverImageUrl` | ⛔ optional | Valid URL. Drives `og:image` + Twitter `summary_large_image` card. |
482
+ | `authorRef` | ✅ | Lowercase kebab-case, ≤ 64 chars. Declared, with its kind, in the site's `BLOG_VOCABULARY`; shown by its name (`website.chrome.blog-author.<ref>`). |
483
+ | `tags` | ✅ | Array of lowercase kebab-case tags (may be empty), each declared in `BLOG_VOCABULARY`; shown and published by their words (`website.chrome.blog-tag.<tag>`). |
484
+ | `coverImageUrl` | ⛔ optional | An absolute URL or a site path (`/blog/covers/<slug>.png`). Drives the post's cover, its index card, `og:image` (made absolute) and the `summary_large_image` card. A site path's size is measured from the file at build time. |
485
+ | `coverImageWidth` / `coverImageHeight` | for a remote cover | Whole pixels, both, REQUIRED for an absolute-URL cover (the build cannot open it) and REFUSED for a site path (measured from the file, so a typed size would drift). |
361
486
 
362
487
  Validation runs at the top of every `<BlogPost>` render via
363
488
  `parseBlogPostFrontmatter(entry.data, { source: entry.id })`. A
@@ -370,14 +495,17 @@ The blog adapter emits **`og:type=article`** + the `article:*`
370
495
  metadata block (NOT `og:type=website`):
371
496
 
372
497
  - `article:published_time` (from `frontmatter.publishedAt`),
373
- - `article:author` (from `frontmatter.authorRef`),
374
- - one `article:tag` per `frontmatter.tags[]` entry.
498
+ - `article:author` (the author's NAME, from the blog vocabulary's label),
499
+ - one `article:tag` per tag, by its WORD.
500
+
501
+ The JSON-LD `BlogPosting` publishes `author` with the vocabulary's kind (`Person` or `Organization`) and name,
502
+ `keywords` from the tags' words, and `image` as an absolute URL.
375
503
 
376
504
  `article:section` is intentionally NOT emitted — the framework has
377
505
  no blog-section taxonomy yet (a future "category" frontmatter field
378
506
  would feed it).
379
507
 
380
- JSON-LD `BlogPosting` / `Article` emission is in scope and covered
508
+ JSON-LD `BlogPosting` emission (never `Article`, see below) is in scope and covered
381
509
  by the `website-seo-aeo-geo` skill. The `BlogPosting` deferral noted
382
510
  in earlier revisions of this SKILL is REPLACED by the catalog
383
511
  integration described below.
@@ -393,9 +521,12 @@ Schema.org catalog at
393
521
  the installed `BLOG_POSTING_CATALOG_ENTRY` contract
394
522
  (`BLOG_POSTING_CATALOG_ENTRY`). The catalog declares:
395
523
 
396
- - **Required**: `headline`, `datePublished`, `author` — all three
397
- resolve from blog frontmatter (`title`, `publishedAt`,
398
- `authorRef`).
524
+ - **Required**: `headline`, `datePublished`, `author` — `headline` and
525
+ `datePublished` come from the frontmatter (`title`, `publishedAt`);
526
+ `author` comes from the post's `words`: the frontmatter's `authorRef`
527
+ resolved through `BLOG_VOCABULARY` to its kind (`Person` or
528
+ `Organization`) and its name (`website.chrome.blog-author.<ref>`) —
529
+ never the ref itself.
399
530
  - **Optional**: `image`, `dateModified`, `wordCount`, `keywords`,
400
531
  `articleSection`, `inLanguage`, `publisher`, `description` —
401
532
  `recommendOptionals: true`, so `wildo website audit` lists the missing ones as recommendations (information, never a finding, never failing `--strict`) — richer payloads earn
@@ -407,7 +538,11 @@ The engine wires emission through `renderBlogPostHeadHtml` (the
407
538
  blog-post-specific page-shell renderer, sibling to
408
539
  `renderWebsitePageHeadHtml`), which calls
409
540
  `renderPageStructuredData()` with a single page-level `BlogPosting`
410
- payload built from the post's frontmatter. The payload includes a
541
+ payload built from the post's frontmatter and its `words`. The same
542
+ payload comes from `buildBlogPostStructuredDataPayload({ frontmatter,
543
+ words, canonicalUrl, siteOrigin, siteName, locale })`, which the site's
544
+ `structured-data/page-payloads.ts` calls so `wildo website audit` checks
545
+ every post; it requires `words` for the same reason. The payload includes a
411
546
  minimal inline `publisher` organization (`@type`, `name`, `url`) so
412
547
  blog routes stand alone even when they do not emit the landing-page
413
548
  organization graph.
@@ -436,14 +571,14 @@ organization graph.
436
571
  type="application/ld+json">` blocks (they'd duplicate or drift
437
572
  from the framework-emitted payload).
438
573
  - Open Graph metadata — that's a separate emission via
439
- `renderBlogPostHeadHtml` (`og:type=article` etc., unchanged from
440
- Phase 7).
574
+ `renderBlogPostHeadHtml` (`og:type=article` etc.).
441
575
 
442
576
  **Verification grep** (run from the app root):
443
577
 
444
578
  | Invariant | Command |
445
579
  |---|---|
446
- | Blog page emits structured data via the framework | `rg -n "renderBlogPostHeadHtml" website/src/pages-impl/` (must return ≥1) |
580
+ | Blog page emits structured data via the framework | `rg -n "renderBlogPostHeadHtml" website/src/pages/ --glob '**/blog/\[slug\].astro'` (must return one per locale) |
581
+ | The audit sees every post's `BlogPosting` | `rg -n "buildBlogPostStructuredDataPayload" website/src/structured-data/` (must return ≥1) |
447
582
  | No inline JSON-LD inside MDX | `rg -n "application/ld\\+json" website/src/content/blog/` (must return 0) |
448
583
  | `dateCreated` deprecation respected | `rg -n "dateCreated" website/src/` (must return 0; use `datePublished`) |
449
584
 
@@ -479,19 +614,34 @@ retrieval framing. Curate it intentionally.
479
614
  ## References
480
615
 
481
616
  - `references/blog-adapter-api.md` — source-backed excerpts of the
482
- five engine entry points (`<BlogPost>`, `<WebsiteMdxProvider>`,
483
- `buildBlogPostCollectionConfig` / `parseBlogPostFrontmatter`,
484
- `renderBlogPostHeadHtml`, `createWebsiteBlogPostBridgeIsland`) +
485
- the frontmatter schema. Pulled via `saas.website.blog.*`
486
- source-backed website contract references.
617
+ blog adapter's contracts: the frontmatter schema, `<BlogPost>`,
618
+ `<WebsiteMdxProvider>`, `buildBlogPostCollectionConfig` /
619
+ `parseBlogPostFrontmatter`, `renderBlogPostHeadHtml` and
620
+ `buildBlogPostStructuredDataPayload`, `createWebsiteBlogPostBridgeIsland`,
621
+ `websiteBlogReactMdx()` and the `?website-react-mdx` query, the blog
622
+ vocabulary, `formatWebsitePublicationDate`, a post's cover and its size
623
+ (`WebsiteBlogPostCover`, `resolveWebsiteBlogPostCover`), and the blog index
624
+ (`buildWebsiteBlogIndex`, `useWebsiteBlogIndex`).
487
625
 
488
626
  ## Verification
489
627
 
490
- - [ ] `mdx()` integration is registered BEFORE `react()` in
491
- `astro.config.ts`.
492
- - [ ] `src/content/config.ts` calls
493
- `buildBlogPostCollectionConfig({ astroZ: z })` (NOT a
494
- hand-mirrored Zod schema).
628
+ - [ ] `mdx()`, `websiteBlogReactMdx()`, `react()` are registered in that order in
629
+ `astro.config.ts`, and every bridge's glob passes `query: '?website-react-mdx'`.
630
+ - [ ] Every post's `authorRef` and tags are declared in `BLOG_VOCABULARY`, whose keys are in `chromeLabelKeys`
631
+ and authored in every pack.
632
+ - [ ] Every `[slug].astro` shell passes `words: resolveWebsiteBlogPostWords(...)` to `renderBlogPostHeadHtml`, and
633
+ `structured-data/page-payloads.ts` passes them to `buildBlogPostStructuredDataPayload`.
634
+ - [ ] `createWebsiteBlogPostBridgeIsland` is imported from `@wildo-ai/saas-website/mdx`, and `BLOG_POST_PAGE_REF` from
635
+ `@wildo-ai/saas-website`.
636
+ - [ ] Every cover is a PNG or JPEG (never SVG: most social networks do not read SVG as `og:image`).
637
+ - [ ] Every `[slug].astro` shell resolves the cover with `await resolveWebsiteBlogPostCover(frontmatter)` and passes
638
+ `cover={cover}` to the bridge island; a remote cover declares `coverImageWidth` and `coverImageHeight`, a
639
+ site-path cover declares neither.
640
+ - [ ] No post body has a `#` heading (the title is the page's `<h1>`).
641
+ - [ ] `src/content.config.ts` spreads
642
+ `buildBlogPostCollectionConfig({ astroZ: z, glob })` (NOT a
643
+ hand-mirrored Zod schema, and no `type: 'content'`): check with
644
+ `rg -n "type: 'content'" website/src` (must return empty).
495
645
  - [ ] `BLOG_POST_PAGE_MANIFEST` is registered in
496
646
  `WEBSITE_ROOT_CONFIG.pageManifests` and uses
497
647
  `ref: BLOG_POST_PAGE_REF` (NOT a literal `'blog-post'`).
@@ -499,12 +649,15 @@ retrieval framing. Curate it intentionally.
499
649
  `BLOG_POST_MDX_COMPONENTS` exposes.
500
650
  - [ ] One bridge module per locale, each calling
501
651
  `createWebsiteBlogPostBridgeIsland(...)` exactly once.
502
- - [ ] Every bridge's `import.meta.glob('...content/blog/<locale>/*.mdx', { eager: true })`
503
- uses a STATIC string-literal pattern (no concatenation, no
504
- variable interpolation).
652
+ - [ ] Every bridge's `import.meta.glob('../content/blog/<locale>/*.mdx', { eager: true, query: '?website-react-mdx' })`
653
+ uses a STATIC string-literal pattern and literal options (no concatenation, no
654
+ variable interpolation, no imported constant).
505
655
  - [ ] Every `[slug].astro` shell calls `parseBlogPostFrontmatter`
506
656
  inside `getStaticPaths` so locale/slug filtering is typed and
507
657
  validated at build start.
658
+ - [ ] Every `[slug].astro` shell passes `routeParams: Astro.params` to
659
+ `loadWebsitePageRuntime`, so the post page's structured-data context
660
+ names the post's URL.
508
661
  - [ ] Every `[slug].astro` shell mounts the bridge island with
509
662
  `client:load` (matches the manifest's
510
663
  `WebsitePageHydrationStrategy.EAGER`).
@@ -524,7 +677,14 @@ retrieval framing. Curate it intentionally.
524
677
  |---|---|
525
678
  | One bridge factory call per locale | see the commands below the table (must equal locale count) |
526
679
  | Static-string-literal globs only | see the commands below the table (must return empty) |
527
- | MDX integration ordering | see the commands below the table (the `mdx()` line must precede the `react()` line) |
680
+ | MDX integration ordering | see the commands below the table (in that order) |
681
+ | Bodies compiled for React | `rg -n "query: '\?website-react-mdx'" website/src/pages-impl/blog-post-*.bridge.tsx` (one per locale) |
682
+ | Blog factories from the blog entry point | `rg -n "from '@wildo-ai/saas-website/astro-island'" website/src/pages-impl/blog-post*` (must return empty) |
683
+ | Head and payload carry words | `rg -n "words:" website/src/pages/ website/src/structured-data/` (one per `[slug].astro`, plus the payloads file) |
684
+ | Templated route passes its parameters | `rg -n "routeParams: Astro.params" website/src/pages/` (one per `[slug].astro`) |
685
+ | No SVG cover | `rg -n "coverImageUrl: .*\.svg" website/src/content/blog/` (must return empty) |
686
+ | Cover resolved and passed | see the commands below the table (two per `[slug].astro`) |
687
+ | One `<h1>` per post | `rg -n "^# " website/src/content/blog/` (must return empty) |
528
688
  | Page manifest registered | `rg -n "BLOG_POST_PAGE_MANIFEST" website/src/website-root.config.ts` (must return ≥1 inside `pageManifests`) |
529
689
  | Frontmatter slug matches filename | per file: `rg -n "^slug: " website/src/content/blog/<locale>/<slug>.mdx` (the YAML `slug:` value must equal the basename) |
530
690
 
@@ -536,27 +696,36 @@ rg -n "createWebsiteBlogPostBridgeIsland\(" website/src/pages-impl/blog-post-*.b
536
696
  rg -n "import\.meta\.glob\(" website/src/pages-impl/blog-post-*.bridge.tsx | rg -v "'\.\./content/blog/[a-z-]+/\*\.mdx'"
537
697
 
538
698
  # MDX integration ordering
539
- rg -n "mdx\(\)|react\(\)" website/astro.config.ts
699
+ rg -n "mdx\(\)|websiteBlogReactMdx\(\)|react\(\)" website/astro.config.ts
700
+
701
+ # Cover resolved and passed
702
+ rg -n "resolveWebsiteBlogPostCover\(frontmatter\)|cover=\{cover\}" website/src/pages/
540
703
  ```
541
704
 
542
705
  ## Common Rationalizations
543
706
 
544
707
  | Rationalization | Reality |
545
708
  |---|---|
546
- | "I'll author the frontmatter Zod schema directly in `src/content/config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change. Astro's bundled `z` is Zod 3 and cannot share schema instances with the engine's Zod 4 — Path Z (passthrough at the collection layer + strict Zod 4 at render time) is the deliberate single-source-of-truth posture. |
709
+ | "I'll author the frontmatter Zod schema directly in `src/content.config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change. Astro's bundled `z` is Zod 3 and cannot share schema instances with the engine's Zod 4 — passthrough at the collection layer + strict Zod 4 at render time is the deliberate single-source-of-truth posture. |
710
+ | "I'll style the post page from scratch in the site stylesheet: the article width, the title, the table" | The engine already draws all of it from the theme, so a full restyle only creates a second copy that drifts from the tokens. Write only what this site reads differently, against the post's hooks (Step 7b). |
547
711
  | "I'll use one bridge module that globs ALL locales together" | Conflates the per-route island bundle (an FR visitor downloads the EN MDX bodies for no reason) AND removes the locale-clean separation `getStaticPaths` already enforces. Per-locale bridges keep the route bundle tight + match the per-locale `[slug].astro` shell shape. |
548
712
  | "I'll pass `mdxComponents` as an island prop instead of closing it over in the bridge factory" | The map values are `ComponentType` references — Astro's hydration boundary serializes props to JSON, and a `ComponentType` cannot survive serialization. Closing over them at module load time inside the factory is the only valid shape. |
549
713
  | "I'll skip the page manifest — there's no React `pageComponent` to mount" | The manifest is what the label-pack validator + bridge label-scoping read. Without it, the bridge ships the FULL pack to every blog post (payload bloat) AND the section's `expectedLabelKeys` are never enforced against per-locale packs. The "headless" stub `pageComponent` is the framework-mindset cost of the schema's non-null requirement; the loud-failure error makes the contract obvious. |
550
714
  | "I'll inline `<WebsiteSection>` inside the section's own `Component`" | Section components are props-less and read labels via leaf-relative `useWebsiteLabel(slot)` — the section ref MUST be established by an ambient `<WebsiteSection>`. The MDX-tag wrapper (in `BLOG_POST_MDX_COMPONENTS`) is where that wrapping lives, mirroring how page modules wrap each section before rendering its `Component`. |
551
- | "I'll switch to lazy globs (`{ eager: false }`) right now to keep bundles small" | YAGNI for the dogfood (≤ 10 posts). The factory's API is forward-compatible with lazy globs — wait until the bundle budget actually hurts (typically past ~50 posts), then swap to `React.lazy()` + `<Suspense>`. The migration is a consumer-side change, not an engine API break. |
715
+ | "The author ref is readable enough, show it" | It is an identifier: French readers get it in English, and search engines index it as a person's name. Declare its words. |
716
+ | "A post can mention what ships next quarter" | Then it says "next", without a date. A post is read as the company's word. |
717
+ | "I'll switch to lazy globs (`{ eager: false }`) right now to keep bundles small" | YAGNI for a young blog (≤ 10 posts). The factory's API is forward-compatible with lazy globs — wait until the bundle budget actually hurts (typically past ~50 posts), then swap to `React.lazy()` + `<Suspense>`. The migration is a consumer-side change, not an engine API break. |
718
+ | "Every cover is 1200×630, so I'll write that size in the frontmatter (or the CSS) instead of resolving it" | A site-path cover's size is measured from its file, and the frontmatter refuses a typed one: the day one image is replaced, a typed size reserves the wrong space or crops the picture. Resolve it with `resolveWebsiteBlogPostCover` and pass `cover`; only a remote cover, which the build cannot open, states its size. |
552
719
 
553
720
  ## Red Flags
554
721
 
722
+ - A post shell that mounts the bridge island without `cover={cover}`, or a cover drawn at a literal size — the
723
+ page refuses the first and the second drifts from the image; catch both with the "Cover resolved and passed" grep.
555
724
  - A blog post component that imports `~wildo-frontend-lib/**` or
556
725
  an undeclared deep package path — the installed website package is bundle-
557
- isolation-scanned. Use the framework's L1 primitives
726
+ isolation-scanned. Use the framework's primitives
558
727
  (`WebsiteHeading`, `WebsiteText`, `WebsiteInternalButton`, …) or
559
- override them via `website-primitive-overrides`.
728
+ the site's own components (`website-primitive-overrides`).
560
729
  - A `mdxComponents` map declared inline as a fresh object literal
561
730
  per render — `<MDXProvider>`'s context value is memoized off the
562
731
  map's identity; a per-render literal invalidates every embedded
@@ -577,6 +746,10 @@ rg -n "mdx\(\)|react\(\)" website/astro.config.ts
577
746
  - Two posts with the same `(slug, locale)` pair — the bridge map
578
747
  keys collide and one body silently shadows the other. Slugs are
579
748
  unique per locale by convention.
749
+ - A `[slug].astro` shell calling `loadWebsitePageRuntime` without
750
+ `routeParams` — a section that reads `pageUrl` on the post page is
751
+ refused at build, since the context only knows `/blog/[slug]`; catch
752
+ with the "Templated route passes its parameters" grep above.
580
753
 
581
754
  ## Related Skills
582
755