@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,553 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-bundle-discipline
|
|
3
|
+
description: Discipline that keeps app-side marketing-website code bundle-safe — what to import (and what NOT to import) when authoring website primitive overrides, custom sections via `defineWebsiteSection`, page composition, label packs, or any code that lands in the Astro/React-island bundle. Use when the user says "the marketing site bundle exploded after I added X", "can I import something from saas-frontend-lib in my Hero section?", "where do I import locale enums on the website?", "I'm overriding WebsitePageLayout, can I pull a backend service from my override?", "is `axios` ok in my Astro middleware?", or any time bundle-size or import-discipline questions come up around the saas-website surface.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Website Bundle Discipline
|
|
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 installed `@wildo-ai/saas-website` package is bundle-safe by design: every file
|
|
23
|
+
in its source tree obeys a tightly-scoped allow-list of bare-specifier
|
|
24
|
+
imports, enforced by a vitest closure-walking test
|
|
25
|
+
through its package boundary contract. The
|
|
26
|
+
SAME discipline must extend to **every app-side file that lands in
|
|
27
|
+
the same bundle** — namely:
|
|
28
|
+
|
|
29
|
+
- App-side L1 primitive overrides (e.g. `website/src/primitives/WebsiteButton.tsx`)
|
|
30
|
+
- App-side L1.5 layout overrides (e.g. `website/src/layouts/WebsitePageLayout.tsx`)
|
|
31
|
+
- App-side section authoring (`defineWebsiteSection`-built `*.section.tsx` files)
|
|
32
|
+
- App-side page composition (`website/src/pages/*.tsx`, `*.astro`)
|
|
33
|
+
- App-side label packs (`website/src/i18n/*.ts`)
|
|
34
|
+
- App-side Astro middleware (`website/src/middleware/*.ts`) — SSR-tier, see below
|
|
35
|
+
|
|
36
|
+
The split between **island-tier** (ships to the browser) and
|
|
37
|
+
**SSR-tier** (runs only on the build/server) is the sharp edge that
|
|
38
|
+
catches most regressions: a single root-barrel import from
|
|
39
|
+
`@wildo-ai/saas-models` inside a React island file pulls
|
|
40
|
+
`initZodDecorators()` + `reflect-metadata` + ~150 schemas into every
|
|
41
|
+
visitor's browser.
|
|
42
|
+
|
|
43
|
+
This skill is the APP-SIDE counterpart of the framework-owned contract
|
|
44
|
+
documented at `engine.client-bundle.discipline` — the live rules
|
|
45
|
+
ship as anchored JSDoc inlined below.
|
|
46
|
+
|
|
47
|
+
## App Paths
|
|
48
|
+
|
|
49
|
+
| Surface | Glob (relative to app root) | Tier |
|
|
50
|
+
|-----------------------------------------|----------------------------------------------------------------------|-----------|
|
|
51
|
+
| L1 primitive overrides | `website/src/primitives/*.tsx` | Island |
|
|
52
|
+
| L1.5 layout overrides | `website/src/layouts/{WebsitePageLayout,WebsiteSection}.tsx` | Island |
|
|
53
|
+
| Sections (`defineWebsiteSection`) | `website/src/sections/<category>/*.section.tsx` | Island |
|
|
54
|
+
| Page composition | `website/src/pages/*.tsx`, `website/src/pages/*.astro` | Island |
|
|
55
|
+
| Label packs | `website/src/i18n/<page-ref>.<locale>.ts` | Island |
|
|
56
|
+
| Astro middleware (SSR-only) | `website/src/middleware/*.ts` | SSR |
|
|
57
|
+
| Installed boundary contract (reference) | source-backed bundle-isolation reference | — |
|
|
58
|
+
|
|
59
|
+
## When to Use
|
|
60
|
+
|
|
61
|
+
- Authoring or reviewing any file under `website/src/**`
|
|
62
|
+
- Reviewing a PR that adds an import to a website-tier file
|
|
63
|
+
- Diagnosing a sudden marketing-bundle size jump after a recent change
|
|
64
|
+
- Picking between `@wildo-ai/saas-models` and `@wildo-ai/saas-models/public-runtime`
|
|
65
|
+
- Wiring an Astro middleware that needs `axios` / `jsonwebtoken` /
|
|
66
|
+
`socket.io-client` / `reflect-metadata` and wondering whether the
|
|
67
|
+
rule still applies
|
|
68
|
+
|
|
69
|
+
## When NOT to Use
|
|
70
|
+
|
|
71
|
+
- Authoring backend code (`backend-api/**`) — bundle discipline does
|
|
72
|
+
not apply; use the relevant backend skill
|
|
73
|
+
- Authoring app-shell / sidebar / menubar / SaaS-app config —
|
|
74
|
+
`config-app-shell` / `config-navigation` / `config-saas`
|
|
75
|
+
- Authoring resource UI behavior or composite views inside the SaaS
|
|
76
|
+
app — `resource-ui-behavior` / `views-composite-authoring`
|
|
77
|
+
- Choosing the rendering engine itself (Astro vs Next vs …) — that
|
|
78
|
+
decision lives upstream of this contract
|
|
79
|
+
|
|
80
|
+
## The installed contract
|
|
81
|
+
|
|
82
|
+
The rules + rationale block below is extracted verbatim from the
|
|
83
|
+
saas-website bundle-isolation test preamble, so this skill never
|
|
84
|
+
drifts from what CI actually enforces:
|
|
85
|
+
|
|
86
|
+
## Import Origins
|
|
87
|
+
|
|
88
|
+
- `@wildo-ai/saas-website`
|
|
89
|
+
|
|
90
|
+
## Source Excerpts
|
|
91
|
+
|
|
92
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
93
|
+
|
|
94
|
+
```typescript
|
|
95
|
+
*
|
|
96
|
+
* Browser-bundle boundary for `@wildo-ai/saas-website`.
|
|
97
|
+
*
|
|
98
|
+
* The entire `saas-website` source tree ships into a browser bundle
|
|
99
|
+
* (Astro SSG + React islands). Anything that lands here transitively
|
|
100
|
+
* pulls into the marketing-site customer bundle. This test walks the
|
|
101
|
+
* source closure starting from each public package entry and asserts
|
|
102
|
+
* that every bare-specifier import is on a tightly-scoped allow-list,
|
|
103
|
+
* and that no forbidden specifier (decorator-framework boot, backend
|
|
104
|
+
* libs, Node-only deps) ever appears.
|
|
105
|
+
*
|
|
106
|
+
* Walked entries (current package.json `exports`):
|
|
107
|
+
* - `./src/index.ts` — root barrel (React + schemas)
|
|
108
|
+
* - `./src/companion-exports.ts` — React-free companion entry
|
|
109
|
+
* - `./src/astro.ts` — Astro adapter SSR/frontmatter
|
|
110
|
+
* sub-entry. Pulls
|
|
111
|
+
* `node:fs` / `node:path` for the
|
|
112
|
+
* label-pack loader. MUST NOT pull
|
|
113
|
+
* the `astro` runtime itself (that
|
|
114
|
+
* lives only inside `.astro` files,
|
|
115
|
+
* which Astro's compiler processes
|
|
116
|
+
* separately) AND MUST NOT pull the
|
|
117
|
+
* bridge-runtime island module
|
|
118
|
+
* (split into `./astro-island` to
|
|
119
|
+
* keep the client graph free of
|
|
120
|
+
* `node:*` specifiers — Vite's
|
|
121
|
+
* resolver runs before
|
|
122
|
+
* tree-shaking and would hard-fail
|
|
123
|
+
* on `__vite-browser-external`
|
|
124
|
+
* otherwise).
|
|
125
|
+
* - `./src/astro-island.ts` — Astro adapter CLIENT-bundle
|
|
126
|
+
* sub-entry.
|
|
127
|
+
* Exposes only
|
|
128
|
+
* `createWebsitePageBridgeIsland`.
|
|
129
|
+
* MUST stay 100% bundle-clean
|
|
130
|
+
* (no `node:*`, no SSR-tier
|
|
131
|
+
* specifiers) — the SSR-tier
|
|
132
|
+
* negative test below asserts that.
|
|
133
|
+
* - `./src/config-loader.ts` — Node-only entry that loads the
|
|
134
|
+
* per-service `wildo.website.config.ts`
|
|
135
|
+
* via `loadConfig` from
|
|
136
|
+
* `@wildo-ai/platform-config-lib`
|
|
137
|
+
* (jiti-backed, transitively pulls
|
|
138
|
+
* `node:fs` / `node:path` /
|
|
139
|
+
* `node:crypto`). Walked here so the
|
|
140
|
+
* SSR-tier negative test below
|
|
141
|
+
* proves `@wildo-ai/platform-config-lib`
|
|
142
|
+
* reaches the closure ONLY through
|
|
143
|
+
* this entry — never through
|
|
144
|
+
* `index.ts`, `companion-exports.ts`,
|
|
145
|
+
* or `astro-island.ts`.
|
|
146
|
+
*
|
|
147
|
+
* `./mdx.ts` is the marketing-blog adapter subpath. It is included in
|
|
148
|
+
* `ENTRY_FILES` below and pulls `@mdx-js/react`. The provider lives in the
|
|
149
|
+
* React-island closure (consumed transitively
|
|
150
|
+
* from a consumer's per-post `.astro` page), so the SSR-tier negative
|
|
151
|
+
* test does NOT apply to `@mdx-js/react` — the specifier is
|
|
152
|
+
* unconditionally allowed across all entries.
|
|
153
|
+
*
|
|
154
|
+
* **Why `.astro` files are NOT in the walked closure**: this test
|
|
155
|
+
* walks `.ts` / `.tsx` only — the import-collection regex assumes
|
|
156
|
+
* TypeScript module syntax. `.astro` files have their own frontmatter
|
|
157
|
+
* grammar (Astro's compiler handles them), and they live on the
|
|
158
|
+
* Astro-build-time side of the boundary, not the React-island side.
|
|
159
|
+
* The TypeScript helpers the `.astro` shell calls into (everything
|
|
160
|
+
* exported from `astro.ts`) ARE walked — that's where the boundary
|
|
161
|
+
* actually matters.
|
|
162
|
+
*
|
|
163
|
+
* **Client-bundle import discipline**
|
|
164
|
+
* The single allowed door into `@wildo-ai/saas-models` is the
|
|
165
|
+
* side-effect-free `/public-runtime` subpath. The root barrel
|
|
166
|
+
* calls `initZodDecorators()` at module load and pulls
|
|
167
|
+
* `reflect-metadata` + the `@wildo-ai/external-connectors-models`
|
|
168
|
+
* graph + the full schema tree — none of which belongs in a marketing
|
|
169
|
+
* bundle.
|
|
170
|
+
*
|
|
171
|
+
* Same forbid applies to the ROOT barrel of
|
|
172
|
+
* `@wildo-ai/presets-components-models` (boots the full preset +
|
|
173
|
+
* component-metadata graph). Its `/public-runtime` SUBPATH is
|
|
174
|
+
* explicitly ALLOWED for callers that need locale-tier symbols
|
|
175
|
+
* beyond what `@wildo-ai/saas-models/public-runtime` re-exports
|
|
176
|
+
* New browser-facing atoms follow the same pattern: expose a narrow public
|
|
177
|
+
* runtime export rather than duplicating a type or importing a heavy root
|
|
178
|
+
* package.
|
|
179
|
+
*
|
|
180
|
+
* `@wildo-ai/zod-decorators` is allowed.
|
|
181
|
+
* Importing the package alone is side-effect-free — the prototype
|
|
182
|
+
* mutation only happens when a caller explicitly invokes
|
|
183
|
+
* `initZodDecorators()`, which neither saas-website nor the
|
|
184
|
+
* saas-models /public-runtime barrel does. Allowing the import
|
|
185
|
+
* leaves room for build-time decorator-metadata reads on schemas
|
|
186
|
+
* imported from /public-runtime (e.g. `WildoZodDecorators.getMetadata(...)`
|
|
187
|
+
* in a future Astro build-time generator) without forcing those
|
|
188
|
+
* call sites to live outside the walked closure.
|
|
189
|
+
*
|
|
190
|
+
* `axios`, `jsonwebtoken`, `socket.io-client`, and
|
|
191
|
+
* `reflect-metadata` are now ALLOWED. The website engine needs
|
|
192
|
+
* them for SERVER-SIDE Astro middleware code paths (request
|
|
193
|
+
* proxying, JWT verification, real-time push) that do NOT ship
|
|
194
|
+
* to the browser island bundle. Adding them collapses this test
|
|
195
|
+
* from a "bundle-bloat guard" to a "stack-creep guard": it still
|
|
196
|
+
* catches `mongoose`, `inversify`, `express`, `pino`, `helmet`,
|
|
197
|
+
* `argon2`, `bcrypt`, the heavy package root barrels of
|
|
198
|
+
* `@wildo-ai/saas-models` / `@wildo-ai/presets-components-models`,
|
|
199
|
+
* and any non-`/public-runtime` subpath of those — i.e. it
|
|
200
|
+
* prevents the saas-app/backend stack from creeping into the
|
|
201
|
+
* marketing engine — but it no longer guarantees by itself that
|
|
202
|
+
* the React island bundle stays under a hard size budget. That
|
|
203
|
+
* guarantee now lives upstream of this file: developer discipline
|
|
204
|
+
* to keep heavy SSR-only deps out of files reachable from React
|
|
205
|
+
* component code. A stricter entry-specific browser-size check may be added
|
|
206
|
+
* later; this contract already prevents backend and framework bootstrap
|
|
207
|
+
* imports from entering the website closure.
|
|
208
|
+
*
|
|
209
|
+
* Related public-runtime boundary tests prove the subpath itself is free of
|
|
210
|
+
* decorator-framework bootstrap. This test proves the website consumes that
|
|
211
|
+
* safe seam correctly.
|
|
212
|
+
*/
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
The current allow-list (the concrete `ALLOWED_BARE_SPECIFIERS`
|
|
216
|
+
const) follows. Treat it as the authoritative answer when you are
|
|
217
|
+
about to add a `from '<package>'` import to any website-tier file:
|
|
218
|
+
|
|
219
|
+
## Import Origins
|
|
220
|
+
|
|
221
|
+
- `@wildo-ai/saas-website`
|
|
222
|
+
|
|
223
|
+
## Source Excerpts
|
|
224
|
+
|
|
225
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
226
|
+
|
|
227
|
+
```typescript
|
|
228
|
+
*
|
|
229
|
+
* Bare-specifier allow-list. Adding a new entry must be a deliberate decision
|
|
230
|
+
* and meet the same browser-boundary acceptance criteria:
|
|
231
|
+
* (a) browser-safe (no Node-only API surface)
|
|
232
|
+
* (b) does NOT transitively pull `reflect-metadata`, the saas-models
|
|
233
|
+
* root barrel, the presets-components-models root barrel, or any
|
|
234
|
+
* backend lib.
|
|
235
|
+
*
|
|
236
|
+
* Add a dependency only when a real application-facing import needs it, with
|
|
237
|
+
* this rationale updated alongside the import.
|
|
238
|
+
*/
|
|
239
|
+
const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
|
|
240
|
+
'react',
|
|
241
|
+
'zod',
|
|
242
|
+
'@wildo-ai/saas-models/public-runtime',
|
|
243
|
+
/**
|
|
244
|
+
* Narrow public-runtime seam exposing
|
|
245
|
+
* `AvailableLanguage` / `TextDirection` (and any future locale-tier
|
|
246
|
+
* atom) without booting the heavy `@wildo-ai/presets-components-models`
|
|
247
|
+
* root barrel. Consumers should prefer the
|
|
248
|
+
* `@wildo-ai/saas-models/public-runtime` re-export path so they see
|
|
249
|
+
* one door, but importing the presets `/public-runtime` subpath
|
|
250
|
+
* directly is allowed for symbols that aren't (yet) re-exported by
|
|
251
|
+
* saas-models. The root barrel of `@wildo-ai/presets-components-models`
|
|
252
|
+
* stays in `FORBIDDEN_SPECIFIERS`.
|
|
253
|
+
*/
|
|
254
|
+
'@wildo-ai/presets-components-models/public-runtime',
|
|
255
|
+
/**
|
|
256
|
+
* Decorator package itself — importing it does NOT mutate Zod
|
|
257
|
+
* prototype (only an explicit `initZodDecorators()` call does), so
|
|
258
|
+
* it is bundle-safe to allow. Use cases include build-time
|
|
259
|
+
* decorator-metadata reads on schemas imported from
|
|
260
|
+
* `@wildo-ai/saas-models/public-runtime`. The dangerous side-effect
|
|
261
|
+
* (the actual prototype mutation done by saas-models's root barrel)
|
|
262
|
+
* is still blocked because the saas-models ROOT barrel sits in
|
|
263
|
+
* `FORBIDDEN_SPECIFIERS`.
|
|
264
|
+
*/
|
|
265
|
+
'@wildo-ai/zod-decorators',
|
|
266
|
+
/**
|
|
267
|
+
* SSR / Astro-middleware tier. These four specifiers support server-side code paths
|
|
268
|
+
* the marketing engine genuinely needs:
|
|
269
|
+
* - `axios` — outbound HTTP from Astro middleware (proxy to
|
|
270
|
+
* the SaaS backend, contact-form forwarding, webhook fan-out).
|
|
271
|
+
* - `jsonwebtoken` — verify cross-frontend handoff JWTs in
|
|
272
|
+
* middleware before letting a request reach a logged-in surface.
|
|
273
|
+
* - `socket.io-client` — real-time push (e.g. live preview / status
|
|
274
|
+
* events from the SaaS app to the marketing site).
|
|
275
|
+
* - `reflect-metadata` — decorator metadata runtime; required
|
|
276
|
+
* by any future build-time consumer of `@wildo-ai/zod-decorators`
|
|
277
|
+
* metadata (the import IS side-effecting — it mutates
|
|
278
|
+
* `globalThis.Reflect`; that side effect is acceptable in an
|
|
279
|
+
* SSR context but would still be objectionable in a React
|
|
280
|
+
* island bundle).
|
|
281
|
+
* Allowing them here is a deliberate trade-off: this test no
|
|
282
|
+
* longer guarantees a hard browser-bundle size budget on its own.
|
|
283
|
+
* Application import discipline keeps the React-island side lean.
|
|
284
|
+
*/
|
|
285
|
+
'axios',
|
|
286
|
+
'jsonwebtoken',
|
|
287
|
+
'socket.io-client',
|
|
288
|
+
'reflect-metadata',
|
|
289
|
+
/**
|
|
290
|
+
* SSR / Astro-build-time tier. The
|
|
291
|
+
* `astro.ts` sub-entry exposes the label-pack loader, which
|
|
292
|
+
* reads `<locale>.json` files from disk inside Astro's frontmatter
|
|
293
|
+
* (synchronous I/O is intentional — see `label-pack-loader.ts`
|
|
294
|
+
* preamble). Allowing the three `node:*` builtins below keeps the
|
|
295
|
+
* loader inside the walked closure (so it gets bundle-rule
|
|
296
|
+
* coverage) without leaking Node-only API into the React island
|
|
297
|
+
* side: `bridge-runtime.tsx` does not import any of them, and the
|
|
298
|
+
* test would catch a regression.
|
|
299
|
+
*
|
|
300
|
+
* `node:fs` — synchronous file reads in the label-pack loader.
|
|
301
|
+
* `node:path` — `resolve()` for the per-locale path composition.
|
|
302
|
+
*
|
|
303
|
+
* Other `node:*` builtins are not allowed; if a future MDX
|
|
304
|
+
* loader needs `node:url` or similar, add it here with the same
|
|
305
|
+
* rationale comment + an actual import that lands at the same time.
|
|
306
|
+
*/
|
|
307
|
+
'node:fs',
|
|
308
|
+
'node:path',
|
|
309
|
+
/**
|
|
310
|
+
* `@wildo-ai/platform-config-lib` is the home of
|
|
311
|
+
* `loadConfig<T>(...)` (jiti-backed) and `AppFrontendType`. The
|
|
312
|
+
* Node-only `config-loader.ts` entry uses both to discover and
|
|
313
|
+
* load the per-service `wildo.website.config.ts`. Adding the
|
|
314
|
+
* specifier here covers the bare-import; pinning it as
|
|
315
|
+
* SSR-only below proves it cannot reach the React-island closure.
|
|
316
|
+
*
|
|
317
|
+
* The transitive graph (`jiti`, `node:crypto`, the saas-models
|
|
318
|
+
* decorator framework via `WildoSaasConfig` type imports) is
|
|
319
|
+
* irrelevant to bundle weight on the React-island side because
|
|
320
|
+
* the dedicated subpath separation (`@wildo-ai/saas-website/config-loader`
|
|
321
|
+
* vs `@wildo-ai/saas-website`) keeps the consumer-side imports
|
|
322
|
+
* tree-shake-trivial: a marketing page bundle never reaches into
|
|
323
|
+
* `./config-loader`.
|
|
324
|
+
*/
|
|
325
|
+
'@wildo-ai/platform-config-lib',
|
|
326
|
+
/**
|
|
327
|
+
* `@mdx-js/react` ships the `MDXProvider` React component the
|
|
328
|
+
* `<WebsiteMdxProvider>` wraps. It is browser-safe (the package's
|
|
329
|
+
* own `package.json` declares `"browser": …` entries; no `node:*`
|
|
330
|
+
* surface), tree-shake-friendly (single named export consumed),
|
|
331
|
+
* and a declared peer dependency of the website package.
|
|
332
|
+
*
|
|
333
|
+
* Allowed UNCONDITIONALLY (not pinned as SSR-only) because the
|
|
334
|
+
* provider lives in the React-island bundle by design — it scopes
|
|
335
|
+
* the consumer-supplied `mdxComponents` map for the duration of a
|
|
336
|
+
* blog-post render, which only happens client-side once Astro has
|
|
337
|
+
* hydrated the per-post island.
|
|
338
|
+
*/
|
|
339
|
+
'@mdx-js/react',
|
|
340
|
+
]);
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
## Workflow
|
|
344
|
+
|
|
345
|
+
### Step 1: Decide whether your file is island-tier or SSR-tier
|
|
346
|
+
|
|
347
|
+
- **Island-tier (default)** — any `.tsx` under
|
|
348
|
+
`website/src/{primitives,layouts,sections,pages,i18n}` and any
|
|
349
|
+
module they transitively import. These ship to the browser.
|
|
350
|
+
- **SSR-tier** — files under `website/src/middleware/` (Astro
|
|
351
|
+
middleware), Astro page server-frontmatter blocks marked
|
|
352
|
+
`export const prerender = false`, and any module imported ONLY
|
|
353
|
+
from those entries. These run on the build/server, never in the
|
|
354
|
+
browser.
|
|
355
|
+
|
|
356
|
+
If you cannot decide, treat it as island-tier (strict). It is much
|
|
357
|
+
cheaper to relax the rule when you confirm SSR-only than to discover
|
|
358
|
+
a 200 KB regression in production.
|
|
359
|
+
|
|
360
|
+
### Step 2: Pick the right import for shared atoms
|
|
361
|
+
|
|
362
|
+
| Need | Import path |
|
|
363
|
+
|-----------------------------------------|-------------------------------------------------------------------|
|
|
364
|
+
| Cross-frontend handoff DTOs | `@wildo-ai/saas-models/public-runtime` |
|
|
365
|
+
| Canonical HTTP header keys | `@wildo-ai/saas-models/public-runtime` |
|
|
366
|
+
| `AvailableLanguage` / `TextDirection` | `@wildo-ai/saas-models/public-runtime` (preferred — single door) |
|
|
367
|
+
| Locale atoms not (yet) re-exported | `@wildo-ai/presets-components-models/public-runtime` |
|
|
368
|
+
| Build-time decorator-metadata reads | `@wildo-ai/zod-decorators` (import is side-effect-free) |
|
|
369
|
+
| Schema runtime | `zod` |
|
|
370
|
+
| React component runtime + hooks | `react` |
|
|
371
|
+
| Outbound HTTP from Astro middleware | `axios` — SSR-tier only |
|
|
372
|
+
| JWT verify in Astro middleware | `jsonwebtoken` — SSR-tier only |
|
|
373
|
+
| Real-time push (live preview, status) | `socket.io-client` — SSR-tier preferred |
|
|
374
|
+
| Decorator-metadata runtime polyfill | `reflect-metadata` — SSR-tier only (mutates `globalThis.Reflect`) |
|
|
375
|
+
|
|
376
|
+
NEVER import from `@wildo-ai/saas-models` (root barrel),
|
|
377
|
+
`@wildo-ai/presets-components-models` (root barrel),
|
|
378
|
+
`@wildo-ai/saas-frontend-lib`, `@wildo-ai/saas-backend-lib`,
|
|
379
|
+
`@wildo-ai/external-connectors-models`, `inversify`, `mongoose`,
|
|
380
|
+
`express`, `pino`, `helmet`, `argon2`, or `bcrypt` from any
|
|
381
|
+
website-tier file.
|
|
382
|
+
|
|
383
|
+
### Step 3: SSR-tier discipline
|
|
384
|
+
|
|
385
|
+
`axios`, `jsonwebtoken`, `socket.io-client`, and `reflect-metadata`
|
|
386
|
+
are allowed in the website source closure but ONLY because the
|
|
387
|
+
deferred entry-split is not in place yet. Today this is enforced by
|
|
388
|
+
**developer discipline**:
|
|
389
|
+
|
|
390
|
+
- Put SSR-tier imports inside `website/src/middleware/*.ts` files (or
|
|
391
|
+
files only reachable from middleware entries).
|
|
392
|
+
- NEVER add an SSR-tier import inside a `.tsx` file under
|
|
393
|
+
`primitives/`, `layouts/`, `sections/`, or `pages/` — those are
|
|
394
|
+
reachable from React islands and the import will ship to the browser.
|
|
395
|
+
- `reflect-metadata` is the most dangerous of the four — its import
|
|
396
|
+
side-effects `globalThis.Reflect`. Tolerable on the server, NOT in
|
|
397
|
+
an island bundle.
|
|
398
|
+
|
|
399
|
+
When the deferred entry-split lands (framework package side), the
|
|
400
|
+
`bundle-isolation.test.ts` will start enforcing this distinction
|
|
401
|
+
automatically. Until then, code review is the gate.
|
|
402
|
+
|
|
403
|
+
### Step 4: Verify before opening a PR
|
|
404
|
+
|
|
405
|
+
Run from the repo root:
|
|
406
|
+
|
|
407
|
+
```bash
|
|
408
|
+
pnpm --filter @wildo-ai/saas-website test src/__tests__/bundle-isolation.test.ts
|
|
409
|
+
```
|
|
410
|
+
|
|
411
|
+
If your app-side code lands in the same bundle (typically through a
|
|
412
|
+
barrel re-export from `website/src/index.ts` or via Astro page
|
|
413
|
+
imports), add a mirror test under `frontend/__tests__/` that walks YOUR
|
|
414
|
+
entry files with the same allow-list. Use the engine test as the
|
|
415
|
+
template — copy `ALLOWED_BARE_SPECIFIERS` / `FORBIDDEN_SPECIFIERS` /
|
|
416
|
+
`FORBIDDEN_PATTERNS` and adjust ENTRY_FILES to point at your app
|
|
417
|
+
entries.
|
|
418
|
+
|
|
419
|
+
## Worked Example
|
|
420
|
+
|
|
421
|
+
Override the default `WebsiteButton` primitive with a brand-styled
|
|
422
|
+
variant. The override file CANNOT pull `saas-frontend-lib` (DI
|
|
423
|
+
graph), CANNOT pull the `@wildo-ai/saas-models` root barrel
|
|
424
|
+
(`initZodDecorators()` + ~150 schemas), and SHOULD prefer the
|
|
425
|
+
`/public-runtime` subpath when it needs a shared atom.
|
|
426
|
+
|
|
427
|
+
The full annotated component (allowed/forbidden imports, props
|
|
428
|
+
interface, the React island body) lives in
|
|
429
|
+
`references/example-website-button-override.md`. Read it once, then
|
|
430
|
+
come back here for the per-line "what earns" rationale and the
|
|
431
|
+
"what is not in this block" anti-rationalization that cross-links to
|
|
432
|
+
the Verification grep invariants below.
|
|
433
|
+
|
|
434
|
+
What earns its place:
|
|
435
|
+
|
|
436
|
+
- `import { z } from 'zod'` — peer dep, browser-safe, on the
|
|
437
|
+
allow-list.
|
|
438
|
+
- `import { type AvailableLanguage } from '@wildo-ai/saas-models/public-runtime'`
|
|
439
|
+
— uses the carved subpath, NOT the root barrel. The whole point of
|
|
440
|
+
`/public-runtime` is to ship locale atoms without booting the
|
|
441
|
+
decorator framework.
|
|
442
|
+
- `import { useWebsiteLabel } from '@wildo-ai/saas-website'` — the
|
|
443
|
+
engine itself is bundle-safe (its own boundary test enforces it),
|
|
444
|
+
so importing from its public surface stays inside the budget.
|
|
445
|
+
- NO `saas-frontend-lib` import (would pull `inversify` + the
|
|
446
|
+
resources framework + the SaaS-app HTTP client into the marketing
|
|
447
|
+
bundle).
|
|
448
|
+
- NO `axios` / `jsonwebtoken` / `socket.io-client` /
|
|
449
|
+
`reflect-metadata` import (this file is island-tier; SSR-tier
|
|
450
|
+
imports belong in `website/src/middleware/*.ts`).
|
|
451
|
+
|
|
452
|
+
What is **not** in this block (and shouldn't be):
|
|
453
|
+
|
|
454
|
+
- No root-barrel `@wildo-ai/saas-models` import (catch with the
|
|
455
|
+
**public-runtime is the ONLY door** invariant)
|
|
456
|
+
- No `saas-frontend-lib` / `saas-backend-lib` import (catch with the
|
|
457
|
+
**no app-stack imports in website code** invariant)
|
|
458
|
+
- No SSR-tier dep (`axios`, `jsonwebtoken`, `socket.io-client`,
|
|
459
|
+
`reflect-metadata`) inside an island-tier file (catch with the
|
|
460
|
+
**SSR-tier deps stay in `website/src/middleware/`** review rule)
|
|
461
|
+
|
|
462
|
+
## References
|
|
463
|
+
|
|
464
|
+
- `references/example-website-button-override.md` — the annotated
|
|
465
|
+
worked example for the `## Worked Example` section; read together
|
|
466
|
+
with the SKILL.md "What earns its place" / "What is not in this
|
|
467
|
+
block" bullets. (Tier A promotion path documented in the file
|
|
468
|
+
itself.)
|
|
469
|
+
- `references/website-bundle-rules.md` — embeds the installed package
|
|
470
|
+
contract (`engine.client-bundle.discipline`) + the live allow-list
|
|
471
|
+
(`engine.client-bundle.allow-list`) so app-side authors always see
|
|
472
|
+
the same rules CI enforces.
|
|
473
|
+
- Source-backed bundle-isolation reference — closure-walk test that enforces
|
|
474
|
+
the installed package side. Mirror its
|
|
475
|
+
structure for an app-side test if your `website/src/**` tree
|
|
476
|
+
warrants one.
|
|
477
|
+
|
|
478
|
+
## Verification
|
|
479
|
+
|
|
480
|
+
- [ ] No website-tier file imports from `@wildo-ai/saas-models` root
|
|
481
|
+
barrel (use `@wildo-ai/saas-models/public-runtime` instead)
|
|
482
|
+
- [ ] No website-tier file imports from
|
|
483
|
+
`@wildo-ai/presets-components-models` root barrel (use the
|
|
484
|
+
`/public-runtime` subpath, prefer the saas-models re-export when
|
|
485
|
+
available)
|
|
486
|
+
- [ ] No website-tier file imports `@wildo-ai/saas-frontend-lib`,
|
|
487
|
+
`@wildo-ai/saas-backend-lib`, `@wildo-ai/external-connectors-models`,
|
|
488
|
+
`inversify`, `mongoose`, `express`, `pino`, `helmet`, `argon2`,
|
|
489
|
+
or `bcrypt`
|
|
490
|
+
- [ ] `axios`, `jsonwebtoken`, `socket.io-client`, `reflect-metadata`
|
|
491
|
+
appear ONLY in files under `website/src/middleware/` (or files
|
|
492
|
+
reachable only from middleware entries)
|
|
493
|
+
- [ ] Engine test still green:
|
|
494
|
+
`pnpm --filter @wildo-ai/saas-website test src/__tests__/bundle-isolation.test.ts`
|
|
495
|
+
- [ ] If app-side bundle has its own entry barrel, an app-mirror
|
|
496
|
+
bundle-isolation test exists and is green
|
|
497
|
+
|
|
498
|
+
### Grep invariants
|
|
499
|
+
|
|
500
|
+
Run from the app root:
|
|
501
|
+
|
|
502
|
+
| Invariant | Command |
|
|
503
|
+
|---------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
|
|
504
|
+
| **No root-barrel `saas-models` import in `website/src/`** | `rg -n "from '@wildo-ai/saas-models'" website/src/` |
|
|
505
|
+
| **No root-barrel `presets-components-models` import in `website/src/`** | `rg -n "from '@wildo-ai/presets-components-models'" website/src/` |
|
|
506
|
+
| **No `saas-frontend-lib` import in `website/src/`** | `rg -n "from '@wildo-ai/saas-frontend-lib" website/src/` |
|
|
507
|
+
| **No `saas-backend-lib` import in `website/src/`** | `rg -n "from '@wildo-ai/saas-backend-lib" website/src/` |
|
|
508
|
+
| **No `inversify` in `website/src/`** | `rg -n "from 'inversify'" website/src/` |
|
|
509
|
+
| **SSR-tier deps confined to `middleware/`** | `rg -n "from '(axios\|jsonwebtoken\|socket\.io-client\|reflect-metadata)'" website/src/ -g '!website/src/middleware/**'` |
|
|
510
|
+
|
|
511
|
+
The high-signal invariant is the **last one** — it catches the
|
|
512
|
+
most-common regression (an SSR-tier import sneaking into a `.tsx`
|
|
513
|
+
React-island file).
|
|
514
|
+
|
|
515
|
+
## Common Rationalizations
|
|
516
|
+
|
|
517
|
+
| Rationalization | Reality |
|
|
518
|
+
|-----------------|---------|
|
|
519
|
+
| "I just need ONE schema from saas-models, the root barrel is faster to type" | The root barrel calls `initZodDecorators()` at module load — every visitor's browser pays the cost. Use the `/public-runtime` subpath, or carve the atom you need into `/public-runtime` via the K-2 protocol. |
|
|
520
|
+
| "`reflect-metadata` is tiny, no one will notice" | It mutates `globalThis.Reflect` on import. Acceptable on the server; objectionable in a React island bundle that runs in every visitor's tab. Keep it in `website/src/middleware/`. |
|
|
521
|
+
| "I'll add `axios` to my Hero section to call the SaaS backend directly" | Browser already has `fetch`. Adding `axios` (~60 KB) to a React island is a regression. If you genuinely need `axios`, do the request from an Astro middleware (SSR-tier) and pass the result down. |
|
|
522
|
+
| "The bundle-isolation test passed, I'm fine" | The test catches stack creep (saas-app DI / backend libs / heavy root barrels) but does NOT enforce the island-vs-SSR split today. Code review is still the gate for SSR-tier deps until the entry-split lands. |
|
|
523
|
+
| "saas-frontend-lib has the React component I need" | `saas-frontend-lib` pulls `inversify` + the entire SaaS resource framework. The website is intentionally a self-contained surface. Mirror the small atom you need locally, or override the L1/L1.5 placeholder. |
|
|
524
|
+
|
|
525
|
+
## Red Flags
|
|
526
|
+
|
|
527
|
+
- A new `import` from `@wildo-ai/saas-models` (root barrel) anywhere
|
|
528
|
+
under `website/src/` — repoint to `/public-runtime`
|
|
529
|
+
- A new `import` from `@wildo-ai/saas-frontend-lib` anywhere under
|
|
530
|
+
`website/src/` — mirror the atom locally instead
|
|
531
|
+
- An `axios` / `jsonwebtoken` / `socket.io-client` / `reflect-metadata`
|
|
532
|
+
import in a `.tsx` file under `primitives/`, `layouts/`,
|
|
533
|
+
`sections/`, or `pages/` — relocate to `website/src/middleware/`
|
|
534
|
+
- A sudden bundle-size jump (>20 KB) right after a routine PR —
|
|
535
|
+
inspect every new website-tier import in the diff, especially
|
|
536
|
+
bare-specifier imports
|
|
537
|
+
- An import below `@wildo-ai/saas-models` that is not a declared semantic
|
|
538
|
+
entrypoint (for example, use the documented `/public-runtime` entrypoint
|
|
539
|
+
only where its browser-safe vocabulary is required)
|
|
540
|
+
|
|
541
|
+
## Related Skills
|
|
542
|
+
|
|
543
|
+
- `website-page-authoring` — page composition (consumer of this
|
|
544
|
+
contract)
|
|
545
|
+
- `website_section_*` (the 9 category skills) — section authoring
|
|
546
|
+
(consumer of this contract)
|
|
547
|
+
- `website-primitive-overrides` — L1 primitive overrides (must obey
|
|
548
|
+
this contract)
|
|
549
|
+
- `website-layout-overrides` — L1.5 layout overrides (must obey
|
|
550
|
+
this contract)
|
|
551
|
+
- `website-label-pack` — label packs (must obey this contract)
|
|
552
|
+
- `engine-component-registration` — app-side engine wiring outside
|
|
553
|
+
the website surface (different bundle, different rules)
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Example: WebsiteButton Override (Island-Tier File)
|
|
2
|
+
|
|
3
|
+
Annotated worked example for the `## Worked Example` section of
|
|
4
|
+
`SKILL.md`. The override file CANNOT pull `saas-frontend-lib` (DI
|
|
5
|
+
graph), CANNOT pull the `@wildo-ai/saas-models` root barrel
|
|
6
|
+
(`initZodDecorators()` + ~150 schemas), and SHOULD prefer the
|
|
7
|
+
`/public-runtime` subpath when it needs a shared atom.
|
|
8
|
+
|
|
9
|
+
```tsx
|
|
10
|
+
// website/src/primitives/WebsiteButton.tsx
|
|
11
|
+
//
|
|
12
|
+
// ✅ ALLOWED imports (island-tier file)
|
|
13
|
+
import { type ReactNode } from 'react';
|
|
14
|
+
import { z } from 'zod';
|
|
15
|
+
import { type AvailableLanguage } from '@wildo-ai/saas-models/public-runtime';
|
|
16
|
+
import { useWebsiteLabel } from '@wildo-ai/saas-website';
|
|
17
|
+
//
|
|
18
|
+
// ❌ FORBIDDEN — would explode the marketing bundle:
|
|
19
|
+
// import { CrossFrontendHandoffRequestSchema } from '@wildo-ai/saas-models';
|
|
20
|
+
// ↑ root barrel — boots initZodDecorators(), pulls reflect-metadata
|
|
21
|
+
// + ~150 schemas + @wildo-ai/external-connectors-models
|
|
22
|
+
// import { Container } from 'inversify';
|
|
23
|
+
// ↑ DI graph — backend-only
|
|
24
|
+
// import { useAuthSession } from '@wildo-ai/saas-frontend-lib';
|
|
25
|
+
// ↑ saas-app frontend lib — pulls inversify + the entire resource framework
|
|
26
|
+
|
|
27
|
+
interface WebsiteButtonProps {
|
|
28
|
+
readonly labelKey: string;
|
|
29
|
+
readonly onClick: () => void;
|
|
30
|
+
readonly children?: ReactNode;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export const WebsiteButton = ({ labelKey, onClick, children }: WebsiteButtonProps) => {
|
|
34
|
+
const label = useWebsiteLabel(labelKey);
|
|
35
|
+
return (
|
|
36
|
+
<button type="button" onClick={onClick} className="brand-btn">
|
|
37
|
+
{children ?? label}
|
|
38
|
+
</button>
|
|
39
|
+
);
|
|
40
|
+
};
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
The SKILL.md "Worked Example" section unpacks what each line earns and
|
|
44
|
+
what is **not** in this block (and shouldn't be). Read this file
|
|
45
|
+
together with those bullets — they cross-link to the Verification grep
|
|
46
|
+
invariants directly below.
|
|
47
|
+
|
|
48
|
+
> **Future work** — promote to Tier A by anchoring this exact file
|
|
49
|
+
> under `website/src/primitives/` with
|
|
50
|
+
> `example.website.bundle-discipline.button-override` and
|
|
51
|
+
> `example.website.bundle-discipline.button-override`
|
|
52
|
+
> here.
|