@wildo-ai/framework-knowledge 1.1.9 → 1.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (376) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  5. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  6. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  8. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  9. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.definitions.js +84 -4
  11. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  12. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  13. package/dist/esm/index.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +132 -20
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  25. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  27. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  29. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +85 -8
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  33. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  35. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  37. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  41. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  43. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  45. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  52. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  56. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +10 -4
  58. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  60. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  62. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  64. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  66. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  68. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  70. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  72. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  80. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  81. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  82. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  83. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  88. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  93. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  95. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  97. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  99. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
  103. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  104. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  105. package/dist/knowledge/manifest.json +7 -7
  106. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
  107. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  108. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  109. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +149 -11
  110. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
  111. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
  113. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +107 -11
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
  118. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  119. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  122. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  123. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  124. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
  125. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  126. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  127. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  128. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  129. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  130. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  131. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  132. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +7 -3
  133. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  135. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  136. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  137. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  138. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  139. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  140. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  141. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  142. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  143. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  144. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  145. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  150. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  152. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  153. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  154. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  157. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +19 -0
  158. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
  159. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  160. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  161. package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
  162. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  163. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  164. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  165. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  166. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  167. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  168. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  169. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  170. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  171. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  172. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  173. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  174. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  175. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  176. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  177. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  178. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  179. package/dist/knowledge/references/experience-plan.config.md +60 -7
  180. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  181. package/dist/knowledge/references/placement-plan.config.md +43 -0
  182. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  183. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  184. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  185. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  186. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  187. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  188. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  189. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  190. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  191. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  192. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  193. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  194. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  195. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  196. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  197. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  198. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  199. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  200. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  201. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  202. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  203. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  204. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  205. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  206. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  207. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  208. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  209. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  210. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  211. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  212. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  213. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  214. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  215. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  216. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  217. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  218. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  219. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  220. package/dist/knowledge/references/website-plan.config.md +26 -0
  221. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  222. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  223. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  224. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  225. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  226. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  227. package/dist/knowledge/references/zod.factories.code.md +1 -0
  228. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  229. package/dist/knowledge/references/zod.factories.money.md +1 -0
  230. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  231. package/dist/knowledge/registries/framework-topics.json +337 -1
  232. package/dist/knowledge/registries/playbooks.json +18 -18
  233. package/dist/knowledge/registries/source-tags.json +1435 -873
  234. package/dist/knowledge/rules/live-context-door.md +1 -1
  235. package/dist/knowledge/skills/INDEX.md +3 -1
  236. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  237. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  238. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  239. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  240. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  241. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  242. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  243. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  244. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  245. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  246. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  247. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  248. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  249. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
  250. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  251. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  252. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  253. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  254. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  255. package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
  256. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
  257. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  258. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  259. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  260. package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
  261. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  262. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  263. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  264. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  265. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  266. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  267. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  268. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  269. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  270. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  271. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
  272. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  273. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  274. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  275. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  276. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  277. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  278. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  279. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  280. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +11 -3
  281. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
  282. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  283. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  284. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  285. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  286. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  287. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  288. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  289. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  290. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  291. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  292. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  293. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  294. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  295. package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
  296. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  297. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  298. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  299. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  300. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  301. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  302. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  303. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  304. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  305. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  306. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  307. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  308. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  309. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  310. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  311. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  312. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  313. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  314. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  315. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  316. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  317. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  318. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  319. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  320. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  321. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  322. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  323. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  324. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  325. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  326. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  327. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  328. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  329. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  330. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  331. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  332. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  333. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  334. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  335. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  336. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  337. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  338. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  339. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  340. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  341. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  342. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  343. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  344. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  345. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  346. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  347. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  348. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  349. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  350. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  351. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  352. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  353. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  354. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  355. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
  356. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  357. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  358. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  359. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  360. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  361. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  362. package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
  363. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  364. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  365. package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
  366. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
  367. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
  368. package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
  369. package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
  370. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
  371. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
  372. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  373. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  374. package/dist/knowledge/topic-index.json +1441 -269
  375. package/dist/tsconfig.build.tsbuildinfo +1 -1
  376. package/package.json +4 -4
@@ -0,0 +1,25 @@
1
+ # saas.frontend.settings-hub.engine-destination-roles
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-frontend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
10
+
11
+ ```typescript
12
+ /** Org-management destinations are visible to organization owners and admins. */
13
+ const ORG_MANAGEMENT_ROLES: string[] = [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN];
14
+
15
+ /**
16
+ * Application-administration destinations are visible to the application's own super-administrator.
17
+ *
18
+ * ONE role, deliberately, and not the wider `APP_ADMIN_*` family: every destination gated with this
19
+ * is a surface whose resource ALSO requires `APP_ADMIN_SUPER_ADMIN` server-side, so admitting
20
+ * `APP_ADMIN_VIEWER` or `APP_ADMIN_BILLING_MANAGER` here would render a rail entry that answers 403
21
+ * on open — worse than absent, because it reads as a permission the operator has and a bug they hit.
22
+ * Widen this only alongside the operation roles it would then have to match.
23
+ */
24
+ const APPLICATION_ADMINISTRATION_ROLES: string[] = [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN];
25
+ ```
@@ -119,8 +119,8 @@ export interface SettingsDestination {
119
119
  ref: string;
120
120
  /** What the destination renders in its content panel. */
121
121
  target: SettingsSectionTarget;
122
- /** Declarative runtime capability gating (same contract as launcher items). */
123
- runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
122
+ /** Declarative runtime capability gating (launcher items' `requiredCapabilities`; roles are `requiredRoles`). */
123
+ runtimeAvailability?: SettingsRuntimeAvailabilityConfig;
124
124
  /** Feature flags required to surface this destination (plan/subscription gating). */
125
125
  requiredFeatures?: RequiredFeaturesConfig;
126
126
  /** RBAC roles required to surface this destination (OR semantics). */
@@ -89,6 +89,19 @@ export enum AuditApplicationReadAccess {
89
89
  INDEPENDENT_APPROVAL = 'independent-approval',
90
90
  }
91
91
 
92
+ /**
93
+ * How one of the application's OWN audit event types is classified: the activity it records and the attention it
94
+ * deserves. The same two vocabularies the engine uses for its event types.
95
+ */
96
+ export const ApplicationAuditEventTypeDeclarationSchema = z.strictObject({
97
+ /** What kind of activity the event records. A business event (an invoice issued, a quote sent) is `data_access`. */
98
+ category: z.enum(AuditEventCategory),
99
+ /** How much attention it deserves: `info` is evidence, `warning` is worth review, `critical` is meant for whoever handles security incidents. A SIEM destination's event filter is what routes on it. */
100
+ severity: z.enum(AuditEventSeverity),
101
+ });
102
+
103
+ export type ApplicationAuditEventTypeDeclaration = z.infer<typeof ApplicationAuditEventTypeDeclarationSchema>;
104
+
92
105
  export const AuditTrailConfigSchema = z.object({
93
106
  /**
94
107
  * Application audit viewer admission. Omitted means ROLE_BASED in every environment.
@@ -155,7 +168,39 @@ export const AuditTrailConfigSchema = z.object({
155
168
  * addresses are admitted, never whether the admitted address is the one connected to.
156
169
  */
157
170
  allowPrivateNetworkSiemCollectors: z.boolean().optional(),
171
+
172
+ /**
173
+ * The application's OWN audit event types — the `eventType` values it passes to `AuditLogsBackendService.logEvent`
174
+ * — each with its classification. Keyed by the exact `eventType` string.
175
+ *
176
+ * ── What declaring one changes ─────────────────────────────────────────────
177
+ * - Every row of that type is recorded with the declared `eventCategory` and `severity`, and the SIEM export
178
+ * routes and filters by them. An UNDECLARED application type is recorded as `data_access` / `info`, whatever
179
+ * the event is — a business-critical event is then indistinguishable from routine reads.
180
+ * - The labelling pipeline plans a word for it (`system_enums.CoreAuditableEventType.<eventType>`, the open
181
+ * vocabulary the audit row's `eventType` field names), so the audit views show "Quote issued" instead of
182
+ * `SALES_QUOTE_ISSUED`. Run label generation after adding one.
183
+ *
184
+ * ── What it cannot do ──────────────────────────────────────────────────────
185
+ * It cannot reclassify a FRAMEWORK event type: the engine's own classification is authoritative, and naming one of
186
+ * its event types here is refused at startup. The key must be usable as the last segment of a label key (letters,
187
+ * digits, `_`, `-`).
188
+ *
189
+ * Severity is a property of the event TYPE. A row's `riskLevel` (supplied per emission) is a separate signal and
190
+ * does not change it.
191
+ *
192
+ * @example
193
+ * auditTrail: {
194
+ * applicationEventTypes: {
195
+ * SALES_QUOTE_ISSUED: { category: AuditEventCategory.DATA_ACCESS, severity: AuditEventSeverity.WARNING },
196
+ * },
197
+ * }
198
+ */
199
+ applicationEventTypes: z.record(z.string().regex(LABEL_KEY_SEGMENT_PATTERN), ApplicationAuditEventTypeDeclarationSchema).optional(),
158
200
  });
159
201
 
202
+ /** The application's declared audit event types, keyed by `eventType` — see `AuditTrailConfig.applicationEventTypes`. */
203
+ export type ApplicationAuditEventTypes = NonNullable<AuditTrailConfig['applicationEventTypes']>;
204
+
160
205
  export type AuditTrailConfig = z.infer<typeof AuditTrailConfigSchema>;
161
206
  ```
@@ -28,9 +28,11 @@
28
28
  * dropped, and were removed. The framework's SMS transport serves authentication's one-time codes, not
29
29
  * resource notifications.
30
30
  *
31
- * For an EMAIL, create the template directory the reference names. The startup validator resolves
32
- * every declared reference through the configured locale chain before the application takes traffic,
33
- * and prints the exact directory to create when one is missing.
31
+ * For an EMAIL, create the template the derived reference names: one per operation variant that declares a
32
+ * `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
33
+ * the configured locale chain before the application takes traffic and names the folder to create when one is
34
+ * missing. It REFUSES to start only for an operation with `tokenGeneration` (the email carries the token its flow
35
+ * needs); for any other operation it WARNS and starts, and that email is silently never sent.
34
36
  *
35
37
  * ## The recipient's preferences are honoured, and three things override them
36
38
  *
@@ -584,6 +584,32 @@ export type ResourceConfiguration_BuilderParameters<
584
584
  * Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
585
585
  * one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
586
586
  * a person — and if so, whose session an erasure ends.
587
+ *
588
+ * And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
589
+ * `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
590
+ * `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
591
+ * and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
592
+ * transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
593
+ * erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
594
+ * `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
595
+ *
596
+ * Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
597
+ * or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
598
+ * STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
599
+ * service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
600
+ *
601
+ * @example
602
+ * ```ts
603
+ * retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
604
+ * dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
605
+ * coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
606
+ * operationsConfiguration: {
607
+ * // …READ / LIST as API_CALL defaults…
608
+ * [CoreResourceOperation.UPDATE_MANY]: {
609
+ * variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
610
+ * },
611
+ * },
612
+ * ```
587
613
  */
588
614
  retentionPolicy?: ResourceRetentionPolicy,
589
615
 
@@ -0,0 +1,61 @@
1
+ # saas.models.roles.definition
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ *
13
+ * One role an application declares, and the table of them. Import from `@wildo-ai/saas-models`
14
+ * (`RolesConfiguration`, `CORE_ORG_ROLES`, `CORE_APP_ROLES`, `ResourcePrimaryScope`).
15
+ *
16
+ * An application's own roles live in ONE place: `CUSTOM_ROLES_CONFIGURATION` in
17
+ * `shared-lib/src/engine/roles.ts`, a `RolesConfiguration` keyed by the role's name. Nothing else
18
+ * declares a role — never a resource holding role names or permission lists, which the engine does not
19
+ * read.
20
+ *
21
+ * - `role` — the role's name, equal to its key. Any string; prefer a stable upper-snake name
22
+ * (`FIELD_TECHNICIAN`).
23
+ * - `inheritFrom` — the role whose access this one also receives. A holder of a role satisfies every
24
+ * operation naming that role OR any role up its `inheritFrom` chain. The core organization chain is
25
+ * linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`. So a custom role inheriting
26
+ * `ORG_MEMBER` is NOT held by an `ORG_ADMIN`: to let administrators do what the custom role does,
27
+ * name both roles on the operation.
28
+ * - `isSystemRole` — `false` for every role an application declares.
29
+ * - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
30
+ * organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
31
+ * ignored at startup with a warning, and the role grants nothing.
32
+ *
33
+ * Declaring a role is one of three steps. An organization role must also be listed in
34
+ * `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
35
+ * it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
36
+ * nothing). People receive it through the engine's members screen and invitations.
37
+ */
38
+ export const RoleDefinitionSchema = z.object({
39
+ role: RolesSchema,
40
+ inheritFrom: RolesSchema.optional(),
41
+ isSystemRole: z.boolean().default(false),
42
+ relatedPrimaryScope : z.enum(ResourcePrimaryScope),
43
+ });
44
+
45
+
46
+ export type RoleDefinition = z.infer<typeof RoleDefinitionSchema>;
47
+
48
+ export const RolesConfigurationSchema = z.record(z.string(), RoleDefinitionSchema).refine(
49
+ (record) => {
50
+ // Validate that all keys are valid roles
51
+ return Object.keys(record).every(key => {
52
+ try {
53
+ RolesSchema.parse(key);
54
+ return true;
55
+ } catch {
56
+ return false;
57
+ }
58
+ });
59
+ }
60
+ );
61
+ ```
@@ -0,0 +1,97 @@
1
+ # saas.models.roles.organization-defaults
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ *
13
+ * The organization roles the engine ships, and how they inherit. Read it to choose what a custom role
14
+ * should `inheritFrom` and which roles an operation must name.
15
+ *
16
+ * The person-holdable chain is linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`
17
+ * (each holds everything to its right). `ORG_SERVICE_PROVIDER` hangs off `ORG_MEMBER` for experts of a
18
+ * service firm. The entries after `ORG_OWNER` are handler-only or delegated-capability roles: the
19
+ * engine confers them (an inbound handler, a live capability grant), they are never stored on a
20
+ * membership, and a membership naming one is refused. Never inherit from them or assign them.
21
+ */
22
+ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
23
+ [CORE_ORG_ROLES.ORG_GUEST]: {
24
+ role: CORE_ORG_ROLES.ORG_GUEST,
25
+ isSystemRole: true,
26
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
27
+ },
28
+ [CORE_ORG_ROLES.ORG_MEMBER]: {
29
+ role: CORE_ORG_ROLES.ORG_MEMBER,
30
+ inheritFrom: CORE_ORG_ROLES.ORG_GUEST,
31
+ isSystemRole: true,
32
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
33
+ },
34
+ [CORE_ORG_ROLES.ORG_SERVICE_PROVIDER]: {
35
+ role: CORE_ORG_ROLES.ORG_SERVICE_PROVIDER,
36
+ inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
37
+ isSystemRole: true,
38
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
39
+ },
40
+ [CORE_ORG_ROLES.ORG_MANAGER]: {
41
+ role: CORE_ORG_ROLES.ORG_MANAGER,
42
+ inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
43
+ isSystemRole: true,
44
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
45
+ },
46
+ [CORE_ORG_ROLES.ORG_ADMIN]: {
47
+ role: CORE_ORG_ROLES.ORG_ADMIN,
48
+ inheritFrom: CORE_ORG_ROLES.ORG_MANAGER,
49
+ isSystemRole: true,
50
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
51
+ },
52
+ [CORE_ORG_ROLES.ORG_OWNER]: {
53
+ role: CORE_ORG_ROLES.ORG_OWNER,
54
+ inheritFrom: CORE_ORG_ROLES.ORG_ADMIN,
55
+ isSystemRole: true,
56
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
57
+ },
58
+ // No `inheritFrom`: handler-only, confers exactly the billing operations that name it (#1629).
59
+ [CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS]: {
60
+ role: CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS,
61
+ isSystemRole: true,
62
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
63
+ },
64
+ // No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
65
+ // inheriting anything would make a lent capability's reach a function of what that role grows into later.
66
+ [CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
67
+ role: CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS,
68
+ isSystemRole: true,
69
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
70
+ },
71
+ [CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS]: {
72
+ role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS,
73
+ isSystemRole: true,
74
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
75
+ },
76
+ [CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL]: {
77
+ role: CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL,
78
+ isSystemRole: true,
79
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
80
+ },
81
+ [CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM]: {
82
+ role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM,
83
+ isSystemRole: true,
84
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
85
+ },
86
+ [CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS]: {
87
+ role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS,
88
+ isSystemRole: true,
89
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
90
+ },
91
+ [CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS]: {
92
+ role: CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS,
93
+ isSystemRole: true,
94
+ relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
95
+ }
96
+ };
97
+ ```
@@ -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
@@ -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
 
@@ -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
  ```
@@ -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
+ ```
@@ -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>`
@@ -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. */