@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,376 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-factory-advanced
|
|
3
|
+
description: Use the narrow advanced website authoring escape hatch when a typed website factory cannot honestly express a section's behavior. Use when the user says "I need full React control for this section", "the website factory is too restrictive", "embed a third-party widget", or "author a section with custom hooks".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website Factory Advanced
|
|
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
|
+
The normal `defineWebsiteSection` path is preferred because it keeps section
|
|
23
|
+
category, labels, structured data and page composition visible to application
|
|
24
|
+
validation. The advanced path is an escape hatch, not a parallel default. Use
|
|
25
|
+
it when the missing capability is concrete and the application can explicitly
|
|
26
|
+
preserve the responsibilities normally carried by the factory.
|
|
27
|
+
|
|
28
|
+
## App Paths
|
|
29
|
+
|
|
30
|
+
| Surface | Application-relative location |
|
|
31
|
+
|---|---|
|
|
32
|
+
| Advanced section/component | `website/src/sections/**` |
|
|
33
|
+
| Page composition | `website/src/pages-impl/**` |
|
|
34
|
+
| Labels | `website/src/i18n/**` |
|
|
35
|
+
| Third-party boundary/adaptor | `website/src/integrations/**` |
|
|
36
|
+
|
|
37
|
+
## Decision
|
|
38
|
+
|
|
39
|
+
| Need | Choice |
|
|
40
|
+
|---|---|
|
|
41
|
+
| Standard visual/content section | Use `defineWebsiteSection`; do not bypass its typed contract. |
|
|
42
|
+
| A single layout variation | Extend section props or use a variant; do not choose raw React only for styling convenience. |
|
|
43
|
+
| Third-party widget, complex interaction, or data source that the factory cannot model | Use the advanced path and document the missing capability. |
|
|
44
|
+
| Need structured data, labels, analytics or accessibility semantics | Re-establish each responsibility explicitly in the advanced component. |
|
|
45
|
+
|
|
46
|
+
## Workflow
|
|
47
|
+
|
|
48
|
+
1. State the specific factory limitation in the component documentation.
|
|
49
|
+
2. Read the installed `@wildo-ai/saas-website` declarations for the page and
|
|
50
|
+
section wrapper contract.
|
|
51
|
+
3. Keep external SDK loading in an adapter boundary with an unavailable/error
|
|
52
|
+
state; do not let it control the page shell.
|
|
53
|
+
4. Use the normal label context for visible text. Keep the component’s inputs
|
|
54
|
+
typed and document its data/consent requirements.
|
|
55
|
+
5. Wrap and compose the component through the application’s normal page
|
|
56
|
+
structure. Register its semantic category/analytics/structured-data intent
|
|
57
|
+
wherever the selected public contract provides it.
|
|
58
|
+
6. Add a fallback that preserves the page's primary purpose if the advanced
|
|
59
|
+
integration fails.
|
|
60
|
+
|
|
61
|
+
## Worked Example
|
|
62
|
+
|
|
63
|
+
<!-- TIER C WAIVER: the exact advanced adapter API depends on the installed
|
|
64
|
+
website package; this illustrates the ownership boundary rather than an API. -->
|
|
65
|
+
```tsx
|
|
66
|
+
type DemoWidgetProps = { locale: string; hasMarketingConsent: boolean };
|
|
67
|
+
|
|
68
|
+
export function DemoWidget({ locale, hasMarketingConsent }: DemoWidgetProps) {
|
|
69
|
+
if (!hasMarketingConsent) return <a href="/demo">Request a demo</a>;
|
|
70
|
+
return <div data-demo-widget-locale={locale} />;
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## References
|
|
75
|
+
|
|
76
|
+
## Import Origins
|
|
77
|
+
|
|
78
|
+
- `@wildo-ai/saas-website`
|
|
79
|
+
|
|
80
|
+
## Source Excerpts
|
|
81
|
+
|
|
82
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
83
|
+
|
|
84
|
+
```typescript
|
|
85
|
+
*
|
|
86
|
+
* Input shape consumed by `defineWebsiteSection<TProps>`. Mirrors
|
|
87
|
+
* `WebsiteSectionDefinition` but keeps `Component` typed against the
|
|
88
|
+
* caller-supplied generic so the precise prop shape survives end-to-end
|
|
89
|
+
* (the consumer's `<HeroSection />` JSX can keep its strongly-typed
|
|
90
|
+
* props after going through the factory).
|
|
91
|
+
*
|
|
92
|
+
* **String inputs vs. branded inputs**: `sectionRef` and
|
|
93
|
+
* `expectedLabelKeys` accept raw strings as well as already-branded
|
|
94
|
+
* values. The factory parses them through the underlying schemas, so
|
|
95
|
+
* either path is safe — accepting strings directly removes the
|
|
96
|
+
* ergonomic drag of forcing every section author to remember to call
|
|
97
|
+
* `WebsiteSectionRefSchema.parse(...)` in their definition.
|
|
98
|
+
*/
|
|
99
|
+
export interface DefineWebsiteSectionInput<TProps> {
|
|
100
|
+
sectionRef: WebsiteSectionRef | string;
|
|
101
|
+
category: WebsiteSectionCategory;
|
|
102
|
+
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
103
|
+
Component: ComponentType<TProps>;
|
|
104
|
+
/**
|
|
105
|
+
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
106
|
+
* full authoring contract. The factory passes the function through
|
|
107
|
+
* unchanged; the framework invokes it at static-build time and
|
|
108
|
+
* forwards the return value to `renderPageStructuredData()`.
|
|
109
|
+
*/
|
|
110
|
+
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Return shape of `defineWebsiteSection<TProps>`. Identical to
|
|
115
|
+
* `WebsiteSectionDefinition` except `Component` retains the
|
|
116
|
+
* caller-supplied generic prop shape rather than the schema's
|
|
117
|
+
* lowest-common-denominator `ComponentType<unknown>`.
|
|
118
|
+
*
|
|
119
|
+
* **Why this matters**: a consumer's `pageComponent` JSX composes
|
|
120
|
+
* sections like `<HERO_SECTION.Component {...heroProps} />`. Without
|
|
121
|
+
* preserving `TProps`, the spread would be untyped and a renamed prop
|
|
122
|
+
* would silently miss the type system. With `TProps` preserved, the
|
|
123
|
+
* call site fails to compile the moment the prop contract drifts.
|
|
124
|
+
*/
|
|
125
|
+
export interface TypedWebsiteSectionDefinition<TProps>
|
|
126
|
+
extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
|
|
127
|
+
Component: ComponentType<TProps>;
|
|
128
|
+
getStructuredData?: () => WebsiteStructuredDataReturn;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* `defineWebsiteSection<TProps>` — factory that materializes a
|
|
133
|
+
* `WebsiteSectionDefinition` from authored input.
|
|
134
|
+
*
|
|
135
|
+
* **Two responsibilities**, one entry point:
|
|
136
|
+
* 1. Runtime validation — parses the input through
|
|
137
|
+
* `WebsiteSectionDefinitionSchema` so brand checks, regex
|
|
138
|
+
* validations, and array refinements run at module load time
|
|
139
|
+
* (not at render time, not at build-output time).
|
|
140
|
+
* 2. Type preservation — returns an object whose `Component` field
|
|
141
|
+
* keeps the caller-supplied `TProps`, so JSX usage of the
|
|
142
|
+
* returned section retains compile-time prop checking.
|
|
143
|
+
*
|
|
144
|
+
* **Why a factory instead of constructing the literal directly**:
|
|
145
|
+
* - Consumers don't have to remember to parse refs / keys
|
|
146
|
+
* themselves before assembling the literal.
|
|
147
|
+
* - The schema parse provides a single audited validation chokepoint
|
|
148
|
+
* so `wildo website audit` (Phase 7) can re-validate definitions
|
|
149
|
+
* without re-entering the React graph.
|
|
150
|
+
* - The factory is the documented authoring API the
|
|
151
|
+
* `website_factory_authoring` skill targets — keeping the
|
|
152
|
+
* authoring surface narrow lets the framework evolve the
|
|
153
|
+
* internal schema (add fields, refinements) without churning
|
|
154
|
+
* every section definition in every consumer app.
|
|
155
|
+
*
|
|
156
|
+
* @param input section authoring input (see `DefineWebsiteSectionInput`).
|
|
157
|
+
* @returns a `TypedWebsiteSectionDefinition<TProps>` with `Component`
|
|
158
|
+
* preserved at the precise prop type.
|
|
159
|
+
*
|
|
160
|
+
* @example
|
|
161
|
+
* interface HeroProps {
|
|
162
|
+
* headlineKey: WebsiteLabelKey;
|
|
163
|
+
* subheadlineKey: WebsiteLabelKey;
|
|
164
|
+
* }
|
|
165
|
+
* function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
|
|
166
|
+
* // …
|
|
167
|
+
* }
|
|
168
|
+
* export const HERO_SECTION = defineWebsiteSection<HeroProps>({
|
|
169
|
+
* sectionRef: 'hero',
|
|
170
|
+
* category: WebsiteSectionCategory.HERO,
|
|
171
|
+
* expectedLabelKeys: [
|
|
172
|
+
* 'website.landing.hero.headline',
|
|
173
|
+
* 'website.landing.hero.subheadline',
|
|
174
|
+
* ],
|
|
175
|
+
* Component: HeroSection,
|
|
176
|
+
* });
|
|
177
|
+
*/
|
|
178
|
+
export function defineWebsiteSection<TProps>(
|
|
179
|
+
input: DefineWebsiteSectionInput<TProps>,
|
|
180
|
+
): TypedWebsiteSectionDefinition<TProps> {
|
|
181
|
+
const parsed = WebsiteSectionDefinitionSchema.parse({
|
|
182
|
+
sectionRef: input.sectionRef,
|
|
183
|
+
category: input.category,
|
|
184
|
+
expectedLabelKeys: input.expectedLabelKeys,
|
|
185
|
+
Component: input.Component,
|
|
186
|
+
getStructuredData: input.getStructuredData,
|
|
187
|
+
});
|
|
188
|
+
/**
|
|
189
|
+
* Re-attach `Component` and `getStructuredData` from the original
|
|
190
|
+
* input so the precise generic types survive — `parsed.Component`
|
|
191
|
+
* is `unknown` per the schema's `z.unknown()` contract.
|
|
192
|
+
*/
|
|
193
|
+
return {
|
|
194
|
+
sectionRef: parsed.sectionRef,
|
|
195
|
+
category: parsed.category,
|
|
196
|
+
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
197
|
+
Component: input.Component,
|
|
198
|
+
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
## Import Origins
|
|
204
|
+
|
|
205
|
+
- `@wildo-ai/saas-website`
|
|
206
|
+
|
|
207
|
+
## Source Excerpts
|
|
208
|
+
|
|
209
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
210
|
+
|
|
211
|
+
```tsx
|
|
212
|
+
*
|
|
213
|
+
* `WebsiteSection` — the per-section structural primitive.
|
|
214
|
+
*
|
|
215
|
+
* **Three responsibilities** (semantic-weight discipline):
|
|
216
|
+
*
|
|
217
|
+
* 1. **Provides `WebsiteSectionContext`** — registers the active
|
|
218
|
+
* sectionRef + category so leaf primitives (`useWebsiteLabel`,
|
|
219
|
+
* analytics overlays, structured-data emitters) can derive
|
|
220
|
+
* keys / metadata without re-typing the section's identity.
|
|
221
|
+
* 2. **Renders a semantic `<section>` landmark** — emits
|
|
222
|
+
* `data-section-ref` and `data-section-category` attributes so
|
|
223
|
+
* analytics tooling and SEO crawlers can identify and group
|
|
224
|
+
* sections without parsing className conventions. Optional
|
|
225
|
+
* `id` prop wires up anchor-link navigation
|
|
226
|
+
* (`<a href="#pricing">`).
|
|
227
|
+
* 3. **Provides a styling seam** — `className` is forwarded to the
|
|
228
|
+
* `<section>` element so designers can apply utility-class
|
|
229
|
+
* decorations (background, padding, max-width container) without
|
|
230
|
+
* having to compose multiple wrappers.
|
|
231
|
+
*
|
|
232
|
+
* **Why NOT render a `<div>` instead of `<section>`**: marketing
|
|
233
|
+
* pages benefit from semantic landmarks for SEO scoring and
|
|
234
|
+
* accessibility (screen-reader section navigation). A `<section>`
|
|
235
|
+
* with `data-section-category="hero"` is structurally meaningful;
|
|
236
|
+
* a `<div>` with the same data-attribute carries the same metadata
|
|
237
|
+
* but loses the landmark benefit.
|
|
238
|
+
*
|
|
239
|
+
* **Why expose `as` is NOT a prop**: switching the rendered tag
|
|
240
|
+
* (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
|
|
241
|
+
* is legitimate but rare enough to be worth a separate primitive
|
|
242
|
+
* (Phase 4: `<WebsiteAside>`, `<WebsiteArticle>`). Keeping
|
|
243
|
+
* `WebsiteSection` rendered as a literal `<section>` removes a
|
|
244
|
+
* rarely-used prop from the section-author API and keeps the SEO
|
|
245
|
+
* landmark contract guaranteed at the type level.
|
|
246
|
+
*/
|
|
247
|
+
export interface WebsiteSectionProps {
|
|
248
|
+
/**
|
|
249
|
+
* The section's ref. Accepts an already-branded `WebsiteSectionRef`
|
|
250
|
+
* or a raw string — the layout parses through
|
|
251
|
+
* `WebsiteSectionRefSchema` so a malformed ref fails loud at
|
|
252
|
+
* render. Typically sourced from the page manifest's
|
|
253
|
+
* `sectionRefs[]` (eg. `<WebsiteSection sectionRef="hero" …>`).
|
|
254
|
+
*/
|
|
255
|
+
sectionRef: WebsiteSectionRef | string;
|
|
256
|
+
/**
|
|
257
|
+
* The section's structural intent (see `WebsiteSectionCategory`).
|
|
258
|
+
* Required at the wrapper level (rather than only on the section
|
|
259
|
+
* definition) because the wrapper emits `data-section-category`
|
|
260
|
+
* for analytics, and asking the wrapper to look up the category
|
|
261
|
+
* on a separate manifest registry would re-introduce the runtime
|
|
262
|
+
* coupling the per-section context exists to avoid.
|
|
263
|
+
*/
|
|
264
|
+
category: WebsiteSectionCategory;
|
|
265
|
+
/**
|
|
266
|
+
* Optional DOM id. Wires anchor-link navigation
|
|
267
|
+
* (`<a href="#pricing">`). When omitted, the section has no DOM
|
|
268
|
+
* id — by design; not every section is an anchor target.
|
|
269
|
+
*/
|
|
270
|
+
id?: string;
|
|
271
|
+
/**
|
|
272
|
+
* Optional className applied to the `<section>` element. Used by
|
|
273
|
+
* designers for layout / spacing utilities. Section components
|
|
274
|
+
* themselves should NOT pass className through to this wrapper —
|
|
275
|
+
* keep the styling responsibility at the page-composition level.
|
|
276
|
+
*/
|
|
277
|
+
className?: string;
|
|
278
|
+
/**
|
|
279
|
+
* The section's body. Typically a single section component
|
|
280
|
+
* (`<HeroSection {…heroProps} />`). May be plain JSX for one-off
|
|
281
|
+
* sections that don't justify a `defineWebsiteSection` factory call.
|
|
282
|
+
*/
|
|
283
|
+
children: ReactNode;
|
|
284
|
+
/**
|
|
285
|
+
* Pass-through `aria-*` / `role` attributes for sections that need
|
|
286
|
+
* to refine their landmark semantics (eg. `aria-label="Featured
|
|
287
|
+
* customer logos"` on a logo wall).
|
|
288
|
+
*/
|
|
289
|
+
ariaLabel?: string;
|
|
290
|
+
ariaLabelledBy?: string;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
export function WebsiteSection({
|
|
294
|
+
sectionRef,
|
|
295
|
+
category,
|
|
296
|
+
id,
|
|
297
|
+
className,
|
|
298
|
+
children,
|
|
299
|
+
ariaLabel,
|
|
300
|
+
ariaLabelledBy,
|
|
301
|
+
}: WebsiteSectionProps): ReactNode {
|
|
302
|
+
const safeSectionRef = useMemo<WebsiteSectionRef>(
|
|
303
|
+
() => WebsiteSectionRefSchema.parse(sectionRef),
|
|
304
|
+
[sectionRef],
|
|
305
|
+
);
|
|
306
|
+
|
|
307
|
+
const sectionContextValue = useMemo<WebsiteSectionContextValue>(
|
|
308
|
+
() => ({ sectionRef: safeSectionRef, category }),
|
|
309
|
+
[safeSectionRef, category],
|
|
310
|
+
);
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* Build the `<section>` attribute set imperatively to keep
|
|
314
|
+
* `aria-*` props off the element when omitted (rendering
|
|
315
|
+
* `aria-label={undefined}` still emits the attribute in some
|
|
316
|
+
* React versions — explicit absence is cleaner).
|
|
317
|
+
*/
|
|
318
|
+
const sectionAttrs: HTMLAttributes<HTMLElement> = {
|
|
319
|
+
className,
|
|
320
|
+
};
|
|
321
|
+
if (id !== undefined) sectionAttrs.id = id;
|
|
322
|
+
if (ariaLabel !== undefined) sectionAttrs['aria-label'] = ariaLabel;
|
|
323
|
+
if (ariaLabelledBy !== undefined) sectionAttrs['aria-labelledby'] = ariaLabelledBy;
|
|
324
|
+
|
|
325
|
+
return (
|
|
326
|
+
<WebsiteSectionContextProvider value={sectionContextValue}>
|
|
327
|
+
<section
|
|
328
|
+
data-section-ref={safeSectionRef as unknown as string}
|
|
329
|
+
data-section-category={category}
|
|
330
|
+
{...sectionAttrs}
|
|
331
|
+
>
|
|
332
|
+
{children}
|
|
333
|
+
</section>
|
|
334
|
+
</WebsiteSectionContextProvider>
|
|
335
|
+
);
|
|
336
|
+
}
|
|
337
|
+
WebsiteSection.displayName = 'WebsiteSection';
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
Use these source-backed contracts to prove that the default factory cannot
|
|
341
|
+
express the need before using this escape hatch.
|
|
342
|
+
|
|
343
|
+
## Verification
|
|
344
|
+
|
|
345
|
+
- The normal factory path was considered and the rejected capability is named.
|
|
346
|
+
- A failed third-party load leaves a usable page and primary action.
|
|
347
|
+
- Labels, accessibility semantics, consent and structured-data responsibility
|
|
348
|
+
are reviewed explicitly rather than assumed from the factory.
|
|
349
|
+
|
|
350
|
+
Run `rg -n "fallback|unavailable|failed" website/src/sections/` and review the
|
|
351
|
+
advanced component result before accepting its fallback behavior.
|
|
352
|
+
|
|
353
|
+
## Mechanical Checks
|
|
354
|
+
|
|
355
|
+
| Invariant | Command |
|
|
356
|
+
|---|---|
|
|
357
|
+
| Escape hatch has a documented reason | `rg -n "factory limitation|escape hatch" website/src/sections/` (must find the advanced component) |
|
|
358
|
+
| Advanced integration has a fallback | `rg -n "fallback|unavailable|failed" website/src/sections/` (review the advanced component result) |
|
|
359
|
+
|
|
360
|
+
## Common Rationalizations
|
|
361
|
+
|
|
362
|
+
- “Raw React is faster.” It is faster only if lost validation and ownership do
|
|
363
|
+
not matter; normally they do.
|
|
364
|
+
- “The vendor widget manages consent.” The application still owns what it
|
|
365
|
+
chooses to load.
|
|
366
|
+
|
|
367
|
+
## Red Flags
|
|
368
|
+
|
|
369
|
+
- An escape-hatch component has no fallback or no reason for bypassing the
|
|
370
|
+
typed factory.
|
|
371
|
+
- User-visible text, tracking or schema is hidden inside an unreviewed widget.
|
|
372
|
+
|
|
373
|
+
## Related Skills
|
|
374
|
+
|
|
375
|
+
- `website-section-hero` and the other section skills for the default path.
|
|
376
|
+
- `website-consent-gate-overrides` for optional third-party behavior.
|
|
@@ -0,0 +1,304 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-inbound-contact-forms
|
|
3
|
+
description: Build a visitor contact, newsletter or sales-enquiry form that safely submits an inbound contact with consent, attribution and abuse handling. Use when the user says "wire a contact form", "submit to inbound contacts", "build a newsletter signup", "build a sales-contact form", or "capture leads from the marketing site".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website Inbound Contact Forms
|
|
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
|
+
An inbound form is both a visitor experience and an untrusted ingress point.
|
|
23
|
+
Design it around a clear contact purpose, minimal data, consent/disclosure,
|
|
24
|
+
server validation and an honest recovery path. Marketing attribution enriches
|
|
25
|
+
the operation; it must not become an excuse to make form acceptance depend on
|
|
26
|
+
optional client data.
|
|
27
|
+
|
|
28
|
+
## App Paths
|
|
29
|
+
|
|
30
|
+
| Surface | Application-relative location |
|
|
31
|
+
|---|---|
|
|
32
|
+
| Form section/component | `website/src/sections/**` |
|
|
33
|
+
| Form validation/schema | `shared-lib/src/**` |
|
|
34
|
+
| Website submission adapter | `website/src/sections/**` (or an application-owned section helper) |
|
|
35
|
+
| Server/resource policy | `backend-api/src/**` or application specifications |
|
|
36
|
+
|
|
37
|
+
## Workflow
|
|
38
|
+
|
|
39
|
+
1. Define the visitor purpose and the minimum fields needed to respond.
|
|
40
|
+
2. Read the installed inbound-contact request contract before building form
|
|
41
|
+
state; use its validation/error model rather than recreating a private DTO.
|
|
42
|
+
3. Gate optional attribution or session enrichment with the resolved consent
|
|
43
|
+
state. Required form validation must work without it.
|
|
44
|
+
4. Submit through the public application API. Render pending, accepted,
|
|
45
|
+
validation-error, rate-limit and unexpected-failure states distinctly.
|
|
46
|
+
5. Treat `extra` metadata as application-owned structured context: give every
|
|
47
|
+
key an owner and avoid placing raw secrets or arbitrary browser data there.
|
|
48
|
+
6. Verify server-side validation and abuse controls, then test a visitor path
|
|
49
|
+
with no optional tracking state.
|
|
50
|
+
|
|
51
|
+
## Worked Example
|
|
52
|
+
|
|
53
|
+
<!-- TIER C WAIVER: request-field names vary by selected application contract;
|
|
54
|
+
the example preserves the essential client-state distinction. -->
|
|
55
|
+
```ts
|
|
56
|
+
type SubmitState = 'idle' | 'submitting' | 'accepted' | 'invalid' | 'rate_limited' | 'failed';
|
|
57
|
+
|
|
58
|
+
export function nextState(status: number): SubmitState {
|
|
59
|
+
if (status >= 200 && status < 300) return 'accepted';
|
|
60
|
+
if (status === 400 || status === 422) return 'invalid';
|
|
61
|
+
if (status === 429) return 'rate_limited';
|
|
62
|
+
return 'failed';
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## References
|
|
67
|
+
|
|
68
|
+
## Import Origins
|
|
69
|
+
|
|
70
|
+
- `@wildo-ai/saas-website`
|
|
71
|
+
|
|
72
|
+
## Source Excerpts
|
|
73
|
+
|
|
74
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
75
|
+
|
|
76
|
+
```tsx
|
|
77
|
+
*
|
|
78
|
+
* `WebsiteRuntimeContext` — site-wide runtime state for the marketing
|
|
79
|
+
* surface. Created **once per page render** by the host adapter
|
|
80
|
+
* (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
|
|
81
|
+
* resolved label pack from disk and calls
|
|
82
|
+
* `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
|
|
83
|
+
*
|
|
84
|
+
* **Why "runtime" and not "config"**: the values here are the
|
|
85
|
+
* locale-resolved subset of `WebsiteRootConfig` — only the active
|
|
86
|
+
* locale's label pack travels with the React tree (the other locales
|
|
87
|
+
* live in their own per-locale static builds). A `*Config` name would
|
|
88
|
+
* suggest the full multi-locale surface is in scope.
|
|
89
|
+
*
|
|
90
|
+
* **Three pieces of state**:
|
|
91
|
+
*
|
|
92
|
+
* - `locale` — the currently-rendering locale. Sections that need
|
|
93
|
+
* locale-aware formatting (number/date in marketing copy is rare
|
|
94
|
+
* but legitimate) read it via `useWebsiteRuntime()`.
|
|
95
|
+
* - `labelPack` — the locale-resolved flat key→string map, validated
|
|
96
|
+
* against the manifest by `validateLabelPackAgainstManifest` at
|
|
97
|
+
* build start. Consumed by `useWebsiteLabel` and
|
|
98
|
+
* `useWebsiteLabelByKey`.
|
|
99
|
+
* - `designTokens` — the `WebsiteDesignTokens` from
|
|
100
|
+
* `WebsiteRootConfig.designTokens`. Consumed by
|
|
101
|
+
* `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
|
|
102
|
+
* materializes them as `--website-*` custom properties on the
|
|
103
|
+
* `<WebsitePageLayout>` root.
|
|
104
|
+
* - `navigation` — the `WebsiteNavigationConfig` from
|
|
105
|
+
* `WebsiteRootConfig.navigation`. Carried in the runtime context
|
|
106
|
+
* (rather than as a separate `WebsiteNavigationContext`) because
|
|
107
|
+
* `<WebsitePageLayout>` already reads runtime state and
|
|
108
|
+
* header/footer slots are inseparable from "the site is rendering
|
|
109
|
+
* right now". A second context for two component refs would split
|
|
110
|
+
* the host-adapter's wiring surface without buying isolation.
|
|
111
|
+
* - `frontendProviderRegistry` — optional website-facing public provider
|
|
112
|
+
* registry hydrated from the materialized provider artifact for the
|
|
113
|
+
* concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
|
|
114
|
+
* browser-monitoring integrations on the same frontend-provider
|
|
115
|
+
* contract the SaaS app now uses, instead of inventing a website-only
|
|
116
|
+
* metadata seam.
|
|
117
|
+
*
|
|
118
|
+
* **Why a separate file from the hook + provider**: split for React
|
|
119
|
+
* Fast Refresh — when a `.tsx` exports both a React component and a
|
|
120
|
+
* React Context object, edits to either one invalidate the entire
|
|
121
|
+
* module's HMR boundary. Keeping the bare context here, the hook in
|
|
122
|
+
* `useWebsiteRuntime.ts`, and the provider component in
|
|
123
|
+
* `WebsiteRuntimeContextProvider.tsx` makes section authors edit
|
|
124
|
+
* components without retriggering the runtime context's identity.
|
|
125
|
+
*/
|
|
126
|
+
export interface WebsiteRuntimeContextValue {
|
|
127
|
+
/**
|
|
128
|
+
* The currently-rendering locale. Marketing-site routing emits one
|
|
129
|
+
* static build per locale (D8), so this value is constant per build
|
|
130
|
+
* — never re-renders mid-session.
|
|
131
|
+
*/
|
|
132
|
+
locale: AvailableLanguage;
|
|
133
|
+
/**
|
|
134
|
+
* The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).
|
|
135
|
+
* Carried in the runtime context so client-tier components — namely
|
|
136
|
+
* `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
|
|
137
|
+
* locale-prefixed pathname (`/pricing` on the EN site,
|
|
138
|
+
* `/fr/pricing` on the FR site) without re-importing the root
|
|
139
|
+
* config. Plumbing it through the runtime keeps the routing rule
|
|
140
|
+
* a framework-internal concern: section authors NEVER hand-prefix
|
|
141
|
+
* paths.
|
|
142
|
+
*/
|
|
143
|
+
defaultLocale: AvailableLanguage;
|
|
144
|
+
/**
|
|
145
|
+
* Flat `Record<string, string>` label pack for the active locale.
|
|
146
|
+
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
147
|
+
* strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
|
|
148
|
+
* which composes the full key against the page+section context.
|
|
149
|
+
*/
|
|
150
|
+
labelPack: LabelPack;
|
|
151
|
+
/**
|
|
152
|
+
* Design-token bundle for the active site. Same object referenced
|
|
153
|
+
* by `WebsiteRootConfig.designTokens`; passed by reference (not
|
|
154
|
+
* cloned) so token-aware components can rely on referential
|
|
155
|
+
* stability across renders.
|
|
156
|
+
*/
|
|
157
|
+
designTokens: WebsiteDesignTokens;
|
|
158
|
+
/**
|
|
159
|
+
* Site-wide navigation slot bindings (header / footer components).
|
|
160
|
+
* Same object referenced by `WebsiteRootConfig.navigation`. Read
|
|
161
|
+
* by `<WebsitePageLayout>` to render the chrome around each page's
|
|
162
|
+
* `<main>` content; per-page `header` / `footer` props on
|
|
163
|
+
* `<WebsitePageLayout>` override these defaults.
|
|
164
|
+
*/
|
|
165
|
+
navigation: WebsiteNavigationConfig;
|
|
166
|
+
/**
|
|
167
|
+
* Fully-composed label key the framework reads to render the
|
|
168
|
+
* "Skip to main content" affordance as the FIRST focusable element
|
|
169
|
+
* on every page (Phase 6 third audit fix M-α). Mirrors
|
|
170
|
+
* `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
|
|
171
|
+
* runtime context (NOT re-derived from the root config inside
|
|
172
|
+
* `WebsitePageLayout`) for two reasons:
|
|
173
|
+
* - The layout is a client-tier React component; it cannot import
|
|
174
|
+
* the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
|
|
175
|
+
* server-only code (manifest registry, page components) into
|
|
176
|
+
* the client bundle.
|
|
177
|
+
* - Threading the key through the runtime keeps the layout's
|
|
178
|
+
* contract symmetric with how every other localized text on the
|
|
179
|
+
* page is sourced (label pack + key), so the skip link is
|
|
180
|
+
* translated automatically without any per-locale branching.
|
|
181
|
+
*/
|
|
182
|
+
skipToMainContentLabelKey: WebsiteLabelKey;
|
|
183
|
+
/**
|
|
184
|
+
* Website-facing public providers for the active static website
|
|
185
|
+
* service. Optional so older tests and provider-free sites can omit
|
|
186
|
+
* it, but when present it is the canonical frontend-safe provider
|
|
187
|
+
* catalog for analytics / captcha / browser-monitoring slices.
|
|
188
|
+
*/
|
|
189
|
+
frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
|
|
190
|
+
/**
|
|
191
|
+
* Backend API origin (WITHOUT a trailing slash) that anonymous-capture
|
|
192
|
+
* sections POST to when constructing a `WebsiteAnonymousSessionClient`
|
|
193
|
+
* (lead / draft-note forms). Sourced from
|
|
194
|
+
* `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
|
|
195
|
+
* JSON-serializable island prop (the `.astro` page resolves the
|
|
196
|
+
* per-environment value and forwards it).
|
|
197
|
+
*
|
|
198
|
+
* Optional because only pages that host an anonymous-capture section
|
|
199
|
+
* need it — brochure pages omit it. A capture section that reads
|
|
200
|
+
* `undefined` here surfaces a loud misconfiguration rather than
|
|
201
|
+
* silently failing to submit.
|
|
202
|
+
*/
|
|
203
|
+
apiOrigin?: string;
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Bare React context. Default `null` — `useWebsiteRuntime()` throws
|
|
208
|
+
* with a clear error message when invoked outside of
|
|
209
|
+
* `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred
|
|
210
|
+
* over a silent default value so a missing provider is detected at
|
|
211
|
+
* the first hook call rather than at render time when a missing
|
|
212
|
+
* label silently renders as the key string.
|
|
213
|
+
*/
|
|
214
|
+
export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
|
|
215
|
+
createContext<WebsiteRuntimeContextValue | null>(null);
|
|
216
|
+
|
|
217
|
+
export interface WebsiteRuntimeContextProviderProps {
|
|
218
|
+
value: WebsiteRuntimeContextValue;
|
|
219
|
+
children: ReactNode;
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Provider component. Authored as a thin wrapper so consumers do NOT
|
|
224
|
+
* have to import `WebsiteRuntimeContext.Provider` directly — the
|
|
225
|
+
* provider component carries the documented authoring API and is the
|
|
226
|
+
* Fast-Refresh-stable surface section authors compose against.
|
|
227
|
+
*/
|
|
228
|
+
export function WebsiteRuntimeContextProvider({
|
|
229
|
+
value,
|
|
230
|
+
children,
|
|
231
|
+
}: WebsiteRuntimeContextProviderProps): ReactNode {
|
|
232
|
+
return (
|
|
233
|
+
<WebsiteRuntimeContext.Provider value={value}>
|
|
234
|
+
{children}
|
|
235
|
+
</WebsiteRuntimeContext.Provider>
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
|
|
242
|
+
## Usage Example
|
|
243
|
+
|
|
244
|
+
```typescript
|
|
245
|
+
{
|
|
246
|
+
variantType: ResourceOperationVariantType.API_CALL,
|
|
247
|
+
isDefault: true,
|
|
248
|
+
roles: [CORE_APP_ROLES.APP_ANONYMOUS],
|
|
249
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
250
|
+
// Public anonymous CREATE — declares the per-IP rate-limit on the
|
|
251
|
+
// default API_CALL variant. Two windows (a short burst limit + an
|
|
252
|
+
// hourly cap) are AND-ed and enforced at the controller pre-flight
|
|
253
|
+
// seam; no bucket-key choice is needed here because IP is the only
|
|
254
|
+
// identity available before execution-context creation. The global
|
|
255
|
+
// HTTP limiter remains the safety net for any path that bypasses
|
|
256
|
+
// this surface.
|
|
257
|
+
rateLimit: {
|
|
258
|
+
requestsPerMinute: 5,
|
|
259
|
+
requestsPerHour: 30,
|
|
260
|
+
},
|
|
261
|
+
},
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
These source-backed routes preserve the website state boundary and a public
|
|
265
|
+
ingress/rate-limit example; the installed inbound-contact declaration remains
|
|
266
|
+
the authoritative field-level contract.
|
|
267
|
+
|
|
268
|
+
## Verification
|
|
269
|
+
|
|
270
|
+
- The form can submit with optional attribution absent.
|
|
271
|
+
- Validation, rate-limit and network failure give different actionable
|
|
272
|
+
messages; none report success before the server accepts the request.
|
|
273
|
+
- Consent text and the actual optional fields/metadata match.
|
|
274
|
+
- A contact page is represented deliberately in `website/src/content/llms.txt`
|
|
275
|
+
when it is a sanctioned public engagement route.
|
|
276
|
+
|
|
277
|
+
Run `rg -n "InboundContactForm|getAnonymousSessionClient" website/src/sections/`
|
|
278
|
+
and confirm the contact section uses the declared form/session boundary instead
|
|
279
|
+
of a raw browser submission bypass.
|
|
280
|
+
|
|
281
|
+
## Mechanical Checks
|
|
282
|
+
|
|
283
|
+
| Invariant | Command |
|
|
284
|
+
|---|---|
|
|
285
|
+
| No raw contact fetch bypass | `rg -n "fetch\(" website/src/sections/` (must be empty or use the approved public adapter) |
|
|
286
|
+
| Form has declared form/session boundary | `rg -n "InboundContactForm\|getAnonymousSessionClient" website/src/sections/` (must return at least one result) |
|
|
287
|
+
|
|
288
|
+
## Common Rationalizations
|
|
289
|
+
|
|
290
|
+
- “Client-side validation is enough.” It improves feedback but does not defend
|
|
291
|
+
the server boundary.
|
|
292
|
+
- “All browser metadata is useful.” Unowned metadata becomes unreviewable and
|
|
293
|
+
can conflict with the stated contact purpose.
|
|
294
|
+
|
|
295
|
+
## Red Flags
|
|
296
|
+
|
|
297
|
+
- The form treats a request dispatch as a successful submission.
|
|
298
|
+
- An API error leaks an internal message or makes the visitor retry blindly.
|
|
299
|
+
- Optional consent is required for the essential act of sending the form.
|
|
300
|
+
|
|
301
|
+
## Related Skills
|
|
302
|
+
|
|
303
|
+
- `website-marketing-metadata-extension` for intentionally modeled extra data.
|
|
304
|
+
- `website-consent-gate-overrides` for shared consent state.
|