@wildo-ai/framework-knowledge 1.1.0
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/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,624 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-seo-aeo-geo
|
|
3
|
+
description: Configure the marketing site's SEO, AEO, and GEO surface — site-wide branding (`WebsiteSeoConfig.siteName` / `defaultOgImageUrl`), per-page `<head>` emission via `renderWebsitePageHeadHtml`, section-driven JSON-LD via `getStructuredData()` + `renderPageStructuredData`, sitemap generation via the `@astrojs/sitemap` integration paired with `enumerateMarketingPageSitemapUrls`, `robots.txt` policy via `WebsiteRobotsConfig` + `renderRobotsTxt`, per-page AI-training opt-out via `WebsitePageManifest.seo.noaiOptOut`, and hand-authored `llms.txt` publication via `WebsiteSeoConfig.llmsTxt` + `readLlmsTxtBody`. Use when the user says "configure SEO", "wire the sitemap", "add structured data", "ship llms.txt", "configure AI-crawler policy", "audit our SEO posture", or "ship per-page meta tags".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website SEO / AEO / GEO
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package
|
|
21
|
+
> ships every SEO surface as a **pure string builder** invoked from a
|
|
22
|
+
> thin Astro shell. Six helpers drive the surface today:
|
|
23
|
+
>
|
|
24
|
+
> 1. `renderWebsitePageHeadHtml(opts)` — per-page `<head>` block
|
|
25
|
+
> (`<title>`, full OG card, Twitter card mirrors, canonical,
|
|
26
|
+
> one `hreflang` `<link>` per declared locale + `x-default`,
|
|
27
|
+
> plus `noai` meta when the manifest opts out).
|
|
28
|
+
> 2. `renderPageStructuredData(...)` — page-level JSON-LD collector
|
|
29
|
+
> that gathers section `getStructuredData()` payloads into one
|
|
30
|
+
> page-level HTML fragment (one JSON-LD `<script>` per surviving
|
|
31
|
+
> payload).
|
|
32
|
+
> 3. `renderRobotsTxt(siteContext)` — site-wide `robots.txt` body
|
|
33
|
+
> driven by `WebsiteRootConfig.seo.robots`.
|
|
34
|
+
> 4. `enumerateMarketingPageSitemapUrls(siteContext)` — testable
|
|
35
|
+
> enumeration of every (page × locale) URL the site exposes;
|
|
36
|
+
> vitest enforces coverage at unit-test time and consumers can
|
|
37
|
+
> spread it into `@astrojs/sitemap`'s `customPages` for any
|
|
38
|
+
> route synthesized outside the file-based router.
|
|
39
|
+
> 5. `readLlmsTxtBody(siteContext)` — hand-authored `llms.txt`
|
|
40
|
+
> publication helper honoring `seo.llmsTxt.enabled`.
|
|
41
|
+
> 6. `renderWebsitePageNoaiHeaders(siteContext)` — `_headers`
|
|
42
|
+
> companion output for static hosts that need `X-Robots-Tag:
|
|
43
|
+
> noai, noimageai` outside the HTML document.
|
|
44
|
+
>
|
|
45
|
+
> The framework owns the SCHEMA (`WebsiteSeoConfig`,
|
|
46
|
+
> `WebsiteSitemapConfig`, `WebsiteRobotsConfig`) so config + enforcement
|
|
47
|
+
> stay in lock-step with the page registry. Sitemap **emission** is
|
|
48
|
+
> delegated to `@astrojs/sitemap` (the official Astro plugin) — it
|
|
49
|
+
> already covers per-page `lastmod` / `changefreq` / `priority` +
|
|
50
|
+
> `xhtml:link hreflang` annotations and re-implementing it inside
|
|
51
|
+
> the engine would duplicate well-trodden tooling for zero added
|
|
52
|
+
> value.
|
|
53
|
+
|
|
54
|
+
## Overview
|
|
55
|
+
|
|
56
|
+
The marketing site's SEO surface is composed of THREE concentric
|
|
57
|
+
layers:
|
|
58
|
+
|
|
59
|
+
1. **Site-level config** (`WebsiteRootConfig.seo`) — branding
|
|
60
|
+
(`siteName`, `defaultOgImageUrl`), sitemap policy
|
|
61
|
+
(`sitemap?.enabled` / `changefreq` / `priority`), and `robots.txt`
|
|
62
|
+
policy (`robots?.policy` / `disallow[]` / `allowedCrawlers[]` /
|
|
63
|
+
`disallowedCrawlers[]`).
|
|
64
|
+
2. **Per-page `<head>`** — the consumer's per-page `.astro` shell calls
|
|
65
|
+
`renderWebsitePageHeadHtml(...)` and injects the returned string
|
|
66
|
+
via `<Fragment set:html={...} />`. The renderer composes its
|
|
67
|
+
output from the page manifest's `metaLabelKeys` (so per-page title /
|
|
68
|
+
description / OG image are localized through the same label-pack
|
|
69
|
+
surface every section uses) plus the site context's `publicOrigin`
|
|
70
|
+
and locale set.
|
|
71
|
+
3. **AEO/GEO artefacts** — section-authored JSON-LD collected via
|
|
72
|
+
`renderPageStructuredData(...)`, hand-authored `llms.txt`, and
|
|
73
|
+
per-page `noai` / `X-Robots-Tag` emission for AI-training opt-out.
|
|
74
|
+
4. **Site-wide artefacts** — `sitemap-index.xml` (emitted by
|
|
75
|
+
`@astrojs/sitemap` at build time) and `robots.txt` (emitted by a
|
|
76
|
+
thin `src/pages/robots.txt.ts` Astro endpoint that calls
|
|
77
|
+
`renderRobotsTxt`).
|
|
78
|
+
|
|
79
|
+
**Single source of truth** for the public origin: every absolute URL
|
|
80
|
+
(canonical, hreflang, OG `og:url`, sitemap `<loc>`, `Sitemap:` footer
|
|
81
|
+
in `robots.txt`) is composed from `WildoMarketingWebsiteConfig.publicOrigin`.
|
|
82
|
+
The per-service `wildo.website.config.ts` is the SINGLE source for
|
|
83
|
+
"what's the origin this site is reachable at" — the seam-collapse
|
|
84
|
+
removed the old duplicate on `WebsiteRootConfig.seo.siteOrigin`.
|
|
85
|
+
|
|
86
|
+
## App Paths
|
|
87
|
+
|
|
88
|
+
The installed `@wildo-ai/saas-website` package provides the contract. SEO authoring touches
|
|
89
|
+
the consumer's website module at these paths:
|
|
90
|
+
|
|
91
|
+
| Surface | Glob (relative to app root) |
|
|
92
|
+
|---|---|
|
|
93
|
+
| Site-level SEO config (branding + sitemap + robots policy) | `website/src/website-root.config.ts` (`seo` block) |
|
|
94
|
+
| Public origin (single source of truth) | `website/src/wildo.website.config.ts` (`publicOrigin`) |
|
|
95
|
+
| Per-page `<head>` injection | `website/src/pages/<page>.astro` (each shell calls `renderWebsitePageHeadHtml(...)`) |
|
|
96
|
+
| Per-page JSON-LD injection | `website/src/pages/<page>.astro` (each shell calls `renderPageStructuredData(...)`) |
|
|
97
|
+
| Per-page meta-label keys | `website/src/i18n/<locale>.json` (per `metaLabelKeys.titleKey` + `descriptionKey` declared on each page manifest) |
|
|
98
|
+
| Hand-authored GEO manifest | `website/src/content/llms.txt` |
|
|
99
|
+
| `llms.txt` endpoint | `website/src/pages/llms.txt.ts` (thin shim around `readLlmsTxtBody`) |
|
|
100
|
+
| `@astrojs/sitemap` integration | `website/astro.config.ts` (registers the integration with `i18n` populated from `WEBSITE_SITE_CONTEXT`) |
|
|
101
|
+
| `robots.txt` endpoint | `website/src/pages/robots.txt.ts` (3-line shim that returns `renderRobotsTxt(WEBSITE_SITE_CONTEXT)`) |
|
|
102
|
+
|
|
103
|
+
## When to Use
|
|
104
|
+
|
|
105
|
+
- A new marketing site needs its baseline SEO surface (head meta,
|
|
106
|
+
sitemap, robots) wired before it goes live.
|
|
107
|
+
- The site needs a per-environment robots policy (e.g. `noindex` on
|
|
108
|
+
staging) without touching the page-shell code.
|
|
109
|
+
- The site needs to allow / deny specific AI crawlers (`GPTBot`,
|
|
110
|
+
`ClaudeBot`, `Google-Extended`, …) — the `allowedCrawlers` /
|
|
111
|
+
`disallowedCrawlers` knobs on `WebsiteRobotsConfig` are the
|
|
112
|
+
current foothold for GEO policy.
|
|
113
|
+
- The site needs section-driven structured data for answer engines
|
|
114
|
+
(`FAQPage`, `Product`, `Review`, `Organization`, `WebSite`, ...).
|
|
115
|
+
- The site wants a crawler-facing discovery manifest via `llms.txt`.
|
|
116
|
+
- A specific page must opt out of AI-training crawlers while the rest of
|
|
117
|
+
the site remains discoverable.
|
|
118
|
+
- A new page is added and the developer wants to verify it lands in
|
|
119
|
+
the sitemap (the `enumerateMarketingPageSitemapUrls` helper is the
|
|
120
|
+
test seam).
|
|
121
|
+
|
|
122
|
+
## When NOT to Use
|
|
123
|
+
|
|
124
|
+
- **Sitemap re-implementation** — `@astrojs/sitemap` already covers
|
|
125
|
+
per-page `lastmod` / `changefreq` / `priority` + `xhtml:link
|
|
126
|
+
hreflang` annotations. Do NOT hand-roll a sitemap renderer; use
|
|
127
|
+
the plugin and feed it via `customPages` if you need to register
|
|
128
|
+
routes synthesized outside Astro's file-based router (use
|
|
129
|
+
`enumerateMarketingPageSitemapUrls` to compute the list).
|
|
130
|
+
- **Automated `llms.txt` generation from labels or section trees** —
|
|
131
|
+
the file is deliberately hand-authored. The framework only serves it.
|
|
132
|
+
- **Per-locale `llms.txt` variants** — v1 publishes a single canonical
|
|
133
|
+
file, not one file per locale.
|
|
134
|
+
|
|
135
|
+
## Workflow
|
|
136
|
+
|
|
137
|
+
### Step 1: Author the site-level `seo` block (branding + policy)
|
|
138
|
+
|
|
139
|
+
In `website/src/website-root.config.ts`, populate the `seo` block on
|
|
140
|
+
`WEBSITE_ROOT_CONFIG`:
|
|
141
|
+
|
|
142
|
+
- `siteName` — REQUIRED, non-empty. Renders into `og:site_name` (the
|
|
143
|
+
brand label social platforms show above the page title).
|
|
144
|
+
- `defaultOgImageUrl` — OPTIONAL. Per-page hero image fallback.
|
|
145
|
+
Pages declare their own via `metaLabelKeys.ogImageUrl`; this is
|
|
146
|
+
the site-wide default for pages that did not commit to one.
|
|
147
|
+
- `sitemap` — OPTIONAL block. Omitting it is equivalent to
|
|
148
|
+
`{ enabled: true }` (the marketing-site default). Set
|
|
149
|
+
`enabled: false` to suppress sitemap emission entirely (e.g.
|
|
150
|
+
staging surface routed under a `noindex` policy).
|
|
151
|
+
- `robots` — OPTIONAL block. Omitting it is equivalent to
|
|
152
|
+
`{ policy: 'index' }`. Author it explicitly when the site needs
|
|
153
|
+
any of: a `noindex` policy, per-path `disallow[]` entries (e.g.
|
|
154
|
+
`/internal/`), or AI-crawler allow/deny lists.
|
|
155
|
+
|
|
156
|
+
The `publicOrigin` (used to compose every absolute URL the SEO
|
|
157
|
+
surface emits) is REQUIRED on `WildoMarketingWebsiteConfig` — it
|
|
158
|
+
lives in `wildo.website.config.ts`, NOT the root config.
|
|
159
|
+
|
|
160
|
+
### Step 2: Wire `renderWebsitePageHeadHtml` in every page shell
|
|
161
|
+
|
|
162
|
+
Each `website/src/pages/<page>.astro` (or `[slug].astro`) shell:
|
|
163
|
+
|
|
164
|
+
1. Calls `loadWebsitePageRuntime({ manifest, siteContext, ... })` to
|
|
165
|
+
resolve the per-locale label pack.
|
|
166
|
+
2. Calls `renderWebsitePageHeadHtml({ manifest, siteContext, locale,
|
|
167
|
+
labelPack })` to compose the `<head>` block.
|
|
168
|
+
3. Injects the returned string via `<Fragment set:html={headHtml} />`.
|
|
169
|
+
|
|
170
|
+
Per-page meta-label keys (`titleKey`, `descriptionKey`, optional
|
|
171
|
+
`ogImageUrl`) are declared on the page manifest and resolved against
|
|
172
|
+
the per-locale label pack at render time. The label-pack validator
|
|
173
|
+
fails the build if any locale is missing one of the declared keys.
|
|
174
|
+
|
|
175
|
+
### Step 2b: Collect section JSON-LD with `renderPageStructuredData`
|
|
176
|
+
|
|
177
|
+
For each static page shell, resolve the concrete sections referenced by
|
|
178
|
+
the manifest and pass them to `renderPageStructuredData(...)`.
|
|
179
|
+
|
|
180
|
+
1. Keep JSON-LD authoring in the section definitions via
|
|
181
|
+
`getStructuredData()`.
|
|
182
|
+
2. Call `renderPageStructuredData({ sections })` from the page shell.
|
|
183
|
+
Use `pagePayloads` only for page-owned entities such as blog-post
|
|
184
|
+
`BlogPosting` payloads or breadcrumbs.
|
|
185
|
+
3. Inject the returned string via `<Fragment set:html={structuredDataHtml} />`.
|
|
186
|
+
|
|
187
|
+
The page shell owns collection and placement; section definitions own
|
|
188
|
+
the actual entity payloads.
|
|
189
|
+
|
|
190
|
+
### Step 2c: Use `WebsitePageManifest.seo.noaiOptOut` deliberately
|
|
191
|
+
|
|
192
|
+
When one page should remain indexable in normal search but should opt
|
|
193
|
+
out of AI training crawlers, set:
|
|
194
|
+
|
|
195
|
+
```ts
|
|
196
|
+
seo: {
|
|
197
|
+
noaiOptOut: true,
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
on that page's manifest. The framework emits both the in-document
|
|
202
|
+
`<meta name="robots" content="noai, noimageai">` tag and exposes the
|
|
203
|
+
static-host `_headers` helper from the same boolean so the two channels
|
|
204
|
+
share one source of truth once the consumer wires `_headers`
|
|
205
|
+
generation.
|
|
206
|
+
|
|
207
|
+
### Step 3: Wire `@astrojs/sitemap`
|
|
208
|
+
|
|
209
|
+
In `website/astro.config.ts`:
|
|
210
|
+
|
|
211
|
+
1. Add `@astrojs/sitemap` as a dev dependency (the engine declares it
|
|
212
|
+
as an optional peer dep).
|
|
213
|
+
2. Set `site: WEBSITE_SITE_CONTEXT.websiteConfig.publicOrigin` on
|
|
214
|
+
`defineConfig({...})` — the integration uses this to compose every
|
|
215
|
+
`<loc>` entry; without it, the plugin throws at build time.
|
|
216
|
+
3. Construct the `i18n` option from
|
|
217
|
+
`WEBSITE_SITE_CONTEXT.websiteConfig.{defaultLocale, locales}`:
|
|
218
|
+
|
|
219
|
+
```ts
|
|
220
|
+
const sitemapI18n = {
|
|
221
|
+
defaultLocale: WEBSITE_SITE_CONTEXT.websiteConfig.defaultLocale,
|
|
222
|
+
locales: Object.fromEntries(
|
|
223
|
+
WEBSITE_SITE_CONTEXT.websiteConfig.locales.map((l) => [l, l]),
|
|
224
|
+
),
|
|
225
|
+
};
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
This shape (`{ defaultLocale, locales: { <key>: <bcp47> } }`) is
|
|
229
|
+
what the plugin expects — passing the framework's array directly
|
|
230
|
+
would silently fall back to no-i18n emission.
|
|
231
|
+
4. Register `sitemap({ i18n: sitemapI18n })` in `integrations`.
|
|
232
|
+
|
|
233
|
+
`@astrojs/sitemap` auto-discovers every page Astro emits at build
|
|
234
|
+
time — the framework does not need a separate registration step for
|
|
235
|
+
the dominant case. For routes synthesized outside the file-based
|
|
236
|
+
router, pass them via the plugin's `customPages` option (compute the
|
|
237
|
+
list with `enumerateMarketingPageSitemapUrls(siteContext)`).
|
|
238
|
+
|
|
239
|
+
### Step 4: Publish `llms.txt`
|
|
240
|
+
|
|
241
|
+
Author a single hand-maintained file at `website/src/content/llms.txt`
|
|
242
|
+
and expose it through a thin Astro endpoint:
|
|
243
|
+
|
|
244
|
+
```ts
|
|
245
|
+
import type { APIRoute } from 'astro';
|
|
246
|
+
import { readLlmsTxtBody } from '@wildo-ai/saas-website/astro';
|
|
247
|
+
|
|
248
|
+
import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
249
|
+
|
|
250
|
+
export const prerender = true;
|
|
251
|
+
|
|
252
|
+
export const GET: APIRoute = () => {
|
|
253
|
+
const body = readLlmsTxtBody(WEBSITE_SITE_CONTEXT);
|
|
254
|
+
return body === null
|
|
255
|
+
? new Response(null, { status: 404 })
|
|
256
|
+
: new Response(body, {
|
|
257
|
+
headers: {
|
|
258
|
+
'Content-Type': 'text/plain; charset=utf-8',
|
|
259
|
+
'Cache-Control': 'public, max-age=3600',
|
|
260
|
+
},
|
|
261
|
+
});
|
|
262
|
+
};
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
`WebsiteRootConfig.seo.llmsTxt` controls publication policy:
|
|
266
|
+
|
|
267
|
+
- omitted / `{}` — auto-publish when the file exists;
|
|
268
|
+
- `{ enabled: true }` — publish if present, otherwise 404;
|
|
269
|
+
- `{ enabled: false }` — always disable publication.
|
|
270
|
+
|
|
271
|
+
### Step 5: Wire the `robots.txt` endpoint
|
|
272
|
+
|
|
273
|
+
Author `website/src/pages/robots.txt.ts` as a 3-line shim:
|
|
274
|
+
|
|
275
|
+
```ts
|
|
276
|
+
import type { APIRoute } from 'astro';
|
|
277
|
+
import { renderRobotsTxt } from '@wildo-ai/saas-website/astro';
|
|
278
|
+
|
|
279
|
+
import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
280
|
+
|
|
281
|
+
export const prerender = true;
|
|
282
|
+
|
|
283
|
+
export const GET: APIRoute = () =>
|
|
284
|
+
new Response(renderRobotsTxt(WEBSITE_SITE_CONTEXT), {
|
|
285
|
+
headers: {
|
|
286
|
+
'Content-Type': 'text/plain; charset=utf-8',
|
|
287
|
+
'Cache-Control': 'public, max-age=3600',
|
|
288
|
+
},
|
|
289
|
+
});
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
`prerender = true` produces a static `robots.txt` at build time
|
|
293
|
+
(matches the rest of the site's static-build posture). Drop the
|
|
294
|
+
flag if you need request-time evaluation (e.g. a per-environment
|
|
295
|
+
secret-keyed bypass).
|
|
296
|
+
|
|
297
|
+
### Step 6: (optional) Lock the sitemap-coverage contract in vitest
|
|
298
|
+
|
|
299
|
+
`enumerateMarketingPageSitemapUrls(WEBSITE_SITE_CONTEXT)` returns
|
|
300
|
+
every (page × locale) URL the framework EXPECTS to land in the
|
|
301
|
+
sitemap. Asserting the size + content of that set in vitest catches:
|
|
302
|
+
|
|
303
|
+
- a manifest registered without a corresponding label-pack key (the
|
|
304
|
+
page would 404 or render with raw keys);
|
|
305
|
+
- a locale dropped from the routing surface without scrubbing the
|
|
306
|
+
sitemap expectations;
|
|
307
|
+
- a route-path collision the page-manifest schema's `superRefine`
|
|
308
|
+
did not catch.
|
|
309
|
+
|
|
310
|
+
This unit-level enforcement runs in seconds — no `astro build`
|
|
311
|
+
needed. Pair it with snapshot tests against the helper's hreflang
|
|
312
|
+
output if you want to lock alternate-URL composition too.
|
|
313
|
+
|
|
314
|
+
## Worked Example
|
|
315
|
+
|
|
316
|
+
<!-- TIER C WAIVER: This block IS the canonical sitemap+robots wiring — it shows the full Astro config integration (with the i18n adapter shape converting the framework's locale array into the plugin's BCP-47-keyed object), the `seo` block authoring (sitemap + robots policy at the call site, even when defaults suffice), and the 3-line `robots.txt.ts` endpoint. The `pages/robots.txt.ts` shim, the `astro.config.ts` integration, and the explicit `seo.{sitemap, robots}` blocks together close the required sitemap and robots invariants. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
|
|
317
|
+
```ts
|
|
318
|
+
// website/astro.config.ts
|
|
319
|
+
import sitemap from '@astrojs/sitemap';
|
|
320
|
+
import react from '@astrojs/react';
|
|
321
|
+
import mdx from '@astrojs/mdx';
|
|
322
|
+
import { defineConfig } from 'astro';
|
|
323
|
+
|
|
324
|
+
import { WEBSITE_SITE_CONTEXT } from './src/website-site-context';
|
|
325
|
+
|
|
326
|
+
const sitemapI18n = {
|
|
327
|
+
defaultLocale: WEBSITE_SITE_CONTEXT.websiteConfig.defaultLocale,
|
|
328
|
+
locales: Object.fromEntries(
|
|
329
|
+
WEBSITE_SITE_CONTEXT.websiteConfig.locales.map((l) => [l, l]),
|
|
330
|
+
),
|
|
331
|
+
};
|
|
332
|
+
|
|
333
|
+
export default defineConfig({
|
|
334
|
+
site: WEBSITE_SITE_CONTEXT.websiteConfig.publicOrigin,
|
|
335
|
+
integrations: [
|
|
336
|
+
mdx(), // MUST come before react()
|
|
337
|
+
react(),
|
|
338
|
+
sitemap({ i18n: sitemapI18n }),
|
|
339
|
+
],
|
|
340
|
+
});
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
```ts
|
|
344
|
+
// website/src/website-root.config.ts (excerpt — the seo block)
|
|
345
|
+
export const WEBSITE_ROOT_CONFIG: WebsiteRootConfig = {
|
|
346
|
+
// ...
|
|
347
|
+
seo: {
|
|
348
|
+
siteName: 'Northstar Tasks',
|
|
349
|
+
/**
|
|
350
|
+
* Sitemap policy. Empty object = the marketing-site default
|
|
351
|
+
* (`enabled: true`, no per-page `changefreq` / `priority`
|
|
352
|
+
* overrides). The `@astrojs/sitemap` integration in
|
|
353
|
+
* `astro.config.ts` actually emits the file; this block only
|
|
354
|
+
* carries the policy decisions the engine cross-references
|
|
355
|
+
* (e.g. `renderRobotsTxt`'s `Sitemap:` footer is omitted when
|
|
356
|
+
* `enabled: false`).
|
|
357
|
+
*/
|
|
358
|
+
sitemap: {},
|
|
359
|
+
/**
|
|
360
|
+
* Robots.txt policy. Authored as the explicit default
|
|
361
|
+
* (`policy: 'index'`, no per-path disallow, no AI-crawler
|
|
362
|
+
* allow/deny lists) so the surface is visible at the call
|
|
363
|
+
* site. Real GTM-side decisions (e.g. blocking `/internal/`,
|
|
364
|
+
* gating `GPTBot` during a brand-positioning window) can flip
|
|
365
|
+
* individual fields without touching the
|
|
366
|
+
* `src/pages/robots.txt.ts` endpoint shell.
|
|
367
|
+
*/
|
|
368
|
+
robots: {
|
|
369
|
+
policy: 'index',
|
|
370
|
+
},
|
|
371
|
+
},
|
|
372
|
+
};
|
|
373
|
+
```
|
|
374
|
+
|
|
375
|
+
```ts
|
|
376
|
+
// website/src/pages/robots.txt.ts
|
|
377
|
+
import type { APIRoute } from 'astro';
|
|
378
|
+
import { renderRobotsTxt } from '@wildo-ai/saas-website/astro';
|
|
379
|
+
|
|
380
|
+
import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
381
|
+
|
|
382
|
+
export const prerender = true;
|
|
383
|
+
|
|
384
|
+
export const GET: APIRoute = () =>
|
|
385
|
+
new Response(renderRobotsTxt(WEBSITE_SITE_CONTEXT), {
|
|
386
|
+
headers: {
|
|
387
|
+
'Content-Type': 'text/plain; charset=utf-8',
|
|
388
|
+
'Cache-Control': 'public, max-age=3600',
|
|
389
|
+
},
|
|
390
|
+
});
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
## Per-page `<head>` shape
|
|
394
|
+
|
|
395
|
+
`renderWebsitePageHeadHtml` emits the following block (every URL
|
|
396
|
+
ABSOLUTE, every consumer-supplied string HTML-escaped):
|
|
397
|
+
|
|
398
|
+
| Tag | Source |
|
|
399
|
+
|---|---|
|
|
400
|
+
| `<title>` | `labelPack[manifest.metaLabelKeys.titleKey]` |
|
|
401
|
+
| `<meta name="description">` | `labelPack[manifest.metaLabelKeys.descriptionKey]` |
|
|
402
|
+
| `<link rel="canonical">` | `${publicOrigin}${buildLocalizedRoutePath(routePath, locale)}` |
|
|
403
|
+
| `<link rel="alternate" hreflang="<locale>">` × N | one per declared locale |
|
|
404
|
+
| `<link rel="alternate" hreflang="x-default">` | `defaultLocale`'s URL — Google's i18n discoverability hint |
|
|
405
|
+
| `<meta property="og:title">` / `og:description` / `og:type` / `og:url` / `og:site_name` | siteContext + label pack |
|
|
406
|
+
| `<meta property="og:locale">` + `og:locale:alternate` × (N − 1) | locale set |
|
|
407
|
+
| `<meta property="og:image">` | `labelPack[manifest.metaLabelKeys.ogImageUrl]` ?? `seo.defaultOgImageUrl` |
|
|
408
|
+
| `<meta name="twitter:card">` + Twitter mirrors | OG block, mirrored |
|
|
409
|
+
|
|
410
|
+
**Failure modes**: `renderWebsitePageHeadHtml` THROWS when
|
|
411
|
+
`titleKey` or `descriptionKey` is absent from the pack — actionable
|
|
412
|
+
next step ("Run `wildo website audit` or add the entry to
|
|
413
|
+
<pack-path>.json") is included in the error message.
|
|
414
|
+
|
|
415
|
+
## `robots.txt` shape
|
|
416
|
+
|
|
417
|
+
`renderRobotsTxt` emits blocks in this order:
|
|
418
|
+
|
|
419
|
+
1. **Per-bot `Allow: /` blocks** for `allowedCrawlers[]` (deny-by-
|
|
420
|
+
default direction — empty when `allowedCrawlers` is unset, the
|
|
421
|
+
dominant case).
|
|
422
|
+
2. **Per-bot `Disallow: /` blocks** for `disallowedCrawlers[]`
|
|
423
|
+
(allow-by-default direction — empty when `disallowedCrawlers` is
|
|
424
|
+
unset).
|
|
425
|
+
3. **Catch-all `User-agent: *`** carrying:
|
|
426
|
+
- `Disallow: /` if `policy === 'noindex'` OR if `allowedCrawlers`
|
|
427
|
+
is set (named bots are the ONLY ones permitted).
|
|
428
|
+
- `Disallow:` (spec-canonical "allow everything") otherwise.
|
|
429
|
+
- One `Disallow: <path>` line per `disallow[]` entry.
|
|
430
|
+
4. **`Sitemap: <publicOrigin>/sitemap-index.xml`** footer, emitted
|
|
431
|
+
whenever `seo.sitemap?.enabled !== false` (defaults to `true`).
|
|
432
|
+
Always advertises `sitemap-index.xml` (the index is always present
|
|
433
|
+
per `@astrojs/sitemap`'s contract, regardless of whether the site
|
|
434
|
+
has one or many sub-sitemap files).
|
|
435
|
+
|
|
436
|
+
**Mutual-exclusion invariant**: `WebsiteRobotsConfigSchema.superRefine`
|
|
437
|
+
guarantees `allowedCrawlers` and `disallowedCrawlers` are NOT both
|
|
438
|
+
set — picking a "policy direction" is a deliberate authoring choice.
|
|
439
|
+
|
|
440
|
+
**Failure mode**: `renderRobotsTxt` THROWS when
|
|
441
|
+
`websiteConfig.publicOrigin` is unset (the absolute URL of the
|
|
442
|
+
sitemap footer cannot be composed without it).
|
|
443
|
+
|
|
444
|
+
## Sitemap coverage contract
|
|
445
|
+
|
|
446
|
+
`enumerateMarketingPageSitemapUrls(siteContext)` returns one entry
|
|
447
|
+
per (`pageManifest`, `locale`) pair, where each entry carries:
|
|
448
|
+
|
|
449
|
+
- `url` — absolute canonical URL (no trailing slash, matches
|
|
450
|
+
`<link rel="canonical">` from the head renderer);
|
|
451
|
+
- `pageRef` / `routePath` / `locale` — debug + grouping aids;
|
|
452
|
+
- `alternates: { hreflang, url }[]` — every other locale's URL plus
|
|
453
|
+
an `x-default` entry for the default locale. Mirrors what
|
|
454
|
+
`@astrojs/sitemap` emits via `xhtml:link rel="alternate"
|
|
455
|
+
hreflang="..."` annotations on each `<url>` block.
|
|
456
|
+
|
|
457
|
+
**Coverage invariant**: every `(pageManifests[i].ref, locales[j])`
|
|
458
|
+
pair MUST appear in the output (one entry per pair). A regression
|
|
459
|
+
that drops a manifest from the registry, drops a locale from the
|
|
460
|
+
routing surface, or silently changes the localized route-path
|
|
461
|
+
helper would fail this invariant immediately.
|
|
462
|
+
|
|
463
|
+
**Excluded**: blog post slugs are NOT in the enumeration — the blog
|
|
464
|
+
adapter ships its routes via Astro's file-based router and
|
|
465
|
+
`@astrojs/sitemap` auto-discovers them. The helper covers only the
|
|
466
|
+
page-manifest registry (the surface the framework asserts coverage
|
|
467
|
+
for).
|
|
468
|
+
|
|
469
|
+
## AEO + GEO contract
|
|
470
|
+
|
|
471
|
+
This SKILL now covers the shipped AEO/GEO surface in addition to the
|
|
472
|
+
baseline SEO shell:
|
|
473
|
+
|
|
474
|
+
- **AEO** — section-owned `getStructuredData()` returns passive
|
|
475
|
+
Schema.org entities from the merged installed/application catalog, and the page
|
|
476
|
+
shell emits them through `renderPageStructuredData(...)`.
|
|
477
|
+
- **GEO** — `website/src/content/llms.txt` is hand-authored and served
|
|
478
|
+
via `readLlmsTxtBody(...)`; per-page
|
|
479
|
+
`WebsitePageManifest.seo.noaiOptOut?` drives both the robots meta tag
|
|
480
|
+
and the `_headers` `X-Robots-Tag`.
|
|
481
|
+
- **Audit posture** — JSON-LD drift is warning-first. The companion
|
|
482
|
+
reconciliation logic is the source of truth, and `wildo website audit`
|
|
483
|
+
is the CLI re-surface.
|
|
484
|
+
|
|
485
|
+
## `llms.txt` assembly guide
|
|
486
|
+
|
|
487
|
+
Treat `website/src/content/llms.txt` as a compact editorial map for AI
|
|
488
|
+
crawlers:
|
|
489
|
+
|
|
490
|
+
- Start with the primary route map near the top.
|
|
491
|
+
- Add one concise block per important page.
|
|
492
|
+
- Add high-signal FAQ/blog material only when it improves retrieval.
|
|
493
|
+
- Prefer one canonical language file; v1 does not emit per-locale files.
|
|
494
|
+
- Update the file in the same PR as any major hero/pricing/FAQ/contact
|
|
495
|
+
copy change.
|
|
496
|
+
|
|
497
|
+
## References
|
|
498
|
+
|
|
499
|
+
- `references/seo-api.md` — source-backed excerpts of the SEO
|
|
500
|
+
surface: the `WebsiteSeoConfigSchema` root block, the three
|
|
501
|
+
policy sub-schemas (`WebsiteSitemapConfigSchema`,
|
|
502
|
+
`WebsiteRobotsConfigSchema`, `WebsiteLlmsTxtConfigSchema` —
|
|
503
|
+
the latter cross-cited in `geo-api.md`), the
|
|
504
|
+
`WebsiteStructuredDataPayload` JSON-LD payload contract, and
|
|
505
|
+
the two Astro-side renderers (`renderRobotsTxt`,
|
|
506
|
+
`enumerateMarketingPageSitemapUrls`). Pulled via
|
|
507
|
+
`saas.website.root-config.seo`, `saas.website.seo.*`,
|
|
508
|
+
`saas.website.structured-data.payload-shape`, and
|
|
509
|
+
`saas.website.astro.{sitemap-coverage,robots-renderer}`
|
|
510
|
+
source-backed website contract references.
|
|
511
|
+
- `references/aeo-api.md` — section JSON-LD contract and structured-data
|
|
512
|
+
renderer anchors.
|
|
513
|
+
- `references/geo-api.md` — `llms.txt` publication + `noai` opt-out
|
|
514
|
+
anchors.
|
|
515
|
+
|
|
516
|
+
## Verification
|
|
517
|
+
|
|
518
|
+
- [ ] `WEBSITE_ROOT_CONFIG.seo.siteName` is a non-empty string.
|
|
519
|
+
- [ ] Every page manifest's `metaLabelKeys.titleKey` and
|
|
520
|
+
`descriptionKey` exist in EVERY locale's
|
|
521
|
+
`i18n/<locale>.json` (label-pack validator catches this).
|
|
522
|
+
- [ ] Every page-shell `.astro` injects
|
|
523
|
+
`renderWebsitePageHeadHtml(...)` via
|
|
524
|
+
`<Fragment set:html={...} />` (NOT raw, NOT a hand-rolled
|
|
525
|
+
`<head>` block).
|
|
526
|
+
- [ ] Every page that wants JSON-LD calls `renderPageStructuredData(...)`
|
|
527
|
+
from the shell instead of hand-rolling inline `<script
|
|
528
|
+
type="application/ld+json">`.
|
|
529
|
+
- [ ] `website/src/content/llms.txt` exists when GEO publication is
|
|
530
|
+
intended, and `website/src/pages/llms.txt.ts` serves it via
|
|
531
|
+
`readLlmsTxtBody(...)`.
|
|
532
|
+
- [ ] Any page with `seo.noaiOptOut: true` also participates in the
|
|
533
|
+
generated `_headers` output (same boolean, dual channel).
|
|
534
|
+
- [ ] `@astrojs/sitemap` is registered in `astro.config.ts`'s
|
|
535
|
+
`integrations[]` AND `defineConfig({ site: ... })` is set to
|
|
536
|
+
`WEBSITE_SITE_CONTEXT.websiteConfig.publicOrigin`.
|
|
537
|
+
- [ ] The sitemap `i18n` option is populated as
|
|
538
|
+
`{ defaultLocale, locales: Object.fromEntries(...) }`, NOT
|
|
539
|
+
an array of locales (silent no-i18n fallback).
|
|
540
|
+
- [ ] `src/pages/robots.txt.ts` exists, exports a `GET` handler,
|
|
541
|
+
and calls `renderRobotsTxt(WEBSITE_SITE_CONTEXT)` (NOT a
|
|
542
|
+
hand-rolled `robots.txt` static asset).
|
|
543
|
+
- [ ] `WEBSITE_ROOT_CONFIG.seo.robots` is authored explicitly at
|
|
544
|
+
the call site (even when `policy: 'index'` and no
|
|
545
|
+
crawler lists) so the surface is visible to the next reader.
|
|
546
|
+
- [ ] If `allowedCrawlers` is set, `disallowedCrawlers` is NOT set
|
|
547
|
+
(and vice-versa) — the `superRefine` enforces this at parse
|
|
548
|
+
time, but the call site should reflect the deliberate
|
|
549
|
+
direction choice.
|
|
550
|
+
- [ ] (optional but recommended) A vitest test asserts
|
|
551
|
+
`enumerateMarketingPageSitemapUrls(WEBSITE_SITE_CONTEXT).length`
|
|
552
|
+
equals `pageManifests.length × locales.length`.
|
|
553
|
+
|
|
554
|
+
### Grep invariants
|
|
555
|
+
|
|
556
|
+
| Invariant | Command |
|
|
557
|
+
|---|---|
|
|
558
|
+
| Sitemap integration registered | `rg -n "@astrojs/sitemap" website/astro.config.ts` (≥1 import + ≥1 `sitemap(...)` call) |
|
|
559
|
+
| `site` option set | `rg -n "site:.*publicOrigin" website/astro.config.ts` (≥1 match) |
|
|
560
|
+
| `llms.txt` endpoint in place | `rg -n "readLlmsTxtBody" website/src/pages/llms.txt.ts` (exactly 1 match) |
|
|
561
|
+
| Robots endpoint in place | `rg -n "renderRobotsTxt" website/src/pages/robots.txt.ts` (exactly 1 match) |
|
|
562
|
+
| 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) |
|
|
563
|
+
| No hand-rolled robots.txt static | `ls website/public/ \| rg "^robots\.txt$"` (must return empty — the endpoint owns it) |
|
|
564
|
+
| No hand-rolled sitemap static | `ls website/public/ \| rg "^sitemap.*\.xml$"` (must return empty — the integration owns it) |
|
|
565
|
+
| Head renderer used in every page shell | `rg -L "renderWebsitePageHeadHtml" website/src/pages/*.astro` (each page shell must match — exclude `[slug].astro` blog shells which use `renderBlogPostHeadHtml`) |
|
|
566
|
+
|
|
567
|
+
## Common Rationalizations
|
|
568
|
+
|
|
569
|
+
| Rationalization | Reality |
|
|
570
|
+
|---|---|
|
|
571
|
+
| "I'll hand-roll a `robots.txt` static asset in `public/` instead of an Astro endpoint" | The endpoint shape lets the framework own the spec-conformant emission (block ordering, `Sitemap:` footer composition, mutual-exclusion invariants). A static asset duplicates that logic at the call site and silently drifts from the schema's intent. |
|
|
572
|
+
| "I'll set `site: 'https://example.com'` as a string literal instead of reading `publicOrigin`" | Two sources of truth that drift on every environment promotion. The `WildoMarketingWebsiteConfig.publicOrigin` is the single source — every absolute URL (sitemap `<loc>`, canonical, OG `og:url`, `Sitemap:` footer) must compose from it. |
|
|
573
|
+
| "I'll pass the locales array directly to `sitemap({ i18n: { locales } })`" | The plugin expects `{ defaultLocale, locales: { <key>: <bcp47-tag> } }` and silently falls back to no-i18n emission for any other shape. Use `Object.fromEntries(websiteConfig.locales.map((l) => [l, l]))` to build the BCP-47 mapping. |
|
|
574
|
+
| "I'll skip the explicit `seo.robots: { policy: 'index' }` because that's the default" | True at the schema layer, but invisible at the call site. Authoring the default explicitly makes the policy decision auditable in code review and lets a downstream reader find the surface without reading the schema first. |
|
|
575
|
+
| "I'll pass per-page meta as raw HTML strings instead of going through `metaLabelKeys`" | Raw HTML bypasses the label-pack validator (typos and missing locales silently ship), bypasses the per-locale resolution, and bypasses the HTML-escape pass the renderer applies. The `metaLabelKeys` indirection is the single discipline surface for SEO copy. |
|
|
576
|
+
| "I'll hand-roll `<script type=\"application/ld+json\">` in the section component" | That bypasses the framework collector, deduping, and companion audit surface. Keep entity authoring in `getStructuredData()` and shell placement in `renderPageStructuredData(...)`. |
|
|
577
|
+
| "I'll derive `llms.txt` automatically from labels/navigation so I don't have to maintain it" | That produces low-signal crawler copy and hides editorial intent. `llms.txt` is deliberately hand-authored. |
|
|
578
|
+
| "I'll add `<meta name=\"robots\" content=\"noai\">` manually in the page shell" | Use `WebsitePageManifest.seo.noaiOptOut` instead so the framework emits both the meta tag and `_headers` `X-Robots-Tag` from one knob. |
|
|
579
|
+
|
|
580
|
+
## Red Flags
|
|
581
|
+
|
|
582
|
+
- A `public/robots.txt` or `public/sitemap.xml` static file shipped
|
|
583
|
+
alongside the Astro integration — duplicates the framework's
|
|
584
|
+
emission and silently shadows the dynamic endpoint.
|
|
585
|
+
- `defineConfig({ site: ... })` set to a literal string instead of
|
|
586
|
+
`WEBSITE_SITE_CONTEXT.websiteConfig.publicOrigin` — drift surface.
|
|
587
|
+
- A page shell composing its own `<head>` block (raw `<title>` /
|
|
588
|
+
`<meta>` tags) instead of injecting `renderWebsitePageHeadHtml`
|
|
589
|
+
output — bypasses the canonical / hreflang / OG composition every
|
|
590
|
+
other page on the site uses.
|
|
591
|
+
- An `astro.config.ts` that registers `sitemap()` without the `i18n`
|
|
592
|
+
option in a multi-locale site — emits a mono-locale sitemap that
|
|
593
|
+
silently breaks the hreflang graph.
|
|
594
|
+
- A `seo.robots` block with both `allowedCrawlers` and
|
|
595
|
+
`disallowedCrawlers` set — `superRefine` rejects it at parse time,
|
|
596
|
+
but if you see the shape proposed in a draft PR the author has
|
|
597
|
+
the wrong mental model (the two fields are two halves of ONE
|
|
598
|
+
policy decision, not orthogonal knobs).
|
|
599
|
+
- An MDX-rendered blog post claiming `og:type=article` while a static
|
|
600
|
+
marketing page claims `og:type=article` — the page shell is using
|
|
601
|
+
the wrong head renderer (`renderBlogPostHeadHtml` is for
|
|
602
|
+
`[slug].astro` shells only; static pages must use
|
|
603
|
+
`renderWebsitePageHeadHtml`).
|
|
604
|
+
- Any `import 'astro:content'` inside a `robots.txt.ts` endpoint —
|
|
605
|
+
the helper is pure and does not need content collections; pulling
|
|
606
|
+
them in adds build-time cost for zero benefit.
|
|
607
|
+
|
|
608
|
+
## Related Skills
|
|
609
|
+
|
|
610
|
+
- `website-page-authoring` — composing the static (non-blog)
|
|
611
|
+
marketing pages whose `metaLabelKeys` feed
|
|
612
|
+
`renderWebsitePageHeadHtml`.
|
|
613
|
+
- `website-blog-authoring` — the per-locale blog adapter, which
|
|
614
|
+
uses `renderBlogPostHeadHtml` (sibling renderer that emits
|
|
615
|
+
`og:type=article` + `article:*` block from validated frontmatter
|
|
616
|
+
instead of `metaLabelKeys`).
|
|
617
|
+
- `website-label-pack` — how `metaLabelKeys` get authored and
|
|
618
|
+
validated against per-locale `i18n/*.json` files.
|
|
619
|
+
- `website-navigation-authoring` — the chrome surfaces that read
|
|
620
|
+
their labels from `chromeLabelKeys` (separate validator surface
|
|
621
|
+
from the SEO `metaLabelKeys`).
|
|
622
|
+
- `website-marketing-metadata-extension` — extending
|
|
623
|
+
`WildoMarketingWebsiteConfig` (where `publicOrigin` lives — the
|
|
624
|
+
single source of truth for absolute URL composition).
|