@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,261 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: configure-billing
|
|
3
|
+
description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain. Use when the user says "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", "my provider is authored but the backend can't reach it", "provider not reachable on the backend", or "make <provider> work on the backend host". Covers the 6 config surfaces (engine capability activation, backend billing block, backend provider scope, backend contribution, per-env secrets, `wildo config sync` regen), the auto-registered webhook route, and the failure-reason → surface debugging map.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Configure Billing
|
|
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
|
+
Enabling billing looks like a one-line switch (`billing.enabled: true` +
|
|
23
|
+
`providerRef`) but is a **multi-surface config chain**. The billing SDK and
|
|
24
|
+
inbound webhook verification run on the **backend host**, and the backend
|
|
25
|
+
exposes only providers authored under `providers.scopes.backend` and projected
|
|
26
|
+
into its generated provider-runtime artifact. Author the provider in the wrong
|
|
27
|
+
scope (the classic trap: frontend-only) and the ref is silently filtered out —
|
|
28
|
+
the backend crash-loops at startup with `PROVIDER_NOT_REACHABLE_ON_BACKEND`.
|
|
29
|
+
|
|
30
|
+
This skill teaches the billing case end-to-end and doubles as a **debugging
|
|
31
|
+
aid**: the framework classifies every billing-resolution failure into a reason
|
|
32
|
+
that maps 1:1 to the surface you must fix. Surfaces 1 and 3–6 are provider-agnostic —
|
|
33
|
+
the same chain makes any backend-reachable provider resolve.
|
|
34
|
+
|
|
35
|
+
## App Paths
|
|
36
|
+
|
|
37
|
+
| Surface | Glob (relative to app root) |
|
|
38
|
+
|---------|------------------------------|
|
|
39
|
+
| Provider SDK dependency | `./backend-api/package.json` (the provider's SDK npm package, e.g. `stripe`) |
|
|
40
|
+
| Engine capability activation | `./wildo.saas.config.ts` (`engineCapabilities[EngineCapability.BILLING]`) |
|
|
41
|
+
| Backend billing enable | `./backend-api/src/saas-config.backend.ts` (`billing: { enabled, providerRef }`) |
|
|
42
|
+
| Backend provider scope | `./wildo.saas.config.ts` (`providers.scopes.backend.providers.<ref>`) |
|
|
43
|
+
| Backend contribution | `./backend-api/src/provider-contributions.ts` |
|
|
44
|
+
| Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` (`providerEnv`) |
|
|
45
|
+
| Generated artifact (do NOT hand-edit) | `./backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
46
|
+
|
|
47
|
+
## When to Use
|
|
48
|
+
|
|
49
|
+
- Enabling billing / Stripe (subscriptions, checkout, invoicing, metered usage)
|
|
50
|
+
- Diagnosing a backend that crash-loops after `billing.enabled: true`
|
|
51
|
+
- Making any provider that runs server-side (email, LLM, SMS, audit sink)
|
|
52
|
+
reachable on the backend host
|
|
53
|
+
- A provider "works in the frontend" but the backend can't resolve it
|
|
54
|
+
|
|
55
|
+
## When NOT to Use
|
|
56
|
+
|
|
57
|
+
- Pure provider-scope authoring with no billing / backend-reachability angle →
|
|
58
|
+
`config-saas` (owns `providers.scopes` generally)
|
|
59
|
+
- Frontend-only SDK wiring (Checkout.js widget, file picker) → that is the
|
|
60
|
+
`providers.scopes.frontendServices.<app>` surface, a different scope
|
|
61
|
+
- Editing environment topology / backing services → `infra-environment-config`
|
|
62
|
+
- Authoring product tiers / feature entitlements → `engine-product-definitions`
|
|
63
|
+
|
|
64
|
+
## Workflow
|
|
65
|
+
|
|
66
|
+
### Step 1: Classify — new enablement, or a failing startup?
|
|
67
|
+
|
|
68
|
+
- **New**: install the provider SDK (Step 2, prerequisite) + author all six config surfaces below in one pass.
|
|
69
|
+
- **Failing**: read the fatal startup message, note its classified reason, and
|
|
70
|
+
jump straight to the matching surface via
|
|
71
|
+
`references/config-chain-and-failure-map.md` (failure → surface table).
|
|
72
|
+
|
|
73
|
+
### Step 2: Prerequisite — install the provider SDK package
|
|
74
|
+
|
|
75
|
+
The engine ships the provider **adapter**, not the provider's SDK. The adapter
|
|
76
|
+
lazy-loads the SDK at runtime (`createRequire` → `require('stripe')`), so the app
|
|
77
|
+
backend MUST declare it as a dependency. Add the SDK package to
|
|
78
|
+
`./backend-api/package.json` and install it — for the Stripe billing provider:
|
|
79
|
+
|
|
80
|
+
```jsonc
|
|
81
|
+
// ./backend-api/package.json → "dependencies"
|
|
82
|
+
"stripe": "*"
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
This is a **prerequisite, not one of the six config surfaces**: it does NOT
|
|
86
|
+
appear in the classified startup-fatal reasons. If it is missing, the six
|
|
87
|
+
surfaces can all be correct and the backend still fails when the adapter
|
|
88
|
+
instantiates — a `Cannot find module 'stripe'` / require error at billing init,
|
|
89
|
+
NOT a `PROVIDER_*` / `SECRET_MISSING` billing-resolution fatal. Check this first
|
|
90
|
+
whenever billing resolution looks correctly authored but the backend still can't
|
|
91
|
+
construct the provider.
|
|
92
|
+
|
|
93
|
+
### Step 3: Surface 1 — activate the engine capability
|
|
94
|
+
|
|
95
|
+
In `./wildo.saas.config.ts`, set
|
|
96
|
+
`engineCapabilities[EngineCapability.BILLING]: { enabled: true }`. This is the
|
|
97
|
+
framework-wide activation authority used by feature/resource exposure and by
|
|
98
|
+
technical-documentation projection; provider authoring alone must never imply
|
|
99
|
+
that billing is enabled.
|
|
100
|
+
|
|
101
|
+
### Step 4: Surface 2 — turn billing on
|
|
102
|
+
|
|
103
|
+
Edit `./backend-api/src/saas-config.backend.ts`:
|
|
104
|
+
`billing: { enabled: true, providerRef: 'stripe' }`. (`RESOLUTION_ERROR` and
|
|
105
|
+
`PROVIDER_REF_UNSET` originate here.)
|
|
106
|
+
|
|
107
|
+
### Step 5: Surface 3 — author the backend provider scope
|
|
108
|
+
|
|
109
|
+
In `./wildo.saas.config.ts`, add the ref under
|
|
110
|
+
`providers.scopes.backend.providers`. For billing: `providerCapabilities:
|
|
111
|
+
['BILLING']`, `protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR']`,
|
|
112
|
+
`engineCapabilities: [EngineCapability.BILLING]`. This is the trap surface — see the Worked Example.
|
|
113
|
+
Read `references/framework-backend-provider-reachability-api.md` for why this
|
|
114
|
+
scope (not the frontend one) is the one the backend registry reads.
|
|
115
|
+
|
|
116
|
+
### Step 6: Surface 4 — declare the backend contribution
|
|
117
|
+
|
|
118
|
+
In `./backend-api/src/provider-contributions.ts`, project the matching engine
|
|
119
|
+
contribution with `runtimeTargets: [{ kind: 'backend' }]` and the backend
|
|
120
|
+
package's reachable `runtimeImportPath`. The engine contribution remains the
|
|
121
|
+
source of capabilities, protocols, and the values-free secret-contract shape;
|
|
122
|
+
copying those fields into the app creates silent drift. See
|
|
123
|
+
`references/example-provider-contribution-and-backend-config.md`.
|
|
124
|
+
|
|
125
|
+
### Step 7: Surface 5 — populate the secrets
|
|
126
|
+
|
|
127
|
+
In `./infrastructure/<env>/secrets/secrets.json` → `providerEnv`, set the
|
|
128
|
+
env-var-named keys the provider's `secretsContract` declares
|
|
129
|
+
(`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`). Missing → `SECRET_MISSING`.
|
|
130
|
+
See `references/example-backend-provider-module-shape.md` for where these
|
|
131
|
+
names come from.
|
|
132
|
+
|
|
133
|
+
### Step 8: Surface 6 — regenerate + verify webhook
|
|
134
|
+
|
|
135
|
+
Run `wildo config sync` (apps-manager must be up). Confirm `<ref>` appears in
|
|
136
|
+
`providerRefs` of the generated provider-runtime artifact, and that the backend
|
|
137
|
+
boots without a billing-resolution fatal. The webhook route
|
|
138
|
+
`POST /api/v1/webhooks/stripe/billing` is auto-registered from
|
|
139
|
+
`WEBHOOK_ORIGINATOR`; forward local events with `stripe listen --forward-to`.
|
|
140
|
+
|
|
141
|
+
## Worked Example
|
|
142
|
+
|
|
143
|
+
The target application's backend-scope `stripe` entry — the surface most authors miss.
|
|
144
|
+
It carries the whole rationale inline: BILLING runs on the backend, the ref is
|
|
145
|
+
filtered out without a backend-scope entry, the provider fills the canonical
|
|
146
|
+
`EngineCapability.BILLING` slot,
|
|
147
|
+
and `WEBHOOK_ORIGINATOR` is what registers the inbound route:
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
## Usage Example
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
// Billing runs on the BACKEND host: the Stripe SDK (checkout,
|
|
154
|
+
// subscription, invoice, metered-usage) and inbound webhook
|
|
155
|
+
// signature verification both execute here. `billing.providerRef`
|
|
156
|
+
// in `saas-config.backend.ts` selects this provider, but the
|
|
157
|
+
// backend provider registry only exposes refs authored in THIS
|
|
158
|
+
// scope — without a backend-scope entry the ref is filtered out
|
|
159
|
+
// of the active catalog and `resolveBillingProvider` returns null
|
|
160
|
+
// (fatal at startup). The provider also fills the canonical
|
|
161
|
+
// `EngineCapability.BILLING` slot enabled above; keeping the authored
|
|
162
|
+
// selection aligned with discovery prevents the provider from being
|
|
163
|
+
// registered under a capability no runtime selects.
|
|
164
|
+
// WEBHOOK_ORIGINATOR is required so the webhook auto-controller
|
|
165
|
+
// registers POST /api/v1/webhooks/stripe/billing. The separate
|
|
166
|
+
// `frontendServices.app.providers.stripe` entry is the Checkout.js
|
|
167
|
+
// SDK surface — a distinct concern, kept as-is.
|
|
168
|
+
stripe: {
|
|
169
|
+
engineCapabilities: [EngineCapability.BILLING],
|
|
170
|
+
providerCapabilities: ['BILLING'],
|
|
171
|
+
protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR'],
|
|
172
|
+
},
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Note the deliberate contrast the comment draws: the separate
|
|
176
|
+
`frontendServices.app.providers.stripe` entry is the browser Checkout.js SDK —
|
|
177
|
+
authoring only there is exactly the trap that leaves the backend unable to
|
|
178
|
+
resolve the provider.
|
|
179
|
+
|
|
180
|
+
## References
|
|
181
|
+
|
|
182
|
+
- `references/config-chain-and-failure-map.md` — the 6-surface checklist, the failure-reason → surface map, the webhook route, and the generalization to non-billing providers
|
|
183
|
+
- `references/framework-backend-provider-reachability-api.md` — source: the backend registry catalog→artifact filter (why a mis-scoped provider is dropped)
|
|
184
|
+
- `references/framework-billing-resolution-failure-api.md` — source: the 5 classified resolution-failure reasons (the debugging map)
|
|
185
|
+
- `references/example-backend-provider-module-shape.md` — source: the provider module contract (capabilities / secretsContract / protocols) your authoring must match
|
|
186
|
+
- `references/example-provider-contribution-and-backend-config.md` — worked: the backend contribution + the billing enable block
|
|
187
|
+
|
|
188
|
+
## Verification
|
|
189
|
+
|
|
190
|
+
- [ ] Provider SDK package (e.g. `stripe`) declared in `./backend-api/package.json` and installed
|
|
191
|
+
- [ ] `EngineCapability.BILLING` explicitly enabled in `./wildo.saas.config.ts`
|
|
192
|
+
- [ ] Backend billing block present with `enabled` + `providerRef`
|
|
193
|
+
- [ ] Provider ref authored under `providers.scopes.backend.providers` (not only a frontend scope)
|
|
194
|
+
- [ ] Backend contribution declares the ref with `runtimeTargets: [{ kind: 'backend' }]`
|
|
195
|
+
- [ ] Billing scope declares `BILLING_PROVIDER` + `WEBHOOK_ORIGINATOR` protocols
|
|
196
|
+
- [ ] Secret env-var names populated in the per-env `providerEnv`
|
|
197
|
+
- [ ] `wildo config sync` re-run; ref appears in the generated artifact's `providerRefs`; backend boots clean
|
|
198
|
+
|
|
199
|
+
### Grep invariants
|
|
200
|
+
|
|
201
|
+
Run from the app root (substitute `<ref>` / `<env>`):
|
|
202
|
+
|
|
203
|
+
| Invariant | Command |
|
|
204
|
+
|-----------|---------|
|
|
205
|
+
| **Provider SDK installed** (must return a hit) | `rg -n '"stripe"' backend-api/package.json` |
|
|
206
|
+
| Engine capability enabled | `rg -n "EngineCapability.BILLING.*enabled:\s*true" wildo.saas.config.ts` |
|
|
207
|
+
| Billing block declares provider ref | `rg -n "billing:\s*\{" -A3 backend-api/src/saas-config.backend.ts \| rg "providerRef:"` |
|
|
208
|
+
| **Ref authored in BACKEND scope** (must return a hit) | `rg -n "backend:\s*\{" -A80 wildo.saas.config.ts \| rg "<ref>:"` |
|
|
209
|
+
| **Backend contribution exists** (must return a hit) | `rg -n "projectEngineBackendProviderContribution\('<ref>'.*kind:\s*'backend'" backend-api/src/provider-contributions.ts` |
|
|
210
|
+
| Billing scope declares both protocols | `rg -n "'BILLING_PROVIDER'.*'WEBHOOK_ORIGINATOR'\|'WEBHOOK_ORIGINATOR'.*'BILLING_PROVIDER'" wildo.saas.config.ts` |
|
|
211
|
+
| Secrets populated | `rg -n "STRIPE_SECRET_KEY\|STRIPE_WEBHOOK_SECRET" infrastructure/<env>/secrets/secrets.json` |
|
|
212
|
+
| **Ref materialized in the artifact** (must return a hit after sync) | `rg -n "<ref>" backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
213
|
+
| **Frontend-only trap** (a hit HERE with no backend-scope hit above = the bug) | `rg -n "frontendServices:" -A60 wildo.saas.config.ts \| rg "<ref>:"` |
|
|
214
|
+
|
|
215
|
+
The high-signal pair: **"ref authored in BACKEND scope"** returning empty while
|
|
216
|
+
**"frontend-only trap"** returns a hit is the exact billing crash-loop
|
|
217
|
+
signature.
|
|
218
|
+
|
|
219
|
+
## Common Rationalizations
|
|
220
|
+
|
|
221
|
+
| Rationalization | Reality |
|
|
222
|
+
|-----------------|---------|
|
|
223
|
+
| "I set `billing.enabled` + `providerRef` and the secret — that's everything." | That is only surfaces 2 and 5. Without engine activation (1), backend-scope authoring (3), and the backend contribution (4), exposure or provider resolution remains incomplete. |
|
|
224
|
+
| "The engine ships the Stripe integration, so I don't need any npm package." | The engine ships the ADAPTER; it lazy-`require`s the provider's SDK at runtime. You must add the SDK package (`stripe`) to `backend-api/package.json` and install it. Missing SDK fails when the adapter instantiates — a require/module-not-found error, distinct from the classified billing-resolution fatals. |
|
|
225
|
+
| "Stripe is already in `frontendServices` — the backend will find it." | Frontend scope is the browser SDK (Checkout.js), a DIFFERENT scope. The backend host reads only `providers.scopes.backend`. Same ref, two surfaces, two purposes. |
|
|
226
|
+
| "The fatal says secret missing, so I'll rotate the key." | Only if the reason is `SECRET_MISSING`. `PROVIDER_NOT_REACHABLE_ON_BACKEND` looks similar but is a scope/contribution gap — read the classified reason before touching the secret. |
|
|
227
|
+
| "Stripe is engine-shipped, I don't need a contribution entry." | You do. The discovery validator matches your scope authoring against `provider-contributions.ts`; a missing entry makes `wildo config sync` reject the scope authoring and the ref never reaches the artifact. |
|
|
228
|
+
| "I'll edit the generated `wildo-provider-runtime.generated.ts` to add the ref." | Generated artifact — hand edits are overwritten on the next sync and mask the real authoring gap. Fix surfaces 3/4 and re-run `wildo config sync`. |
|
|
229
|
+
|
|
230
|
+
## Red Flags
|
|
231
|
+
|
|
232
|
+
- Provider SDK package missing from `backend-api/package.json` (catch with the
|
|
233
|
+
**Provider SDK installed** grep). Surfaces as a `Cannot find module 'stripe'` /
|
|
234
|
+
require error when the adapter instantiates — NOT a classified `PROVIDER_*` /
|
|
235
|
+
`SECRET_MISSING` billing-resolution fatal. Check this when the six surfaces
|
|
236
|
+
look correct but the backend still can't construct the provider.
|
|
237
|
+
- `billing.providerRef` set but no matching entry under
|
|
238
|
+
`providers.scopes.backend` (catch with the **Ref authored in BACKEND scope**
|
|
239
|
+
grep — must return a hit).
|
|
240
|
+
- Ref under `frontendServices` only, absent from the backend scope (catch with
|
|
241
|
+
the **Frontend-only trap** grep returning a hit while the backend-scope grep
|
|
242
|
+
is empty).
|
|
243
|
+
- Backend-scope entry with no matching `provider-contributions.ts` entry (catch
|
|
244
|
+
with the **Backend contribution exists** grep — must return a hit).
|
|
245
|
+
- Billing scope missing `WEBHOOK_ORIGINATOR` (catch with the **both protocols**
|
|
246
|
+
grep) — webhooks silently never register.
|
|
247
|
+
- Secret env-var names absent from `providerEnv` (catch with the **Secrets
|
|
248
|
+
populated** grep) — `SECRET_MISSING` at startup.
|
|
249
|
+
- Hand-edited generated artifact (catch with the **Ref materialized in the
|
|
250
|
+
artifact** grep AFTER a clean `wildo config sync`, not before).
|
|
251
|
+
|
|
252
|
+
## Related Skills
|
|
253
|
+
|
|
254
|
+
- `config-saas` — owns `providers.scopes` authoring generally; this skill is the
|
|
255
|
+
billing-and-backend-reachability specialization
|
|
256
|
+
- `infra-environment-config` — the per-env infra / secrets file this skill's
|
|
257
|
+
surface 5 lives beside
|
|
258
|
+
- `local-environment-bootstrap` — drives `wildo config sync` and the local stack
|
|
259
|
+
that materializes the authored truth
|
|
260
|
+
- `engine-product-definitions` — billing product tiers / feature entitlements
|
|
261
|
+
(the layer above provider wiring)
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# The backend-provider config chain + failure → fix map
|
|
2
|
+
|
|
3
|
+
Enabling billing — and, generally, making any provider reachable on the
|
|
4
|
+
**backend host** — is a multi-surface change. Getting one surface right and
|
|
5
|
+
the rest wrong fails at startup. This file is the authoritative checklist and
|
|
6
|
+
the debugging aid: match the classified startup reason to the surface, fix it,
|
|
7
|
+
re-sync.
|
|
8
|
+
|
|
9
|
+
## Prerequisite — the provider SDK package (not one of the six surfaces)
|
|
10
|
+
|
|
11
|
+
The engine ships the provider **adapter**, not the provider's SDK. The adapter
|
|
12
|
+
lazy-loads the SDK at runtime (`createRequire` → `require('stripe')`), so the app
|
|
13
|
+
backend MUST declare the SDK npm package in `./backend-api/package.json`
|
|
14
|
+
(`"stripe": "*"` for the Stripe billing provider) and install it. This is a
|
|
15
|
+
**prerequisite, not one of the six config surfaces**, and it does NOT appear in
|
|
16
|
+
the classified startup reasons: if it is missing, all six surfaces can be correct
|
|
17
|
+
and the backend still fails when the adapter instantiates — a `Cannot find module
|
|
18
|
+
'stripe'` / require error at billing init (may surface as `RESOLUTION_ERROR` or a
|
|
19
|
+
raw module-not-found). Check it first whenever billing resolution looks correctly
|
|
20
|
+
authored but the provider still cannot be constructed.
|
|
21
|
+
|
|
22
|
+
## The six surfaces (author all, in one pass)
|
|
23
|
+
|
|
24
|
+
| # | Surface | File | What to author |
|
|
25
|
+
|---|---------|------|----------------|
|
|
26
|
+
| 1 | Engine capability activation | `./wildo.saas.config.ts` → `engineCapabilities` | `[EngineCapability.BILLING]: { enabled: true }` |
|
|
27
|
+
| 2 | Backend billing enable | `./backend-api/src/saas-config.backend.ts` | `billing: { enabled: true, providerRef: 'stripe' }` |
|
|
28
|
+
| 3 | Backend provider scope | `./wildo.saas.config.ts` → `providers.scopes.backend.providers.<ref>` | `providerCapabilities: ['BILLING']`, `protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR']`, `engineCapabilities: [EngineCapability.BILLING]` |
|
|
29
|
+
| 4 | Backend contribution | `./backend-api/src/provider-contributions.ts` | project the canonical engine contribution and author only `runtimeTargets: [{ kind: 'backend' }]` + the reachable runtime import path |
|
|
30
|
+
| 5 | Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` → `providerEnv` | env-var-named keys `STRIPE_SECRET_KEY` + `STRIPE_WEBHOOK_SECRET` (emitted verbatim into the backend env) |
|
|
31
|
+
| 6 | Regenerate | run `wildo config sync` | regenerates the provider-runtime artifact (its `providerRefs` must now list `<ref>`) + `.env` files |
|
|
32
|
+
|
|
33
|
+
Surface 2 is the **classic trap**: authoring the provider only in a frontend
|
|
34
|
+
scope (`providers.scopes.frontendServices.<app>`) looks done, but that surface
|
|
35
|
+
is the browser SDK (e.g. Stripe Checkout.js) — a DIFFERENT scope from the
|
|
36
|
+
backend host that runs the billing SDK and verifies inbound webhooks. The
|
|
37
|
+
backend registry only exposes refs authored under `providers.scopes.backend`.
|
|
38
|
+
|
|
39
|
+
> Billing note: the provider fills `EngineCapability.BILLING`, the same slot the
|
|
40
|
+
> application enables. Runtime billing-provider choice still comes from
|
|
41
|
+
> `billing.providerRef` (surface 2), so billing does not need a provider
|
|
42
|
+
> `selection` primary/fallbacks entry. Capability activation and provider choice
|
|
43
|
+
> are distinct axes; both must agree on the canonical billing slot.
|
|
44
|
+
|
|
45
|
+
## Failure reason → surface
|
|
46
|
+
|
|
47
|
+
The fatal startup message names one classified reason (see
|
|
48
|
+
`framework-billing-resolution-failure-api.md`). Map it straight to a surface:
|
|
49
|
+
|
|
50
|
+
| Classified reason | Fix at surface |
|
|
51
|
+
|-------------------|----------------|
|
|
52
|
+
| `PROVIDER_REF_UNSET` | **2** — set `billing.providerRef` |
|
|
53
|
+
| `PROVIDER_NOT_REACHABLE_ON_BACKEND` | **3 + 4** — author under `providers.scopes.backend` AND add the backend contribution, then re-sync (**6**) |
|
|
54
|
+
| `PROVIDER_DISABLED` | external-provider config — the ref resolves but is disabled for the `BILLING` protocol in this environment; enable it, then re-sync |
|
|
55
|
+
| `SECRET_MISSING` | **5** — populate the env var named by the provider's `secretRef` in `providerEnv`, then re-sync |
|
|
56
|
+
| `RESOLUTION_ERROR` | the provider threw while resolving (registry / billing-SDK fault) — inspect the SDK wiring; not an authoring gap. **Common cause: the provider SDK package is not installed** (see Prerequisite above) |
|
|
57
|
+
|
|
58
|
+
## Webhooks
|
|
59
|
+
|
|
60
|
+
Declaring `WEBHOOK_ORIGINATOR` (surfaces 3 + 4) makes the webhook
|
|
61
|
+
auto-controller register an inbound route from the provider's declared
|
|
62
|
+
endpoints. For billing that is:
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
POST /api/v1/webhooks/{providerRef}/{endpoint.key} → POST /api/v1/webhooks/stripe/billing
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Signature verification uses the `STRIPE_WEBHOOK_SECRET` secret (surface 5).
|
|
69
|
+
For local dev, forward Stripe events to the running backend:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
stripe listen --forward-to localhost:<backend-port>/api/v1/webhooks/stripe/billing
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Generalizing beyond billing
|
|
76
|
+
|
|
77
|
+
Surfaces 1 and 3 → 6 are provider-agnostic: they are how ANY backend-reachable
|
|
78
|
+
provider (transactional email, server-side LLM, SMS, audit sink) is made
|
|
79
|
+
resolvable on the backend host. Only surface 2 and the webhook route are
|
|
80
|
+
billing-specific. Billing fills `EngineCapability.BILLING` but is selected by
|
|
81
|
+
its dedicated `billing.providerRef`; email/LLM providers use the generic
|
|
82
|
+
`selection` primary/fallbacks map. SSO currently has no mapped engine slot.
|
|
83
|
+
|
|
84
|
+
## App-backend env prep
|
|
85
|
+
|
|
86
|
+
`wildo config sync` writes the backend `.env` from the materialized artifact +
|
|
87
|
+
`providerEnv`. That regeneration needs the platform apps-manager running (it
|
|
88
|
+
provisions the app-backend env). If the ref is present in the artifact but the
|
|
89
|
+
backend still can't reach it, re-run `wildo config sync` and confirm the
|
|
90
|
+
apps-manager is up.
|
package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Backend provider module shape (Stripe, engine-owned)
|
|
2
|
+
|
|
3
|
+
Read this to see the contract your authoring must line up with. You do **not**
|
|
4
|
+
write this file — engine-shipped providers already declare it — but every
|
|
5
|
+
backend-scope entry in `./wildo.saas.config.ts` and every backend
|
|
6
|
+
`provider-contributions.ts` entry must agree with the module's `ref`,
|
|
7
|
+
`providerCapabilities`, `protocols`, and `secretsContract`. In particular:
|
|
8
|
+
|
|
9
|
+
- `secretsContract.*.envVarName` are the **exact** keys you populate in the
|
|
10
|
+
per-env `providerEnv` secrets (`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`).
|
|
11
|
+
- `protocols` lists what you must mirror in your authoring. Billing needs both
|
|
12
|
+
`BILLING_PROVIDER` (the SDK surface) and `WEBHOOK_ORIGINATOR` (which makes the
|
|
13
|
+
webhook auto-controller register the inbound route from `endpoints`).
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
## Usage Example
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
/**
|
|
20
|
+
* Shape of a backend provider module (illustrated by the engine's built-in
|
|
21
|
+
* Stripe billing provider). App authors do NOT write this — engine-shipped
|
|
22
|
+
* providers already declare it — but it is the contract every backend-scope
|
|
23
|
+
* provider authoring in `./wildo.saas.config.ts` and every backend
|
|
24
|
+
* `provider-contributions.ts` entry must line up with:
|
|
25
|
+
*
|
|
26
|
+
* - `metadata.ref` — the provider ref you reference everywhere (`'stripe'`).
|
|
27
|
+
* - `providerCapabilities` — the built-in capabilities the provider fills
|
|
28
|
+
* (billing → `BILLING`). Mirror these in your authored `providerCapabilities`.
|
|
29
|
+
* - `secretsContract` — each secret's `envVarName` is the EXACT key you must
|
|
30
|
+
* populate in the per-env `providerEnv` secrets (`STRIPE_SECRET_KEY`,
|
|
31
|
+
* `STRIPE_WEBHOOK_SECRET`); the CLI emits them verbatim into the backend env.
|
|
32
|
+
* - `protocols` — the exchange protocols you list in your authoring. Billing
|
|
33
|
+
* needs `BILLING_PROVIDER` (the SDK surface) AND `WEBHOOK_ORIGINATOR` (which
|
|
34
|
+
* makes the webhook auto-controller register
|
|
35
|
+
* `POST /api/v1/webhooks/stripe/billing` from the declared `endpoints`).
|
|
36
|
+
*/
|
|
37
|
+
export const StripeBackendProvider: BackendProviderModule = {
|
|
38
|
+
metadata: {
|
|
39
|
+
ref: "stripe",
|
|
40
|
+
displayNameLabelKey: buildProviderDisplayNameLabelKey('stripe'),
|
|
41
|
+
},
|
|
42
|
+
// WHO can run this, and where its vendor processes — read by the compliance-document lane to
|
|
43
|
+
// decide whether this provider is a third-party recipient at all (issue #130).
|
|
44
|
+
complianceProfile: {
|
|
45
|
+
deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
|
|
46
|
+
processingRegions: ['us-east-1', 'eu-west-1'],
|
|
47
|
+
vendorLegalEntityName: 'Stripe, Inc.',
|
|
48
|
+
},
|
|
49
|
+
providerCapabilities: [
|
|
50
|
+
BUILTIN_PROVIDER_CAPABILITY.BILLING,
|
|
51
|
+
],
|
|
52
|
+
secretsContract: {
|
|
53
|
+
secretKey: {
|
|
54
|
+
envVarName: "STRIPE_SECRET_KEY",
|
|
55
|
+
required: true,
|
|
56
|
+
description: "Stripe secret key for Billing API calls."
|
|
57
|
+
},
|
|
58
|
+
webhookSecret: {
|
|
59
|
+
envVarName: "STRIPE_WEBHOOK_SECRET",
|
|
60
|
+
required: true,
|
|
61
|
+
description: "Stripe webhook signing secret for Billing event verification."
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
protocols: [
|
|
65
|
+
{
|
|
66
|
+
protocol: "BILLING_PROVIDER",
|
|
67
|
+
designTimeExposed: false,
|
|
68
|
+
runtimeContract: {
|
|
69
|
+
kind: "billing",
|
|
70
|
+
secretRef: "STRIPE_SECRET_KEY",
|
|
71
|
+
sdkPackage: "stripe",
|
|
72
|
+
apiVersion: "2026-01-28.clover",
|
|
73
|
+
operations: [
|
|
74
|
+
"checkout",
|
|
75
|
+
"customer",
|
|
76
|
+
"subscription",
|
|
77
|
+
"invoice",
|
|
78
|
+
"paymentIntent",
|
|
79
|
+
"meteredUsage"
|
|
80
|
+
]
|
|
81
|
+
},
|
|
82
|
+
parameterSchema: z.unknown()
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
protocol: "WEBHOOK_ORIGINATOR",
|
|
86
|
+
designTimeExposed: false,
|
|
87
|
+
runtimeContract: {
|
|
88
|
+
kind: "webhook-originator",
|
|
89
|
+
secretRef: "STRIPE_WEBHOOK_SECRET",
|
|
90
|
+
signatureHeaderName: "stripe-signature",
|
|
91
|
+
endpoints: [
|
|
92
|
+
{
|
|
93
|
+
key: 'billing',
|
|
94
|
+
capability: 'billing',
|
|
95
|
+
signatureConfig: {
|
|
96
|
+
algorithm: Hook_SignatureAlgorithm.HMAC_SHA256,
|
|
97
|
+
},
|
|
98
|
+
triggerStrategy: Hook_TriggerStrategy.WEBHOOK,
|
|
99
|
+
eventTypes: [...STRIPE_BILLING_EVENT_TYPES],
|
|
100
|
+
scopeBinding: {
|
|
101
|
+
mode: 'polymorphic',
|
|
102
|
+
payloadScopeIdPath: 'data.object.customer',
|
|
103
|
+
/**
|
|
104
|
+
* Field on each variant resource (`organizationBillingAccounts`
|
|
105
|
+
* / `userBillingAccounts`) to match against the extracted
|
|
106
|
+
* `data.object.customer` Stripe customer ID. Required by
|
|
107
|
+
* `Hook_EndpointScopeBinding` (polymorphic mode);
|
|
108
|
+
* `webhook-handler.resolvePolymorphicScope` reads it. Without
|
|
109
|
+
* this field, scope resolution would silently degrade to
|
|
110
|
+
* APPLICATION scope.
|
|
111
|
+
*/
|
|
112
|
+
lookupField: 'providerCustomerId',
|
|
113
|
+
variants: STRIPE_BILLING_ACCOUNT_WEBHOOK_VARIANTS,
|
|
114
|
+
},
|
|
115
|
+
},
|
|
116
|
+
],
|
|
117
|
+
},
|
|
118
|
+
parameterSchema: z.unknown()
|
|
119
|
+
}
|
|
120
|
+
],
|
|
121
|
+
};
|
|
122
|
+
```
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Backend contribution + billing enable block (worked examples)
|
|
2
|
+
|
|
3
|
+
Two of the six config surfaces, shown as a portable target-application example.
|
|
4
|
+
|
|
5
|
+
## Surface 4 — backend `provider-contributions.ts`
|
|
6
|
+
|
|
7
|
+
The backend package projects each engine-shipped provider it reaches from the
|
|
8
|
+
canonical engine companion contribution, then overrides only application
|
|
9
|
+
topology (`runtimeTargets`) and the package import gateway. The discovery
|
|
10
|
+
validator matches `providers.scopes.backend` against that projection; without a
|
|
11
|
+
matching backend target, `wildo config sync` rejects the scope authoring. Do not
|
|
12
|
+
copy capabilities, protocols, or secret-contract metadata into the app.
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
## Usage Example
|
|
16
|
+
|
|
17
|
+
```typescript
|
|
18
|
+
// Stripe fills the canonical EngineCapability.BILLING slot and supplies the
|
|
19
|
+
// BILLING_PROVIDER + WEBHOOK_ORIGINATOR protocols. Only its application
|
|
20
|
+
// runtime target and import gateway are authored here; semantic provider
|
|
21
|
+
// metadata is projected from the engine registry.
|
|
22
|
+
projectEngineBackendProviderContribution('stripe', [{ kind: 'backend' }]),
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Surface 2 — `billing` enable block in `saas-config.backend.ts`
|
|
26
|
+
|
|
27
|
+
The backend app config turns billing on and names the provider ref. This is
|
|
28
|
+
the entry point the runtime reads; everything else exists to make that ref
|
|
29
|
+
resolvable on the backend host.
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
## Usage Example
|
|
33
|
+
|
|
34
|
+
```typescript
|
|
35
|
+
billing: {
|
|
36
|
+
// Enabled for local dev against a test-mode Stripe connector.
|
|
37
|
+
// Requires a resolvable provider — the framework ships only a Stripe
|
|
38
|
+
// adapter — so `providerRef: 'stripe'` must be paired with the
|
|
39
|
+
// `STRIPE_SECRET_KEY` (billing API) and `STRIPE_WEBHOOK_SECRET`
|
|
40
|
+
// (webhook signature verification) secrets in the per-env
|
|
41
|
+
// `providerEnv` map (see `infrastructure/local/secrets/secrets.json`).
|
|
42
|
+
// With `enabled: true` and no resolvable provider, startup fails loud
|
|
43
|
+
// (see `StartApplicationBackendService.initializeBillingServices`).
|
|
44
|
+
// To disable: set `enabled: false` (providerRef then becomes inert).
|
|
45
|
+
enabled: true,
|
|
46
|
+
providerRef: 'stripe',
|
|
47
|
+
},
|
|
48
|
+
```
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Backend provider reachability — the runtime filter
|
|
2
|
+
|
|
3
|
+
Read this to understand **why a provider you authored is not reachable on the
|
|
4
|
+
backend host**. This is the seam that decides which providers a backend
|
|
5
|
+
process can resolve at runtime: the composed catalog (engine-shipped +
|
|
6
|
+
app-contributed) is filtered down to the refs the generated provider-runtime
|
|
7
|
+
artifact declares for this host, and that artifact is projected from the
|
|
8
|
+
`providers.scopes.backend` authoring plus the backend `provider-contributions`.
|
|
9
|
+
|
|
10
|
+
A provider authored only in a **non-backend** scope (e.g.
|
|
11
|
+
`providers.scopes.frontendServices.<app>`) never enters this registry. Any
|
|
12
|
+
backend feature keyed on it — billing, transactional email, server-side LLM
|
|
13
|
+
calls — then resolves nothing and fails at startup. This is the exact
|
|
14
|
+
mechanism behind the billing crash-loop: Stripe authored only in the frontend
|
|
15
|
+
scope was filtered out here.
|
|
16
|
+
|
|
17
|
+
## Import Origins
|
|
18
|
+
|
|
19
|
+
- `@wildo-ai/saas-backend-lib`
|
|
20
|
+
|
|
21
|
+
## Source Excerpts
|
|
22
|
+
|
|
23
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
/**
|
|
27
|
+
* Initialize the backend provider registry that all downstream services
|
|
28
|
+
* (auth, billing, notifications, …) will resolve through.
|
|
29
|
+
*
|
|
30
|
+
* This is the seam that decides which providers a backend host can actually
|
|
31
|
+
* reach at runtime. A provider authored only in a NON-backend scope (e.g.
|
|
32
|
+
* `providers.scopes.frontendServices.<app>`) never enters this registry, so
|
|
33
|
+
* any backend feature keyed on it (billing, transactional email, server-side
|
|
34
|
+
* LLM calls) resolves nothing and fails at startup. Author the provider under
|
|
35
|
+
* `providers.scopes.backend` in `./wildo.saas.config.ts` AND declare a
|
|
36
|
+
* matching backend contribution (`runtimeTargets: [{ kind: 'backend' }]`) so
|
|
37
|
+
* `wildo config sync` lists its ref in the generated provider-runtime
|
|
38
|
+
* artifact — otherwise it is filtered out here.
|
|
39
|
+
*
|
|
40
|
+
* Composition model:
|
|
41
|
+
*
|
|
42
|
+
* 1. The **catalog** is the union of engine-shipped providers
|
|
43
|
+
* (`EngineBackendProviderRegistry`) and any application-contributed
|
|
44
|
+
* providers (passed in via `registry`). This is what is *available*.
|
|
45
|
+
* 2. The **runtime artifact** (`providerRuntime`, generated by
|
|
46
|
+
* `wildo config sync` and imported by the application bootstrap)
|
|
47
|
+
* declares which providers this specific backend process is *allowed*
|
|
48
|
+
* to expose, scoped by the authored `providers.scopes.backend`.
|
|
49
|
+
* 3. The active registry is the catalog filtered to the artifact's
|
|
50
|
+
* `providerRefs`. Any ref claimed by the artifact but missing from the
|
|
51
|
+
* catalog is a deployment-time error and fails startup loudly — there
|
|
52
|
+
* is no silent fallback to the unfiltered catalog.
|
|
53
|
+
*
|
|
54
|
+
* When `providerRuntime` is `undefined`, no filtering is applied and the
|
|
55
|
+
* full catalog is exposed (legacy / pre-materialization callers, and
|
|
56
|
+
* platform applications that initialize their config later).
|
|
57
|
+
*/
|
|
58
|
+
initialize(
|
|
59
|
+
registry: BackendProviderRegistry = EngineBackendProviderRegistry,
|
|
60
|
+
providerRuntime?: ProviderRuntimeArtifact,
|
|
61
|
+
): void {
|
|
62
|
+
if (!providerRuntime) {
|
|
63
|
+
this.registry = registry;
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
this.registry = filterRegistryByProviderRuntime(registry, providerRuntime);
|
|
68
|
+
}
|
|
69
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Billing resolution failure reasons — the debugging map
|
|
2
|
+
|
|
3
|
+
Read this when `billing.enabled: true` crash-loops the backend at startup. The
|
|
4
|
+
framework classifies **why** the billing provider could not resolve into five
|
|
5
|
+
distinct reasons, and each reason names the ONE config surface to fix. The
|
|
6
|
+
fatal startup message is built from this enum, so it points you at the right
|
|
7
|
+
file instead of the historical catch-all ("set providerRef + its secret") that
|
|
8
|
+
misdirected authors to the secret when the real gap was backend-scope
|
|
9
|
+
authoring.
|
|
10
|
+
|
|
11
|
+
Use it as a lookup: read the reason in the startup error, then jump to the
|
|
12
|
+
matching surface. The full surface-by-surface fix is in
|
|
13
|
+
`config-chain-and-failure-map.md`.
|
|
14
|
+
|
|
15
|
+
## Import Origins
|
|
16
|
+
|
|
17
|
+
- `@wildo-ai/saas-backend-lib`
|
|
18
|
+
|
|
19
|
+
## Source Excerpts
|
|
20
|
+
|
|
21
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
/**
|
|
25
|
+
* Why billing-provider resolution failed at startup. Each reason maps 1:1 to a
|
|
26
|
+
* DISTINCT config surface an app author must fix, so `billing.enabled: true`
|
|
27
|
+
* that cannot resolve a provider fails LOUD with an actionable message instead
|
|
28
|
+
* of the historical catch-all ("set providerRef + its secret") that misdirected
|
|
29
|
+
* authors to the secret when the real gap was backend-scope authoring.
|
|
30
|
+
*
|
|
31
|
+
* Read this as a debugging map — the fatal startup message names the surface,
|
|
32
|
+
* and each reason below is the surface:
|
|
33
|
+
* - PROVIDER_REF_UNSET → `billing.providerRef` in `./backend-api/src/saas-config.backend.ts`
|
|
34
|
+
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts` + a matching backend contribution in `./backend-api/src/provider-contributions.ts` (the classic trap: authored only in a frontend scope), then `wildo config sync`
|
|
35
|
+
* - PROVIDER_DISABLED → the ref resolves but is disabled for the BILLING protocol in external-provider config
|
|
36
|
+
* - SECRET_MISSING → the env var named by the provider's `secretRef` is absent from the per-env `providerEnv` secrets
|
|
37
|
+
* - RESOLUTION_ERROR → the provider threw while resolving (registry / billing-SDK fault)
|
|
38
|
+
*/
|
|
39
|
+
enum BillingProviderResolutionFailureReason {
|
|
40
|
+
/** `billing.enabled` is true but `billing.providerRef` is unset. */
|
|
41
|
+
PROVIDER_REF_UNSET = 'provider-ref-unset',
|
|
42
|
+
/**
|
|
43
|
+
* `providerRef` is set, but no billing runtime contract is exposed to the
|
|
44
|
+
* backend registry for it — the provider is not authored in
|
|
45
|
+
* `providers.scopes.backend` (a common trap: it is authored only in a
|
|
46
|
+
* frontend scope) and/or has no matching backend runtime-owner
|
|
47
|
+
* contribution. The provider is filtered out of the active catalog.
|
|
48
|
+
*/
|
|
49
|
+
PROVIDER_NOT_REACHABLE_ON_BACKEND = 'provider-not-reachable-on-backend',
|
|
50
|
+
/** The provider resolves but is disabled by external-provider configuration. */
|
|
51
|
+
PROVIDER_DISABLED = 'provider-disabled',
|
|
52
|
+
/** The provider resolves but its secret (env var `secretRef`) is absent. */
|
|
53
|
+
SECRET_MISSING = 'secret-missing',
|
|
54
|
+
/** An unexpected error was thrown while resolving (registry/SDK fault). */
|
|
55
|
+
RESOLUTION_ERROR = 'resolution-error',
|
|
56
|
+
}
|
|
57
|
+
```
|