@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,790 @@
|
|
|
1
|
+
# Marketing-site SEO — API contract (source-backed)
|
|
2
|
+
|
|
3
|
+
Source-backed excerpts of the engine entry points the SEO surface
|
|
4
|
+
exposes. Pulled in via the framework-knowledge anchor system so the
|
|
5
|
+
compiled skill always reflects the engine's current contract —
|
|
6
|
+
never a hand-mirrored copy.
|
|
7
|
+
|
|
8
|
+
## `WebsiteSeoConfig` — site-wide SEO root block
|
|
9
|
+
|
|
10
|
+
The Zod 4 schema authored on `WebsiteRootConfig.seo`. Composes the
|
|
11
|
+
three optional policy sub-blocks (`sitemap?` / `robots?` /
|
|
12
|
+
`llmsTxt?`) with the always-required site identity fields
|
|
13
|
+
(`siteName`, `defaultOgImageUrl?`). `siteOrigin` is intentionally
|
|
14
|
+
NOT on this block — after the seam-collapse refactor it lives only
|
|
15
|
+
on `WildoMarketingWebsiteConfig.publicOrigin` (the per-service
|
|
16
|
+
`wildo.website.config.ts`), so that "what URL is this site reachable
|
|
17
|
+
at" has exactly one source of truth.
|
|
18
|
+
|
|
19
|
+
Read this block first when authoring root-level SEO — it shows
|
|
20
|
+
which sub-blocks are optional, which defaults each omission picks
|
|
21
|
+
up (sitemap → enabled, robots → index, llmsTxt → auto-detect from
|
|
22
|
+
file presence), and why `siteName` is required (social-platform
|
|
23
|
+
preview branding).
|
|
24
|
+
|
|
25
|
+
## Import Origins
|
|
26
|
+
|
|
27
|
+
- `@wildo-ai/saas-website`
|
|
28
|
+
|
|
29
|
+
## Source Excerpts
|
|
30
|
+
|
|
31
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
32
|
+
|
|
33
|
+
```typescript
|
|
34
|
+
*
|
|
35
|
+
* `WebsiteSeoConfig` — site-wide SEO/social-graph configuration
|
|
36
|
+
* AUTHORED ON THE ROOT CONFIG.
|
|
37
|
+
*
|
|
38
|
+
* # Scope
|
|
39
|
+
*
|
|
40
|
+
* The public marketing-site origin belongs only in the per-service
|
|
41
|
+
* `wildo.website.config.ts` declaration. Keep it out of this site-level SEO
|
|
42
|
+
* block so the origin and localized routing have one source of truth.
|
|
43
|
+
*
|
|
44
|
+
* What stays on this block: site-level branding + hero-image
|
|
45
|
+
* fallbacks that are co-authored with chrome labels and page
|
|
46
|
+
* manifests respectively, NOT with the URL/i18n routing surface.
|
|
47
|
+
*
|
|
48
|
+
* # Field rationale
|
|
49
|
+
*
|
|
50
|
+
* **Why `siteName` is REQUIRED**:
|
|
51
|
+
* - `og:site_name` is the brand label social platforms render
|
|
52
|
+
* above the page title in shared previews. Without it, every
|
|
53
|
+
* LinkedIn / Facebook / Slack preview shows the bare title with
|
|
54
|
+
* no brand context.
|
|
55
|
+
* - It is also the recommended `application-name` meta tag value
|
|
56
|
+
* and a useful default for JSON-LD `Organization.name` schema
|
|
57
|
+
* when the application ships structured data.
|
|
58
|
+
*
|
|
59
|
+
* **Why `defaultOgImageUrl` is OPTIONAL**:
|
|
60
|
+
* - Each page's `WebsitePageManifest.metaLabelKeys.ogImageUrl`
|
|
61
|
+
* takes precedence; the site-level default is a fallback for
|
|
62
|
+
* pages that did not commit to a hero image.
|
|
63
|
+
* - Marketing surfaces shipping no OG images at all (acceptable
|
|
64
|
+
* for a placeholder build) should not be forced to author one.
|
|
65
|
+
*
|
|
66
|
+
* **Why `sitemap?` and `robots?` are OPTIONAL** (with sensible
|
|
67
|
+
* defaults inside each sub-schema):
|
|
68
|
+
* - The marketing-site default ships a public surface — every
|
|
69
|
+
* page indexable, no AI-crawler restrictions, no per-path
|
|
70
|
+
* disallow. Forcing every consumer to author both blocks just
|
|
71
|
+
* to land in that default state would pollute the call site.
|
|
72
|
+
* - Omitting either block at the call site is equivalent to
|
|
73
|
+
* authoring `{}` — `WebsiteSitemapConfig.enabled` defaults to
|
|
74
|
+
* `true`, `WebsiteRobotsConfig.policy` defaults to `'index'`.
|
|
75
|
+
* The per-block field rationale lives on each sub-schema.
|
|
76
|
+
* - `llmsTxt?` is similarly optional, but with a different default
|
|
77
|
+
* mechanic: omitting the block means "auto-detect from file
|
|
78
|
+
* presence" rather than "use a static schema default". The helper
|
|
79
|
+
* `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`
|
|
80
|
+
* exists and returns `null` otherwise.
|
|
81
|
+
*
|
|
82
|
+
* **Validation**:
|
|
83
|
+
* - `siteName` is `z.string().min(1)` — empty strings would emit
|
|
84
|
+
* `<meta property="og:site_name" content="" />` which social
|
|
85
|
+
* platforms render as a blank line.
|
|
86
|
+
* - `defaultOgImageUrl` (when present) is `z.url()`.
|
|
87
|
+
* - `sitemap` / `robots` validation lives on the sub-schemas.
|
|
88
|
+
*/
|
|
89
|
+
const _WebsiteSeoConfigSchema = z
|
|
90
|
+
.object({
|
|
91
|
+
siteName: z
|
|
92
|
+
.string()
|
|
93
|
+
.min(1, { error: 'WebsiteSeoConfig.siteName must be a non-empty string' }),
|
|
94
|
+
defaultOgImageUrl: z
|
|
95
|
+
.url({ error: 'WebsiteSeoConfig.defaultOgImageUrl must be a fully-qualified URL' })
|
|
96
|
+
.optional(),
|
|
97
|
+
/**
|
|
98
|
+
* Sitemap policy block. Optional — omitting it is equivalent to
|
|
99
|
+
* `{ enabled: true }` (the marketing-site default). See
|
|
100
|
+
* `WebsiteSitemapConfigSchema` for field-by-field rationale.
|
|
101
|
+
*/
|
|
102
|
+
sitemap: _WebsiteSitemapConfigSchema.optional(),
|
|
103
|
+
/**
|
|
104
|
+
* Robots.txt policy block. Optional — omitting it is equivalent
|
|
105
|
+
* to `{ policy: 'index' }` (the marketing-site default). See
|
|
106
|
+
* `WebsiteRobotsConfigSchema` for field-by-field rationale.
|
|
107
|
+
*/
|
|
108
|
+
robots: _WebsiteRobotsConfigSchema.optional(),
|
|
109
|
+
/**
|
|
110
|
+
* `llms.txt` publication policy. Optional — omitting it means
|
|
111
|
+
* "auto-detect from file presence". See
|
|
112
|
+
* `WebsiteLlmsTxtConfigSchema` for the serving contract.
|
|
113
|
+
*/
|
|
114
|
+
llmsTxt: _WebsiteLlmsTxtConfigSchema.optional(),
|
|
115
|
+
});
|
|
116
|
+
|
|
117
|
+
export const WebsiteSeoConfigSchema: typeof _WebsiteSeoConfigSchema = _WebsiteSeoConfigSchema;
|
|
118
|
+
|
|
119
|
+
export type WebsiteSeoConfig = z.infer<typeof _WebsiteSeoConfigSchema>;
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## `WebsiteSitemapConfig` — site-wide sitemap policy schema
|
|
123
|
+
|
|
124
|
+
The Zod 4 schema authored on `WebsiteRootConfig.seo.sitemap?`.
|
|
125
|
+
Optional at the call site — omitting it is equivalent to
|
|
126
|
+
`{ enabled: true }` (the marketing-site default). The schema
|
|
127
|
+
documents WHY each field has the default it has (`enabled` defaults
|
|
128
|
+
to `true` because shipping public pages without a sitemap is the
|
|
129
|
+
common silent regression; `changefreq` and `priority` are optional
|
|
130
|
+
because both are non-binding hints and forcing a value invites
|
|
131
|
+
superstitious authoring).
|
|
132
|
+
|
|
133
|
+
## Import Origins
|
|
134
|
+
|
|
135
|
+
- `@wildo-ai/saas-website`
|
|
136
|
+
|
|
137
|
+
## Source Excerpts
|
|
138
|
+
|
|
139
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
140
|
+
|
|
141
|
+
```typescript
|
|
142
|
+
*
|
|
143
|
+
* `WebsiteSitemapConfig` — site-wide sitemap policy block.
|
|
144
|
+
*
|
|
145
|
+
* Materialized at build time by `@astrojs/sitemap` (the official
|
|
146
|
+
* Astro plugin) when the consumer wires it into `astro.config.ts`
|
|
147
|
+
* (see `website-seo-aeo-geo` SKILL). The framework owns the
|
|
148
|
+
* **schema** (so config + enforcement live in lock-step with the
|
|
149
|
+
* page registry) but the framework does NOT own the runtime
|
|
150
|
+
* generator — `@astrojs/sitemap` already covers per-page
|
|
151
|
+
* `lastmod` / `changefreq` / `priority` + i18n `xhtml:link
|
|
152
|
+
* hreflang` annotations natively, and re-implementing that surface
|
|
153
|
+
* inside the engine would duplicate well-trodden Astro tooling for
|
|
154
|
+
* zero added value.
|
|
155
|
+
*
|
|
156
|
+
* # Field rationale
|
|
157
|
+
*
|
|
158
|
+
* **Why `enabled` defaults to `true`**:
|
|
159
|
+
* - Marketing sites that want to ship public pages overwhelmingly
|
|
160
|
+
* also want them in `sitemap.xml` (search engines treat its
|
|
161
|
+
* absence as a discoverability signal). The opt-OUT shape avoids
|
|
162
|
+
* a silent regression where a consumer ships pages that crawlers
|
|
163
|
+
* never index because they forgot to flip a flag.
|
|
164
|
+
* - The escape hatch (`enabled: false`) covers staging deployments
|
|
165
|
+
* and the rare per-app decision to suppress sitemap emission
|
|
166
|
+
* entirely (e.g. a private beta surface routed under a
|
|
167
|
+
* `noindex` policy).
|
|
168
|
+
*
|
|
169
|
+
* **Why `changefreq` / `priority` are OPTIONAL** (no defaults):
|
|
170
|
+
* - Both fields are non-binding hints — Google explicitly
|
|
171
|
+
* ignores `priority` and treats `changefreq` as a soft signal.
|
|
172
|
+
* Forcing the consumer to pick a value would either invite
|
|
173
|
+
* superstitious authoring (`priority: 1.0` on every page) or
|
|
174
|
+
* bury the field's actual ergonomic shape (per-page overrides
|
|
175
|
+
* via `WebsitePageManifest.seo` — deferred until a real
|
|
176
|
+
* consumer requests it).
|
|
177
|
+
* - Unset values are simply omitted from the emitted `<url>`
|
|
178
|
+
* entries; `@astrojs/sitemap` handles that automatically.
|
|
179
|
+
*
|
|
180
|
+
* **Validation**:
|
|
181
|
+
* - `priority` is `z.number().min(0).max(1)` — outside the spec
|
|
182
|
+
* range would silently break crawler ingestion.
|
|
183
|
+
* - `changefreq` is the union of the seven values the sitemap
|
|
184
|
+
* spec defines; arbitrary strings would be silently dropped by
|
|
185
|
+
* compliant crawlers.
|
|
186
|
+
*/
|
|
187
|
+
const _WebsiteSitemapConfigSchema = z.object({
|
|
188
|
+
enabled: z.boolean().default(true),
|
|
189
|
+
changefreq: z
|
|
190
|
+
.enum(['always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never'])
|
|
191
|
+
.optional(),
|
|
192
|
+
priority: z
|
|
193
|
+
.number()
|
|
194
|
+
.min(0, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })
|
|
195
|
+
.max(1, { error: 'WebsiteSitemapConfig.priority must be between 0 and 1' })
|
|
196
|
+
.optional(),
|
|
197
|
+
});
|
|
198
|
+
|
|
199
|
+
export const WebsiteSitemapConfigSchema: typeof _WebsiteSitemapConfigSchema =
|
|
200
|
+
_WebsiteSitemapConfigSchema;
|
|
201
|
+
|
|
202
|
+
export type WebsiteSitemapConfig = z.infer<typeof _WebsiteSitemapConfigSchema>;
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
## `WebsiteRobotsConfig` — site-wide robots.txt policy schema
|
|
206
|
+
|
|
207
|
+
The Zod 4 schema authored on `WebsiteRootConfig.seo.robots?`.
|
|
208
|
+
Optional at the call site — omitting it is equivalent to
|
|
209
|
+
`{ policy: 'index' }`. `disallow[]` entries are validated to start
|
|
210
|
+
with `/` (sitemap path-prefix spec); `allowedCrawlers` and
|
|
211
|
+
`disallowedCrawlers` are mutually exclusive (enforced via
|
|
212
|
+
`superRefine` — picking a "policy direction" is a deliberate
|
|
213
|
+
authoring choice, not a knob you flip on both sides).
|
|
214
|
+
|
|
215
|
+
## Import Origins
|
|
216
|
+
|
|
217
|
+
- `@wildo-ai/saas-website`
|
|
218
|
+
|
|
219
|
+
## Source Excerpts
|
|
220
|
+
|
|
221
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
222
|
+
|
|
223
|
+
```typescript
|
|
224
|
+
*
|
|
225
|
+
* `WebsiteRobotsConfig` — site-wide `robots.txt` policy block.
|
|
226
|
+
*
|
|
227
|
+
* Materialized at request time by `renderRobotsTxt(siteContext)`
|
|
228
|
+
* from `@wildo-ai/saas-website/astro` (consumer wires a thin
|
|
229
|
+
* `src/pages/robots.txt.ts` Astro endpoint that returns the helper's
|
|
230
|
+
* output). Scoped to the SITE-WIDE policy surface — per-page
|
|
231
|
+
* `noindex` is a separate concern that lands on
|
|
232
|
+
* `WebsitePageManifest.seo` once a real consumer requests it (today
|
|
233
|
+
* the site-wide `disallow[]` covers staging-environment exclusion of
|
|
234
|
+
* specific path prefixes, the dominant real-world use case).
|
|
235
|
+
*
|
|
236
|
+
* # Field rationale
|
|
237
|
+
*
|
|
238
|
+
* **Why `policy` defaults to `'index'`**:
|
|
239
|
+
* - The default for a public marketing site is "let crawlers in";
|
|
240
|
+
* `'noindex'` is the deliberate exception (staging environments,
|
|
241
|
+
* beta surfaces, sites still under construction). The opt-OUT
|
|
242
|
+
* shape mirrors `WebsiteSitemapConfig.enabled` for consistency.
|
|
243
|
+
* - `'noindex'` emits a `User-agent: *\nDisallow: /` block — the
|
|
244
|
+
* standard "tell every well-behaved crawler to stay away"
|
|
245
|
+
* primitive.
|
|
246
|
+
*
|
|
247
|
+
* **Why `disallow[]` is a path-prefix list (not a regex)**:
|
|
248
|
+
* - The `robots.txt` spec only supports literal path prefixes
|
|
249
|
+
* with `*` / `$` wildcards; Disallow is NOT a regex surface.
|
|
250
|
+
* Typing it as `string[]` (validated to start with `/`) keeps
|
|
251
|
+
* the contract honest and lets consumers paste from their CDN
|
|
252
|
+
* allowlists without translation.
|
|
253
|
+
*
|
|
254
|
+
* **Why `allowedCrawlers` and `disallowedCrawlers` are mutually
|
|
255
|
+
* exclusive**:
|
|
256
|
+
* - The two fields are two halves of the SAME AI-crawler policy
|
|
257
|
+
* decision. `allowedCrawlers` is the deny-by-default shape
|
|
258
|
+
* (only the named bots may crawl); `disallowedCrawlers` is the
|
|
259
|
+
* allow-by-default shape (every bot except the named ones may
|
|
260
|
+
* crawl). Mixing both would emit a contradictory `robots.txt`
|
|
261
|
+
* (a bot in both lists would receive conflicting directives).
|
|
262
|
+
* A `superRefine` enforces the mutual-exclusion invariant at
|
|
263
|
+
* parse time so the build fails fast.
|
|
264
|
+
*
|
|
265
|
+
* **Validation**:
|
|
266
|
+
* - `disallow[]` entries must start with `/` (sitemap path-prefix
|
|
267
|
+
* spec) — anything else would silently match nothing.
|
|
268
|
+
* - `allowedCrawlers` / `disallowedCrawlers` entries must be
|
|
269
|
+
* non-empty strings (a blank User-agent token would emit
|
|
270
|
+
* `User-agent: ` which compliant crawlers ignore — silent
|
|
271
|
+
* misconfig).
|
|
272
|
+
* - `superRefine` rejects the combined-list anti-pattern.
|
|
273
|
+
*/
|
|
274
|
+
const _WebsiteRobotsConfigSchema = z
|
|
275
|
+
.object({
|
|
276
|
+
policy: z.enum(['index', 'noindex']).default('index'),
|
|
277
|
+
disallow: z
|
|
278
|
+
.array(
|
|
279
|
+
z
|
|
280
|
+
.string()
|
|
281
|
+
.min(1)
|
|
282
|
+
.refine((path) => path.startsWith('/'), {
|
|
283
|
+
error: 'WebsiteRobotsConfig.disallow[] entries must start with "/"',
|
|
284
|
+
}),
|
|
285
|
+
)
|
|
286
|
+
.optional(),
|
|
287
|
+
/**
|
|
288
|
+
* Deny-by-default AI-crawler allowlist. When set, the emitted
|
|
289
|
+
* `robots.txt` lists each named bot under its own
|
|
290
|
+
* `User-agent: <bot>\nAllow: /` block, then closes with a
|
|
291
|
+
* catch-all `User-agent: *\nDisallow: /`. Mutually exclusive
|
|
292
|
+
* with `disallowedCrawlers` (see `superRefine` below).
|
|
293
|
+
*/
|
|
294
|
+
allowedCrawlers: z.array(z.string().min(1)).optional(),
|
|
295
|
+
/**
|
|
296
|
+
* Allow-by-default AI-crawler denylist. When set, the emitted
|
|
297
|
+
* `robots.txt` lists each named bot under its own
|
|
298
|
+
* `User-agent: <bot>\nDisallow: /` block. Mutually exclusive
|
|
299
|
+
* with `allowedCrawlers` (see `superRefine` below).
|
|
300
|
+
*/
|
|
301
|
+
disallowedCrawlers: z.array(z.string().min(1)).optional(),
|
|
302
|
+
})
|
|
303
|
+
.superRefine((value, ctx) => {
|
|
304
|
+
if (value.allowedCrawlers !== undefined && value.disallowedCrawlers !== undefined) {
|
|
305
|
+
ctx.addIssue({
|
|
306
|
+
code: 'custom',
|
|
307
|
+
path: ['allowedCrawlers'],
|
|
308
|
+
message:
|
|
309
|
+
'WebsiteRobotsConfig.allowedCrawlers and disallowedCrawlers are mutually exclusive — pick one policy direction (deny-by-default vs allow-by-default).',
|
|
310
|
+
});
|
|
311
|
+
}
|
|
312
|
+
});
|
|
313
|
+
|
|
314
|
+
export const WebsiteRobotsConfigSchema: typeof _WebsiteRobotsConfigSchema =
|
|
315
|
+
_WebsiteRobotsConfigSchema;
|
|
316
|
+
|
|
317
|
+
export type WebsiteRobotsConfig = z.infer<typeof _WebsiteRobotsConfigSchema>;
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
## `renderRobotsTxt(siteContext)` — robots.txt body builder
|
|
321
|
+
|
|
322
|
+
Pure string builder consumed by the consumer's
|
|
323
|
+
`src/pages/robots.txt.ts` endpoint. Composes per-bot Allow/Disallow
|
|
324
|
+
blocks, the catch-all `User-agent: *`, the per-path `Disallow:`
|
|
325
|
+
entries from `disallow[]`, and the `Sitemap:` footer (always
|
|
326
|
+
advertising `sitemap-index.xml`, the stable URL `@astrojs/sitemap`
|
|
327
|
+
emits regardless of how many sub-sitemap files the site has).
|
|
328
|
+
Throws when `publicOrigin` is unset (the sitemap footer's absolute
|
|
329
|
+
URL cannot be composed without it).
|
|
330
|
+
|
|
331
|
+
## Import Origins
|
|
332
|
+
|
|
333
|
+
- `@wildo-ai/saas-website`
|
|
334
|
+
|
|
335
|
+
## Source Excerpts
|
|
336
|
+
|
|
337
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
338
|
+
|
|
339
|
+
```typescript
|
|
340
|
+
*
|
|
341
|
+
* `renderRobotsTxt(siteContext)` — pure string builder for the
|
|
342
|
+
* marketing site's `robots.txt` body. The consumer wires a thin
|
|
343
|
+
* `src/pages/robots.txt.ts` Astro endpoint that imports this helper
|
|
344
|
+
* + `WEBSITE_SITE_CONTEXT` and returns its output as a `Response`
|
|
345
|
+
* with `Content-Type: text/plain` (see `website-seo-aeo-geo` SKILL).
|
|
346
|
+
*
|
|
347
|
+
* # Why a pure string builder (not an Astro component)
|
|
348
|
+
*
|
|
349
|
+
* Same rationale as `renderWebsitePageHeadHtml`:
|
|
350
|
+
* 1. Pure TypeScript ships through the `@wildo-ai/saas-website/astro`
|
|
351
|
+
* subpath barrel (Astro components do not).
|
|
352
|
+
* 2. Vitest-friendly — every policy permutation is asserted
|
|
353
|
+
* against the returned string without an Astro test harness.
|
|
354
|
+
* 3. The Astro endpoint stays a 3-line shim the consumer can
|
|
355
|
+
* audit at a glance.
|
|
356
|
+
*
|
|
357
|
+
* # Output shape
|
|
358
|
+
*
|
|
359
|
+
* The emitted text follows the de-facto `robots.txt` ordering
|
|
360
|
+
* (RFC 9309 §2 + Google's published guidance):
|
|
361
|
+
*
|
|
362
|
+
* 1. Per-bot blocks for `allowedCrawlers` (deny-by-default
|
|
363
|
+
* direction) — each named bot gets its own `User-agent: <bot>`
|
|
364
|
+
* + `Allow: /` block.
|
|
365
|
+
* 2. Per-bot blocks for `disallowedCrawlers` (allow-by-default
|
|
366
|
+
* direction) — each named bot gets its own `User-agent: <bot>`
|
|
367
|
+
* + `Disallow: /` block.
|
|
368
|
+
* 3. Catch-all `User-agent: *` block carrying the site-wide
|
|
369
|
+
* `policy` (`Disallow: /` if `policy === 'noindex'` OR if
|
|
370
|
+
* `allowedCrawlers` is set, otherwise nothing) and any
|
|
371
|
+
* `disallow[]` path-prefix entries.
|
|
372
|
+
* 4. `Sitemap: <publicOrigin>/sitemap-index.xml` footer when
|
|
373
|
+
* `seo.sitemap?.enabled !== false` (defaults to `true`).
|
|
374
|
+
* `@astrojs/sitemap` emits `sitemap-index.xml` regardless of
|
|
375
|
+
* whether the site has one or many sitemap files (the index
|
|
376
|
+
* is always-present per the plugin's contract), so this is
|
|
377
|
+
* the stable URL to advertise.
|
|
378
|
+
*
|
|
379
|
+
* # Mutual-exclusion invariant
|
|
380
|
+
*
|
|
381
|
+
* `WebsiteRobotsConfigSchema.superRefine` already guarantees
|
|
382
|
+
* `allowedCrawlers` and `disallowedCrawlers` are NOT both set, so
|
|
383
|
+
* step 1 and step 2 above are mutually exclusive at the input
|
|
384
|
+
* layer. The string builder is defensive (handles both being unset)
|
|
385
|
+
* but does NOT re-validate the invariant.
|
|
386
|
+
*
|
|
387
|
+
* # Why we always emit `Sitemap:` footer when `enabled !== false`
|
|
388
|
+
*
|
|
389
|
+
* The `Sitemap:` directive is independent from any `User-agent`
|
|
390
|
+
* block — it is a top-level signal to any crawler that the site
|
|
391
|
+
* publishes a sitemap. Even when the catch-all policy is
|
|
392
|
+
* `Disallow: /` (e.g. `policy === 'noindex'`), the `Sitemap:` line
|
|
393
|
+
* stays useful: a crawler that ignores `noindex` (Bing was famous
|
|
394
|
+
* for this) at least has a single canonical URL list to consult,
|
|
395
|
+
* and human readers of `robots.txt` see the publication contract
|
|
396
|
+
* intact.
|
|
397
|
+
*
|
|
398
|
+
* # Failure modes
|
|
399
|
+
*
|
|
400
|
+
* - `siteContext.websiteConfig.publicOrigin` undefined → throws.
|
|
401
|
+
* The marketing-site origin is the SINGLE source of truth for
|
|
402
|
+
* absolute URL composition (see `WildoMarketingWebsiteConfig`
|
|
403
|
+
* JSDoc); a missing origin is a configuration error, not a
|
|
404
|
+
* silent fallback opportunity.
|
|
405
|
+
*
|
|
406
|
+
* @example
|
|
407
|
+
* ```ts
|
|
408
|
+
* // examples/<app>/website/src/pages/robots.txt.ts
|
|
409
|
+
* import type { APIRoute } from 'astro';
|
|
410
|
+
* import { renderRobotsTxt } from '@wildo-ai/saas-website/astro';
|
|
411
|
+
* import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
412
|
+
*
|
|
413
|
+
* export const GET: APIRoute = () =>
|
|
414
|
+
* new Response(renderRobotsTxt(WEBSITE_SITE_CONTEXT), {
|
|
415
|
+
* headers: { 'Content-Type': 'text/plain; charset=utf-8' },
|
|
416
|
+
* });
|
|
417
|
+
* ```
|
|
418
|
+
*/
|
|
419
|
+
export function renderRobotsTxt(siteContext: WebsiteSiteContext): string {
|
|
420
|
+
const { rootConfig, websiteConfig } = siteContext;
|
|
421
|
+
|
|
422
|
+
if (!websiteConfig.publicOrigin) {
|
|
423
|
+
throw new Error(
|
|
424
|
+
'renderRobotsTxt: WildoMarketingWebsiteConfig.publicOrigin is required to compose the absolute Sitemap: URL. Author it in your service\'s `wildo.website.config.ts`.',
|
|
425
|
+
);
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
const robots: WebsiteRobotsConfig | undefined = rootConfig.seo.robots;
|
|
429
|
+
const policy: 'index' | 'noindex' = robots?.policy ?? 'index';
|
|
430
|
+
const allowedCrawlers = robots?.allowedCrawlers ?? [];
|
|
431
|
+
const disallowedCrawlers = robots?.disallowedCrawlers ?? [];
|
|
432
|
+
const disallow = robots?.disallow ?? [];
|
|
433
|
+
|
|
434
|
+
const blocks: string[] = [];
|
|
435
|
+
|
|
436
|
+
/**
|
|
437
|
+
* Block 1 — per-bot `Allow: /` for the deny-by-default direction.
|
|
438
|
+
* Empty when `allowedCrawlers` is unset (the dominant case).
|
|
439
|
+
*/
|
|
440
|
+
for (const bot of allowedCrawlers) {
|
|
441
|
+
blocks.push(`User-agent: ${bot}\nAllow: /`);
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
/**
|
|
445
|
+
* Block 2 — per-bot `Disallow: /` for the allow-by-default
|
|
446
|
+
* direction. Empty when `disallowedCrawlers` is unset (the
|
|
447
|
+
* dominant case for a public marketing site).
|
|
448
|
+
*/
|
|
449
|
+
for (const bot of disallowedCrawlers) {
|
|
450
|
+
blocks.push(`User-agent: ${bot}\nDisallow: /`);
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
/**
|
|
454
|
+
* Block 3 — catch-all `User-agent: *`. Two policy-driven shapes:
|
|
455
|
+
* - `noindex` → `Disallow: /` (the site-wide closure).
|
|
456
|
+
* - `index` (default) → `Disallow:` is the spec-canonical "allow
|
|
457
|
+
* everything" line; combined with any per-path `Disallow: <path>`
|
|
458
|
+
* entries from `disallow[]`. When `allowedCrawlers` is set, the
|
|
459
|
+
* catch-all also closes the rest of the crawler universe with
|
|
460
|
+
* `Disallow: /` so the named bots are the ONLY ones permitted.
|
|
461
|
+
*/
|
|
462
|
+
const catchAllLines: string[] = ['User-agent: *'];
|
|
463
|
+
if (policy === 'noindex' || allowedCrawlers.length > 0) {
|
|
464
|
+
catchAllLines.push('Disallow: /');
|
|
465
|
+
} else if (disallow.length === 0) {
|
|
466
|
+
/**
|
|
467
|
+
* Spec-canonical "allow everything" — `Disallow:` with no path.
|
|
468
|
+
* Some crawlers treat the absence of any `Disallow:` line as
|
|
469
|
+
* undefined behavior; an explicit empty Disallow is the safe
|
|
470
|
+
* shape.
|
|
471
|
+
*/
|
|
472
|
+
catchAllLines.push('Disallow:');
|
|
473
|
+
}
|
|
474
|
+
for (const path of disallow) {
|
|
475
|
+
catchAllLines.push(`Disallow: ${path}`);
|
|
476
|
+
}
|
|
477
|
+
blocks.push(catchAllLines.join('\n'));
|
|
478
|
+
|
|
479
|
+
/**
|
|
480
|
+
* Block 4 — `Sitemap:` footer, advertised whenever sitemap
|
|
481
|
+
* emission is enabled (the marketing-site default). See file
|
|
482
|
+
* preamble for why we always advertise `sitemap-index.xml` as
|
|
483
|
+
* the stable URL.
|
|
484
|
+
*/
|
|
485
|
+
const sitemapEnabled = rootConfig.seo.sitemap?.enabled ?? true;
|
|
486
|
+
if (sitemapEnabled) {
|
|
487
|
+
/**
|
|
488
|
+
* Trim trailing slash on the origin to avoid emitting
|
|
489
|
+
* `https://example.com//sitemap-index.xml`. `URL` constructor
|
|
490
|
+
* is overkill for a single concat; the regex is enough.
|
|
491
|
+
*/
|
|
492
|
+
const origin = websiteConfig.publicOrigin.replace(/\/+$/, '');
|
|
493
|
+
blocks.push(`Sitemap: ${origin}/sitemap-index.xml`);
|
|
494
|
+
}
|
|
495
|
+
|
|
496
|
+
/**
|
|
497
|
+
* Spec-conformant trailing newline. Some crawler parsers tolerate
|
|
498
|
+
* its absence; emitting it is universally safe.
|
|
499
|
+
*/
|
|
500
|
+
return `${blocks.join('\n\n')}\n`;
|
|
501
|
+
}
|
|
502
|
+
```
|
|
503
|
+
|
|
504
|
+
## `enumerateMarketingPageSitemapUrls(siteContext)` — coverage helper
|
|
505
|
+
|
|
506
|
+
Pure helper that returns one entry per (`pageManifest`, `locale`)
|
|
507
|
+
pair, each carrying the absolute canonical URL plus its hreflang
|
|
508
|
+
alternates (other locales + `x-default`). The vitest-friendly
|
|
509
|
+
testable surface for "every (page × locale) URL the framework KNOWS
|
|
510
|
+
about lands in the published sitemap" — also reusable as
|
|
511
|
+
`@astrojs/sitemap`'s `customPages` input when a future surface
|
|
512
|
+
synthesizes routes outside Astro's file-based router. Excludes blog
|
|
513
|
+
post slugs (those are auto-discovered by Astro's file-based router
|
|
514
|
+
+ the sitemap plugin).
|
|
515
|
+
|
|
516
|
+
## Import Origins
|
|
517
|
+
|
|
518
|
+
- `@wildo-ai/saas-website`
|
|
519
|
+
|
|
520
|
+
## Source Excerpts
|
|
521
|
+
|
|
522
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
523
|
+
|
|
524
|
+
```typescript
|
|
525
|
+
*
|
|
526
|
+
* `enumerateMarketingPageSitemapUrls(siteContext)` — pure helper that
|
|
527
|
+
* returns every (page-manifest × locale) absolute URL the marketing
|
|
528
|
+
* site's `sitemap.xml` MUST advertise, paired with its hreflang
|
|
529
|
+
* alternates.
|
|
530
|
+
*
|
|
531
|
+
* # Why this helper exists (vs leaning entirely on `@astrojs/sitemap`)
|
|
532
|
+
*
|
|
533
|
+
* `@astrojs/sitemap` (the official Astro plugin) auto-discovers every
|
|
534
|
+
* page Astro emits and emits a `sitemap-index.xml` + sub-sitemaps at
|
|
535
|
+
* build time. That covers the dominant case (every page in
|
|
536
|
+
* `src/pages/**` ships in the sitemap). What it does NOT cover by
|
|
537
|
+
* itself:
|
|
538
|
+
*
|
|
539
|
+
* 1. **Coverage enforcement at unit-test time.** The plugin runs
|
|
540
|
+
* during `astro build`; vitest cannot exercise it without
|
|
541
|
+
* booting the full Astro pipeline. This helper is the testable
|
|
542
|
+
* surface — a regression that drops a manifest-registered route
|
|
543
|
+
* from the expected URL set fails fast in vitest, well before
|
|
544
|
+
* the `astro build` step would surface it (and even then only
|
|
545
|
+
* via end-to-end inspection of the emitted XML).
|
|
546
|
+
* 2. **Programmatic page registration.** Future framework-owned
|
|
547
|
+
* features that synthesize routes outside Astro's
|
|
548
|
+
* file-based router (e.g. data-driven landing variants) need an
|
|
549
|
+
* explicit URL list to pass into `@astrojs/sitemap`'s
|
|
550
|
+
* `customPages` config. This helper is the canonical place to
|
|
551
|
+
* compute that list — consumers spread the result into the
|
|
552
|
+
* plugin config without re-deriving the locale × route logic.
|
|
553
|
+
* 3. **Cross-check.** The same site context that drives the head
|
|
554
|
+
* renderer drives this enumeration; a divergence between
|
|
555
|
+
* "what the head renderer thinks the canonical URL set is" and
|
|
556
|
+
* "what the sitemap publishes" is a silent drift surface this
|
|
557
|
+
* helper makes auditable.
|
|
558
|
+
*
|
|
559
|
+
* # Output shape
|
|
560
|
+
*
|
|
561
|
+
* Each entry carries:
|
|
562
|
+
* - `url` — the absolute canonical URL (no trailing slash, matches
|
|
563
|
+
* `<link rel="canonical">` output of `renderWebsitePageHeadHtml`).
|
|
564
|
+
* - `pageRef` — the page-manifest `ref` (debug + grouping aid).
|
|
565
|
+
* - `routePath` — the manifest-declared `routePath` (debug + grouping aid).
|
|
566
|
+
* - `locale` — the URL's language.
|
|
567
|
+
* - `alternates` — every other locale's URL for the SAME page,
|
|
568
|
+
* emitted as `xhtml:link rel="alternate" hreflang` entries inside
|
|
569
|
+
* the sitemap (single-sitemap-with-hreflang shape, per Google's
|
|
570
|
+
* recommended sitemap format).
|
|
571
|
+
*
|
|
572
|
+
* # Routing convention (matches `buildLocalizedRoutePath`)
|
|
573
|
+
*
|
|
574
|
+
* Default locale mounts at the un-prefixed path (`/`, `/pricing`);
|
|
575
|
+
* other locales sit under `/<locale>/…`. The helper delegates to
|
|
576
|
+
* `buildLocalizedRoutePath` so a future change to the routing
|
|
577
|
+
* convention lands in one file rather than two.
|
|
578
|
+
*
|
|
579
|
+
* # What this helper does NOT enumerate
|
|
580
|
+
*
|
|
581
|
+
* - **Blog post slugs.** Blog posts share ONE page-manifest ref
|
|
582
|
+
* (`BLOG_POST_PAGE_REF`) but materialize as N URLs — one per
|
|
583
|
+
* `(slug, locale)` MDX file. The MDX file system is the
|
|
584
|
+
* source-of-truth for blog URLs, NOT the page manifest. Astro's
|
|
585
|
+
* file-based router auto-discovers each blog `[slug].astro` route
|
|
586
|
+
* and `@astrojs/sitemap` auto-publishes them. A future helper
|
|
587
|
+
* (`enumerateBlogPostSitemapUrls(...)`) can address the same
|
|
588
|
+
* coverage-enforcement gap for the blog surface specifically.
|
|
589
|
+
* - **Static `.astro` pages without a page manifest.** If a consumer
|
|
590
|
+
* authors a page directly in `src/pages/` without registering a
|
|
591
|
+
* manifest in `WebsiteRootConfig.pageManifests`, this helper will
|
|
592
|
+
* not list it (and `renderWebsitePageHeadHtml` cannot render its
|
|
593
|
+
* `<head>` either). The framework convention is "every public
|
|
594
|
+
* page has a manifest" — pages without manifests are a label-pack
|
|
595
|
+
* discipline regression and surface separately via
|
|
596
|
+
* `assertLabelPacksValid`.
|
|
597
|
+
*/
|
|
598
|
+
export interface MarketingPageSitemapEntry {
|
|
599
|
+
/** Absolute canonical URL, no trailing slash. */
|
|
600
|
+
readonly url: string;
|
|
601
|
+
/** The page-manifest `ref` (branded string in the source schema). */
|
|
602
|
+
readonly pageRef: string;
|
|
603
|
+
/** The manifest-declared `routePath` (always starts with `/`). */
|
|
604
|
+
readonly routePath: string;
|
|
605
|
+
/** The URL's language. */
|
|
606
|
+
readonly locale: AvailableLanguage;
|
|
607
|
+
/**
|
|
608
|
+
* Every OTHER locale's URL for the same page, suitable for emitting
|
|
609
|
+
* `xhtml:link rel="alternate" hreflang` entries inside the sitemap.
|
|
610
|
+
* Includes an `x-default` synthesized from the default-locale URL
|
|
611
|
+
* (Google's i18n discoverability convention; matches the head
|
|
612
|
+
* renderer's hreflang output).
|
|
613
|
+
*/
|
|
614
|
+
readonly alternates: readonly { readonly hreflang: string; readonly url: string }[];
|
|
615
|
+
}
|
|
616
|
+
|
|
617
|
+
export function enumerateMarketingPageSitemapUrls(
|
|
618
|
+
siteContext: WebsiteSiteContext,
|
|
619
|
+
): readonly MarketingPageSitemapEntry[] {
|
|
620
|
+
const { rootConfig, websiteConfig } = siteContext;
|
|
621
|
+
|
|
622
|
+
if (!websiteConfig.publicOrigin) {
|
|
623
|
+
throw new Error(
|
|
624
|
+
'enumerateMarketingPageSitemapUrls: WildoMarketingWebsiteConfig.publicOrigin is required to compose absolute sitemap URLs. Author it in your service\'s `wildo.website.config.ts`.',
|
|
625
|
+
);
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
/**
|
|
629
|
+
* Trim trailing slash defensively (the schema-level refinement
|
|
630
|
+
* already rejects them, but the helper is consumed in synthetic
|
|
631
|
+
* test contexts that bypass the parser).
|
|
632
|
+
*/
|
|
633
|
+
const origin = websiteConfig.publicOrigin.replace(/\/+$/, '');
|
|
634
|
+
const defaultLocale = websiteConfig.defaultLocale;
|
|
635
|
+
const locales: readonly AvailableLanguage[] = websiteConfig.locales.map(
|
|
636
|
+
(entry: { locale: AvailableLanguage }) => entry.locale,
|
|
637
|
+
);
|
|
638
|
+
|
|
639
|
+
const entries: MarketingPageSitemapEntry[] = [];
|
|
640
|
+
|
|
641
|
+
for (const manifest of rootConfig.pageManifests as readonly WebsitePageManifest[]) {
|
|
642
|
+
const routePath = manifest.routePath as unknown as string;
|
|
643
|
+
const pageRef = manifest.ref as unknown as string;
|
|
644
|
+
|
|
645
|
+
/**
|
|
646
|
+
* Pre-compute every locale's URL for this page once — each entry
|
|
647
|
+
* needs the full set as its `alternates` (with itself excluded
|
|
648
|
+
* later if/when the consumer wants the strict
|
|
649
|
+
* "alternates-don't-include-self" shape; today we keep the full
|
|
650
|
+
* set + add `x-default` for parity with the head renderer's
|
|
651
|
+
* hreflang output).
|
|
652
|
+
*/
|
|
653
|
+
const urlsByLocale = new Map<AvailableLanguage, string>();
|
|
654
|
+
for (const locale of locales) {
|
|
655
|
+
const localizedPath = buildLocalizedRoutePath({ locale, defaultLocale, routePath });
|
|
656
|
+
urlsByLocale.set(locale, `${origin}${localizedPath}`);
|
|
657
|
+
}
|
|
658
|
+
|
|
659
|
+
const defaultLocaleUrl = urlsByLocale.get(defaultLocale);
|
|
660
|
+
if (defaultLocaleUrl === undefined) {
|
|
661
|
+
throw new Error(
|
|
662
|
+
`enumerateMarketingPageSitemapUrls: defaultLocale "${String(defaultLocale)}" is missing from WildoMarketingWebsiteConfig.locales (page "${pageRef}"). This is a configuration invariant — locales[] must include the default locale.`,
|
|
663
|
+
);
|
|
664
|
+
}
|
|
665
|
+
|
|
666
|
+
for (const locale of locales) {
|
|
667
|
+
const url = urlsByLocale.get(locale);
|
|
668
|
+
if (url === undefined) {
|
|
669
|
+
throw new Error(
|
|
670
|
+
`enumerateMarketingPageSitemapUrls: missing computed URL for locale "${String(locale)}" on page "${pageRef}" (internal invariant violation).`,
|
|
671
|
+
);
|
|
672
|
+
}
|
|
673
|
+
|
|
674
|
+
const alternates: { hreflang: string; url: string }[] = [];
|
|
675
|
+
for (const altLocale of locales) {
|
|
676
|
+
const altUrl = urlsByLocale.get(altLocale);
|
|
677
|
+
if (altUrl !== undefined) {
|
|
678
|
+
alternates.push({ hreflang: String(altLocale), url: altUrl });
|
|
679
|
+
}
|
|
680
|
+
}
|
|
681
|
+
/**
|
|
682
|
+
* `x-default` — Google's hreflang convention for "the URL to
|
|
683
|
+
* serve when no locale signal is available". The marketing-site
|
|
684
|
+
* convention (default locale at the un-prefixed path) makes the
|
|
685
|
+
* default-locale URL the right `x-default` target.
|
|
686
|
+
*/
|
|
687
|
+
alternates.push({ hreflang: 'x-default', url: defaultLocaleUrl });
|
|
688
|
+
|
|
689
|
+
entries.push({
|
|
690
|
+
url,
|
|
691
|
+
pageRef,
|
|
692
|
+
routePath,
|
|
693
|
+
locale,
|
|
694
|
+
alternates,
|
|
695
|
+
});
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
return entries;
|
|
700
|
+
}
|
|
701
|
+
```
|
|
702
|
+
|
|
703
|
+
## `WebsiteStructuredDataPayload` — JSON-LD payload contract
|
|
704
|
+
|
|
705
|
+
The runtime JSON-LD object shape a section's `getStructuredData()`
|
|
706
|
+
returns and the installed `renderPageStructuredData()` helper
|
|
707
|
+
serializes into one `<script type="application/ld+json">` block per
|
|
708
|
+
payload. Defined in the runtime engine (NOT imported from the spec
|
|
709
|
+
layer — specs decorate runtime registries, the inverse would be a
|
|
710
|
+
circular layering). The Schema.org catalog in
|
|
711
|
+
the installed Schema.org catalog contract describes the
|
|
712
|
+
same vocabulary at the COMPANION layer; the two are structurally
|
|
713
|
+
compatible by design but defined independently.
|
|
714
|
+
|
|
715
|
+
The `@type` field is REQUIRED and typed as a free-form string (not a
|
|
716
|
+
closed enum) so app-side catalog extensions can emit custom
|
|
717
|
+
`@type`s without a saas-website release. `@id` is OPTIONAL and used
|
|
718
|
+
for renderer-side deduplication (two payloads sharing an `@id`
|
|
719
|
+
collapse to one block, last-wins). `@context` defaults to
|
|
720
|
+
`'https://schema.org'` when omitted; consumers may override.
|
|
721
|
+
|
|
722
|
+
## Import Origins
|
|
723
|
+
|
|
724
|
+
- `@wildo-ai/saas-website`
|
|
725
|
+
|
|
726
|
+
## Source Excerpts
|
|
727
|
+
|
|
728
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
729
|
+
|
|
730
|
+
```typescript
|
|
731
|
+
*
|
|
732
|
+
* `WebsiteStructuredDataPayload` — the runtime JSON-LD object shape returned
|
|
733
|
+
* by a section's `getStructuredData()` and serialized into one
|
|
734
|
+
* `<script type="application/ld+json">` block per payload.
|
|
735
|
+
*
|
|
736
|
+
* **Layering note** — the payload type is defined HERE (in the
|
|
737
|
+
* website runtime) rather than imported from the specification package because
|
|
738
|
+
* runtime rendering must remain independent from companion semantics. The
|
|
739
|
+
* application's Schema.org catalog describes the same vocabulary (per-`@type`
|
|
740
|
+
* required / optional / deprecated fields); the two contracts are structurally
|
|
741
|
+
* compatible by design but independently owned.
|
|
742
|
+
*
|
|
743
|
+
* **Authoring contract**:
|
|
744
|
+
*
|
|
745
|
+
* - `@type` REQUIRED — the Schema.org entity kind (`'Article'`,
|
|
746
|
+
* `'BlogPosting'`, `'FAQPage'`, …). Typed as a free-form `string`
|
|
747
|
+
* here (not a closed enum) so app-side catalog extensions
|
|
748
|
+
* (e.g. `'SoftwareApplication'`, custom Schema.org-extension
|
|
749
|
+
* `@type`s) are emittable without a saas-website release. The
|
|
750
|
+
* companion's catalog reconciliation surface validates the
|
|
751
|
+
* `@type` value against the merged engine + app catalog.
|
|
752
|
+
* - `@id?` OPTIONAL — a stable URI identifying the entity. Used for
|
|
753
|
+
* cross-referencing on the same page (e.g. `Article.publisher`
|
|
754
|
+
* referencing the page-level `Organization` via `@id`). The
|
|
755
|
+
* renderer uses `@id` for deduplication: two payloads with the
|
|
756
|
+
* same `@id` collapse into one emitted block (last-wins).
|
|
757
|
+
* - `@context?` OPTIONAL — the JSON-LD vocabulary URL. The renderer
|
|
758
|
+
* auto-injects `'https://schema.org'` when omitted; the field is
|
|
759
|
+
* exposed so consumers CAN override (Schema.org payload extended
|
|
760
|
+
* with a custom vocabulary).
|
|
761
|
+
* - All other fields are pass-through `unknown` — the catalog
|
|
762
|
+
* describes the FIELD NAMES per `@type`; the per-field SHAPE
|
|
763
|
+
* (e.g. `Article.author` is a `Person | Organization`) is locked
|
|
764
|
+
* at the section's payload-builder TS-side.
|
|
765
|
+
*/
|
|
766
|
+
export interface WebsiteStructuredDataPayload {
|
|
767
|
+
'@type': string;
|
|
768
|
+
'@id'?: string;
|
|
769
|
+
'@context'?: string | Record<string, unknown>;
|
|
770
|
+
[key: string]: unknown;
|
|
771
|
+
}
|
|
772
|
+
|
|
773
|
+
/**
|
|
774
|
+
* Convenience union for `getStructuredData()` return types.
|
|
775
|
+
*
|
|
776
|
+
* A section may emit:
|
|
777
|
+
* - a single payload (most common — `FAQPage` for an FAQ section);
|
|
778
|
+
* - a fixed-length tuple of payloads (e.g. pricing emits `Product +
|
|
779
|
+
* AggregateOffer` together);
|
|
780
|
+
* - `null` / `undefined` when the section has no contribution for
|
|
781
|
+
* the current state (e.g. an empty FAQ list);
|
|
782
|
+
* - an empty array (semantically equivalent to `null`; the renderer
|
|
783
|
+
* short-circuits both).
|
|
784
|
+
*/
|
|
785
|
+
export type WebsiteStructuredDataReturn =
|
|
786
|
+
| WebsiteStructuredDataPayload
|
|
787
|
+
| readonly WebsiteStructuredDataPayload[]
|
|
788
|
+
| null
|
|
789
|
+
| undefined;
|
|
790
|
+
```
|