@wildo-ai/framework-knowledge 1.1.8 → 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 (480) 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/composites-and-the-loop.md +9 -2
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  8. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
  9. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  10. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
  11. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
  12. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
  14. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
  15. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
  17. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  18. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  19. package/dist/esm/framework-knowledge.definitions.js +95 -5
  20. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  21. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  22. package/dist/esm/index.d.ts.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +41 -3
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +175 -14
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -3
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  40. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  45. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -2
  47. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +90 -13
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +8 -0
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  59. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  61. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  63. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  65. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  74. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
  78. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +91 -43
  80. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
  82. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
  84. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
  86. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
  87. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
  88. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
  89. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
  90. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -1
  94. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +27 -18
  96. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  97. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
  99. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +11 -11
  101. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -0
  103. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +3 -1
  105. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +3 -1
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
  113. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  117. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  121. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  124. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  125. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  127. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +7 -3
  129. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  130. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +71 -2
  131. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  132. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  133. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  134. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  135. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
  137. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  138. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
  139. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  140. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +9 -3
  141. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +3 -3
  143. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
  146. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +41 -17
  148. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  149. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  150. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  151. package/dist/knowledge/manifest.json +8 -8
  152. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +22 -7
  153. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
  155. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
  156. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  157. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  158. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
  159. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
  160. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
  161. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
  163. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
  164. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
  165. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
  166. package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
  167. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
  168. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  169. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  170. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
  171. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
  172. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  173. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  174. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
  175. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  176. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  177. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  178. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  179. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
  180. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  181. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  182. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  183. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  184. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  185. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  186. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  187. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
  188. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
  189. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
  190. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
  191. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
  192. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
  193. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
  194. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
  195. package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
  196. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
  197. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  198. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  199. package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
  200. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
  201. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  202. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  203. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
  204. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
  205. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
  206. package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
  207. package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
  208. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  209. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  210. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  211. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  212. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  213. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  214. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  215. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  216. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  217. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
  218. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  219. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  220. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  221. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  222. package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
  223. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
  224. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
  225. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
  226. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
  227. package/dist/knowledge/references/brand.name-choice.config.md +144 -0
  228. package/dist/knowledge/references/brand.name-screening.config.md +308 -0
  229. package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
  230. package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
  231. package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
  232. package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
  233. package/dist/knowledge/references/capability-composition.config.md +67 -4
  234. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  235. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  236. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  237. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  238. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  239. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  240. package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
  241. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  242. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  243. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  244. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  245. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  246. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  247. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  248. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  249. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  250. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  251. package/dist/knowledge/references/experience-plan.config.md +60 -7
  252. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  253. package/dist/knowledge/references/market.snapshot.validation.md +1 -1
  254. package/dist/knowledge/references/placement-plan.config.md +43 -0
  255. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  256. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  257. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  258. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  259. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  260. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  261. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  262. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  263. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  264. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  265. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
  266. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  267. package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
  268. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  269. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  270. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  271. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  272. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  273. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  274. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  275. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  276. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  277. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  278. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  279. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  280. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
  281. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  282. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  283. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  284. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  285. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
  286. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  287. package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
  288. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  289. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  290. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  291. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  292. package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
  293. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  294. package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
  295. package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
  296. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  297. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  298. package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
  299. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  300. package/dist/knowledge/references/website-plan.config.md +26 -0
  301. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  302. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  303. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  304. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  305. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  306. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  307. package/dist/knowledge/references/zod.factories.code.md +1 -0
  308. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  309. package/dist/knowledge/references/zod.factories.money.md +1 -0
  310. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  311. package/dist/knowledge/registries/framework-topics.json +374 -1
  312. package/dist/knowledge/registries/playbooks.json +76 -28
  313. package/dist/knowledge/registries/source-tags.json +1513 -898
  314. package/dist/knowledge/rules/live-context-door.md +5 -2
  315. package/dist/knowledge/skills/INDEX.md +5 -2
  316. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  317. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  318. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  319. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  320. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  321. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  322. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  323. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  324. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  325. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  326. package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
  327. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
  328. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
  329. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
  330. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  331. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  332. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  333. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  334. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  335. package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
  336. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
  337. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  338. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
  339. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  340. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  341. package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
  342. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  343. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  344. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  345. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  346. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  347. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  348. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  349. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  350. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  351. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  352. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
  353. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  354. package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
  355. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  356. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
  357. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
  358. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
  359. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
  360. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  361. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  362. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  363. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  364. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  365. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
  366. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
  367. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  368. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  369. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  370. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  371. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  372. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  373. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  374. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  375. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  376. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  377. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
  378. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
  379. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  380. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  381. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  382. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
  383. package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
  384. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  385. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  386. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  387. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  388. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  389. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  390. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  391. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  392. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  393. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  394. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  395. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  396. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  397. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  398. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  399. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  400. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  401. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  402. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  403. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  404. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  405. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  406. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  407. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  408. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  409. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  410. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  411. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  412. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  413. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  414. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  415. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  416. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  417. package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
  418. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  419. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
  420. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  421. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
  422. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  423. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  424. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  425. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
  426. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  427. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  428. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  429. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  430. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  431. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  432. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  433. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  434. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  435. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  436. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  437. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  438. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  439. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  440. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  441. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  442. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  443. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  444. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  445. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
  446. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  447. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  448. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  449. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  450. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  451. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  452. package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
  453. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  454. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  455. package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
  456. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
  457. package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
  458. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
  459. package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
  460. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
  461. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
  462. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
  463. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
  464. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
  465. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
  466. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
  467. package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
  468. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
  469. package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
  470. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
  471. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
  472. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
  473. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
  474. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
  475. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  476. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  477. package/dist/knowledge/topic-index.json +1590 -292
  478. package/dist/tsconfig.build.tsbuildinfo +1 -1
  479. package/dist/tsconfig.tsbuildinfo +1 -1
  480. 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'] = [
@@ -59,10 +59,19 @@ each with the skill that authors it. The plan split the page into sections on pu
59
59
 
60
60
  - **Author the page, not its sections.** Write the route, bridge, page component and manifest,
61
61
  register the page, and create `<page>.sections.tsx` with an empty sections list the page
62
- renders from — registered in `sections/index.ts` (re-exported, and spread into
62
+ renders from, DECLARED WITH ITS TYPE — `export const HOME_SECTIONS: readonly
63
+ WebsiteSectionDefinition[] = [];` — because an unannotated empty array is `never[]` and the
64
+ page that maps over it does not compile until the first section lands. Register it in
65
+ `sections/index.ts` (re-exported, and spread into
63
66
  `WEBSITE_SECTIONS`), or the label audit never sees the page's sections. Each section is its
64
67
  own build task, authored with its own `website-section-*` skill, and it adds itself to that
65
68
  list.
69
+ - **Render the list through `<WebsitePageSections pageRef="home" sections={HOME_SECTIONS} />`**,
70
+ never a hand-written `map`. While the list is empty the page shows a marked pending block, so
71
+ `astro dev` serves it, and the page visibly says its sections are still to come. `astro build`
72
+ refuses a page with no section: publish only once each page has one. A section an in-page link
73
+ targets (`<a href="#tiers">`) declares `anchorId: 'tiers'` in its `defineWebsiteSection` call;
74
+ the component turns it into the section's DOM `id`.
66
75
  - **Keep the plan's identities.** The plan says `page-home`; the tree spells the page `home`
67
76
  (`home.page.tsx`, `HOME_PAGE_MANIFEST`, `home.sections.tsx`). Section refs are used verbatim.
68
77
  - **Do not re-decide the message.** Purpose, audience and tone were decided from the market
@@ -89,10 +98,13 @@ each with the skill that authors it. The plan split the page into sections on pu
89
98
  see `website-section-faq`.
90
99
  3. In the route's frontmatter, forward BOTH origins to the bridge island from the
91
100
  site context — `appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` and
92
- `apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}`. The header's CTA
93
- throws without `appOrigin`, and consent is recorded through `apiOrigin` on every
94
- page. Never hardcode a host or port: the site-context loader settles both per
95
- 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`).
96
108
  4. Select section categories based on the information journey: orientation,
97
109
  proof, detail, objection handling and next action. Do not duplicate a
98
110
  section solely to repeat copy.
@@ -102,7 +114,14 @@ each with the skill that authors it. The plan split the page into sections on pu
102
114
  every locale pack the site publishes.
103
115
  7. Choose any page-owned structured data based on actual content. Add one
104
116
  concise canonical `llms.txt` entry that describes the page's purpose and
105
- 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.
106
125
  8. Run `wildo website audit`: it checks every locale pack against every page and
107
126
  section the site declares (a missing key fails, exactly as `astro build` does)
108
127
  and reconciles structured data against the application's Schema.org catalog.
@@ -531,6 +550,77 @@ function renderConsentSurface(
531
550
  }
532
551
  ```
533
552
 
553
+ ## Import Origins
554
+
555
+ - `@wildo-ai/saas-website`
556
+
557
+ ## Source Excerpts
558
+
559
+ ### Origin Package: `@wildo-ai/saas-website`
560
+
561
+ ```tsx
562
+ *
563
+ * `WebsitePageSections` — renders a page's ordered sections list, each inside its `WebsiteSection`
564
+ * wrapper, and a visible PENDING marker while the list is still empty.
565
+ *
566
+ * A page component should render its sections through this rather than mapping the list by hand:
567
+ *
568
+ * ```tsx
569
+ * export function PricingPage(): ReactNode {
570
+ * return <WebsitePageSections pageRef="pricing" sections={PRICING_SECTIONS} />;
571
+ * }
572
+ * ```
573
+ *
574
+ * **Why the empty state is the point.** A page's sections list starts EMPTY when its page
575
+ * is authored before its sections — the application-creation build lane does exactly that, one task
576
+ * per page and one per section. An empty page is a valid manifest and a dev server serves it; the
577
+ * production build refuses it (`assertWebsitePagesHaveSections`). Mapped by hand, an empty list
578
+ * renders nothing at all, which is indistinguishable from a page that failed. This renders a
579
+ * marked block instead, so the page visibly says its sections are still to come.
580
+ *
581
+ * A section's `anchorId`, declared on its definition, becomes the wrapper's DOM `id`, so in-page links
582
+ * still have a target when no page places its sections by hand.
583
+ *
584
+ * **The marker carries identifiers, not prose.** It shows the page ref and the empty list as code,
585
+ * deliberately: words a person reads come from the label packs, and a label for a state no built
586
+ * page can ever reach (the build refuses an empty page) would be a key every locale must carry for
587
+ * nothing. A missing section must LOOK missing, which a raw identifier does.
588
+ */
589
+ export interface WebsitePageSectionsProps {
590
+ /** The page's ref, as its manifest declares it. Shown in the pending marker. */
591
+ pageRef: string;
592
+ /** The page's ordered sections list — the same array its manifest's `sectionRefs` derive from. */
593
+ sections: readonly WebsiteSectionDefinition[];
594
+ }
595
+
596
+ export function WebsitePageSections({ pageRef, sections }: WebsitePageSectionsProps): ReactNode {
597
+ if (sections.length === 0) {
598
+ return (
599
+ <section
600
+ data-website-pending-page={pageRef}
601
+ aria-busy="true"
602
+ style={{ margin: '2rem auto', maxWidth: '48rem', padding: '2rem', border: '2px dashed currentColor', opacity: 0.6, textAlign: 'center' }}
603
+ >
604
+ <code>{`${pageRef}: sections = []`}</code>
605
+ </section>
606
+ );
607
+ }
608
+ return (
609
+ <>
610
+ {sections.map((section) => {
611
+ const SectionComponent = section.Component as React.ComponentType;
612
+ return (
613
+ <WebsiteSection key={String(section.sectionRef)} sectionRef={section.sectionRef} category={section.category} id={section.anchorId}>
614
+ <SectionComponent />
615
+ </WebsiteSection>
616
+ );
617
+ })}
618
+ </>
619
+ );
620
+ }
621
+ WebsitePageSections.displayName = 'WebsitePageSections';
622
+ ```
623
+
534
624
  These source-backed contracts are the page-manifest and structural composition
535
625
  authority for the workflow below.
536
626
 
@@ -549,10 +639,12 @@ authority for the workflow below.
549
639
  |---|---|
550
640
  | Page has a manifest declaration | `rg -n "defineWebsitePageManifest" website/src/pages-impl/` (must include the new page) |
551
641
  | Page is registered | `rg -n "_PAGE_MANIFEST" website/src/website-root.config.ts` (must include the new page) |
552
- | Every route forwards both origins | `rg -L "apiOrigin=\{WEBSITE_SITE_CONTEXT" website/src/pages --glob '*.astro'` (must print nothing) |
642
+ | Every route forwards both origins | `rg --files-without-match "apiOrigin=\{WEBSITE_SITE_CONTEXT" website/src/pages --glob '*.astro'` (must print nothing) |
553
643
  | No hardcoded host in pages | `rg -n "localhost:[0-9]" website/src --glob "!**/generated/**"` (must print nothing; the generated CSP legitimately names the local backend) |
554
- | Labels complete in every locale | `wildo website audit` (exit 0) |
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) |
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) |
555
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) |
556
648
 
557
649
  ## Common Rationalizations
558
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,
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };