@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
@@ -23,8 +23,10 @@ Read and apply these patterns from the application-developer point of view:
23
23
  Mechanism skill for **chart sections** — the `chartViews:[]` array on
24
24
  a resource's `ui-behavior.tsx` that declares charts the resource owns
25
25
  and surfaces. Charts are **data-declarative**: there is no JSX chart
26
- component to author. The runtime renders a chart from the typed
27
- `chartDefinition` (chart type + data query + series).
26
+ component to author. The runtime renders a chart from a typed
27
+ `ChartDefinition` (chart type + data query + series), declared once as a
28
+ constant in the shared layer (`<resource>.charts.ts`) and named by both the
29
+ `chartViews` entry and the backend module that runs its query.
28
30
 
29
31
  A chart declared on a resource is reachable via:
30
32
 
@@ -38,7 +40,9 @@ A chart declared on a resource is reachable via:
38
40
 
39
41
  | Surface | Glob (relative to app root) |
40
42
  |---------------------|------------------------------------------------------------------------------------------|
43
+ | Chart definition (shared) | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.charts.ts` (`ChartDefinition` constants) |
41
44
  | Chart authoring (resource-owned) | `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` (`chartViews:`) |
45
+ | Backend registration | `backend-api/src/modules/<slug>/index.ts` (`chartDefinitions:` on the module) |
42
46
  | Chart spec | `specifications/src/modules/<slug>/resources/<resource>/<resource>.<chart-ref>.chart-view.specification.ts` |
43
47
  | Chart spec barrel | `specifications/src/modules/<slug>/chart-view-specifications.ts` |
44
48
  | Embed call sites | `frontend/src/modules/<slug>/resources/**/*CompositeView.tsx` (`<EmbedHostChart>` / `<EmbedRelatedChart>`) |
@@ -61,12 +65,15 @@ A chart declared on a resource is reachable via:
61
65
 
62
66
  ### Step 1: Mirror sibling chart
63
67
 
64
- Find a chart definition in the same module (or in a sibling resource
65
- with similar shape); copy the `chartViews:[{...}]` entry pattern.
68
+ Find a chart in the same module (or in a sibling resource with similar
69
+ shape) and copy both halves: its `ChartDefinition` constant in
70
+ `shared-lib/.../<resource>.charts.ts`, and its `chartViews:[{...}]` entry,
71
+ which names that constant as `chartDefinition`.
66
72
 
67
73
  ### Step 2: Define data query
68
74
 
69
- Set `dataQuery.mainResourceType` to the resource being aggregated.
75
+ Steps 2 and 3 edit the `ChartDefinition` constant in `<resource>.charts.ts`,
76
+ not the `chartViews` entry. Set `dataQuery.mainResourceType` to the resource being aggregated.
70
77
  Add `dimensions:[{ ref, field }]` (the grouping axis) and
71
78
  `measures:[{ ref, field, aggregate }]` (the value axis). Use
72
79
  `AggregateFunction.*` (typed enum); never string literals.
@@ -77,15 +84,85 @@ Add `dimensions:[{ ref, field }]` (the grouping axis) and
77
84
  must equal a `measures[].ref` declared above; `splitByDimension`
78
85
  must equal a `dimensions[].ref`.
79
86
 
80
- ### Step 4: Wire parent requirements
87
+ ### Step 4: Register the definition for the backend
88
+
89
+ The frontend `chartViews` entry is what RENDERS the chart; the backend cannot read it. The backend runs the
90
+ chart's query only for definitions its module registers, in `chartDefinitions` on the `BackendDomainModule`.
91
+ Without it the chart's frame renders and every data fetch answers `chart_not_found`.
92
+
93
+ So declare each `ChartDefinition` once, as a constant in the shared layer (`<resource>.charts.ts`), and feed the
94
+ SAME object to both the `chartViews` entry and the module's `chartDefinitions`. The module wiring, as Wonder
95
+ Todos does it (see its `chartDefinitions` entry):
96
+
97
+
98
+ ## Usage Example
99
+
100
+ ```typescript
101
+ const backendModule: BackendDomainModule = {
102
+ ...resourcesModule,
103
+ flowsActors: moduleBackend_FlowsActorsRegistry,
104
+ pdfTemplateBindings: tasksManagerPdfTemplateBindings,
105
+ // Register resource-owned chart definitions so the backend chart registry can
106
+ // execute `/charts/:chartRef/data`. The SAME shared `ChartDefinition` is wired
107
+ // into the frontend `chartViews` on the tasks ui-behavior (render side).
108
+ chartDefinitions: [
109
+ // Per-todo charts (MANDATORY parent todo scope) — surfaced on the todo workspace.
110
+ todoTaskStatusChartDefinition, todoTaskPriorityChartDefinition, todoTaskTimelineChartDefinition,
111
+ // The caller's OWN tasks (CURRENT_USER assignee filter) — surfaced on the `my-week` app-level view.
112
+ myWeekTasksByStatusChartDefinition, myWeekTasksByPriorityChartDefinition,
113
+ // Org-wide todo analytics — surfaced on the Todos LIST host and the home dashboard.
114
+ todosByStatusChartDefinition, todosByPriorityChartDefinition, todosCreatedTimelineChartDefinition,
115
+ ],
116
+ // Singleton config rows auto-seeded on resource lifecycle:
117
+ // - M2M outbound webhook config (per ORG / per APP) — app-specific dev-listener
118
+ // payload, so it stays app-owned (`./seeds/webhook-configs.seeds.ts`).
119
+ //
120
+ // The engine's OWN defaults are no longer listed here, and their absence is the point.
121
+ // Enterprise-config disabled defaults (SSO / SCIM / SIEM, both scopes) and APPLICATION_METADATA
122
+ // used to be spread in below under a "framework-provides / app-registers" pattern. The framework
123
+ // now registers them itself (`ENGINE_OWNED_DATA_SEEDS`), because an opt-in is something an
124
+ // application can forget: Wonder CRM never wired any of them, so every SSO / SCIM / SIEM settings
125
+ // panel there answered a 404 that renders as "Couldn't load details". Re-adding them here would
126
+ // now fail the boot on a duplicate `seedKey`, deliberately.
127
+ seeds: [
128
+ ...webhookConfigSeeds,
129
+ ],
130
+ // A signed webhook from a client's system that creates a todo (#1596) — `POST /webhooks/app/todo-intake`;
131
+ // and an email to an organization's address that creates one and answers on the thread (#1600, #1630).
132
+ inboundHandlers: [todoIntakeInboundHandler, todoEmailIntakeHandler, todoEmailScreenedHandler, todoEmailScreeningHandler],
133
+ };
134
+
135
+ // NB: this module intentionally does not populate `customLabels`. The dev
136
+ // companion's labelling pipeline writes every per-unit label file (engine
137
+ // resources, app resources, components, themes, errors, …) under one
138
+ // tree (`<backend>/src/engine/i18n/`), and the engine module is the
139
+ // single owner that scans it. Duplicating the scan here would either
140
+ // produce empty results (wrong root) or trigger key-collision warnings
141
+ // (same root scanned twice).
142
+ const tasksManagerBackendModule: BackendOwnedModule = {
143
+ moduleId: 'tasks-manager',
144
+ kind: 'domain',
145
+ backendModule,
146
+ emailTemplateDefinitions,
147
+ };
148
+
149
+ export default tasksManagerBackendModule;
150
+ ```
151
+
152
+ ### Step 5: Wire parent requirements
81
153
 
82
154
  If the chart only makes sense when scoped to a parent (e.g. tasks of
83
- *this* todo), declare `parentResourcesRequirements:[{ resourceType,
84
- foreignKeyField, requirement: MANDATORY, isPrimaryScope: false }]`.
85
- Without MANDATORY, the chart can render in contexts without the
86
- parent and produce confusing aggregates.
155
+ *this* todo), it takes two declarations, one per half:
156
+
157
+ - on the `chartViews` entry, `parentResourcesRequirements:[{ resourceType,
158
+ foreignKeyField, requirement: MANDATORY, isPrimaryScope: false }]`, so the
159
+ chart is only offered where a parent is in scope;
160
+ - in the `ChartDefinition`, a `dataQuery.contextFilters` entry with
161
+ `source: ContextFilterSource.PARENT_RESOURCE`, which is what confines the
162
+ QUERY to that parent's rows. Without it the chart counts every row the caller
163
+ can see, and the numbers look plausible.
87
164
 
88
- ### Step 5: Reading the numbers without the chart
165
+ ### Step 6: Reading the numbers without the chart
89
166
 
90
167
  When a view needs a chart's values but not its canvas (KPI tiles, a completion rate), read them with
91
168
  `useResourceChartData({ resourceType, viewRef })` from `@wildo-ai/saas-frontend-lib`. It resolves the
@@ -94,7 +171,7 @@ declared chart view and its scope, so one chart feeds both the donut and the til
94
171
  chart is refused with `aggregation_scope_unresolved`. See
95
172
  `references/framework-resource-chart-data-api.md`.
96
173
 
97
- ### Step 6: Spec
174
+ ### Step 7: Spec
98
175
 
99
176
  Update or add the chart spec under
100
177
  `specifications/src/modules/<slug>/resources/<resource>/<chart-ref>.chart-view.specification.ts`.
@@ -104,7 +181,94 @@ Re-export from the chart spec barrel.
104
181
 
105
182
  An application's `todo-task-status` chart on the `tasks` resource is
106
183
  the canonical resource-owned chart shape — donut chart counting tasks
107
- by status, scoped to the parent todo:
184
+ by status, scoped to the parent todo. It is two pieces.
185
+
186
+ The shared `ChartDefinition` (`shared-lib/.../tasks/tasks.charts.ts`), which
187
+ the backend module also registers:
188
+
189
+
190
+ ## Usage Example
191
+
192
+ ```typescript
193
+ import type { ChartDefinition, ContextFilter } from '@wildo-ai/saas-models';
194
+ import {
195
+ AggregateFunction,
196
+ ChartType,
197
+ ComparisonOperator,
198
+ ContextFilterSource,
199
+ TimeGranularity,
200
+ } from '@wildo-ai/saas-models';
201
+
202
+ import { TasksManager_ResourceFieldIdentifier, TasksManager_ResourceType } from '../tasks-manager.resources-types';
203
+
204
+ /**
205
+ * Scopes every task chart to its MANDATORY parent todo.
206
+ *
207
+ * The chart embed posts `contextResourceIdentifiers` (resourceType-keyed) with
208
+ * the data request; the backend verifies READ access on the referenced parent
209
+ * and resolves this filter from that trusted map
210
+ * (`parentResource['todos']` → `tasks.todoId`, ObjectId-coerced). Without this
211
+ * filter the "parent todo's tasks" charts silently aggregate EVERY task the
212
+ * caller can see — the query executes fine, so the drift is invisible until
213
+ * someone compares numbers. The backend fails closed when the parent id is
214
+ * missing from the request, and the frontend only surfaces these charts on
215
+ * hosts whose context satisfies the declared MANDATORY parent requirement.
216
+ */
217
+ const parentTodoScopeFilter: ContextFilter = {
218
+ field: TasksManager_ResourceFieldIdentifier[TasksManager_ResourceType.TODOS],
219
+ operator: ComparisonOperator.EQ,
220
+ source: ContextFilterSource.PARENT_RESOURCE,
221
+ sourceField: TasksManager_ResourceType.TODOS,
222
+ };
223
+
224
+ /**
225
+ * `todo-task-status` chart — single source of truth.
226
+ *
227
+ * A resource-owned chart needs its `ChartDefinition` in TWO places:
228
+ * - the FRONTEND `chartViews[].chartDefinition` on the owning resource's
229
+ * ui-behavior (rendering / routing), and
230
+ * - the BACKEND chart registry (so `POST /charts/:chartRef/data` can execute
231
+ * the aggregation query) — fed via the backend module's `chartDefinitions`.
232
+ *
233
+ * `chartViews` is a frontend-only authoring surface the backend cannot import,
234
+ * so the shared `ChartDefinition` data contract is declared HERE in shared-lib
235
+ * and consumed by both layers. Declaring it twice would let the rendered chart
236
+ * and the executed query drift apart.
237
+ *
238
+ * Donut of the current parent todo's tasks, split by execution `status`.
239
+ */
240
+ export const todoTaskStatusChartDefinition: ChartDefinition = {
241
+ ref: 'todo-task-status',
242
+ chartType: ChartType.DONUT,
243
+ dataQuery: {
244
+ mainResourceType: TasksManager_ResourceType.TASKS,
245
+ contextFilters: [parentTodoScopeFilter],
246
+ dimensions: [
247
+ {
248
+ ref: 'status',
249
+ field: 'status',
250
+ },
251
+ ],
252
+ measures: [
253
+ {
254
+ ref: 'count',
255
+ field: '*',
256
+ aggregate: AggregateFunction.COUNT,
257
+ },
258
+ ],
259
+ },
260
+ series: [
261
+ {
262
+ ref: 'tasks-by-status',
263
+ name: 'Tasks by status',
264
+ measureRef: 'count',
265
+ splitByDimension: 'status',
266
+ },
267
+ ],
268
+ };
269
+ ```
270
+
271
+ The `chartViews` entry on the resource's ui-behavior, which surfaces it:
108
272
 
109
273
 
110
274
  ## Usage Example
@@ -201,7 +365,28 @@ by status, scoped to the parent todo:
201
365
  ],
202
366
  ```
203
367
 
204
- What earns its place:
368
+ What earns its place in the definition:
369
+
370
+ - `chartType: ChartType.DONUT` — typed enum. Other shapes (`BAR`,
371
+ `LINE`, etc.) are first-class enum members.
372
+ - `dataQuery.mainResourceType` — the resource being aggregated.
373
+ - `dataQuery.contextFilters: [parentTodoScopeFilter]` — confines the
374
+ query to the parent todo's tasks; the backend resolves the parent id
375
+ from the request and refuses when it is missing.
376
+ - `dataQuery.dimensions: [{ ref: 'status', field: 'status' }]` —
377
+ grouping axis. `ref` is referenced by `series[].splitByDimension`;
378
+ `field` is the schema field the framework groups by.
379
+ - `dataQuery.measures: [{ ref: 'count', field: '*', aggregate:
380
+ AggregateFunction.COUNT }]` — value axis. `field: '*'` is the
381
+ canonical wildcard for COUNT. SUM / AVG / MIN / MAX use the
382
+ field name being aggregated.
383
+ - `series: [{ ref: 'tasks-by-status', name: 'Tasks by status',
384
+ measureRef: 'count', splitByDimension: 'status' }]` — `measureRef`
385
+ must match a `measures[].ref`; `splitByDimension` must match a
386
+ `dimensions[].ref`. Series wiring is the **only** place that
387
+ combines them.
388
+
389
+ What earns its place in the `chartViews` entry:
205
390
 
206
391
  - `ref: 'todo-task-status'` is the **stable identity**. It must
207
392
  match: (a) the spec id `resources.tasks.todo-task-status`, and
@@ -222,22 +407,9 @@ What earns its place:
222
407
  is in scope. The `foreignKeyField` typed reference picks the
223
408
  correct FK on the child even when there are multiple FKs to the
224
409
  same parent type.
225
- - `chartDefinition.chartType: ChartType.DONUT` — typed enum. Other
226
- shapes (`BAR`, `LINE`, etc.) are first-class enum members.
227
- - `dataQuery.mainResourceType: R.TASKS` — the resource being
228
- aggregated.
229
- - `dataQuery.dimensions: [{ ref: 'status', field: 'status' }]` —
230
- grouping axis. `ref` is referenced by `series[].splitByDimension`;
231
- `field` is the schema field the framework groups by.
232
- - `dataQuery.measures: [{ ref: 'count', field: '*', aggregate:
233
- AggregateFunction.COUNT }]` — value axis. `field: '*'` is the
234
- canonical wildcard for COUNT. SUM / AVG / MIN / MAX use the
235
- field name being aggregated.
236
- - `series: [{ ref: 'tasks-by-status', name: 'Tasks by status',
237
- measureRef: 'count', splitByDimension: 'status' }]` — `measureRef`
238
- must match a `measures[].ref`; `splitByDimension` must match a
239
- `dimensions[].ref`. Series wiring is the **only** place that
240
- combines them.
410
+ - `chartDefinition: todoTaskStatusChartDefinition` — the shared
411
+ constant, never an inline copy: an inline copy and the backend's
412
+ registered one drift apart.
241
413
 
242
414
  What is **not** in this block (and shouldn't be):
243
415
 
@@ -261,6 +433,8 @@ What is **not** in this block (and shouldn't be):
261
433
  - [ ] `aggregate:` uses `AggregateFunction.*` (typed enum)
262
434
  - [ ] `chartType:` uses `ChartType.*` (typed enum)
263
435
  - [ ] Charts requiring a parent declare `MANDATORY` parent-resource requirement
436
+ - [ ] Every chart declared in `chartViews` names a shared `ChartDefinition` constant, registered in its backend module's `chartDefinitions` (`wildo charts audit` passes)
437
+ - [ ] A chart scoped to a parent has a `PARENT_RESOURCE` entry in `dataQuery.contextFilters`, not only a MANDATORY parent requirement
264
438
  - [ ] Spec id matches the runtime ref
265
439
  - [ ] Chart numbers read outside a chart use `useResourceChartData`, never a bare `useChartData(definition, ref)`
266
440
 
@@ -270,12 +444,19 @@ Run from the app root, substituting `<resource>`:
270
444
 
271
445
  | Invariant | Command |
272
446
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
273
- | Chart `ref` is referenced by at least one embed | `rg -oN "viewRef=\"\K[a-z-]+" frontend/src/modules/**/*CompositeView.tsx` then verify each ref is declared in some `chartViews[].ref` |
274
- | Aggregates use the typed enum | `rg -n "aggregate:\s+AggregateFunction\." frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
275
- | Chart types use the typed enum | `rg -n "chartType:\s+ChartType\." frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
276
- | **No string-literal aggregate** | `rg -n "aggregate:\s+'[A-Z]" frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` (must return empty) |
447
+ | Chart `ref` is referenced by at least one embed | `rg -P -oN "viewRef=\"\K[a-z-]+" frontend/src/modules/**/*CompositeView.tsx` then verify each ref is declared in some `chartViews[].ref` |
448
+ | Aggregates use the typed enum | `rg -n "aggregate:\s+AggregateFunction\." shared-lib/src/modules/<slug>/resources/<resource>/<resource>.charts.ts` |
449
+ | Chart types use the typed enum | `rg -n "chartType:\s+ChartType\." shared-lib/src/modules/<slug>/resources/<resource>/<resource>.charts.ts` |
450
+ | **No string-literal aggregate** | `rg -n "aggregate:\s+['\"]" shared-lib/src frontend/src` (must return empty) |
277
451
  | **No bare transport call for a declared chart** | `rg -n "useChartData\(" frontend/src` (must return empty — use `useResourceChartData`) |
278
- | Series measureRef references an existing measure (per file) | `rg -oN "measureRef:\s*'\K[a-z-]+" <ui-behavior>.tsx \| sort -u` then verify each in `measures: [{ ref: '<...>' }]` |
452
+ | **Every rendered chart is registered for the backend** | `wildo charts audit` (exits non-zero when a `chartViews` entry has no backend registration; needs the dev companion). Without it running: `rg -n "chartDefinitions" -A40 backend-api/src/modules/<slug>/index.ts` and check each constant named in a `chartViews` entry |
453
+ | **Parent-scoped charts filter their query** (each chart with a MANDATORY parent requirement) | `rg -n "ContextFilterSource\.PARENT_RESOURCE" shared-lib/src/modules/<slug>/resources/<resource>/<resource>.charts.ts` (must name a filter used by that chart's `contextFilters`) |
454
+ | Series measureRef references an existing measure (per file) | run the commands below the table, then verify each in `measures: [{ ref: '<...>' }]` |
455
+
456
+ ```bash
457
+ # Series measureRef references an existing measure (per file)
458
+ rg -P -oN "measureRef:\s*'\K[a-z-]+" shared-lib/src/modules/<slug>/resources/<resource>/<resource>.charts.ts | sort -u
459
+ ```
279
460
 
280
461
  The first invariant (chart ref referenced by an embed) is the
281
462
  high-signal one — an unreferenced chart is dead code that drifts
@@ -287,17 +468,20 @@ silently.
287
468
  |-----------------|---------|
288
469
  | "Hard-coded sample data is enough" | Production charts need the same data path as siblings — the framework derives queries from the typed `dataQuery`; bypassing it produces "works in dev, breaks in prod". |
289
470
  | "`field: '*'` only works for COUNT" | Yes — for COUNT it is the canonical wildcard. For SUM/AVG/MIN/MAX, set `field` to the schema field being aggregated. Read sibling chart for the right pattern. |
290
- | "I can skip parent requirements" | A chart aggregating across an entire collection without a MANDATORY parent renders confusing global aggregates when embedded in a parent's read page. |
471
+ | "I can skip parent requirements" | Without the MANDATORY requirement the chart is offered where no parent is in scope, and its parent-filtered query is then refused for lack of a parent id: a broken card instead of a hidden one. |
472
+ | "The MANDATORY parent requirement scopes the data" | It only decides where the chart is OFFERED. The query is confined by a `PARENT_RESOURCE` entry in `dataQuery.contextFilters`; without it the chart on a parent's page counts every row the caller can see. |
291
473
  | "I only need the numbers, so `useChartData` with the definition is simpler" | It sends no scope. An organization-scoped chart is refused (`aggregation_scope_unresolved`) while the same chart renders fine as a canvas. `useResourceChartData` resolves it the same way the canvas does. |
292
474
  | "Series can reuse a `splitByDimension` not declared in dimensions" | The framework requires `splitByDimension` to match a declared `dimensions[].ref`. Skipping declaration produces "no data" silently. |
293
475
 
294
476
  ## Red Flags
295
477
 
296
- - Chart `ref` collides with another chart in the same resource (TS deduplicates the array but the second declaration silently wins; catch by `rg -oN "ref:\s+'\K[a-z-]+" <ui-behavior>.tsx \| sort \| uniq -d`).
478
+ - Chart `ref` collides with another chart in the same resource (TS deduplicates the array but the second declaration silently wins; catch by `rg -P -oN "ref:\s+'\K[a-z-]+" <ui-behavior>.tsx | sort | uniq -d`).
479
+ - A chart with a MANDATORY parent requirement whose definition has no `PARENT_RESOURCE` context filter: it counts every row (catch with the **Parent-scoped charts filter their query** grep).
297
480
  - String-literal `aggregate` (catch with the **No string-literal aggregate** grep — must return empty).
298
481
  - `series[].measureRef` referencing a non-existent measure ref (catch with the **Series measureRef references an existing measure** check).
299
482
  - Chart embedded with `<EmbedHost*>` but declared on a different resource (use `<EmbedRelated*>` for cross-resource embedding).
300
483
  - A view calls `useChartData(definition, ref)` for a declared chart: it sends no scope and renders "unavailable" (catch with the **No bare transport call** grep).
484
+ - A chart in `chartViews` whose definition is missing from the module's `chartDefinitions`: it renders a frame and every fetch answers `chart_not_found` (catch with `wildo charts audit`, the **Every rendered chart is registered for the backend** check).
301
485
 
302
486
  ## Related Skills
303
487
 
@@ -267,12 +267,29 @@ Run from the app root, substituting the composite file:
267
267
 
268
268
  | Invariant | Command |
269
269
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
270
- | Composite uses framework primitives only | `rg -n "<(CompositeLayout\|Section\|Embed[A-Z][A-Za-z]+)" <CompositeViewFile>.tsx` |
271
- | **JSX section names match `sectionRefs`** (must return empty) | `comm -3 <(rg -oN "<Section name=\"\K[a-z-]+" <CompositeViewFile>.tsx \| sort -u) <(rg -oN "sectionRefs:\s*\[\K[^\]]+" <CompositeViewFile>.tsx \| tr ',' '\n' \| rg -oN "[a-z-]+" \| sort -u)` |
272
- | Registration map is typed | `rg -n "satisfies (ResourceCompositeViewsConfig\|AppCompositeViewsConfig)" <CompositeViewFile>.tsx` |
270
+ | Composite uses framework primitives only | see the commands below the table |
271
+ | **JSX section names match `sectionRefs`** (must return empty) | see the commands below the table |
272
+ | Registration map is typed | see the commands below the table |
273
273
  | No string-literal `SectionMode` | `rg -n "appearance=\"[A-Z]" <CompositeViewFile>.tsx` (must return empty) |
274
- | `viewRef` literals exist in their resource's chart/execution map | `rg -oN "viewRef=\"\K[a-z-]+" <CompositeViewFile>.tsx \| sort -u` then verify each in the resource's `chartViews:[]` / `executionViews:{}` |
275
- | **Single-embed sections use a solo mode** | `rg -n "appearance=\{SectionMode\.(GRID\|TABS\|COLUMNS\|VERTICAL_TABS\|PILLS\|ACCORDION\|EXPANDABLE\|STEPPER\|TIMELINE)\}" <CompositeViewFile>.tsx` — every hit must be a **direct** `<Section>` child of `<CompositeLayout>` grouped with sibling sections of the same mode; a lone or custom-component-wrapped one renders bare → switch to `SectionMode.CARD` / `DEFAULT` / `GHOST`. |
274
+ | `viewRef` literals exist in their resource's chart/execution map | run the commands below the table, then verify each in the resource's `chartViews:[]` / `executionViews:{}` |
275
+ | **Single-embed sections use a solo mode** | see the commands below the table — every hit must be a **direct** `<Section>` child of `<CompositeLayout>` grouped with sibling sections of the same mode; a lone or custom-component-wrapped one renders bare → switch to `SectionMode.CARD` / `DEFAULT` / `GHOST`. |
276
+
277
+ ```bash
278
+ # Composite uses framework primitives only
279
+ rg -n "<(CompositeLayout|Section|Embed[A-Z][A-Za-z]+)" <CompositeViewFile>.tsx
280
+
281
+ # JSX section names match `sectionRefs` (must return empty)
282
+ comm -3 <(rg -P -oN "<Section name=\"\K[a-z-]+" <CompositeViewFile>.tsx | sort -u) <(rg -P -oN "sectionRefs:\s*\[\K[^\]]+" <CompositeViewFile>.tsx | tr ',' '\n' | rg -oN "[a-z-]+" | sort -u)
283
+
284
+ # Registration map is typed
285
+ rg -n "satisfies (ResourceCompositeViewsConfig|AppCompositeViewsConfig)" <CompositeViewFile>.tsx
286
+
287
+ # `viewRef` literals exist in their resource's chart/execution map
288
+ rg -P -oN "viewRef=\"\K[a-z-]+" <CompositeViewFile>.tsx | sort -u
289
+
290
+ # Single-embed sections use a solo mode
291
+ rg -n "appearance=\{SectionMode\.(GRID|TABS|COLUMNS|VERTICAL_TABS|PILLS|ACCORDION|EXPANDABLE|STEPPER|TIMELINE)\}" <CompositeViewFile>.tsx
292
+ ```
276
293
 
277
294
  The second invariant (JSX section names == `sectionRefs`) is the
278
295
  high-signal one — the comm output catches the most common drift
@@ -183,7 +183,7 @@ Run from the app root, substituting `<resource>`:
183
183
  | Anchor source uses the typed enum | `rg -n "ExecutionViewAnchorBindingSource\." frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
184
184
  | **No string-literal anchor source** (must return empty) | `rg -n "source:\s+'[A-Z]" frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
185
185
  | Host component imports `useExecution` from the framework | `rg -n "useExecution" frontend/src/modules/<slug>/resources/<resource>/<Resource>ExecutionView.tsx` |
186
- | Execution ref matches an embed call | `rg -oN "viewRef=\"\K[a-z-]+" frontend/src/modules/<slug>/resources/**/*CompositeView.tsx` then verify each is a key in `executionViews:` |
186
+ | Execution ref matches an embed call | `rg -P -oN "viewRef=\"\K[a-z-]+" frontend/src/modules/<slug>/resources/**/*CompositeView.tsx` then verify each is a key in `executionViews:` |
187
187
 
188
188
  The third invariant (no string-literal source) is the high-signal
189
189
  one — string sources bypass typecheck and break silently when enum
@@ -189,6 +189,13 @@ export interface WebsiteRuntimeContextValue {
189
189
  * place to change it.
190
190
  */
191
191
  appOrigin?: string;
192
+ /**
193
+ * Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
194
+ * by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
195
+ * island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
196
+ * and refuses to render when it is absent.
197
+ */
198
+ legalNoticeOwed?: boolean;
192
199
  /**
193
200
  * Flat `Record<string, string>` label pack for the active locale.
194
201
  * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
@@ -414,6 +421,18 @@ export interface WebsiteSiteContext {
414
421
  * React island as JSON-serializable data.
415
422
  */
416
423
  readonly frontendProviders?: FrontendProvidersBlock;
424
+ /**
425
+ * Whether the operator owes a LEGAL NOTICE (imprint): derived by `loadWebsiteSiteContext` from
426
+ * `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts` with `legalNoticeOwed`, so the
427
+ * site and the application's `/legal-notice` page answer from the one declaration (#2588). `false` when the
428
+ * establishment is outside the EU, the EEA, the UK and Switzerland, or not declared yet.
429
+ *
430
+ * Every page forwards it to its bridge island beside `appOrigin`: the footer's legal links read it from
431
+ * `WebsiteRuntimeContext` and refuse to render without it, so a page that forgets it fails its build rather than
432
+ * dropping an obligation silently. Optional here only because a context composed by hand (a test) has no
433
+ * application config to derive it from; the loader always sets it.
434
+ */
435
+ readonly legalNoticeOwed?: boolean;
417
436
  }
418
437
 
419
438
  /**
@@ -451,6 +470,7 @@ export function composeWebsiteSiteContext(
451
470
  rootConfig: parts.rootConfig,
452
471
  websiteConfig: parts.websiteConfig,
453
472
  frontendProviders: parts.frontendProviders,
473
+ ...(parts.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: parts.legalNoticeOwed }),
454
474
  });
455
475
  }
456
476
  ```
@@ -472,16 +492,26 @@ invent a browser-readable session API.
472
492
 
473
493
  | Invariant | Command |
474
494
  |---|---|
475
- | No browser storage of opaque session values | `rg -n "localStorage|sessionStorage" website/src/session/` (must be empty for the session token path) |
495
+ | No browser storage of opaque session values | see the commands below the table (must be empty for the session token path) |
476
496
  | One session provider boundary | `rg -n "AnonymousSession.*Provider" website/src/layouts/ website/src/session/` (review duplicates) |
477
497
 
498
+ ```bash
499
+ # No browser storage of opaque session values — (must be empty for the session token path)
500
+ rg -n "localStorage|sessionStorage" website/src/session/
501
+ ```
502
+
478
503
  ## Mechanical Checks
479
504
 
480
505
  | Invariant | Command |
481
506
  |---|---|
482
- | No browser storage of opaque session values | `rg -n "localStorage|sessionStorage" website/src/session/` (must be empty for the token path) |
507
+ | No browser storage of opaque session values | see the commands below the table (must be empty for the token path) |
483
508
  | One provider boundary | `rg -n "AnonymousSession.*Provider" website/src/layouts/ website/src/session/` (review duplicates) |
484
509
 
510
+ ```bash
511
+ # No browser storage of opaque session values — (must be empty for the token path)
512
+ rg -n "localStorage|sessionStorage" website/src/session/
513
+ ```
514
+
485
515
  ## Common Rationalizations
486
516
 
487
517
  - “It is anonymous, so consent is irrelevant.” The purpose, not the label,
@@ -309,6 +309,8 @@ const designTokensCss = renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootCo
309
309
  labelPack={runtime.labelPack}
310
310
  designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
311
311
  skipToMainContentLabelKey={WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey}
312
+ appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}
313
+ legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}
312
314
  />
313
315
  </body>
314
316
  </html>
@@ -520,12 +522,23 @@ retrieval framing. Curate it intentionally.
520
522
 
521
523
  | Invariant | Command |
522
524
  |---|---|
523
- | One bridge factory call per locale | `rg -n "createWebsiteBlogPostBridgeIsland\(" website/src/pages-impl/blog-post-*.bridge.tsx \| wc -l` (must equal locale count) |
524
- | Static-string-literal globs only | `rg -n "import\.meta\.glob\(" website/src/pages-impl/blog-post-*.bridge.tsx \| rg -v "'\\.\\./content/blog/[a-z-]+/\\*\\.mdx'"` (must return empty) |
525
- | MDX integration ordering | `rg -n "mdx\(\)\|react\(\)" website/astro.config.ts` (the `mdx()` line must precede the `react()` line) |
525
+ | One bridge factory call per locale | see the commands below the table (must equal locale count) |
526
+ | Static-string-literal globs only | see the commands below the table (must return empty) |
527
+ | MDX integration ordering | see the commands below the table (the `mdx()` line must precede the `react()` line) |
526
528
  | Page manifest registered | `rg -n "BLOG_POST_PAGE_MANIFEST" website/src/website-root.config.ts` (must return ≥1 inside `pageManifests`) |
527
529
  | Frontmatter slug matches filename | per file: `rg -n "^slug: " website/src/content/blog/<locale>/<slug>.mdx` (the YAML `slug:` value must equal the basename) |
528
530
 
531
+ ```bash
532
+ # One bridge factory call per locale
533
+ rg -n "createWebsiteBlogPostBridgeIsland\(" website/src/pages-impl/blog-post-*.bridge.tsx | wc -l
534
+
535
+ # Static-string-literal globs only
536
+ rg -n "import\.meta\.glob\(" website/src/pages-impl/blog-post-*.bridge.tsx | rg -v "'\.\./content/blog/[a-z-]+/\*\.mdx'"
537
+
538
+ # MDX integration ordering
539
+ rg -n "mdx\(\)|react\(\)" website/astro.config.ts
540
+ ```
541
+
529
542
  ## Common Rationalizations
530
543
 
531
544
  | Rationalization | Reality |
@@ -1357,6 +1357,8 @@ export interface WebsiteBlogPostBridgeIslandProps {
1357
1357
  /** Product origin for navigation and call-to-action components inside the blog island.
1358
1358
  * Supplied by the Astro page from websiteConfig, just as on ordinary page bridges. */
1359
1359
  appOrigin?: string;
1360
+ /** Whether the operator owes a legal notice, from `WEBSITE_SITE_CONTEXT.legalNoticeOwed`, as on ordinary page bridges (#2588). */
1361
+ legalNoticeOwed?: boolean;
1360
1362
  }
1361
1363
 
1362
1364
  const EMPTY_MDX_COMPONENTS: WebsiteMdxComponentsMap = Object.freeze({});
@@ -1388,6 +1390,7 @@ export function createWebsiteBlogPostBridgeIsland(
1388
1390
  skipToMainContentLabelKey,
1389
1391
  frontendProviders,
1390
1392
  appOrigin,
1393
+ legalNoticeOwed,
1391
1394
  }: WebsiteBlogPostBridgeIslandProps): ReactNode {
1392
1395
  const MdxBody = slugToMdxBody[slug];
1393
1396
  if (MdxBody === undefined) {
@@ -1427,6 +1430,7 @@ export function createWebsiteBlogPostBridgeIsland(
1427
1430
  navigation,
1428
1431
  skipToMainContentLabelKey,
1429
1432
  appOrigin,
1433
+ ...(legalNoticeOwed !== undefined ? { legalNoticeOwed } : {}),
1430
1434
  ...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
1431
1435
  frontendProviderRegistry,
1432
1436
  providerComponentRegistry,
@@ -370,6 +370,7 @@ a 200 KB regression in production.
370
370
  |-----------------------------------------|-------------------------------------------------------------------|
371
371
  | Cross-frontend handoff DTOs | `@wildo-ai/saas-models/public-runtime` |
372
372
  | Canonical HTTP header keys | `@wildo-ai/saas-models/public-runtime` |
373
+ | Public governed-document refs + paths | `@wildo-ai/saas-models/public-runtime` (or render `WebsitePublicDocumentLinks`) |
373
374
  | `AvailableLanguage` / `TextDirection` | `@wildo-ai/saas-models/public-runtime` (preferred — single door) |
374
375
  | Locale atoms not (yet) re-exported | `@wildo-ai/presets-components-models/public-runtime` |
375
376
  | Build-time decorator-metadata reads | `@wildo-ai/zod-decorators` (import is side-effect-free) |
@@ -522,7 +523,12 @@ Run from the app root:
522
523
  | **No `saas-frontend-lib` import in `website/src/`** | `rg -n "from '@wildo-ai/saas-frontend-lib" website/src/` |
523
524
  | **No `saas-backend-lib` import in `website/src/`** | `rg -n "from '@wildo-ai/saas-backend-lib" website/src/` |
524
525
  | **No `inversify` in `website/src/`** | `rg -n "from 'inversify'" website/src/` |
525
- | **SSR-tier deps confined to `middleware/`** | `rg -n "from '(axios\|jsonwebtoken\|socket\.io-client\|reflect-metadata)'" website/src/ -g '!website/src/middleware/**'` |
526
+ | **SSR-tier deps confined to `middleware/`** | see the commands below the table |
527
+
528
+ ```bash
529
+ # SSR-tier deps confined to `middleware/`
530
+ rg -n "from '(axios|jsonwebtoken|socket\.io-client|reflect-metadata)'" website/src/ -g '!website/src/middleware/**'
531
+ ```
526
532
 
527
533
  The high-signal invariant is the **last one** — it catches the
528
534
  most-common regression (an SSR-tier import sneaking into a `.tsx`
@@ -1012,6 +1012,13 @@ export interface WebsiteRuntimeContextValue {
1012
1012
  * place to change it.
1013
1013
  */
1014
1014
  appOrigin?: string;
1015
+ /**
1016
+ * Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
1017
+ * by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
1018
+ * island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
1019
+ * and refuses to render when it is absent.
1020
+ */
1021
+ legalNoticeOwed?: boolean;
1015
1022
  /**
1016
1023
  * Flat `Record<string, string>` label pack for the active locale.
1017
1024
  * Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
@@ -1145,13 +1152,18 @@ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
1145
1152
 
1146
1153
  | Invariant | Command |
1147
1154
  |---|---|
1148
- | No component reads consent from storage | `rg -n "__wildo_website_consent\|localStorage" website/src/` (must return nothing) |
1155
+ | No component reads consent from storage | see the commands below the table (must return nothing) |
1149
1156
  | No raw cookie reads | `rg -n "document\.cookie" website/src/` (must return nothing) |
1150
1157
  | Every locale labels the panel | `rg -c "website.chrome.consent." website/src/i18n/` (same count in every file) |
1151
1158
  | Every locale labels the provider-component states | `rg -c "website.chrome.provider-component." website/src/i18n/` (2 in every file) |
1152
1159
  | No page calls a provider's loader itself | `rg -n "components\??\.\[?.*\]?\.load\(" website/src/` (must return nothing — mount it through `WebsiteProviderComponent`) |
1153
1160
  | A replacement panel reaches every bridge | `rg -n "consentBannerComponent" website/src/pages-impl/` (one per bridge, or none) |
1154
1161
 
1162
+ ```bash
1163
+ # No component reads consent from storage
1164
+ rg -n "__wildo_website_consent|localStorage" website/src/
1165
+ ```
1166
+
1155
1167
  ## Common Rationalizations
1156
1168
 
1157
1169
  | Rationalization | Reality |
@@ -359,8 +359,16 @@ advanced component result before accepting its fallback behavior.
359
359
 
360
360
  | Invariant | Command |
361
361
  |---|---|
362
- | Escape hatch has a documented reason | `rg -n "factory limitation|escape hatch" website/src/sections/` (must find the advanced component) |
363
- | Advanced integration has a fallback | `rg -n "fallback|unavailable|failed" website/src/sections/` (review the advanced component result) |
362
+ | Escape hatch has a documented reason | see the commands below the table (must find the advanced component) |
363
+ | Advanced integration has a fallback | see the commands below the table (review the advanced component result) |
364
+
365
+ ```bash
366
+ # Escape hatch has a documented reason — (must find the advanced component)
367
+ rg -n "factory limitation|escape hatch" website/src/sections/
368
+
369
+ # Advanced integration has a fallback — (review the advanced component result)
370
+ rg -n "fallback|unavailable|failed" website/src/sections/
371
+ ```
364
372
 
365
373
  ## Common Rationalizations
366
374