@wildo-ai/framework-knowledge 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,726 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-catalog-authoring
|
|
3
|
+
description: Author a "catalog spec" entry — a Zod-validated application extension to an installed catalog vocabulary such as Schema.org JSON-LD. Catalog specs describe **external vocabularies** the framework reasons about (Schema.org `@type`s today; OpenAPI OperationObjects, JSON-Feed entries, RSS items tomorrow) — distinct from overlay specs, which add application prose, config and code-handling. Use when the user says "add a Schema.org type", "register a JSON-LD vocabulary entry", "extend the catalog with a custom @type", "ship a new vocabulary entry the framework should validate", or "the catalog reconciliation warns on a missing @type".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec Catalog Authoring
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Author a **catalog spec** — a single Zod-validated entry that describes
|
|
23
|
+
one external-vocabulary entity (e.g. `Schema.org/Article`, `Schema.org/FAQPage`,
|
|
24
|
+
a future `OpenAPI/OperationObject`) so that:
|
|
25
|
+
|
|
26
|
+
1. **Installed consumers** (today: the website package's
|
|
27
|
+
`getStructuredData()` plumbing for JSON-LD; future: any consumer of
|
|
28
|
+
the same vocabulary) get a **typed, autocomplete-rich, validated**
|
|
29
|
+
contract for every emission site.
|
|
30
|
+
2. **The dev companion** can render per-entity context blocks
|
|
31
|
+
(descriptions, examples, deprecated-fields tables, citation links)
|
|
32
|
+
so AI assistants and reviewers reason about the vocabulary the same
|
|
33
|
+
way humans do.
|
|
34
|
+
3. **A single reconciliation surface** (the companion's structured-data
|
|
35
|
+
harness, exposed verbatim at `wildo website audit`) validates every
|
|
36
|
+
emission site against the catalog with one consistent set of
|
|
37
|
+
warnings.
|
|
38
|
+
|
|
39
|
+
Catalog specs are **distinct from overlay specs** in two ways:
|
|
40
|
+
|
|
41
|
+
| Concern | Overlay specs (`_core/`) | Catalog specs (`_catalogs/`) |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| **What they describe** | A registry entry the app already declares (a resource, a feature, a composite view…) — they overlay it with prose, config, code handling. | An **external vocabulary** the framework reasons about (Schema.org `@type`, an RFC entity shape…) — they own the contract themselves. |
|
|
44
|
+
| **Source of truth** | The runtime registry (`R.TASKS`, `F.NOTIFICATIONS`, `CV.TASK_DASHBOARD`). The spec **decorates** it. | The catalog file itself. The vocabulary contract **lives** here. |
|
|
45
|
+
| **Discriminator** | The registry key. | A vocabulary-native field (Schema.org: `@type`; OpenAPI: `operationId`…). |
|
|
46
|
+
| **App can author its own?** | Yes — every app authors its own overlay specs. | Yes, **and** the app can author **extensions** that augment or override engine-shipped catalog entries (per OQ-AG8). |
|
|
47
|
+
| **Companion behavior on conflict** | Apps fully own their overlays (no engine vs app conflict possible). | App entries override engine entries silently in the merged catalog; the companion emits a `catalog-override` warning so the override is visible. |
|
|
48
|
+
|
|
49
|
+
The catalog-spec layer is deliberately **physical, not nominal** — it
|
|
50
|
+
lives in a sibling sub-tree (`_catalogs/`) to `_core/` so the structural
|
|
51
|
+
honesty is enforceable by file path (no `_core/x/y/_catalogs/` smuggling)
|
|
52
|
+
and so future catalogs land in the same shape without a per-vocabulary
|
|
53
|
+
authoring debate.
|
|
54
|
+
|
|
55
|
+
This skill teaches the **application extension pattern**. The installed
|
|
56
|
+
Schema.org catalog is consumed through `WebsiteSectionDefinition.getStructuredData?`.
|
|
57
|
+
|
|
58
|
+
## App Paths
|
|
59
|
+
|
|
60
|
+
| Surface | Glob (relative to repo root) |
|
|
61
|
+
|---|---|
|
|
62
|
+
| Installed catalog vocabulary | declared catalog contract (for example Schema.org) |
|
|
63
|
+
| Installed shared contract | source-backed reference: discriminator + base shape every entry conforms to |
|
|
64
|
+
| Application catalog extension root | `specifications/src/_catalogs/<vocabulary>/` |
|
|
65
|
+
| Application catalog extension entry | `specifications/src/_catalogs/<vocabulary>/<entry-name>.catalog-spec.ts` |
|
|
66
|
+
| Application companion-exports surface | `specifications/src/companion-exports.ts` — `CatalogSpecifications` slot |
|
|
67
|
+
| App catalog companion-exports surface | `<app>/specifications/src/companion-exports.ts` — `catalogSpecifications` slot per vocabulary |
|
|
68
|
+
|
|
69
|
+
## When to Use
|
|
70
|
+
|
|
71
|
+
- Adding an application extension to the installed catalog because a section
|
|
72
|
+
emits a Schema.org `@type` not yet covered by the installed contract.
|
|
73
|
+
- Adding an **app-side extension** to an engine catalog because the
|
|
74
|
+
app's domain needs an entity the engine standard layer doesn't ship
|
|
75
|
+
(for example, an application's `SoftwareApplication` for its marketing site —
|
|
76
|
+
domain-specific, not general enough for the engine surface).
|
|
77
|
+
- Adding a new vocabulary altogether (a brand-new sibling to
|
|
78
|
+
`schema-org/` — e.g. `_catalogs/openapi/`). Read this skill **and**
|
|
79
|
+
the cross-reference to `spec-companion-exports` before opening a PR;
|
|
80
|
+
a new vocabulary means a new `companion-exports.ts` slot, a new
|
|
81
|
+
reconciliation surface, and the discriminator decision (`@type`
|
|
82
|
+
vs `operationId` vs `kind`).
|
|
83
|
+
- Deprecating a field on an existing catalog entry (e.g. Schema.org
|
|
84
|
+
`Article.dateCreated` → use `datePublished`). Document via the
|
|
85
|
+
catalog entry's `deprecatedFields[]` — the companion reconciliation
|
|
86
|
+
surface will warn on emission sites that still use the field.
|
|
87
|
+
|
|
88
|
+
## When NOT to Use
|
|
89
|
+
|
|
90
|
+
- Authoring a runtime resource / feature / view spec → use the
|
|
91
|
+
appropriate `spec_*` skill (`spec-resource-update`,
|
|
92
|
+
`spec-feature-update`, `spec-composite-view-update`,
|
|
93
|
+
`spec-component-update`, `spec-family-update`). Catalog specs do
|
|
94
|
+
NOT decorate registry entries.
|
|
95
|
+
- Wiring the catalog-spec into the companion exports surface →
|
|
96
|
+
[`spec-companion-exports`](../spec-companion-exports/SKILL.md)
|
|
97
|
+
covers the typed `CatalogSpecifications` slot.
|
|
98
|
+
- Authoring the **section that emits** a Schema.org payload → the
|
|
99
|
+
per-section SKILL (e.g. `website-section-faq`,
|
|
100
|
+
`website-section-pricing`) walks the `getStructuredData()` worked
|
|
101
|
+
example. This skill describes the **catalog**, not the emitter.
|
|
102
|
+
- Building the reconciliation harness itself → framework-maintenance work, not
|
|
103
|
+
app-side authoring. Once the harness is in place, app-side authors
|
|
104
|
+
consume it; they do not modify it.
|
|
105
|
+
|
|
106
|
+
## The Catalog-Spec Contract
|
|
107
|
+
|
|
108
|
+
Every entry in a vocabulary's `_catalogs/<vocabulary>/` folder
|
|
109
|
+
conforms to a **shared contract** defined once per vocabulary in
|
|
110
|
+
`_catalog-spec.shared.schemas.ts`. The contract has three required
|
|
111
|
+
shapes:
|
|
112
|
+
|
|
113
|
+
### Shape 1 — Discriminator + identity
|
|
114
|
+
|
|
115
|
+
The vocabulary picks a single discriminator field. For Schema.org
|
|
116
|
+
JSON-LD, the discriminator is `@type` (a string literal per entry).
|
|
117
|
+
|
|
118
|
+
<!-- TIER C WAIVER: illustrative contract-shape for the _catalog-spec.shared base (discriminator enum + base object) teaching "the three required shapes", not a verbatim engine export to anchor. -->
|
|
119
|
+
```ts
|
|
120
|
+
const SchemaOrgEntityKindSchema = z.enum([
|
|
121
|
+
'Article',
|
|
122
|
+
'BlogPosting',
|
|
123
|
+
'FAQPage',
|
|
124
|
+
'Product',
|
|
125
|
+
'Offer',
|
|
126
|
+
'AggregateOffer',
|
|
127
|
+
'Organization',
|
|
128
|
+
'BreadcrumbList',
|
|
129
|
+
'Review',
|
|
130
|
+
'AggregateRating',
|
|
131
|
+
'WebSite',
|
|
132
|
+
'SoftwareApplication',
|
|
133
|
+
]);
|
|
134
|
+
|
|
135
|
+
export const SchemaOrgCatalogEntryBaseSchema = z.object({
|
|
136
|
+
'@type': SchemaOrgEntityKindSchema,
|
|
137
|
+
schemaOrgUrl: z.string().url(),
|
|
138
|
+
description: z.string().min(1),
|
|
139
|
+
developmentNotes: z.string().min(1).optional(),
|
|
140
|
+
requiredFields: z.array(z.string()).readonly(),
|
|
141
|
+
optionalFields: z.array(z.string()).readonly(),
|
|
142
|
+
deprecatedFields: z.array(SchemaOrgDeprecatedFieldSchema).readonly(),
|
|
143
|
+
recommendOptionals: z.boolean().default(false),
|
|
144
|
+
});
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
The discriminator is **the identity** — companion reconciliation
|
|
148
|
+
matches an emission site's payload against the catalog by
|
|
149
|
+
`@type`-equivalent lookup, and the merged engine + app catalog is
|
|
150
|
+
indexed by discriminator (so app overrides land at the same key).
|
|
151
|
+
|
|
152
|
+
### Shape 2 — Field declarations (required + optional + deprecated)
|
|
153
|
+
|
|
154
|
+
Each entry declares its fields explicitly with three flavors:
|
|
155
|
+
|
|
156
|
+
| Flavor | What it means | Companion behavior |
|
|
157
|
+
|---|---|---|
|
|
158
|
+
| **Required** | Vocabulary spec REQUIRES the field for a valid entity. | Reconciliation FAILS (warning, per D-AG4) if missing on an emission site. |
|
|
159
|
+
| **Optional** | Vocabulary spec ALLOWS the field; richer results when present. | Reconciliation warns "field missing — consider adding for richer AI/AEO results" only when the entry is wired with `recommendOptionals: true`. |
|
|
160
|
+
| **Deprecated** | Vocabulary spec USED TO have the field; replaced by another. | Reconciliation FAILS with a "use `<replacement>` instead" warning when the field appears on an emission site. |
|
|
161
|
+
|
|
162
|
+
<!-- spec-cite: N/A — "Vocabulary spec" above is the schema.org vocabulary as modelled by THIS catalog, and the quoted fragments are the companion's own warning strings shown as examples. No external standard is quoted. -->
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
<!-- TIER C WAIVER: illustrative field-declaration shape (required/optional/deprecated flavors) for the Shape-2 contract; a teaching template, not a verbatim engine export. -->
|
|
166
|
+
```ts
|
|
167
|
+
export const ArticleCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
168
|
+
'@type': z.literal('Article'),
|
|
169
|
+
requiredFields: z.array(z.string()).default(['headline', 'datePublished', 'author']),
|
|
170
|
+
optionalFields: z.array(z.string()).default(['image', 'dateModified', 'wordCount', 'inLanguage']),
|
|
171
|
+
deprecatedFields: z.array(z.object({
|
|
172
|
+
field: z.string(),
|
|
173
|
+
replacedBy: z.string().nullable(),
|
|
174
|
+
deprecatedSince: z.string().describe('vocabulary version or YYYY-MM-DD'),
|
|
175
|
+
})).default([]),
|
|
176
|
+
});
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
Fields are declared as **string lists** (not Zod sub-schemas) because
|
|
180
|
+
the catalog's job is to **describe** the vocabulary, not to validate
|
|
181
|
+
arbitrary nested payloads. The actual section-side payload validation
|
|
182
|
+
happens at the section's `getStructuredData()` return-type level (the
|
|
183
|
+
section author writes a typed function returning the right shape — the
|
|
184
|
+
type system catches structural mistakes; the catalog catches
|
|
185
|
+
vocabulary-level drift).
|
|
186
|
+
|
|
187
|
+
### Shape 3 — Companion narrative (description + citation)
|
|
188
|
+
|
|
189
|
+
Every catalog entry carries enough prose for the companion to render
|
|
190
|
+
a useful per-entity context block:
|
|
191
|
+
|
|
192
|
+
- `description`: one paragraph explaining what the entity represents
|
|
193
|
+
in the vocabulary's natural language (e.g. "An `Article` is a
|
|
194
|
+
written work — news, blog post, scholarly publication. Use
|
|
195
|
+
`BlogPosting` for blog content specifically; `NewsArticle` for
|
|
196
|
+
news.").
|
|
197
|
+
- `schemaOrgUrl`: canonical citation URL (e.g.
|
|
198
|
+
`https://schema.org/Article`). The companion renders this as a
|
|
199
|
+
hyperlink in the entity's context block.
|
|
200
|
+
- `developmentNotes?`: optional non-spec prose about Wildo's stance
|
|
201
|
+
on the entity (e.g. "We use `BlogPosting` exclusively for blog
|
|
202
|
+
content — `Article` only for evergreen marketing landing-page
|
|
203
|
+
copy.").
|
|
204
|
+
|
|
205
|
+
## Engine vs App Authoring
|
|
206
|
+
|
|
207
|
+
### Engine catalog entries (standard vocabulary)
|
|
208
|
+
|
|
209
|
+
Engine catalog entries describe the **standard, vendor-neutral** part
|
|
210
|
+
of the vocabulary — the entries every Wildo-built website / app /
|
|
211
|
+
service can use without adopting a domain-specific extension.
|
|
212
|
+
|
|
213
|
+
For Schema.org, this is the canonical set of `@type`s every consumer
|
|
214
|
+
likely needs: `Article`, `BlogPosting`, `FAQPage`, `Product`, `Offer`,
|
|
215
|
+
`AggregateOffer`, `Organization`, `BreadcrumbList`, `Review`,
|
|
216
|
+
`AggregateRating`, `WebSite`. Adding a new entry to this engine layer
|
|
217
|
+
is appropriate when:
|
|
218
|
+
|
|
219
|
+
- The `@type` is in Schema.org's core vocabulary (not an
|
|
220
|
+
extension-only or pending-spec entity).
|
|
221
|
+
- At least two consuming app shapes plausibly emit it (otherwise it's
|
|
222
|
+
a domain-specific extension — author it on the app side).
|
|
223
|
+
- The required + optional + deprecated field declarations track the
|
|
224
|
+
current Schema.org documentation (link the spec URL in
|
|
225
|
+
`schemaOrgUrl`).
|
|
226
|
+
|
|
227
|
+
### App catalog extensions (domain-specific entries + overrides)
|
|
228
|
+
|
|
229
|
+
App-side catalog entries do **two** things:
|
|
230
|
+
|
|
231
|
+
1. **Net-new entries** — `@type`s the engine layer doesn't ship
|
|
232
|
+
because they're domain-specific. An application, for example, may ship
|
|
233
|
+
`SoftwareApplication` for its marketing site (the engine layer
|
|
234
|
+
doesn't include it because most Wildo apps aren't software
|
|
235
|
+
products). The entry shape is identical to engine entries (same
|
|
236
|
+
discriminator, same field-flavor declarations) — it just lives in
|
|
237
|
+
the app's `_catalogs/schema-org/` instead of the engine's.
|
|
238
|
+
|
|
239
|
+
2. **Overrides of engine entries** — the same `@type` re-declared on
|
|
240
|
+
the app side with adjusted required / optional / deprecated lists.
|
|
241
|
+
This is the mechanism for app-specific stances on a standard
|
|
242
|
+
vocabulary (e.g. "for our domain, `Product.gtin` is required even
|
|
243
|
+
though Schema.org marks it optional").
|
|
244
|
+
|
|
245
|
+
The merged catalog uses **structural override** (app silently wins
|
|
246
|
+
on `@type` collision) — but the reconciliation surface emits a
|
|
247
|
+
**`catalog-override` warning** listing every duplicate `@type`, so
|
|
248
|
+
the override is visible. There is no acknowledgement/suppression
|
|
249
|
+
field in the catalog contract today; remove the duplicate or keep
|
|
250
|
+
the warning as an intentional review signal.
|
|
251
|
+
|
|
252
|
+
## Workflow
|
|
253
|
+
|
|
254
|
+
### Step 1: Decide engine vs app
|
|
255
|
+
|
|
256
|
+
Walk the criteria above. Engine is the default for standard-vocabulary
|
|
257
|
+
entries; app for domain-specific entries and overrides. If unsure,
|
|
258
|
+
default to **app**: it's easier to promote an app entry to the engine
|
|
259
|
+
layer later than to demote an engine entry that turned out to be
|
|
260
|
+
app-specific.
|
|
261
|
+
|
|
262
|
+
### Step 2: Confirm the vocabulary's shared contract exists
|
|
263
|
+
|
|
264
|
+
Open `_catalogs/<vocabulary>/_catalog-spec.shared.schemas.ts`.
|
|
265
|
+
Verify:
|
|
266
|
+
|
|
267
|
+
- The discriminator field name (`@type` for Schema.org;
|
|
268
|
+
`operationId` for a future OpenAPI catalog…).
|
|
269
|
+
- The discriminator's enum / literal list — adding a new framework entry
|
|
270
|
+
requires extending this enum **and** wiring the
|
|
271
|
+
new file in the barrel (Step 5).
|
|
272
|
+
- The base entry shape (`*CatalogEntryBaseSchema`) — the new entry's
|
|
273
|
+
schema must `.extend()` it (so cross-entry concerns like
|
|
274
|
+
`description` / `schemaOrgUrl` stay uniform).
|
|
275
|
+
|
|
276
|
+
If the vocabulary doesn't exist yet (you're adding the first
|
|
277
|
+
`_catalogs/<new-vocabulary>/`), this skill's scope ends — read
|
|
278
|
+
`spec-companion-exports` for the new typed slot and open an
|
|
279
|
+
engine-level PR for the new vocabulary's contract before authoring
|
|
280
|
+
entries.
|
|
281
|
+
|
|
282
|
+
### Step 3: Author the entry file
|
|
283
|
+
|
|
284
|
+
Create `<entry-name>.catalog-spec.ts` co-located in the vocabulary
|
|
285
|
+
folder:
|
|
286
|
+
|
|
287
|
+
<!-- TIER C WAIVER: authoring template for the <entry-name>.catalog-spec.ts file the developer writes (placeholder name, parse-validated-constant pattern); a scaffold, not engine code to anchor. -->
|
|
288
|
+
```ts
|
|
289
|
+
import { z } from 'zod';
|
|
290
|
+
import { SchemaOrgCatalogEntryBaseSchema } from './_catalog-spec.shared.schemas';
|
|
291
|
+
|
|
292
|
+
export const ArticleCatalogEntrySchema = SchemaOrgCatalogEntryBaseSchema.extend({
|
|
293
|
+
'@type': z.literal('Article'),
|
|
294
|
+
requiredFields: z.array(z.string()).default(['headline', 'datePublished', 'author']),
|
|
295
|
+
optionalFields: z.array(z.string()).default([
|
|
296
|
+
'image', 'dateModified', 'wordCount', 'inLanguage',
|
|
297
|
+
]),
|
|
298
|
+
deprecatedFields: z.array(z.object({
|
|
299
|
+
field: z.string(),
|
|
300
|
+
replacedBy: z.string().nullable(),
|
|
301
|
+
deprecatedSince: z.string(),
|
|
302
|
+
})).default([]),
|
|
303
|
+
});
|
|
304
|
+
|
|
305
|
+
export type ArticleCatalogEntry = z.infer<typeof ArticleCatalogEntrySchema>;
|
|
306
|
+
|
|
307
|
+
export const ARTICLE_CATALOG_ENTRY: ArticleCatalogEntry = ArticleCatalogEntrySchema.parse({
|
|
308
|
+
'@type': 'Article',
|
|
309
|
+
schemaOrgUrl: 'https://schema.org/Article',
|
|
310
|
+
description: 'An Article is a written work — news, blog post, scholarly publication. Use BlogPosting for blog content specifically; NewsArticle for news.',
|
|
311
|
+
requiredFields: ['headline', 'datePublished', 'author'],
|
|
312
|
+
optionalFields: ['image', 'dateModified', 'wordCount', 'inLanguage'],
|
|
313
|
+
recommendOptionals: false,
|
|
314
|
+
deprecatedFields: [],
|
|
315
|
+
});
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
The key invariants:
|
|
319
|
+
|
|
320
|
+
- The schema **`.extend()`s** the shared base — never re-declares
|
|
321
|
+
`description` / `schemaOrgUrl`.
|
|
322
|
+
- The exported value is a **`*CatalogEntrySchema.parse(...)`-validated
|
|
323
|
+
constant** — the validation at module-load catches typos that the
|
|
324
|
+
TypeScript compiler can't (e.g. `requiredFields: 'headline'` instead
|
|
325
|
+
of `['headline']` parses as a string-array failure at module load,
|
|
326
|
+
not a silent runtime bug at companion reconciliation).
|
|
327
|
+
- The discriminator is a `z.literal('<TypeName>')` — narrowing the
|
|
328
|
+
base schema's `@type: SchemaOrgEntityKindSchema` (the enum) down to
|
|
329
|
+
the single literal for this entry.
|
|
330
|
+
|
|
331
|
+
### Step 4: Add the entry to the vocabulary's barrel
|
|
332
|
+
|
|
333
|
+
Open the vocabulary folder's `index.ts`. Append the entry to the
|
|
334
|
+
discriminated union:
|
|
335
|
+
|
|
336
|
+
<!-- TIER C WAIVER: authoring template for the vocabulary barrel's discriminated union (with "… all other entries …" elisions); a scaffold filled per vocabulary, not a verbatim export. -->
|
|
337
|
+
```ts
|
|
338
|
+
export * from './article.catalog-spec';
|
|
339
|
+
export * from './blog-posting.catalog-spec';
|
|
340
|
+
// … all other entries …
|
|
341
|
+
|
|
342
|
+
import { ArticleCatalogEntrySchema } from './article.catalog-spec';
|
|
343
|
+
import { BlogPostingCatalogEntrySchema } from './blog-posting.catalog-spec';
|
|
344
|
+
// … all other entries …
|
|
345
|
+
|
|
346
|
+
export const SchemaOrgCatalogEntrySchema = z.discriminatedUnion('@type', [
|
|
347
|
+
ArticleCatalogEntrySchema,
|
|
348
|
+
BlogPostingCatalogEntrySchema,
|
|
349
|
+
// … all other entries …
|
|
350
|
+
]);
|
|
351
|
+
|
|
352
|
+
export type SchemaOrgCatalogEntry = z.infer<typeof SchemaOrgCatalogEntrySchema>;
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
The discriminated union is the **typed surface every consumer reads**
|
|
356
|
+
— the installed website contract uses `SchemaOrgCatalogEntry` as the return
|
|
357
|
+
type's vocabulary contract; the companion reconciliation surface
|
|
358
|
+
matches emission-site `@type` values against the union's
|
|
359
|
+
discriminator.
|
|
360
|
+
|
|
361
|
+
### Step 5: Wire the entry into companion exports
|
|
362
|
+
|
|
363
|
+
Companion-exports gets a `catalogSpecifications` slot per vocabulary.
|
|
364
|
+
For engine catalogs:
|
|
365
|
+
|
|
366
|
+
<!-- TIER C WAIVER: illustrative companion-exports slot shape (catalogSpecifications) with elided sibling slots; a teaching excerpt of the interface, not the verbatim file to anchor. -->
|
|
367
|
+
```ts
|
|
368
|
+
// specifications/src/companion-exports.ts
|
|
369
|
+
export interface SpecificationsCompanionExports<…> {
|
|
370
|
+
// … existing slots …
|
|
371
|
+
catalogSpecifications?: {
|
|
372
|
+
schemaOrg?: readonly SchemaOrgCatalogEntryBase[];
|
|
373
|
+
};
|
|
374
|
+
}
|
|
375
|
+
```
|
|
376
|
+
|
|
377
|
+
For app catalogs:
|
|
378
|
+
|
|
379
|
+
<!-- TIER C WAIVER: authoring template for the app's companion-exports catalogSpecifications wiring (placeholder <app> path, illustrative entry list); a scaffold, not verbatim app code. -->
|
|
380
|
+
```ts
|
|
381
|
+
// <app>/specifications/src/companion-exports.ts
|
|
382
|
+
export const specificationsCompanionExports: SpecificationsCompanionExports = {
|
|
383
|
+
// … existing slots …
|
|
384
|
+
catalogSpecifications: {
|
|
385
|
+
schemaOrg: [
|
|
386
|
+
ENGINE_ARTICLE_CATALOG_ENTRY,
|
|
387
|
+
ENGINE_BLOG_POSTING_CATALOG_ENTRY,
|
|
388
|
+
// … all engine entries the app consumes …
|
|
389
|
+
APP_SOFTWARE_APPLICATION_CATALOG_ENTRY, // app-only
|
|
390
|
+
APP_PRODUCT_CATALOG_ENTRY, // override of engine Product
|
|
391
|
+
],
|
|
392
|
+
},
|
|
393
|
+
};
|
|
394
|
+
```
|
|
395
|
+
|
|
396
|
+
The **app** is the single source of truth for what the merged catalog
|
|
397
|
+
contains — the engine ships its entries as importable constants but
|
|
398
|
+
does NOT auto-merge them. This keeps the surface explicit (the app
|
|
399
|
+
sees, in one place, every `@type` it consumes) and lets the override
|
|
400
|
+
mechanism work without ambiguity.
|
|
401
|
+
|
|
402
|
+
### Step 6: Verify the companion reconciliation surface is green
|
|
403
|
+
|
|
404
|
+
Boot the dev companion (`wildo dev:start` resumes the watcher) and
|
|
405
|
+
confirm:
|
|
406
|
+
|
|
407
|
+
- New engine entry → companion's catalog-context block lists it; no
|
|
408
|
+
`catalog-miss` warnings on emission sites that already targeted it.
|
|
409
|
+
- New app entry → same, plus (if the entry is an override) a
|
|
410
|
+
`catalog-override` warning at boot listing the `@type`'s engine and
|
|
411
|
+
app side-by-side.
|
|
412
|
+
- Deprecated field → companion emits a warning on every emission site
|
|
413
|
+
that still uses the deprecated field.
|
|
414
|
+
|
|
415
|
+
The same validation runs from the CLI via `wildo website audit` —
|
|
416
|
+
identical output format, identical severity.
|
|
417
|
+
|
|
418
|
+
## Worked Example
|
|
419
|
+
|
|
420
|
+
The installed Schema.org catalog supplies the baseline contract. The canonical
|
|
421
|
+
application entry lives in the application catalog extension:
|
|
422
|
+
|
|
423
|
+
## Import Origins
|
|
424
|
+
|
|
425
|
+
- `@wildo-ai/saas-specifications`
|
|
426
|
+
|
|
427
|
+
## Source Excerpts
|
|
428
|
+
|
|
429
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
430
|
+
|
|
431
|
+
```typescript
|
|
432
|
+
*
|
|
433
|
+
* Shared contract for every entry in the application's Schema.org JSON-LD
|
|
434
|
+
* catalog. Import the catalog declarations from `@wildo-ai/saas-specifications`
|
|
435
|
+
* and author an entry when the application emits that Schema.org type.
|
|
436
|
+
*
|
|
437
|
+
* Catalog specs are physically distinct from overlay specs (`_core/`):
|
|
438
|
+
*
|
|
439
|
+
* | Concern | Overlay specs (`_core/`) | Catalog specs (`_catalogs/`) |
|
|
440
|
+
* |---|---|---|
|
|
441
|
+
* | 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). |
|
|
442
|
+
* | Source of truth | The runtime registry. The spec **decorates** it. | The catalog file itself. The vocabulary contract **lives** here. |
|
|
443
|
+
* | Discriminator | The registry key. | A vocabulary-native field (Schema.org: `@type`). |
|
|
444
|
+
* | App-side authoring | App authors its own overlay specs. | App authors net-new entries AND opinionated overrides (per OQ-AG8). |
|
|
445
|
+
* | 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. |
|
|
446
|
+
*
|
|
447
|
+
* The catalog-spec layer is deliberately PHYSICAL (sibling sub-tree
|
|
448
|
+
* `_catalogs/` to `_core/`), not nominal — the structural honesty is
|
|
449
|
+
* enforceable by file path and future catalogs land in the same shape
|
|
450
|
+
* without a per-vocabulary authoring debate.
|
|
451
|
+
*
|
|
452
|
+
* **What the catalog describes vs. what it does NOT validate**:
|
|
453
|
+
*
|
|
454
|
+
* - The catalog DESCRIBES the vocabulary's required / optional /
|
|
455
|
+
* deprecated FIELD NAMES per `@type`. It does NOT validate the
|
|
456
|
+
* structural payload of any single section's emission — that is the
|
|
457
|
+
* section author's job (the section's `getStructuredData()` return
|
|
458
|
+
* type is locked by the consuming website/section payload schema).
|
|
459
|
+
* - The catalog DOES feed the companion's reconciliation surface so
|
|
460
|
+
* the framework can flag emission sites that miss required fields
|
|
461
|
+
* or use deprecated ones — warnings only (D-AG4), not blocking.
|
|
462
|
+
*
|
|
463
|
+
* **Discriminator strategy**: the vocabulary picks ONE field as the
|
|
464
|
+
* discriminator. For Schema.org JSON-LD, that field is `@type` (the
|
|
465
|
+
* canonical entity-kind selector). The discriminated union in the
|
|
466
|
+
* vocabulary's `index.ts` barrel keys off this field, so per-`@type`
|
|
467
|
+
* payload narrowing works at every consumer site.
|
|
468
|
+
*/
|
|
469
|
+
export const SchemaOrgEntityKindSchema: z.ZodEnum<{
|
|
470
|
+
Article: 'Article';
|
|
471
|
+
BlogPosting: 'BlogPosting';
|
|
472
|
+
FAQPage: 'FAQPage';
|
|
473
|
+
Product: 'Product';
|
|
474
|
+
Offer: 'Offer';
|
|
475
|
+
AggregateOffer: 'AggregateOffer';
|
|
476
|
+
Organization: 'Organization';
|
|
477
|
+
BreadcrumbList: 'BreadcrumbList';
|
|
478
|
+
Review: 'Review';
|
|
479
|
+
AggregateRating: 'AggregateRating';
|
|
480
|
+
WebSite: 'WebSite';
|
|
481
|
+
SoftwareApplication: 'SoftwareApplication';
|
|
482
|
+
}> = z.enum([
|
|
483
|
+
'Article',
|
|
484
|
+
'BlogPosting',
|
|
485
|
+
'FAQPage',
|
|
486
|
+
'Product',
|
|
487
|
+
'Offer',
|
|
488
|
+
'AggregateOffer',
|
|
489
|
+
'Organization',
|
|
490
|
+
'BreadcrumbList',
|
|
491
|
+
'Review',
|
|
492
|
+
'AggregateRating',
|
|
493
|
+
'WebSite',
|
|
494
|
+
/**
|
|
495
|
+
* `SoftwareApplication` is included in the engine discriminator enum
|
|
496
|
+
* so application-side catalog entries can declare
|
|
497
|
+
* `'@type': z.literal('SoftwareApplication')` without a private enum. The
|
|
498
|
+
* framework does not ship a default entry: author one only when the
|
|
499
|
+
* application genuinely describes software to search engines.
|
|
500
|
+
*/
|
|
501
|
+
'SoftwareApplication',
|
|
502
|
+
]);
|
|
503
|
+
|
|
504
|
+
export type SchemaOrgEntityKind = z.infer<typeof SchemaOrgEntityKindSchema>;
|
|
505
|
+
|
|
506
|
+
/**
|
|
507
|
+
* `SchemaOrgDeprecatedField` — one row of the per-entity deprecation
|
|
508
|
+
* ledger. The companion reconciliation surface uses this to warn on
|
|
509
|
+
* emission sites that still emit a deprecated field.
|
|
510
|
+
*
|
|
511
|
+
* - `field` — the deprecated field name (e.g. `'dateCreated'`).
|
|
512
|
+
* - `replacedBy` — the field name that supersedes it (e.g.
|
|
513
|
+
* `'datePublished'`). Use `null` if the vocabulary deprecated the
|
|
514
|
+
* field with no replacement (the warning then suggests removing
|
|
515
|
+
* the field outright).
|
|
516
|
+
* - `deprecatedSince` — vocabulary-version OR `YYYY-MM-DD` of the
|
|
517
|
+
* deprecation. Used in the companion warning text so reviewers can
|
|
518
|
+
* trace the deprecation citation.
|
|
519
|
+
*/
|
|
520
|
+
const _SchemaOrgDeprecatedFieldSchema = z.object({
|
|
521
|
+
field: z
|
|
522
|
+
.string()
|
|
523
|
+
.min(1, { error: 'SchemaOrgDeprecatedField.field must be a non-empty field name' }),
|
|
524
|
+
replacedBy: z.string().min(1).nullable(),
|
|
525
|
+
deprecatedSince: z
|
|
526
|
+
.string()
|
|
527
|
+
.min(1, {
|
|
528
|
+
error:
|
|
529
|
+
'SchemaOrgDeprecatedField.deprecatedSince must cite a vocabulary version or YYYY-MM-DD date',
|
|
530
|
+
}),
|
|
531
|
+
});
|
|
532
|
+
|
|
533
|
+
export const SchemaOrgDeprecatedFieldSchema: typeof _SchemaOrgDeprecatedFieldSchema =
|
|
534
|
+
_SchemaOrgDeprecatedFieldSchema;
|
|
535
|
+
|
|
536
|
+
export type SchemaOrgDeprecatedField = z.infer<typeof _SchemaOrgDeprecatedFieldSchema>;
|
|
537
|
+
|
|
538
|
+
/**
|
|
539
|
+
* `SchemaOrgCatalogEntryBase` — the shared shape every entry extends
|
|
540
|
+
* via `.extend({ '@type': z.literal('<TypeName>'), ... })`.
|
|
541
|
+
*
|
|
542
|
+
* Authoring contract:
|
|
543
|
+
*
|
|
544
|
+
* - `@type` — the discriminator. Per-entity schemas narrow this from
|
|
545
|
+
* `SchemaOrgEntityKindSchema` (the enum) down to a single
|
|
546
|
+
* `z.literal('<TypeName>')` so the discriminated union in the
|
|
547
|
+
* vocabulary barrel can key off it.
|
|
548
|
+
* - `schemaOrgUrl` — canonical citation URL on schema.org (e.g.
|
|
549
|
+
* `https://schema.org/Article`). Companion renders this as a
|
|
550
|
+
* hyperlink in the per-entity context block so AI assistants can
|
|
551
|
+
* cite the spec verbatim.
|
|
552
|
+
* - `description` — ONE PARAGRAPH of opinionated framing: what the
|
|
553
|
+
* entity represents in the vocabulary's natural language, when to
|
|
554
|
+
* pick it vs sibling entities, what NOT to use it for. NOT a
|
|
555
|
+
* copy-paste of the schema.org docs (long, not opinionated). The
|
|
556
|
+
* companion uses this prose as the entity's primer in the AI
|
|
557
|
+
* assistant's catalog context block.
|
|
558
|
+
* - `developmentNotes?` — optional non-spec prose about Wildo's
|
|
559
|
+
* stance on the entity (e.g. "We use `BlogPosting` exclusively for
|
|
560
|
+
* blog content — `Article` only for evergreen marketing
|
|
561
|
+
* landing-page copy."). Distinct from `description` because it can
|
|
562
|
+
* evolve independently of the vocabulary spec.
|
|
563
|
+
* - `requiredFields` — vocabulary-required field names. Companion
|
|
564
|
+
* reconciliation FAILS (warning, per D-AG4) if missing on an
|
|
565
|
+
* emission site.
|
|
566
|
+
* - `optionalFields` — vocabulary-optional field names that yield
|
|
567
|
+
* richer AI/AEO results when present. Companion warns "consider
|
|
568
|
+
* adding for richer results" only when the catalog entry is
|
|
569
|
+
* wired with `recommendOptionals: true` (default `false` so the
|
|
570
|
+
* surface stays quiet by default).
|
|
571
|
+
* - `recommendOptionals?` — opt-IN to optional-field recommendation
|
|
572
|
+
* warnings. Default `false` (the catalog entry can be a strict
|
|
573
|
+
* "required-only" surface). Use `true` for high-value entities
|
|
574
|
+
* where richer AEO output is the goal (e.g. `BlogPosting`).
|
|
575
|
+
* - `deprecatedFields` — per-entity deprecation ledger.
|
|
576
|
+
*
|
|
577
|
+
* Authors should never bypass `.parse()` — the module-load
|
|
578
|
+
* validation is the cheapest possible signal that catches every
|
|
579
|
+
* shape drift the TypeScript compiler can't.
|
|
580
|
+
*/
|
|
581
|
+
const _SchemaOrgCatalogEntryBaseSchema = z.object({
|
|
582
|
+
'@type': SchemaOrgEntityKindSchema,
|
|
583
|
+
schemaOrgUrl: z.url({
|
|
584
|
+
error: 'SchemaOrgCatalogEntry.schemaOrgUrl must be a fully-qualified URL on schema.org',
|
|
585
|
+
}),
|
|
586
|
+
description: z
|
|
587
|
+
.string()
|
|
588
|
+
.min(1, { error: 'SchemaOrgCatalogEntry.description must be a non-empty paragraph' }),
|
|
589
|
+
developmentNotes: z.string().min(1).optional(),
|
|
590
|
+
requiredFields: z.array(z.string().min(1)).readonly(),
|
|
591
|
+
optionalFields: z.array(z.string().min(1)).readonly(),
|
|
592
|
+
recommendOptionals: z.boolean().default(false),
|
|
593
|
+
deprecatedFields: z.array(_SchemaOrgDeprecatedFieldSchema).readonly().default([]),
|
|
594
|
+
});
|
|
595
|
+
|
|
596
|
+
export const SchemaOrgCatalogEntryBaseSchema: typeof _SchemaOrgCatalogEntryBaseSchema =
|
|
597
|
+
_SchemaOrgCatalogEntryBaseSchema;
|
|
598
|
+
|
|
599
|
+
export type SchemaOrgCatalogEntryBase = z.infer<typeof _SchemaOrgCatalogEntryBaseSchema>;
|
|
600
|
+
```
|
|
601
|
+
|
|
602
|
+
And the canonical app-side extension (an application's
|
|
603
|
+
`SoftwareApplication` for its marketing site) lives at
|
|
604
|
+
`specifications/src/_catalogs/schema-org/software-application.catalog-spec.ts`.
|
|
605
|
+
|
|
606
|
+
What earns its place in this block:
|
|
607
|
+
|
|
608
|
+
- **Engine entry shape, app entry shape, and the merged
|
|
609
|
+
`catalogSpecifications.schemaOrg` slot** — together they prove the
|
|
610
|
+
full pattern (engine ships standard vocabulary; app extends with
|
|
611
|
+
domain-specific entries and overrides; both flow through the same
|
|
612
|
+
companion-exports slot).
|
|
613
|
+
- **A deprecated field example** — Schema.org's `Article.dateCreated`
|
|
614
|
+
marked replaced by `datePublished`. The deprecation appears in the
|
|
615
|
+
catalog file, not in the section's emission code, because that's
|
|
616
|
+
where the vocabulary contract lives.
|
|
617
|
+
|
|
618
|
+
What is **not** in this block (and shouldn't be):
|
|
619
|
+
|
|
620
|
+
- No section-side `getStructuredData()` example — the per-section
|
|
621
|
+
worked examples live in the section SKILLs (`website-section-faq`,
|
|
622
|
+
`website-section-pricing`, etc.), not here. This skill describes
|
|
623
|
+
the catalog, not the consumers.
|
|
624
|
+
- No companion reconciliation harness internals — the harness's
|
|
625
|
+
contract (input: emission site payloads + merged catalog;
|
|
626
|
+
output: warnings) is documented in
|
|
627
|
+
[`website-seo-aeo-geo`](../website-seo-aeo-geo/SKILL.md)'s
|
|
628
|
+
references; the harness's implementation is engine-level.
|
|
629
|
+
- No `wildo website audit` CLI flag inventory — the CLI re-surface
|
|
630
|
+
documentation lives in the same place as the harness contract.
|
|
631
|
+
|
|
632
|
+
## References
|
|
633
|
+
|
|
634
|
+
- (Step 1 deliverable) `references/catalog-spec-pattern-overview.md` —
|
|
635
|
+
the catalog-spec pattern overview anchored against the Schema.org
|
|
636
|
+
catalog's shared contract once shipped.
|
|
637
|
+
|
|
638
|
+
## Verification
|
|
639
|
+
|
|
640
|
+
- [ ] Application catalog extension folder exists at
|
|
641
|
+
`specifications/src/_catalogs/<vocabulary>/`.
|
|
642
|
+
- [ ] Entry file follows `<entry-name>.catalog-spec.ts` naming.
|
|
643
|
+
- [ ] Entry schema `.extend()`s the vocabulary's shared base
|
|
644
|
+
(`<Vocabulary>CatalogEntryBaseSchema`).
|
|
645
|
+
- [ ] Entry exports both the schema constant and the
|
|
646
|
+
`*CatalogEntrySchema.parse(...)`-validated value constant.
|
|
647
|
+
- [ ] Discriminator (`@type` for Schema.org) is declared as
|
|
648
|
+
`z.literal('<EntryName>')` narrowing the base enum.
|
|
649
|
+
- [ ] Vocabulary barrel's discriminated union includes the new entry.
|
|
650
|
+
- [ ] Engine catalog discriminator enum (`SchemaOrgEntityKindSchema`)
|
|
651
|
+
includes the new entry's discriminator value (engine entries only).
|
|
652
|
+
- [ ] App `companion-exports.ts` lists the new entry on the
|
|
653
|
+
`catalogSpecifications.<vocabulary>` slot (app entries only).
|
|
654
|
+
- [ ] Companion reconciliation runs green (no `catalog-miss`,
|
|
655
|
+
no unexpected `catalog-override` warnings) — verify via
|
|
656
|
+
`wildo website audit` OR companion log on `wildo dev:start`.
|
|
657
|
+
|
|
658
|
+
### Grep invariants
|
|
659
|
+
|
|
660
|
+
Run from the repo root:
|
|
661
|
+
|
|
662
|
+
| Invariant | Command |
|
|
663
|
+
|---|---|
|
|
664
|
+
| Application vocabulary folder exists | `ls specifications/src/_catalogs/<vocabulary>/` |
|
|
665
|
+
| Entry follows naming convention | `rg -l 'CatalogEntrySchema' specifications/src/_catalogs/<vocabulary>/` |
|
|
666
|
+
| Entry schema `.extend()`s the shared base | `rg -n 'CatalogEntryBaseSchema.extend' specifications/src/_catalogs/<vocabulary>/` |
|
|
667
|
+
| Entry export uses `.parse()` for module-load validation | `rg -n 'CatalogEntrySchema.parse' specifications/src/_catalogs/<vocabulary>/` |
|
|
668
|
+
| Application barrel discriminated union mentions the new entry | `rg -n 'discriminatedUnion' specifications/src/_catalogs/<vocabulary>/index.ts` |
|
|
669
|
+
| App companion-exports wires the catalog slot | `rg -n 'catalogSpecifications' <app>/specifications/src/companion-exports.ts` |
|
|
670
|
+
|
|
671
|
+
## Common Rationalizations
|
|
672
|
+
|
|
673
|
+
| Rationalization | Reality |
|
|
674
|
+
|---|---|
|
|
675
|
+
| "I'll just inline the `@type` validation in my section's `getStructuredData()`." | The section sees only its own emission. The catalog's job is to be the **single source of truth** for what every emission site reasons about — without it, every section author drifts on their own. The catalog also feeds the companion's per-entity context block; an inline section-level shape teaches the AI assistant nothing reusable. |
|
|
676
|
+
| "App-side override should be a deep-merge with the engine entry, not a structural override." | Deep-merge looks helpful but quietly hides the override (the merged shape isn't either entry). Structural override + the `catalog-override` warning makes the choice **visible**. Deep-merge optimizes for least-typing, override+warn optimizes for least-surprise. |
|
|
677
|
+
| "I'll skip the `.parse()` at module load — TypeScript catches the shape." | TypeScript catches **structural** errors. The `.parse()` catches everything Zod knows about the shape — non-empty strings, URL formats on `schemaOrgUrl`, enum membership for the discriminator. Module-load fail-loud is the cheapest possible signal — strictly better than a silent runtime drift. |
|
|
678
|
+
| "I don't need the `description` — the field name is self-explanatory." | The companion renders this prose into the AI assistant's per-entity context. A missing `description` doesn't break the build, but it makes the AI's narrative about the entity hollow ("the Article entity is for articles…") — the vocabulary citation + a one-paragraph framing is the minimum useful prose. |
|
|
679
|
+
| "I'll add the deprecated field directly to my section's emission as a TODO comment." | The deprecation lives at the **vocabulary** level, not the **emission** level. Putting it in the catalog means every section gets the warning automatically; putting it in one section's comment hides it from the next section author who repeats the mistake. |
|
|
680
|
+
|
|
681
|
+
## Red Flags
|
|
682
|
+
|
|
683
|
+
- New `_catalogs/<vocabulary>/` folder created without a matching
|
|
684
|
+
`_catalog-spec.shared.schemas.ts` (the contract is the FIRST file —
|
|
685
|
+
every entry depends on it).
|
|
686
|
+
- Entry file declares its `@type` discriminator value but the
|
|
687
|
+
vocabulary's shared discriminator enum doesn't include it
|
|
688
|
+
(companion's discriminated-union parse fails at module load).
|
|
689
|
+
- Entry exported as a **plain object literal** without
|
|
690
|
+
`*CatalogEntrySchema.parse(...)` — bypasses the module-load
|
|
691
|
+
validation that catches every shape drift.
|
|
692
|
+
- App catalog entry overrides an engine entry unintentionally — the
|
|
693
|
+
`catalog-override` warning should either be accepted as deliberate
|
|
694
|
+
review noise or removed by deleting the duplicate entry.
|
|
695
|
+
- Catalog entry's `requiredFields[]` includes a field the vocabulary
|
|
696
|
+
spec actually marks optional (the catalog will then flag every
|
|
697
|
+
emission site that omits it — false-positive warnings drown the
|
|
698
|
+
signal).
|
|
699
|
+
- Catalog entry's `description` is a copy-paste of the
|
|
700
|
+
Schema.org docs page (long, not opinionated). The description
|
|
701
|
+
should be **one paragraph of opinionated framing** — what this
|
|
702
|
+
entity is, when to pick it vs sibling entities, what NOT to use
|
|
703
|
+
it for.
|
|
704
|
+
- Section author edits a catalog entry to "make my section pass" —
|
|
705
|
+
the catalog should match the **vocabulary**, not the section. If
|
|
706
|
+
a section's emission disagrees with the catalog, fix the section
|
|
707
|
+
(or, if the vocabulary actually disagrees with the catalog, fix
|
|
708
|
+
the catalog with a citation in the commit message).
|
|
709
|
+
|
|
710
|
+
## Related Skills
|
|
711
|
+
|
|
712
|
+
- [`spec-companion-exports`](../spec-companion-exports/SKILL.md) —
|
|
713
|
+
the typed `catalogSpecifications.<vocabulary>` slot in
|
|
714
|
+
`companion-exports.ts`. Catalog specs flow through the same
|
|
715
|
+
contract as overlay specs; this skill walks the typed-contract
|
|
716
|
+
shape end-to-end.
|
|
717
|
+
- [`website-seo-aeo-geo`](../website-seo-aeo-geo/SKILL.md) — the
|
|
718
|
+
primary consumer surface of the Schema.org catalog. Every
|
|
719
|
+
per-section SKILL (`website-section-faq`, `website-section-pricing`,
|
|
720
|
+
etc.) emits structured data validated against this catalog.
|
|
721
|
+
- `spec-resource-update` / `spec-feature-update` /
|
|
722
|
+
`spec-composite-view-update` / `spec-component-update` — the
|
|
723
|
+
**overlay** spec authoring family (decorating registry entries with
|
|
724
|
+
prose + config + code-handling). Catalog specs are the **other**
|
|
725
|
+
spec family — distinct sub-tree, distinct discriminator strategy,
|
|
726
|
+
distinct companion behavior.
|