@wildo-ai/framework-knowledge 1.1.8 → 1.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +9 -2
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +95 -5
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +41 -3
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +175 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -2
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +90 -13
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +8 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +91 -43
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +27 -18
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +11 -11
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +71 -2
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +9 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +3 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +41 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +22 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
- package/dist/knowledge/references/brand.name-choice.config.md +144 -0
- package/dist/knowledge/references/brand.name-screening.config.md +308 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
- package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
- package/dist/knowledge/references/capability-composition.config.md +67 -4
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
- package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +374 -1
- package/dist/knowledge/registries/playbooks.json +76 -28
- package/dist/knowledge/registries/source-tags.json +1513 -898
- package/dist/knowledge/rules/live-context-door.md +5 -2
- package/dist/knowledge/skills/INDEX.md +5 -2
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1590 -292
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- 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
|
|
27
|
-
`
|
|
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
|
|
65
|
-
|
|
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
|
-
|
|
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:
|
|
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),
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
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
|
|
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
|
|
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
|
|
226
|
-
|
|
227
|
-
|
|
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\."
|
|
275
|
-
| Chart types use the typed enum | `rg -n "chartType:\s+ChartType\."
|
|
276
|
-
| **No string-literal aggregate** | `rg -n "aggregate:\s+'
|
|
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
|
-
|
|
|
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" |
|
|
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
|
|
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 |
|
|
271
|
-
| **JSX section names match `sectionRefs`** (must return empty) |
|
|
272
|
-
| Registration map is typed |
|
|
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 |
|
|
275
|
-
| **Single-embed sections use a solo mode** |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
524
|
-
| Static-string-literal globs only |
|
|
525
|
-
| MDX integration ordering |
|
|
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/`** |
|
|
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 |
|
|
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 |
|
|
@@ -101,6 +101,8 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
101
101
|
sectionRef: WebsiteSectionRef | string;
|
|
102
102
|
category: WebsiteSectionCategory;
|
|
103
103
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
104
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
105
|
+
anchorId?: string;
|
|
104
106
|
Component: ComponentType<TProps>;
|
|
105
107
|
/**
|
|
106
108
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
@@ -183,6 +185,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
183
185
|
sectionRef: input.sectionRef,
|
|
184
186
|
category: input.category,
|
|
185
187
|
expectedLabelKeys: input.expectedLabelKeys,
|
|
188
|
+
anchorId: input.anchorId,
|
|
186
189
|
Component: input.Component,
|
|
187
190
|
getStructuredData: input.getStructuredData,
|
|
188
191
|
});
|
|
@@ -195,6 +198,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
195
198
|
sectionRef: parsed.sectionRef,
|
|
196
199
|
category: parsed.category,
|
|
197
200
|
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
201
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
198
202
|
Component: input.Component,
|
|
199
203
|
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
200
204
|
};
|
|
@@ -355,8 +359,16 @@ advanced component result before accepting its fallback behavior.
|
|
|
355
359
|
|
|
356
360
|
| Invariant | Command |
|
|
357
361
|
|---|---|
|
|
358
|
-
| Escape hatch has a documented reason |
|
|
359
|
-
| Advanced integration has a fallback |
|
|
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
|
+
```
|
|
360
372
|
|
|
361
373
|
## Common Rationalizations
|
|
362
374
|
|