@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,263 @@
|
|
|
1
|
+
# platform.config.environment.deployment
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/platform-config-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Convenience environment ids kept for common local/staging/production setups.
|
|
14
|
+
*
|
|
15
|
+
* The project model is no longer limited to a fixed environment set: remote
|
|
16
|
+
* environment ids can be any slug-like value. Use `WildoEnvironmentIdSchema`
|
|
17
|
+
* for authoritative validation.
|
|
18
|
+
*/
|
|
19
|
+
export enum WildoEnvironment {
|
|
20
|
+
LOCAL = 'local',
|
|
21
|
+
STAGING = 'staging',
|
|
22
|
+
PRODUCTION = 'production',
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export const WildoEnvironmentIdSchema = z
|
|
26
|
+
.string()
|
|
27
|
+
.min(1)
|
|
28
|
+
.regex(
|
|
29
|
+
/^[a-z0-9]+(?:-[a-z0-9]+)*$/,
|
|
30
|
+
'environment ids must be lowercase alphanumeric with optional hyphen-separated segments',
|
|
31
|
+
);
|
|
32
|
+
export type WildoEnvironmentId = z.infer<typeof WildoEnvironmentIdSchema>;
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Deployment runtime targets for CI/CD workflows and infra config.
|
|
36
|
+
*
|
|
37
|
+
* Single source of truth for deployment runtime targets, used by both
|
|
38
|
+
* platform-config-lib (developer-facing config) and wildo-cli (operational).
|
|
39
|
+
*/
|
|
40
|
+
export enum WildoDeploymentRuntime {
|
|
41
|
+
DOCKER_COMPOSE = 'docker-compose',
|
|
42
|
+
KUBERNETES = 'kubernetes',
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export enum WildoLocationType {
|
|
46
|
+
LOCAL = 'local',
|
|
47
|
+
REMOTE = 'remote',
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export function isLocalEnvironmentId(environmentId: string): boolean {
|
|
51
|
+
return environmentId === WildoEnvironment.LOCAL;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* K8s-internal cluster topology. Holds ONLY values that are genuinely
|
|
56
|
+
* specific to a Kubernetes deployment (the namespace and the optional
|
|
57
|
+
* ingress class).
|
|
58
|
+
*
|
|
59
|
+
* The external/public hostname (where browsers and reverse proxies hit
|
|
60
|
+
* us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
|
|
61
|
+
* as `publicDomain` because it applies to BOTH `KUBERNETES` and
|
|
62
|
+
* `DOCKER_COMPOSE` runtimes. See `external-public-domain-rename.md`
|
|
63
|
+
* for the rationale (the previous `baseDomain` field on this object
|
|
64
|
+
* conflated K8s-internal and reverse-proxy concerns).
|
|
65
|
+
*/
|
|
66
|
+
export const WildoKubernetesConfigSchema = z.object({
|
|
67
|
+
namespace: z.string().min(1),
|
|
68
|
+
ingressClass: z.string().min(1).optional(),
|
|
69
|
+
});
|
|
70
|
+
export type WildoKubernetesConfig = z.infer<typeof WildoKubernetesConfigSchema>;
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* cert-manager `ClusterIssuer` selection for remote TLS. Both issuers are
|
|
74
|
+
* always provisioned in the cluster (see `cluster-issuer.yaml.hbs`); this
|
|
75
|
+
* picks which one an application's ingress annotation
|
|
76
|
+
* (`cert-manager.io/cluster-issuer`) points at — i.e. which ACME endpoint
|
|
77
|
+
* issues its per-ingress certificate.
|
|
78
|
+
*
|
|
79
|
+
* - `LETSENCRYPT_PROD` — real, browser-trusted certificates. The default,
|
|
80
|
+
* because a remote deployment implies a real domain that browsers must
|
|
81
|
+
* trust. Subject to Let's Encrypt production rate limits
|
|
82
|
+
* (50 certs / registered domain / week).
|
|
83
|
+
* - `LETSENCRYPT_STAGING` — untrusted test certificates with far higher
|
|
84
|
+
* rate limits. Opt into this **while validating DNS + ingress on a new
|
|
85
|
+
* cluster** so a misconfigured first deploy cannot exhaust the prod
|
|
86
|
+
* quota, then flip to prod once issuance succeeds.
|
|
87
|
+
*/
|
|
88
|
+
export enum WildoTlsIssuer {
|
|
89
|
+
LETSENCRYPT_PROD = 'letsencrypt-prod',
|
|
90
|
+
LETSENCRYPT_STAGING = 'letsencrypt-staging',
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
export const WildoRemoteProviderSchema = z.object({
|
|
94
|
+
provider: z.string().min(1),
|
|
95
|
+
registryEndpoint: z.string().min(1),
|
|
96
|
+
region: z.string().min(1).optional(),
|
|
97
|
+
/**
|
|
98
|
+
* ACME registration email for Let's Encrypt (`ClusterIssuer.spec.acme.email`).
|
|
99
|
+
* Optional at the schema level so non-TLS remote configs parse, but a
|
|
100
|
+
* remote Kubernetes environment that terminates TLS should author it —
|
|
101
|
+
* Let's Encrypt uses it for expiry warnings and account recovery.
|
|
102
|
+
*/
|
|
103
|
+
acmeEmail: z.email().optional(),
|
|
104
|
+
/**
|
|
105
|
+
* Which cert-manager `ClusterIssuer` this environment's ingresses use.
|
|
106
|
+
* Defaults to `LETSENCRYPT_PROD` downstream when unset. See {@link WildoTlsIssuer}.
|
|
107
|
+
*/
|
|
108
|
+
tlsIssuer: z.enum(WildoTlsIssuer).optional(),
|
|
109
|
+
});
|
|
110
|
+
export type WildoRemoteProvider = z.infer<typeof WildoRemoteProviderSchema>;
|
|
111
|
+
|
|
112
|
+
export const WildoLoggingConfigSchema = z.object({
|
|
113
|
+
level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
|
|
114
|
+
formattedConsoleErrors: z.boolean().optional(),
|
|
115
|
+
});
|
|
116
|
+
export type WildoLoggingConfig = z.infer<typeof WildoLoggingConfigSchema>;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Per-environment OTLP telemetry (traces + metrics + logs) posture (Slice 2 Phase 5).
|
|
120
|
+
*
|
|
121
|
+
* `env-vars-builder` projects this block onto the standard `OTEL_*` env vars that the
|
|
122
|
+
* `otel-preload.ts` SDK (in `saas-backend-lib`) reads BEFORE app code:
|
|
123
|
+
* - `enabled` → `OTEL_ENABLED` (the master gate) + drives the `--import` preload wiring.
|
|
124
|
+
* - `endpoint` → `OTEL_EXPORTER_OTLP_ENDPOINT` (the OTLP/HTTP collector/ingest URL).
|
|
125
|
+
* The provider auth header (`OTEL_EXPORTER_OTLP_HEADERS`) is NOT authored here — it is
|
|
126
|
+
* derived by `env-vars-builder` from the selected `OBSERVABILITY_TELEMETRY` provider's
|
|
127
|
+
* secret (e.g. a BetterStack source token). Persisted into `PlatformEnvConfigJson.observability`
|
|
128
|
+
* and hydrated back by `hydrateEnvironmentFromConfig`, mirroring `logging`.
|
|
129
|
+
*/
|
|
130
|
+
export const WildoObservabilityConfigSchema = z.object({
|
|
131
|
+
/**
|
|
132
|
+
* Master switch for OTLP telemetry. `true` → emit `OTEL_ENABLED=true` + wire the
|
|
133
|
+
* `--import @wildo-ai/saas-backend-lib/otel-preload` preload; the preload starts the SDK.
|
|
134
|
+
* `false`/omitted → a complete no-op (the preload self-gates).
|
|
135
|
+
*/
|
|
136
|
+
enabled: z.boolean().default(false),
|
|
137
|
+
/**
|
|
138
|
+
* OTLP/HTTP endpoint (`OTEL_EXPORTER_OTLP_ENDPOINT`). Local dev: the local `otel-collector`
|
|
139
|
+
* (`http://localhost:4318`). Remote: the selected provider's ingesting host (e.g. a BetterStack
|
|
140
|
+
* source URL). When omitted, the OTLP exporters fall back to their own default
|
|
141
|
+
* (`http://localhost:4318`), which is the local collector — convenient for local dev.
|
|
142
|
+
*/
|
|
143
|
+
endpoint: z.string().optional(),
|
|
144
|
+
/**
|
|
145
|
+
* LLM-call observability env-layer posture — a SEPARATE signal from OTLP
|
|
146
|
+
* telemetry (fed by the engine `AgentCallTraceSink` into the selected
|
|
147
|
+
* `LLM_OBSERVABILITY` provider, e.g. PostHog `$ai_generation`), colocated
|
|
148
|
+
* here because both are per-environment observability posture. Projected
|
|
149
|
+
* onto the `WILDO_LLM_OBS_*` env vars INDEPENDENTLY of the OTLP `enabled`
|
|
150
|
+
* gate — LLM-obs activation is provider-selection-driven, not
|
|
151
|
+
* `OTEL_ENABLED`-driven.
|
|
152
|
+
*/
|
|
153
|
+
llmObservability: z.object({
|
|
154
|
+
/**
|
|
155
|
+
* Forward prompt + completion content (`$ai_input` / `$ai_output_choices`)
|
|
156
|
+
* to the LLM-observability provider (→ `WILDO_LLM_OBS_CAPTURE_CONTENT`).
|
|
157
|
+
* Default FALSE: content is user/app data (PII) shipped to a third party —
|
|
158
|
+
* opt in per environment (local dev typically true; production a
|
|
159
|
+
* deliberate decision).
|
|
160
|
+
*/
|
|
161
|
+
captureContent: z.boolean().default(false),
|
|
162
|
+
/**
|
|
163
|
+
* Fraction (0..1) of agent calls forwarded (→ `WILDO_LLM_OBS_SAMPLE_RATE`).
|
|
164
|
+
* Omitted = capture every call.
|
|
165
|
+
*/
|
|
166
|
+
sampleRate: z.number().min(0).max(1).optional(),
|
|
167
|
+
/**
|
|
168
|
+
* NON-SECRET env for the selected LLM-observability provider — connection
|
|
169
|
+
* details the provider module reads from the runtime env (e.g. PostHog's
|
|
170
|
+
* `POSTHOG_HOST` ingestion host and `POSTHOG_PROJECT_ID`). Projected
|
|
171
|
+
* verbatim into the runtime env; the env-key names are provider-owned,
|
|
172
|
+
* same vocabulary as `secrets.json → providerEnv`. Secrets (API keys)
|
|
173
|
+
* do NOT belong here — they stay in `secrets.json → providerEnv`, which
|
|
174
|
+
* also WINS on a key collision (secrets are the more specific layer).
|
|
175
|
+
* This is the checked-in home for provider config that is not sensitive.
|
|
176
|
+
*/
|
|
177
|
+
providerEnv: z.record(z.string(), z.string()).optional(),
|
|
178
|
+
}).optional(),
|
|
179
|
+
});
|
|
180
|
+
export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSchema>;
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Per-environment external-provider SELECTION override (2026-07-10).
|
|
184
|
+
*
|
|
185
|
+
* The app-wide primary/fallback selection for an `EngineCapability` lives in
|
|
186
|
+
* `wildo.saas.config.ts` (`providers.scopes.backend.selection[capability]`) —
|
|
187
|
+
* a single value shared by every environment. This block lets an environment
|
|
188
|
+
* OVERRIDE that primary (and fallbacks) without touching the shared SaaS
|
|
189
|
+
* config, so e.g. LOCAL can select the non-sending `email-preview` provider
|
|
190
|
+
* for `EMAIL_TRANSACTIONAL` while staging/production keep `resend`.
|
|
191
|
+
*
|
|
192
|
+
* Semantics (mirrors the SaaS-side selection policy):
|
|
193
|
+
* - `primary` — the ref that wins for this capability in this environment.
|
|
194
|
+
* - `fallbacks` — ordered failover refs (optional).
|
|
195
|
+
*
|
|
196
|
+
* The referenced provider must still be DECLARED in
|
|
197
|
+
* `providers.scopes.backend.providers` and available for the capability — the
|
|
198
|
+
* backend's availability/enabled filtering is unchanged, so an override that
|
|
199
|
+
* names an undeclared or capability-disabled provider resolves to nothing
|
|
200
|
+
* (same fail-closed behaviour as an equivalent SaaS-side selection). FAN_OUT
|
|
201
|
+
* capabilities ignore the override (every declared provider is active — a
|
|
202
|
+
* primary/failover is meaningless), matching the SaaS-side rule.
|
|
203
|
+
*
|
|
204
|
+
* `env-vars-builder` serializes this block to the `WILDO_PROVIDER_SELECTION_OVERRIDES`
|
|
205
|
+
* backend env var (JSON); `ExternalProvidersRegistryBackendService` reads it and
|
|
206
|
+
* applies it over the SaaS-config selection at capability-resolution time.
|
|
207
|
+
* Persisted into `PlatformEnvConfigJson.providerSelection` and hydrated back by
|
|
208
|
+
* `hydrateEnvironmentFromConfig`, mirroring `logging` / `observability`.
|
|
209
|
+
*/
|
|
210
|
+
export const WildoProviderSelectionOverrideEntrySchema = z.strictObject({
|
|
211
|
+
primary: z.string().min(1),
|
|
212
|
+
fallbacks: z.array(z.string().min(1)).optional(),
|
|
213
|
+
});
|
|
214
|
+
export type WildoProviderSelectionOverrideEntry = z.infer<typeof WildoProviderSelectionOverrideEntrySchema>;
|
|
215
|
+
|
|
216
|
+
export const WildoProviderSelectionOverridesSchema = z.partialRecord(
|
|
217
|
+
z.enum(EngineCapability),
|
|
218
|
+
WildoProviderSelectionOverrideEntrySchema,
|
|
219
|
+
);
|
|
220
|
+
export type WildoProviderSelectionOverrides = z.infer<typeof WildoProviderSelectionOverridesSchema>;
|
|
221
|
+
|
|
222
|
+
export enum DatabaseEngine {
|
|
223
|
+
MONGODB = 'mongodb',
|
|
224
|
+
POSTGRESQL = 'postgresql',
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
export enum WildoImageTagStrategy {
|
|
228
|
+
COMMIT_SHA = 'commit-sha',
|
|
229
|
+
BRANCH_NAME = 'branch-name',
|
|
230
|
+
SEMVER = 'semver',
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Docker Compose deployment — no scaling, no K8s-specific fields.
|
|
235
|
+
*/
|
|
236
|
+
export const DockerComposeDeploymentSchema = z.object({
|
|
237
|
+
branch: z.string().min(1),
|
|
238
|
+
runtime: z.literal(WildoDeploymentRuntime.DOCKER_COMPOSE),
|
|
239
|
+
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* Kubernetes deployment — includes registry, namespace, and scaling support.
|
|
244
|
+
*/
|
|
245
|
+
export const KubernetesDeploymentSchema = z.object({
|
|
246
|
+
branch: z.string().min(1),
|
|
247
|
+
runtime: z.literal(WildoDeploymentRuntime.KUBERNETES),
|
|
248
|
+
registry: z.string().min(1).optional(),
|
|
249
|
+
namespace: z.string().min(1).optional(),
|
|
250
|
+
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
251
|
+
});
|
|
252
|
+
|
|
253
|
+
/**
|
|
254
|
+
* Deployment configuration for CI/CD pipeline integration.
|
|
255
|
+
* Discriminated on `runtime`: K8s-specific fields (`registry`, `namespace`)
|
|
256
|
+
* are only available when `runtime` is `KUBERNETES`.
|
|
257
|
+
*/
|
|
258
|
+
export const WildoDeploymentConfigSchema = z.discriminatedUnion('runtime', [
|
|
259
|
+
DockerComposeDeploymentSchema,
|
|
260
|
+
KubernetesDeploymentSchema,
|
|
261
|
+
]);
|
|
262
|
+
export type WildoDeploymentConfig = z.infer<typeof WildoDeploymentConfigSchema>;
|
|
263
|
+
```
|
|
@@ -0,0 +1,405 @@
|
|
|
1
|
+
# platform.config.saas
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/platform-config-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Root `wildo.saas.config.ts` application declaration: services, modules,
|
|
14
|
+
* engine capabilities, provider scopes, provider configurations and data
|
|
15
|
+
* services. Import `defineSaasConfig` from `@wildo-ai/platform-config-lib` and
|
|
16
|
+
* keep cross-service choices here rather than scattering them through runtime
|
|
17
|
+
* source files.
|
|
18
|
+
*/
|
|
19
|
+
/**
|
|
20
|
+
* The root schema is `z.strictObject` (not `z.object`) so that authoring an
|
|
21
|
+
* unknown top-level key surfaces as a
|
|
22
|
+
* Zod parse error at `defineSaasConfig` time instead of being silently
|
|
23
|
+
* dropped. A typoed `dataServises:` block (or a removed-then-re-introduced
|
|
24
|
+
* `secretsSharingPolicy`) would otherwise compile cleanly, parse cleanly,
|
|
25
|
+
* and produce no runtime warning — exactly the failure mode the
|
|
26
|
+
* `@unimplemented` machinery exists to prevent. The fail-closed posture
|
|
27
|
+
* trades a slightly louder authoring boundary for a guarantee that every
|
|
28
|
+
* authored top-level concern is either consumed or explicitly rejected.
|
|
29
|
+
*/
|
|
30
|
+
export const WildoSaasConfigSchema = z.strictObject({
|
|
31
|
+
/**
|
|
32
|
+
* Authored schema-format version for this `wildo.saas.config.ts`,
|
|
33
|
+
* expressed as a **SemVer 2.0.0 string** (e.g. `'1.0.0'`,
|
|
34
|
+
* `'2.3.1-rc.1'`, `'1.0.0+build.42'`).
|
|
35
|
+
*
|
|
36
|
+
* SemVer (not a bare integer) keeps MAJOR-vs-MINOR-vs-PATCH meaning explicit
|
|
37
|
+
* for future configuration evolution — bare integers conflate "breaking", "feature
|
|
38
|
+
* add" and "bug-fix" into a single dimension and force every bump to
|
|
39
|
+
* look like a breaking change.
|
|
40
|
+
*
|
|
41
|
+
* The field is intentionally optional (no Zod default) so unauthored
|
|
42
|
+
* configurations stay silent. Version-based migration enforcement is not
|
|
43
|
+
* available yet; an authored value records intent but does not itself perform
|
|
44
|
+
* a migration or authorize an incompatible configuration.
|
|
45
|
+
*/
|
|
46
|
+
version: WildoSchemaVersionSchema.optional(),
|
|
47
|
+
name: z.string().min(1),
|
|
48
|
+
slug: z.string().min(1).regex(/^[a-z0-9-]+$/, 'slug must be lowercase alphanumeric with hyphens'),
|
|
49
|
+
displayName: z.string().min(1),
|
|
50
|
+
description: z.string().optional(),
|
|
51
|
+
type: z.literal('saas'),
|
|
52
|
+
|
|
53
|
+
services: z.record(z.string(), AppServiceDefinitionSchema),
|
|
54
|
+
modules: ApplicationModulesSchema,
|
|
55
|
+
libraries: z.record(z.string(), AppLibraryDefinitionSchema).optional(),
|
|
56
|
+
specifications: AppRefSchema.optional(),
|
|
57
|
+
/**
|
|
58
|
+
* Long-running "minion" actor hosts (scheduled or always-up).
|
|
59
|
+
*
|
|
60
|
+
* Each entry can declare a `resourceAccess` read/write whitelist. The
|
|
61
|
+
* current configuration parser accepts the declaration, but a minion runtime
|
|
62
|
+
* does not consume or enforce it yet. Do not rely on this field as an access
|
|
63
|
+
* control until the installed runtime exposes that capability.
|
|
64
|
+
*/
|
|
65
|
+
minions: z.record(z.string(), MinionBucketEntrySchema).optional(),
|
|
66
|
+
/**
|
|
67
|
+
* HTTP-only "worker" subprocesses (compute-heavy, often Rust/Go).
|
|
68
|
+
*
|
|
69
|
+
* The current configuration parser accepts these declarations, but a worker
|
|
70
|
+
* runtime is not available yet. Workers have no `resourceAccess` field
|
|
71
|
+
* because they do not receive database access by default; a resource
|
|
72
|
+
* whitelist would therefore be misleading.
|
|
73
|
+
*/
|
|
74
|
+
workers: z.record(z.string(), AppRefSchema).optional(),
|
|
75
|
+
|
|
76
|
+
engineCapabilities: EngineCapabilityActivationsSchema,
|
|
77
|
+
providerConfigurations: ProviderConfigurationsSchema,
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Per-facet provider registries.
|
|
81
|
+
*
|
|
82
|
+
* Authored as a `z.custom` because the value is a constructed object
|
|
83
|
+
* (registry instances carry methods like `getProviderByRef`); strict
|
|
84
|
+
* runtime parsing of method-bearing values is intentionally skipped
|
|
85
|
+
* — the application/provider composition boundary enforces the registry
|
|
86
|
+
* invariants.
|
|
87
|
+
*
|
|
88
|
+
* See the `SaasConfigProvidersBlock` JSDoc above for the role of each
|
|
89
|
+
* registry facet.
|
|
90
|
+
*/
|
|
91
|
+
providers: SaasConfigProvidersBlockSchema,
|
|
92
|
+
|
|
93
|
+
bootstrap: AppBootstrapSchema.optional(),
|
|
94
|
+
dataServices: AppDataServicesSchema,
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* How long this application keeps each class of data, and why.
|
|
98
|
+
*
|
|
99
|
+
* Declared HERE, beside `dataServices`, because the two describe the same thing from opposite ends:
|
|
100
|
+
* `dataServices` says which stores exist, and this says how long what is in them is kept. Both are
|
|
101
|
+
* application-wide operator decisions rather than per-resource authoring.
|
|
102
|
+
*
|
|
103
|
+
* Optional as a whole, and partial within itself. An application that has decided nothing omits it;
|
|
104
|
+
* one that has decided only its customer-data period declares only that. Absence is never read as
|
|
105
|
+
* "kept forever" — a compliance document states the classes that ARE declared and marks the rest as
|
|
106
|
+
* needing an operator decision, which is what lets the document be produced today rather than
|
|
107
|
+
* waiting on a number nobody has yet.
|
|
108
|
+
*
|
|
109
|
+
* Two consumers, and the second is why the classes are the STORES: a privacy notice's retention
|
|
110
|
+
* paragraph (issue #89, which is why this exists), and the backup-and-restore inventory a remote
|
|
111
|
+
* environment still has none of (issue #8) — one declaration answers both instead of two that drift.
|
|
112
|
+
*/
|
|
113
|
+
dataRetention: ApplicationRetentionScheduleSchema.optional(),
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Whether each AI capability this application enables DECIDES something about a person, and who
|
|
117
|
+
* reviews it if so.
|
|
118
|
+
*
|
|
119
|
+
* A capability establishes that AI is in use and for what function; it cannot establish consequence,
|
|
120
|
+
* because the same `AI_LLM` backs a summariser that decides nothing and a screener that decides a
|
|
121
|
+
* great deal (issue #92).
|
|
122
|
+
*
|
|
123
|
+
* Optional and partial, like `dataRetention` — but the silence here is the more dangerous one. A
|
|
124
|
+
* notice describing AI use without addressing consequence does not read as "unknown", it reads as
|
|
125
|
+
* "nothing significant happens", which silently claims an exemption. So an enabled AI capability with
|
|
126
|
+
* no entry is REPORTED as outstanding rather than assumed harmless.
|
|
127
|
+
*/
|
|
128
|
+
aiUsePosture: ApplicationAiUsePostureSchema.optional(),
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* What this application stores in a visitor's browser, per FRONTEND SURFACE — the itemised table a
|
|
132
|
+
* cookie notice IS (issue #91).
|
|
133
|
+
*
|
|
134
|
+
* Per surface because a public marketing site and the authenticated application set different things,
|
|
135
|
+
* and one merged list would be wrong for both. The FRAMEWORK's own cookies are not declared here:
|
|
136
|
+
* every application inherits them and none authored them, so they are answered by
|
|
137
|
+
* `ENGINE_CLIENT_STORAGE_ENTRIES` and reported separately.
|
|
138
|
+
*
|
|
139
|
+
* Optional and partial. A surface with no entry has not been inventoried and is reported as such; an
|
|
140
|
+
* empty ARRAY is the different, positive answer — this surface sets nothing of its own.
|
|
141
|
+
*/
|
|
142
|
+
clientStorage: ApplicationClientStorageInventorySchema.optional(),
|
|
143
|
+
operatorComplianceIdentity: ApplicationOperatorComplianceIdentitySchema.optional(),
|
|
144
|
+
providerComplianceChoices: ApplicationProviderComplianceChoicesSchema.optional(),
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* Module registries the app pulls modules from. Each entry pairs a
|
|
148
|
+
* stable id (used by lockfile entries + the `--registry <id>` CLI
|
|
149
|
+
* flag) with a registry HTTP origin. Optional — when omitted, CLI
|
|
150
|
+
* commands fall back to alias resolution (`local` / `public`) or
|
|
151
|
+
* the env-policy default (`WILDO_FRAMEWORK_DEVELOPER` → local;
|
|
152
|
+
* else public).
|
|
153
|
+
*
|
|
154
|
+
* Example: `[{ id: 'wildo', url: 'https://registry.wildo.ai' }]`
|
|
155
|
+
*
|
|
156
|
+
* Credentials never live here — they live per-machine under
|
|
157
|
+
* the local Wildo credential store. This config only points at endpoints.
|
|
158
|
+
*/
|
|
159
|
+
moduleRegistries: RegistryConfigSchema.optional(),
|
|
160
|
+
|
|
161
|
+
// Technical-documentation and marketing-website configuration belong in
|
|
162
|
+
// their respective service folders as
|
|
163
|
+
// `wildo.tech-doc.config.ts` and `wildo.website.config.ts`,
|
|
164
|
+
// co-located with the public packages that own their semantics
|
|
165
|
+
// (`@wildo-ai/saas-technical-doc` and `@wildo-ai/saas-website`). The
|
|
166
|
+
// schemas, types, `defineXxxConfig` helpers, and (for website) the
|
|
167
|
+
// jiti-backed loader now live entirely in those packages.
|
|
168
|
+
// The dev companion / Astro build discover and load each per-service
|
|
169
|
+
// file via the unique service of the matching `frontendType`. The
|
|
170
|
+
// single-frontend-per-kind constraint enforced by the `superRefine`
|
|
171
|
+
// below guarantees that "the TECH_DOC service folder" and "the
|
|
172
|
+
// STATIC_WEBSITE service folder" are unambiguous.
|
|
173
|
+
}).superRefine((config, ctx) => {
|
|
174
|
+
const availableServiceKeys = new Set(Object.keys(config.services));
|
|
175
|
+
const frontendServiceKeys = new Set(
|
|
176
|
+
Object.entries(config.services)
|
|
177
|
+
.filter(([, definition]) => definition.frontendType !== undefined)
|
|
178
|
+
.map(([serviceKey]) => serviceKey),
|
|
179
|
+
);
|
|
180
|
+
|
|
181
|
+
for (const [moduleId, moduleBinding] of Object.entries(config.modules ?? {})) {
|
|
182
|
+
for (const serviceKey of moduleBinding.services) {
|
|
183
|
+
if (availableServiceKeys.has(serviceKey)) {
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
ctx.addIssue({
|
|
188
|
+
code: 'custom',
|
|
189
|
+
path: ['modules', moduleId, 'services'],
|
|
190
|
+
message: `Module "${moduleId}" references unknown service "${serviceKey}".`,
|
|
191
|
+
});
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// Minion/worker bucket keys are RFC1123-normalized (via `buildMinionServiceName`
|
|
196
|
+
// / `buildWorkerServiceName`) into the k8s object / built image / compose service
|
|
197
|
+
// / worker dispatch-host DNS name at deploy time. camelCase keys are ACCEPTED and
|
|
198
|
+
// normalized — matching the `services.<key>` convention and the existing
|
|
199
|
+
// `WILDO_WORKER_<NAME>_URL` env-key normalization — but two keys that COLLAPSE to
|
|
200
|
+
// the same DNS name would silently deploy as ONE Service/image, and a key that
|
|
201
|
+
// normalizes to EMPTY (all-symbol) would emit an invalid trailing-hyphen name.
|
|
202
|
+
// Fail fast at authoring on either, independently per background-runtime map.
|
|
203
|
+
// The full generated deploy name is `{slug}-{minion|worker}-{dnsName}`. It is
|
|
204
|
+
// used as the k8s Service `metadata.name` AND the `app.kubernetes.io/name` label
|
|
205
|
+
// value — both bounded by the RFC1123 label limit of 63 chars. A longer name is
|
|
206
|
+
// rejected by kubectl at deploy time (and by Docker for the image tag), so fail
|
|
207
|
+
// fast at authoring rather than let CI/deploy blow up. Truncating instead would
|
|
208
|
+
// be a silent "trick" that risks a collision with a sibling key — rejected.
|
|
209
|
+
const K8S_LABEL_MAX_LENGTH = 63;
|
|
210
|
+
for (const [mapLabel, bucket, buildServiceName] of [
|
|
211
|
+
['minions', config.minions, buildMinionServiceName],
|
|
212
|
+
['workers', config.workers, buildWorkerServiceName],
|
|
213
|
+
] as const) {
|
|
214
|
+
if (!bucket) continue;
|
|
215
|
+
const dnsNameToKey = new Map<string, string>();
|
|
216
|
+
for (const bucketKey of Object.keys(bucket)) {
|
|
217
|
+
const dnsName = normalizeServiceKeyToDnsName(bucketKey);
|
|
218
|
+
if (dnsName.length === 0) {
|
|
219
|
+
ctx.addIssue({
|
|
220
|
+
code: 'custom',
|
|
221
|
+
path: [mapLabel, bucketKey],
|
|
222
|
+
message:
|
|
223
|
+
`${mapLabel} key "${bucketKey}" normalizes to an empty DNS name — it must contain at least ` +
|
|
224
|
+
`one [a-z0-9] character so the deployed k8s Service / image name is valid (e.g. "market-scraper").`,
|
|
225
|
+
});
|
|
226
|
+
continue;
|
|
227
|
+
}
|
|
228
|
+
const serviceName = buildServiceName(config.slug, bucketKey);
|
|
229
|
+
if (serviceName.length > K8S_LABEL_MAX_LENGTH) {
|
|
230
|
+
ctx.addIssue({
|
|
231
|
+
code: 'custom',
|
|
232
|
+
path: [mapLabel, bucketKey],
|
|
233
|
+
message:
|
|
234
|
+
`${mapLabel} key "${bucketKey}" generates the deploy name "${serviceName}" ` +
|
|
235
|
+
`(${serviceName.length} chars), exceeding the ${K8S_LABEL_MAX_LENGTH}-char RFC1123 limit for a ` +
|
|
236
|
+
`k8s Service / label name. Shorten the ${mapLabel.slice(0, -1)} key or the app slug ("${config.slug}").`,
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
const existing = dnsNameToKey.get(dnsName);
|
|
240
|
+
if (existing !== undefined) {
|
|
241
|
+
ctx.addIssue({
|
|
242
|
+
code: 'custom',
|
|
243
|
+
path: [mapLabel, bucketKey],
|
|
244
|
+
message:
|
|
245
|
+
`${mapLabel} keys "${existing}" and "${bucketKey}" both normalize to the DNS name "${dnsName}" — ` +
|
|
246
|
+
`they would deploy as the SAME k8s Service / image / compose service. Rename one so the normalized names differ.`,
|
|
247
|
+
});
|
|
248
|
+
continue;
|
|
249
|
+
}
|
|
250
|
+
dnsNameToKey.set(dnsName, bucketKey);
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
const scopeBuckets: Record<string, ReadonlySet<string>> = {
|
|
255
|
+
services: availableServiceKeys,
|
|
256
|
+
minions: new Set(Object.keys(config.minions ?? {})),
|
|
257
|
+
workers: new Set(Object.keys(config.workers ?? {})),
|
|
258
|
+
};
|
|
259
|
+
|
|
260
|
+
const validateProviderScope = (
|
|
261
|
+
scopePath: Array<string | number>,
|
|
262
|
+
scope: SaasProviderRuntimeScope | undefined,
|
|
263
|
+
): void => {
|
|
264
|
+
if (!scope) return;
|
|
265
|
+
|
|
266
|
+
for (const [providerRef, selection] of Object.entries(scope.providers)) {
|
|
267
|
+
for (const capability of selection.engineCapabilities) {
|
|
268
|
+
if (config.engineCapabilities?.[capability]?.enabled !== true) {
|
|
269
|
+
ctx.addIssue({
|
|
270
|
+
code: 'custom',
|
|
271
|
+
path: [...scopePath, 'providers', providerRef, 'engineCapabilities'],
|
|
272
|
+
message:
|
|
273
|
+
`Provider "${providerRef}" selects disabled or unauthored engine capability "${capability}".`,
|
|
274
|
+
});
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
for (const [capability, policy] of Object.entries(scope.selection ?? {})) {
|
|
280
|
+
// A FAN_OUT capability (e.g. COMPLIANCE_AUDIT_TRAIL) writes to EVERY declared
|
|
281
|
+
// provider — a `selection` (primary + failover) is meaningless for it. Reject
|
|
282
|
+
// it; declaring the providers is enough (all are active).
|
|
283
|
+
if (
|
|
284
|
+
getEngineCapabilityResolutionMode(capability as EngineCapability)
|
|
285
|
+
=== EngineCapabilityResolutionMode.FAN_OUT
|
|
286
|
+
) {
|
|
287
|
+
ctx.addIssue({
|
|
288
|
+
code: 'custom',
|
|
289
|
+
path: [...scopePath, 'selection', capability],
|
|
290
|
+
message:
|
|
291
|
+
`"${capability}" is a FAN_OUT capability — every declared provider is active (no primary/failover). Remove its \`selection\` entry; declaring the providers is enough.`,
|
|
292
|
+
});
|
|
293
|
+
continue;
|
|
294
|
+
}
|
|
295
|
+
for (const providerRef of [policy.primary, ...(policy.fallbacks ?? [])]) {
|
|
296
|
+
const providerSelection = scope.providers[providerRef];
|
|
297
|
+
if (providerSelection && !providerSelection.engineCapabilities.includes(capability as EngineCapability)) {
|
|
298
|
+
ctx.addIssue({
|
|
299
|
+
code: 'custom',
|
|
300
|
+
path: [...scopePath, 'selection', capability],
|
|
301
|
+
message:
|
|
302
|
+
`Provider selection for "${capability}" references provider "${providerRef}" that does not declare engineCapabilities including ${capability}.`,
|
|
303
|
+
});
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
};
|
|
308
|
+
|
|
309
|
+
validateProviderScope(['providers', 'scopes', 'backend'], config.providers?.scopes.backend);
|
|
310
|
+
validateProviderScope(['providers', 'scopes', 'companion'], config.providers?.scopes.companion);
|
|
311
|
+
|
|
312
|
+
for (const [serviceKey, scope] of Object.entries(config.providers?.scopes.frontendServices ?? {})) {
|
|
313
|
+
if (!availableServiceKeys.has(serviceKey)) {
|
|
314
|
+
ctx.addIssue({
|
|
315
|
+
code: 'custom',
|
|
316
|
+
path: ['providers', 'scopes', 'frontendServices', serviceKey],
|
|
317
|
+
message: `Provider scope references unknown frontend service "${serviceKey}".`,
|
|
318
|
+
});
|
|
319
|
+
} else if (!frontendServiceKeys.has(serviceKey)) {
|
|
320
|
+
ctx.addIssue({
|
|
321
|
+
code: 'custom',
|
|
322
|
+
path: ['providers', 'scopes', 'frontendServices', serviceKey],
|
|
323
|
+
message:
|
|
324
|
+
`Provider scope references non-frontend service "${serviceKey}". ` +
|
|
325
|
+
'Only services with a frontendType may appear under providers.scopes.frontendServices.',
|
|
326
|
+
});
|
|
327
|
+
}
|
|
328
|
+
validateProviderScope(['providers', 'scopes', 'frontendServices', serviceKey], scope);
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
for (const [minionKey, scope] of Object.entries(config.providers?.scopes.minions ?? {})) {
|
|
332
|
+
if (!scopeBuckets.minions.has(minionKey)) {
|
|
333
|
+
ctx.addIssue({
|
|
334
|
+
code: 'custom',
|
|
335
|
+
path: ['providers', 'scopes', 'minions', minionKey],
|
|
336
|
+
message: `Provider scope references unknown minion "${minionKey}".`,
|
|
337
|
+
});
|
|
338
|
+
}
|
|
339
|
+
validateProviderScope(['providers', 'scopes', 'minions', minionKey], scope);
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
for (const [workerKey, scope] of Object.entries(config.providers?.scopes.workers ?? {})) {
|
|
343
|
+
if (!scopeBuckets.workers.has(workerKey)) {
|
|
344
|
+
ctx.addIssue({
|
|
345
|
+
code: 'custom',
|
|
346
|
+
path: ['providers', 'scopes', 'workers', workerKey],
|
|
347
|
+
message: `Provider scope references unknown worker "${workerKey}".`,
|
|
348
|
+
});
|
|
349
|
+
}
|
|
350
|
+
validateProviderScope(['providers', 'scopes', 'workers', workerKey], scope);
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
// At most one service may use each "single-instance" frontend kind.
|
|
354
|
+
//
|
|
355
|
+
// `TECH_DOC` and `STATIC_WEBSITE` are framework-managed singletons:
|
|
356
|
+
// a SaaS app has at most one technical-documentation site and at
|
|
357
|
+
// most one marketing/landing site. The per-service config files
|
|
358
|
+
// (`wildo.tech-doc.config.ts` for `TECH_DOC`, `wildo.website.config.ts`
|
|
359
|
+
// for `STATIC_WEBSITE`) are discovered by the companion / Astro
|
|
360
|
+
// build through the unique service of the matching `frontendType`.
|
|
361
|
+
// If the schema allowed two `TECH_DOC` services, the companion
|
|
362
|
+
// would have no deterministic way to project the OpenAPI YAMLs to
|
|
363
|
+
// "the" docs root — every consumer would need a "which docs
|
|
364
|
+
// service?" indirection for no real-world payoff (multi-doc-site
|
|
365
|
+
// / multi-marketing-site SaaS apps are not a use case we have
|
|
366
|
+
// ever needed to support).
|
|
367
|
+
//
|
|
368
|
+
// The constraint is enforced at parse time so the failure surfaces
|
|
369
|
+
// at `defineSaasConfig` (CLI parse, dev watcher reload) rather than
|
|
370
|
+
// at first companion-driven OpenAPI publish — the latter would be
|
|
371
|
+
// a confusing "your second docs service was silently picked over
|
|
372
|
+
// the first" type of failure.
|
|
373
|
+
//
|
|
374
|
+
// `SAAS_APP` is intentionally NOT constrained here: a single repo
|
|
375
|
+
// can ship multiple SaaS-app frontends (e.g. a customer surface and
|
|
376
|
+
// an internal admin), each owning its own session, and the
|
|
377
|
+
// cross-frontend handoff already handles that fan-out via
|
|
378
|
+
// `runtime.endPoints[*].publicUrl`. The session-owning role does not
|
|
379
|
+
// create a unique-receiver assumption the way the docs / website
|
|
380
|
+
// frontends do.
|
|
381
|
+
const singletonFrontends: ReadonlyArray<AppFrontendType> = [
|
|
382
|
+
AppFrontendType.TECH_DOC,
|
|
383
|
+
AppFrontendType.STATIC_WEBSITE,
|
|
384
|
+
];
|
|
385
|
+
for (const kind of singletonFrontends) {
|
|
386
|
+
const matchingServiceKeys = Object.entries(config.services)
|
|
387
|
+
.filter(([, def]) => def.frontendType === kind)
|
|
388
|
+
.map(([key]) => key);
|
|
389
|
+
if (matchingServiceKeys.length > 1) {
|
|
390
|
+
for (const offendingKey of matchingServiceKeys) {
|
|
391
|
+
ctx.addIssue({
|
|
392
|
+
code: 'custom',
|
|
393
|
+
path: ['services', offendingKey, 'frontendType'],
|
|
394
|
+
message:
|
|
395
|
+
`frontendType='${kind}' may be declared on at most one service ` +
|
|
396
|
+
`per SaaS app (found ${matchingServiceKeys.length}: ${matchingServiceKeys.join(', ')}). ` +
|
|
397
|
+
`${kind} is a framework-managed singleton — the companion / build ` +
|
|
398
|
+
`pipeline addresses it as "the ${kind} service" with no disambiguator. ` +
|
|
399
|
+
`Collapse the duplicates into a single service or split them into separate apps.`,
|
|
400
|
+
});
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
}) as unknown as z.ZodType<WildoSaasConfig, WildoSaasConfigInput>;
|
|
405
|
+
```
|