@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
@@ -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
  };
@@ -708,12 +723,15 @@ catalog, and the page route renders it through
708
723
 
709
724
  ### Step 5: Compose into a page
710
725
 
711
- Import the exported `HERO_SECTION` definition into the page module,
712
- and render it inside the page component as
713
- `<WebsiteSection sectionRef={HERO_SECTION.sectionRef}
714
- category={HERO_SECTION.category}><HERO_SECTION.Component {...heroProps}/></WebsiteSection>`.
715
- Register the section in the page manifest's `sections: […]` array so
716
- the label-pack validator can audit it.
726
+ Add the exported `HERO_SECTION` to the page's sections list
727
+ (`<PAGE>_SECTIONS` in `website/src/sections/<page>.sections.tsx`) at its
728
+ reading-order position, normally first. The page renders that list through
729
+ `<WebsitePageSections>`, which wraps each section in its `WebsiteSection` and
730
+ renders `Component` with NO props, and the manifest's `sectionRefs` derive from
731
+ the same list, so the label-pack validator audits it with no further edit.
732
+ A hero with a layout variant therefore binds the variant in its definition
733
+ (`Component: () => <HeroBody variant={HeroVariant.CENTERED} />`), never in the
734
+ page JSX.
717
735
 
718
736
  **Finish** after the hero compiles and renders without TypeScript errors,
719
737
  the page manifest includes the exported `HERO_SECTION`, and the homepage
@@ -908,7 +926,12 @@ a single block (last-wins).
908
926
  | Invariant | Command |
909
927
  |---|---|
910
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) |
911
- | 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
+ ```
912
935
 
913
936
  ## References
914
937
 
@@ -929,9 +952,9 @@ a single block (last-wins).
929
952
  `WebSite` / `Organization` (or omitted entirely).
930
953
  - [ ] Layout / variant choices live on the component's prop interface,
931
954
  NOT on the `WebsiteSectionDefinition`.
932
- - [ ] The exported `HERO_SECTION` is registered in the page manifest's
933
- `sections: […]` array and its `sectionRef` matches the
934
- `<WebsiteSection sectionRef=…>` wrapper used in the page JSX.
955
+ - [ ] The exported `HERO_SECTION` is an entry of the page's `<PAGE>_SECTIONS`
956
+ list, and the page renders that list through `<WebsitePageSections>`
957
+ rather than placing the hero in its JSX by hand.
935
958
 
936
959
  ### Grep invariants
937
960
 
@@ -141,6 +141,14 @@ compile-time prop checking.
141
141
  * and is caught by nothing until a reviewer reads the page. The
142
142
  * build and `wildo website audit` check the pack against the
143
143
  * DECLARED keys, so declare every slot the component reads.
144
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
145
+ * can target it. Belongs to the DEFINITION because a page renders its
146
+ * sections list through `WebsitePageSections`, which places every
147
+ * section itself: an anchor a page author would otherwise write on a
148
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
149
+ * valid HTML id that is also URL-fragment-safe: a letter, then
150
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
151
+ * to keep, like the id attribute it becomes.
144
152
  * - `Component` — the React component that renders the section. Typed
145
153
  * as `ComponentType<unknown>` here because schema-layer cannot lock
146
154
  * the component's prop shape (props vary per section). The factory
@@ -167,6 +175,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
167
175
  sectionRef: WebsiteSectionRefSchema,
168
176
  category: WebsiteSectionCategorySchema,
169
177
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
178
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
179
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
180
+ }).optional(),
170
181
  Component: z.unknown(),
171
182
  getStructuredData: z.unknown().optional(),
172
183
  });
@@ -255,6 +266,8 @@ export interface DefineWebsiteSectionInput<TProps> {
255
266
  sectionRef: WebsiteSectionRef | string;
256
267
  category: WebsiteSectionCategory;
257
268
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
269
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
270
+ anchorId?: string;
258
271
  Component: ComponentType<TProps>;
259
272
  /**
260
273
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -337,6 +350,7 @@ export function defineWebsiteSection<TProps>(
337
350
  sectionRef: input.sectionRef,
338
351
  category: input.category,
339
352
  expectedLabelKeys: input.expectedLabelKeys,
353
+ anchorId: input.anchorId,
340
354
  Component: input.Component,
341
355
  getStructuredData: input.getStructuredData,
342
356
  });
@@ -349,6 +363,7 @@ export function defineWebsiteSection<TProps>(
349
363
  sectionRef: parsed.sectionRef,
350
364
  category: parsed.category,
351
365
  expectedLabelKeys: parsed.expectedLabelKeys,
366
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
352
367
  Component: input.Component,
353
368
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
354
369
  };
@@ -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
  };
@@ -908,11 +923,16 @@ warns on drift (warning-only per D-AG4).
908
923
  |---|---|
909
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) |
910
925
  | Plans read from the catalogue | `rg -n "useWebsitePricingCatalog" website/src/sections/<page>.sections.tsx` (must return ≥1) |
911
- | 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) |
912
927
  | Catalogue passed to the island | `rg -n "pricingCatalog=" website/src/pages/pricing.astro` (must return ≥1) |
913
928
  | Offers derived | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
914
929
  | Audit passes | `wildo website audit --strict` (no finding for the pricing page) |
915
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
+
916
936
  ## Common Rationalizations
917
937
 
918
938
  | Rationalization | Reality |
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -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
  };
@@ -862,7 +877,12 @@ D-AG4).
862
877
  | Invariant | Command |
863
878
  |---|---|
864
879
  | Section emits structured data | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 when testimonials are rendered) |
865
- | 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
+ ```
866
886
 
867
887
  ## References
868
888
 
@@ -886,9 +906,14 @@ D-AG4).
886
906
  |---|---|
887
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) |
888
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 |
889
- | 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) |
890
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`) |
891
911
 
912
+ ```bash
913
+ # Image alt declared
914
+ rg -n "WebsiteImage" -A 2 website/src/sections/<page>.sections.tsx | rg -n "alt="
915
+ ```
916
+
892
917
  ## Common Rationalizations
893
918
 
894
919
  | Rationalization | Reality |
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -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,9 +569,17 @@ 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) |
570
- | Head renderer used in every page shell | `rg -L "renderWebsitePageHeadHtml" website/src/pages/*.astro` (each page shell must match — exclude `[slug].astro` blog shells which use `renderBlogPostHeadHtml`) |
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) |
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`) |
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
+ ```
571
583
 
572
584
  ## Common Rationalizations
573
585
 
@@ -58,6 +58,14 @@ the claim while still letting the framework collect/dedupe it centrally.
58
58
  * and is caught by nothing until a reviewer reads the page. The
59
59
  * build and `wildo website audit` check the pack against the
60
60
  * DECLARED keys, so declare every slot the component reads.
61
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
62
+ * can target it. Belongs to the DEFINITION because a page renders its
63
+ * sections list through `WebsitePageSections`, which places every
64
+ * section itself: an anchor a page author would otherwise write on a
65
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
66
+ * valid HTML id that is also URL-fragment-safe: a letter, then
67
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
68
+ * to keep, like the id attribute it becomes.
61
69
  * - `Component` — the React component that renders the section. Typed
62
70
  * as `ComponentType<unknown>` here because schema-layer cannot lock
63
71
  * the component's prop shape (props vary per section). The factory
@@ -84,6 +92,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
84
92
  sectionRef: WebsiteSectionRefSchema,
85
93
  category: WebsiteSectionCategorySchema,
86
94
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
95
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
96
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
97
+ }).optional(),
87
98
  Component: z.unknown(),
88
99
  getStructuredData: z.unknown().optional(),
89
100
  });
@@ -80,6 +80,8 @@ file.
80
80
  * - `false` → suppress publication even if the file exists
81
81
  * - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the
82
82
  * file exists, returns `null` when absent)
83
+ * - never while the file still carries `LLMS_TXT_UNAUTHORED_MARKER`,
84
+ * the scaffold's placeholder marker, whatever `enabled` says
83
85
  *
84
86
  * Keeping the "auto-detect when undefined" convention in the HELPER
85
87
  * (not as a schema default) is deliberate: schema defaults are static,
@@ -111,6 +113,15 @@ the config block is omitted.
111
113
 
112
114
  ```typescript
113
115
  *
116
+ * The marker the scaffold puts on every PLACEHOLDER line of `llms.txt` (the summary, the generic
117
+ * landing entry, the generic topic). A file still carrying it holds the template's instruction to a
118
+ * developer, not a description of the product, so it is never served: an AI assistant quoting it would
119
+ * repeat "Replace this line" as the product's summary. The marker sits on the line it guards, so
120
+ * replacing the line removes it, and a file is served once no placeholder is left.
121
+ */
122
+ export const LLMS_TXT_UNAUTHORED_MARKER = 'wildo:llms-txt-unauthored';
123
+
124
+ /**
114
125
  * Read the hand-authored `llms.txt` body for the marketing site.
115
126
  *
116
127
  * Publication policy:
@@ -118,6 +129,9 @@ the config block is omitted.
118
129
  * - `seo.llmsTxt?.enabled === true` → read the file if present, else `null`
119
130
  * - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
120
131
  * publish when the file exists, otherwise return `null`
132
+ * - in every case, a file still carrying {@link LLMS_TXT_UNAUTHORED_MARKER} → `null`. A route returns
133
+ * `new Response(null, { status: 404 })` for `null`: a prerendered route writes any non-null body
134
+ * to the build output, so a text body would be served as the file with status 200
121
135
  */
122
136
  export function readLlmsTxtBody(
123
137
  siteContext: WebsiteSiteContext,
@@ -135,7 +149,8 @@ export function readLlmsTxtBody(
135
149
  }
136
150
 
137
151
  try {
138
- return readFileSync(filePath, 'utf-8');
152
+ const body = readFileSync(filePath, 'utf-8');
153
+ return body.includes(LLMS_TXT_UNAUTHORED_MARKER) ? null : body;
139
154
  } catch (cause) {
140
155
  throw new Error(
141
156
  `[llms-txt-server] Could not read llms.txt at ${filePath}. ` +
@@ -77,7 +77,8 @@ preview branding).
77
77
  * mechanic: omitting the block means "auto-detect from file
78
78
  * presence" rather than "use a static schema default". The helper
79
79
  * `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`
80
- * exists and returns `null` otherwise.
80
+ * exists and carries no `LLMS_TXT_UNAUTHORED_MARKER`, and returns
81
+ * `null` otherwise.
81
82
  *
82
83
  * **Validation**:
83
84
  * - `siteName` is `z.string().min(1)` — empty strings would emit