@wildo-ai/framework-knowledge 1.1.9 → 1.1.10

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 (376) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  5. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  6. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  8. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  9. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.definitions.js +84 -4
  11. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  12. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  13. package/dist/esm/index.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +132 -20
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  25. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  27. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  29. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +85 -8
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  33. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  35. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  37. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  41. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  43. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  45. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  52. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  56. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +10 -4
  58. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  60. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  62. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  64. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  66. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  68. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  70. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  72. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  80. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  81. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  82. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  83. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  88. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  93. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  95. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  97. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  99. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
  103. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  104. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  105. package/dist/knowledge/manifest.json +7 -7
  106. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
  107. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  108. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  109. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +149 -11
  110. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
  111. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
  113. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +107 -11
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
  118. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  119. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  122. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  123. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  124. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
  125. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  126. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  127. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  128. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  129. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  130. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  131. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  132. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +7 -3
  133. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  135. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  136. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  137. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  138. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  139. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  140. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  141. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  142. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  143. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  144. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  145. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  150. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  152. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  153. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  154. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  157. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +19 -0
  158. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
  159. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  160. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  161. package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
  162. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  163. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  164. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  165. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  166. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  167. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  168. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  169. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  170. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  171. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  172. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  173. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  174. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  175. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  176. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  177. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  178. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  179. package/dist/knowledge/references/experience-plan.config.md +60 -7
  180. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  181. package/dist/knowledge/references/placement-plan.config.md +43 -0
  182. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  183. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  184. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  185. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  186. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  187. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  188. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  189. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  190. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  191. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  192. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  193. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  194. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  195. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  196. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  197. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  198. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  199. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  200. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  201. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  202. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  203. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  204. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  205. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  206. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  207. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  208. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  209. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  210. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  211. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  212. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  213. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  214. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  215. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  216. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  217. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  218. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  219. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  220. package/dist/knowledge/references/website-plan.config.md +26 -0
  221. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  222. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  223. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  224. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  225. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  226. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  227. package/dist/knowledge/references/zod.factories.code.md +1 -0
  228. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  229. package/dist/knowledge/references/zod.factories.money.md +1 -0
  230. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  231. package/dist/knowledge/registries/framework-topics.json +337 -1
  232. package/dist/knowledge/registries/playbooks.json +18 -18
  233. package/dist/knowledge/registries/source-tags.json +1435 -873
  234. package/dist/knowledge/rules/live-context-door.md +1 -1
  235. package/dist/knowledge/skills/INDEX.md +3 -1
  236. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  237. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  238. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  239. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  240. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  241. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  242. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  243. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  244. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  245. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  246. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  247. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  248. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  249. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
  250. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  251. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  252. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  253. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  254. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  255. package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
  256. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
  257. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  258. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  259. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  260. package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
  261. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  262. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  263. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  264. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  265. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  266. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  267. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  268. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  269. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  270. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  271. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
  272. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  273. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  274. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  275. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  276. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  277. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  278. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  279. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  280. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +11 -3
  281. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
  282. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  283. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  284. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  285. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  286. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  287. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  288. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  289. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  290. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  291. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  292. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  293. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  294. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  295. package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
  296. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  297. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  298. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  299. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  300. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  301. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  302. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  303. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  304. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  305. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  306. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  307. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  308. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  309. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  310. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  311. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  312. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  313. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  314. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  315. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  316. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  317. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  318. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  319. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  320. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  321. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  322. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  323. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  324. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  325. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  326. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  327. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  328. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  329. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  330. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  331. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  332. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  333. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  334. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  335. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  336. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  337. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  338. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  339. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  340. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  341. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  342. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  343. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  344. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  345. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  346. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  347. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  348. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  349. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  350. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  351. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  352. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  353. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  354. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  355. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
  356. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  357. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  358. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  359. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  360. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  361. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  362. package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
  363. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  364. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  365. package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
  366. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
  367. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
  368. package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
  369. package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
  370. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
  371. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
  372. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  373. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  374. package/dist/knowledge/topic-index.json +1441 -269
  375. package/dist/tsconfig.build.tsbuildinfo +1 -1
  376. package/package.json +4 -4
@@ -187,6 +187,13 @@ export interface WebsiteRuntimeContextValue {
187
187
  * place to change it.
188
188
  */
189
189
  appOrigin?: string;
190
+ /**
191
+ * Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
192
+ * by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
193
+ * island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
194
+ * and refuses to render when it is absent.
195
+ */
196
+ legalNoticeOwed?: boolean;
190
197
  /**
191
198
  * Flat `Record<string, string>` label pack for the active locale.
192
199
  * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
@@ -377,7 +384,12 @@ of a raw browser submission bypass.
377
384
  | Invariant | Command |
378
385
  |---|---|
379
386
  | No raw contact fetch bypass | `rg -n "fetch\(" website/src/sections/` (must be empty or use the approved public adapter) |
380
- | Form has declared form/session boundary | `rg -n "InboundContactForm\|getAnonymousSessionClient" website/src/sections/` (must return at least one result) |
387
+ | Form has declared form/session boundary | see the commands below the table (must return at least one result) |
388
+
389
+ ```bash
390
+ # Form has declared form/session boundary
391
+ rg -n "InboundContactForm|getAnonymousSessionClient" website/src/sections/
392
+ ```
381
393
 
382
394
  ## Common Rationalizations
383
395
 
@@ -512,9 +512,14 @@ to confirm that one main landmark remains.
512
512
 
513
513
  | Invariant | Command |
514
514
  |---|---|
515
- | One main landmark remains | `rg -n "<main|role=\"main\"" website/src/` (review every page result) |
515
+ | One main landmark remains | see the commands below the table (review every page result) |
516
516
  | Layout does not own page-specific copy | `rg -n "useWebsiteLabel" website/src/layouts/` (review scope; page copy belongs below) |
517
517
 
518
+ ```bash
519
+ # One main landmark remains — (review every page result)
520
+ rg -n "<main|role=\"main\"" website/src/
521
+ ```
522
+
518
523
  ## Common Rationalizations
519
524
 
520
525
  - “We can solve it globally because it is only a CSS change.” Global scope
@@ -165,6 +165,18 @@ export interface WebsiteSiteContext {
165
165
  * React island as JSON-serializable data.
166
166
  */
167
167
  readonly frontendProviders?: FrontendProvidersBlock;
168
+ /**
169
+ * Whether the operator owes a LEGAL NOTICE (imprint): derived by `loadWebsiteSiteContext` from
170
+ * `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts` with `legalNoticeOwed`, so the
171
+ * site and the application's `/legal-notice` page answer from the one declaration (#2588). `false` when the
172
+ * establishment is outside the EU, the EEA, the UK and Switzerland, or not declared yet.
173
+ *
174
+ * Every page forwards it to its bridge island beside `appOrigin`: the footer's legal links read it from
175
+ * `WebsiteRuntimeContext` and refuse to render without it, so a page that forgets it fails its build rather than
176
+ * dropping an obligation silently. Optional here only because a context composed by hand (a test) has no
177
+ * application config to derive it from; the loader always sets it.
178
+ */
179
+ readonly legalNoticeOwed?: boolean;
168
180
  }
169
181
 
170
182
  /**
@@ -202,6 +214,7 @@ export function composeWebsiteSiteContext(
202
214
  rootConfig: parts.rootConfig,
203
215
  websiteConfig: parts.websiteConfig,
204
216
  frontendProviders: parts.frontendProviders,
217
+ ...(parts.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: parts.legalNoticeOwed }),
205
218
  });
206
219
  }
207
220
  ```
@@ -264,7 +277,12 @@ key has an application-owned model/spec owner before wiring it into a section.
264
277
 
265
278
  | Invariant | Command |
266
279
  |---|---|
267
- | No secret-looking data in extra mapping | `rg -n "token|secret|password" website/src/sections/` (must be empty for metadata mapping) |
280
+ | No secret-looking data in extra mapping | see the commands below the table (must be empty for metadata mapping) |
281
+
282
+ ```bash
283
+ # No secret-looking data in extra mapping — (must be empty for metadata mapping)
284
+ rg -n "token|secret|password" website/src/sections/
285
+ ```
268
286
 
269
287
  ## Common Rationalizations
270
288
 
@@ -38,8 +38,8 @@ consequences flow from that:
38
38
  `FOOTER` value on purpose: chrome doesn't participate in the
39
39
  per-section SEO-dispatch contract, doesn't get a `data-section-ref`,
40
40
  and isn't authored under `website/src/sections/`. It's authored
41
- under `website/src/chrome/` and registered once for the entire
42
- site.
41
+ under `website/src/components/` (the scaffold's `HeaderComponent.tsx`
42
+ and `FooterComponent.tsx`) and registered once for the entire site.
43
43
  2. **They render OUTSIDE the page's `<main>`.** `WebsitePageLayout`
44
44
  emits `<header>{HeaderComponent}</header>` and
45
45
  `<footer>{FooterComponent}</footer>` around the `<main>` that
@@ -66,8 +66,8 @@ surface without buying isolation.
66
66
 
67
67
  | Surface | Glob (relative to app root) |
68
68
  | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
69
- | Header component | `website/src/chrome/SiteHeader.tsx` |
70
- | Footer component | `website/src/chrome/SiteFooter.tsx` |
69
+ | Header component | `website/src/components/HeaderComponent.tsx` (the scaffold's file) |
70
+ | Footer component | `website/src/components/FooterComponent.tsx` (the scaffold's file) |
71
71
  | Site-wide navigation registration | `website/src/website-root.config.ts` (the file that exports `WEBSITE_ROOT_CONFIG: WebsiteRootConfig`) |
72
72
  | Per-page chrome override (rare) | `website/src/pages-impl/<page-ref>.page.tsx` (passes `header={…}` / `footer={…}` to `<WebsitePageLayout>`) |
73
73
  | Site-wide chrome label keys | `website/src/i18n/<locale>.json` under the `website.chrome.`* synthetic page/section namespace (see `website-label-pack`) |
@@ -149,10 +149,18 @@ so the auto-prefix behavior is exactly the wrong contract. Read the
149
149
  locale list from `useWebsiteRuntime().locale` (the active locale)
150
150
  plus `WebsiteRootConfig.locales` injected as a prop or imported
151
151
  directly from your `website-root.config.ts`.
152
- - **Legal columns** — copyright, privacy, terms. Use
153
- `<WebsiteInternalLink routePath="/legal/privacy">` for in-app legal
154
- pages (locale-prefixed automatically); reserve `<WebsiteLink href=...
155
- external>` for cases where legal lives on a separate domain.
152
+ - **Legal links** — render `<WebsitePublicDocumentLinks />` once in the
153
+ footer. It links every public governed document the application serves
154
+ (its privacy notice and its terms) at the page the APPLICATION serves it
155
+ on, on the application's origin, plus the legal notice (imprint) when
156
+ the operator is established in the EU, the EEA, the UK or Switzerland; the site has no legal
157
+ pages of its own. Its labels are framework-owned keys
158
+ (`website.chrome.legal.*`) every locale pack must carry. Never
159
+ hand-write a `/privacy`, `/legal-notice` or `/legal/...` link: the paths
160
+ come from the constant the application's router mounts. Every page
161
+ forwards `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its
162
+ bridge island, beside `appOrigin`.
163
+ See `references/framework-public-document-links-api.md`.
156
164
  - **Social links** — always pass `external` to `WebsiteLink` so the
157
165
  primitive applies `rel="noopener noreferrer"` + `target="_blank"`
158
166
  automatically.
@@ -255,7 +263,12 @@ repeat the intentional primary route map there.
255
263
 
256
264
  | Invariant | Command |
257
265
  |---|---|
258
- | Primary nav URLs are surfaced in `llms.txt` | `rg -n "\\]\\(.*/(features|pricing|contact|blog)?\\)" website/src/content/llms.txt` (must include the current primary routes) |
266
+ | Primary nav URLs are surfaced in `llms.txt` | see the commands below the table (must include the current primary routes) |
267
+
268
+ ```bash
269
+ # Primary nav URLs are surfaced in `llms.txt` — (must include the current primary routes)
270
+ rg -n "\\]\\(.*/(features|pricing|contact|blog)?\\)" website/src/content/llms.txt
271
+ ```
259
272
 
260
273
  ## Cross-frontend handoff CTA pattern (D16)
261
274
 
@@ -296,7 +309,8 @@ per locale and is exercised from every page.
296
309
  | Footer column heading | `website.chrome.footer.<column-ref>.heading` (e.g. `product.heading`) |
297
310
  | Footer column link | `website.chrome.footer.<column-ref>.<link-ref>` |
298
311
  | Footer locale-switcher (a11y) | `website.chrome.footer.locale-switcher.label` |
299
- | Footer legal copyright | `website.chrome.footer.legal.copyright` |
312
+ | Footer copyright | `website.chrome.footer.copyright` |
313
+ | Legal links (framework-owned) | `website.chrome.legal.heading`, `website.chrome.legal.<document-id>` (e.g. `privacy-notice`, `service-terms`), `website.chrome.legal.legal-notice`; listed by `WEBSITE_LEGAL_LABEL_KEYS`, never in `chromeLabelKeys` |
300
314
  | Footer social link (a11y) | `website.chrome.footer.social.<network>` |
301
315
 
302
316
 
@@ -314,8 +328,9 @@ registration so chrome copy doesn't need a synthetic manifest entry.
314
328
  `header={null}` suppression escape hatch. Inline blocks were
315
329
  extracted to honor the inline-code-block discipline (Rule 10);
316
330
  promote them to `example.website.chrome.*` Tier A
317
- anchors when the consumer-side chrome lands in
318
- `website/src/chrome/`.
331
+ anchors when the consumer-side chrome is anchored in
332
+ `website/src/components/`.
333
+ - `references/framework-public-document-links-api.md` — source-backed `WebsitePublicDocumentLinks`, the footer's legal links.
319
334
  - The three runtime moving parts (slot schema, runtime carrier,
320
335
  layout resolution rules: per-page override → runtime fallback →
321
336
  explicit `null` suppression) are framework-internal. Refer to
@@ -326,8 +341,11 @@ registration so chrome copy doesn't need a synthetic manifest entry.
326
341
 
327
342
  ## Verification
328
343
 
329
- - Header / footer components live under `website/src/chrome/`,
344
+ - Header / footer components live under `website/src/components/`,
330
345
  not under `website/src/sections/` (chrome ≠ section).
346
+ - The footer renders `<WebsitePublicDocumentLinks />`, and no chrome file hand-writes a
347
+ `/privacy`, `/terms`, `/legal-notice` or `/legal/` link.
348
+ - Every page that renders a bridge island forwards `legalNoticeOwed` beside `appOrigin`.
331
349
  - Components are registered ONCE on `WebsiteRootConfig.navigation`
332
350
  (not per-page) — per-page overrides via `<WebsitePageLayout header={…} footer={…}>` are the exception, not the rule.
333
351
  - No `defineWebsiteSection(...)` call wraps a header/footer
@@ -356,12 +374,26 @@ don't pass the prop).
356
374
 
357
375
  | Invariant | Command |
358
376
  | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
359
- | Chrome lives outside `sections/` | `rg -l "useWebsiteLabel\(" website/src/chrome/` (must return empty — chrome must use `useWebsiteLabelByKey`) |
360
- | Chrome registered, not authored as a section | `rg -n "defineWebsiteSection" website/src/chrome/` (must return empty) |
377
+ | Chrome lives outside `sections/` | `rg -l "useWebsiteLabel\(" website/src/components/` (must return empty — chrome must use `useWebsiteLabelByKey`) |
378
+ | Chrome registered, not authored as a section | `rg -n "defineWebsiteSection" website/src/components/` (must return empty) |
361
379
  | Header CTA targets the handoff route | `rg -n "primaryCtaHref:" website/src/website-root.config.ts` (must reference `/auth/handoff` or the consumer's documented handoff path) |
362
- | Locale switcher uses `hrefLang` | `rg -n "hrefLang" website/src/chrome/SiteFooter.tsx` (must return ≥1) |
363
- | External social links are flagged | `rg -n "<WebsiteLink href=\"https" website/src/chrome/SiteFooter.tsx` (every match must also have `external`) |
364
- | Chrome never re-declares the landmark | `rg -n "<header\b\|<footer\b" website/src/components/ website/src/chrome/` (must return empty — the layout already emits both) |
380
+ | Locale switcher uses `hrefLang` | `rg -n "hrefLang" website/src/components/FooterComponent.tsx` (must return ≥1 when the site has a locale switcher) |
381
+ | External social links are flagged | `rg -n "<WebsiteLink href=\"https" website/src/components/FooterComponent.tsx` (every match must also have `external`) |
382
+ | The footer links the legal documents | `rg -n "WebsitePublicDocumentLinks" website/src/components/FooterComponent.tsx` (must return ≥1) |
383
+ | No hand-written legal link | see the commands below the table (must return empty — the component owns those paths) |
384
+ | Every page forwards `legalNoticeOwed` | see the commands below the table (must return empty) |
385
+ | Chrome never re-declares the landmark | see the commands below the table (must return empty — the layout already emits both) |
386
+
387
+ ```bash
388
+ # No hand-written legal link
389
+ rg -n "['\"]/(privacy|terms|legal-notice|legal/)" website/src
390
+
391
+ # Every page forwards `legalNoticeOwed`
392
+ comm -23 <(rg -l "appOrigin=" website/src/pages | sort) <(rg -l "legalNoticeOwed=" website/src/pages | sort)
393
+
394
+ # Chrome never re-declares the landmark
395
+ rg -n "<header\b|<footer\b" website/src/components/
396
+ ```
365
397
 
366
398
 
367
399
  ## Common Rationalizations
@@ -379,6 +411,11 @@ don't pass the prop).
379
411
 
380
412
  ## Red Flags
381
413
 
414
+ - **A footer without `WebsitePublicDocumentLinks`, or a hand-written `/privacy` / `/terms` / `/legal-notice` / `/legal/...`
415
+ link** — the legal pages are the application's, on its origin, and their paths come from the constant its router
416
+ mounts (catch with the **legal links** greps above).
417
+ - **A page forwarding `appOrigin` but not `legalNoticeOwed`** — its footer throws in the build, and a legal notice
418
+ the operator owes must not be dropped (catch with the **`legalNoticeOwed`** grep above).
382
419
  - **A `<header>` or `<footer>` element at the root of a chrome component** — the layout
383
420
  already emits that landmark, so the page gets two (catch with the **landmark** grep above).
384
421
  - **Hardcoded `<a href="https://...">` in chrome that targets the SaaS
@@ -0,0 +1,98 @@
1
+ # The footer's legal links (source-backed)
2
+
3
+ `WebsitePublicDocumentLinks` renders the site's legal links: the application's privacy notice and terms, each linked at
4
+ the page the application serves it on, on the application's origin, and its legal notice (imprint) when the operator
5
+ owes one.
6
+
7
+ Read this when:
8
+
9
+ - you are authoring or changing the site footer;
10
+ - you are about to write a `/privacy`, `/terms`, `/legal-notice`, `/imprint` or `/legal/...` link by hand (do not: render
11
+ this component);
12
+ - a locale pack fails the build on a missing `website.chrome.legal.*` key (add the label; the keys are framework-owned).
13
+
14
+ ## Import Origins
15
+
16
+ - `@wildo-ai/saas-website`
17
+
18
+ ## Source Excerpts
19
+
20
+ ### Origin Package: `@wildo-ai/saas-website`
21
+
22
+ ```tsx
23
+ *
24
+ * The site's LEGAL LINKS: one link per public governed document the application serves (its privacy notice and its
25
+ * terms), each to the page the application itself serves it at, on the APPLICATION's origin. Render it once in the
26
+ * site footer.
27
+ *
28
+ * Total over the public documents: a document the framework adds is linked by every site at its next build, and its
29
+ * label is a framework-owned key every locale pack must carry (`WEBSITE_LEGAL_LABEL_KEYS`). The page paths come from
30
+ * the same constant the application's router mounts, so a link cannot point where no page is.
31
+ *
32
+ * When the operator owes a LEGAL NOTICE (imprint) — established in the EU, the EEA, the UK or Switzerland, derived at build time from
33
+ * `operatorComplianceIdentity.establishmentJurisdiction` — a last link goes to the application's `/legal-notice` page.
34
+ * Directive 2000/31/EC Art. 5(1) wants that information "easily, directly and permanently accessible", which a footer
35
+ * link on every page is. An operator who owes none gets no link.
36
+ * spec-cite: Directive 2000/31/EC Art. 5(1)
37
+ *
38
+ * A same-tab link, not `external`: a legal page is something the visitor reads and comes back from, and an unexpected
39
+ * new window is the worse experience. The application's page shows the published document, or says plainly that it is
40
+ * not published yet.
41
+ *
42
+ * Throws when the page did not forward `appOrigin` or `legalNoticeOwed` to its bridge island, like the scaffold's
43
+ * `useAppOrigin`: a legal link pointing nowhere, or an owed one silently missing, must fail the build that produced
44
+ * it, not ship.
45
+ *
46
+ * Import from `@wildo-ai/saas-website`.
47
+ *
48
+ * @example
49
+ * // website/src/components/FooterComponent.tsx
50
+ * <WebsitePublicDocumentLinks className="wt-footer__legal" />
51
+ */
52
+ export function WebsitePublicDocumentLinks({ className }: WebsitePublicDocumentLinksProps): ReactNode {
53
+ const { appOrigin, legalNoticeOwed } = useWebsiteRuntime();
54
+ const headingId = useId();
55
+ const heading = useWebsiteLabelByKey(WEBSITE_LEGAL_LINKS_HEADING_LABEL_KEY);
56
+ const legalNoticeLabel = useWebsiteLabelByKey(WEBSITE_LEGAL_NOTICE_LABEL_KEY);
57
+ if (!appOrigin) {
58
+ throw new Error(
59
+ '[saas-website] WebsitePublicDocumentLinks needs the application origin. The page rendering it must forward '
60
+ + '`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to its bridge island.',
61
+ );
62
+ }
63
+ if (legalNoticeOwed === undefined) {
64
+ throw new Error(
65
+ '[saas-website] WebsitePublicDocumentLinks needs to know whether a legal notice is owed. The page rendering it '
66
+ + 'must forward `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its bridge island.',
67
+ );
68
+ }
69
+ const origin = appOrigin.replace(/\/+$/u, '');
70
+ return (
71
+ <nav aria-labelledby={headingId} className={className} data-website-legal-links="">
72
+ <span id={headingId} hidden>{heading}</span>
73
+ <ul>
74
+ {WEBSITE_PUBLIC_DOCUMENT_REF_NAMES.map((refName) => (
75
+ <WebsitePublicDocumentLink key={refName} refName={refName} href={`${origin}${PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS[PUBLIC_GOVERNED_DOCUMENT_REFS[refName]]}`} />
76
+ ))}
77
+ {legalNoticeOwed ? (
78
+ <li>
79
+ <WebsiteLink href={`${origin}${LEGAL_NOTICE_ROUTE_PATH}`}>{legalNoticeLabel}</WebsiteLink>
80
+ </li>
81
+ ) : null}
82
+ </ul>
83
+ </nav>
84
+ );
85
+ }
86
+ WebsitePublicDocumentLinks.displayName = 'WebsitePublicDocumentLinks';
87
+ ```
88
+
89
+ - The labels are `website.chrome.legal.heading` (the landmark's name, read by screen readers), one
90
+ `website.chrome.legal.<document-id>` per public document (`privacy-notice`, `service-terms`), and
91
+ `website.chrome.legal.legal-notice`. Author all of them in every locale pack, even when the operator owes no notice
92
+ today; do NOT list them in `chromeLabelKeys`, the framework adds them.
93
+ - The legal-notice link appears when `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts`
94
+ is in the EU, the EEA, the UK or Switzerland; the site-context loader derives it. Do not add or remove that link by hand. To change whether it
95
+ shows, change the declaration (see the `config-saas` skill's compliance declarations).
96
+ - The page must forward `appOrigin` and `legalNoticeOwed` to its bridge island, like every page the scaffold generates:
97
+ `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}`. Without either the component throws in the build, because a
98
+ legal link pointing nowhere, or an owed one silently missing, must not ship.
@@ -142,6 +142,7 @@ import {
142
142
  WebsiteText,
143
143
  WebsiteTextVariant,
144
144
  type WebsiteLabelKey,
145
+ WebsitePublicDocumentLinks,
145
146
  } from '@wildo-ai/saas-website';
146
147
  import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
147
148
 
@@ -157,7 +158,7 @@ type SiteFooterLink =
157
158
  | {
158
159
  kind: 'internal';
159
160
  labelKey: WebsiteLabelKey;
160
- /** Locale-NEUTRAL path (eg. `/legal/privacy`). */
161
+ /** Locale-NEUTRAL path (eg. `/pricing`). */
161
162
  routePath: string;
162
163
  }
163
164
  | {
@@ -225,8 +226,8 @@ function SocialLink({ link }: { link: { labelKey: WebsiteLabelKey; href: string
225
226
 
226
227
  export function SiteFooter({ columns, socialLinks, availableLocales }: SiteFooterProps) {
227
228
  const { locale: activeLocale } = useWebsiteRuntime();
228
- const legalCopyright = useWebsiteLabelByKey(
229
- 'website.chrome.footer.legal.copyright' as WebsiteLabelKey,
229
+ const copyright = useWebsiteLabelByKey(
230
+ 'website.chrome.footer.copyright' as WebsiteLabelKey,
230
231
  );
231
232
  const localeSwitcherLabel = useWebsiteLabelByKey(
232
233
  'website.chrome.footer.locale-switcher.label' as WebsiteLabelKey,
@@ -263,7 +264,10 @@ export function SiteFooter({ columns, socialLinks, availableLocales }: SiteFoote
263
264
  ))}
264
265
  </ul>
265
266
 
266
- <WebsiteText variant={WebsiteTextVariant.CAPTION}>{legalCopyright}</WebsiteText>
267
+ {/* The application's privacy notice and terms, on the application's origin: never hand-written links. */}
268
+ <WebsitePublicDocumentLinks />
269
+
270
+ <WebsiteText variant={WebsiteTextVariant.CAPTION}>{copyright}</WebsiteText>
267
271
  </div>
268
272
  );
269
273
  }
@@ -308,13 +312,6 @@ const FOOTER_COLUMNS: SiteFooterProps['columns'] = [
308
312
  { kind: 'internal', labelKey: 'website.chrome.footer.product.pricing' as WebsiteLabelKey, routePath: '/pricing' },
309
313
  ],
310
314
  },
311
- {
312
- headingKey: 'website.chrome.footer.legal.heading' as WebsiteLabelKey,
313
- links: [
314
- { kind: 'internal', labelKey: 'website.chrome.footer.legal.privacy' as WebsiteLabelKey, routePath: '/legal/privacy' },
315
- { kind: 'internal', labelKey: 'website.chrome.footer.legal.terms' as WebsiteLabelKey, routePath: '/legal/terms' },
316
- ],
317
- },
318
315
  ];
319
316
 
320
317
  const SOCIAL_LINKS: SiteFooterProps['socialLinks'] = [
@@ -98,10 +98,13 @@ each with the skill that authors it. The plan split the page into sections on pu
98
98
  see `website-section-faq`.
99
99
  3. In the route's frontmatter, forward BOTH origins to the bridge island from the
100
100
  site context — `appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` and
101
- `apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}`. The header's CTA
102
- throws without `appOrigin`, and consent is recorded through `apiOrigin` on every
103
- page. Never hardcode a host or port: the site-context loader settles both per
104
- build (see `references/framework-site-context-loader-api.md`).
101
+ `apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}` — and
102
+ `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}`. The header's CTA
103
+ throws without `appOrigin`, consent is recorded through `apiOrigin` on every
104
+ page, and the footer's legal links throw without `legalNoticeOwed` (they add
105
+ the legal-notice link when the operator owes one). Never hardcode a host or
106
+ port: the site-context loader settles all three per build (see
107
+ `references/framework-site-context-loader-api.md`).
105
108
  4. Select section categories based on the information journey: orientation,
106
109
  proof, detail, objection handling and next action. Do not duplicate a
107
110
  section solely to repeat copy.
@@ -111,7 +114,14 @@ each with the skill that authors it. The plan split the page into sections on pu
111
114
  every locale pack the site publishes.
112
115
  7. Choose any page-owned structured data based on actual content. Add one
113
116
  concise canonical `llms.txt` entry that describes the page's purpose and
114
- primary action rather than copying the whole page.
117
+ primary action rather than copying the whole page. The LANDING page's task
118
+ also owns the file's summary: replace the scaffold's summary line with one
119
+ sentence saying what the product is and who it is for, in the product's own
120
+ words, and replace (or delete) every other line carrying
121
+ `wildo:llms-txt-unauthored`. While any line carries it the site serves no
122
+ `llms.txt` at all, because the scaffold's placeholder is an instruction to
123
+ you, not a description of the product. Write only your own page's entry:
124
+ each page's task adds its own.
115
125
  8. Run `wildo website audit`: it checks every locale pack against every page and
116
126
  section the site declares (a missing key fails, exactly as `astro build` does)
117
127
  and reconciles structured data against the application's Schema.org catalog.
@@ -634,6 +644,7 @@ authority for the workflow below.
634
644
  | Page renders through `WebsitePageSections` | `rg --files-without-match "WebsitePageSections" website/src/pages-impl --glob '*.page.tsx' --glob '!blog-post.page.tsx'` (must print nothing; a hand-written map renders an empty page blank. The blog post page renders one post, not a sections list) |
635
645
  | Labels complete in every locale, no empty page | `wildo website audit` (exit 0; it fails a page with no section, which `astro build` refuses) |
636
646
  | Discovery entry is deliberate | `rg -n "^## " website/src/content/llms.txt` (must include the page title where public) |
647
+ | Discovery summary is authored | `rg -n "wildo:llms-txt-unauthored" website/src/content/llms.txt` (must print nothing once the landing page is built; while it prints, `/llms.txt` is not served) |
637
648
 
638
649
  ## Common Rationalizations
639
650
 
@@ -69,6 +69,8 @@ import {
69
69
  type WildoSaasConfig,
70
70
  } from '@wildo-ai/platform-config-lib';
71
71
 
72
+ import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
73
+
72
74
  import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
73
75
  import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
74
76
  import { loadWebsiteConfig, resolveStaticWebsiteServiceEntry } from './load-website-config';
@@ -159,6 +161,7 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
159
161
  artifactPath: resolveFrontendServicesArtifactPath(resolvePath(saasRoot)),
160
162
  serviceKey: websiteServiceKey,
161
163
  }),
164
+ legalNoticeOwed: legalNoticeOwed(saasConfig.operatorComplianceIdentity) === true,
162
165
  });
163
166
  }
164
167
  ```
@@ -283,9 +283,14 @@ and confirm section consumers use the declared primitive seam.
283
283
 
284
284
  | Invariant | Command |
285
285
  |---|---|
286
- | No clickable non-semantic primitive | `rg -n "onClick=.*<div|<div.*onClick" website/src/components/` (must be empty) |
286
+ | No clickable non-semantic primitive | see the commands below the table (must be empty) |
287
287
  | Link override preserves href | `rg -n "<a .*href=" website/src/components/` (review the matching link primitive) |
288
288
 
289
+ ```bash
290
+ # No clickable non-semantic primitive — (must be empty)
291
+ rg -n "onClick=.*<div|<div.*onClick" website/src/components/
292
+ ```
293
+
289
294
  ## Common Rationalizations
290
295
 
291
296
  - “It looks identical in the screenshot.” Screenshots do not prove keyboard,
@@ -928,7 +928,12 @@ D-AG4).
928
928
  |---|---|
929
929
  | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
930
930
  | FAQPage emitted | `rg -n "'FAQPage'" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
931
- | Anchor + JSON-LD ref consistency | `rg -oN "faq-[a-z-]+" website/src/sections/<page>.sections.tsx \| sort -u` (count must equal `FAQ_QUESTIONS.length`) |
931
+ | Anchor + JSON-LD ref consistency | see the commands below the table (count must equal `FAQ_QUESTIONS.length`) |
932
+
933
+ ```bash
934
+ # Anchor + JSON-LD ref consistency
935
+ rg -oN "faq-[a-z-]+" website/src/sections/<page>.sections.tsx | sort -u
936
+ ```
932
937
 
933
938
  ## Common Rationalizations
934
939
 
@@ -863,9 +863,14 @@ that an `ItemList` emission would currently trigger (until
863
863
  |---|---|
864
864
  | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
865
865
  | Category enum (no string literal) | `rg -n "FEATURE_BENEFIT_SUMMARY" website/src/sections/<page>.sections.tsx` (must return ≥1) |
866
- | Cell count consistent | `rg -oN "cell-\\d" website/src/sections/<page>.sections.tsx \| sort -u` (count must match section's documented arity) |
866
+ | Cell count consistent | see the commands below the table (count must match section's documented arity) |
867
867
  | Static label refs only | `rg -n "useWebsiteLabel\\(\`" website/src/sections/<page>.sections.tsx` (must return empty — dynamic refs hide from `expectedLabelKeys` audit) |
868
868
 
869
+ ```bash
870
+ # Cell count consistent
871
+ rg -oN "cell-\\d" website/src/sections/<page>.sections.tsx | sort -u
872
+ ```
873
+
869
874
  ## Common Rationalizations
870
875
 
871
876
  | Rationalization | Reality |
@@ -880,8 +880,16 @@ will emit a `catalog-miss` warning. The right resolution is to
880
880
  |---|---|
881
881
  | Factory used for each instance | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` |
882
882
  | Category enum | `rg -n "FEATURE_DETAIL" website/src/sections/<page>.sections.tsx` (must return ≥1 per instance) |
883
- | Image dimensions present | `rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx \| rg -n "width=\|height="` (each `WebsiteImage` must have both) |
884
- | Bullet leaves declared = consumed | `diff <(rg -oN "bullet-\\d" website/src/sections/<page>.sections.tsx \| sort -u) <(rg -oN "\`\\$\\{root\\}\\.bullet-\\d\`" website/src/sections/<page>.sections.tsx \| sed 's/.*\\.//;s/\`//' \| sort -u)` (must return empty — no orphan / missing bullet leaves) |
883
+ | Image dimensions present | see the commands below the table (each `WebsiteImage` must have both) |
884
+ | Bullet leaves declared = consumed | see the commands below the table (must return empty — no orphan / missing bullet leaves) |
885
+
886
+ ```bash
887
+ # Image dimensions present
888
+ rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx | rg -n "width=|height="
889
+
890
+ # Bullet leaves declared = consumed
891
+ diff <(rg -oN "bullet-\d" website/src/sections/<page>.sections.tsx | sort -u) <(rg -oN '`\$\{root\}\.bullet-\d`' website/src/sections/<page>.sections.tsx | sed 's/.*\.//;s/`//' | sort -u)
892
+ ```
885
893
 
886
894
  ## Common Rationalizations
887
895
 
@@ -926,7 +926,12 @@ a single block (last-wins).
926
926
  | Invariant | Command |
927
927
  |---|---|
928
928
  | Hero emits structured data on the landing page | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 for landing-page hero) |
929
- | Both `@type`s present | `rg -n "'WebSite'\|'Organization'" website/src/sections/<page>.sections.tsx` (must return ≥2) |
929
+ | Both `@type`s present | see the commands below the table (must return ≥2) |
930
+
931
+ ```bash
932
+ # Both `@type`s present
933
+ rg -n "'WebSite'|'Organization'" website/src/sections/<page>.sections.tsx
934
+ ```
930
935
 
931
936
  ## References
932
937
 
@@ -923,11 +923,16 @@ warns on drift (warning-only per D-AG4).
923
923
  |---|---|
924
924
  | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
925
925
  | Plans read from the catalogue | `rg -n "useWebsitePricingCatalog" website/src/sections/<page>.sections.tsx` (must return ≥1) |
926
- | No typed price in the website | `rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/src/pages-impl` (must return 0) |
926
+ | No typed price in the website | see the commands below the table (must return 0) |
927
927
  | Catalogue passed to the island | `rg -n "pricingCatalog=" website/src/pages/pricing.astro` (must return ≥1) |
928
928
  | Offers derived | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
929
929
  | Audit passes | `wildo website audit --strict` (no finding for the pricing page) |
930
930
 
931
+ ```bash
932
+ # No typed price in the website — (must return 0)
933
+ rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/src/pages-impl
934
+ ```
935
+
931
936
  ## Common Rationalizations
932
937
 
933
938
  | Rationalization | Reality |
@@ -877,7 +877,12 @@ D-AG4).
877
877
  | Invariant | Command |
878
878
  |---|---|
879
879
  | Section emits structured data | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 when testimonials are rendered) |
880
- | Both `@type`s present | `rg -n "'Review'\|'AggregateRating'" website/src/sections/<page>.sections.tsx` (must return ≥2) |
880
+ | Both `@type`s present | see the commands below the table (must return ≥2) |
881
+
882
+ ```bash
883
+ # Both `@type`s present
884
+ rg -n "'Review'|'AggregateRating'" website/src/sections/<page>.sections.tsx
885
+ ```
881
886
 
882
887
  ## References
883
888
 
@@ -901,9 +906,14 @@ D-AG4).
901
906
  |---|---|
902
907
  | Factory used | `rg -n "defineWebsiteSection<?" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
903
908
  | Section's payloads are its own, and valid | This section's `getStructuredData` returns `Review` / `AggregateRating` (wrapping `Product` / `Organization` / `SoftwareApplication` only as `itemReviewed`); `wildo website audit` reports no finding for the page |
904
- | Image alt declared | `rg -n "WebsiteImage" -A 2 website/src/sections/<page>.sections.tsx \| rg -n "alt="` (every `WebsiteImage` must have alt) |
909
+ | Image alt declared | see the commands below the table (every `WebsiteImage` must have alt) |
905
910
  | Rating counts derived (no hardcoded `reviewCount`) | `rg -n "reviewCount: \\d+" website/src/sections/<page>.sections.tsx` (must return empty — `reviewCount` should always be `TESTIMONIALS.length`) |
906
911
 
912
+ ```bash
913
+ # Image alt declared
914
+ rg -n "WebsiteImage" -A 2 website/src/sections/<page>.sections.tsx | rg -n "alt="
915
+ ```
916
+
907
917
  ## Common Rationalizations
908
918
 
909
919
  | Rationalization | Reality |
@@ -267,7 +267,11 @@ export const GET: APIRoute = () => {
267
267
 
268
268
  - omitted / `{}` — auto-publish when the file exists;
269
269
  - `{ enabled: true }` — publish if present, otherwise 404;
270
- - `{ enabled: false }` — always disable publication.
270
+ - `{ enabled: false }` — always disable publication;
271
+ - in every case, a file still carrying `wildo:llms-txt-unauthored` (the scaffold's marker on each
272
+ placeholder line, `LLMS_TXT_UNAUTHORED_MARKER`) is not published until every placeholder line is
273
+ replaced. Return `new Response(null, { status: 404 })`, never a text body: a prerendered route
274
+ writes any body to the build, and it would be served with 200.
271
275
 
272
276
  ### Step 5: Wire the `robots.txt` endpoint
273
277
 
@@ -565,10 +569,18 @@ crawlers:
565
569
  | `llms.txt` endpoint in place | `rg -n "readLlmsTxtBody" website/src/pages/llms.txt.ts` (exactly 1 match) |
566
570
  | Robots endpoint in place | `rg -n "renderRobotsTxt" website/src/pages/robots.txt.ts` (exactly 1 match) |
567
571
  | Page shells use structured-data renderer | `rg -n "renderPageStructuredData" website/src/pages/**/*.astro website/src/pages/*.astro` (must return the static pages that emit JSON-LD) |
568
- | No hand-rolled robots.txt static | `ls website/public/ \| rg "^robots\.txt$"` (must return empty — the endpoint owns it) |
569
- | No hand-rolled sitemap static | `ls website/public/ \| rg "^sitemap.*\.xml$"` (must return empty — the integration owns it) |
572
+ | No hand-rolled robots.txt static | see the commands below the table (must return empty — the endpoint owns it) |
573
+ | No hand-rolled sitemap static | see the commands below the table (must return empty — the integration owns it) |
570
574
  | Head renderer used in every page shell | `rg --files-without-match "renderWebsitePageHeadHtml" website/src/pages/*.astro` (each page shell must match — exclude `[slug].astro` blog shells which use `renderBlogPostHeadHtml`) |
571
575
 
576
+ ```bash
577
+ # No hand-rolled robots.txt static
578
+ ls website/public/ | rg "^robots\.txt$"
579
+
580
+ # No hand-rolled sitemap static
581
+ ls website/public/ | rg "^sitemap.*\.xml$"
582
+ ```
583
+
572
584
  ## Common Rationalizations
573
585
 
574
586
  | Rationalization | Reality |