@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
|
@@ -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
|
};
|
|
@@ -708,12 +723,15 @@ catalog, and the page route renders it through
|
|
|
708
723
|
|
|
709
724
|
### Step 5: Compose into a page
|
|
710
725
|
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
the label-pack validator
|
|
726
|
+
Add the exported `HERO_SECTION` to the page's sections list
|
|
727
|
+
(`<PAGE>_SECTIONS` in `website/src/sections/<page>.sections.tsx`) at its
|
|
728
|
+
reading-order position, normally first. The page renders that list through
|
|
729
|
+
`<WebsitePageSections>`, which wraps each section in its `WebsiteSection` and
|
|
730
|
+
renders `Component` with NO props, and the manifest's `sectionRefs` derive from
|
|
731
|
+
the same list, so the label-pack validator audits it with no further edit.
|
|
732
|
+
A hero with a layout variant therefore binds the variant in its definition
|
|
733
|
+
(`Component: () => <HeroBody variant={HeroVariant.CENTERED} />`), never in the
|
|
734
|
+
page JSX.
|
|
717
735
|
|
|
718
736
|
**Finish** after the hero compiles and renders without TypeScript errors,
|
|
719
737
|
the page manifest includes the exported `HERO_SECTION`, and the homepage
|
|
@@ -908,7 +926,12 @@ a single block (last-wins).
|
|
|
908
926
|
| Invariant | Command |
|
|
909
927
|
|---|---|
|
|
910
928
|
| Hero emits structured data on the landing page | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 for landing-page hero) |
|
|
911
|
-
| Both `@type`s present |
|
|
929
|
+
| Both `@type`s present | see the commands below the table (must return ≥2) |
|
|
930
|
+
|
|
931
|
+
```bash
|
|
932
|
+
# Both `@type`s present
|
|
933
|
+
rg -n "'WebSite'|'Organization'" website/src/sections/<page>.sections.tsx
|
|
934
|
+
```
|
|
912
935
|
|
|
913
936
|
## References
|
|
914
937
|
|
|
@@ -929,9 +952,9 @@ a single block (last-wins).
|
|
|
929
952
|
`WebSite` / `Organization` (or omitted entirely).
|
|
930
953
|
- [ ] Layout / variant choices live on the component's prop interface,
|
|
931
954
|
NOT on the `WebsiteSectionDefinition`.
|
|
932
|
-
- [ ] The exported `HERO_SECTION` is
|
|
933
|
-
|
|
934
|
-
|
|
955
|
+
- [ ] The exported `HERO_SECTION` is an entry of the page's `<PAGE>_SECTIONS`
|
|
956
|
+
list, and the page renders that list through `<WebsitePageSections>`
|
|
957
|
+
rather than placing the hero in its JSX by hand.
|
|
935
958
|
|
|
936
959
|
### Grep invariants
|
|
937
960
|
|
|
@@ -141,6 +141,14 @@ compile-time prop checking.
|
|
|
141
141
|
* and is caught by nothing until a reviewer reads the page. The
|
|
142
142
|
* build and `wildo website audit` check the pack against the
|
|
143
143
|
* DECLARED keys, so declare every slot the component reads.
|
|
144
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
145
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
146
|
+
* sections list through `WebsitePageSections`, which places every
|
|
147
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
148
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
149
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
150
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
151
|
+
* to keep, like the id attribute it becomes.
|
|
144
152
|
* - `Component` — the React component that renders the section. Typed
|
|
145
153
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
146
154
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -167,6 +175,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
|
|
|
167
175
|
sectionRef: WebsiteSectionRefSchema,
|
|
168
176
|
category: WebsiteSectionCategorySchema,
|
|
169
177
|
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
178
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
179
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
180
|
+
}).optional(),
|
|
170
181
|
Component: z.unknown(),
|
|
171
182
|
getStructuredData: z.unknown().optional(),
|
|
172
183
|
});
|
|
@@ -255,6 +266,8 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
255
266
|
sectionRef: WebsiteSectionRef | string;
|
|
256
267
|
category: WebsiteSectionCategory;
|
|
257
268
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
269
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
270
|
+
anchorId?: string;
|
|
258
271
|
Component: ComponentType<TProps>;
|
|
259
272
|
/**
|
|
260
273
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
@@ -337,6 +350,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
337
350
|
sectionRef: input.sectionRef,
|
|
338
351
|
category: input.category,
|
|
339
352
|
expectedLabelKeys: input.expectedLabelKeys,
|
|
353
|
+
anchorId: input.anchorId,
|
|
340
354
|
Component: input.Component,
|
|
341
355
|
getStructuredData: input.getStructuredData,
|
|
342
356
|
});
|
|
@@ -349,6 +363,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
349
363
|
sectionRef: parsed.sectionRef,
|
|
350
364
|
category: parsed.category,
|
|
351
365
|
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
366
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
352
367
|
Component: input.Component,
|
|
353
368
|
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
354
369
|
};
|
|
@@ -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
|
};
|
|
@@ -908,11 +923,16 @@ warns on drift (warning-only per D-AG4).
|
|
|
908
923
|
|---|---|
|
|
909
924
|
| Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
|
|
910
925
|
| Plans read from the catalogue | `rg -n "useWebsitePricingCatalog" website/src/sections/<page>.sections.tsx` (must return ≥1) |
|
|
911
|
-
| No typed price in the website |
|
|
926
|
+
| No typed price in the website | see the commands below the table (must return 0) |
|
|
912
927
|
| Catalogue passed to the island | `rg -n "pricingCatalog=" website/src/pages/pricing.astro` (must return ≥1) |
|
|
913
928
|
| Offers derived | `rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/page-payloads.ts` (must return ≥1) |
|
|
914
929
|
| Audit passes | `wildo website audit --strict` (no finding for the pricing page) |
|
|
915
930
|
|
|
931
|
+
```bash
|
|
932
|
+
# No typed price in the website — (must return 0)
|
|
933
|
+
rg -n "priceCurrency|amountMonthly|monthlyPrice" website/src/sections website/src/pages-impl
|
|
934
|
+
```
|
|
935
|
+
|
|
916
936
|
## Common Rationalizations
|
|
917
937
|
|
|
918
938
|
| Rationalization | Reality |
|
package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md
CHANGED
|
@@ -137,6 +137,14 @@ compile-time prop checking.
|
|
|
137
137
|
* and is caught by nothing until a reviewer reads the page. The
|
|
138
138
|
* build and `wildo website audit` check the pack against the
|
|
139
139
|
* DECLARED keys, so declare every slot the component reads.
|
|
140
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
141
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
142
|
+
* sections list through `WebsitePageSections`, which places every
|
|
143
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
144
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
145
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
146
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
147
|
+
* to keep, like the id attribute it becomes.
|
|
140
148
|
* - `Component` — the React component that renders the section. Typed
|
|
141
149
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
142
150
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
|
|
|
163
171
|
sectionRef: WebsiteSectionRefSchema,
|
|
164
172
|
category: WebsiteSectionCategorySchema,
|
|
165
173
|
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
174
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
175
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
176
|
+
}).optional(),
|
|
166
177
|
Component: z.unknown(),
|
|
167
178
|
getStructuredData: z.unknown().optional(),
|
|
168
179
|
});
|
|
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
251
262
|
sectionRef: WebsiteSectionRef | string;
|
|
252
263
|
category: WebsiteSectionCategory;
|
|
253
264
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
265
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
266
|
+
anchorId?: string;
|
|
254
267
|
Component: ComponentType<TProps>;
|
|
255
268
|
/**
|
|
256
269
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
333
346
|
sectionRef: input.sectionRef,
|
|
334
347
|
category: input.category,
|
|
335
348
|
expectedLabelKeys: input.expectedLabelKeys,
|
|
349
|
+
anchorId: input.anchorId,
|
|
336
350
|
Component: input.Component,
|
|
337
351
|
getStructuredData: input.getStructuredData,
|
|
338
352
|
});
|
|
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
345
359
|
sectionRef: parsed.sectionRef,
|
|
346
360
|
category: parsed.category,
|
|
347
361
|
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
362
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
348
363
|
Component: input.Component,
|
|
349
364
|
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
350
365
|
};
|
|
@@ -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
|
};
|
|
@@ -862,7 +877,12 @@ D-AG4).
|
|
|
862
877
|
| Invariant | Command |
|
|
863
878
|
|---|---|
|
|
864
879
|
| Section emits structured data | `rg -n "getStructuredData" website/src/sections/<page>.sections.tsx` (must return ≥1 when testimonials are rendered) |
|
|
865
|
-
| Both `@type`s present |
|
|
880
|
+
| Both `@type`s present | see the commands below the table (must return ≥2) |
|
|
881
|
+
|
|
882
|
+
```bash
|
|
883
|
+
# Both `@type`s present
|
|
884
|
+
rg -n "'Review'|'AggregateRating'" website/src/sections/<page>.sections.tsx
|
|
885
|
+
```
|
|
866
886
|
|
|
867
887
|
## References
|
|
868
888
|
|
|
@@ -886,9 +906,14 @@ D-AG4).
|
|
|
886
906
|
|---|---|
|
|
887
907
|
| Factory used | `rg -n "defineWebsiteSection<?" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
|
|
888
908
|
| Section's payloads are its own, and valid | This section's `getStructuredData` returns `Review` / `AggregateRating` (wrapping `Product` / `Organization` / `SoftwareApplication` only as `itemReviewed`); `wildo website audit` reports no finding for the page |
|
|
889
|
-
| Image alt declared |
|
|
909
|
+
| Image alt declared | see the commands below the table (every `WebsiteImage` must have alt) |
|
|
890
910
|
| Rating counts derived (no hardcoded `reviewCount`) | `rg -n "reviewCount: \\d+" website/src/sections/<page>.sections.tsx` (must return empty — `reviewCount` should always be `TESTIMONIALS.length`) |
|
|
891
911
|
|
|
912
|
+
```bash
|
|
913
|
+
# Image alt declared
|
|
914
|
+
rg -n "WebsiteImage" -A 2 website/src/sections/<page>.sections.tsx | rg -n "alt="
|
|
915
|
+
```
|
|
916
|
+
|
|
892
917
|
## Common Rationalizations
|
|
893
918
|
|
|
894
919
|
| Rationalization | Reality |
|
package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md
CHANGED
|
@@ -137,6 +137,14 @@ compile-time prop checking.
|
|
|
137
137
|
* and is caught by nothing until a reviewer reads the page. The
|
|
138
138
|
* build and `wildo website audit` check the pack against the
|
|
139
139
|
* DECLARED keys, so declare every slot the component reads.
|
|
140
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
141
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
142
|
+
* sections list through `WebsitePageSections`, which places every
|
|
143
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
144
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
145
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
146
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
147
|
+
* to keep, like the id attribute it becomes.
|
|
140
148
|
* - `Component` — the React component that renders the section. Typed
|
|
141
149
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
142
150
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
|
|
|
163
171
|
sectionRef: WebsiteSectionRefSchema,
|
|
164
172
|
category: WebsiteSectionCategorySchema,
|
|
165
173
|
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
174
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
175
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
176
|
+
}).optional(),
|
|
166
177
|
Component: z.unknown(),
|
|
167
178
|
getStructuredData: z.unknown().optional(),
|
|
168
179
|
});
|
|
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
|
|
|
251
262
|
sectionRef: WebsiteSectionRef | string;
|
|
252
263
|
category: WebsiteSectionCategory;
|
|
253
264
|
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
265
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
266
|
+
anchorId?: string;
|
|
254
267
|
Component: ComponentType<TProps>;
|
|
255
268
|
/**
|
|
256
269
|
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
333
346
|
sectionRef: input.sectionRef,
|
|
334
347
|
category: input.category,
|
|
335
348
|
expectedLabelKeys: input.expectedLabelKeys,
|
|
349
|
+
anchorId: input.anchorId,
|
|
336
350
|
Component: input.Component,
|
|
337
351
|
getStructuredData: input.getStructuredData,
|
|
338
352
|
});
|
|
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
|
|
|
345
359
|
sectionRef: parsed.sectionRef,
|
|
346
360
|
category: parsed.category,
|
|
347
361
|
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
362
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
348
363
|
Component: input.Component,
|
|
349
364
|
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
350
365
|
};
|
|
@@ -267,7 +267,11 @@ export const GET: APIRoute = () => {
|
|
|
267
267
|
|
|
268
268
|
- omitted / `{}` — auto-publish when the file exists;
|
|
269
269
|
- `{ enabled: true }` — publish if present, otherwise 404;
|
|
270
|
-
- `{ enabled: false }` — always disable publication
|
|
270
|
+
- `{ enabled: false }` — always disable publication;
|
|
271
|
+
- in every case, a file still carrying `wildo:llms-txt-unauthored` (the scaffold's marker on each
|
|
272
|
+
placeholder line, `LLMS_TXT_UNAUTHORED_MARKER`) is not published until every placeholder line is
|
|
273
|
+
replaced. Return `new Response(null, { status: 404 })`, never a text body: a prerendered route
|
|
274
|
+
writes any body to the build, and it would be served with 200.
|
|
271
275
|
|
|
272
276
|
### Step 5: Wire the `robots.txt` endpoint
|
|
273
277
|
|
|
@@ -565,9 +569,17 @@ crawlers:
|
|
|
565
569
|
| `llms.txt` endpoint in place | `rg -n "readLlmsTxtBody" website/src/pages/llms.txt.ts` (exactly 1 match) |
|
|
566
570
|
| Robots endpoint in place | `rg -n "renderRobotsTxt" website/src/pages/robots.txt.ts` (exactly 1 match) |
|
|
567
571
|
| Page shells use structured-data renderer | `rg -n "renderPageStructuredData" website/src/pages/**/*.astro website/src/pages/*.astro` (must return the static pages that emit JSON-LD) |
|
|
568
|
-
| No hand-rolled robots.txt static |
|
|
569
|
-
| No hand-rolled sitemap static |
|
|
570
|
-
| Head renderer used in every page shell | `rg -
|
|
572
|
+
| No hand-rolled robots.txt static | see the commands below the table (must return empty — the endpoint owns it) |
|
|
573
|
+
| No hand-rolled sitemap static | see the commands below the table (must return empty — the integration owns it) |
|
|
574
|
+
| Head renderer used in every page shell | `rg --files-without-match "renderWebsitePageHeadHtml" website/src/pages/*.astro` (each page shell must match — exclude `[slug].astro` blog shells which use `renderBlogPostHeadHtml`) |
|
|
575
|
+
|
|
576
|
+
```bash
|
|
577
|
+
# No hand-rolled robots.txt static
|
|
578
|
+
ls website/public/ | rg "^robots\.txt$"
|
|
579
|
+
|
|
580
|
+
# No hand-rolled sitemap static
|
|
581
|
+
ls website/public/ | rg "^sitemap.*\.xml$"
|
|
582
|
+
```
|
|
571
583
|
|
|
572
584
|
## Common Rationalizations
|
|
573
585
|
|
|
@@ -58,6 +58,14 @@ the claim while still letting the framework collect/dedupe it centrally.
|
|
|
58
58
|
* and is caught by nothing until a reviewer reads the page. The
|
|
59
59
|
* build and `wildo website audit` check the pack against the
|
|
60
60
|
* DECLARED keys, so declare every slot the component reads.
|
|
61
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
62
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
63
|
+
* sections list through `WebsitePageSections`, which places every
|
|
64
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
65
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
66
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
67
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
68
|
+
* to keep, like the id attribute it becomes.
|
|
61
69
|
* - `Component` — the React component that renders the section. Typed
|
|
62
70
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
63
71
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -84,6 +92,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
|
|
|
84
92
|
sectionRef: WebsiteSectionRefSchema,
|
|
85
93
|
category: WebsiteSectionCategorySchema,
|
|
86
94
|
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
95
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
96
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
97
|
+
}).optional(),
|
|
87
98
|
Component: z.unknown(),
|
|
88
99
|
getStructuredData: z.unknown().optional(),
|
|
89
100
|
});
|
|
@@ -80,6 +80,8 @@ file.
|
|
|
80
80
|
* - `false` → suppress publication even if the file exists
|
|
81
81
|
* - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the
|
|
82
82
|
* file exists, returns `null` when absent)
|
|
83
|
+
* - never while the file still carries `LLMS_TXT_UNAUTHORED_MARKER`,
|
|
84
|
+
* the scaffold's placeholder marker, whatever `enabled` says
|
|
83
85
|
*
|
|
84
86
|
* Keeping the "auto-detect when undefined" convention in the HELPER
|
|
85
87
|
* (not as a schema default) is deliberate: schema defaults are static,
|
|
@@ -111,6 +113,15 @@ the config block is omitted.
|
|
|
111
113
|
|
|
112
114
|
```typescript
|
|
113
115
|
*
|
|
116
|
+
* The marker the scaffold puts on every PLACEHOLDER line of `llms.txt` (the summary, the generic
|
|
117
|
+
* landing entry, the generic topic). A file still carrying it holds the template's instruction to a
|
|
118
|
+
* developer, not a description of the product, so it is never served: an AI assistant quoting it would
|
|
119
|
+
* repeat "Replace this line" as the product's summary. The marker sits on the line it guards, so
|
|
120
|
+
* replacing the line removes it, and a file is served once no placeholder is left.
|
|
121
|
+
*/
|
|
122
|
+
export const LLMS_TXT_UNAUTHORED_MARKER = 'wildo:llms-txt-unauthored';
|
|
123
|
+
|
|
124
|
+
/**
|
|
114
125
|
* Read the hand-authored `llms.txt` body for the marketing site.
|
|
115
126
|
*
|
|
116
127
|
* Publication policy:
|
|
@@ -118,6 +129,9 @@ the config block is omitted.
|
|
|
118
129
|
* - `seo.llmsTxt?.enabled === true` → read the file if present, else `null`
|
|
119
130
|
* - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
|
|
120
131
|
* publish when the file exists, otherwise return `null`
|
|
132
|
+
* - in every case, a file still carrying {@link LLMS_TXT_UNAUTHORED_MARKER} → `null`. A route returns
|
|
133
|
+
* `new Response(null, { status: 404 })` for `null`: a prerendered route writes any non-null body
|
|
134
|
+
* to the build output, so a text body would be served as the file with status 200
|
|
121
135
|
*/
|
|
122
136
|
export function readLlmsTxtBody(
|
|
123
137
|
siteContext: WebsiteSiteContext,
|
|
@@ -135,7 +149,8 @@ export function readLlmsTxtBody(
|
|
|
135
149
|
}
|
|
136
150
|
|
|
137
151
|
try {
|
|
138
|
-
|
|
152
|
+
const body = readFileSync(filePath, 'utf-8');
|
|
153
|
+
return body.includes(LLMS_TXT_UNAUTHORED_MARKER) ? null : body;
|
|
139
154
|
} catch (cause) {
|
|
140
155
|
throw new Error(
|
|
141
156
|
`[llms-txt-server] Could not read llms.txt at ${filePath}. ` +
|
|
@@ -77,7 +77,8 @@ preview branding).
|
|
|
77
77
|
* mechanic: omitting the block means "auto-detect from file
|
|
78
78
|
* presence" rather than "use a static schema default". The helper
|
|
79
79
|
* `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`
|
|
80
|
-
* exists and
|
|
80
|
+
* exists and carries no `LLMS_TXT_UNAUTHORED_MARKER`, and returns
|
|
81
|
+
* `null` otherwise.
|
|
81
82
|
*
|
|
82
83
|
* **Validation**:
|
|
83
84
|
* - `siteName` is `z.string().min(1)` — empty strings would emit
|