@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
|
@@ -187,6 +187,13 @@ export interface WebsiteRuntimeContextValue {
|
|
|
187
187
|
* place to change it.
|
|
188
188
|
*/
|
|
189
189
|
appOrigin?: string;
|
|
190
|
+
/**
|
|
191
|
+
* Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
|
|
192
|
+
* by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
|
|
193
|
+
* island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
|
|
194
|
+
* and refuses to render when it is absent.
|
|
195
|
+
*/
|
|
196
|
+
legalNoticeOwed?: boolean;
|
|
190
197
|
/**
|
|
191
198
|
* Flat `Record<string, string>` label pack for the active locale.
|
|
192
199
|
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
@@ -377,7 +384,12 @@ of a raw browser submission bypass.
|
|
|
377
384
|
| Invariant | Command |
|
|
378
385
|
|---|---|
|
|
379
386
|
| No raw contact fetch bypass | `rg -n "fetch\(" website/src/sections/` (must be empty or use the approved public adapter) |
|
|
380
|
-
| Form has declared form/session boundary |
|
|
387
|
+
| Form has declared form/session boundary | see the commands below the table (must return at least one result) |
|
|
388
|
+
|
|
389
|
+
```bash
|
|
390
|
+
# Form has declared form/session boundary
|
|
391
|
+
rg -n "InboundContactForm|getAnonymousSessionClient" website/src/sections/
|
|
392
|
+
```
|
|
381
393
|
|
|
382
394
|
## Common Rationalizations
|
|
383
395
|
|
|
@@ -512,9 +512,14 @@ to confirm that one main landmark remains.
|
|
|
512
512
|
|
|
513
513
|
| Invariant | Command |
|
|
514
514
|
|---|---|
|
|
515
|
-
| One main landmark remains |
|
|
515
|
+
| One main landmark remains | see the commands below the table (review every page result) |
|
|
516
516
|
| Layout does not own page-specific copy | `rg -n "useWebsiteLabel" website/src/layouts/` (review scope; page copy belongs below) |
|
|
517
517
|
|
|
518
|
+
```bash
|
|
519
|
+
# One main landmark remains — (review every page result)
|
|
520
|
+
rg -n "<main|role=\"main\"" website/src/
|
|
521
|
+
```
|
|
522
|
+
|
|
518
523
|
## Common Rationalizations
|
|
519
524
|
|
|
520
525
|
- “We can solve it globally because it is only a CSS change.” Global scope
|
|
@@ -165,6 +165,18 @@ export interface WebsiteSiteContext {
|
|
|
165
165
|
* React island as JSON-serializable data.
|
|
166
166
|
*/
|
|
167
167
|
readonly frontendProviders?: FrontendProvidersBlock;
|
|
168
|
+
/**
|
|
169
|
+
* Whether the operator owes a LEGAL NOTICE (imprint): derived by `loadWebsiteSiteContext` from
|
|
170
|
+
* `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts` with `legalNoticeOwed`, so the
|
|
171
|
+
* site and the application's `/legal-notice` page answer from the one declaration (#2588). `false` when the
|
|
172
|
+
* establishment is outside the EU, the EEA, the UK and Switzerland, or not declared yet.
|
|
173
|
+
*
|
|
174
|
+
* Every page forwards it to its bridge island beside `appOrigin`: the footer's legal links read it from
|
|
175
|
+
* `WebsiteRuntimeContext` and refuse to render without it, so a page that forgets it fails its build rather than
|
|
176
|
+
* dropping an obligation silently. Optional here only because a context composed by hand (a test) has no
|
|
177
|
+
* application config to derive it from; the loader always sets it.
|
|
178
|
+
*/
|
|
179
|
+
readonly legalNoticeOwed?: boolean;
|
|
168
180
|
}
|
|
169
181
|
|
|
170
182
|
/**
|
|
@@ -202,6 +214,7 @@ export function composeWebsiteSiteContext(
|
|
|
202
214
|
rootConfig: parts.rootConfig,
|
|
203
215
|
websiteConfig: parts.websiteConfig,
|
|
204
216
|
frontendProviders: parts.frontendProviders,
|
|
217
|
+
...(parts.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: parts.legalNoticeOwed }),
|
|
205
218
|
});
|
|
206
219
|
}
|
|
207
220
|
```
|
|
@@ -264,7 +277,12 @@ key has an application-owned model/spec owner before wiring it into a section.
|
|
|
264
277
|
|
|
265
278
|
| Invariant | Command |
|
|
266
279
|
|---|---|
|
|
267
|
-
| No secret-looking data in extra mapping |
|
|
280
|
+
| No secret-looking data in extra mapping | see the commands below the table (must be empty for metadata mapping) |
|
|
281
|
+
|
|
282
|
+
```bash
|
|
283
|
+
# No secret-looking data in extra mapping — (must be empty for metadata mapping)
|
|
284
|
+
rg -n "token|secret|password" website/src/sections/
|
|
285
|
+
```
|
|
268
286
|
|
|
269
287
|
## Common Rationalizations
|
|
270
288
|
|
|
@@ -38,8 +38,8 @@ consequences flow from that:
|
|
|
38
38
|
`FOOTER` value on purpose: chrome doesn't participate in the
|
|
39
39
|
per-section SEO-dispatch contract, doesn't get a `data-section-ref`,
|
|
40
40
|
and isn't authored under `website/src/sections/`. It's authored
|
|
41
|
-
under `website/src/
|
|
42
|
-
site.
|
|
41
|
+
under `website/src/components/` (the scaffold's `HeaderComponent.tsx`
|
|
42
|
+
and `FooterComponent.tsx`) and registered once for the entire site.
|
|
43
43
|
2. **They render OUTSIDE the page's `<main>`.** `WebsitePageLayout`
|
|
44
44
|
emits `<header>{HeaderComponent}</header>` and
|
|
45
45
|
`<footer>{FooterComponent}</footer>` around the `<main>` that
|
|
@@ -66,8 +66,8 @@ surface without buying isolation.
|
|
|
66
66
|
|
|
67
67
|
| Surface | Glob (relative to app root) |
|
|
68
68
|
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
69
|
-
| Header component | `website/src/
|
|
70
|
-
| Footer component | `website/src/
|
|
69
|
+
| Header component | `website/src/components/HeaderComponent.tsx` (the scaffold's file) |
|
|
70
|
+
| Footer component | `website/src/components/FooterComponent.tsx` (the scaffold's file) |
|
|
71
71
|
| Site-wide navigation registration | `website/src/website-root.config.ts` (the file that exports `WEBSITE_ROOT_CONFIG: WebsiteRootConfig`) |
|
|
72
72
|
| Per-page chrome override (rare) | `website/src/pages-impl/<page-ref>.page.tsx` (passes `header={…}` / `footer={…}` to `<WebsitePageLayout>`) |
|
|
73
73
|
| Site-wide chrome label keys | `website/src/i18n/<locale>.json` under the `website.chrome.`* synthetic page/section namespace (see `website-label-pack`) |
|
|
@@ -149,10 +149,18 @@ so the auto-prefix behavior is exactly the wrong contract. Read the
|
|
|
149
149
|
locale list from `useWebsiteRuntime().locale` (the active locale)
|
|
150
150
|
plus `WebsiteRootConfig.locales` injected as a prop or imported
|
|
151
151
|
directly from your `website-root.config.ts`.
|
|
152
|
-
- **Legal
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
152
|
+
- **Legal links** — render `<WebsitePublicDocumentLinks />` once in the
|
|
153
|
+
footer. It links every public governed document the application serves
|
|
154
|
+
(its privacy notice and its terms) at the page the APPLICATION serves it
|
|
155
|
+
on, on the application's origin, plus the legal notice (imprint) when
|
|
156
|
+
the operator is established in the EU, the EEA, the UK or Switzerland; the site has no legal
|
|
157
|
+
pages of its own. Its labels are framework-owned keys
|
|
158
|
+
(`website.chrome.legal.*`) every locale pack must carry. Never
|
|
159
|
+
hand-write a `/privacy`, `/legal-notice` or `/legal/...` link: the paths
|
|
160
|
+
come from the constant the application's router mounts. Every page
|
|
161
|
+
forwards `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its
|
|
162
|
+
bridge island, beside `appOrigin`.
|
|
163
|
+
See `references/framework-public-document-links-api.md`.
|
|
156
164
|
- **Social links** — always pass `external` to `WebsiteLink` so the
|
|
157
165
|
primitive applies `rel="noopener noreferrer"` + `target="_blank"`
|
|
158
166
|
automatically.
|
|
@@ -255,7 +263,12 @@ repeat the intentional primary route map there.
|
|
|
255
263
|
|
|
256
264
|
| Invariant | Command |
|
|
257
265
|
|---|---|
|
|
258
|
-
| Primary nav URLs are surfaced in `llms.txt` |
|
|
266
|
+
| Primary nav URLs are surfaced in `llms.txt` | see the commands below the table (must include the current primary routes) |
|
|
267
|
+
|
|
268
|
+
```bash
|
|
269
|
+
# Primary nav URLs are surfaced in `llms.txt` — (must include the current primary routes)
|
|
270
|
+
rg -n "\\]\\(.*/(features|pricing|contact|blog)?\\)" website/src/content/llms.txt
|
|
271
|
+
```
|
|
259
272
|
|
|
260
273
|
## Cross-frontend handoff CTA pattern (D16)
|
|
261
274
|
|
|
@@ -296,7 +309,8 @@ per locale and is exercised from every page.
|
|
|
296
309
|
| Footer column heading | `website.chrome.footer.<column-ref>.heading` (e.g. `product.heading`) |
|
|
297
310
|
| Footer column link | `website.chrome.footer.<column-ref>.<link-ref>` |
|
|
298
311
|
| Footer locale-switcher (a11y) | `website.chrome.footer.locale-switcher.label` |
|
|
299
|
-
| Footer
|
|
312
|
+
| Footer copyright | `website.chrome.footer.copyright` |
|
|
313
|
+
| Legal links (framework-owned) | `website.chrome.legal.heading`, `website.chrome.legal.<document-id>` (e.g. `privacy-notice`, `service-terms`), `website.chrome.legal.legal-notice`; listed by `WEBSITE_LEGAL_LABEL_KEYS`, never in `chromeLabelKeys` |
|
|
300
314
|
| Footer social link (a11y) | `website.chrome.footer.social.<network>` |
|
|
301
315
|
|
|
302
316
|
|
|
@@ -314,8 +328,9 @@ registration so chrome copy doesn't need a synthetic manifest entry.
|
|
|
314
328
|
`header={null}` suppression escape hatch. Inline blocks were
|
|
315
329
|
extracted to honor the inline-code-block discipline (Rule 10);
|
|
316
330
|
promote them to `example.website.chrome.*` Tier A
|
|
317
|
-
anchors when the consumer-side chrome
|
|
318
|
-
`website/src/
|
|
331
|
+
anchors when the consumer-side chrome is anchored in
|
|
332
|
+
`website/src/components/`.
|
|
333
|
+
- `references/framework-public-document-links-api.md` — source-backed `WebsitePublicDocumentLinks`, the footer's legal links.
|
|
319
334
|
- The three runtime moving parts (slot schema, runtime carrier,
|
|
320
335
|
layout resolution rules: per-page override → runtime fallback →
|
|
321
336
|
explicit `null` suppression) are framework-internal. Refer to
|
|
@@ -326,8 +341,11 @@ registration so chrome copy doesn't need a synthetic manifest entry.
|
|
|
326
341
|
|
|
327
342
|
## Verification
|
|
328
343
|
|
|
329
|
-
- Header / footer components live under `website/src/
|
|
344
|
+
- Header / footer components live under `website/src/components/`,
|
|
330
345
|
not under `website/src/sections/` (chrome ≠ section).
|
|
346
|
+
- The footer renders `<WebsitePublicDocumentLinks />`, and no chrome file hand-writes a
|
|
347
|
+
`/privacy`, `/terms`, `/legal-notice` or `/legal/` link.
|
|
348
|
+
- Every page that renders a bridge island forwards `legalNoticeOwed` beside `appOrigin`.
|
|
331
349
|
- Components are registered ONCE on `WebsiteRootConfig.navigation`
|
|
332
350
|
(not per-page) — per-page overrides via `<WebsitePageLayout header={…} footer={…}>` are the exception, not the rule.
|
|
333
351
|
- No `defineWebsiteSection(...)` call wraps a header/footer
|
|
@@ -356,12 +374,26 @@ don't pass the prop).
|
|
|
356
374
|
|
|
357
375
|
| Invariant | Command |
|
|
358
376
|
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
|
|
359
|
-
| Chrome lives outside `sections/` | `rg -l "useWebsiteLabel\(" website/src/
|
|
360
|
-
| Chrome registered, not authored as a section | `rg -n "defineWebsiteSection" website/src/
|
|
377
|
+
| Chrome lives outside `sections/` | `rg -l "useWebsiteLabel\(" website/src/components/` (must return empty — chrome must use `useWebsiteLabelByKey`) |
|
|
378
|
+
| Chrome registered, not authored as a section | `rg -n "defineWebsiteSection" website/src/components/` (must return empty) |
|
|
361
379
|
| Header CTA targets the handoff route | `rg -n "primaryCtaHref:" website/src/website-root.config.ts` (must reference `/auth/handoff` or the consumer's documented handoff path) |
|
|
362
|
-
| Locale switcher uses `hrefLang` | `rg -n "hrefLang" website/src/
|
|
363
|
-
| External social links are flagged | `rg -n "<WebsiteLink href=\"https" website/src/
|
|
364
|
-
|
|
|
380
|
+
| Locale switcher uses `hrefLang` | `rg -n "hrefLang" website/src/components/FooterComponent.tsx` (must return ≥1 when the site has a locale switcher) |
|
|
381
|
+
| External social links are flagged | `rg -n "<WebsiteLink href=\"https" website/src/components/FooterComponent.tsx` (every match must also have `external`) |
|
|
382
|
+
| The footer links the legal documents | `rg -n "WebsitePublicDocumentLinks" website/src/components/FooterComponent.tsx` (must return ≥1) |
|
|
383
|
+
| No hand-written legal link | see the commands below the table (must return empty — the component owns those paths) |
|
|
384
|
+
| Every page forwards `legalNoticeOwed` | see the commands below the table (must return empty) |
|
|
385
|
+
| Chrome never re-declares the landmark | see the commands below the table (must return empty — the layout already emits both) |
|
|
386
|
+
|
|
387
|
+
```bash
|
|
388
|
+
# No hand-written legal link
|
|
389
|
+
rg -n "['\"]/(privacy|terms|legal-notice|legal/)" website/src
|
|
390
|
+
|
|
391
|
+
# Every page forwards `legalNoticeOwed`
|
|
392
|
+
comm -23 <(rg -l "appOrigin=" website/src/pages | sort) <(rg -l "legalNoticeOwed=" website/src/pages | sort)
|
|
393
|
+
|
|
394
|
+
# Chrome never re-declares the landmark
|
|
395
|
+
rg -n "<header\b|<footer\b" website/src/components/
|
|
396
|
+
```
|
|
365
397
|
|
|
366
398
|
|
|
367
399
|
## Common Rationalizations
|
|
@@ -379,6 +411,11 @@ don't pass the prop).
|
|
|
379
411
|
|
|
380
412
|
## Red Flags
|
|
381
413
|
|
|
414
|
+
- **A footer without `WebsitePublicDocumentLinks`, or a hand-written `/privacy` / `/terms` / `/legal-notice` / `/legal/...`
|
|
415
|
+
link** — the legal pages are the application's, on its origin, and their paths come from the constant its router
|
|
416
|
+
mounts (catch with the **legal links** greps above).
|
|
417
|
+
- **A page forwarding `appOrigin` but not `legalNoticeOwed`** — its footer throws in the build, and a legal notice
|
|
418
|
+
the operator owes must not be dropped (catch with the **`legalNoticeOwed`** grep above).
|
|
382
419
|
- **A `<header>` or `<footer>` element at the root of a chrome component** — the layout
|
|
383
420
|
already emits that landmark, so the page gets two (catch with the **landmark** grep above).
|
|
384
421
|
- **Hardcoded `<a href="https://...">` in chrome that targets the SaaS
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# The footer's legal links (source-backed)
|
|
2
|
+
|
|
3
|
+
`WebsitePublicDocumentLinks` renders the site's legal links: the application's privacy notice and terms, each linked at
|
|
4
|
+
the page the application serves it on, on the application's origin, and its legal notice (imprint) when the operator
|
|
5
|
+
owes one.
|
|
6
|
+
|
|
7
|
+
Read this when:
|
|
8
|
+
|
|
9
|
+
- you are authoring or changing the site footer;
|
|
10
|
+
- you are about to write a `/privacy`, `/terms`, `/legal-notice`, `/imprint` or `/legal/...` link by hand (do not: render
|
|
11
|
+
this component);
|
|
12
|
+
- a locale pack fails the build on a missing `website.chrome.legal.*` key (add the label; the keys are framework-owned).
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-website`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
*
|
|
24
|
+
* The site's LEGAL LINKS: one link per public governed document the application serves (its privacy notice and its
|
|
25
|
+
* terms), each to the page the application itself serves it at, on the APPLICATION's origin. Render it once in the
|
|
26
|
+
* site footer.
|
|
27
|
+
*
|
|
28
|
+
* Total over the public documents: a document the framework adds is linked by every site at its next build, and its
|
|
29
|
+
* label is a framework-owned key every locale pack must carry (`WEBSITE_LEGAL_LABEL_KEYS`). The page paths come from
|
|
30
|
+
* the same constant the application's router mounts, so a link cannot point where no page is.
|
|
31
|
+
*
|
|
32
|
+
* When the operator owes a LEGAL NOTICE (imprint) — established in the EU, the EEA, the UK or Switzerland, derived at build time from
|
|
33
|
+
* `operatorComplianceIdentity.establishmentJurisdiction` — a last link goes to the application's `/legal-notice` page.
|
|
34
|
+
* Directive 2000/31/EC Art. 5(1) wants that information "easily, directly and permanently accessible", which a footer
|
|
35
|
+
* link on every page is. An operator who owes none gets no link.
|
|
36
|
+
* spec-cite: Directive 2000/31/EC Art. 5(1)
|
|
37
|
+
*
|
|
38
|
+
* A same-tab link, not `external`: a legal page is something the visitor reads and comes back from, and an unexpected
|
|
39
|
+
* new window is the worse experience. The application's page shows the published document, or says plainly that it is
|
|
40
|
+
* not published yet.
|
|
41
|
+
*
|
|
42
|
+
* Throws when the page did not forward `appOrigin` or `legalNoticeOwed` to its bridge island, like the scaffold's
|
|
43
|
+
* `useAppOrigin`: a legal link pointing nowhere, or an owed one silently missing, must fail the build that produced
|
|
44
|
+
* it, not ship.
|
|
45
|
+
*
|
|
46
|
+
* Import from `@wildo-ai/saas-website`.
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* // website/src/components/FooterComponent.tsx
|
|
50
|
+
* <WebsitePublicDocumentLinks className="wt-footer__legal" />
|
|
51
|
+
*/
|
|
52
|
+
export function WebsitePublicDocumentLinks({ className }: WebsitePublicDocumentLinksProps): ReactNode {
|
|
53
|
+
const { appOrigin, legalNoticeOwed } = useWebsiteRuntime();
|
|
54
|
+
const headingId = useId();
|
|
55
|
+
const heading = useWebsiteLabelByKey(WEBSITE_LEGAL_LINKS_HEADING_LABEL_KEY);
|
|
56
|
+
const legalNoticeLabel = useWebsiteLabelByKey(WEBSITE_LEGAL_NOTICE_LABEL_KEY);
|
|
57
|
+
if (!appOrigin) {
|
|
58
|
+
throw new Error(
|
|
59
|
+
'[saas-website] WebsitePublicDocumentLinks needs the application origin. The page rendering it must forward '
|
|
60
|
+
+ '`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to its bridge island.',
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
if (legalNoticeOwed === undefined) {
|
|
64
|
+
throw new Error(
|
|
65
|
+
'[saas-website] WebsitePublicDocumentLinks needs to know whether a legal notice is owed. The page rendering it '
|
|
66
|
+
+ 'must forward `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its bridge island.',
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
const origin = appOrigin.replace(/\/+$/u, '');
|
|
70
|
+
return (
|
|
71
|
+
<nav aria-labelledby={headingId} className={className} data-website-legal-links="">
|
|
72
|
+
<span id={headingId} hidden>{heading}</span>
|
|
73
|
+
<ul>
|
|
74
|
+
{WEBSITE_PUBLIC_DOCUMENT_REF_NAMES.map((refName) => (
|
|
75
|
+
<WebsitePublicDocumentLink key={refName} refName={refName} href={`${origin}${PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS[PUBLIC_GOVERNED_DOCUMENT_REFS[refName]]}`} />
|
|
76
|
+
))}
|
|
77
|
+
{legalNoticeOwed ? (
|
|
78
|
+
<li>
|
|
79
|
+
<WebsiteLink href={`${origin}${LEGAL_NOTICE_ROUTE_PATH}`}>{legalNoticeLabel}</WebsiteLink>
|
|
80
|
+
</li>
|
|
81
|
+
) : null}
|
|
82
|
+
</ul>
|
|
83
|
+
</nav>
|
|
84
|
+
);
|
|
85
|
+
}
|
|
86
|
+
WebsitePublicDocumentLinks.displayName = 'WebsitePublicDocumentLinks';
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
- The labels are `website.chrome.legal.heading` (the landmark's name, read by screen readers), one
|
|
90
|
+
`website.chrome.legal.<document-id>` per public document (`privacy-notice`, `service-terms`), and
|
|
91
|
+
`website.chrome.legal.legal-notice`. Author all of them in every locale pack, even when the operator owes no notice
|
|
92
|
+
today; do NOT list them in `chromeLabelKeys`, the framework adds them.
|
|
93
|
+
- The legal-notice link appears when `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts`
|
|
94
|
+
is in the EU, the EEA, the UK or Switzerland; the site-context loader derives it. Do not add or remove that link by hand. To change whether it
|
|
95
|
+
shows, change the declaration (see the `config-saas` skill's compliance declarations).
|
|
96
|
+
- The page must forward `appOrigin` and `legalNoticeOwed` to its bridge island, like every page the scaffold generates:
|
|
97
|
+
`legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}`. Without either the component throws in the build, because a
|
|
98
|
+
legal link pointing nowhere, or an owed one silently missing, must not ship.
|
|
@@ -142,6 +142,7 @@ import {
|
|
|
142
142
|
WebsiteText,
|
|
143
143
|
WebsiteTextVariant,
|
|
144
144
|
type WebsiteLabelKey,
|
|
145
|
+
WebsitePublicDocumentLinks,
|
|
145
146
|
} from '@wildo-ai/saas-website';
|
|
146
147
|
import { AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
|
|
147
148
|
|
|
@@ -157,7 +158,7 @@ type SiteFooterLink =
|
|
|
157
158
|
| {
|
|
158
159
|
kind: 'internal';
|
|
159
160
|
labelKey: WebsiteLabelKey;
|
|
160
|
-
/** Locale-NEUTRAL path (eg. `/
|
|
161
|
+
/** Locale-NEUTRAL path (eg. `/pricing`). */
|
|
161
162
|
routePath: string;
|
|
162
163
|
}
|
|
163
164
|
| {
|
|
@@ -225,8 +226,8 @@ function SocialLink({ link }: { link: { labelKey: WebsiteLabelKey; href: string
|
|
|
225
226
|
|
|
226
227
|
export function SiteFooter({ columns, socialLinks, availableLocales }: SiteFooterProps) {
|
|
227
228
|
const { locale: activeLocale } = useWebsiteRuntime();
|
|
228
|
-
const
|
|
229
|
-
'website.chrome.footer.
|
|
229
|
+
const copyright = useWebsiteLabelByKey(
|
|
230
|
+
'website.chrome.footer.copyright' as WebsiteLabelKey,
|
|
230
231
|
);
|
|
231
232
|
const localeSwitcherLabel = useWebsiteLabelByKey(
|
|
232
233
|
'website.chrome.footer.locale-switcher.label' as WebsiteLabelKey,
|
|
@@ -263,7 +264,10 @@ export function SiteFooter({ columns, socialLinks, availableLocales }: SiteFoote
|
|
|
263
264
|
))}
|
|
264
265
|
</ul>
|
|
265
266
|
|
|
266
|
-
|
|
267
|
+
{/* The application's privacy notice and terms, on the application's origin: never hand-written links. */}
|
|
268
|
+
<WebsitePublicDocumentLinks />
|
|
269
|
+
|
|
270
|
+
<WebsiteText variant={WebsiteTextVariant.CAPTION}>{copyright}</WebsiteText>
|
|
267
271
|
</div>
|
|
268
272
|
);
|
|
269
273
|
}
|
|
@@ -308,13 +312,6 @@ const FOOTER_COLUMNS: SiteFooterProps['columns'] = [
|
|
|
308
312
|
{ kind: 'internal', labelKey: 'website.chrome.footer.product.pricing' as WebsiteLabelKey, routePath: '/pricing' },
|
|
309
313
|
],
|
|
310
314
|
},
|
|
311
|
-
{
|
|
312
|
-
headingKey: 'website.chrome.footer.legal.heading' as WebsiteLabelKey,
|
|
313
|
-
links: [
|
|
314
|
-
{ kind: 'internal', labelKey: 'website.chrome.footer.legal.privacy' as WebsiteLabelKey, routePath: '/legal/privacy' },
|
|
315
|
-
{ kind: 'internal', labelKey: 'website.chrome.footer.legal.terms' as WebsiteLabelKey, routePath: '/legal/terms' },
|
|
316
|
-
],
|
|
317
|
-
},
|
|
318
315
|
];
|
|
319
316
|
|
|
320
317
|
const SOCIAL_LINKS: SiteFooterProps['socialLinks'] = [
|
|
@@ -59,10 +59,19 @@ each with the skill that authors it. The plan split the page into sections on pu
|
|
|
59
59
|
|
|
60
60
|
- **Author the page, not its sections.** Write the route, bridge, page component and manifest,
|
|
61
61
|
register the page, and create `<page>.sections.tsx` with an empty sections list the page
|
|
62
|
-
renders from
|
|
62
|
+
renders from, DECLARED WITH ITS TYPE — `export const HOME_SECTIONS: readonly
|
|
63
|
+
WebsiteSectionDefinition[] = [];` — because an unannotated empty array is `never[]` and the
|
|
64
|
+
page that maps over it does not compile until the first section lands. Register it in
|
|
65
|
+
`sections/index.ts` (re-exported, and spread into
|
|
63
66
|
`WEBSITE_SECTIONS`), or the label audit never sees the page's sections. Each section is its
|
|
64
67
|
own build task, authored with its own `website-section-*` skill, and it adds itself to that
|
|
65
68
|
list.
|
|
69
|
+
- **Render the list through `<WebsitePageSections pageRef="home" sections={HOME_SECTIONS} />`**,
|
|
70
|
+
never a hand-written `map`. While the list is empty the page shows a marked pending block, so
|
|
71
|
+
`astro dev` serves it, and the page visibly says its sections are still to come. `astro build`
|
|
72
|
+
refuses a page with no section: publish only once each page has one. A section an in-page link
|
|
73
|
+
targets (`<a href="#tiers">`) declares `anchorId: 'tiers'` in its `defineWebsiteSection` call;
|
|
74
|
+
the component turns it into the section's DOM `id`.
|
|
66
75
|
- **Keep the plan's identities.** The plan says `page-home`; the tree spells the page `home`
|
|
67
76
|
(`home.page.tsx`, `HOME_PAGE_MANIFEST`, `home.sections.tsx`). Section refs are used verbatim.
|
|
68
77
|
- **Do not re-decide the message.** Purpose, audience and tone were decided from the market
|
|
@@ -89,10 +98,13 @@ each with the skill that authors it. The plan split the page into sections on pu
|
|
|
89
98
|
see `website-section-faq`.
|
|
90
99
|
3. In the route's frontmatter, forward BOTH origins to the bridge island from the
|
|
91
100
|
site context — `appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` and
|
|
92
|
-
`apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
101
|
+
`apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}` — and
|
|
102
|
+
`legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}`. The header's CTA
|
|
103
|
+
throws without `appOrigin`, consent is recorded through `apiOrigin` on every
|
|
104
|
+
page, and the footer's legal links throw without `legalNoticeOwed` (they add
|
|
105
|
+
the legal-notice link when the operator owes one). Never hardcode a host or
|
|
106
|
+
port: the site-context loader settles all three per build (see
|
|
107
|
+
`references/framework-site-context-loader-api.md`).
|
|
96
108
|
4. Select section categories based on the information journey: orientation,
|
|
97
109
|
proof, detail, objection handling and next action. Do not duplicate a
|
|
98
110
|
section solely to repeat copy.
|
|
@@ -102,7 +114,14 @@ each with the skill that authors it. The plan split the page into sections on pu
|
|
|
102
114
|
every locale pack the site publishes.
|
|
103
115
|
7. Choose any page-owned structured data based on actual content. Add one
|
|
104
116
|
concise canonical `llms.txt` entry that describes the page's purpose and
|
|
105
|
-
primary action rather than copying the whole page.
|
|
117
|
+
primary action rather than copying the whole page. The LANDING page's task
|
|
118
|
+
also owns the file's summary: replace the scaffold's summary line with one
|
|
119
|
+
sentence saying what the product is and who it is for, in the product's own
|
|
120
|
+
words, and replace (or delete) every other line carrying
|
|
121
|
+
`wildo:llms-txt-unauthored`. While any line carries it the site serves no
|
|
122
|
+
`llms.txt` at all, because the scaffold's placeholder is an instruction to
|
|
123
|
+
you, not a description of the product. Write only your own page's entry:
|
|
124
|
+
each page's task adds its own.
|
|
106
125
|
8. Run `wildo website audit`: it checks every locale pack against every page and
|
|
107
126
|
section the site declares (a missing key fails, exactly as `astro build` does)
|
|
108
127
|
and reconciles structured data against the application's Schema.org catalog.
|
|
@@ -531,6 +550,77 @@ function renderConsentSurface(
|
|
|
531
550
|
}
|
|
532
551
|
```
|
|
533
552
|
|
|
553
|
+
## Import Origins
|
|
554
|
+
|
|
555
|
+
- `@wildo-ai/saas-website`
|
|
556
|
+
|
|
557
|
+
## Source Excerpts
|
|
558
|
+
|
|
559
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
560
|
+
|
|
561
|
+
```tsx
|
|
562
|
+
*
|
|
563
|
+
* `WebsitePageSections` — renders a page's ordered sections list, each inside its `WebsiteSection`
|
|
564
|
+
* wrapper, and a visible PENDING marker while the list is still empty.
|
|
565
|
+
*
|
|
566
|
+
* A page component should render its sections through this rather than mapping the list by hand:
|
|
567
|
+
*
|
|
568
|
+
* ```tsx
|
|
569
|
+
* export function PricingPage(): ReactNode {
|
|
570
|
+
* return <WebsitePageSections pageRef="pricing" sections={PRICING_SECTIONS} />;
|
|
571
|
+
* }
|
|
572
|
+
* ```
|
|
573
|
+
*
|
|
574
|
+
* **Why the empty state is the point.** A page's sections list starts EMPTY when its page
|
|
575
|
+
* is authored before its sections — the application-creation build lane does exactly that, one task
|
|
576
|
+
* per page and one per section. An empty page is a valid manifest and a dev server serves it; the
|
|
577
|
+
* production build refuses it (`assertWebsitePagesHaveSections`). Mapped by hand, an empty list
|
|
578
|
+
* renders nothing at all, which is indistinguishable from a page that failed. This renders a
|
|
579
|
+
* marked block instead, so the page visibly says its sections are still to come.
|
|
580
|
+
*
|
|
581
|
+
* A section's `anchorId`, declared on its definition, becomes the wrapper's DOM `id`, so in-page links
|
|
582
|
+
* still have a target when no page places its sections by hand.
|
|
583
|
+
*
|
|
584
|
+
* **The marker carries identifiers, not prose.** It shows the page ref and the empty list as code,
|
|
585
|
+
* deliberately: words a person reads come from the label packs, and a label for a state no built
|
|
586
|
+
* page can ever reach (the build refuses an empty page) would be a key every locale must carry for
|
|
587
|
+
* nothing. A missing section must LOOK missing, which a raw identifier does.
|
|
588
|
+
*/
|
|
589
|
+
export interface WebsitePageSectionsProps {
|
|
590
|
+
/** The page's ref, as its manifest declares it. Shown in the pending marker. */
|
|
591
|
+
pageRef: string;
|
|
592
|
+
/** The page's ordered sections list — the same array its manifest's `sectionRefs` derive from. */
|
|
593
|
+
sections: readonly WebsiteSectionDefinition[];
|
|
594
|
+
}
|
|
595
|
+
|
|
596
|
+
export function WebsitePageSections({ pageRef, sections }: WebsitePageSectionsProps): ReactNode {
|
|
597
|
+
if (sections.length === 0) {
|
|
598
|
+
return (
|
|
599
|
+
<section
|
|
600
|
+
data-website-pending-page={pageRef}
|
|
601
|
+
aria-busy="true"
|
|
602
|
+
style={{ margin: '2rem auto', maxWidth: '48rem', padding: '2rem', border: '2px dashed currentColor', opacity: 0.6, textAlign: 'center' }}
|
|
603
|
+
>
|
|
604
|
+
<code>{`${pageRef}: sections = []`}</code>
|
|
605
|
+
</section>
|
|
606
|
+
);
|
|
607
|
+
}
|
|
608
|
+
return (
|
|
609
|
+
<>
|
|
610
|
+
{sections.map((section) => {
|
|
611
|
+
const SectionComponent = section.Component as React.ComponentType;
|
|
612
|
+
return (
|
|
613
|
+
<WebsiteSection key={String(section.sectionRef)} sectionRef={section.sectionRef} category={section.category} id={section.anchorId}>
|
|
614
|
+
<SectionComponent />
|
|
615
|
+
</WebsiteSection>
|
|
616
|
+
);
|
|
617
|
+
})}
|
|
618
|
+
</>
|
|
619
|
+
);
|
|
620
|
+
}
|
|
621
|
+
WebsitePageSections.displayName = 'WebsitePageSections';
|
|
622
|
+
```
|
|
623
|
+
|
|
534
624
|
These source-backed contracts are the page-manifest and structural composition
|
|
535
625
|
authority for the workflow below.
|
|
536
626
|
|
|
@@ -549,10 +639,12 @@ authority for the workflow below.
|
|
|
549
639
|
|---|---|
|
|
550
640
|
| Page has a manifest declaration | `rg -n "defineWebsitePageManifest" website/src/pages-impl/` (must include the new page) |
|
|
551
641
|
| Page is registered | `rg -n "_PAGE_MANIFEST" website/src/website-root.config.ts` (must include the new page) |
|
|
552
|
-
| Every route forwards both origins | `rg -
|
|
642
|
+
| Every route forwards both origins | `rg --files-without-match "apiOrigin=\{WEBSITE_SITE_CONTEXT" website/src/pages --glob '*.astro'` (must print nothing) |
|
|
553
643
|
| No hardcoded host in pages | `rg -n "localhost:[0-9]" website/src --glob "!**/generated/**"` (must print nothing; the generated CSP legitimately names the local backend) |
|
|
554
|
-
|
|
|
644
|
+
| Page renders through `WebsitePageSections` | `rg --files-without-match "WebsitePageSections" website/src/pages-impl --glob '*.page.tsx' --glob '!blog-post.page.tsx'` (must print nothing; a hand-written map renders an empty page blank. The blog post page renders one post, not a sections list) |
|
|
645
|
+
| Labels complete in every locale, no empty page | `wildo website audit` (exit 0; it fails a page with no section, which `astro build` refuses) |
|
|
555
646
|
| Discovery entry is deliberate | `rg -n "^## " website/src/content/llms.txt` (must include the page title where public) |
|
|
647
|
+
| Discovery summary is authored | `rg -n "wildo:llms-txt-unauthored" website/src/content/llms.txt` (must print nothing once the landing page is built; while it prints, `/llms.txt` is not served) |
|
|
556
648
|
|
|
557
649
|
## Common Rationalizations
|
|
558
650
|
|
package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md
CHANGED
|
@@ -69,6 +69,8 @@ import {
|
|
|
69
69
|
type WildoSaasConfig,
|
|
70
70
|
} from '@wildo-ai/platform-config-lib';
|
|
71
71
|
|
|
72
|
+
import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
|
|
73
|
+
|
|
72
74
|
import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
|
|
73
75
|
import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
|
|
74
76
|
import { loadWebsiteConfig, resolveStaticWebsiteServiceEntry } from './load-website-config';
|
|
@@ -159,6 +161,7 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
|
|
|
159
161
|
artifactPath: resolveFrontendServicesArtifactPath(resolvePath(saasRoot)),
|
|
160
162
|
serviceKey: websiteServiceKey,
|
|
161
163
|
}),
|
|
164
|
+
legalNoticeOwed: legalNoticeOwed(saasConfig.operatorComplianceIdentity) === true,
|
|
162
165
|
});
|
|
163
166
|
}
|
|
164
167
|
```
|
|
@@ -283,9 +283,14 @@ and confirm section consumers use the declared primitive seam.
|
|
|
283
283
|
|
|
284
284
|
| Invariant | Command |
|
|
285
285
|
|---|---|
|
|
286
|
-
| No clickable non-semantic primitive |
|
|
286
|
+
| No clickable non-semantic primitive | see the commands below the table (must be empty) |
|
|
287
287
|
| Link override preserves href | `rg -n "<a .*href=" website/src/components/` (review the matching link primitive) |
|
|
288
288
|
|
|
289
|
+
```bash
|
|
290
|
+
# No clickable non-semantic primitive — (must be empty)
|
|
291
|
+
rg -n "onClick=.*<div|<div.*onClick" website/src/components/
|
|
292
|
+
```
|
|
293
|
+
|
|
289
294
|
## Common Rationalizations
|
|
290
295
|
|
|
291
296
|
- “It looks identical in the screenshot.” Screenshots do not prove keyboard,
|
|
@@ -155,6 +155,14 @@ compile-time prop checking.
|
|
|
155
155
|
* and is caught by nothing until a reviewer reads the page. The
|
|
156
156
|
* build and `wildo website audit` check the pack against the
|
|
157
157
|
* DECLARED keys, so declare every slot the component reads.
|
|
158
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
159
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
160
|
+
* sections list through `WebsitePageSections`, which places every
|
|
161
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
162
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
163
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
164
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
165
|
+
* to keep, like the id attribute it becomes.
|
|
158
166
|
* - `Component` — the React component that renders the section. Typed
|
|
159
167
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
160
168
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
|
|
|
181
189
|
sectionRef: WebsiteSectionRefSchema,
|
|
182
190
|
category: WebsiteSectionCategorySchema,
|
|
183
191
|
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
192
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
193
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
194
|
+
}).optional(),
|
|
184
195
|
Component: z.unknown(),
|
|
185
196
|
getStructuredData: z.unknown().optional(),
|
|
186
197
|
});
|
|
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
269
280
|
sectionRef: WebsiteSectionRef | string;
|
|
270
281
|
category: WebsiteSectionCategory;
|
|
271
282
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
283
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
284
|
+
anchorId?: string;
|
|
272
285
|
Component: ComponentType<TProps>;
|
|
273
286
|
/**
|
|
274
287
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
351
364
|
sectionRef: input.sectionRef,
|
|
352
365
|
category: input.category,
|
|
353
366
|
expectedLabelKeys: input.expectedLabelKeys,
|
|
367
|
+
anchorId: input.anchorId,
|
|
354
368
|
Component: input.Component,
|
|
355
369
|
getStructuredData: input.getStructuredData,
|
|
356
370
|
});
|
|
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
363
377
|
sectionRef: parsed.sectionRef,
|
|
364
378
|
category: parsed.category,
|
|
365
379
|
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
380
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
366
381
|
Component: input.Component,
|
|
367
382
|
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
368
383
|
};
|