@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,646 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: infra-environment-config
|
|
3
|
+
description: Edit infrastructure environment configuration for local and deployed targets — the typed `defineInfraEnvConfig({...})` files declaring `environment`, `runtime`, `publicDomain` (top-level, runtime-agnostic external hostname — REQUIRED), `serviceAuth`, `backingServices` (the closed `BackingServiceKind` map — see `references/framework-backing-services-api.md` for the authoritative kind list — each with `BackingServiceSource.SELF | MANAGED` plus an orthogonal `provider: '<brand>'`, e.g. `provider: 'atlas'` for MongoDB Atlas), `logging`, `devCompanion`, `kubernetes` (namespace + ingressClass only), and (for remote) `remoteProvider` + `deployment`. Use when the user says "wire up a new external service endpoint", "rotate the staging mongodb to Atlas", "fix the local docker-compose port collision", "add a new environment", "the dev stack can't reach Redis", "where do audit logs get stored", "config sync warns my env has no audit store", or any change that adjusts environment-specific infrastructure wiring.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Infra Environment Config
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for **infrastructure environment configuration** —
|
|
23
|
+
the typed `defineInfraEnvConfig({...})` calls (one file per
|
|
24
|
+
environment: `local`, `staging`, `production`, …) that declare
|
|
25
|
+
how the application connects to its backing services and runtime.
|
|
26
|
+
Infra config serves three consumers:
|
|
27
|
+
|
|
28
|
+
1. The **`wildo` CLI** — reads the active infra config at command
|
|
29
|
+
time to scaffold docker-compose stacks (local), drive deploys
|
|
30
|
+
(remote), and surface backing-service endpoints to the dev
|
|
31
|
+
companion.
|
|
32
|
+
2. The **application bootstrap** — the typed config feeds runtime
|
|
33
|
+
service initialization (DB connection strings, cache hosts,
|
|
34
|
+
message broker vhosts, S3 bucket / endpoint pairs).
|
|
35
|
+
3. The **dev companion** — reads `devCompanion: { host, port }` to
|
|
36
|
+
bind its UI; reads `backingServices` to surface service-status
|
|
37
|
+
tiles to the developer.
|
|
38
|
+
|
|
39
|
+
Infra config lives at the **app boundary**, separate from
|
|
40
|
+
application business code (which is module-owned). It is
|
|
41
|
+
intentionally **environment-scoped, not module-scoped** — every
|
|
42
|
+
environment file declares the full backing-service topology for
|
|
43
|
+
that environment, never a per-module slice.
|
|
44
|
+
|
|
45
|
+
## App Paths
|
|
46
|
+
|
|
47
|
+
| Surface | Glob (relative to app root) |
|
|
48
|
+
|--------------------------------------|----------------------------------------------------------------------------------------------|
|
|
49
|
+
| Local environment config | `infrastructure/local/wildo.infra.local.config.ts` (`defineInfraEnvConfig({...})`) |
|
|
50
|
+
| Staging environment config | `infrastructure/staging/wildo.infra.remote.config.ts` |
|
|
51
|
+
| Production environment config | `infrastructure/production/wildo.infra.remote.config.ts` |
|
|
52
|
+
| Per-app SaaS config | `wildo.saas.config.ts` (typed `defineSaasConfig` — modules, engine capabilities, provider scopes; cross-skill: `config-saas`) |
|
|
53
|
+
| Worker / minion infra extensions | `workers/<name>/wildo.worker.config.ts`, `minions/<name>/wildo.minion.config.ts` |
|
|
54
|
+
| Framework publish targets | Not an application surface — npm scopes and docker namespaces belong to the Wildo framework distribution, not to this app |
|
|
55
|
+
| Secrets store | Out of repo: `wildo-secrets/environments/<env>/secrets.json` |
|
|
56
|
+
|
|
57
|
+
## When to Use
|
|
58
|
+
|
|
59
|
+
- New external service endpoint (DB cluster, S3 bucket, object
|
|
60
|
+
storage, message broker)
|
|
61
|
+
- Rotating a backing-service source (e.g. moving mongodb from
|
|
62
|
+
`SELF` to `MANAGED` with `provider: 'atlas'`)
|
|
63
|
+
- Local docker-compose port realignment (collision with another
|
|
64
|
+
dev stack on the same machine)
|
|
65
|
+
- New environment file (e.g. adding `preview` or `qa` alongside
|
|
66
|
+
staging / production)
|
|
67
|
+
- Adjusting `serviceAuth` (JWT access/refresh token lifetimes)
|
|
68
|
+
- Wiring `devCompanion` host / port (e.g. binding to `0.0.0.0` for
|
|
69
|
+
remote dev access)
|
|
70
|
+
|
|
71
|
+
## When NOT to Use
|
|
72
|
+
|
|
73
|
+
- Changing the module list / engine capabilities / provider scope surface →
|
|
74
|
+
`config-saas` (those live in `wildo.saas.config.ts`)
|
|
75
|
+
- Adding navigation zones / app shell layout → `config-navigation`
|
|
76
|
+
+ `config-app-shell`
|
|
77
|
+
- Application secrets values themselves (database password, S3
|
|
78
|
+
access keys) → out-of-repo secrets store, never in
|
|
79
|
+
`defineInfraEnvConfig({...})`
|
|
80
|
+
- Framework-level publish targets (npm scopes, docker namespaces)
|
|
81
|
+
→ not an application concern. They belong to the Wildo framework
|
|
82
|
+
distribution and are not configurable from this application.
|
|
83
|
+
|
|
84
|
+
## Workflow
|
|
85
|
+
|
|
86
|
+
### Step 1: Identify which environment file to edit
|
|
87
|
+
|
|
88
|
+
- **Local change**: `infrastructure/local/wildo.infra.local.config.ts`
|
|
89
|
+
- **Staging change**: `infrastructure/staging/wildo.infra.remote.config.ts`
|
|
90
|
+
- **Production change**: `infrastructure/production/wildo.infra.remote.config.ts`
|
|
91
|
+
|
|
92
|
+
The target application's local config
|
|
93
|
+
(`example.infra.environment-config.local`) illustrates the canonical shape
|
|
94
|
+
for new environment files. Mirror it; replace `WildoEnvironment.LOCAL`
|
|
95
|
+
with the target environment and adjust backing-service `source`
|
|
96
|
+
as appropriate.
|
|
97
|
+
|
|
98
|
+
### Step 2: Edit the typed `defineInfraEnvConfig({...})` call
|
|
99
|
+
|
|
100
|
+
Every infra file is a single `defineInfraEnvConfig({...})` default
|
|
101
|
+
export. The typed shape carries:
|
|
102
|
+
|
|
103
|
+
- `environment` — typed `WildoEnvironment.LOCAL | STAGING |
|
|
104
|
+
PRODUCTION | …` (drives runtime detection)
|
|
105
|
+
- `runtime` — typed `WildoDeploymentRuntime.DOCKER_COMPOSE |
|
|
106
|
+
KUBERNETES | …` (drives deploy strategy)
|
|
107
|
+
- `serviceAuth` — JWT access/refresh token lifetimes (algorithm selection is intentionally not authored here)
|
|
108
|
+
- `backingServices` — typed map keyed by the closed
|
|
109
|
+
`BackingServiceKind` vocabulary. **Read
|
|
110
|
+
`references/framework-backing-services-api.md` for the authoritative
|
|
111
|
+
kind list and per-kind entry shape** — it is extracted from the
|
|
112
|
+
schema, so unlike a prose list it cannot drift as kinds are added.
|
|
113
|
+
Each entry carries `source: BackingServiceSource.SELF | MANAGED`
|
|
114
|
+
plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'aws-rds'`,
|
|
115
|
+
`'minio'`) and per-source connection params. The legacy
|
|
116
|
+
`BackingServiceSource.ATLAS` value no longer exists — it was
|
|
117
|
+
replaced by the two-axis `(source, provider?)` shape, so Atlas is
|
|
118
|
+
now `source: MANAGED, provider: 'atlas'`
|
|
119
|
+
- `logging` — `{ level, formattedConsoleErrors }` projected to the
|
|
120
|
+
process env as `LOG_LEVEL` / `LOG_FORMATTED_CONSOLE_ERRORS` by
|
|
121
|
+
`env-vars-builder` and consumed at boot by
|
|
122
|
+
`LoggerService.loadConfiguration` (every long-running platform/
|
|
123
|
+
application service)
|
|
124
|
+
- `publicDomain` (top-level, REQUIRED, runtime-agnostic) — canonical
|
|
125
|
+
external hostname seam for generated ingress hosts AND for cookie
|
|
126
|
+
`Domain` / CORS allowlist derivation. Applies to BOTH `KUBERNETES`
|
|
127
|
+
and `DOCKER_COMPOSE` runtimes (compose-without-reverse-proxy
|
|
128
|
+
authors `'localhost'`). Renamed from the misnamed
|
|
129
|
+
`kubernetes.baseDomain`, whose nesting wrongly suggested K8s-only
|
|
130
|
+
semantics. There
|
|
131
|
+
is intentionally no top-level `domain` field either — the canonical
|
|
132
|
+
seam is `publicDomain`. Both `domain` and `kubernetes.baseDomain`
|
|
133
|
+
are strict-rejected by the schema (pinned by
|
|
134
|
+
`define-infra-env-config.unimplemented.test.ts`).
|
|
135
|
+
- `devCompanion` (local-only) — host + port binding
|
|
136
|
+
- `remoteProvider` + `deployment` (remote-only) — registry
|
|
137
|
+
endpoint, region, branch wiring
|
|
138
|
+
- `cdn` (remote-only) — OPT-IN per-service map (`cdn?[serviceKey]`)
|
|
139
|
+
that serves a frontend from object storage + a CDN instead of its
|
|
140
|
+
nginx pod. Skips the frontend's Deployment/Service + ingress route
|
|
141
|
+
and pairs with `wildo frontend publish`. The schema rejects `cdn`
|
|
142
|
+
in local. Full workflow (vendor options, Cloudflare + operator
|
|
143
|
+
setup): `frontend-cdn-publish`.
|
|
144
|
+
|
|
145
|
+
Use the typed enums (`WildoEnvironment.*`,
|
|
146
|
+
`WildoDeploymentRuntime.*`, `BackingServiceSource.*`) — never
|
|
147
|
+
string literals. The enums get autocomplete + refactor safety
|
|
148
|
+
and reject unknown values at compile time.
|
|
149
|
+
|
|
150
|
+
### Step 3: Never commit secret values
|
|
151
|
+
|
|
152
|
+
Connection strings, passwords, S3 access keys, JWT secrets —
|
|
153
|
+
**none** of these belong in the infra config file. Reference
|
|
154
|
+
them via the secrets store (`wildo-secrets/environments/<env>/`)
|
|
155
|
+
or environment variables resolved at deploy time. The infra config
|
|
156
|
+
declares **shape and source**, not credentials.
|
|
157
|
+
|
|
158
|
+
Read `references/infra-config-files.md` for the secrets-channel
|
|
159
|
+
conventions and `references/framework-environment-deployment-api.md`
|
|
160
|
+
for the typed schema reference.
|
|
161
|
+
|
|
162
|
+
### Step 4: Restart the dev stack (local) or trigger redeploy (remote)
|
|
163
|
+
|
|
164
|
+
Local edits require restarting `docker-compose` (the dev companion
|
|
165
|
+
exposes a "Restart stack" action). Remote edits require pushing to
|
|
166
|
+
the configured `deployment.branch` (typically the same branch the
|
|
167
|
+
deploy pipeline watches).
|
|
168
|
+
|
|
169
|
+
### Step 5: Verify
|
|
170
|
+
|
|
171
|
+
- `wildo local status` (or equivalent for remote) — services
|
|
172
|
+
health-check
|
|
173
|
+
- App connects to the new endpoint without errors in the bootstrap log
|
|
174
|
+
- Dev companion shows updated backing-service tiles
|
|
175
|
+
- Documentation updated for teammates if ports / hostnames changed
|
|
176
|
+
|
|
177
|
+
## Worked Example
|
|
178
|
+
|
|
179
|
+
The application's `infrastructure/local/wildo.infra.local.config.ts`
|
|
180
|
+
illustrates the canonical local infra shape — typed
|
|
181
|
+
`defineInfraEnvConfig({...})` with all six common backing-service
|
|
182
|
+
kinds wired against `BackingServiceSource.SELF`:
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
## Usage Example
|
|
186
|
+
|
|
187
|
+
```typescript
|
|
188
|
+
export default defineInfraEnvConfig({
|
|
189
|
+
environment: WildoEnvironment.LOCAL,
|
|
190
|
+
runtime: WildoDeploymentRuntime.DOCKER_COMPOSE,
|
|
191
|
+
// Public hostname browsers and reverse proxies resolve. For local
|
|
192
|
+
// Docker Compose without a reverse proxy, `'localhost'` is the
|
|
193
|
+
// canonical author-time value (mirrors `PUBLIC_DOMAIN_DEFAULTS.LOCAL_COMPOSE`
|
|
194
|
+
// that `wildo init` would emit). Required upstream by the schema.
|
|
195
|
+
publicDomain: 'localhost',
|
|
196
|
+
// `serviceAuth` intentionally OMITTED. Pre-2026-04-13 this block authored
|
|
197
|
+
// `{ accessTokenExpirationMinutes: 60, refreshTokenExpirationDays: 30 }`
|
|
198
|
+
// \u2014 byte-for-byte equal to the THEN-CURRENT `WildoAuthConfigSchema`
|
|
199
|
+
// defaults, which is author-noise per the framework-mindset principle
|
|
200
|
+
// documented on `production/wildo.infra.remote.config.ts`. With Auth-
|
|
201
|
+
// hardening Slice A Step 5 lowering the access-token default to 15 min,
|
|
202
|
+
// local dev now inherits the tighter posture too: an XSS bug in dev only
|
|
203
|
+
// exposes a 15-min access-token window (the refresh loop rotates
|
|
204
|
+
// transparently via the `__wildo_refresh` cookie, so developers see no
|
|
205
|
+
// login friction). Author this block ONLY when local dev genuinely needs
|
|
206
|
+
// to deviate (e.g. `accessTokenExpirationMinutes: 60` for offline-style
|
|
207
|
+
// long-session debugging \u2014 with a comment explaining why).
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* The PLATFORM's own store (apps-manager + module-registry: users, organizations, applications,
|
|
211
|
+
* sessions, API keys). Declared rather than inferred — the backing-service derivation resolves
|
|
212
|
+
* `postgresql && mongodb` to MongoDB, so this dual-store state cannot be expressed any other way.
|
|
213
|
+
*
|
|
214
|
+
* MongoDB below is no longer REQUIRED by the platform (2026-08-28): the six `persistenceAdapter:
|
|
215
|
+
* MONGODB` bootstrap pins retired, crontabs-batches-manager was ported, and apps-manager's
|
|
216
|
+
* `MONGO_CONNECT_URL` became engine-conditional — so neither `defineInfraEnvConfig` nor
|
|
217
|
+
* `env-vars-builder` refuses this block without it any more.
|
|
218
|
+
*
|
|
219
|
+
* It is kept here DELIBERATELY, and the reason is now an application one rather than a platform
|
|
220
|
+
* one: this environment also runs mongot beside it, and any Mongo-backed application hosted on
|
|
221
|
+
* this platform lives in that server. Removing it is a decision about what this environment hosts,
|
|
222
|
+
* not a box the framework still ticks for you.
|
|
223
|
+
*/
|
|
224
|
+
database: { engine: DatabaseEngine.POSTGRESQL, source: BackingServiceSource.SELF },
|
|
225
|
+
|
|
226
|
+
/**
|
|
227
|
+
* The APPLICATION's own store — a separate axis from `database` directly above.
|
|
228
|
+
*
|
|
229
|
+
* `database` decides where the PLATFORM's tables live. This decides where Your Application' own 95
|
|
230
|
+
* resources persist. Until this field existed there was nowhere to say it: the CLI emitted a
|
|
231
|
+
* reachable PostgreSQL ADDRESS to the application backend and deliberately never selected it, so
|
|
232
|
+
* the only way to move an application was to hand-edit `backend-api/.env` — machine-local and not
|
|
233
|
+
* reproducible on another developer's machine.
|
|
234
|
+
*
|
|
235
|
+
* The substrate is `backingServices.postgresql` below; this is only the selection.
|
|
236
|
+
*/
|
|
237
|
+
applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
|
|
238
|
+
|
|
239
|
+
backingServices: {
|
|
240
|
+
mongodb: {
|
|
241
|
+
source: BackingServiceSource.SELF,
|
|
242
|
+
database: 'your-app-db',
|
|
243
|
+
host: 'localhost',
|
|
244
|
+
port: 27017,
|
|
245
|
+
},
|
|
246
|
+
redis: {
|
|
247
|
+
source: BackingServiceSource.SELF,
|
|
248
|
+
host: 'localhost',
|
|
249
|
+
port: 6379,
|
|
250
|
+
database: 0,
|
|
251
|
+
},
|
|
252
|
+
rabbitmq: {
|
|
253
|
+
source: BackingServiceSource.SELF,
|
|
254
|
+
host: 'localhost',
|
|
255
|
+
port: 5672,
|
|
256
|
+
vhost: 'your-app',
|
|
257
|
+
},
|
|
258
|
+
/**
|
|
259
|
+
* Self-hosted PostgreSQL, declared ALONGSIDE MongoDB rather than instead of it.
|
|
260
|
+
*
|
|
261
|
+
* This names the APPLICATION's own database, and is distinct from the PLATFORM's engine
|
|
262
|
+
* declared by `database` above. The two are separate axes: `database.engine` decides where the
|
|
263
|
+
* platform's own tables live, while an application's resources move only when that
|
|
264
|
+
* application's backend selects `DATABASE_DEFAULT_ADAPTER`.
|
|
265
|
+
*
|
|
266
|
+
* ⚠️ CORRECTED 2026-08-19. This comment used to warn that flipping `database.engine` to
|
|
267
|
+
* PostgreSQL "would delete MongoDB from the rendered compose file and take the whole platform
|
|
268
|
+
* down with it", and instructed authors to declare PostgreSQL only here. That exclusivity was
|
|
269
|
+
* real when written — `needsLocalMongoDB` was `engine === MONGODB && source === SELF` — and it
|
|
270
|
+
* is now gone: `database.engine` IS PostgreSQL on line 36, and `defineInfraEnvConfig`'s
|
|
271
|
+
* superRefine used to REQUIRE `backingServices.mongodb: SELF` whenever the engine is PostgreSQL.
|
|
272
|
+
* It no longer does (2026-08-28): the six bootstrap resources that were pinned to MongoDB
|
|
273
|
+
* (`wildoApplication`, `wildoApplicationConfig`, `wildoApplicationSecrets`,
|
|
274
|
+
* `platformApplications`, `platformApplicationsConfig`, `platformApplicationsSecrets`) had their
|
|
275
|
+
* pins retired on 2026-08-22 and now follow the platform's configured engine like every other
|
|
276
|
+
* platform resource. Both stores are still declared above and both are still rendered — by
|
|
277
|
+
* choice now, not by obligation.
|
|
278
|
+
*/
|
|
279
|
+
postgresql: {
|
|
280
|
+
source: BackingServiceSource.SELF,
|
|
281
|
+
host: 'localhost',
|
|
282
|
+
port: 5432,
|
|
283
|
+
database: 'your-app-db',
|
|
284
|
+
},
|
|
285
|
+
s3: {
|
|
286
|
+
source: BackingServiceSource.SELF,
|
|
287
|
+
provider: 'minio',
|
|
288
|
+
endpoint: 'http://localhost:9000',
|
|
289
|
+
bucket: 'your-app-local',
|
|
290
|
+
},
|
|
291
|
+
// Optional `port` override: publish a self-hosted service on a
|
|
292
|
+
// different host port than its framework default (Gotenberg defaults
|
|
293
|
+
// to 3100). Reach for it when the default port is already taken on
|
|
294
|
+
// the host — only the host-side mapping changes, the container still
|
|
295
|
+
// listens on its internal port. Here Gotenberg is published on 3200.
|
|
296
|
+
gotenberg: { source: BackingServiceSource.SELF, port: 3200 },
|
|
297
|
+
clamav: { source: BackingServiceSource.SELF },
|
|
298
|
+
// Audit Phase 2 — self-hosted immudb (tamper-evident audit-log store). Boots
|
|
299
|
+
// the local immudb container so `wildo local up` dogfoods the compose ⇄ k8s
|
|
300
|
+
// immudb seam end-to-end. The COMPLIANCE_AUDIT_TRAIL provider that WRITES to
|
|
301
|
+
// it (via the app-level audit fan-out) lands in Phase 3.
|
|
302
|
+
immudb: { source: BackingServiceSource.SELF },
|
|
303
|
+
},
|
|
304
|
+
|
|
305
|
+
// `formattedConsoleErrors: false` → the backend emits one-line pino JSON
|
|
306
|
+
// (LOG_FORMATTED_CONSOLE_ERRORS=false) instead of colorized pino-pretty. This
|
|
307
|
+
// makes the log stream machine-parseable, which the testing-stack backend-log
|
|
308
|
+
// helpers require — `createBackendLogSurface` / `watchForEmail`
|
|
309
|
+
// (@wildo-ai/testing-core) parse JSON lines and SKIP pretty ones, so the
|
|
310
|
+
// `email-preview` log-delivery mail (selected as the local
|
|
311
|
+
// transactional-email primary via `providerSelection` below) is only
|
|
312
|
+
// retrievable in JSON mode.
|
|
313
|
+
// This aspect is also the SINGLE authority over console presentation in
|
|
314
|
+
// `wildo local dev`: at `false` the CLI output boundary forwards each line
|
|
315
|
+
// untouched, so the terminal shows the same one-line JSON the process emitted.
|
|
316
|
+
// Set it to `true` (or drop the field to fall back on the `APPLICATION_ENV`
|
|
317
|
+
// auto-detect) to read decoded, human-formatted output instead — at the cost
|
|
318
|
+
// of the machine-parseable stream the helpers above depend on. The `dev-*.log`
|
|
319
|
+
// machine capture always keeps the raw, ANSI-free line regardless of this
|
|
320
|
+
// value; only the interactive terminal follows the authored posture.
|
|
321
|
+
logging: {
|
|
322
|
+
level: 'debug',
|
|
323
|
+
formattedConsoleErrors: false,
|
|
324
|
+
},
|
|
325
|
+
|
|
326
|
+
/**
|
|
327
|
+
* OTLP telemetry (Slice 2 Phase 5) — local verification against the in-compose
|
|
328
|
+
* `otel-collector` (published on `localhost:4318`). `enabled` → `OTEL_ENABLED` + the
|
|
329
|
+
* `--import @wildo-ai/saas-backend-lib/otel-preload` wiring; `endpoint` →
|
|
330
|
+
* `OTEL_EXPORTER_OTLP_ENDPOINT`. No provider auth here — the local collector needs none
|
|
331
|
+
* (the BetterStack source token + ingesting host is the Phase 5b endpoint swap).
|
|
332
|
+
*/
|
|
333
|
+
observability: {
|
|
334
|
+
enabled: true,
|
|
335
|
+
endpoint: 'http://localhost:4318',
|
|
336
|
+
/**
|
|
337
|
+
* LLM-call observability (PostHog `$ai_generation`): capture prompt +
|
|
338
|
+
* completion content locally — dev traces are far more useful with the
|
|
339
|
+
* actual `$ai_input`/`$ai_output_choices` visible, and local runs carry
|
|
340
|
+
* no customer data. Remote envs omit this (content capture stays a
|
|
341
|
+
* deliberate per-env opt-in — PII to a third party).
|
|
342
|
+
*/
|
|
343
|
+
llmObservability: {
|
|
344
|
+
captureContent: true,
|
|
345
|
+
/**
|
|
346
|
+
* Non-secret connection env for the selected LLM-obs provider (posthog).
|
|
347
|
+
* The API key stays in `secrets.json → providerEnv` (secrets win on a
|
|
348
|
+
* key collision) — only non-sensitive connection details live here.
|
|
349
|
+
*/
|
|
350
|
+
providerEnv: {
|
|
351
|
+
POSTHOG_HOST: 'https://eu.i.posthog.com',
|
|
352
|
+
// Forward-compat only: no runtime reads POSTHOG_PROJECT_ID today (the
|
|
353
|
+
// sink needs key + host). Kept for future dashboard deep-linking.
|
|
354
|
+
POSTHOG_PROJECT_ID: '117928',
|
|
355
|
+
},
|
|
356
|
+
},
|
|
357
|
+
},
|
|
358
|
+
|
|
359
|
+
/**
|
|
360
|
+
* Env-layer docs CSP override (`auth-hardening.md` B-2C).
|
|
361
|
+
*
|
|
362
|
+
* This is the per-env origin the docs frontend is allowed to fetch for
|
|
363
|
+
* auth handoff + OpenAPI runtime calls. The app-static posture
|
|
364
|
+
* (`enabled`, `reportOnly`) lives in `technical-doc/wildo.tech-doc.config.ts`;
|
|
365
|
+
* this env layer only supplies the local backend origin.
|
|
366
|
+
*/
|
|
367
|
+
csp: {
|
|
368
|
+
app: {
|
|
369
|
+
extraDirectives: {
|
|
370
|
+
'connect-src': ['http://localhost:4241'],
|
|
371
|
+
// PDF.js parses documents on a Web Worker, and the worker asset is emitted
|
|
372
|
+
// same-origin by the bundler (resolved through `import.meta.url`, never a
|
|
373
|
+
// CDN). Bundlers may instantiate it through a blob shim, so both sources are
|
|
374
|
+
// required — without them a PDF field renders an empty viewer and the only
|
|
375
|
+
// signal is a CSP violation in the console.
|
|
376
|
+
'worker-src': ["'self'", 'blob:'],
|
|
377
|
+
},
|
|
378
|
+
},
|
|
379
|
+
docs: {
|
|
380
|
+
extraDirectives: {
|
|
381
|
+
'connect-src': ['http://localhost:4241'],
|
|
382
|
+
},
|
|
383
|
+
},
|
|
384
|
+
// Marketing website: the anonymous-capture forms (lead + draft-note) POST
|
|
385
|
+
// cross-origin to the backend API, so an enforced website CSP must admit
|
|
386
|
+
// the API origin in connect-src. CSP is report-only today, so this is prep
|
|
387
|
+
// — non-blocking until `wildo.website.config.ts` `csp.reportOnly` flips.
|
|
388
|
+
website: {
|
|
389
|
+
extraDirectives: {
|
|
390
|
+
'connect-src': ['http://localhost:4241'],
|
|
391
|
+
},
|
|
392
|
+
},
|
|
393
|
+
},
|
|
394
|
+
|
|
395
|
+
/**
|
|
396
|
+
* Per-environment external-provider selection override. LOCAL sends
|
|
397
|
+
* transactional email through the non-sending `email-preview` provider
|
|
398
|
+
* (`delivery: 'log'` — renders + logs, never hits Resend), so invites /
|
|
399
|
+
* verification / password-reset work with no live API key and no mail
|
|
400
|
+
* leaving the machine. `email-preview` is DECLARED in
|
|
401
|
+
* `wildo.saas.config.ts > providers.scopes.backend.providers`; this block
|
|
402
|
+
* only makes it the LOCAL primary. Staging/production author no override,
|
|
403
|
+
* so they keep the saas-config default (`resend`).
|
|
404
|
+
*/
|
|
405
|
+
providerSelection: {
|
|
406
|
+
[EngineCapability.EMAIL_TRANSACTIONAL]: {
|
|
407
|
+
primary: 'email-preview',
|
|
408
|
+
},
|
|
409
|
+
},
|
|
410
|
+
|
|
411
|
+
/**
|
|
412
|
+
* Local operator evidence posture. `wildo config sync --domain env-files`
|
|
413
|
+
* and `wildo dev start` project this block into the ephemeral app-root
|
|
414
|
+
* `.env`; the verification command never treats `.env` as authored truth.
|
|
415
|
+
*/
|
|
416
|
+
applicationCreationVerification: {
|
|
417
|
+
evidenceDirectory: '.wildo-saas/logs/application-creation-evidence',
|
|
418
|
+
silent: false,
|
|
419
|
+
},
|
|
420
|
+
|
|
421
|
+
devCompanion: {
|
|
422
|
+
// Loopback ONLY (meta-workflows P-29): the companion API hosts
|
|
423
|
+
// endpoints that spend money and execute code (coding-agent dispatch),
|
|
424
|
+
// and its startup fail-closed asserts the resolved host is loopback.
|
|
425
|
+
// A `0.0.0.0` bind (the historical value) now refuses to start.
|
|
426
|
+
host: 'localhost',
|
|
427
|
+
port: 4341,
|
|
428
|
+
},
|
|
429
|
+
|
|
430
|
+
});
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
What earns its place:
|
|
434
|
+
|
|
435
|
+
- `defineInfraEnvConfig({ ... })` — the **typed factory entry**
|
|
436
|
+
imported from `@wildo-ai/platform-config-lib`. The factory does
|
|
437
|
+
the cross-field validation (e.g. `WildoEnvironment.LOCAL`
|
|
438
|
+
requires `devCompanion`; `runtime: DOCKER_COMPOSE` accepts
|
|
439
|
+
`BackingServiceSource.SELF` for self-hosted services).
|
|
440
|
+
- `environment: WildoEnvironment.LOCAL` — typed enum, not the
|
|
441
|
+
string `'local'`. The value drives runtime detection at app
|
|
442
|
+
bootstrap (`isLocal()` / `isProduction()` helpers read this).
|
|
443
|
+
- `runtime: WildoDeploymentRuntime.DOCKER_COMPOSE` — typed enum,
|
|
444
|
+
drives the CLI's stack scaffolding strategy (compose file
|
|
445
|
+
generation, port allocation, image build).
|
|
446
|
+
- `serviceAuth: { accessTokenExpirationMinutes: 15,
|
|
447
|
+
refreshTokenExpirationDays: 30 }` — the **shape** of token
|
|
448
|
+
lifetime policy threaded into every per-app
|
|
449
|
+
`Wildo_Application_Config.jwt` at apps-manager init time. The
|
|
450
|
+
actual JWT signing keys live in the secrets store, **never** in
|
|
451
|
+
this file. Algorithm selection is not authored here \u2014 it is
|
|
452
|
+
fixed by the per-service key convention at sign time. The
|
|
453
|
+
`15 / 30` shown above matches the schema defaults exactly
|
|
454
|
+
(Auth-hardening Slice A Step 5, 2026-04-13 \u2014 prior to that
|
|
455
|
+
the access-token default was 60 min); per the framework-mindset
|
|
456
|
+
principle, **do not author values byte-for-byte equal to the
|
|
457
|
+
schema defaults** (creates author-noise, masks future default
|
|
458
|
+
shifts). Author `serviceAuth` only when you genuinely deviate
|
|
459
|
+
(e.g. a stricter posture: `accessTokenExpirationMinutes: 5`).
|
|
460
|
+
- `backingServices` — the **typed map** of backing services this env
|
|
461
|
+
depends on, keyed by `BackingServiceKind` (authoritative list:
|
|
462
|
+
`references/framework-backing-services-api.md`). Declare a kind only
|
|
463
|
+
when the environment actually runs it — but declare EVERY kind the
|
|
464
|
+
app's enabled engine capabilities depend on (see "Capability-driven
|
|
465
|
+
backing services" below). Each entry carries `source: BackingServiceSource.SELF`
|
|
466
|
+
(locally hosted by docker-compose) plus per-source connection
|
|
467
|
+
params (host, port, vhost, bucket, endpoint). Remote configs swap
|
|
468
|
+
to `source: BackingServiceSource.MANAGED` for cloud-provider-managed
|
|
469
|
+
services, with the brand recorded separately as `provider: '<brand>'`
|
|
470
|
+
(e.g. `provider: 'atlas'` for MongoDB Atlas, `provider: 'aws-rds'` /
|
|
471
|
+
`'gcp-cloud-sql'` / `'supabase'` / `'neon'` / `'render'` /
|
|
472
|
+
`'azure-database'` for Postgres). The pre-Slice-4.B.0 `BackingServiceSource.ATLAS`
|
|
473
|
+
enum value was removed on 2026-05-07 — Atlas is a brand under the
|
|
474
|
+
managed source, not its own source axis.
|
|
475
|
+
- `logging: { level: 'debug', formattedConsoleErrors: true }` —
|
|
476
|
+
per-environment log posture. Wired end-to-end by Slice 3.5:
|
|
477
|
+
persisted into `PlatformEnvConfigJson.logging`, projected by
|
|
478
|
+
`env-vars-builder.emitLoggingEnv` to `LOG_LEVEL` /
|
|
479
|
+
`LOG_FORMATTED_CONSOLE_ERRORS`, and consumed at boot by every
|
|
480
|
+
service's `LoggerService.loadConfiguration`. Production typically
|
|
481
|
+
drops to `level: 'info'` and unsets `formattedConsoleErrors`
|
|
482
|
+
(preserves the auto-detect JSON branch).
|
|
483
|
+
- `devCompanion: { host: '0.0.0.0', port: 4341 }` — local-only.
|
|
484
|
+
Binding to `0.0.0.0` makes the companion reachable from other
|
|
485
|
+
machines on the LAN (drop to `'127.0.0.1'` for solo dev).
|
|
486
|
+
|
|
487
|
+
What is **not** in this block (and shouldn't be):
|
|
488
|
+
|
|
489
|
+
- No connection passwords, no JWT signing keys, no S3 access
|
|
490
|
+
secrets — those live in the secrets store, resolved at deploy
|
|
491
|
+
time via env-var indirection.
|
|
492
|
+
- No module list / engine capabilities / provider scopes — those belong in
|
|
493
|
+
`wildo.saas.config.ts` (`config-saas`).
|
|
494
|
+
- No deployment branch / registry endpoint — those are remote-only
|
|
495
|
+
fields (`remoteProvider`, `deployment`) and don't apply to
|
|
496
|
+
`WildoEnvironment.LOCAL`.
|
|
497
|
+
- No string-literal enums — every typed slot uses the imported
|
|
498
|
+
enum constant.
|
|
499
|
+
|
|
500
|
+
The sibling staging config
|
|
501
|
+
(`infrastructure/staging/wildo.infra.remote.config.ts`) follows
|
|
502
|
+
the same shape with `WildoEnvironment.STAGING` +
|
|
503
|
+
`WildoLocationType.REMOTE` + `remoteProvider` (registry endpoint,
|
|
504
|
+
region) + `deployment` (branch, runtime). Backing-service `source`
|
|
505
|
+
swaps to `MANAGED` as appropriate, with `provider: '<brand>'`
|
|
506
|
+
naming the cloud variant (`'atlas'` for MongoDB Atlas,
|
|
507
|
+
`'aws-rds'` / `'gcp-cloud-sql'` / `'supabase'` / `'neon'` /
|
|
508
|
+
`'render'` / `'azure-database'` for Postgres).
|
|
509
|
+
|
|
510
|
+
## Capability-driven backing services
|
|
511
|
+
|
|
512
|
+
Some engine capabilities enabled in `wildo.saas.config.ts` REQUIRE a matching
|
|
513
|
+
backing service in **every environment that runs them**. Enabling the capability
|
|
514
|
+
without declaring the service is not a hard failure — it degrades silently, which
|
|
515
|
+
is why it is easy to ship and hard to notice.
|
|
516
|
+
|
|
517
|
+
| Engine capability | Required backing service | What a missing declaration costs |
|
|
518
|
+
|---|---|---|
|
|
519
|
+
| `COMPLIANCE_AUDIT_TRAIL` | `immudb` (`AUDIT_LOG_STORAGE`) | The tamper-evident audit store is unbacked — audit events lose their cryptographic verifiability |
|
|
520
|
+
|
|
521
|
+
The capability lives in `wildo.saas.config.ts` (skill: `config-saas`); the backing
|
|
522
|
+
service lives here, per environment. They are authored in two different files, so
|
|
523
|
+
they drift independently — a capability added later rarely gets back-filled into
|
|
524
|
+
`staging` / `production`.
|
|
525
|
+
|
|
526
|
+
**`wildo config sync` is the enforcement.** It warns per environment, naming the
|
|
527
|
+
capability, the missing kind, and the environments that lack it:
|
|
528
|
+
|
|
529
|
+
```text
|
|
530
|
+
COMPLIANCE_AUDIT_TRAIL is enabled with an audit provider declared, but env(s)
|
|
531
|
+
[production, staging] do not declare an immudb backing store (AUDIT_LOG_STORAGE).
|
|
532
|
+
```
|
|
533
|
+
|
|
534
|
+
Treat that warning as a defect in the infra files, not as noise. The fix is one
|
|
535
|
+
entry per affected environment:
|
|
536
|
+
|
|
537
|
+
```ts
|
|
538
|
+
backingServices: {
|
|
539
|
+
immudb: { source: BackingServiceSource.SELF },
|
|
540
|
+
}
|
|
541
|
+
```
|
|
542
|
+
|
|
543
|
+
**You never author the audit store's signing material.** immudb's whole-server
|
|
544
|
+
substitution defense needs an ECDSA keypair — private half signing the server's
|
|
545
|
+
state, public half pinned by the audit client. The framework provisions,
|
|
546
|
+
distributes, and rotates it automatically the moment the service is declared;
|
|
547
|
+
there is no secret for you to create. If a backend log says
|
|
548
|
+
`immudb state-signature pinning is OFF (IMMUDB_STATE_PUBLIC_KEY unset)`, the
|
|
549
|
+
answer is a `wildo config sync` (which provisions and re-renders), never a
|
|
550
|
+
hand-written key.
|
|
551
|
+
|
|
552
|
+
## Choosing the application's store — and what it obliges
|
|
553
|
+
|
|
554
|
+
`applicationDatabase` selects where THIS application's resources persist, and it
|
|
555
|
+
is a separate axis from `database` (the platform's own store). The substrate is
|
|
556
|
+
declared beside it in `backingServices`; this field is only the selection.
|
|
557
|
+
|
|
558
|
+
Selecting PostgreSQL creates a standing obligation that nothing else will remind
|
|
559
|
+
you about: a resource's table is built by a MIGRATION, not by first write, so
|
|
560
|
+
from then on every schema change owes an artifact. Follow
|
|
561
|
+
`application-database-migrations` — and read
|
|
562
|
+
`references/framework-application-database-api.md` for the contract itself.
|
|
563
|
+
|
|
564
|
+
## References
|
|
565
|
+
|
|
566
|
+
- `references/framework-application-database-api.md` — source-backed `applicationDatabase` contract
|
|
567
|
+
|
|
568
|
+
- `references/infra-config-files.md` — repo paths for infra / secrets
|
|
569
|
+
- `references/framework-backing-services-api.md` — authoritative `BackingServiceKind` vocabulary + per-kind entry shapes (source-extracted; read before adding or re-sourcing a service)
|
|
570
|
+
- `references/framework-environment-deployment-api.md` — `defineInfraEnvConfig` schema + `WildoEnvironment` / `WildoDeploymentRuntime` / `BackingServiceSource` enums
|
|
571
|
+
- `config-saas/SKILL.md` — `wildo.saas.config.ts` (modules / engine capabilities / provider scopes — separate from infra)
|
|
572
|
+
|
|
573
|
+
## Verification
|
|
574
|
+
|
|
575
|
+
- [ ] Infra file is a single `defineInfraEnvConfig({...})` default export
|
|
576
|
+
- [ ] Typed enums used for `environment`, `runtime`, `backingServices.*.source` (no string literals)
|
|
577
|
+
- [ ] Every backing service the app uses is declared with a valid `source`
|
|
578
|
+
- [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
|
|
579
|
+
- [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
|
|
580
|
+
- [ ] `devCompanion` declared for local; `remoteProvider` + `deployment` declared for remote
|
|
581
|
+
- [ ] `wildo local status` (or remote equivalent) shows services healthy with the new wiring
|
|
582
|
+
- [ ] App bootstrap log shows successful connection to each backing service
|
|
583
|
+
- [ ] Documentation updated for teammates if ports / hostnames / sources changed
|
|
584
|
+
|
|
585
|
+
### Grep invariants
|
|
586
|
+
|
|
587
|
+
Run from the app root, substituting `<env>`:
|
|
588
|
+
|
|
589
|
+
| Invariant | Command |
|
|
590
|
+
|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
591
|
+
| Infra file uses typed `defineInfraEnvConfig` | `rg -n "defineInfraEnvConfig\(" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
592
|
+
| Typed `WildoEnvironment` enum used (no string literal) | `rg -n "environment:\s*WildoEnvironment\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
593
|
+
| Typed `WildoDeploymentRuntime` enum used | `rg -n "runtime:\s*WildoDeploymentRuntime\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
594
|
+
| Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
595
|
+
| Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
|
|
596
|
+
| **No secrets** in infra file (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
597
|
+
| **No string-literal `environment`** (must be empty) | `rg -n "environment:\s*['\"](local\|staging\|production)['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
598
|
+
| Local file declares `devCompanion` | `rg -n "devCompanion:\s*\{" infrastructure/local/wildo.infra.local.config.ts` |
|
|
599
|
+
| Remote file declares `remoteProvider` + `deployment` | `rg -n "(remoteProvider\|deployment):\s*\{" infrastructure/<env>/wildo.infra.remote.config.ts` |
|
|
600
|
+
|
|
601
|
+
The high-signal invariants are **"typed enums used"** combined
|
|
602
|
+
with **"no secrets in infra file"** — drift in either direction
|
|
603
|
+
either compromises secret hygiene or silently mistypes an env id.
|
|
604
|
+
|
|
605
|
+
## Common Rationalizations
|
|
606
|
+
|
|
607
|
+
| Rationalization | Reality |
|
|
608
|
+
|-----------------|---------|
|
|
609
|
+
| "Add a top-level `domain` field for the app hostname" | `domain` was deleted as a wrong seam, and the then-misnamed `kubernetes.baseDomain` was renamed to top-level `publicDomain`. The canonical hostname seam is now `publicDomain` (top-level, runtime-agnostic, REQUIRED). The strict schema rejects re-introduction of EITHER `domain` OR `kubernetes.baseDomain`, and both rejections are pinned by the framework's own schema tests. |
|
|
610
|
+
| "Drop the password into the config for now, I'll move it later" | Secrets in git are an outage waiting to happen. Use the secrets store from the first commit; "later" never arrives. |
|
|
611
|
+
| "Use `'local'` as a string instead of `WildoEnvironment.LOCAL`" | Plain string envs bypass typed-enum refactor safety; a typo (`'localhost'`, `'lcl'`) compiles but fails the runtime detection check. |
|
|
612
|
+
| "Skip declaring `clamav` — we don't use virus scanning yet" | If the app's bootstrap initializes the service, the infra config must declare it. Missing entries fail bootstrap with cryptic `undefined` errors. |
|
|
613
|
+
| "Copy production URL into the example config to keep them in sync" | Production URLs in non-production configs are catastrophic when accidentally promoted. Keep production values exclusively in production config + secrets. |
|
|
614
|
+
|
|
615
|
+
## Red Flags
|
|
616
|
+
|
|
617
|
+
- Production URL or registry endpoint checked into a non-production
|
|
618
|
+
config (catastrophic accidental promotion)
|
|
619
|
+
- Secret value (password, key, token) in any infra config file
|
|
620
|
+
(catch with the **No secrets** grep — must be empty)
|
|
621
|
+
- String-literal env value (`environment: 'local'`) instead of typed
|
|
622
|
+
enum (catch with the **No string-literal `environment`** grep — must be empty)
|
|
623
|
+
- Backing service used by the app but not declared in the infra
|
|
624
|
+
config (bootstrap fails with `undefined` connection params)
|
|
625
|
+
- `devCompanion` declared in a remote config (the field is local-only;
|
|
626
|
+
the typed factory may accept it but the companion won't bind correctly)
|
|
627
|
+
- `remoteProvider` or `deployment` declared in a local config (same
|
|
628
|
+
shape mismatch — both fields are remote-only)
|
|
629
|
+
- Backing-service `source` mismatched against the runtime (e.g.
|
|
630
|
+
`BackingServiceSource.SELF` declared but the runtime is
|
|
631
|
+
`KUBERNETES` without a self-hosted manifest)
|
|
632
|
+
|
|
633
|
+
## Related Skills
|
|
634
|
+
|
|
635
|
+
- `local-environment-bootstrap` — operational counterpart: drives the
|
|
636
|
+
`wildo` CLI commands (`setup`, `local up/down/reset`, `config sync`)
|
|
637
|
+
that turn the authored `defineInfraEnvConfig({...})` truth into a
|
|
638
|
+
running local docker-compose stack. **Always pair an edit on this
|
|
639
|
+
side with `wildo setup` (re-seeds env state) or
|
|
640
|
+
`wildo config sync --domain manifest` (re-renders compose only) on
|
|
641
|
+
that side — authored edits do not propagate automatically.**
|
|
642
|
+
- `frontend-cdn-publish` — the OPT-IN `cdn?[serviceKey]` block + `wildo frontend publish` (serve a frontend from object storage + a CDN instead of an nginx pod). Authored in this same infra file; that skill owns the CDN-specific workflow (vendor, Cloudflare, operator steps).
|
|
643
|
+
- `config-saas` — `wildo.saas.config.ts` (modules / engine capabilities / provider scopes — separate from infra)
|
|
644
|
+
- `config-app-shell` — UI shell composition (separate from infra)
|
|
645
|
+
- `config-navigation` — navigation zones (separate from infra)
|
|
646
|
+
- `backend-addon-wiring` — module backend wiring (separate from infra; consumes the runtime services declared here)
|