@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,587 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-blog-authoring
|
|
3
|
+
description: Author marketing blog posts as per-locale MDX files (`src/content/blog/<locale>/<slug>.mdx`) with strict Zod-4 frontmatter validation, automatic `Article` Open Graph emission, and consumer-authored MDX tags (e.g. `<CTASection ref="post-cta" />`) bridged through `<WebsiteMdxProvider>`. Use when the user says "add a blog post", "publish an MDX article", "wire the blog adapter", "register a new MDX tag for blog posts", or "configure blog frontmatter".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website Blog Authoring
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships
|
|
21
|
+
> the entire blog rendering machinery (`<BlogPost>`,
|
|
22
|
+
> `<WebsiteMdxProvider>`, `buildBlogPostCollectionConfig(...)`,
|
|
23
|
+
> `parseBlogPostFrontmatter(...)`, `renderBlogPostHeadHtml(...)`,
|
|
24
|
+
> `createWebsiteBlogPostBridgeIsland(...)`). The consumer authors:
|
|
25
|
+
>
|
|
26
|
+
> 1. one MDX file per `(slug, locale)` pair,
|
|
27
|
+
> 2. one MDX-tag → React-component map (`BLOG_POST_MDX_COMPONENTS`),
|
|
28
|
+
> 3. one per-locale bridge module (`blog-post-<locale>.bridge.tsx`)
|
|
29
|
+
> using `import.meta.glob` to materialize the per-locale post set,
|
|
30
|
+
> 4. one per-locale `[slug].astro` shell.
|
|
31
|
+
>
|
|
32
|
+
> Every blog post in the site shares ONE reserved page ref
|
|
33
|
+
> (`BLOG_POST_PAGE_REF = 'blog-post'`) — sections / chrome / analytics
|
|
34
|
+
> see the entire blog surface as one funnel.
|
|
35
|
+
|
|
36
|
+
## Overview
|
|
37
|
+
|
|
38
|
+
A blog post in this framework is **a fully-localized MDX file**, NOT
|
|
39
|
+
a label-pack-keyed structural page (Q16=B in
|
|
40
|
+
the application website contract). Per-locale MDX is the right
|
|
41
|
+
shape because:
|
|
42
|
+
|
|
43
|
+
- blog copy is long-form and locale-divergent (forcing it through a
|
|
44
|
+
structural label-pack would either inflate the pack or fragment
|
|
45
|
+
the prose);
|
|
46
|
+
- per-post identity flows through `frontmatter.slug` + `frontmatter.locale`;
|
|
47
|
+
the same `slug` across `en/<slug>.mdx` and `fr/<slug>.mdx` denotes
|
|
48
|
+
the same post in two locales (single `hreflang` graph);
|
|
49
|
+
- inline business sections (`<CTASection>`, future newsletter / related-
|
|
50
|
+
posts strips) are bridged through `<WebsiteMdxProvider>` so they
|
|
51
|
+
can read labels and dispatch analytics like any other consumer-
|
|
52
|
+
authored section.
|
|
53
|
+
|
|
54
|
+
The framework's per-locale **bridge island** (Phase 7 D-6 Option A)
|
|
55
|
+
encapsulates the entire post tree (BlogPost + MDX body + embedded
|
|
56
|
+
sections) inside ONE React island per route. This is the structural
|
|
57
|
+
fix for Astro's React-context propagation gap (`<MDXProvider>`
|
|
58
|
+
context cannot cross an `.astro` ↔ `.tsx` boundary, even on the
|
|
59
|
+
server side).
|
|
60
|
+
|
|
61
|
+
## App Paths
|
|
62
|
+
|
|
63
|
+
The installed `@wildo-ai/saas-website` package provides the contract. Blog authoring touches
|
|
64
|
+
the consumer's website module at these paths:
|
|
65
|
+
|
|
66
|
+
| Surface | Glob (relative to app root) |
|
|
67
|
+
|---|---|
|
|
68
|
+
| Per-locale MDX bodies | `website/src/content/blog/<locale>/<slug>.mdx` |
|
|
69
|
+
| Astro content-collection registry | `website/src/content/config.ts` |
|
|
70
|
+
| MDX integration registration | `website/astro.config.ts` (registers `mdx()` BEFORE `react()`) |
|
|
71
|
+
| Per-locale bridge module | `website/src/pages-impl/blog-post-<locale>.bridge.tsx` |
|
|
72
|
+
| MDX-tag → component registry | `website/src/pages-impl/blog-post.mdx-components.tsx` |
|
|
73
|
+
| Page manifest (headless) | `website/src/pages-impl/blog-post.page.tsx` |
|
|
74
|
+
| Section definitions used inside posts | `website/src/sections/blog.sections.tsx` |
|
|
75
|
+
| Per-locale `[slug].astro` shell | `website/src/pages/blog/[slug].astro` (default locale, unprefixed) |
|
|
76
|
+
| | `website/src/pages/<other-locale>/blog/[slug].astro` |
|
|
77
|
+
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
78
|
+
|
|
79
|
+
## When to Use
|
|
80
|
+
|
|
81
|
+
- The site needs SEO-friendly, long-form, per-locale articles.
|
|
82
|
+
- Each post will be authored as MDX (Markdown + JSX) with at least
|
|
83
|
+
one consumer-authored section embeddable inline (CTA, newsletter,
|
|
84
|
+
related-posts, …).
|
|
85
|
+
- The post set per locale is small (≤ ~50 posts); the eager
|
|
86
|
+
`import.meta.glob` bundles every post into the island. Past ~50
|
|
87
|
+
posts, swap to `{ eager: false }` + `React.lazy()` (the bridge
|
|
88
|
+
factory's API is forward-compatible).
|
|
89
|
+
|
|
90
|
+
## When NOT to Use
|
|
91
|
+
|
|
92
|
+
- **Knowledge-base / docs** — use a dedicated docs surface; the blog
|
|
93
|
+
adapter is opinionated about "publication-shaped" content
|
|
94
|
+
(`Article` Open Graph, single `BLOG_POST_PAGE_REF`).
|
|
95
|
+
- **In-product help articles** — those belong inside the SaaS app,
|
|
96
|
+
not the marketing site.
|
|
97
|
+
- **Single one-off article** — over-investment; a static page
|
|
98
|
+
(`website-page-authoring`) with rich copy is simpler.
|
|
99
|
+
- **Headless-CMS-sourced posts** — out of scope per Phase 7 D-5
|
|
100
|
+
(scope minimization). The collection config helper is currently
|
|
101
|
+
filesystem-only.
|
|
102
|
+
|
|
103
|
+
## Workflow
|
|
104
|
+
|
|
105
|
+
### Step 1: Wire the MDX integration once per site
|
|
106
|
+
|
|
107
|
+
In `website/astro.config.ts`, register `@astrojs/mdx` BEFORE
|
|
108
|
+
`@astrojs/react`. Order matters — MDX must compile `.mdx` files into
|
|
109
|
+
JSX before the React integration sees them.
|
|
110
|
+
|
|
111
|
+
In `website/src/content/config.ts`, define the `blog` collection
|
|
112
|
+
using `buildBlogPostCollectionConfig({ astroZ: z })` (Path Z — the
|
|
113
|
+
collection schema is a passthrough record, the strict Zod-4
|
|
114
|
+
validation runs at render time inside `<BlogPost>`).
|
|
115
|
+
|
|
116
|
+
### Step 2: Define the headless page manifest
|
|
117
|
+
|
|
118
|
+
Author `website/src/pages-impl/blog-post.page.tsx`:
|
|
119
|
+
|
|
120
|
+
- `ref: BLOG_POST_PAGE_REF` (re-exported from `@wildo-ai/saas-website/astro-island`),
|
|
121
|
+
- `routePath: '/blog/[slug]'`,
|
|
122
|
+
- `pageComponent: BlogPostPageStub` — a stub that throws if ever
|
|
123
|
+
mounted (the framework renders `<BlogPost>` directly via the
|
|
124
|
+
bridge; the manifest's `pageComponent` exists only to satisfy the
|
|
125
|
+
schema's non-null requirement),
|
|
126
|
+
- `sectionRefs: [BLOG_POST_CTA_SECTION.sectionRef, …]` — every
|
|
127
|
+
section that may appear inside a post body,
|
|
128
|
+
- `metaLabelKeys` — placeholder keys (e.g. `website.blog-post.meta.title`)
|
|
129
|
+
so the label-pack validator passes; the blog-post head renderer
|
|
130
|
+
ignores these and reads from MDX frontmatter directly,
|
|
131
|
+
- `hydration: WebsitePageHydrationStrategy.EAGER` — paired with
|
|
132
|
+
`client:load` in the `[slug].astro` shells.
|
|
133
|
+
|
|
134
|
+
Register the manifest in `WEBSITE_ROOT_CONFIG.pageManifests`.
|
|
135
|
+
|
|
136
|
+
### Step 3: Author the embeddable sections
|
|
137
|
+
|
|
138
|
+
Drop a `BLOG_POST_*_SECTION` definition into
|
|
139
|
+
`website/src/sections/blog.sections.tsx` using the same
|
|
140
|
+
`defineWebsiteSection({ category, expectedLabelKeys, Component })`
|
|
141
|
+
shape every other section uses. Use `WebsiteSectionCategory.FOOTER_CTA`
|
|
142
|
+
(or another existing enum value that fits) — the blog dogfood does
|
|
143
|
+
NOT introduce a new category.
|
|
144
|
+
|
|
145
|
+
Append `BLOG_POST_SECTIONS` to `WEBSITE_SECTIONS` (the
|
|
146
|
+
aggregate registry the label-pack validator scans).
|
|
147
|
+
|
|
148
|
+
### Step 4: Author the MDX-tag registry
|
|
149
|
+
|
|
150
|
+
`website/src/pages-impl/blog-post.mdx-components.tsx` exports
|
|
151
|
+
`BLOG_POST_MDX_COMPONENTS: WebsiteMdxComponentsMap` — a frozen map
|
|
152
|
+
of MDX tag name (e.g. `CTASection`) → React component. Each value
|
|
153
|
+
MUST wrap its underlying section's `Component` in `<WebsiteSection
|
|
154
|
+
sectionRef={…} category={…}>` so `useWebsiteLabel(slot)` inside the
|
|
155
|
+
section can compose the absolute key from the ambient context.
|
|
156
|
+
|
|
157
|
+
### Step 5: Author the per-locale bridge modules
|
|
158
|
+
|
|
159
|
+
For each locale, `website/src/pages-impl/blog-post-<locale>.bridge.tsx`
|
|
160
|
+
exports a single `BlogPostXxBridgeIsland` built from
|
|
161
|
+
`createWebsiteBlogPostBridgeIsland({...})`. The factory closes over:
|
|
162
|
+
|
|
163
|
+
- `slugToMdxBody` — built from `import.meta.glob('../content/blog/<locale>/*.mdx', { eager: true })`
|
|
164
|
+
(the glob pattern MUST be a single string literal — Vite parses
|
|
165
|
+
it AST-side at build time);
|
|
166
|
+
- `navigation: WEBSITE_ROOT_CONFIG.navigation`;
|
|
167
|
+
- `mdxComponents: BLOG_POST_MDX_COMPONENTS`.
|
|
168
|
+
|
|
169
|
+
Per-locale separation keeps each route's island bundle tight (an FR
|
|
170
|
+
visitor never downloads EN MDX bodies).
|
|
171
|
+
|
|
172
|
+
### Step 6: Author the per-locale `[slug].astro` shells
|
|
173
|
+
|
|
174
|
+
Each shell mounts its locale's bridge island with `client:load` and
|
|
175
|
+
the per-render primitive props:
|
|
176
|
+
|
|
177
|
+
- `slug={frontmatter.slug}` — looked up against the bridge's
|
|
178
|
+
`slugToMdxBody` map at island render time;
|
|
179
|
+
- `rawFrontmatter={entry.data}` — re-validated by `<BlogPost>` on
|
|
180
|
+
the React side;
|
|
181
|
+
- `locale` / `defaultLocale` / `labelPack` / `designTokens` /
|
|
182
|
+
`skipToMainContentLabelKey` from `loadWebsitePageRuntime(...)` +
|
|
183
|
+
`WEBSITE_SITE_CONTEXT.rootConfig`.
|
|
184
|
+
|
|
185
|
+
`getStaticPaths()` reads the `blog` collection, parses each
|
|
186
|
+
entry's frontmatter (the collection schema is passthrough — Path Z),
|
|
187
|
+
filters by `frontmatter.locale === <this-locale>`, and emits
|
|
188
|
+
`{ params: { slug }, props: { entry } }` for each match.
|
|
189
|
+
|
|
190
|
+
### Step 7: Author the MDX bodies
|
|
191
|
+
|
|
192
|
+
Per-post: `website/src/content/blog/<locale>/<slug>.mdx` with the
|
|
193
|
+
required frontmatter (see structured-data contract below) and a
|
|
194
|
+
body that may embed any registered MDX tag inline:
|
|
195
|
+
|
|
196
|
+
```mdx
|
|
197
|
+
## Section heading
|
|
198
|
+
|
|
199
|
+
Body paragraph…
|
|
200
|
+
|
|
201
|
+
<CTASection ref="post-cta" />
|
|
202
|
+
|
|
203
|
+
More body paragraph…
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
The `ref="post-cta"` attribute is a documentation convention — the
|
|
207
|
+
section ref is hard-coded inside `BLOG_POST_MDX_COMPONENTS`; the
|
|
208
|
+
attribute is informational only (a future evolution could multiplex
|
|
209
|
+
variants from the prop).
|
|
210
|
+
|
|
211
|
+
### Step 8: Author the label pack entries
|
|
212
|
+
|
|
213
|
+
Add the section's `expectedLabelKeys` (and the page manifest's
|
|
214
|
+
`metaLabelKeys` placeholder keys) to every locale's
|
|
215
|
+
`website/src/i18n/<locale>.json`. The label-pack validator fails the
|
|
216
|
+
build if ANY locale is missing one of the declared keys.
|
|
217
|
+
|
|
218
|
+
## Worked Example
|
|
219
|
+
|
|
220
|
+
<!-- TIER C WAIVER: This block IS the canonical blog-adapter wiring — it shows BOTH the per-locale bridge factory call (closing over `slugToMdxBody` from a static-string-literal `import.meta.glob`, the navigation, and the MDX-tag registry) AND the matching `[slug].astro` shell (Path-Z `parseBlogPostFrontmatter` inside `getStaticPaths` for typed locale/slug access, frontmatter-driven `renderBlogPostHeadHtml`, single React island via `client:load`). The `<CTASection ref="post-cta" />` MDX tag closes the loop with `BLOG_POST_MDX_COMPONENTS`. Verification check #1 (`createWebsiteBlogPostBridgeIsland` per locale) and Common Rationalization #2 (single bridge factory call per locale) both reference this shape. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
|
|
221
|
+
```tsx
|
|
222
|
+
// website/src/pages-impl/blog-post-en.bridge.tsx
|
|
223
|
+
import type { ComponentType } from 'react';
|
|
224
|
+
|
|
225
|
+
import { createWebsiteBlogPostBridgeIsland } from '@wildo-ai/saas-website/astro-island';
|
|
226
|
+
|
|
227
|
+
import { WEBSITE_ROOT_CONFIG } from '../website-root.config';
|
|
228
|
+
import { BLOG_POST_MDX_COMPONENTS } from './blog-post.mdx-components';
|
|
229
|
+
|
|
230
|
+
const rawModules = import.meta.glob('../content/blog/en/*.mdx', {
|
|
231
|
+
eager: true,
|
|
232
|
+
}) as Record<string, { default: ComponentType<unknown> }>;
|
|
233
|
+
|
|
234
|
+
const slugToMdxBody: Record<string, ComponentType<unknown>> = {};
|
|
235
|
+
for (const [path, mod] of Object.entries(rawModules)) {
|
|
236
|
+
const filename = path.split('/').pop()!;
|
|
237
|
+
slugToMdxBody[filename.replace(/\.mdx$/, '')] = mod.default;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
export const BlogPostEnBridgeIsland = createWebsiteBlogPostBridgeIsland({
|
|
241
|
+
slugToMdxBody,
|
|
242
|
+
navigation: WEBSITE_ROOT_CONFIG.navigation,
|
|
243
|
+
mdxComponents: BLOG_POST_MDX_COMPONENTS,
|
|
244
|
+
});
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
```astro
|
|
248
|
+
---
|
|
249
|
+
// website/src/pages/blog/[slug].astro
|
|
250
|
+
import { getCollection } from 'astro:content';
|
|
251
|
+
import {
|
|
252
|
+
loadWebsitePageRuntime,
|
|
253
|
+
renderBlogPostHeadHtml,
|
|
254
|
+
renderWebsiteDesignTokensCss,
|
|
255
|
+
} from '@wildo-ai/saas-website/astro';
|
|
256
|
+
import { parseBlogPostFrontmatter } from '@wildo-ai/saas-website/mdx';
|
|
257
|
+
import { BlogPostEnBridgeIsland } from '@/pages-impl/blog-post-en.bridge';
|
|
258
|
+
import { BLOG_POST_PAGE_MANIFEST } from '@/pages-impl/blog-post.page';
|
|
259
|
+
import { WEBSITE_SITE_CONTEXT } from '@/website-site-context';
|
|
260
|
+
|
|
261
|
+
export async function getStaticPaths() {
|
|
262
|
+
const posts = await getCollection('blog');
|
|
263
|
+
const defaultLocale = WEBSITE_SITE_CONTEXT.websiteConfig.defaultLocale;
|
|
264
|
+
return posts
|
|
265
|
+
.map((post) => ({
|
|
266
|
+
post,
|
|
267
|
+
frontmatter: parseBlogPostFrontmatter(post.data, { source: post.id }),
|
|
268
|
+
}))
|
|
269
|
+
.filter(({ frontmatter }) => frontmatter.locale === defaultLocale)
|
|
270
|
+
.map(({ post, frontmatter }) => ({
|
|
271
|
+
params: { slug: frontmatter.slug as string },
|
|
272
|
+
props: { entry: post },
|
|
273
|
+
}));
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
const { entry } = Astro.props;
|
|
277
|
+
const runtime = loadWebsitePageRuntime({
|
|
278
|
+
manifest: BLOG_POST_PAGE_MANIFEST,
|
|
279
|
+
siteContext: WEBSITE_SITE_CONTEXT,
|
|
280
|
+
labelPacksDir: './src/i18n',
|
|
281
|
+
astroLocale: Astro.currentLocale,
|
|
282
|
+
});
|
|
283
|
+
const frontmatter = parseBlogPostFrontmatter(entry.data, { source: entry.id });
|
|
284
|
+
const headHtml = renderBlogPostHeadHtml({
|
|
285
|
+
siteContext: WEBSITE_SITE_CONTEXT,
|
|
286
|
+
locale: runtime.locale,
|
|
287
|
+
routePath: `/blog/${frontmatter.slug}`,
|
|
288
|
+
frontmatter,
|
|
289
|
+
});
|
|
290
|
+
const designTokensCss = renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootConfig.designTokens);
|
|
291
|
+
---
|
|
292
|
+
<!doctype html>
|
|
293
|
+
<html lang={runtime.locale}>
|
|
294
|
+
<head>
|
|
295
|
+
<meta charset="UTF-8" />
|
|
296
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
297
|
+
<Fragment set:html={headHtml} />
|
|
298
|
+
<style set:html={designTokensCss}></style>
|
|
299
|
+
</head>
|
|
300
|
+
<body>
|
|
301
|
+
<BlogPostEnBridgeIsland
|
|
302
|
+
client:load
|
|
303
|
+
slug={frontmatter.slug}
|
|
304
|
+
rawFrontmatter={entry.data}
|
|
305
|
+
source={entry.id}
|
|
306
|
+
locale={runtime.locale}
|
|
307
|
+
defaultLocale={runtime.defaultLocale}
|
|
308
|
+
labelPack={runtime.labelPack}
|
|
309
|
+
designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
|
|
310
|
+
skipToMainContentLabelKey={WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey}
|
|
311
|
+
/>
|
|
312
|
+
</body>
|
|
313
|
+
</html>
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
```mdx
|
|
317
|
+
---
|
|
318
|
+
title: Northstar Tasks enters early access
|
|
319
|
+
summary: Today we open Northstar Tasks to a small first wave of teams.
|
|
320
|
+
slug: application-launching-early-access
|
|
321
|
+
locale: en
|
|
322
|
+
publishedAt: 2026-04-15T09:00:00.000Z
|
|
323
|
+
authorRef: founding-team
|
|
324
|
+
tags:
|
|
325
|
+
- product
|
|
326
|
+
- launch
|
|
327
|
+
---
|
|
328
|
+
|
|
329
|
+
# Why we built Northstar Tasks
|
|
330
|
+
|
|
331
|
+
Most task trackers were designed for individuals first…
|
|
332
|
+
|
|
333
|
+
<CTASection ref="post-cta" />
|
|
334
|
+
|
|
335
|
+
## How to join
|
|
336
|
+
|
|
337
|
+
Early access is invite-only this quarter while we onboard each team personally.
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
## Frontmatter contract
|
|
341
|
+
|
|
342
|
+
Every post's frontmatter MUST satisfy `BlogPostFrontmatterSchema`
|
|
343
|
+
(strict Zod 4, branded slugs / author refs / tags). The fields are
|
|
344
|
+
authored as raw strings — deliberately, with no label-pack
|
|
345
|
+
indirection. The full schema is the source of truth; see the
|
|
346
|
+
references file below for the excerpt.
|
|
347
|
+
|
|
348
|
+
| Field | Required | Notes |
|
|
349
|
+
|---|---|---|
|
|
350
|
+
| `title` | ✅ | 1–200 chars. Renders into `<title>`, `og:title`, in-page `<h1>`. |
|
|
351
|
+
| `summary` | ✅ | 1–400 chars. Renders into `<meta name="description">`, `og:description`. |
|
|
352
|
+
| `slug` | ✅ | Lowercase kebab-case, ≤ 96 chars. Cross-locale identity. MUST match the filename. |
|
|
353
|
+
| `locale` | ✅ | `AvailableLanguage` enum value (e.g. `en`, `fr`). MUST match the parent directory. |
|
|
354
|
+
| `publishedAt` | ✅ | ISO-8601 date-time string. Renders into `article:published_time`. |
|
|
355
|
+
| `authorRef` | ✅ | Lowercase kebab-case, ≤ 64 chars. Free identifier (no author registry yet). |
|
|
356
|
+
| `tags` | ✅ | Array of lowercase kebab-case tags (may be empty). Renders into repeated `article:tag` lines. |
|
|
357
|
+
| `coverImageUrl` | ⛔ optional | Valid URL. Drives `og:image` + Twitter `summary_large_image` card. |
|
|
358
|
+
|
|
359
|
+
Validation runs at the top of every `<BlogPost>` render via
|
|
360
|
+
`parseBlogPostFrontmatter(entry.data, { source: entry.id })`. A
|
|
361
|
+
failure throws a `[blog-post]`-prefixed error with the offending
|
|
362
|
+
file and the failing field path.
|
|
363
|
+
|
|
364
|
+
## Structured-data contract
|
|
365
|
+
|
|
366
|
+
The blog adapter emits **`og:type=article`** + the `article:*`
|
|
367
|
+
metadata block (NOT `og:type=website`):
|
|
368
|
+
|
|
369
|
+
- `article:published_time` (from `frontmatter.publishedAt`),
|
|
370
|
+
- `article:author` (from `frontmatter.authorRef`),
|
|
371
|
+
- one `article:tag` per `frontmatter.tags[]` entry.
|
|
372
|
+
|
|
373
|
+
`article:section` is intentionally NOT emitted — the framework has
|
|
374
|
+
no blog-section taxonomy yet (a future "category" frontmatter field
|
|
375
|
+
would feed it).
|
|
376
|
+
|
|
377
|
+
JSON-LD `BlogPosting` / `Article` emission is in scope and covered
|
|
378
|
+
by the `website-seo-aeo-geo` skill. The `BlogPosting` deferral noted
|
|
379
|
+
in earlier revisions of this SKILL is REPLACED by the catalog
|
|
380
|
+
integration described below.
|
|
381
|
+
|
|
382
|
+
## Catalog integration (AEO)
|
|
383
|
+
|
|
384
|
+
Blog posts emit a `BlogPosting` payload (NOT `Article` — `Article`
|
|
385
|
+
is the engine catalog's evergreen marketing-page entry; blog posts
|
|
386
|
+
are the more specific Schema.org type and earn richer AEO results).
|
|
387
|
+
|
|
388
|
+
The `BlogPosting` `@type` is declared in the engine-shipped
|
|
389
|
+
Schema.org catalog at
|
|
390
|
+
the installed `BLOG_POSTING_CATALOG_ENTRY` contract
|
|
391
|
+
(`BLOG_POSTING_CATALOG_ENTRY`). The catalog declares:
|
|
392
|
+
|
|
393
|
+
- **Required**: `headline`, `datePublished`, `author` — all three
|
|
394
|
+
resolve from blog frontmatter (`title`, `publishedAt`,
|
|
395
|
+
`authorRef`).
|
|
396
|
+
- **Optional**: `image`, `dateModified`, `wordCount`, `keywords`,
|
|
397
|
+
`articleSection`, `inLanguage`, `publisher`, `description` —
|
|
398
|
+
`recommendOptionals: true`, so missing fields trigger
|
|
399
|
+
AEO-richness warnings (richer payloads earn richer AI citations).
|
|
400
|
+
- **Deprecated**: `dateCreated` (replaced by `datePublished`) —
|
|
401
|
+
emitting it triggers a "use `datePublished` instead" warning.
|
|
402
|
+
|
|
403
|
+
The engine wires emission through `renderBlogPostHeadHtml` (the
|
|
404
|
+
blog-post-specific page-shell renderer, sibling to
|
|
405
|
+
`renderWebsitePageHeadHtml`), which calls
|
|
406
|
+
`renderPageStructuredData()` with a single page-level `BlogPosting`
|
|
407
|
+
payload built from the post's frontmatter. The payload includes a
|
|
408
|
+
minimal inline `publisher` organization (`@type`, `name`, `url`) so
|
|
409
|
+
blog routes stand alone even when they do not emit the landing-page
|
|
410
|
+
organization graph.
|
|
411
|
+
|
|
412
|
+
**What earns its place in the blog-post emission**:
|
|
413
|
+
|
|
414
|
+
- A `BlogPosting` payload with `headline` / `datePublished` /
|
|
415
|
+
`author` (required) and `image` / `wordCount` / `keywords` /
|
|
416
|
+
`articleSection` / `inLanguage` / `dateModified` (optional but
|
|
417
|
+
recommended for AEO richness — the framework derives most of these
|
|
418
|
+
from frontmatter automatically).
|
|
419
|
+
- `publisher` as a minimal inline brand `Organization` with `name`
|
|
420
|
+
and `url`.
|
|
421
|
+
- `mainEntityOfPage` set to the post's canonical URL (resolved by
|
|
422
|
+
the framework from `BLOG_POST_PAGE_REF` + the post's slug).
|
|
423
|
+
|
|
424
|
+
**What is NOT in the blog-post emission**:
|
|
425
|
+
|
|
426
|
+
- A standalone `Organization` payload — the brand only appears inside
|
|
427
|
+
the `BlogPosting.publisher` field on blog routes.
|
|
428
|
+
- An `Article` payload — `BlogPosting` IS the more specific
|
|
429
|
+
catalog entry for blog content. `Article` is reserved for
|
|
430
|
+
evergreen marketing-page copy.
|
|
431
|
+
- Inline JSON-LD authored from MDX content — the framework owns
|
|
432
|
+
emission; MDX bodies should not include `<script
|
|
433
|
+
type="application/ld+json">` blocks (they'd duplicate or drift
|
|
434
|
+
from the framework-emitted payload).
|
|
435
|
+
- Open Graph metadata — that's a separate emission via
|
|
436
|
+
`renderBlogPostHeadHtml` (`og:type=article` etc., unchanged from
|
|
437
|
+
Phase 7).
|
|
438
|
+
|
|
439
|
+
**Verification grep** (run from the app root):
|
|
440
|
+
|
|
441
|
+
| Invariant | Command |
|
|
442
|
+
|---|---|
|
|
443
|
+
| Blog page emits structured data via the framework | `rg -n "renderBlogPostHeadHtml" website/src/pages-impl/` (must return ≥1) |
|
|
444
|
+
| No inline JSON-LD inside MDX | `rg -n "application/ld\\+json" website/src/content/blog/` (must return 0) |
|
|
445
|
+
| `dateCreated` deprecation respected | `rg -n "dateCreated" website/src/` (must return 0; use `datePublished`) |
|
|
446
|
+
|
|
447
|
+
## Contribution to `llms.txt`
|
|
448
|
+
|
|
449
|
+
Blog authoring contributes the long-form knowledge surface to the
|
|
450
|
+
hand-authored `website/src/content/llms.txt`.
|
|
451
|
+
|
|
452
|
+
- **What to author**: one blog index section (for example
|
|
453
|
+
`## Blog`) plus one markdown link line per high-signal post:
|
|
454
|
+
`[<post title>](<canonical URL>): <1 sentence summary>`.
|
|
455
|
+
- **Where it goes**: after the core site-page blocks, grouped under the
|
|
456
|
+
blog heading and optionally clustered by tag / topic when that helps
|
|
457
|
+
AI retrieval.
|
|
458
|
+
- **What earns its place**: durable insight, explicit problem framing,
|
|
459
|
+
and posts worth citation. Prefer fewer high-signal summaries over a
|
|
460
|
+
dump of every draft.
|
|
461
|
+
- **What is NOT this block**: MDX body excerpts, unpublished posts, or
|
|
462
|
+
duplicate locale variants. The file should point crawlers at the best
|
|
463
|
+
canonical post entry, not restate the article.
|
|
464
|
+
|
|
465
|
+
**Common rationalization**: "the blog sitemap already lists every post."
|
|
466
|
+
Sitemaps expose URLs; `llms.txt` adds editorial prioritization and
|
|
467
|
+
retrieval framing. Curate it intentionally.
|
|
468
|
+
|
|
469
|
+
**Verification grep** (run from the app root):
|
|
470
|
+
|
|
471
|
+
| Invariant | Command |
|
|
472
|
+
|---|---|
|
|
473
|
+
| Blog section exists in `llms.txt` | `rg -n "^## Blog$" website/src/content/llms.txt` (must return 1) |
|
|
474
|
+
| Published post URL is listed | `rg -n "\\]\\(.*/blog/<slug>\\)" website/src/content/llms.txt` (must return ≥1 for the surfaced post) |
|
|
475
|
+
|
|
476
|
+
## References
|
|
477
|
+
|
|
478
|
+
- `references/blog-adapter-api.md` — source-backed excerpts of the
|
|
479
|
+
five engine entry points (`<BlogPost>`, `<WebsiteMdxProvider>`,
|
|
480
|
+
`buildBlogPostCollectionConfig` / `parseBlogPostFrontmatter`,
|
|
481
|
+
`renderBlogPostHeadHtml`, `createWebsiteBlogPostBridgeIsland`) +
|
|
482
|
+
the frontmatter schema. Pulled via `saas.website.blog.*`
|
|
483
|
+
source-backed website contract references.
|
|
484
|
+
|
|
485
|
+
## Verification
|
|
486
|
+
|
|
487
|
+
- [ ] `mdx()` integration is registered BEFORE `react()` in
|
|
488
|
+
`astro.config.ts`.
|
|
489
|
+
- [ ] `src/content/config.ts` calls
|
|
490
|
+
`buildBlogPostCollectionConfig({ astroZ: z })` (NOT a
|
|
491
|
+
hand-mirrored Zod schema).
|
|
492
|
+
- [ ] `BLOG_POST_PAGE_MANIFEST` is registered in
|
|
493
|
+
`WEBSITE_ROOT_CONFIG.pageManifests` and uses
|
|
494
|
+
`ref: BLOG_POST_PAGE_REF` (NOT a literal `'blog-post'`).
|
|
495
|
+
- [ ] `BLOG_POST_PAGE_MANIFEST.sectionRefs` lists every section
|
|
496
|
+
`BLOG_POST_MDX_COMPONENTS` exposes.
|
|
497
|
+
- [ ] One bridge module per locale, each calling
|
|
498
|
+
`createWebsiteBlogPostBridgeIsland(...)` exactly once.
|
|
499
|
+
- [ ] Every bridge's `import.meta.glob('...content/blog/<locale>/*.mdx', { eager: true })`
|
|
500
|
+
uses a STATIC string-literal pattern (no concatenation, no
|
|
501
|
+
variable interpolation).
|
|
502
|
+
- [ ] Every `[slug].astro` shell calls `parseBlogPostFrontmatter`
|
|
503
|
+
inside `getStaticPaths` so locale/slug filtering is typed and
|
|
504
|
+
validated at build start.
|
|
505
|
+
- [ ] Every `[slug].astro` shell mounts the bridge island with
|
|
506
|
+
`client:load` (matches the manifest's
|
|
507
|
+
`WebsitePageHydrationStrategy.EAGER`).
|
|
508
|
+
- [ ] Every entry in `BLOG_POST_MDX_COMPONENTS` wraps its underlying
|
|
509
|
+
section's `Component` in `<WebsiteSection sectionRef={…}
|
|
510
|
+
category={…}>`.
|
|
511
|
+
- [ ] Every `(slug, locale)` MDX file has the same `slug` /
|
|
512
|
+
`locale` in its frontmatter as the filename / parent
|
|
513
|
+
directory.
|
|
514
|
+
- [ ] Every label key declared by an embedded section (and every
|
|
515
|
+
`metaLabelKeys` placeholder) exists in EVERY locale's
|
|
516
|
+
`i18n/<locale>.json`.
|
|
517
|
+
|
|
518
|
+
### Grep invariants
|
|
519
|
+
|
|
520
|
+
| Invariant | Command |
|
|
521
|
+
|---|---|
|
|
522
|
+
| One bridge factory call per locale | `rg -n "createWebsiteBlogPostBridgeIsland\(" website/src/pages-impl/blog-post-*.bridge.tsx \| wc -l` (must equal locale count) |
|
|
523
|
+
| Static-string-literal globs only | `rg -n "import\.meta\.glob\(" website/src/pages-impl/blog-post-*.bridge.tsx \| rg -v "'\\.\\./content/blog/[a-z-]+/\\*\\.mdx'"` (must return empty) |
|
|
524
|
+
| MDX integration ordering | `rg -n "mdx\(\)\|react\(\)" website/astro.config.ts` (the `mdx()` line must precede the `react()` line) |
|
|
525
|
+
| Page manifest registered | `rg -n "BLOG_POST_PAGE_MANIFEST" website/src/website-root.config.ts` (must return ≥1 inside `pageManifests`) |
|
|
526
|
+
| Frontmatter slug matches filename | per file: `rg -n "^slug: " website/src/content/blog/<locale>/<slug>.mdx` (the YAML `slug:` value must equal the basename) |
|
|
527
|
+
|
|
528
|
+
## Common Rationalizations
|
|
529
|
+
|
|
530
|
+
| Rationalization | Reality |
|
|
531
|
+
|---|---|
|
|
532
|
+
| "I'll author the frontmatter Zod schema directly in `src/content/config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change. Astro's bundled `z` is Zod 3 and cannot share schema instances with the engine's Zod 4 — Path Z (passthrough at the collection layer + strict Zod 4 at render time) is the deliberate single-source-of-truth posture. |
|
|
533
|
+
| "I'll use one bridge module that globs ALL locales together" | Conflates the per-route island bundle (an FR visitor downloads the EN MDX bodies for no reason) AND removes the locale-clean separation `getStaticPaths` already enforces. Per-locale bridges keep the route bundle tight + match the per-locale `[slug].astro` shell shape. |
|
|
534
|
+
| "I'll pass `mdxComponents` as an island prop instead of closing it over in the bridge factory" | The map values are `ComponentType` references — Astro's hydration boundary serializes props to JSON, and a `ComponentType` cannot survive serialization. Closing over them at module load time inside the factory is the only valid shape. |
|
|
535
|
+
| "I'll skip the page manifest — there's no React `pageComponent` to mount" | The manifest is what the label-pack validator + bridge label-scoping read. Without it, the bridge ships the FULL pack to every blog post (payload bloat) AND the section's `expectedLabelKeys` are never enforced against per-locale packs. The "headless" stub `pageComponent` is the framework-mindset cost of the schema's non-null requirement; the loud-failure error makes the contract obvious. |
|
|
536
|
+
| "I'll inline `<WebsiteSection>` inside the section's own `Component`" | Section components are props-less and read labels via leaf-relative `useWebsiteLabel(slot)` — the section ref MUST be established by an ambient `<WebsiteSection>`. The MDX-tag wrapper (in `BLOG_POST_MDX_COMPONENTS`) is where that wrapping lives, mirroring how page modules wrap each section before rendering its `Component`. |
|
|
537
|
+
| "I'll switch to lazy globs (`{ eager: false }`) right now to keep bundles small" | YAGNI for the dogfood (≤ 10 posts). The factory's API is forward-compatible with lazy globs — wait until the bundle budget actually hurts (typically past ~50 posts), then swap to `React.lazy()` + `<Suspense>`. The migration is a consumer-side change, not an engine API break. |
|
|
538
|
+
|
|
539
|
+
## Red Flags
|
|
540
|
+
|
|
541
|
+
- A blog post component that imports `~wildo-frontend-lib/**` or
|
|
542
|
+
an undeclared deep package path — the installed website package is bundle-
|
|
543
|
+
isolation-scanned. Use the framework's L1 primitives
|
|
544
|
+
(`WebsiteHeading`, `WebsiteText`, `WebsiteInternalButton`, …) or
|
|
545
|
+
override them via `website-primitive-overrides`.
|
|
546
|
+
- A `mdxComponents` map declared inline as a fresh object literal
|
|
547
|
+
per render — `<MDXProvider>`'s context value is memoized off the
|
|
548
|
+
map's identity; a per-render literal invalidates every embedded
|
|
549
|
+
section's React tree on every parent render. Always export a
|
|
550
|
+
module-scoped frozen const.
|
|
551
|
+
- Any `<MDXProvider>` import OUTSIDE
|
|
552
|
+
the installed MDX-provider contract — the
|
|
553
|
+
framework owns the upstream package boundary so the engine can
|
|
554
|
+
swap `@mdx-js/react` for an alternative without consumer churn.
|
|
555
|
+
- A `slug` field that doesn't match the MDX filename — the bridge
|
|
556
|
+
derives the lookup key from the filename; a mismatch makes the
|
|
557
|
+
post route emit but the island throws "no MDX body registered".
|
|
558
|
+
- An MDX body that embeds a tag NOT registered in
|
|
559
|
+
`BLOG_POST_MDX_COMPONENTS` — MDX falls back to the literal HTML
|
|
560
|
+
tag (e.g. `<ctasection>`), which renders nothing and silently
|
|
561
|
+
passes lint. Add the tag to the registry or remove it from the
|
|
562
|
+
body.
|
|
563
|
+
- Two posts with the same `(slug, locale)` pair — the bridge map
|
|
564
|
+
keys collide and one body silently shadows the other. Slugs are
|
|
565
|
+
unique per locale by convention.
|
|
566
|
+
|
|
567
|
+
## Related Skills
|
|
568
|
+
|
|
569
|
+
- `website-page-authoring` — composing static (non-blog) marketing
|
|
570
|
+
pages; same `defineWebsitePageManifest` shape, different rendering
|
|
571
|
+
path.
|
|
572
|
+
- `website-label-pack` — how `expectedLabelKeys` and `metaLabelKeys`
|
|
573
|
+
feed the validator + the per-locale `i18n/*.json` files.
|
|
574
|
+
- `website-section-footer-cta` — the section category most blog-post
|
|
575
|
+
CTAs adopt.
|
|
576
|
+
- `website-section-cta` — alternate category for mid-body conversion
|
|
577
|
+
bands; the choice drives the analytics signal, not the layout.
|
|
578
|
+
- `website-seo-aeo-geo` — how the framework dispatches structured
|
|
579
|
+
data; blog posts emit Open Graph `article:*` + JSON-LD
|
|
580
|
+
`BlogPosting` (see "Catalog integration (AEO)" above for the
|
|
581
|
+
catalog-driven contract).
|
|
582
|
+
- `spec-catalog-authoring` — the pattern behind the engine-shipped
|
|
583
|
+
`BLOG_POSTING_CATALOG_ENTRY` and how to author app-side catalog
|
|
584
|
+
extensions.
|
|
585
|
+
- `website-bundle-discipline` — the bundle-isolation rules the blog
|
|
586
|
+
adapter respects (no `node:*` from `mdx.ts`, allow-listed
|
|
587
|
+
`@mdx-js/react`).
|