@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
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md
ADDED
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.catalog-spec-shared
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Shared contract for every entry in the application's Schema.org JSON-LD
|
|
14
|
+
* catalog. Import the catalog declarations from `@wildo-ai/saas-specifications`
|
|
15
|
+
* and author an entry when the application emits that Schema.org type.
|
|
16
|
+
*
|
|
17
|
+
* Catalog specs are physically distinct from overlay specs (`_core/`):
|
|
18
|
+
*
|
|
19
|
+
* | Concern | Overlay specs (`_core/`) | Catalog specs (`_catalogs/`) |
|
|
20
|
+
* |---|---|---|
|
|
21
|
+
* | Describes | A registry entry the app already declares (resource, feature, view…). | An EXTERNAL vocabulary the framework reasons about (Schema.org `@type`, future OpenAPI/RSS/JSON-Feed). |
|
|
22
|
+
* | Source of truth | The runtime registry. The spec **decorates** it. | The catalog file itself. The vocabulary contract **lives** here. |
|
|
23
|
+
* | Discriminator | The registry key. | A vocabulary-native field (Schema.org: `@type`). |
|
|
24
|
+
* | App-side authoring | App authors its own overlay specs. | App authors net-new entries AND opinionated overrides (per OQ-AG8). |
|
|
25
|
+
* | Conflict behavior | App fully owns its overlays. | App entries silently override engine entries on `@type` collision; companion emits a `catalog-override` warning so the override is visible. |
|
|
26
|
+
*
|
|
27
|
+
* The catalog-spec layer is deliberately PHYSICAL (sibling sub-tree
|
|
28
|
+
* `_catalogs/` to `_core/`), not nominal — the structural honesty is
|
|
29
|
+
* enforceable by file path and future catalogs land in the same shape
|
|
30
|
+
* without a per-vocabulary authoring debate.
|
|
31
|
+
*
|
|
32
|
+
* **What the catalog describes vs. what it does NOT validate**:
|
|
33
|
+
*
|
|
34
|
+
* - The catalog DESCRIBES the vocabulary's required / optional /
|
|
35
|
+
* deprecated FIELD NAMES per `@type`. It does NOT validate the
|
|
36
|
+
* structural payload of any single section's emission — that is the
|
|
37
|
+
* section author's job (the section's `getStructuredData()` return
|
|
38
|
+
* type is locked by the consuming website/section payload schema).
|
|
39
|
+
* - The catalog DOES feed the companion's reconciliation surface so
|
|
40
|
+
* the framework can flag emission sites that miss required fields
|
|
41
|
+
* or use deprecated ones — warnings only (D-AG4), not blocking.
|
|
42
|
+
*
|
|
43
|
+
* **Discriminator strategy**: the vocabulary picks ONE field as the
|
|
44
|
+
* discriminator. For Schema.org JSON-LD, that field is `@type` (the
|
|
45
|
+
* canonical entity-kind selector). The discriminated union in the
|
|
46
|
+
* vocabulary's `index.ts` barrel keys off this field, so per-`@type`
|
|
47
|
+
* payload narrowing works at every consumer site.
|
|
48
|
+
*/
|
|
49
|
+
export const SchemaOrgEntityKindSchema: z.ZodEnum<{
|
|
50
|
+
Article: 'Article';
|
|
51
|
+
BlogPosting: 'BlogPosting';
|
|
52
|
+
FAQPage: 'FAQPage';
|
|
53
|
+
Product: 'Product';
|
|
54
|
+
Offer: 'Offer';
|
|
55
|
+
AggregateOffer: 'AggregateOffer';
|
|
56
|
+
Organization: 'Organization';
|
|
57
|
+
BreadcrumbList: 'BreadcrumbList';
|
|
58
|
+
Review: 'Review';
|
|
59
|
+
AggregateRating: 'AggregateRating';
|
|
60
|
+
WebSite: 'WebSite';
|
|
61
|
+
SoftwareApplication: 'SoftwareApplication';
|
|
62
|
+
}> = z.enum([
|
|
63
|
+
'Article',
|
|
64
|
+
'BlogPosting',
|
|
65
|
+
'FAQPage',
|
|
66
|
+
'Product',
|
|
67
|
+
'Offer',
|
|
68
|
+
'AggregateOffer',
|
|
69
|
+
'Organization',
|
|
70
|
+
'BreadcrumbList',
|
|
71
|
+
'Review',
|
|
72
|
+
'AggregateRating',
|
|
73
|
+
'WebSite',
|
|
74
|
+
/**
|
|
75
|
+
* `SoftwareApplication` is included in the engine discriminator enum
|
|
76
|
+
* so application-side catalog entries can declare
|
|
77
|
+
* `'@type': z.literal('SoftwareApplication')` without a private enum. The
|
|
78
|
+
* framework does not ship a default entry: author one only when the
|
|
79
|
+
* application genuinely describes software to search engines.
|
|
80
|
+
*/
|
|
81
|
+
'SoftwareApplication',
|
|
82
|
+
]);
|
|
83
|
+
|
|
84
|
+
export type SchemaOrgEntityKind = z.infer<typeof SchemaOrgEntityKindSchema>;
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* `SchemaOrgDeprecatedField` — one row of the per-entity deprecation
|
|
88
|
+
* ledger. The companion reconciliation surface uses this to warn on
|
|
89
|
+
* emission sites that still emit a deprecated field.
|
|
90
|
+
*
|
|
91
|
+
* - `field` — the deprecated field name (e.g. `'dateCreated'`).
|
|
92
|
+
* - `replacedBy` — the field name that supersedes it (e.g.
|
|
93
|
+
* `'datePublished'`). Use `null` if the vocabulary deprecated the
|
|
94
|
+
* field with no replacement (the warning then suggests removing
|
|
95
|
+
* the field outright).
|
|
96
|
+
* - `deprecatedSince` — vocabulary-version OR `YYYY-MM-DD` of the
|
|
97
|
+
* deprecation. Used in the companion warning text so reviewers can
|
|
98
|
+
* trace the deprecation citation.
|
|
99
|
+
*/
|
|
100
|
+
const _SchemaOrgDeprecatedFieldSchema = z.object({
|
|
101
|
+
field: z
|
|
102
|
+
.string()
|
|
103
|
+
.min(1, { error: 'SchemaOrgDeprecatedField.field must be a non-empty field name' }),
|
|
104
|
+
replacedBy: z.string().min(1).nullable(),
|
|
105
|
+
deprecatedSince: z
|
|
106
|
+
.string()
|
|
107
|
+
.min(1, {
|
|
108
|
+
error:
|
|
109
|
+
'SchemaOrgDeprecatedField.deprecatedSince must cite a vocabulary version or YYYY-MM-DD date',
|
|
110
|
+
}),
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
export const SchemaOrgDeprecatedFieldSchema: typeof _SchemaOrgDeprecatedFieldSchema =
|
|
114
|
+
_SchemaOrgDeprecatedFieldSchema;
|
|
115
|
+
|
|
116
|
+
export type SchemaOrgDeprecatedField = z.infer<typeof _SchemaOrgDeprecatedFieldSchema>;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* `SchemaOrgCatalogEntryBase` — the shared shape every entry extends
|
|
120
|
+
* via `.extend({ '@type': z.literal('<TypeName>'), ... })`.
|
|
121
|
+
*
|
|
122
|
+
* Authoring contract:
|
|
123
|
+
*
|
|
124
|
+
* - `@type` — the discriminator. Per-entity schemas narrow this from
|
|
125
|
+
* `SchemaOrgEntityKindSchema` (the enum) down to a single
|
|
126
|
+
* `z.literal('<TypeName>')` so the discriminated union in the
|
|
127
|
+
* vocabulary barrel can key off it.
|
|
128
|
+
* - `schemaOrgUrl` — canonical citation URL on schema.org (e.g.
|
|
129
|
+
* `https://schema.org/Article`). Companion renders this as a
|
|
130
|
+
* hyperlink in the per-entity context block so AI assistants can
|
|
131
|
+
* cite the spec verbatim.
|
|
132
|
+
* - `description` — ONE PARAGRAPH of opinionated framing: what the
|
|
133
|
+
* entity represents in the vocabulary's natural language, when to
|
|
134
|
+
* pick it vs sibling entities, what NOT to use it for. NOT a
|
|
135
|
+
* copy-paste of the schema.org docs (long, not opinionated). The
|
|
136
|
+
* companion uses this prose as the entity's primer in the AI
|
|
137
|
+
* assistant's catalog context block.
|
|
138
|
+
* - `developmentNotes?` — optional non-spec prose about Wildo's
|
|
139
|
+
* stance on the entity (e.g. "We use `BlogPosting` exclusively for
|
|
140
|
+
* blog content — `Article` only for evergreen marketing
|
|
141
|
+
* landing-page copy."). Distinct from `description` because it can
|
|
142
|
+
* evolve independently of the vocabulary spec.
|
|
143
|
+
* - `requiredFields` — vocabulary-required field names. Companion
|
|
144
|
+
* reconciliation FAILS (warning, per D-AG4) if missing on an
|
|
145
|
+
* emission site.
|
|
146
|
+
* - `optionalFields` — vocabulary-optional field names that yield
|
|
147
|
+
* richer AI/AEO results when present. Companion warns "consider
|
|
148
|
+
* adding for richer results" only when the catalog entry is
|
|
149
|
+
* wired with `recommendOptionals: true` (default `false` so the
|
|
150
|
+
* surface stays quiet by default).
|
|
151
|
+
* - `recommendOptionals?` — opt-IN to optional-field recommendation
|
|
152
|
+
* warnings. Default `false` (the catalog entry can be a strict
|
|
153
|
+
* "required-only" surface). Use `true` for high-value entities
|
|
154
|
+
* where richer AEO output is the goal (e.g. `BlogPosting`).
|
|
155
|
+
* - `deprecatedFields` — per-entity deprecation ledger.
|
|
156
|
+
*
|
|
157
|
+
* Authors should never bypass `.parse()` — the module-load
|
|
158
|
+
* validation is the cheapest possible signal that catches every
|
|
159
|
+
* shape drift the TypeScript compiler can't.
|
|
160
|
+
*/
|
|
161
|
+
const _SchemaOrgCatalogEntryBaseSchema = z.object({
|
|
162
|
+
'@type': SchemaOrgEntityKindSchema,
|
|
163
|
+
schemaOrgUrl: z.url({
|
|
164
|
+
error: 'SchemaOrgCatalogEntry.schemaOrgUrl must be a fully-qualified URL on schema.org',
|
|
165
|
+
}),
|
|
166
|
+
description: z
|
|
167
|
+
.string()
|
|
168
|
+
.min(1, { error: 'SchemaOrgCatalogEntry.description must be a non-empty paragraph' }),
|
|
169
|
+
developmentNotes: z.string().min(1).optional(),
|
|
170
|
+
requiredFields: z.array(z.string().min(1)).readonly(),
|
|
171
|
+
optionalFields: z.array(z.string().min(1)).readonly(),
|
|
172
|
+
recommendOptionals: z.boolean().default(false),
|
|
173
|
+
deprecatedFields: z.array(_SchemaOrgDeprecatedFieldSchema).readonly().default([]),
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
export const SchemaOrgCatalogEntryBaseSchema: typeof _SchemaOrgCatalogEntryBaseSchema =
|
|
177
|
+
_SchemaOrgCatalogEntryBaseSchema;
|
|
178
|
+
|
|
179
|
+
export type SchemaOrgCatalogEntryBase = z.infer<typeof _SchemaOrgCatalogEntryBaseSchema>;
|
|
180
|
+
```
|
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.discriminated-union
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Discriminated union of every Schema.org catalog entry shipped by the
|
|
14
|
+
* engine layer. The discriminator is `@type` (the canonical Schema.org
|
|
15
|
+
* entity-kind selector). Each variant is the entry's per-`@type`
|
|
16
|
+
* Zod schema — so `z.infer<typeof SchemaOrgCatalogEntrySchema>`
|
|
17
|
+
* narrows correctly per variant downstream.
|
|
18
|
+
*
|
|
19
|
+
* **What this union represents**: the **engine-shipped** standard
|
|
20
|
+
* vocabulary. App-side catalog extensions (e.g. Your Application'
|
|
21
|
+
* `SoftwareApplication`) live in `<app>/specifications/src/_catalogs/schema-org/`
|
|
22
|
+
* and are merged into the **app's** companion-exports
|
|
23
|
+
* `catalogSpecifications.schemaOrg` slot — they're NOT folded into
|
|
24
|
+
* this engine union (which would require the engine to know about
|
|
25
|
+
* every app's extensions, defeating the open-extension model).
|
|
26
|
+
*
|
|
27
|
+
* **App-side extension shape**: app-side entries share the same
|
|
28
|
+
* `_catalog-spec.shared.schemas.ts` contract (re-exported from the
|
|
29
|
+
* package root for app-side catalog authoring)
|
|
30
|
+
* and use `SchemaOrgEntityKindSchema` literals for net-new
|
|
31
|
+
* discriminators (e.g. `'SoftwareApplication'` is reserved in the
|
|
32
|
+
* shared enum precisely so app entries can declare it without
|
|
33
|
+
* extending the enum).
|
|
34
|
+
*
|
|
35
|
+
* **Companion reconciliation contract**: the merged catalog (engine
|
|
36
|
+
* entries + app entries) is keyed by `'@type'`. App entries silently
|
|
37
|
+
* override engine entries on collision, but the companion emits a
|
|
38
|
+
* `catalog-override` warning listing each duplicate `@type`.
|
|
39
|
+
* There is no acknowledgement/suppression field in the v1 catalog
|
|
40
|
+
* contract; duplicate entries are always visible review noise.
|
|
41
|
+
*/
|
|
42
|
+
export const SchemaOrgCatalogEntrySchema: z.ZodDiscriminatedUnion<
|
|
43
|
+
[
|
|
44
|
+
typeof ArticleCatalogEntrySchema,
|
|
45
|
+
typeof BlogPostingCatalogEntrySchema,
|
|
46
|
+
typeof FAQPageCatalogEntrySchema,
|
|
47
|
+
typeof ProductCatalogEntrySchema,
|
|
48
|
+
typeof OfferCatalogEntrySchema,
|
|
49
|
+
typeof AggregateOfferCatalogEntrySchema,
|
|
50
|
+
typeof OrganizationCatalogEntrySchema,
|
|
51
|
+
typeof BreadcrumbListCatalogEntrySchema,
|
|
52
|
+
typeof ReviewCatalogEntrySchema,
|
|
53
|
+
typeof AggregateRatingCatalogEntrySchema,
|
|
54
|
+
typeof WebSiteCatalogEntrySchema,
|
|
55
|
+
]
|
|
56
|
+
> = z.discriminatedUnion('@type', [
|
|
57
|
+
ArticleCatalogEntrySchema,
|
|
58
|
+
BlogPostingCatalogEntrySchema,
|
|
59
|
+
FAQPageCatalogEntrySchema,
|
|
60
|
+
ProductCatalogEntrySchema,
|
|
61
|
+
OfferCatalogEntrySchema,
|
|
62
|
+
AggregateOfferCatalogEntrySchema,
|
|
63
|
+
OrganizationCatalogEntrySchema,
|
|
64
|
+
BreadcrumbListCatalogEntrySchema,
|
|
65
|
+
ReviewCatalogEntrySchema,
|
|
66
|
+
AggregateRatingCatalogEntrySchema,
|
|
67
|
+
WebSiteCatalogEntrySchema,
|
|
68
|
+
]);
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Hand-written union (not a bare `z.infer<…>`) so a per-entry payload
|
|
72
|
+
* type imported in the same file (for narrowing in renderers /
|
|
73
|
+
* companion harness) doesn't drift from the union variants — adding
|
|
74
|
+
* a new entry forces a touch here AND in the discriminated-union
|
|
75
|
+
* variants array AND in the engine bundle below, all in one PR.
|
|
76
|
+
*/
|
|
77
|
+
export type SchemaOrgCatalogEntry =
|
|
78
|
+
| ArticleCatalogEntry
|
|
79
|
+
| BlogPostingCatalogEntry
|
|
80
|
+
| FAQPageCatalogEntry
|
|
81
|
+
| ProductCatalogEntry
|
|
82
|
+
| OfferCatalogEntry
|
|
83
|
+
| AggregateOfferCatalogEntry
|
|
84
|
+
| OrganizationCatalogEntry
|
|
85
|
+
| BreadcrumbListCatalogEntry
|
|
86
|
+
| ReviewCatalogEntry
|
|
87
|
+
| AggregateRatingCatalogEntry
|
|
88
|
+
| WebSiteCatalogEntry;
|
|
89
|
+
|
|
90
|
+
import { ARTICLE_CATALOG_ENTRY } from './article.catalog-spec';
|
|
91
|
+
import { BLOG_POSTING_CATALOG_ENTRY } from './blog-posting.catalog-spec';
|
|
92
|
+
import { FAQ_PAGE_CATALOG_ENTRY } from './faq-page.catalog-spec';
|
|
93
|
+
import { PRODUCT_CATALOG_ENTRY } from './product.catalog-spec';
|
|
94
|
+
import { OFFER_CATALOG_ENTRY } from './offer.catalog-spec';
|
|
95
|
+
import { AGGREGATE_OFFER_CATALOG_ENTRY } from './aggregate-offer.catalog-spec';
|
|
96
|
+
import { ORGANIZATION_CATALOG_ENTRY } from './organization.catalog-spec';
|
|
97
|
+
import { BREADCRUMB_LIST_CATALOG_ENTRY } from './breadcrumb-list.catalog-spec';
|
|
98
|
+
import { REVIEW_CATALOG_ENTRY } from './review.catalog-spec';
|
|
99
|
+
import { AGGREGATE_RATING_CATALOG_ENTRY } from './aggregate-rating.catalog-spec';
|
|
100
|
+
import { WEB_SITE_CATALOG_ENTRY } from './website.catalog-spec';
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* `ENGINE_SCHEMA_ORG_CATALOG` — the engine-shipped standard catalog
|
|
104
|
+
* as a flat array of validated entries. Apps compose their own
|
|
105
|
+
* merged catalog by spreading this constant and appending app-side
|
|
106
|
+
* entries:
|
|
107
|
+
*
|
|
108
|
+
* ```ts
|
|
109
|
+
* // <app>/specifications/src/companion-exports.ts
|
|
110
|
+
* import { ENGINE_SCHEMA_ORG_CATALOG } from '@wildo-ai/saas-specifications';
|
|
111
|
+
* import { SOFTWARE_APPLICATION_CATALOG_ENTRY } from './_catalogs/schema-org/software-application.catalog-spec';
|
|
112
|
+
*
|
|
113
|
+
* export const specificationsCompanionExports: SpecificationsCompanionExports = {
|
|
114
|
+
* // …
|
|
115
|
+
* catalogSpecifications: {
|
|
116
|
+
* schemaOrg: [...ENGINE_SCHEMA_ORG_CATALOG, SOFTWARE_APPLICATION_CATALOG_ENTRY],
|
|
117
|
+
* },
|
|
118
|
+
* };
|
|
119
|
+
* ```
|
|
120
|
+
*
|
|
121
|
+
* The engine deliberately ships the entries as an array (not as a
|
|
122
|
+
* `Record<EntityKind, Entry>`) so app-side overrides are explicit
|
|
123
|
+
* (the app spreads, picks, or replaces — no implicit deep-merge).
|
|
124
|
+
*/
|
|
125
|
+
export const ENGINE_SCHEMA_ORG_CATALOG: readonly SchemaOrgCatalogEntry[] = [
|
|
126
|
+
ARTICLE_CATALOG_ENTRY,
|
|
127
|
+
BLOG_POSTING_CATALOG_ENTRY,
|
|
128
|
+
FAQ_PAGE_CATALOG_ENTRY,
|
|
129
|
+
PRODUCT_CATALOG_ENTRY,
|
|
130
|
+
OFFER_CATALOG_ENTRY,
|
|
131
|
+
AGGREGATE_OFFER_CATALOG_ENTRY,
|
|
132
|
+
ORGANIZATION_CATALOG_ENTRY,
|
|
133
|
+
BREADCRUMB_LIST_CATALOG_ENTRY,
|
|
134
|
+
REVIEW_CATALOG_ENTRY,
|
|
135
|
+
AGGREGATE_RATING_CATALOG_ENTRY,
|
|
136
|
+
WEB_SITE_CATALOG_ENTRY,
|
|
137
|
+
] as const;
|
|
138
|
+
```
|
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-aggregate-offer
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `AggregateOffer` catalog entry — an aggregate of multiple
|
|
14
|
+
* `Offer` entries (e.g. "Plans starting at $9 / month, 4 tiers
|
|
15
|
+
* available"). The marketing-site pricing section emits this
|
|
16
|
+
* alongside `Product` whenever the page surfaces more than one plan.
|
|
17
|
+
*
|
|
18
|
+
* `lowPrice` + `priceCurrency` + `offerCount` are required so AI
|
|
19
|
+
* engines can render a meaningful "from $X" answer. `highPrice` is
|
|
20
|
+
* strongly recommended for completeness.
|
|
21
|
+
*
|
|
22
|
+
* Spec citation: https://schema.org/AggregateOffer
|
|
23
|
+
*/
|
|
24
|
+
const _AggregateOfferCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
25
|
+
'@type': z.literal('AggregateOffer'),
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
export const AggregateOfferCatalogEntrySchema: typeof _AggregateOfferCatalogEntrySchema =
|
|
29
|
+
_AggregateOfferCatalogEntrySchema;
|
|
30
|
+
|
|
31
|
+
export type AggregateOfferCatalogEntry = z.infer<typeof _AggregateOfferCatalogEntrySchema>;
|
|
32
|
+
|
|
33
|
+
export const AGGREGATE_OFFER_CATALOG_ENTRY: AggregateOfferCatalogEntry =
|
|
34
|
+
_AggregateOfferCatalogEntrySchema.parse({
|
|
35
|
+
'@type': 'AggregateOffer',
|
|
36
|
+
schemaOrgUrl: 'https://schema.org/AggregateOffer',
|
|
37
|
+
description:
|
|
38
|
+
'An aggregate of multiple `Offer` entries summarizing a price range and offer count (e.g. "Plans from $9/month, 4 tiers available"). Pair with `Product` on multi-plan pricing pages; never emit alone.',
|
|
39
|
+
developmentNotes:
|
|
40
|
+
'When wired by the pricing section, `offers[]` should reference each individual `Offer` entry. Omitting `highPrice` is allowed but materially weakens AI engine summaries.',
|
|
41
|
+
requiredFields: ['lowPrice', 'priceCurrency', 'offerCount'],
|
|
42
|
+
optionalFields: ['highPrice', 'offers', 'availability', 'url'],
|
|
43
|
+
recommendOptionals: true,
|
|
44
|
+
deprecatedFields: [],
|
|
45
|
+
});
|
|
46
|
+
```
|
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-aggregate-rating
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `AggregateRating` catalog entry — the average rating
|
|
14
|
+
* across many `Review` entries (e.g. "4.7 stars across 142 reviews").
|
|
15
|
+
* Embed inside `Product.aggregateRating` or
|
|
16
|
+
* `Organization.aggregateRating`; never emit at the top level alone.
|
|
17
|
+
*
|
|
18
|
+
* `bestRating` and `worstRating` default to 5 / 1 in the Schema.org
|
|
19
|
+
* spec, but emitting them explicitly avoids "out of what?" ambiguity
|
|
20
|
+
* in AI-engine answer summaries — hence
|
|
21
|
+
* `recommendOptionals: true`.
|
|
22
|
+
*
|
|
23
|
+
* Spec citation: https://schema.org/AggregateRating
|
|
24
|
+
*/
|
|
25
|
+
const _AggregateRatingCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
26
|
+
'@type': z.literal('AggregateRating'),
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
export const AggregateRatingCatalogEntrySchema: typeof _AggregateRatingCatalogEntrySchema =
|
|
30
|
+
_AggregateRatingCatalogEntrySchema;
|
|
31
|
+
|
|
32
|
+
export type AggregateRatingCatalogEntry = z.infer<typeof _AggregateRatingCatalogEntrySchema>;
|
|
33
|
+
|
|
34
|
+
export const AGGREGATE_RATING_CATALOG_ENTRY: AggregateRatingCatalogEntry =
|
|
35
|
+
_AggregateRatingCatalogEntrySchema.parse({
|
|
36
|
+
'@type': 'AggregateRating',
|
|
37
|
+
schemaOrgUrl: 'https://schema.org/AggregateRating',
|
|
38
|
+
description:
|
|
39
|
+
'The average rating across many `Review` entries (e.g. "4.7 stars across 142 reviews"). Embed inside `Product.aggregateRating` or `Organization.aggregateRating`; never emit at the top level alone.',
|
|
40
|
+
developmentNotes:
|
|
41
|
+
'Even though `bestRating` and `worstRating` default to 5/1 in the Schema.org spec, emit them explicitly — AI-engine answer summaries become ambiguous ("4.7 out of what?") otherwise.',
|
|
42
|
+
requiredFields: ['ratingValue', 'reviewCount'],
|
|
43
|
+
optionalFields: ['bestRating', 'worstRating', 'itemReviewed'],
|
|
44
|
+
recommendOptionals: true,
|
|
45
|
+
deprecatedFields: [],
|
|
46
|
+
});
|
|
47
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-article
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `Article` catalog entry — a written work (news, blog
|
|
14
|
+
* post, scholarly publication). Pick `BlogPosting` for blog content
|
|
15
|
+
* specifically; pick `NewsArticle` (not yet in the catalog) for
|
|
16
|
+
* date-anchored news stories. `Article` is the right pick for
|
|
17
|
+
* evergreen marketing landing-page copy that is "article-shaped"
|
|
18
|
+
* (headline + author + body) but not specifically a blog post.
|
|
19
|
+
*
|
|
20
|
+
* Spec citation: https://schema.org/Article
|
|
21
|
+
*/
|
|
22
|
+
const _ArticleCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
23
|
+
'@type': z.literal('Article'),
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
export const ArticleCatalogEntrySchema: typeof _ArticleCatalogEntrySchema =
|
|
27
|
+
_ArticleCatalogEntrySchema;
|
|
28
|
+
|
|
29
|
+
export type ArticleCatalogEntry = z.infer<typeof _ArticleCatalogEntrySchema>;
|
|
30
|
+
|
|
31
|
+
export const ARTICLE_CATALOG_ENTRY: ArticleCatalogEntry = _ArticleCatalogEntrySchema.parse({
|
|
32
|
+
'@type': 'Article',
|
|
33
|
+
schemaOrgUrl: 'https://schema.org/Article',
|
|
34
|
+
description:
|
|
35
|
+
'A written work — news, blog post, scholarly publication. Pick `BlogPosting` for blog content specifically; pick `NewsArticle` for date-anchored news. Use `Article` for evergreen, article-shaped marketing landing-page copy that is not strictly a blog post.',
|
|
36
|
+
developmentNotes:
|
|
37
|
+
'For the marketing-website blog itself, use `BlogPosting` (the engine `WebsiteMdxProvider` / `BlogPost` pipeline emits `BlogPosting` JSON-LD by default). Use `Article` only for landing-page deep-dives.',
|
|
38
|
+
requiredFields: ['headline', 'datePublished', 'author'],
|
|
39
|
+
optionalFields: ['image', 'dateModified', 'wordCount', 'inLanguage', 'publisher', 'description'],
|
|
40
|
+
recommendOptionals: false,
|
|
41
|
+
deprecatedFields: [
|
|
42
|
+
{
|
|
43
|
+
field: 'dateCreated',
|
|
44
|
+
replacedBy: 'datePublished',
|
|
45
|
+
deprecatedSince: '2017-04-13',
|
|
46
|
+
},
|
|
47
|
+
],
|
|
48
|
+
});
|
|
49
|
+
```
|
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-blog-posting
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `BlogPosting` catalog entry — a single blog entry on
|
|
14
|
+
* a blog. `BlogPosting` is a **subtype of `Article`** specialized for
|
|
15
|
+
* blog content. The marketing-site MDX/blog adapter emits `BlogPosting`
|
|
16
|
+
* JSON-LD by default for every blog post.
|
|
17
|
+
*
|
|
18
|
+
* `recommendOptionals: true` because blog posts benefit from the
|
|
19
|
+
* full optional surface (image, wordCount, inLanguage…) for AEO/GEO
|
|
20
|
+
* citation richness — answer engines extract richer summaries when
|
|
21
|
+
* these fields are present.
|
|
22
|
+
*
|
|
23
|
+
* Spec citation: https://schema.org/BlogPosting
|
|
24
|
+
*/
|
|
25
|
+
const _BlogPostingCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
26
|
+
'@type': z.literal('BlogPosting'),
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
export const BlogPostingCatalogEntrySchema: typeof _BlogPostingCatalogEntrySchema =
|
|
30
|
+
_BlogPostingCatalogEntrySchema;
|
|
31
|
+
|
|
32
|
+
export type BlogPostingCatalogEntry = z.infer<typeof _BlogPostingCatalogEntrySchema>;
|
|
33
|
+
|
|
34
|
+
export const BLOG_POSTING_CATALOG_ENTRY: BlogPostingCatalogEntry =
|
|
35
|
+
_BlogPostingCatalogEntrySchema.parse({
|
|
36
|
+
'@type': 'BlogPosting',
|
|
37
|
+
schemaOrgUrl: 'https://schema.org/BlogPosting',
|
|
38
|
+
description:
|
|
39
|
+
'A single blog entry on a blog (subtype of `Article` specialized for blog content). Use this for everything served by the marketing-site blog adapter; reserve `Article` for evergreen, non-blog landing-page deep-dives.',
|
|
40
|
+
developmentNotes:
|
|
41
|
+
'The engine `BlogPost.tsx` renderer auto-emits a `BlogPosting` JSON-LD payload for every blog post unless the section overrides it. Recommended optional fields drive AEO/GEO citation richness.',
|
|
42
|
+
requiredFields: ['headline', 'datePublished', 'author'],
|
|
43
|
+
optionalFields: [
|
|
44
|
+
'image',
|
|
45
|
+
'dateModified',
|
|
46
|
+
'wordCount',
|
|
47
|
+
'inLanguage',
|
|
48
|
+
'publisher',
|
|
49
|
+
'description',
|
|
50
|
+
'keywords',
|
|
51
|
+
'articleSection',
|
|
52
|
+
],
|
|
53
|
+
recommendOptionals: true,
|
|
54
|
+
deprecatedFields: [
|
|
55
|
+
{
|
|
56
|
+
field: 'dateCreated',
|
|
57
|
+
replacedBy: 'datePublished',
|
|
58
|
+
deprecatedSince: '2017-04-13',
|
|
59
|
+
},
|
|
60
|
+
],
|
|
61
|
+
});
|
|
62
|
+
```
|
package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-breadcrumb-list
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `BreadcrumbList` catalog entry — the navigation
|
|
14
|
+
* breadcrumb trail for a deep page. Emit on any page that is NOT
|
|
15
|
+
* the home page so search + answer engines can surface the page's
|
|
16
|
+
* position in the site hierarchy in their cited results.
|
|
17
|
+
*
|
|
18
|
+
* `itemListElement` is required and MUST be an ordered list of
|
|
19
|
+
* `ListItem` entries with `position` (1-indexed), `name`, and
|
|
20
|
+
* `item` URL.
|
|
21
|
+
*
|
|
22
|
+
* Spec citation: https://schema.org/BreadcrumbList
|
|
23
|
+
*/
|
|
24
|
+
const _BreadcrumbListCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
25
|
+
'@type': z.literal('BreadcrumbList'),
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
export const BreadcrumbListCatalogEntrySchema: typeof _BreadcrumbListCatalogEntrySchema =
|
|
29
|
+
_BreadcrumbListCatalogEntrySchema;
|
|
30
|
+
|
|
31
|
+
export type BreadcrumbListCatalogEntry = z.infer<typeof _BreadcrumbListCatalogEntrySchema>;
|
|
32
|
+
|
|
33
|
+
export const BREADCRUMB_LIST_CATALOG_ENTRY: BreadcrumbListCatalogEntry =
|
|
34
|
+
_BreadcrumbListCatalogEntrySchema.parse({
|
|
35
|
+
'@type': 'BreadcrumbList',
|
|
36
|
+
schemaOrgUrl: 'https://schema.org/BreadcrumbList',
|
|
37
|
+
description:
|
|
38
|
+
'The navigation breadcrumb trail for a deep page. Emit on every non-home page so search and answer engines can surface the page hierarchy in their cited results. `itemListElement` must be an ORDERED list of `ListItem` entries with `position` (1-indexed), `name`, `item` URL.',
|
|
39
|
+
developmentNotes:
|
|
40
|
+
'The page-shell wires this automatically when the page manifest declares a parent path. Sections do NOT need to emit it themselves; they typically get it for free.',
|
|
41
|
+
requiredFields: ['itemListElement'],
|
|
42
|
+
optionalFields: [],
|
|
43
|
+
recommendOptionals: false,
|
|
44
|
+
deprecatedFields: [],
|
|
45
|
+
});
|
|
46
|
+
```
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-faq-page
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `FAQPage` catalog entry — a page presenting a list of
|
|
14
|
+
* questions and matching answers. Picked by the marketing-website
|
|
15
|
+
* FAQ section category for ANY page surfacing a Q+A list (sales FAQ,
|
|
16
|
+
* support FAQ, pricing FAQ).
|
|
17
|
+
*
|
|
18
|
+
* `mainEntity` is required and MUST be a list of `Question` entities,
|
|
19
|
+
* each carrying an `acceptedAnswer` `Answer` entity. The catalog
|
|
20
|
+
* intentionally does NOT carry sub-entries for `Question` / `Answer`
|
|
21
|
+
* (their shape is locked at the section's payload-schema level — the
|
|
22
|
+
* FAQ section ships a typed `Question[]` contract).
|
|
23
|
+
*
|
|
24
|
+
* `recommendOptionals: true` because `inLanguage` + `dateModified`
|
|
25
|
+
* help AI engines surface the page when locale-specific answers
|
|
26
|
+
* matter or freshness is a tie-breaker.
|
|
27
|
+
*
|
|
28
|
+
* Spec citation: https://schema.org/FAQPage
|
|
29
|
+
*/
|
|
30
|
+
const _FAQPageCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
31
|
+
'@type': z.literal('FAQPage'),
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
export const FAQPageCatalogEntrySchema: typeof _FAQPageCatalogEntrySchema =
|
|
35
|
+
_FAQPageCatalogEntrySchema;
|
|
36
|
+
|
|
37
|
+
export type FAQPageCatalogEntry = z.infer<typeof _FAQPageCatalogEntrySchema>;
|
|
38
|
+
|
|
39
|
+
export const FAQ_PAGE_CATALOG_ENTRY: FAQPageCatalogEntry = _FAQPageCatalogEntrySchema.parse({
|
|
40
|
+
'@type': 'FAQPage',
|
|
41
|
+
schemaOrgUrl: 'https://schema.org/FAQPage',
|
|
42
|
+
description:
|
|
43
|
+
'A page presenting a list of questions and matching answers. Each item under `mainEntity` is a `Question` carrying an `acceptedAnswer`. Use this for any marketing page whose primary content is a Q+A list (sales FAQ, support FAQ, pricing FAQ).',
|
|
44
|
+
developmentNotes:
|
|
45
|
+
'The FAQ section category emits this `@type` automatically when wired with `getStructuredData()`. The per-question shape (`Question` + `acceptedAnswer`) is locked at the section payload schema level, not the catalog level.',
|
|
46
|
+
requiredFields: ['mainEntity'],
|
|
47
|
+
optionalFields: ['inLanguage', 'dateModified', 'description'],
|
|
48
|
+
recommendOptionals: true,
|
|
49
|
+
deprecatedFields: [],
|
|
50
|
+
});
|
|
51
|
+
```
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# saas.specifications.catalogs.schema-org.entity-offer
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Schema.org `Offer` catalog entry — a single offer to provide a
|
|
14
|
+
* `Product` / `Service` for a specified price. Use a stand-alone
|
|
15
|
+
* `Offer` for single-price products (one plan, one tier). For
|
|
16
|
+
* multi-plan pricing pages, prefer `AggregateOffer` (priceRange +
|
|
17
|
+
* offerCount), which references this entity via its
|
|
18
|
+
* `offers[]` field.
|
|
19
|
+
*
|
|
20
|
+
* `availability` is recommended when the offer can be sold-out /
|
|
21
|
+
* pre-order — answer engines surface availability in their cited
|
|
22
|
+
* answer summaries when present.
|
|
23
|
+
*
|
|
24
|
+
* Spec citation: https://schema.org/Offer
|
|
25
|
+
*/
|
|
26
|
+
const _OfferCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
27
|
+
'@type': z.literal('Offer'),
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
export const OfferCatalogEntrySchema: typeof _OfferCatalogEntrySchema = _OfferCatalogEntrySchema;
|
|
31
|
+
|
|
32
|
+
export type OfferCatalogEntry = z.infer<typeof _OfferCatalogEntrySchema>;
|
|
33
|
+
|
|
34
|
+
export const OFFER_CATALOG_ENTRY: OfferCatalogEntry = _OfferCatalogEntrySchema.parse({
|
|
35
|
+
'@type': 'Offer',
|
|
36
|
+
schemaOrgUrl: 'https://schema.org/Offer',
|
|
37
|
+
description:
|
|
38
|
+
'A single offer to provide a `Product` or `Service` for a specified price. Use stand-alone for single-price products; use `AggregateOffer` for multi-plan pricing pages whose `offers[]` array references multiple `Offer` entries.',
|
|
39
|
+
developmentNotes:
|
|
40
|
+
'Always pair `price` with `priceCurrency` — emitting one without the other yields an invalid offer that AI engines silently drop from their citation index.',
|
|
41
|
+
requiredFields: ['price', 'priceCurrency'],
|
|
42
|
+
optionalFields: ['availability', 'url', 'validFrom', 'validThrough', 'priceValidUntil', 'name'],
|
|
43
|
+
recommendOptionals: false,
|
|
44
|
+
deprecatedFields: [],
|
|
45
|
+
});
|
|
46
|
+
```
|