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