@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,77 @@
|
|
|
1
|
+
# `applicationDatabase` — selecting this application's store
|
|
2
|
+
|
|
3
|
+
Read this when deciding where an application's own resources persist, or when
|
|
4
|
+
you need to know what selecting PostgreSQL obliges afterwards.
|
|
5
|
+
|
|
6
|
+
## Import Origins
|
|
7
|
+
|
|
8
|
+
- `@wildo-ai/platform-config-lib`
|
|
9
|
+
|
|
10
|
+
## Source Excerpts
|
|
11
|
+
|
|
12
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
/**
|
|
16
|
+
* Which declared backing store the APPLICATION's own resources persist to.
|
|
17
|
+
*
|
|
18
|
+
* ## Why this is a SEPARATE field from `database`
|
|
19
|
+
*
|
|
20
|
+
* `database` above is the PLATFORM's engine — where apps-manager's own tables live. This one is the
|
|
21
|
+
* application's, and the two move independently: a PostgreSQL platform can host a MongoDB
|
|
22
|
+
* application and vice versa. Collapsing them would make one decision imply the other, which is
|
|
23
|
+
* exactly the conflation the emitter's own contract warns against.
|
|
24
|
+
*
|
|
25
|
+
* ## Why it carries only `engine`
|
|
26
|
+
*
|
|
27
|
+
* The SUBSTRATE is already declared: `backingServices.postgresql` says where the database is and
|
|
28
|
+
* who provisions it, and `env-vars-builder` already emits `POSTGRESQL_HOST/PORT/DATABASE` to the
|
|
29
|
+
* application backend whenever the environment self-hosts one. What was missing is the SELECTION,
|
|
30
|
+
* and only the selection belongs here.
|
|
31
|
+
*
|
|
32
|
+
* ## Why an authored field rather than an env variable
|
|
33
|
+
*
|
|
34
|
+
* The emitter states the rule this field exists to satisfy: *"which store an application persists to
|
|
35
|
+
* is a deployment decision that must be legible in one place, not an emergent property of which
|
|
36
|
+
* variables happen to be set"*. Before this, the only way to select PostgreSQL for an application
|
|
37
|
+
* was to hand-edit `backend-api/.env` — machine-local, ungitted, and not reproducible on another
|
|
38
|
+
* developer's machine. That is the same defect the platform `database` field above was added to
|
|
39
|
+
* remove, and the reason both live in the authored, committed config.
|
|
40
|
+
*
|
|
41
|
+
* Absent means MongoDB, matching `ApplicationBackendDataEnvKeys.DATABASE_DEFAULT_ADAPTER`'s own
|
|
42
|
+
* default — so every existing deployment is unaffected by this field existing.
|
|
43
|
+
*
|
|
44
|
+
* @example An application on PostgreSQL, on a platform that is also on PostgreSQL.
|
|
45
|
+
* ```ts
|
|
46
|
+
* database: { engine: DatabaseEngine.POSTGRESQL, source: BackingServiceSource.SELF },
|
|
47
|
+
* applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
|
|
48
|
+
* backingServices: {
|
|
49
|
+
* postgresql: { source: BackingServiceSource.SELF, database: 'my-app-db' },
|
|
50
|
+
* },
|
|
51
|
+
* ```
|
|
52
|
+
*/
|
|
53
|
+
applicationDatabase: z
|
|
54
|
+
.strictObject({
|
|
55
|
+
engine: z.enum(DatabaseEngine),
|
|
56
|
+
})
|
|
57
|
+
.optional(),
|
|
58
|
+
/**
|
|
59
|
+
* ## Choosing PostgreSQL creates a standing obligation — MIGRATIONS
|
|
60
|
+
*
|
|
61
|
+
* This is the part that is easy to miss, and it is not a detail of deployment: on MongoDB a
|
|
62
|
+
* collection exists the moment something writes to it, so a new resource needs nothing. On
|
|
63
|
+
* PostgreSQL a resource's TABLE is built by a MIGRATION, and nothing creates it implicitly. So on
|
|
64
|
+
* this engine, adding or reshaping a resource owes an artifact:
|
|
65
|
+
*
|
|
66
|
+
* - `wildo db diff` — what separates the model from the accepted plan;
|
|
67
|
+
* - `wildo db generate --name <label>` — writes `backend-api/migrations/<timestamp>_<name>/`
|
|
68
|
+
* AND advances `backend-api/migrations/schema-plan.lock.json`, in one step. Commit them
|
|
69
|
+
* TOGETHER; either one alone is the two-artifact drift the design exists to prevent;
|
|
70
|
+
* - `wildo db migrate` — applies pending migrations by hand. Usually unnecessary: the application
|
|
71
|
+
* backend applies them at BOOT, and `wildo local dev` reconciles drift before the app starts.
|
|
72
|
+
*
|
|
73
|
+
* Skip it and nothing warns until the backend refuses to start with
|
|
74
|
+
* `postgresql_table_schema_mismatch` — an accurate message that names neither the migration nor
|
|
75
|
+
* the command. See the `application-database-migrations` skill.
|
|
76
|
+
*/
|
|
77
|
+
```
|
package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md
ADDED
|
@@ -0,0 +1,282 @@
|
|
|
1
|
+
# Backing services (source)
|
|
2
|
+
|
|
3
|
+
Read this before adding, removing, or re-sourcing anything under
|
|
4
|
+
`backingServices: { ... }` in an environment file.
|
|
5
|
+
|
|
6
|
+
- The **closed `BackingServiceKind` vocabulary** — the complete set of service kinds
|
|
7
|
+
an environment may declare. Never invent a key; the schema is `.strict()` and an
|
|
8
|
+
unknown key fails at parse time.
|
|
9
|
+
- The **`BackingServiceSource` hosting-model axis** (`SELF` / `MANAGED`) and how it
|
|
10
|
+
composes with the orthogonal `provider: '<brand>'` field.
|
|
11
|
+
- The **per-kind entry shape** — which extra field each kind carries and why
|
|
12
|
+
(`database` as a NAME for Mongo/Postgres/immudb vs. an INTEGER INDEX for Redis;
|
|
13
|
+
`vhost` for RabbitMQ; `endpoint` + `bucket` for S3; nothing extra for the
|
|
14
|
+
stateless kinds).
|
|
15
|
+
|
|
16
|
+
Trust this over any prose list of kinds: prose drifts as kinds are added, this is
|
|
17
|
+
extracted from the schema itself.
|
|
18
|
+
|
|
19
|
+
## Import Origins
|
|
20
|
+
|
|
21
|
+
- `@wildo-ai/platform-config-lib`
|
|
22
|
+
|
|
23
|
+
## Source Excerpts
|
|
24
|
+
|
|
25
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
*/
|
|
29
|
+
export enum BackingServiceKind {
|
|
30
|
+
MONGODB = 'mongodb',
|
|
31
|
+
REDIS = 'redis',
|
|
32
|
+
RABBITMQ = 'rabbitmq',
|
|
33
|
+
S3 = 's3',
|
|
34
|
+
POSTGRESQL = 'postgresql',
|
|
35
|
+
GOTENBERG = 'gotenberg',
|
|
36
|
+
CLAMAV = 'clamav',
|
|
37
|
+
/**
|
|
38
|
+
* immudb — an immutable, cryptographically-verifiable database used as a
|
|
39
|
+
* tamper-evident audit-log store (fills the `AUDIT_LOG_STORAGE` capability).
|
|
40
|
+
* A stateful DB: a data volume in dev, self-hosted or immudb Vault in prod.
|
|
41
|
+
*/
|
|
42
|
+
IMMUDB = 'immudb',
|
|
43
|
+
/**
|
|
44
|
+
* Metrics / telemetry sink (Prometheus, DataDog, OpenTelemetry, …).
|
|
45
|
+
* Stateless base for now.
|
|
46
|
+
*/
|
|
47
|
+
METRICS = 'metrics-telemetry',
|
|
48
|
+
/**
|
|
49
|
+
* Backup orchestration target. Stateless base for now.
|
|
50
|
+
*/
|
|
51
|
+
BACKUP = 'backup',
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Hosting model of a backing service instance — the orthogonal axis to
|
|
56
|
+
* the **brand** (which is captured by the per-kind `provider` field).
|
|
57
|
+
*
|
|
58
|
+
* - `self`: self-hosted (Docker/K8s container managed by the platform,
|
|
59
|
+
* or operator-managed on-prem). Brands here are open-source
|
|
60
|
+
* software names (e.g. MinIO for S3, vanilla Postgres / MongoDB).
|
|
61
|
+
* - `managed`: external vendor-managed service. Brands here are
|
|
62
|
+
* vendor names (e.g. `'atlas'` for MongoDB Atlas, `'aws-rds'` for
|
|
63
|
+
* AWS RDS, `'supabase'` for Supabase Postgres, `'aws'` for AWS S3).
|
|
64
|
+
*
|
|
65
|
+
* **Slice 4.B.0 reshape (2026-05-07)**: the `ATLAS` value was removed.
|
|
66
|
+
* Pre-reshape `source: ATLAS` becomes `source: MANAGED, provider:
|
|
67
|
+
* 'atlas'`. The reshape generalizes from "Mongo + S3 are the only
|
|
68
|
+
* brand-aware kinds" to "every kind can be brand-aware when the
|
|
69
|
+
* managed market has multiple vendors" — Postgres in particular
|
|
70
|
+
* (RDS / GCP Cloud SQL / Supabase / Neon / Render / Azure).
|
|
71
|
+
*/
|
|
72
|
+
export enum BackingServiceSource {
|
|
73
|
+
SELF = 'self',
|
|
74
|
+
MANAGED = 'managed',
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Common fields every backing-service entry shares.
|
|
79
|
+
*
|
|
80
|
+
* Per-kind extensions add the fields that are SEMANTICALLY meaningful
|
|
81
|
+
* for that kind only. Slice 3 closeout (M-4 + L-5): the previous shared
|
|
82
|
+
* `BackingServiceEnvConfigSchema` collapsed `database` into a
|
|
83
|
+
* `union(int, string)` and put `name` only on Mongo; both compromised
|
|
84
|
+
* the framework-mindset rule that "every field must carry its semantic
|
|
85
|
+
* weight". The split below means a typo like `redis: { database:
|
|
86
|
+
* 'staging' }` (string on a kind that needs an integer DB index) is
|
|
87
|
+
* rejected at parse time instead of crashing the runtime client at
|
|
88
|
+
* connect time.
|
|
89
|
+
*/
|
|
90
|
+
const BackingServiceBaseSchema = z.object({
|
|
91
|
+
source: z.enum(BackingServiceSource),
|
|
92
|
+
/**
|
|
93
|
+
* Brand of the backing service. Orthogonal to `source` (hosting
|
|
94
|
+
* model). Required-in-spirit when `source === MANAGED` and the
|
|
95
|
+
* managed market has multiple vendors (Mongo: `'atlas'` /
|
|
96
|
+
* `'aws-documentdb'` / …; Postgres: `'aws-rds'` / `'gcp-cloud-sql'`
|
|
97
|
+
* / `'supabase'` / `'neon'` / `'render'` / `'azure-database'`;
|
|
98
|
+
* S3: `'aws'` / `'cloudflare-r2'` / …); optional when `source ===
|
|
99
|
+
* SELF` (e.g. S3-self-hosted defaults to MinIO; `provider:
|
|
100
|
+
* 'minio'` is allowed but redundant).
|
|
101
|
+
*
|
|
102
|
+
* Modeled as `z.string().optional()` rather than per-kind enum
|
|
103
|
+
* unions to keep this base schema simple — the canonical brand
|
|
104
|
+
* vocabulary lives in `resolveInfraProvider`'s dispatch table
|
|
105
|
+
* (each kind documents which brand strings it recognizes; unknown
|
|
106
|
+
* brands fall back to the kind's generic `<KIND>_MANAGED` /
|
|
107
|
+
* `<KIND>_SELF` entry where one exists, otherwise return
|
|
108
|
+
* `undefined`).
|
|
109
|
+
*
|
|
110
|
+
* Slice 4.B.0 (2026-05-07) generalized this from "S3-only" to
|
|
111
|
+
* every brand-aware kind.
|
|
112
|
+
*/
|
|
113
|
+
provider: z.string().min(1).optional(),
|
|
114
|
+
/**
|
|
115
|
+
* Override the catalog-derived hostname for this kind. Honored at
|
|
116
|
+
* `HOST_FACING` perspective (always) and at `CONTAINER_INTERNAL` for
|
|
117
|
+
* `MANAGED` sources. SELF + `CONTAINER_INTERNAL` keeps the catalog
|
|
118
|
+
* container name because that is the only DNS the container network
|
|
119
|
+
* can resolve.
|
|
120
|
+
*/
|
|
121
|
+
host: z.string().min(1).optional(),
|
|
122
|
+
/**
|
|
123
|
+
* Override the catalog-derived listen port. Threaded into both
|
|
124
|
+
* docker-compose `<authored>:<authored>` publish and the per-app
|
|
125
|
+
* env-vars (`<KIND>_PORT`).
|
|
126
|
+
*/
|
|
127
|
+
port: z.number().int().positive().optional(),
|
|
128
|
+
}).strict();
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* MongoDB backing service. `database` is the database NAME (string).
|
|
132
|
+
*
|
|
133
|
+
* Mongo's connection URL has the shape `mongodb://host:port/<database>`
|
|
134
|
+
* — this string corresponds to the path segment. Pre-3 the field was
|
|
135
|
+
* `name`; renamed to `database` in Slice 3 closeout (L-5) so all
|
|
136
|
+
* data-store kinds use the same property name for the same concept
|
|
137
|
+
* (vs. Postgres which already used `database`).
|
|
138
|
+
*/
|
|
139
|
+
export const MongoBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
140
|
+
database: z.string().min(1).optional(),
|
|
141
|
+
}).strict();
|
|
142
|
+
export type MongoBackingService = z.infer<typeof MongoBackingServiceSchema>;
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Redis backing service. `database` is the LOGICAL DB INDEX (integer).
|
|
146
|
+
*
|
|
147
|
+
* Redis exposes 16 logical databases (0–15) on a single connection.
|
|
148
|
+
* Authoring a string here (e.g. `'staging'`) would silently parse on
|
|
149
|
+
* the pre-3 union schema and crash ioredis at connect; the integer
|
|
150
|
+
* constraint with `max(15)` fails loud at parse time.
|
|
151
|
+
*/
|
|
152
|
+
export const RedisBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
153
|
+
database: z.number().int().min(0).max(15).optional(),
|
|
154
|
+
}).strict();
|
|
155
|
+
export type RedisBackingService = z.infer<typeof RedisBackingServiceSchema>;
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* PostgreSQL backing service. `database` is the database NAME (string).
|
|
159
|
+
*
|
|
160
|
+
* Symmetric with `MongoBackingService.database` — both are the
|
|
161
|
+
* database identifier in their respective connection URLs.
|
|
162
|
+
*/
|
|
163
|
+
export const PostgresBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
164
|
+
database: z.string().min(1).optional(),
|
|
165
|
+
}).strict();
|
|
166
|
+
export type PostgresBackingService = z.infer<typeof PostgresBackingServiceSchema>;
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* RabbitMQ backing service. `vhost` is the RabbitMQ virtual host.
|
|
170
|
+
*
|
|
171
|
+
* AMQP virtual hosts isolate exchange/queue namespaces inside a single
|
|
172
|
+
* broker. NOT a database — RabbitMQ has no DB concept — so the field
|
|
173
|
+
* is intentionally NOT named `database`.
|
|
174
|
+
*/
|
|
175
|
+
export const RabbitBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
176
|
+
vhost: z.string().min(1).optional(),
|
|
177
|
+
}).strict();
|
|
178
|
+
export type RabbitBackingService = z.infer<typeof RabbitBackingServiceSchema>;
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* S3-compatible backing service (MinIO, Scaleway Object Storage, AWS).
|
|
182
|
+
*
|
|
183
|
+
* `endpoint` is a URL (`http://localhost:9000`, `https://s3.eu-west.amazonaws.com`)
|
|
184
|
+
* — the resolver parses it into host/port. `bucket` is the S3 bucket
|
|
185
|
+
* name. NOT a database — S3 has no DB concept.
|
|
186
|
+
*/
|
|
187
|
+
export const S3BackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
188
|
+
endpoint: z.string().min(1).optional(),
|
|
189
|
+
bucket: z.string().min(1).optional(),
|
|
190
|
+
}).strict();
|
|
191
|
+
export type S3BackingService = z.infer<typeof S3BackingServiceSchema>;
|
|
192
|
+
|
|
193
|
+
/** Gotenberg PDF service. Stateless, no database/vhost/bucket. */
|
|
194
|
+
export const GotenbergBackingServiceSchema = BackingServiceBaseSchema;
|
|
195
|
+
export type GotenbergBackingService = z.infer<typeof GotenbergBackingServiceSchema>;
|
|
196
|
+
|
|
197
|
+
/** ClamAV anti-virus daemon. Stateless, no database/vhost/bucket. */
|
|
198
|
+
export const ClamAvBackingServiceSchema = BackingServiceBaseSchema;
|
|
199
|
+
export type ClamAvBackingService = z.infer<typeof ClamAvBackingServiceSchema>;
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* immudb backing service (tamper-evident audit-log store). A stateful DB —
|
|
203
|
+
* `database` names the immudb database (defaults to `defaultdb` at runtime);
|
|
204
|
+
* credentials come from the secrets pipeline like every other backing service.
|
|
205
|
+
*
|
|
206
|
+
* Declare this in EVERY environment where the `COMPLIANCE_AUDIT_TRAIL` engine
|
|
207
|
+
* capability is enabled. `wildo config sync` warns per environment when the audit
|
|
208
|
+
* capability is on but no environment declares an audit store, and the audit client
|
|
209
|
+
* then has nowhere tamper-evident to write.
|
|
210
|
+
*
|
|
211
|
+
* You do NOT author the state-signing keypair that makes the store's
|
|
212
|
+
* whole-server-substitution defense work. The framework provisions it (private half
|
|
213
|
+
* mounted into a `source: SELF` immudb via `--signingKey`, public half pinned by the
|
|
214
|
+
* audit client as `IMMUDB_STATE_PUBLIC_KEY`) — declaring the service is the whole job.
|
|
215
|
+
*
|
|
216
|
+
* @example
|
|
217
|
+
* ```ts
|
|
218
|
+
* backingServices: {
|
|
219
|
+
* immudb: { source: BackingServiceSource.SELF },
|
|
220
|
+
* }
|
|
221
|
+
* ```
|
|
222
|
+
*/
|
|
223
|
+
export const ImmudbBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
224
|
+
database: z.string().min(1).optional(),
|
|
225
|
+
}).strict();
|
|
226
|
+
export type ImmudbBackingService = z.infer<typeof ImmudbBackingServiceSchema>;
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Metrics / telemetry sink (Prometheus / DataDog / OpenTelemetry / …).
|
|
230
|
+
* Stateless base for now.
|
|
231
|
+
*/
|
|
232
|
+
export const MetricsBackingServiceSchema = BackingServiceBaseSchema;
|
|
233
|
+
export type MetricsBackingService = z.infer<typeof MetricsBackingServiceSchema>;
|
|
234
|
+
|
|
235
|
+
/**
|
|
236
|
+
* Backup orchestration target. Stateless base for now.
|
|
237
|
+
*/
|
|
238
|
+
export const BackupBackingServiceSchema = BackingServiceBaseSchema;
|
|
239
|
+
export type BackupBackingService = z.infer<typeof BackupBackingServiceSchema>;
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* Discriminated UNION over all backing-service kinds. Used by the
|
|
243
|
+
* `ServiceAddressResolver` and helpers that accept any kind and read
|
|
244
|
+
* only base fields (`source`, `host`, `port`). Consumers that need
|
|
245
|
+
* kind-specific fields MUST narrow first (e.g. via the per-kind type
|
|
246
|
+
* exports above).
|
|
247
|
+
*/
|
|
248
|
+
export type BackingServiceEnvConfig =
|
|
249
|
+
| MongoBackingService
|
|
250
|
+
| RedisBackingService
|
|
251
|
+
| PostgresBackingService
|
|
252
|
+
| RabbitBackingService
|
|
253
|
+
| S3BackingService
|
|
254
|
+
| GotenbergBackingService
|
|
255
|
+
| ClamAvBackingService
|
|
256
|
+
| ImmudbBackingService
|
|
257
|
+
| MetricsBackingService
|
|
258
|
+
| BackupBackingService;
|
|
259
|
+
|
|
260
|
+
/**
|
|
261
|
+
* Per-environment backing services config (source for each service).
|
|
262
|
+
* Used in environment-specific infra descriptors.
|
|
263
|
+
*
|
|
264
|
+
* Keys stay optional because an app-owned environment only needs to declare the
|
|
265
|
+
* backing services it actually enables. Requiring the full enum-keyed record
|
|
266
|
+
* would force disabled services (for example `postgresql`) into every env file
|
|
267
|
+
* and breaks truthful flattened targeted-app declarations.
|
|
268
|
+
*/
|
|
269
|
+
export const BackingServicesEnvConfigSchema = z.object({
|
|
270
|
+
[BackingServiceKind.MONGODB]: MongoBackingServiceSchema.optional(),
|
|
271
|
+
[BackingServiceKind.REDIS]: RedisBackingServiceSchema.optional(),
|
|
272
|
+
[BackingServiceKind.RABBITMQ]: RabbitBackingServiceSchema.optional(),
|
|
273
|
+
[BackingServiceKind.S3]: S3BackingServiceSchema.optional(),
|
|
274
|
+
[BackingServiceKind.POSTGRESQL]: PostgresBackingServiceSchema.optional(),
|
|
275
|
+
[BackingServiceKind.GOTENBERG]: GotenbergBackingServiceSchema.optional(),
|
|
276
|
+
[BackingServiceKind.CLAMAV]: ClamAvBackingServiceSchema.optional(),
|
|
277
|
+
[BackingServiceKind.IMMUDB]: ImmudbBackingServiceSchema.optional(),
|
|
278
|
+
[BackingServiceKind.METRICS]: MetricsBackingServiceSchema.optional(),
|
|
279
|
+
[BackingServiceKind.BACKUP]: BackupBackingServiceSchema.optional(),
|
|
280
|
+
}).strict();
|
|
281
|
+
export type BackingServicesEnvConfig = z.infer<typeof BackingServicesEnvConfigSchema>;
|
|
282
|
+
```
|
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
# Environment & deployment descriptors (source)
|
|
2
|
+
|
|
3
|
+
- Environment id validation (`WildoEnvironmentIdSchema`), common ids, deployment runtime enum, and Docker Compose / Kubernetes deployment shapes used by platform tooling.
|
|
4
|
+
|
|
5
|
+
## Import Origins
|
|
6
|
+
|
|
7
|
+
- `@wildo-ai/platform-config-lib`
|
|
8
|
+
|
|
9
|
+
## Source Excerpts
|
|
10
|
+
|
|
11
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
*
|
|
15
|
+
* Convenience environment ids kept for common local/staging/production setups.
|
|
16
|
+
*
|
|
17
|
+
* The project model is no longer limited to a fixed environment set: remote
|
|
18
|
+
* environment ids can be any slug-like value. Use `WildoEnvironmentIdSchema`
|
|
19
|
+
* for authoritative validation.
|
|
20
|
+
*/
|
|
21
|
+
export enum WildoEnvironment {
|
|
22
|
+
LOCAL = 'local',
|
|
23
|
+
STAGING = 'staging',
|
|
24
|
+
PRODUCTION = 'production',
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export const WildoEnvironmentIdSchema = z
|
|
28
|
+
.string()
|
|
29
|
+
.min(1)
|
|
30
|
+
.regex(
|
|
31
|
+
/^[a-z0-9]+(?:-[a-z0-9]+)*$/,
|
|
32
|
+
'environment ids must be lowercase alphanumeric with optional hyphen-separated segments',
|
|
33
|
+
);
|
|
34
|
+
export type WildoEnvironmentId = z.infer<typeof WildoEnvironmentIdSchema>;
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Deployment runtime targets for CI/CD workflows and infra config.
|
|
38
|
+
*
|
|
39
|
+
* Single source of truth for deployment runtime targets, used by both
|
|
40
|
+
* platform-config-lib (developer-facing config) and wildo-cli (operational).
|
|
41
|
+
*/
|
|
42
|
+
export enum WildoDeploymentRuntime {
|
|
43
|
+
DOCKER_COMPOSE = 'docker-compose',
|
|
44
|
+
KUBERNETES = 'kubernetes',
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export enum WildoLocationType {
|
|
48
|
+
LOCAL = 'local',
|
|
49
|
+
REMOTE = 'remote',
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function isLocalEnvironmentId(environmentId: string): boolean {
|
|
53
|
+
return environmentId === WildoEnvironment.LOCAL;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* K8s-internal cluster topology. Holds ONLY values that are genuinely
|
|
58
|
+
* specific to a Kubernetes deployment (the namespace and the optional
|
|
59
|
+
* ingress class).
|
|
60
|
+
*
|
|
61
|
+
* The external/public hostname (where browsers and reverse proxies hit
|
|
62
|
+
* us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
|
|
63
|
+
* as `publicDomain` because it applies to BOTH `KUBERNETES` and
|
|
64
|
+
* `DOCKER_COMPOSE` runtimes. See `external-public-domain-rename.md`
|
|
65
|
+
* for the rationale (the previous `baseDomain` field on this object
|
|
66
|
+
* conflated K8s-internal and reverse-proxy concerns).
|
|
67
|
+
*/
|
|
68
|
+
export const WildoKubernetesConfigSchema = z.object({
|
|
69
|
+
namespace: z.string().min(1),
|
|
70
|
+
ingressClass: z.string().min(1).optional(),
|
|
71
|
+
});
|
|
72
|
+
export type WildoKubernetesConfig = z.infer<typeof WildoKubernetesConfigSchema>;
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* cert-manager `ClusterIssuer` selection for remote TLS. Both issuers are
|
|
76
|
+
* always provisioned in the cluster (see `cluster-issuer.yaml.hbs`); this
|
|
77
|
+
* picks which one an application's ingress annotation
|
|
78
|
+
* (`cert-manager.io/cluster-issuer`) points at — i.e. which ACME endpoint
|
|
79
|
+
* issues its per-ingress certificate.
|
|
80
|
+
*
|
|
81
|
+
* - `LETSENCRYPT_PROD` — real, browser-trusted certificates. The default,
|
|
82
|
+
* because a remote deployment implies a real domain that browsers must
|
|
83
|
+
* trust. Subject to Let's Encrypt production rate limits
|
|
84
|
+
* (50 certs / registered domain / week).
|
|
85
|
+
* - `LETSENCRYPT_STAGING` — untrusted test certificates with far higher
|
|
86
|
+
* rate limits. Opt into this **while validating DNS + ingress on a new
|
|
87
|
+
* cluster** so a misconfigured first deploy cannot exhaust the prod
|
|
88
|
+
* quota, then flip to prod once issuance succeeds.
|
|
89
|
+
*/
|
|
90
|
+
export enum WildoTlsIssuer {
|
|
91
|
+
LETSENCRYPT_PROD = 'letsencrypt-prod',
|
|
92
|
+
LETSENCRYPT_STAGING = 'letsencrypt-staging',
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
export const WildoRemoteProviderSchema = z.object({
|
|
96
|
+
provider: z.string().min(1),
|
|
97
|
+
registryEndpoint: z.string().min(1),
|
|
98
|
+
region: z.string().min(1).optional(),
|
|
99
|
+
/**
|
|
100
|
+
* ACME registration email for Let's Encrypt (`ClusterIssuer.spec.acme.email`).
|
|
101
|
+
* Optional at the schema level so non-TLS remote configs parse, but a
|
|
102
|
+
* remote Kubernetes environment that terminates TLS should author it —
|
|
103
|
+
* Let's Encrypt uses it for expiry warnings and account recovery.
|
|
104
|
+
*/
|
|
105
|
+
acmeEmail: z.email().optional(),
|
|
106
|
+
/**
|
|
107
|
+
* Which cert-manager `ClusterIssuer` this environment's ingresses use.
|
|
108
|
+
* Defaults to `LETSENCRYPT_PROD` downstream when unset. See {@link WildoTlsIssuer}.
|
|
109
|
+
*/
|
|
110
|
+
tlsIssuer: z.enum(WildoTlsIssuer).optional(),
|
|
111
|
+
});
|
|
112
|
+
export type WildoRemoteProvider = z.infer<typeof WildoRemoteProviderSchema>;
|
|
113
|
+
|
|
114
|
+
export const WildoLoggingConfigSchema = z.object({
|
|
115
|
+
level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
|
|
116
|
+
formattedConsoleErrors: z.boolean().optional(),
|
|
117
|
+
});
|
|
118
|
+
export type WildoLoggingConfig = z.infer<typeof WildoLoggingConfigSchema>;
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* Per-environment OTLP telemetry (traces + metrics + logs) posture (Slice 2 Phase 5).
|
|
122
|
+
*
|
|
123
|
+
* `env-vars-builder` projects this block onto the standard `OTEL_*` env vars that the
|
|
124
|
+
* `otel-preload.ts` SDK (in `saas-backend-lib`) reads BEFORE app code:
|
|
125
|
+
* - `enabled` → `OTEL_ENABLED` (the master gate) + drives the `--import` preload wiring.
|
|
126
|
+
* - `endpoint` → `OTEL_EXPORTER_OTLP_ENDPOINT` (the OTLP/HTTP collector/ingest URL).
|
|
127
|
+
* The provider auth header (`OTEL_EXPORTER_OTLP_HEADERS`) is NOT authored here — it is
|
|
128
|
+
* derived by `env-vars-builder` from the selected `OBSERVABILITY_TELEMETRY` provider's
|
|
129
|
+
* secret (e.g. a BetterStack source token). Persisted into `PlatformEnvConfigJson.observability`
|
|
130
|
+
* and hydrated back by `hydrateEnvironmentFromConfig`, mirroring `logging`.
|
|
131
|
+
*/
|
|
132
|
+
export const WildoObservabilityConfigSchema = z.object({
|
|
133
|
+
/**
|
|
134
|
+
* Master switch for OTLP telemetry. `true` → emit `OTEL_ENABLED=true` + wire the
|
|
135
|
+
* `--import @wildo-ai/saas-backend-lib/otel-preload` preload; the preload starts the SDK.
|
|
136
|
+
* `false`/omitted → a complete no-op (the preload self-gates).
|
|
137
|
+
*/
|
|
138
|
+
enabled: z.boolean().default(false),
|
|
139
|
+
/**
|
|
140
|
+
* OTLP/HTTP endpoint (`OTEL_EXPORTER_OTLP_ENDPOINT`). Local dev: the local `otel-collector`
|
|
141
|
+
* (`http://localhost:4318`). Remote: the selected provider's ingesting host (e.g. a BetterStack
|
|
142
|
+
* source URL). When omitted, the OTLP exporters fall back to their own default
|
|
143
|
+
* (`http://localhost:4318`), which is the local collector — convenient for local dev.
|
|
144
|
+
*/
|
|
145
|
+
endpoint: z.string().optional(),
|
|
146
|
+
/**
|
|
147
|
+
* LLM-call observability env-layer posture — a SEPARATE signal from OTLP
|
|
148
|
+
* telemetry (fed by the engine `AgentCallTraceSink` into the selected
|
|
149
|
+
* `LLM_OBSERVABILITY` provider, e.g. PostHog `$ai_generation`), colocated
|
|
150
|
+
* here because both are per-environment observability posture. Projected
|
|
151
|
+
* onto the `WILDO_LLM_OBS_*` env vars INDEPENDENTLY of the OTLP `enabled`
|
|
152
|
+
* gate — LLM-obs activation is provider-selection-driven, not
|
|
153
|
+
* `OTEL_ENABLED`-driven.
|
|
154
|
+
*/
|
|
155
|
+
llmObservability: z.object({
|
|
156
|
+
/**
|
|
157
|
+
* Forward prompt + completion content (`$ai_input` / `$ai_output_choices`)
|
|
158
|
+
* to the LLM-observability provider (→ `WILDO_LLM_OBS_CAPTURE_CONTENT`).
|
|
159
|
+
* Default FALSE: content is user/app data (PII) shipped to a third party —
|
|
160
|
+
* opt in per environment (local dev typically true; production a
|
|
161
|
+
* deliberate decision).
|
|
162
|
+
*/
|
|
163
|
+
captureContent: z.boolean().default(false),
|
|
164
|
+
/**
|
|
165
|
+
* Fraction (0..1) of agent calls forwarded (→ `WILDO_LLM_OBS_SAMPLE_RATE`).
|
|
166
|
+
* Omitted = capture every call.
|
|
167
|
+
*/
|
|
168
|
+
sampleRate: z.number().min(0).max(1).optional(),
|
|
169
|
+
/**
|
|
170
|
+
* NON-SECRET env for the selected LLM-observability provider — connection
|
|
171
|
+
* details the provider module reads from the runtime env (e.g. PostHog's
|
|
172
|
+
* `POSTHOG_HOST` ingestion host and `POSTHOG_PROJECT_ID`). Projected
|
|
173
|
+
* verbatim into the runtime env; the env-key names are provider-owned,
|
|
174
|
+
* same vocabulary as `secrets.json → providerEnv`. Secrets (API keys)
|
|
175
|
+
* do NOT belong here — they stay in `secrets.json → providerEnv`, which
|
|
176
|
+
* also WINS on a key collision (secrets are the more specific layer).
|
|
177
|
+
* This is the checked-in home for provider config that is not sensitive.
|
|
178
|
+
*/
|
|
179
|
+
providerEnv: z.record(z.string(), z.string()).optional(),
|
|
180
|
+
}).optional(),
|
|
181
|
+
});
|
|
182
|
+
export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSchema>;
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Per-environment external-provider SELECTION override (2026-07-10).
|
|
186
|
+
*
|
|
187
|
+
* The app-wide primary/fallback selection for an `EngineCapability` lives in
|
|
188
|
+
* `wildo.saas.config.ts` (`providers.scopes.backend.selection[capability]`) —
|
|
189
|
+
* a single value shared by every environment. This block lets an environment
|
|
190
|
+
* OVERRIDE that primary (and fallbacks) without touching the shared SaaS
|
|
191
|
+
* config, so e.g. LOCAL can select the non-sending `email-preview` provider
|
|
192
|
+
* for `EMAIL_TRANSACTIONAL` while staging/production keep `resend`.
|
|
193
|
+
*
|
|
194
|
+
* Semantics (mirrors the SaaS-side selection policy):
|
|
195
|
+
* - `primary` — the ref that wins for this capability in this environment.
|
|
196
|
+
* - `fallbacks` — ordered failover refs (optional).
|
|
197
|
+
*
|
|
198
|
+
* The referenced provider must still be DECLARED in
|
|
199
|
+
* `providers.scopes.backend.providers` and available for the capability — the
|
|
200
|
+
* backend's availability/enabled filtering is unchanged, so an override that
|
|
201
|
+
* names an undeclared or capability-disabled provider resolves to nothing
|
|
202
|
+
* (same fail-closed behaviour as an equivalent SaaS-side selection). FAN_OUT
|
|
203
|
+
* capabilities ignore the override (every declared provider is active — a
|
|
204
|
+
* primary/failover is meaningless), matching the SaaS-side rule.
|
|
205
|
+
*
|
|
206
|
+
* `env-vars-builder` serializes this block to the `WILDO_PROVIDER_SELECTION_OVERRIDES`
|
|
207
|
+
* backend env var (JSON); `ExternalProvidersRegistryBackendService` reads it and
|
|
208
|
+
* applies it over the SaaS-config selection at capability-resolution time.
|
|
209
|
+
* Persisted into `PlatformEnvConfigJson.providerSelection` and hydrated back by
|
|
210
|
+
* `hydrateEnvironmentFromConfig`, mirroring `logging` / `observability`.
|
|
211
|
+
*/
|
|
212
|
+
export const WildoProviderSelectionOverrideEntrySchema = z.strictObject({
|
|
213
|
+
primary: z.string().min(1),
|
|
214
|
+
fallbacks: z.array(z.string().min(1)).optional(),
|
|
215
|
+
});
|
|
216
|
+
export type WildoProviderSelectionOverrideEntry = z.infer<typeof WildoProviderSelectionOverrideEntrySchema>;
|
|
217
|
+
|
|
218
|
+
export const WildoProviderSelectionOverridesSchema = z.partialRecord(
|
|
219
|
+
z.enum(EngineCapability),
|
|
220
|
+
WildoProviderSelectionOverrideEntrySchema,
|
|
221
|
+
);
|
|
222
|
+
export type WildoProviderSelectionOverrides = z.infer<typeof WildoProviderSelectionOverridesSchema>;
|
|
223
|
+
|
|
224
|
+
export enum DatabaseEngine {
|
|
225
|
+
MONGODB = 'mongodb',
|
|
226
|
+
POSTGRESQL = 'postgresql',
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
export enum WildoImageTagStrategy {
|
|
230
|
+
COMMIT_SHA = 'commit-sha',
|
|
231
|
+
BRANCH_NAME = 'branch-name',
|
|
232
|
+
SEMVER = 'semver',
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/**
|
|
236
|
+
* Docker Compose deployment — no scaling, no K8s-specific fields.
|
|
237
|
+
*/
|
|
238
|
+
export const DockerComposeDeploymentSchema = z.object({
|
|
239
|
+
branch: z.string().min(1),
|
|
240
|
+
runtime: z.literal(WildoDeploymentRuntime.DOCKER_COMPOSE),
|
|
241
|
+
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
242
|
+
});
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Kubernetes deployment — includes registry, namespace, and scaling support.
|
|
246
|
+
*/
|
|
247
|
+
export const KubernetesDeploymentSchema = z.object({
|
|
248
|
+
branch: z.string().min(1),
|
|
249
|
+
runtime: z.literal(WildoDeploymentRuntime.KUBERNETES),
|
|
250
|
+
registry: z.string().min(1).optional(),
|
|
251
|
+
namespace: z.string().min(1).optional(),
|
|
252
|
+
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
253
|
+
});
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* Deployment configuration for CI/CD pipeline integration.
|
|
257
|
+
* Discriminated on `runtime`: K8s-specific fields (`registry`, `namespace`)
|
|
258
|
+
* are only available when `runtime` is `KUBERNETES`.
|
|
259
|
+
*/
|
|
260
|
+
export const WildoDeploymentConfigSchema = z.discriminatedUnion('runtime', [
|
|
261
|
+
DockerComposeDeploymentSchema,
|
|
262
|
+
KubernetesDeploymentSchema,
|
|
263
|
+
]);
|
|
264
|
+
export type WildoDeploymentConfig = z.infer<typeof WildoDeploymentConfigSchema>;
|
|
265
|
+
```
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Infrastructure Config Files
|
|
2
|
+
|
|
3
|
+
**Typical:** `wildo.infra.*.config.ts` or project env layout under `./infrastructure/`.
|
|
4
|
+
|
|
5
|
+
- Secrets stay out of git — use env + secrets store per project policy.
|
|
6
|
+
- Local vs remote: verify which file the active `wildo` profile reads.
|
|
7
|
+
- Changing URLs/ports requires restarting dev stacks.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: journey-approve
|
|
3
|
+
description: "Guide the creator through ACCEPTING landed application-creation work — review the working edits and commit them. Use when the user says \"journey approve\", \"accept this run\", \"approve the landed files\", or asks how acceptance works. Acceptance is a git commit by a human; there is no other approval mechanism."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Journey Approve — Acceptance Is a Commit
|
|
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
|
+
There are no authority requests, approval queues or acceptance ceremonies. A playbook run lands
|
|
23
|
+
FILES in the specifications package; they are working edits until a human commits them. Git gives
|
|
24
|
+
the whole safety story: diff to review, commit to accept, revert to undo, log as the audit trail.
|
|
25
|
+
|
|
26
|
+
## Workflow
|
|
27
|
+
|
|
28
|
+
1. **Show what is awaiting acceptance** — `git status` and `git diff` in the application's
|
|
29
|
+
`specifications/` package, grouped by family.
|
|
30
|
+
2. **Bring the evidence to the review**: the run's `generation` findings and the advisory
|
|
31
|
+
`judge` verdicts (from the run response or `GET /api/companion/traces/<sessionId>`) are the
|
|
32
|
+
reviewer's briefing — surface `CONCERN`/`GAP` rationales beside the diff they concern.
|
|
33
|
+
3. **The creator decides**, per file or wholesale: commit (accept), amend and commit, or discard
|
|
34
|
+
with `git checkout -- <path>` / re-run the playbook.
|
|
35
|
+
4. **Commit is the creator's action.** Compose a message naming the playbook and families; the
|
|
36
|
+
HUMAN runs the commit unless the application's autonomy mode says otherwise (YOLO modes may
|
|
37
|
+
auto-commit — that mode is the application's declared choice, never this skill's default).
|
|
38
|
+
|
|
39
|
+
## Rules
|
|
40
|
+
|
|
41
|
+
- Never commit on the creator's behalf without an explicit autonomy-mode basis for it.
|
|
42
|
+
- Rejecting the judge's concern and committing anyway is a legitimate outcome — record nothing;
|
|
43
|
+
the commit itself is the decision.
|