@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,374 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: backend-custom-operation
|
|
3
|
+
description: Author or modify backend resource operation files (`<resource>.<operation>.<variant>.operation.ts`) — the typed `ResourceCustomServiceImplementationFactory` shape that wires custom create/update/delete pipelines, prefix/replace/postfix/terminal hooks, and side effects on resource operations. Use when the user says "add a postfix hook to create todos", "wire a custom update pipeline", "add a side effect on delete", "the postfix hook isn't running", "validate input beyond Zod for this operation", or any change that authors / modifies a backend operation handler beyond generic CRUD.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Backend Custom Operation
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for **backend custom resource operations** — the
|
|
23
|
+
typed `ResourceCustomServiceImplementationFactory` modules that
|
|
24
|
+
augment generic CRUD with prefix / postfix / on-success / on-error
|
|
25
|
+
hooks. Custom operations are auto-scanned from
|
|
26
|
+
`backend-api/src/modules/<slug>/resources/**/*.operation.ts` by
|
|
27
|
+
`scanDefaultExports` and registered through the
|
|
28
|
+
`BackendDomainModule.operations` slot (`backend-addon-wiring`).
|
|
29
|
+
|
|
30
|
+
A custom operation file is the spot where:
|
|
31
|
+
|
|
32
|
+
1. **Custom validation** beyond Zod runs (cross-field constraints,
|
|
33
|
+
tenant-aware rules, async validation against external systems)
|
|
34
|
+
2. **Side effects** fire on commit (notifications, workflow
|
|
35
|
+
triggers, downstream replication, audit log)
|
|
36
|
+
3. **Pipeline composition** layers custom logic on top of the
|
|
37
|
+
framework's generic CRUD path through lifecycle hooks
|
|
38
|
+
4. **Cross-resource orchestration** runs in a transactional context
|
|
39
|
+
|
|
40
|
+
The framework's generic CRUD remains the default; the custom
|
|
41
|
+
operation file **augments** it via hooks rather than replacing it.
|
|
42
|
+
|
|
43
|
+
## App Paths
|
|
44
|
+
|
|
45
|
+
| Surface | Glob (relative to app root) |
|
|
46
|
+
|--------------------------------------|----------------------------------------------------------------------------------------------|
|
|
47
|
+
| Operation file | `backend-api/src/modules/<slug>/resources/<resource>/<resource>.<operation>.<variant>.operation.ts` |
|
|
48
|
+
| Operation auto-scanner | `backend-api/src/modules/<slug>/resources/index.ts` (`scanDefaultExports`) |
|
|
49
|
+
| Operation path types | `@wildo-ai/saas-models` (`CoreResourceOperation`, `ResourceOperationVariantType`) |
|
|
50
|
+
| Custom impl factory + helpers | `@wildo-ai/saas-backend-lib` (`createResourceCustomServiceImplementation`, `ResourcesRegistryBackendService`) |
|
|
51
|
+
| Resource configuration (parity) | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.resource-configurations.ts` |
|
|
52
|
+
| Repository service | injected via `utils.<resourceRepositoryService>` inside handlers |
|
|
53
|
+
|
|
54
|
+
## When to Use
|
|
55
|
+
|
|
56
|
+
- Custom create / update / delete pipelines that need lifecycle hooks
|
|
57
|
+
- Side effects (notifications, workflows, downstream replication)
|
|
58
|
+
on commit
|
|
59
|
+
- Validation that cannot live in Zod alone (cross-field,
|
|
60
|
+
tenant-aware, async)
|
|
61
|
+
- Cross-resource orchestration that must be transactional
|
|
62
|
+
|
|
63
|
+
## When NOT to Use
|
|
64
|
+
|
|
65
|
+
- Pure schema constraint expressible in Zod →
|
|
66
|
+
`resource-schema-authoring`
|
|
67
|
+
- Frontend-only behavior change → frontend skills
|
|
68
|
+
- Module-level service / controller wiring → `backend-addon-wiring`
|
|
69
|
+
- Resource operation declaration / DTO shape → `resource-config-wiring`
|
|
70
|
+
|
|
71
|
+
## Workflow
|
|
72
|
+
|
|
73
|
+
### Step 1: Mirror a sibling operation file
|
|
74
|
+
|
|
75
|
+
Find the closest sibling `<resource>.<operation>.<variant>.operation.ts`
|
|
76
|
+
and copy its `ResourceCustomServiceImplementationFactory` shape.
|
|
77
|
+
Naming convention: `<resource>.<operation>.<variant>.operation.ts`
|
|
78
|
+
(e.g. `todos.create.default.operation.ts`,
|
|
79
|
+
`todos.update.default.operation.ts`).
|
|
80
|
+
|
|
81
|
+
### Step 2: Wire the typed `operationPath`
|
|
82
|
+
|
|
83
|
+
`operationPath` is a typed object with three required fields:
|
|
84
|
+
|
|
85
|
+
- `resourceIdentifier: <ModuleResourceType>.<ENUM_MEMBER>` (typed
|
|
86
|
+
enum reference)
|
|
87
|
+
- `operationIdentifier: CoreResourceOperation.*` (typed enum:
|
|
88
|
+
`CREATE`, `UPDATE`, `DELETE`, etc.)
|
|
89
|
+
- `variantType: ResourceOperationVariantType.*` (typed enum:
|
|
90
|
+
`API_CALL`, etc.)
|
|
91
|
+
|
|
92
|
+
Never hand-build `operationPath` with string literals — the typed
|
|
93
|
+
shape is the only durable wiring.
|
|
94
|
+
|
|
95
|
+
### Step 3: Resolve DTO schemas from the registry
|
|
96
|
+
|
|
97
|
+
```ts
|
|
98
|
+
const requestDtoSchema = resourcesRegistryService.getRequestDtoFromPath(operationPath);
|
|
99
|
+
const responseDtoSchema = resourcesRegistryService.getResponseDtoFromPath(operationPath);
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
The registry-backed DTO lookup is the truth contract; it ensures
|
|
103
|
+
the operation's typed input / output match the resource
|
|
104
|
+
configuration declared in `resource-config-wiring`. **Never
|
|
105
|
+
hand-build DTO schemas in the operation file** — that produces
|
|
106
|
+
silent drift the moment the resource config changes.
|
|
107
|
+
|
|
108
|
+
### Step 4: Compose the implementation with `createResourceCustomServiceImplementation`
|
|
109
|
+
|
|
110
|
+
<!-- TIER C WAIVER: Step 4 is named after this exact factory call; the snippet shows the four-handler choreography the step teaches and the post-fence prose explains why the typed generics earn the verbosity. Promote to Tier A `example.backend.custom-operation.factory-call` once a stable application custom-operation fixture exists. -->
|
|
111
|
+
```ts
|
|
112
|
+
return createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({
|
|
113
|
+
operationPath,
|
|
114
|
+
requestDtoSchema,
|
|
115
|
+
responseDtoSchema,
|
|
116
|
+
handlers: {
|
|
117
|
+
prefixCoreOperations: async (id, input, executionContext, operationPath, utils) => { ... },
|
|
118
|
+
postfixCoreOperations: async (id, input, executionContext, operationPath, utils) => { ... },
|
|
119
|
+
},
|
|
120
|
+
});
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
The typed factory accepts `<typeof requestDtoSchema, typeof responseDtoSchema>`
|
|
124
|
+
generics so handler `input` and `output` parameters are correctly
|
|
125
|
+
typed without manual annotation.
|
|
126
|
+
|
|
127
|
+
Keep the default non-transactional mode when hooks do not form one atomic
|
|
128
|
+
business invariant with core persistence. When they do, add
|
|
129
|
+
`transactionalCore: true` and an explicit `transactionParticipants` map naming
|
|
130
|
+
every additional resource the atomic phases access. The operation resource is
|
|
131
|
+
included automatically; `{}` is valid only for a genuinely single-resource
|
|
132
|
+
transaction. Every nested resource call inside the boundary must also forward
|
|
133
|
+
`utils.serviceOptions`. Startup validates adapter compatibility for the
|
|
134
|
+
declared participants; the framework cannot discover an omitted call or make a
|
|
135
|
+
call that drops `serviceOptions` join the transaction. Read
|
|
136
|
+
`references/framework-transactional-core-api.md` for the exact discriminated
|
|
137
|
+
contract and incompatible terminal modes. If a concurrent uniqueness race can
|
|
138
|
+
produce an equivalent committed winner, author
|
|
139
|
+
`transactionalCoreConflictResolver` with one explicit outcome:
|
|
140
|
+
`RECONCILED` returns that winner, `RETRY_TRANSACTION` spends the framework's
|
|
141
|
+
single bounded full-boundary retry, and `UNHANDLED` preserves the original
|
|
142
|
+
conflict. An absent result never implicitly means “retry.”
|
|
143
|
+
|
|
144
|
+
### Step 5: Implement only the handlers you need
|
|
145
|
+
|
|
146
|
+
Each handler is optional. Common patterns:
|
|
147
|
+
|
|
148
|
+
- **`prefixCoreOperations`** — input validation / mutation before
|
|
149
|
+
CRUD runs (must return the (possibly mutated) input)
|
|
150
|
+
- **`replaceCoreOperations`** — replace the core CRUD result after the
|
|
151
|
+
core operation has run (single-owner mode)
|
|
152
|
+
- **`postfixCoreOperations`** — transform the core/REPLACE result; it
|
|
153
|
+
remains inside `transactionalCore` when that mode is enabled
|
|
154
|
+
- **`afterUserNotifications`** / **`atTheEnd`** — synchronous,
|
|
155
|
+
request-scoped result transforms. With a framework-owned
|
|
156
|
+
`transactionalCore`, they run after root commit and post-commit effects and
|
|
157
|
+
receive the committed callback-attempt context without a completed
|
|
158
|
+
transaction in `utils.serviceOptions`. They cannot run when the operation
|
|
159
|
+
reuses a caller-owned transaction, because the nested result must return
|
|
160
|
+
before that caller can commit. A terminal-hook failure after a framework
|
|
161
|
+
commit rejects the response but cannot roll the mutation back; mutation-owned
|
|
162
|
+
external work belongs in the durable post-commit mechanism instead.
|
|
163
|
+
|
|
164
|
+
Use `utils.logger` for logs; never `console.log`. Throw typed
|
|
165
|
+
backend errors and catch them with `isWildoBackendError(error)`.
|
|
166
|
+
|
|
167
|
+
### Step 6: Verify
|
|
168
|
+
|
|
169
|
+
- Operation auto-scanner picks up the file (file matches `*.operation.ts`
|
|
170
|
+
suffix)
|
|
171
|
+
- API call to the matching path triggers the operation
|
|
172
|
+
- Logs show the handler executing
|
|
173
|
+
- Errors are typed backend errors, not raw `Error` instances
|
|
174
|
+
|
|
175
|
+
## Worked Example
|
|
176
|
+
|
|
177
|
+
An application-owned `create-default` implementation illustrates the canonical
|
|
178
|
+
custom operation factory — typed `operationPath`, registry-backed
|
|
179
|
+
DTO resolution, `postfixCoreOperations` lifecycle hook:
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
## Usage Example
|
|
183
|
+
|
|
184
|
+
```typescript
|
|
185
|
+
const todosCreateDefaultCustomImpl: ResourceCustomServiceImplementationFactory = (resourcesRegistryService : ResourcesRegistryBackendService ) => {
|
|
186
|
+
|
|
187
|
+
const operationPath = {
|
|
188
|
+
resourceIdentifier: TasksManager_ResourceType.TODOS,
|
|
189
|
+
operationIdentifier: CoreResourceOperation.CREATE,
|
|
190
|
+
variantType: ResourceOperationVariantType.API_CALL
|
|
191
|
+
};
|
|
192
|
+
|
|
193
|
+
const requestDtoSchema = resourcesRegistryService.getRequestDtoFromPath(operationPath);
|
|
194
|
+
const responseDtoSchema = resourcesRegistryService.getResponseDtoFromPath(operationPath);
|
|
195
|
+
|
|
196
|
+
|
|
197
|
+
return createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({
|
|
198
|
+
operationPath,
|
|
199
|
+
requestDtoSchema,
|
|
200
|
+
responseDtoSchema,
|
|
201
|
+
handlers : {
|
|
202
|
+
postfixCoreOperations: async (_id, input, executionContext, operationPath, utils) => {
|
|
203
|
+
utils.logger.debug('TodosCreatePostfix.postfixCoreOperations executed');
|
|
204
|
+
const temp = input;
|
|
205
|
+
|
|
206
|
+
return input;
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
});
|
|
210
|
+
};
|
|
211
|
+
|
|
212
|
+
export default todosCreateDefaultCustomImpl;
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
What earns its place:
|
|
216
|
+
|
|
217
|
+
- `ResourceCustomServiceImplementationFactory` typed signature —
|
|
218
|
+
the factory takes `(resourcesRegistryService:
|
|
219
|
+
ResourcesRegistryBackendService) => ...` and returns the typed
|
|
220
|
+
custom impl. The framework injects the registry; you never
|
|
221
|
+
instantiate it yourself.
|
|
222
|
+
- `const operationPath = { resourceIdentifier:
|
|
223
|
+
TasksManager_ResourceType.TODOS, operationIdentifier:
|
|
224
|
+
CoreResourceOperation.CREATE, variantType:
|
|
225
|
+
ResourceOperationVariantType.API_CALL }` — **fully typed
|
|
226
|
+
`operationPath`** with three enum references. No string
|
|
227
|
+
literals; every member resolves through a typed enum so
|
|
228
|
+
rename safety is enforced at compile time.
|
|
229
|
+
- `resourcesRegistryService.getRequestDtoFromPath(operationPath)`
|
|
230
|
+
+ `getResponseDtoFromPath(operationPath)` — **registry-backed
|
|
231
|
+
DTO resolution**. The DTO schemas come from the resource
|
|
232
|
+
configuration (`resource-config-wiring`); the operation file
|
|
233
|
+
never hand-builds them. This is the only mechanism that keeps
|
|
234
|
+
the operation's typed input / output aligned with the resource
|
|
235
|
+
config as it evolves.
|
|
236
|
+
- `createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({...})`
|
|
237
|
+
— **typed factory** with the DTO schema generics. The generics
|
|
238
|
+
flow into every handler so `input` and `output` are correctly
|
|
239
|
+
typed without manual annotation.
|
|
240
|
+
- `handlers: { postfixCoreOperations: async (_id, input,
|
|
241
|
+
executionContext, operationPath, utils) => {...} }` — single
|
|
242
|
+
hook. The five handler parameters are positional and typed:
|
|
243
|
+
`id` (resource id, may be unset on CREATE prefix),
|
|
244
|
+
`input` (request DTO, typed via the generic), `executionContext`
|
|
245
|
+
(auth + tenant), `operationPath` (echoed for convenience),
|
|
246
|
+
`utils` (logger, repository services). The handler **must
|
|
247
|
+
return the input** (possibly mutated) for the framework to
|
|
248
|
+
continue the pipeline.
|
|
249
|
+
- `utils.logger.debug('TodosCreatePostfix.postfixCoreOperations executed')`
|
|
250
|
+
— typed logger with named source. Never `console.log`; the
|
|
251
|
+
framework logger is structured and routed.
|
|
252
|
+
- `export default todosCreateDefaultCustomImpl` — **default
|
|
253
|
+
export** is the auto-scanner contract.
|
|
254
|
+
`scanDefaultExports<ResourceCustomServiceImplementationFactory>`
|
|
255
|
+
picks up the default export and wires it into
|
|
256
|
+
`BackendDomainModule.operations`.
|
|
257
|
+
|
|
258
|
+
What is **not** in this block (and shouldn't be):
|
|
259
|
+
|
|
260
|
+
- No hand-built DTO schemas — every schema comes from the registry
|
|
261
|
+
- No string-literal enum values in `operationPath`
|
|
262
|
+
- No raw `console.log` — use `utils.logger`
|
|
263
|
+
- No untyped `(input: any) => ...` handler signatures — the
|
|
264
|
+
generic flow is what makes the handlers safe
|
|
265
|
+
- No transaction management — the framework owns the transaction;
|
|
266
|
+
the handler runs within it
|
|
267
|
+
|
|
268
|
+
## Rejecting from a hook: throw a WildoError, never `new Error`
|
|
269
|
+
|
|
270
|
+
When a hook must reject (custom validation fails, a business rule is violated,
|
|
271
|
+
a related record is missing), throw through the injected `utils.errorBuilder`:
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
throw utils.errorBuilder.buildError(ErrorType.<TYPE>, executionContext, {
|
|
275
|
+
customMessageReference: ErrorCustomMessageReference.<REF>,
|
|
276
|
+
context: { /* structured dynamic values only */ },
|
|
277
|
+
});
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
- The **`ErrorType`** drives the HTTP status (VALIDATION→400, NOT_FOUND→404,
|
|
281
|
+
AUTHORIZATION→403, CONFLICT→409, BUSINESS_RULE→422, …) — never default to INTERNAL.
|
|
282
|
+
- The **user-facing text is the `customMessageReference`** (localized via
|
|
283
|
+
`tErrorMessage`), NOT a string in `context.message` — that is stripped for most
|
|
284
|
+
types and never localized.
|
|
285
|
+
- **Dynamic values go in `context` as structured keys**
|
|
286
|
+
(`context: { emailDomain }`), never interpolated into a message string.
|
|
287
|
+
- A plain `throw new Error(...)` makes the framework GUESS the type from the
|
|
288
|
+
message text — wrong status, generic message, no i18n. Only acceptable in
|
|
289
|
+
pre-DI/bootstrap code where `errorBuilder` does not exist.
|
|
290
|
+
|
|
291
|
+
Read `references/framework-error-handling-api.md` for the full `ErrorType`→status
|
|
292
|
+
map and the message/context rules.
|
|
293
|
+
|
|
294
|
+
## References
|
|
295
|
+
|
|
296
|
+
- `references/operation-file-conventions.md` — operation file conventions
|
|
297
|
+
- `references/framework-operation-base-and-path-api.md` — source-backed operation identity / path types from `saas-models`
|
|
298
|
+
- `references/framework-transactional-core-api.md` — source-backed atomic core and named participant contract
|
|
299
|
+
- `references/framework-error-handling-api.md` — source-backed `ErrorType` enum + the rules for throwing a WildoError (customMessageReference vs context, no plain `Error`)
|
|
300
|
+
- `backend-addon-wiring/SKILL.md` — module wiring (the consumer of the auto-scanned operations slot)
|
|
301
|
+
- `resource-config-wiring/SKILL.md` — resource configuration (the truth contract for DTO schemas)
|
|
302
|
+
|
|
303
|
+
## Verification
|
|
304
|
+
|
|
305
|
+
- [ ] File matches `*.operation.ts` suffix (so auto-scanner picks it up)
|
|
306
|
+
- [ ] Default export is the typed `ResourceCustomServiceImplementationFactory`
|
|
307
|
+
- [ ] `operationPath` uses typed enums for all three fields (no string literals)
|
|
308
|
+
- [ ] DTO schemas come from `resourcesRegistryService.getRequestDtoFromPath/getResponseDtoFromPath`
|
|
309
|
+
- [ ] `createResourceCustomServiceImplementation<...>(...)` is invoked with the DTO schema generics
|
|
310
|
+
- [ ] `transactionalCore: true` has an explicit `transactionParticipants` map containing every additional resource touched inside the atomic phases
|
|
311
|
+
- [ ] Any `transactionalCoreConflictResolver` returns an explicit `RECONCILED`, `RETRY_TRANSACTION`, or `UNHANDLED` action
|
|
312
|
+
- [ ] Handlers (when present) return the input or run side effects through `utils.<service>`
|
|
313
|
+
- [ ] Errors caught with `isWildoBackendError(error)`
|
|
314
|
+
- [ ] Logs use `utils.logger`, not `console.log`
|
|
315
|
+
- [ ] Operation invoked from API for the intended resource operation id
|
|
316
|
+
|
|
317
|
+
### Grep invariants
|
|
318
|
+
|
|
319
|
+
Run from the app root, substituting `<slug>` and `<resource>`:
|
|
320
|
+
|
|
321
|
+
| Invariant | Command |
|
|
322
|
+
|---------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
323
|
+
| File suffix is `*.operation.ts` | `rg --files backend-api/src/modules/<slug>/resources/ \| rg "\.operation\.ts$"` |
|
|
324
|
+
| Default export is the typed factory | `rg -n "export default" backend-api/src/modules/<slug>/resources/<resource>/<resource>.*.operation.ts` |
|
|
325
|
+
| `operationIdentifier` uses typed enum | `rg -n "operationIdentifier:\s+CoreResourceOperation\." backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
326
|
+
| `variantType` uses typed enum | `rg -n "variantType:\s+ResourceOperationVariantType\." backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
327
|
+
| **No string-literal `operationIdentifier`** (must be empty) | `rg -n "operationIdentifier:\s+'" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
328
|
+
| DTO schemas resolved through the registry | `rg -n "getRequestDtoFromPath\(operationPath\)\|getResponseDtoFromPath\(operationPath\)" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
329
|
+
| Custom impl uses the typed factory | `rg -n "createResourceCustomServiceImplementation<" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
330
|
+
| Transactional core declares its participant map | `rg -n -U "transactionalCore:\\s*true[\\s\\S]{0,240}transactionParticipants:" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
331
|
+
| **No `console.log`** (must be empty; use `utils.logger`) | `rg -n "console\.(log\|error\|warn)" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
332
|
+
| **No plain `throw new Error`** (use `utils.errorBuilder.buildError`) | `rg -n "throw new Error" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
333
|
+
| **No prose in error context** (use `customMessageReference`) | `rg -n "context:\s*\{[^}]*message:\s*['\"\`]" backend-api/src/modules/<slug>/resources/<resource>/` |
|
|
334
|
+
|
|
335
|
+
The high-signal invariant is **"`operationIdentifier` and
|
|
336
|
+
`variantType` use typed enums"** combined with **"DTO schemas
|
|
337
|
+
resolved through the registry"** — these are the two contracts that
|
|
338
|
+
keep the operation aligned with the resource config as it evolves.
|
|
339
|
+
|
|
340
|
+
## Common Rationalizations
|
|
341
|
+
|
|
342
|
+
| Rationalization | Reality |
|
|
343
|
+
|-----------------|---------|
|
|
344
|
+
| "Mutate DTO in place" | Immutability and audit trails depend on clear boundaries; mutate via the returned input shape, not by reaching into internal references. |
|
|
345
|
+
| "Hand-build the DTO schema for speed" | Hand-built schemas drift the moment `resource-config-wiring` changes; the registry-backed lookup is the only mechanism that stays aligned. |
|
|
346
|
+
| "Use `console.log` for quick debugging" | The framework logger is structured and routed; `console.log` bypasses observability and pollutes prod logs. Always `utils.logger`. |
|
|
347
|
+
| "Skip handlers when only validating Zod" | Pure Zod validation stays in the schema layer; if you have a custom handler, it's because validation needs runtime context (tenant, related resource state). |
|
|
348
|
+
| "`transactionalCore: true` means every nested resource call joins automatically" | No. Name every additional resource in `transactionParticipants` and forward `utils.serviceOptions` to every nested call. Startup rejects incompatible declared adapters, but it cannot discover omitted calls or repair dropped transaction options. |
|
|
349
|
+
| "A conflict resolver can return `undefined` to ask for a retry" | No. Return `RETRY_TRANSACTION` explicitly. Use `UNHANDLED` to preserve the original conflict and `RECONCILED` only with an already-committed equivalent result. |
|
|
350
|
+
| "Catch errors as `Error`" | Use `isWildoBackendError(error)`; raw `Error` catches mask typed backend errors and break observability. |
|
|
351
|
+
| "`throw new Error('bad input')` is simpler" | It bypasses the error system — the framework guesses the status from the message text, the user gets a generic 500, and there is no i18n. Throw `utils.errorBuilder.buildError(ErrorType.X, ec, { customMessageReference })`. |
|
|
352
|
+
| "Put the message in `context.message` so the user sees it" | For most ErrorTypes `context` is stripped before the response, so that string is never shown and never localized. The user message is the `customMessageReference`; `context` is for structured, log-only diagnostic values. |
|
|
353
|
+
|
|
354
|
+
## Red Flags
|
|
355
|
+
|
|
356
|
+
- Operation file not auto-scanned because the suffix is wrong (e.g. `.operations.ts` plural — must be singular `.operation.ts`)
|
|
357
|
+
- DTO schemas hand-built in the operation file (will silently drift from `resource-config-wiring`)
|
|
358
|
+
- String-literal `operationIdentifier:` or `variantType:` instead of the typed enum
|
|
359
|
+
- Operation file imports `Container` from `inversify` directly (must use `InversifyContainer` from `@wildo-ai/saas-backend-lib`)
|
|
360
|
+
- Handler signature `(input: any, ...)` — defeats the generic flow that gives input/output their correct types
|
|
361
|
+
- `transactionalCore: true` without a nearby `transactionParticipants` map (catch with the **Transactional core declares its participant map** grep above)
|
|
362
|
+
- A nested resource read/write inside `transactionalCore` that does not forward `utils.serviceOptions` — the participant declaration validates compatibility but does not implicitly propagate the transaction
|
|
363
|
+
- A `transactionalCoreConflictResolver` that infers retry from a missing/undefined result instead of returning one explicit conflict action
|
|
364
|
+
- `console.log` in handler body (catch with the **No `console.log`** grep — must be empty)
|
|
365
|
+
- `throw new Error(...)` inside a hook instead of `utils.errorBuilder.buildError(...)` (catch with the **No plain `throw new Error`** grep below)
|
|
366
|
+
- A hardcoded English sentence in `context.message` (or `context.errorMessage`) instead of a `customMessageReference` (catch with the **No prose in error context** grep below)
|
|
367
|
+
- Operation file not bound in DI — handler never runs (catch by hitting the API path and observing the framework's "no custom impl" log)
|
|
368
|
+
|
|
369
|
+
## Related Skills
|
|
370
|
+
|
|
371
|
+
- `backend-addon-wiring` — module wiring (the consumer of the auto-scanned operations slot)
|
|
372
|
+
- `resource-config-wiring` — resource configuration (the truth contract for DTO schemas); also documents `systemAccessPolicy` + `SystemAccessBackendService` for a handler that must read a resource OUTSIDE the caller's scope (an ACL-bypassing system read)
|
|
373
|
+
- `resource-schema-authoring` — Zod schemas underlying the DTOs
|
|
374
|
+
- `resource-ui-behavior` — give the new custom operation its action-button `iconOverride`; custom operations have no default icon and otherwise render the placeholder "missing icon"
|
package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# Error handling in backend operations (source + rules)
|
|
2
|
+
|
|
3
|
+
Read this whenever a custom operation hook, custom validation, or side effect
|
|
4
|
+
needs to **reject** — return a failure to the caller. Getting this right is what
|
|
5
|
+
makes your error surface with the correct HTTP status and a localized message
|
|
6
|
+
instead of a generic 500.
|
|
7
|
+
|
|
8
|
+
## The one rule
|
|
9
|
+
|
|
10
|
+
Inside a backend operation hook you are handed `utils.errorBuilder`. **Throw
|
|
11
|
+
through it — never `throw new Error(...)`.**
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
throw utils.errorBuilder.buildError(ErrorType.<TYPE>, executionContext, {
|
|
15
|
+
customMessageReference: ErrorCustomMessageReference.<REF>,
|
|
16
|
+
context: { /* structured dynamic values — log-only for most types */ },
|
|
17
|
+
});
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
A plain `throw new Error('...')` bypasses the whole error system: the framework
|
|
21
|
+
then *guesses* the type from the message text (so rewording the string silently
|
|
22
|
+
changes the HTTP status), hands the user a generic message, and cannot localize
|
|
23
|
+
it. `buildError` is the only path that gives you an explicit status, the
|
|
24
|
+
localized user message, and safe client/log separation.
|
|
25
|
+
|
|
26
|
+
## Pick the ErrorType (it drives the HTTP status)
|
|
27
|
+
|
|
28
|
+
The `ErrorType` enum below is the single source for the status code, the log
|
|
29
|
+
severity, and whether `context` is exposed to the client. Choose the type that
|
|
30
|
+
matches the real condition — do not default everything to `INTERNAL`.
|
|
31
|
+
|
|
32
|
+
## Import Origins
|
|
33
|
+
|
|
34
|
+
- `@wildo-ai/saas-models`
|
|
35
|
+
|
|
36
|
+
## Source Excerpts
|
|
37
|
+
|
|
38
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
39
|
+
|
|
40
|
+
```typescript
|
|
41
|
+
NETWORK = 'NETWORK',
|
|
42
|
+
|
|
43
|
+
AUTHENTICATION = 'AUTHENTICATION',
|
|
44
|
+
AUTHORIZATION = 'AUTHORIZATION',
|
|
45
|
+
|
|
46
|
+
VALIDATION = 'VALIDATION',
|
|
47
|
+
|
|
48
|
+
/** HTTP 413 — the request body exceeded a size limit (e.g. the OAuth mount's 32 KB cap or a global body
|
|
49
|
+
* parser limit). A CLIENT input problem, classified separately from VALIDATION so the response carries the
|
|
50
|
+
* precise 413 status framework-wide rather than a generic 400 (and never an INTERNAL 500). */
|
|
51
|
+
PAYLOAD_TOO_LARGE = 'PAYLOAD_TOO_LARGE',
|
|
52
|
+
|
|
53
|
+
NOT_FOUND = 'NOT_FOUND',
|
|
54
|
+
CONFLICT = 'CONFLICT',
|
|
55
|
+
|
|
56
|
+
RATE_LIMIT = 'RATE_LIMIT',
|
|
57
|
+
|
|
58
|
+
INTERNAL = 'INTERNAL',
|
|
59
|
+
DATABASE = 'DATABASE',
|
|
60
|
+
EXTERNAL_SERVICE = 'EXTERNAL_SERVICE',
|
|
61
|
+
|
|
62
|
+
UNKNOWN = 'UNKNOWN',
|
|
63
|
+
UNCAUGHT_EXCEPTION = 'UNCAUGHT_EXCEPTION',
|
|
64
|
+
UNHANDLED_REJECTION = 'UNHANDLED_REJECTION',
|
|
65
|
+
|
|
66
|
+
BUSINESS_RULE = 'BUSINESS_RULE',
|
|
67
|
+
INFRASTRUCTURE = 'INFRASTRUCTURE',
|
|
68
|
+
CONFIGURATION = 'CONFIGURATION',
|
|
69
|
+
|
|
70
|
+
// Feature gating errors
|
|
71
|
+
FEATURE_NOT_AVAILABLE = 'FEATURE_NOT_AVAILABLE',
|
|
72
|
+
FEATURE_LIMIT_EXCEEDED = 'FEATURE_LIMIT_EXCEEDED',
|
|
73
|
+
INSUFFICIENT_CREDITS = 'INSUFFICIENT_CREDITS',
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## The user-facing message is the `customMessageReference` — NOT `context.message`
|
|
77
|
+
|
|
78
|
+
- `customMessageReference` (an `ErrorCustomMessageReference` from
|
|
79
|
+
`@wildo-ai/saas-models`) is resolved to localized text on the frontend via
|
|
80
|
+
`tErrorMessage(ref)` → `errors_messages.<ref>.msg`. **This is the only text a
|
|
81
|
+
user sees.** Pick the closest existing member (there is a large catalog:
|
|
82
|
+
`VALIDATION`, `NOT_FOUND`, `BUSINESS_RULE`, `CONFLICT`, `FEATURE_NOT_AVAILABLE`,
|
|
83
|
+
`AUTHENTICATION_*`, `BILLING_*`, `CONSUMABLE_TOKEN_*`, …).
|
|
84
|
+
- **NEVER put a user-facing English sentence in `context.message`.** For most
|
|
85
|
+
error types the whole `context` is stripped before the response, so that
|
|
86
|
+
string never reaches the user *and* is not localized — it is dead weight.
|
|
87
|
+
Only `VALIDATION` / `CONFLICT` / `RATE_LIMIT` expose `context` at all.
|
|
88
|
+
- **Dynamic values go in `context` as structured keys, not interpolated into a
|
|
89
|
+
message.** Instead of `` message: `Domain '${d}' is not allowed` ``, write
|
|
90
|
+
`context: { emailDomain: d }`. The value is preserved for logs (and, for the
|
|
91
|
+
exposed types, for the client) without hardcoding prose.
|
|
92
|
+
- For **field-level** validation prefer Zod on the operation's input schema — it
|
|
93
|
+
produces per-field `validationErrors` the form renders inline; reserve
|
|
94
|
+
`buildError(VALIDATION, …)` for cross-field / whole-request rejections.
|
|
95
|
+
|
|
96
|
+
## Worked example (from engine source)
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
## Usage Example
|
|
100
|
+
|
|
101
|
+
```typescript
|
|
102
|
+
// Inside a backend custom-operation hook you receive `utils.errorBuilder`.
|
|
103
|
+
// Throw a WildoError with it — NEVER `throw new Error(...)`:
|
|
104
|
+
// • the ErrorType drives the HTTP status (VALIDATION → 400 here);
|
|
105
|
+
// • customMessageReference names the localized user message (resolved by
|
|
106
|
+
// tErrorMessage → errors_messages.<ref>.msg) — do NOT hardcode English;
|
|
107
|
+
// • any dynamic values go in `context` as structured keys (log-only for
|
|
108
|
+
// most types), never interpolated into a `context.message` string.
|
|
109
|
+
throw errorBuilder.buildError(ErrorType.VALIDATION, undefined, {
|
|
110
|
+
customMessageReference: ErrorCustomMessageReference.SERVICE_RESOURCE_VALIDATION_FAILED,
|
|
111
|
+
});
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Verification (grep invariants)
|
|
115
|
+
|
|
116
|
+
- No plain throws in a hook: `rg "throw new Error" backend-api/src/modules/**/*.operation.ts` → 0.
|
|
117
|
+
- No hardcoded prose in error context:
|
|
118
|
+
`rg "context:\s*\{[^}]*message:\s*['\"\`]" backend-api/src/modules` → 0.
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# Operation base & path types (source)
|
|
2
|
+
|
|
3
|
+
- Backend handlers must align with **resource-config** operation identity and URL/path shape.
|
|
4
|
+
- Read when implementing or renaming custom operations in `backend-api`.
|
|
5
|
+
|
|
6
|
+
## Import Origins
|
|
7
|
+
|
|
8
|
+
- `@wildo-ai/saas-models`
|
|
9
|
+
|
|
10
|
+
## Source Excerpts
|
|
11
|
+
|
|
12
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
*
|
|
16
|
+
* Base operation configuration type.
|
|
17
|
+
* NOTE: TDatabaseSchema has been removed. Backend-only fields are now marked with
|
|
18
|
+
* the isBackendOnly decorator in mainSchema and are stripped at the service layer.
|
|
19
|
+
*
|
|
20
|
+
* @remarks Import from `@wildo-ai/saas-models`. App `resources-config` fills these per operation variant.
|
|
21
|
+
*/
|
|
22
|
+
export type ResourceConfiguration_Operation_Base<
|
|
23
|
+
TCustomOperationEnum extends EnumLikeType | undefined,
|
|
24
|
+
TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined,
|
|
25
|
+
TMainSchema extends z.ZodTypeAny = z.ZodAny,
|
|
26
|
+
> = ResourceConfiguration_OperationVariant_Base<TMainSchema> & {
|
|
27
|
+
isDisabled: boolean, // default false
|
|
28
|
+
mainSchema: TMainSchema,
|
|
29
|
+
resourcePrimaryScope : ResourcePrimaryScope, // default ResourcePrimaryScope.ORGANIZATIONS
|
|
30
|
+
resourceIdentifier : ResourceType,
|
|
31
|
+
resourceFieldIdentifier : ResourceFieldIdentifier,
|
|
32
|
+
|
|
33
|
+
resourceRelationships : ResourceConfiguration_ResourceRelationships,
|
|
34
|
+
|
|
35
|
+
isSystemResource: boolean, // default false - true for core system resources (organizations, users, etc.), false for tenant-specific resources
|
|
36
|
+
operationIdentifier : TCustomOperationEnum | TCoreOperationEnum,
|
|
37
|
+
isOperationDefault : boolean, // default true
|
|
38
|
+
serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode; //default ResourceOperation_ServiceRuntimeMode.INLINE
|
|
39
|
+
generatedOperation?: ResourceConfiguration_GeneratedOperationMetadata;
|
|
40
|
+
|
|
41
|
+
requestDto?: z.ZodSchema<any>;
|
|
42
|
+
responseDto?: z.ZodSchema<any>;
|
|
43
|
+
/** Set by factory when an explicit `requestDto` was provided in variant params.
|
|
44
|
+
* Allows the DTO builder to skip heuristic comparison and trust the flag:
|
|
45
|
+
* `true` ⇒ preserve the supplied schema verbatim; `false` ⇒ the requestDto is
|
|
46
|
+
* the factory's auto-derived temporary placeholder, so always use the
|
|
47
|
+
* inheritance-rebuilt DTO (a discriminated union for inheritance resources).
|
|
48
|
+
* Absent only on legacy/hand-authored operations that predate the flag. */
|
|
49
|
+
hasCustomRequestDto?: boolean;
|
|
50
|
+
/** Set by factory when `customResponseDto` was explicitly provided in variant params.
|
|
51
|
+
* Allows the DTO builder to skip heuristic comparison and always preserve the custom schema. */
|
|
52
|
+
hasCustomResponseDto?: boolean;
|
|
53
|
+
/**
|
|
54
|
+
* SummaryDto contains only fields marked with isSummaryField decorator.
|
|
55
|
+
* Used for LIST operations in SUMMARY mode.
|
|
56
|
+
* Calculated at factory execution time.
|
|
57
|
+
*/
|
|
58
|
+
summaryDto?: z.ZodSchema<any>;
|
|
59
|
+
/**
|
|
60
|
+
* ContextDto includes relationship placeholders for context-dependent operations.
|
|
61
|
+
* Used for operations in CONTEXT mode.
|
|
62
|
+
* Calculated at factory execution time.
|
|
63
|
+
*/
|
|
64
|
+
contextDto?: z.ZodSchema<any>;
|
|
65
|
+
/**
|
|
66
|
+
* InternalDto includes backend-only fields (isBackendOnly decorator).
|
|
67
|
+
* Used for backend-to-backend communication (queues, internal calls).
|
|
68
|
+
* Calculated at factory execution time.
|
|
69
|
+
*/
|
|
70
|
+
internalDto?: z.ZodSchema<any>;
|
|
71
|
+
/**
|
|
72
|
+
* RepositoryDto for repository projection.
|
|
73
|
+
* Excludes virtual fields and populated placeholders.
|
|
74
|
+
* Calculated at factory execution time.
|
|
75
|
+
*/
|
|
76
|
+
repositoryDto?: z.ZodSchema<any>;
|
|
77
|
+
|
|
78
|
+
notificationBadgeOperations: { identifier : NotificationBadgeIdentifier, operation : NotificationBadgeOperation }[]; //
|
|
79
|
+
userNotifications: UserNotificationDefinition[];
|
|
80
|
+
m2mNotifications: M2MNotificationDefinitionWithoutIdentifier[];
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
## Import Origins
|
|
84
|
+
|
|
85
|
+
- `@wildo-ai/saas-models`
|
|
86
|
+
|
|
87
|
+
## Source Excerpts
|
|
88
|
+
|
|
89
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
90
|
+
|
|
91
|
+
```typescript
|
|
92
|
+
*
|
|
93
|
+
* Path key for routing: resource, operation, variant, optional variantKey / bulk.
|
|
94
|
+
*/
|
|
95
|
+
export type ResourceConfiguration_OperationPath<
|
|
96
|
+
TCustomOperationEnum extends EnumLikeType | undefined,
|
|
97
|
+
TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined
|
|
98
|
+
> = {
|
|
99
|
+
resourceIdentifier: ResourceType;
|
|
100
|
+
operationIdentifier: TCustomOperationEnum | TCoreOperationEnum;
|
|
101
|
+
variantType : ResourceOperationVariantType
|
|
102
|
+
isOperationDefault?: boolean;
|
|
103
|
+
isBulkOperation?: boolean;
|
|
104
|
+
variantKey?: string;
|
|
105
|
+
|
|
106
|
+
}
|
|
107
|
+
```
|