@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
@@ -285,6 +285,32 @@ export {
285
285
  WEBSITE_VISITOR_CONSENT_STORAGE_KEY,
286
286
  } from '../compliance/privacy/consent-purposes.shared';
287
287
 
288
+ /**
289
+ * The governed documents an application serves as public pages, and their paths (#2588) — read by the marketing
290
+ * website's footer, which links the privacy notice and the terms on the application's origin. Carved into an
291
+ * import-free atom (`public-governed-documents.shared.ts`) so the footer and the router that mounts those pages name
292
+ * them from ONE source: a website copying `'/privacy'` would be a second copy that drifts.
293
+ */
294
+ export {
295
+ LEGAL_NOTICE_ROUTE_PATH,
296
+ PUBLIC_GOVERNED_DOCUMENT_REFS,
297
+ PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS,
298
+ resolvePublicGovernedDocumentRoutePath,
299
+ type PublicGovernedDocumentRefName,
300
+ } from '../compliance/documents/public-governed-documents.shared';
301
+
302
+ /**
303
+ * Whether the operator owes a legal notice (imprint), derived from where it is established (#2588). The marketing
304
+ * website's build reads it to decide whether the footer links the application's `/legal-notice` page, from the same
305
+ * function the application's projection uses. An import-free atom over the import-free jurisdiction table.
306
+ */
307
+ export {
308
+ E_COMMERCE_DIRECTIVE_EEA_EFTA_STATES,
309
+ E_COMMERCE_INFORMATION_DUTY_OTHER_JURISDICTIONS,
310
+ legalNoticeOwed,
311
+ type LegalNoticeEstablishment,
312
+ } from '../compliance/privacy/legal-notice-obligation.shared';
313
+
288
314
  /**
289
315
  * The tier rule (#328) is enforced by every facet's `compose*Providers`,
290
316
  * three of which are browser-bound and reach this package only here. It
@@ -118,6 +118,8 @@ export interface SpecificationsCompanionExports<
118
118
  TIntegrationPlan = IntegrationPlan,
119
119
  // Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
120
120
  TApplicationMaturity = ApplicationMaturity,
121
+ // Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
122
+ TBrandNameScreening = BrandNameScreening,
121
123
  > {
122
124
  resourceSpecifications: TResourceSpecifications;
123
125
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -648,6 +650,14 @@ export interface SpecificationsCompanionExports<
648
650
  * never a gate. Read by the coherence report and the workbench.
649
651
  */
650
652
  applicationMaturity?: TApplicationMaturity;
653
+ /**
654
+ * WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
655
+ * registers, classes and jurisdictions searched, per-register results with sources and dates, and the
656
+ * competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
657
+ * `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
658
+ * brand name stands. A screening, never a legal clearance opinion.
659
+ */
660
+ brandNameScreening?: TBrandNameScreening;
651
661
  /**
652
662
  * Accepted application-declared semantic causality between whole
653
663
  * specification-family states. This is not the registry's physical
@@ -91,6 +91,7 @@
91
91
  * locale={runtime.locale}
92
92
  * defaultLocale={runtime.defaultLocale}
93
93
  * appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}
94
+ * legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}
94
95
  * apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}
95
96
  * labelPack={runtime.labelPack}
96
97
  * designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
@@ -270,6 +271,13 @@ export interface WebsitePageBridgeIslandProps {
270
271
  * the consumer's job and the whole point of removing the fallback.
271
272
  */
272
273
  appOrigin?: string;
274
+ /**
275
+ * Whether the operator owes a legal notice (imprint), forwarded into `WebsiteRuntimeContext.legalNoticeOwed` for the
276
+ * footer's legal links (#2588). An island prop for the reason `appOrigin` is one: the page reads it from
277
+ * `WEBSITE_SITE_CONTEXT.legalNoticeOwed`, derived at build time from `wildo.saas.config.ts`. Every page rendering
278
+ * the footer forwards it; the legal links refuse to render without it.
279
+ */
280
+ legalNoticeOwed?: boolean;
273
281
  /**
274
282
  * The application's public pricing catalogue (#1835), forwarded into
275
283
  * `WebsiteRuntimeContext.pricingCatalog` for `useWebsitePricingCatalog()`. Plain JSON-safe data
@@ -300,6 +308,7 @@ export function createWebsitePageBridgeIsland(
300
308
  frontendProviders,
301
309
  apiOrigin,
302
310
  appOrigin,
311
+ legalNoticeOwed,
303
312
  pricingCatalog,
304
313
  }: WebsitePageBridgeIslandProps): ReactNode {
305
314
  /*
@@ -330,6 +339,7 @@ export function createWebsitePageBridgeIsland(
330
339
  ...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
331
340
  apiOrigin,
332
341
  appOrigin,
342
+ ...(legalNoticeOwed !== undefined ? { legalNoticeOwed } : {}),
333
343
  ...(pricingCatalog !== undefined ? { pricingCatalog } : {}),
334
344
  };
335
345
  return (
@@ -205,6 +205,9 @@ function composeEffectiveChromeLabelKeys(
205
205
  // So is the provider-component slot's refusal wording (#1703): a site placing an address lookup must not
206
206
  // ship its consent-required or unavailable state as a raw key.
207
207
  for (const key of WEBSITE_PROVIDER_COMPONENT_LABEL_KEYS) set.add(key);
208
+ // And the legal links (#2588): one key per public governed document, so a document the framework adds is a missing
209
+ // label at the next build rather than a footer that cannot name it.
210
+ for (const key of WEBSITE_LEGAL_LABEL_KEYS) set.add(key);
208
211
  return Array.from(set);
209
212
  }
210
213
 
@@ -231,6 +234,12 @@ function composeEffectiveChromeLabelKeys(
231
234
  * `loadAndValidateAllLabelPacks` is what `wildo website audit` calls
232
235
  * when it wants programmatic access to the per-locale results.
233
236
  *
237
+ * **Empty pages**: it first refuses a page whose `sectionRefs` is empty
238
+ * (`assertWebsitePagesHaveSections`, #2205). That refusal used to live in
239
+ * the manifest schema, where it crashed `astro dev` too; this hook runs
240
+ * only at `astro:build:start`, which is where a page with nothing on it
241
+ * stops being unfinished and starts being wrong.
242
+ *
234
243
  * **Key-origin annotation**: every `missing` key is tagged with the
235
244
  * page (and, if section-scoped, the section) that declared it, so the
236
245
  * author can grep + open the right `defineWebsiteSection` /
@@ -242,6 +251,9 @@ export function assertLabelPacksValid(
242
251
  expectedKeysBySectionRef: ExpectedLabelKeysBySectionRef,
243
252
  ): void {
244
253
  const { rootConfig } = siteContext;
254
+ // The build-start hook every website wires, so the empty-page refusal arms with no config edit
255
+ // (#2205). First, because a page with no section has no label commitments to validate.
256
+ assertWebsitePagesHaveSections(rootConfig);
245
257
  const validations = loadAndValidateAllLabelPacks(
246
258
  packsDir,
247
259
  siteContext,
@@ -10,6 +10,15 @@
10
10
 
11
11
  ```typescript
12
12
  *
13
+ * The marker the scaffold puts on every PLACEHOLDER line of `llms.txt` (the summary, the generic
14
+ * landing entry, the generic topic). A file still carrying it holds the template's instruction to a
15
+ * developer, not a description of the product, so it is never served: an AI assistant quoting it would
16
+ * repeat "Replace this line" as the product's summary. The marker sits on the line it guards, so
17
+ * replacing the line removes it, and a file is served once no placeholder is left.
18
+ */
19
+ export const LLMS_TXT_UNAUTHORED_MARKER = 'wildo:llms-txt-unauthored';
20
+
21
+ /**
13
22
  * Read the hand-authored `llms.txt` body for the marketing site.
14
23
  *
15
24
  * Publication policy:
@@ -17,6 +26,9 @@
17
26
  * - `seo.llmsTxt?.enabled === true` → read the file if present, else `null`
18
27
  * - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
19
28
  * publish when the file exists, otherwise return `null`
29
+ * - in every case, a file still carrying {@link LLMS_TXT_UNAUTHORED_MARKER} → `null`. A route returns
30
+ * `new Response(null, { status: 404 })` for `null`: a prerendered route writes any non-null body
31
+ * to the build output, so a text body would be served as the file with status 200
20
32
  */
21
33
  export function readLlmsTxtBody(
22
34
  siteContext: WebsiteSiteContext,
@@ -34,7 +46,8 @@ export function readLlmsTxtBody(
34
46
  }
35
47
 
36
48
  try {
37
- return readFileSync(filePath, 'utf-8');
49
+ const body = readFileSync(filePath, 'utf-8');
50
+ return body.includes(LLMS_TXT_UNAUTHORED_MARKER) ? null : body;
38
51
  } catch (cause) {
39
52
  throw new Error(
40
53
  `[llms-txt-server] Could not read llms.txt at ${filePath}. ` +
@@ -102,6 +102,18 @@ export interface WebsiteSiteContext {
102
102
  * React island as JSON-serializable data.
103
103
  */
104
104
  readonly frontendProviders?: FrontendProvidersBlock;
105
+ /**
106
+ * Whether the operator owes a LEGAL NOTICE (imprint): derived by `loadWebsiteSiteContext` from
107
+ * `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts` with `legalNoticeOwed`, so the
108
+ * site and the application's `/legal-notice` page answer from the one declaration (#2588). `false` when the
109
+ * establishment is outside the EU, the EEA, the UK and Switzerland, or not declared yet.
110
+ *
111
+ * Every page forwards it to its bridge island beside `appOrigin`: the footer's legal links read it from
112
+ * `WebsiteRuntimeContext` and refuse to render without it, so a page that forgets it fails its build rather than
113
+ * dropping an obligation silently. Optional here only because a context composed by hand (a test) has no
114
+ * application config to derive it from; the loader always sets it.
115
+ */
116
+ readonly legalNoticeOwed?: boolean;
105
117
  }
106
118
 
107
119
  /**
@@ -139,6 +151,7 @@ export function composeWebsiteSiteContext(
139
151
  rootConfig: parts.rootConfig,
140
152
  websiteConfig: parts.websiteConfig,
141
153
  frontendProviders: parts.frontendProviders,
154
+ ...(parts.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: parts.legalNoticeOwed }),
142
155
  });
143
156
  }
144
157
  ```
@@ -327,6 +327,8 @@ export interface WebsiteBlogPostBridgeIslandProps {
327
327
  /** Product origin for navigation and call-to-action components inside the blog island.
328
328
  * Supplied by the Astro page from websiteConfig, just as on ordinary page bridges. */
329
329
  appOrigin?: string;
330
+ /** Whether the operator owes a legal notice, from `WEBSITE_SITE_CONTEXT.legalNoticeOwed`, as on ordinary page bridges (#2588). */
331
+ legalNoticeOwed?: boolean;
330
332
  }
331
333
 
332
334
  const EMPTY_MDX_COMPONENTS: WebsiteMdxComponentsMap = Object.freeze({});
@@ -358,6 +360,7 @@ export function createWebsiteBlogPostBridgeIsland(
358
360
  skipToMainContentLabelKey,
359
361
  frontendProviders,
360
362
  appOrigin,
363
+ legalNoticeOwed,
361
364
  }: WebsiteBlogPostBridgeIslandProps): ReactNode {
362
365
  const MdxBody = slugToMdxBody[slug];
363
366
  if (MdxBody === undefined) {
@@ -397,6 +400,7 @@ export function createWebsiteBlogPostBridgeIsland(
397
400
  navigation,
398
401
  skipToMainContentLabelKey,
399
402
  appOrigin,
403
+ ...(legalNoticeOwed !== undefined ? { legalNoticeOwed } : {}),
400
404
  ...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
401
405
  frontendProviderRegistry,
402
406
  providerComponentRegistry,
@@ -59,6 +59,8 @@ import {
59
59
  type WildoSaasConfig,
60
60
  } from '@wildo-ai/platform-config-lib';
61
61
 
62
+ import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
63
+
62
64
  import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
63
65
  import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
64
66
  import { loadWebsiteConfig, resolveStaticWebsiteServiceEntry } from './load-website-config';
@@ -149,6 +151,7 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
149
151
  artifactPath: resolveFrontendServicesArtifactPath(resolvePath(saasRoot)),
150
152
  serviceKey: websiteServiceKey,
151
153
  }),
154
+ legalNoticeOwed: legalNoticeOwed(saasConfig.operatorComplianceIdentity) === true,
152
155
  });
153
156
  }
154
157
  ```
@@ -27,6 +27,8 @@ export interface DefineWebsiteSectionInput<TProps> {
27
27
  sectionRef: WebsiteSectionRef | string;
28
28
  category: WebsiteSectionCategory;
29
29
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
30
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
31
+ anchorId?: string;
30
32
  Component: ComponentType<TProps>;
31
33
  /**
32
34
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -109,6 +111,7 @@ export function defineWebsiteSection<TProps>(
109
111
  sectionRef: input.sectionRef,
110
112
  category: input.category,
111
113
  expectedLabelKeys: input.expectedLabelKeys,
114
+ anchorId: input.anchorId,
112
115
  Component: input.Component,
113
116
  getStructuredData: input.getStructuredData,
114
117
  });
@@ -121,6 +124,7 @@ export function defineWebsiteSection<TProps>(
121
124
  sectionRef: parsed.sectionRef,
122
125
  category: parsed.category,
123
126
  expectedLabelKeys: parsed.expectedLabelKeys,
127
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
124
128
  Component: input.Component,
125
129
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
126
130
  };
@@ -0,0 +1,76 @@
1
+ # saas.website.legal.public-document-links
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-website`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-website`
10
+
11
+ ```tsx
12
+ *
13
+ * The site's LEGAL LINKS: one link per public governed document the application serves (its privacy notice and its
14
+ * terms), each to the page the application itself serves it at, on the APPLICATION's origin. Render it once in the
15
+ * site footer.
16
+ *
17
+ * Total over the public documents: a document the framework adds is linked by every site at its next build, and its
18
+ * label is a framework-owned key every locale pack must carry (`WEBSITE_LEGAL_LABEL_KEYS`). The page paths come from
19
+ * the same constant the application's router mounts, so a link cannot point where no page is.
20
+ *
21
+ * When the operator owes a LEGAL NOTICE (imprint) — established in the EU, the EEA, the UK or Switzerland, derived at build time from
22
+ * `operatorComplianceIdentity.establishmentJurisdiction` — a last link goes to the application's `/legal-notice` page.
23
+ * Directive 2000/31/EC Art. 5(1) wants that information "easily, directly and permanently accessible", which a footer
24
+ * link on every page is. An operator who owes none gets no link.
25
+ * spec-cite: Directive 2000/31/EC Art. 5(1)
26
+ *
27
+ * A same-tab link, not `external`: a legal page is something the visitor reads and comes back from, and an unexpected
28
+ * new window is the worse experience. The application's page shows the published document, or says plainly that it is
29
+ * not published yet.
30
+ *
31
+ * Throws when the page did not forward `appOrigin` or `legalNoticeOwed` to its bridge island, like the scaffold's
32
+ * `useAppOrigin`: a legal link pointing nowhere, or an owed one silently missing, must fail the build that produced
33
+ * it, not ship.
34
+ *
35
+ * Import from `@wildo-ai/saas-website`.
36
+ *
37
+ * @example
38
+ * // website/src/components/FooterComponent.tsx
39
+ * <WebsitePublicDocumentLinks className="wt-footer__legal" />
40
+ */
41
+ export function WebsitePublicDocumentLinks({ className }: WebsitePublicDocumentLinksProps): ReactNode {
42
+ const { appOrigin, legalNoticeOwed } = useWebsiteRuntime();
43
+ const headingId = useId();
44
+ const heading = useWebsiteLabelByKey(WEBSITE_LEGAL_LINKS_HEADING_LABEL_KEY);
45
+ const legalNoticeLabel = useWebsiteLabelByKey(WEBSITE_LEGAL_NOTICE_LABEL_KEY);
46
+ if (!appOrigin) {
47
+ throw new Error(
48
+ '[saas-website] WebsitePublicDocumentLinks needs the application origin. The page rendering it must forward '
49
+ + '`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to its bridge island.',
50
+ );
51
+ }
52
+ if (legalNoticeOwed === undefined) {
53
+ throw new Error(
54
+ '[saas-website] WebsitePublicDocumentLinks needs to know whether a legal notice is owed. The page rendering it '
55
+ + 'must forward `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its bridge island.',
56
+ );
57
+ }
58
+ const origin = appOrigin.replace(/\/+$/u, '');
59
+ return (
60
+ <nav aria-labelledby={headingId} className={className} data-website-legal-links="">
61
+ <span id={headingId} hidden>{heading}</span>
62
+ <ul>
63
+ {WEBSITE_PUBLIC_DOCUMENT_REF_NAMES.map((refName) => (
64
+ <WebsitePublicDocumentLink key={refName} refName={refName} href={`${origin}${PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS[PUBLIC_GOVERNED_DOCUMENT_REFS[refName]]}`} />
65
+ ))}
66
+ {legalNoticeOwed ? (
67
+ <li>
68
+ <WebsiteLink href={`${origin}${LEGAL_NOTICE_ROUTE_PATH}`}>{legalNoticeLabel}</WebsiteLink>
69
+ </li>
70
+ ) : null}
71
+ </ul>
72
+ </nav>
73
+ );
74
+ }
75
+ WebsitePublicDocumentLinks.displayName = 'WebsitePublicDocumentLinks';
76
+ ```
@@ -63,6 +63,8 @@
63
63
  * not match the directive in its `.astro` file.
64
64
  *
65
65
  * **Refinements**:
66
+ * - `sectionRefs` MAY be empty — a page whose sections are still being authored. It may be
67
+ * served by a dev server and may not be built: see `assertWebsitePagesHaveSections`.
66
68
  * - `sectionRefs` MUST contain unique values. Duplicates indicate
67
69
  * either a copy-paste bug (two sections pointing at the same
68
70
  * label-key root) or an intent to share a label-key root that
@@ -123,9 +125,16 @@ const _WebsitePageManifestSchema = z
123
125
  ref: WebsitePageRefSchema,
124
126
  routePath: _WebsitePageRoutePathSchema,
125
127
  pageComponent: z.unknown(),
126
- sectionRefs: z.array(WebsiteSectionRefSchema).min(1, {
127
- error: 'A page manifest must declare at least one sectionRef',
128
- }),
128
+ /*
129
+ * EMPTY is a valid manifest (#2205): a page whose sections are not authored YET. The build lane
130
+ * creates that state on purpose (the page task writes the empty list, then each section task
131
+ * appends itself), and refusing it here made `astro dev` crash at module load until every page
132
+ * of the site had a section. An empty page is unfinished, not false, so it is representable and
133
+ * a dev server renders it (`WebsitePageSections` shows the pending state). What is refused is
134
+ * BUILDING one: `assertWebsitePagesHaveSections`, run from the build-start hook, because a
135
+ * published page with nothing on it is a statement to a real reader.
136
+ */
137
+ sectionRefs: z.array(WebsiteSectionRefSchema),
129
138
  metaLabelKeys: _WebsitePageMetaLabelKeysSchema,
130
139
  hydration: WebsitePageHydrationStrategySchema.optional(),
131
140
  seo: _WebsitePageSeoConfigSchema.optional(),
@@ -0,0 +1,72 @@
1
+ # saas.website.page-sections.component
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-website`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-website`
10
+
11
+ ```tsx
12
+ *
13
+ * `WebsitePageSections` — renders a page's ordered sections list, each inside its `WebsiteSection`
14
+ * wrapper, and a visible PENDING marker while the list is still empty.
15
+ *
16
+ * A page component should render its sections through this rather than mapping the list by hand:
17
+ *
18
+ * ```tsx
19
+ * export function PricingPage(): ReactNode {
20
+ * return <WebsitePageSections pageRef="pricing" sections={PRICING_SECTIONS} />;
21
+ * }
22
+ * ```
23
+ *
24
+ * **Why the empty state is the point.** A page's sections list starts EMPTY when its page
25
+ * is authored before its sections — the application-creation build lane does exactly that, one task
26
+ * per page and one per section. An empty page is a valid manifest and a dev server serves it; the
27
+ * production build refuses it (`assertWebsitePagesHaveSections`). Mapped by hand, an empty list
28
+ * renders nothing at all, which is indistinguishable from a page that failed. This renders a
29
+ * marked block instead, so the page visibly says its sections are still to come.
30
+ *
31
+ * A section's `anchorId`, declared on its definition, becomes the wrapper's DOM `id`, so in-page links
32
+ * still have a target when no page places its sections by hand.
33
+ *
34
+ * **The marker carries identifiers, not prose.** It shows the page ref and the empty list as code,
35
+ * deliberately: words a person reads come from the label packs, and a label for a state no built
36
+ * page can ever reach (the build refuses an empty page) would be a key every locale must carry for
37
+ * nothing. A missing section must LOOK missing, which a raw identifier does.
38
+ */
39
+ export interface WebsitePageSectionsProps {
40
+ /** The page's ref, as its manifest declares it. Shown in the pending marker. */
41
+ pageRef: string;
42
+ /** The page's ordered sections list — the same array its manifest's `sectionRefs` derive from. */
43
+ sections: readonly WebsiteSectionDefinition[];
44
+ }
45
+
46
+ export function WebsitePageSections({ pageRef, sections }: WebsitePageSectionsProps): ReactNode {
47
+ if (sections.length === 0) {
48
+ return (
49
+ <section
50
+ data-website-pending-page={pageRef}
51
+ aria-busy="true"
52
+ style={{ margin: '2rem auto', maxWidth: '48rem', padding: '2rem', border: '2px dashed currentColor', opacity: 0.6, textAlign: 'center' }}
53
+ >
54
+ <code>{`${pageRef}: sections = []`}</code>
55
+ </section>
56
+ );
57
+ }
58
+ return (
59
+ <>
60
+ {sections.map((section) => {
61
+ const SectionComponent = section.Component as React.ComponentType;
62
+ return (
63
+ <WebsiteSection key={String(section.sectionRef)} sectionRef={section.sectionRef} category={section.category} id={section.anchorId}>
64
+ <SectionComponent />
65
+ </WebsiteSection>
66
+ );
67
+ })}
68
+ </>
69
+ );
70
+ }
71
+ WebsitePageSections.displayName = 'WebsitePageSections';
72
+ ```
@@ -55,7 +55,8 @@
55
55
  * mechanic: omitting the block means "auto-detect from file
56
56
  * presence" rather than "use a static schema default". The helper
57
57
  * `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`
58
- * exists and returns `null` otherwise.
58
+ * exists and carries no `LLMS_TXT_UNAUTHORED_MARKER`, and returns
59
+ * `null` otherwise.
59
60
  *
60
61
  * **Validation**:
61
62
  * - `siteName` is `z.string().min(1)` — empty strings would emit
@@ -105,6 +105,13 @@ export interface WebsiteRuntimeContextValue {
105
105
  * place to change it.
106
106
  */
107
107
  appOrigin?: string;
108
+ /**
109
+ * Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
110
+ * by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
111
+ * island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
112
+ * and refuses to render when it is absent.
113
+ */
114
+ legalNoticeOwed?: boolean;
108
115
  /**
109
116
  * Flat `Record<string, string>` label pack for the active locale.
110
117
  * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
@@ -47,6 +47,14 @@
47
47
  * and is caught by nothing until a reviewer reads the page. The
48
48
  * build and `wildo website audit` check the pack against the
49
49
  * DECLARED keys, so declare every slot the component reads.
50
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
51
+ * can target it. Belongs to the DEFINITION because a page renders its
52
+ * sections list through `WebsitePageSections`, which places every
53
+ * section itself: an anchor a page author would otherwise write on a
54
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
55
+ * valid HTML id that is also URL-fragment-safe: a letter, then
56
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
57
+ * to keep, like the id attribute it becomes.
50
58
  * - `Component` — the React component that renders the section. Typed
51
59
  * as `ComponentType<unknown>` here because schema-layer cannot lock
52
60
  * the component's prop shape (props vary per section). The factory
@@ -73,6 +81,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
73
81
  sectionRef: WebsiteSectionRefSchema,
74
82
  category: WebsiteSectionCategorySchema,
75
83
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
84
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
85
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
86
+ }).optional(),
76
87
  Component: z.unknown(),
77
88
  getStructuredData: z.unknown().optional(),
78
89
  });
@@ -21,6 +21,8 @@
21
21
  * - `false` → suppress publication even if the file exists
22
22
  * - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the
23
23
  * file exists, returns `null` when absent)
24
+ * - never while the file still carries `LLMS_TXT_UNAUTHORED_MARKER`,
25
+ * the scaffold's placeholder marker, whatever `enabled` says
24
26
  *
25
27
  * Keeping the "auto-detect when undefined" convention in the HELPER
26
28
  * (not as a schema default) is deliberate: schema defaults are static,
@@ -163,9 +163,35 @@ export const WebsiteSectionPlanSchema = z.strictObject({
163
163
  * vision's own one-liner — but the judge reads it.
164
164
  */
165
165
  drawsOnRefs: z.array(NonEmptyStringSchema).default([]),
166
+ /**
167
+ * The requirements this section's CAPABILITY claims rest on, by their refs (#2507): functional or non-functional.
168
+ * A citation, named like `valuePillars[].backedByBenefitRefs`, not a delivery like a roadmap phase's field.
169
+ *
170
+ * A market benefit says what a buyer wants; it does not say the product does it. One generated site promised
171
+ * "country workflow guidance with its limits stated", drawn from a market benefit, while the product shipped an
172
+ * empty place for an administrator to write guidance. A section that says the product DOES something cites the
173
+ * requirement behind it. The citation is necessary, not sufficient: a requirement is a commitment, so when the
174
+ * section is built its author is told whether the tasks serving each cited requirement have landed, whether a run
175
+ * reported it still unmet, and which roadmap phase delivers it. Only what has been delivered is described as
176
+ * available; the rest is described as planned.
177
+ *
178
+ * Reported when empty on the feature kinds ({@link WEBSITE_CAPABILITY_CLAIM_SECTION_KINDS}, `CAPABILITY_CLAIM_UNBACKED`).
179
+ * Any other kind may cite requirements too, and one that cites none describes no capability as available.
180
+ */
181
+ backedByRequirementRefs: z.array(NonEmptyStringSchema).default([]),
166
182
  });
167
183
  export type WebsiteSectionPlan = z.infer<typeof WebsiteSectionPlanSchema>;
168
184
 
185
+ /**
186
+ * The section kinds whose job is to say what the product DOES (#2507), reported when they cite no requirement. The
187
+ * build-time boundary binds every kind alike: a hero, a pricing table or an FAQ answer describes as available only
188
+ * what its own citations back.
189
+ */
190
+ export const WEBSITE_CAPABILITY_CLAIM_SECTION_KINDS: readonly WebsiteSectionKind[] = [
191
+ WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY,
192
+ WebsiteSectionKind.FEATURE_DETAIL,
193
+ ];
194
+
169
195
  /** One page of the marketing site. */
170
196
  export const WebsitePagePlanSchema = z.strictObject({
171
197
  /** `page-<slug>`, stamped by the trusted runtime; the route and the sections file are named from it. */
@@ -321,6 +321,19 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
321
321
  case ZodDecorator.IS_BUSINESS_KEY:
322
322
  currentMetadata[ZodDecorator.IS_BUSINESS_KEY] = true;
323
323
  break;
324
+ case ZodDecorator.DOCUMENT_SEQUENCE: {
325
+ // Parsed HERE, so a bad format fails when the schema loads, never when the first document is created.
326
+ const sequence = p as DocumentSequenceParams | undefined;
327
+ if (!sequence || !Object.values(DocumentSequenceScope).includes(sequence.scope)) {
328
+ throw new Error('documentSequence: params need a format and a DocumentSequenceScope.');
329
+ }
330
+ if (sequence.allocation !== undefined && !Object.values(DocumentSequenceAllocation).includes(sequence.allocation)) {
331
+ throw new Error(`documentSequence: unknown allocation "${String(sequence.allocation)}".`);
332
+ }
333
+ parseDocumentSequenceFormat(sequence.format);
334
+ currentMetadata[ZodDecorator.DOCUMENT_SEQUENCE] = sequence;
335
+ break;
336
+ }
324
337
  case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
325
338
  currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
326
339
  break;
@@ -175,6 +175,11 @@ export enum ZodDecorator {
175
175
  * `OBJECT_BUSINESS_KEY_SET` decorator on the schema root.
176
176
  */
177
177
  IS_BUSINESS_KEY = "isBusinessKey",
178
+ /**
179
+ * A server-allocated document number (`INV-2026-00042`), consecutive and gapless per scope. Composite: implies
180
+ * `excludeFromCreate`, `excludeFromUpdate` and a unique index in the sequence's scope. See `DocumentSequenceParams`.
181
+ */
182
+ DOCUMENT_SEQUENCE = "documentSequence",
178
183
  /**
179
184
  * Object-level decorator declaring a **composite business key** for the
180
185
  * schema (e.g. `(organizationId, templateKey)`). Schema-level analog of
@@ -291,6 +296,7 @@ export type ZodDecorator_ParamsType = {
291
296
  [ZodDecorator.IS_PRIMARY_KEY]: undefined;
292
297
  // Business key marker (parameterless field-level marker for the data-seeding subsystem)
293
298
  [ZodDecorator.IS_BUSINESS_KEY]: undefined;
299
+ [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
294
300
  // Composite business key (object-level decorator carrying the ordered list of field names)
295
301
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams | DecoratorUpdater<BusinessKeySetParams>;
296
302
  [ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
@@ -384,6 +390,7 @@ export type ZodDecorator_Types = {
384
390
  [ZodDecorator.IS_PRIMARY_KEY]: true;
385
391
  // Business key marker (parameterless field-level marker for the data-seeding subsystem)
386
392
  [ZodDecorator.IS_BUSINESS_KEY]: true;
393
+ [ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
387
394
  // Composite business key (object-level — stored params shape after resolver unwraps DecoratorUpdater)
388
395
  [ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams;
389
396
  [ZodDecorator.TTL]: TtlFieldParams;
@@ -0,0 +1,65 @@
1
+ # zod.decorators.document-sequence
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/zod-decorators`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/zod-decorators`
10
+
11
+ ```typescript
12
+ *
13
+ * A DOCUMENT NUMBER the server allocates: an invoice, quote or job number such as `INV-2026-00042`.
14
+ *
15
+ * Declared on a string field with `.documentSequence({ format, scope })`. The server assigns the next number of the
16
+ * field's sequence when the row is created (or, with `allocation: EXPLICIT`, when the application's own operation asks
17
+ * for it, such as an "issue" transition), inside the same transaction as the write. So two documents created at the same
18
+ * instant in one organization get consecutive numbers, and a failed write consumes none: the sequence has no gaps.
19
+ * EU VAT invoicing requires exactly that, a sequential number that identifies each invoice once.
20
+ *
21
+ * The field is never written by a client: the decorator implies `excludeFromCreate`, `excludeFromUpdate`, and a unique
22
+ * index in the sequence's scope.
23
+ *
24
+ * Import from `@wildo-ai/zod-decorators` (the decorator is installed on every string schema).
25
+ *
26
+ * @example
27
+ * invoiceNumber: z.string().documentSequence({ format: 'INV-{YYYY}-{n:5}', scope: DocumentSequenceScope.ORGANIZATION }),
28
+ * // first invoice of 2026 in an organization: INV-2026-00001; the count restarts at 1 in 2027
29
+ */
30
+ export enum DocumentSequenceScope {
31
+ /** One sequence per organization: two organizations each have their own INV-2026-00001. */
32
+ ORGANIZATION = 'organization',
33
+ /** One sequence across the whole application. */
34
+ APPLICATION = 'application',
35
+ }
36
+
37
+ /** WHEN the number is allocated. */
38
+ export enum DocumentSequenceAllocation {
39
+ /** When the row is created. The default. */
40
+ CREATE = 'create',
41
+ /**
42
+ * When the application's own operation allocates it, through the backend's document-sequence allocator: an invoice
43
+ * drafted without a number and numbered when it is issued. The field stays empty until then, so declare it optional.
44
+ */
45
+ EXPLICIT = 'explicit',
46
+ }
47
+
48
+ /**
49
+ * The parameters of `.documentSequence(...)`.
50
+ *
51
+ * `format` is literal text with these tokens:
52
+ * - `{n}` or `{n:5}`: the sequence number, zero-padded to the width given (exactly one, required);
53
+ * - `{YYYY}` or `{YY}`: the year, which also RESTARTS the count every year;
54
+ * - `{MM}`: the month (with a year token), which restarts the count every month.
55
+ *
56
+ * The year and month are those of the moment the number is allocated, in the organization's timezone for an
57
+ * ORGANIZATION sequence (its profile's `timezone`) and in UTC for an APPLICATION sequence.
58
+ */
59
+ export interface DocumentSequenceParams {
60
+ format: string;
61
+ scope: DocumentSequenceScope;
62
+ /** Defaults to {@link DocumentSequenceAllocation.CREATE}. */
63
+ allocation?: DocumentSequenceAllocation;
64
+ }
65
+ ```