@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,569 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: seeding-authoring
|
|
3
|
+
description: Author a `DataSeedDefinition` end-to-end — pick the right Level (A vs B), pick the right mode (LAZY / ADDITIVE / UPGRADE / SYNC) for the row's re-run semantics, declare a stable business key on the resource schema, declare which fields the seed *owns* via `managedFields`, and (for UPGRADE) ship a migrator + rename ledger so business-key relocations preserve identity. Use when the user says "seed system email templates", "give every new organization a default workspace", "add a default dashboard the first time a user opens the dashboards list", "ship a closed enum as DB rows synced from the declaration", "deploy version 2 of the welcome template without losing user customization", or any request that produces a new `createDataSeedDefinition({...})` call site.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Seeding Authoring
|
|
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
|
+
Author a `DataSeedDefinition` — the declarative shape consumed by the
|
|
23
|
+
backend seeding engine to **idempotently materialize known rows**
|
|
24
|
+
into the application's database. One factory entry point
|
|
25
|
+
(`createDataSeedDefinition`) drives every seed; the authoring decisions
|
|
26
|
+
live entirely in its single input object.
|
|
27
|
+
|
|
28
|
+
Five decisions, ordered by blast-radius:
|
|
29
|
+
|
|
30
|
+
1. **Level (A vs B)** — does this seed fire from an *application
|
|
31
|
+
lifecycle* event (boot, version upgrade, scheduled refresh,
|
|
32
|
+
admin re-run) or from a *resource lifecycle* event (after
|
|
33
|
+
`Organization.create`, before `User.delete`, on lazy READ of
|
|
34
|
+
`Dashboard`)?
|
|
35
|
+
2. **Mode** — what should happen on the SECOND pass? Pick `LAZY`,
|
|
36
|
+
`ADDITIVE`, `UPGRADE`, or `SYNC` from the decision tree below.
|
|
37
|
+
3. **Business key** — what stable identifier on the target resource
|
|
38
|
+
tells the dispatcher "this declared row is the same one I
|
|
39
|
+
inserted last time"? Declare it on the resource schema with the
|
|
40
|
+
`isBusinessKey()` decorator (single field) or `businessKeySet([...])`
|
|
41
|
+
builder (composite).
|
|
42
|
+
4. **Managed fields** — which fields does the seed *own* (replaced
|
|
43
|
+
on every UPGRADE/SYNC pass) vs leave to the user? Required
|
|
44
|
+
non-empty for UPGRADE.
|
|
45
|
+
5. **Rename ledger** — when a business-key value changes at the
|
|
46
|
+
declaration site, ship a `renames[]` entry so the next pass
|
|
47
|
+
relocates existing rows instead of orphaning them.
|
|
48
|
+
|
|
49
|
+
The framework rejects almost every authoring mistake at
|
|
50
|
+
`createDataSeedDefinition(...)` invocation time: missing `onOrphan`
|
|
51
|
+
on SYNC, empty `managedFields` on UPGRADE, `lazyAccess` on a
|
|
52
|
+
non-LAZY mode, illegal trigger × mode pair, malformed
|
|
53
|
+
`schedule.cron`, rename pointing at a non-business-key field. The
|
|
54
|
+
goal of this skill is to make the right choice the FIRST time so the
|
|
55
|
+
factory doesn't have to reject anything.
|
|
56
|
+
|
|
57
|
+
This skill is **scoped to authoring**: the operational surface
|
|
58
|
+
(admin endpoints, cron batch wiring, lazy guard registration,
|
|
59
|
+
metrics, `DataSeedRun` ledger queries) is covered by
|
|
60
|
+
[`seeding-operations`](../seeding-operations/SKILL.md).
|
|
61
|
+
|
|
62
|
+
## App Paths
|
|
63
|
+
|
|
64
|
+
| Surface | Glob (relative to app root) |
|
|
65
|
+
|----------------------------|-------------------------------------------------------------------------------------------------------------------|
|
|
66
|
+
| Seed declaration | `backend-api/src/modules/<module>/seeds/<seed-key>.seed.ts` (recommended: one file per seed; default-export the `DataSeedDefinition`. No factory-enforced naming yet — pick a stable convention per module.) |
|
|
67
|
+
| Module seed aggregator | `backend-api/src/modules/<module>/seeds/index.ts` (recommended: default-export `DataSeedDefinition[]` so the backend module record can `seeds: <module>Seeds`) |
|
|
68
|
+
| Resource schema (business key) | `shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts` (`isBusinessKey()` / `businessKeySet([...])`) |
|
|
69
|
+
| Module backend record | `backend-api/src/modules/<module>/index.ts` — `seeds?: DataSeedDefinition[]` slot on the typed `BackendDomainModule` (the wrapper exposed via `BackendOwnedModule.backendModule`). Aggregated by `mergeBackendDomainModules` and threaded through `ApplicationInitializationConfig.dataSeeds`. |
|
|
70
|
+
|
|
71
|
+
## When to Use
|
|
72
|
+
|
|
73
|
+
- Adding a new seed (any mode, any level)
|
|
74
|
+
- Changing the business key on a seeded resource (must ship a
|
|
75
|
+
`renames[]` entry on every seed targeting that resource)
|
|
76
|
+
- Bumping `version` on a UPGRADE seed (must verify migrators cover
|
|
77
|
+
every persisted version `n < new version`)
|
|
78
|
+
- Adding a Level-B trigger on a new resource (must verify the
|
|
79
|
+
`mode` × `trigger` cell is allowed by the §3.6 matrix)
|
|
80
|
+
- Switching a SYNC seed's `onOrphan` policy (read the operational
|
|
81
|
+
blast-radius before changing — `DELETE` is irreversible)
|
|
82
|
+
|
|
83
|
+
## When NOT to Use
|
|
84
|
+
|
|
85
|
+
- Wiring the cron scheduler / admin endpoints / lazy guard →
|
|
86
|
+
[`seeding-operations`](../seeding-operations/SKILL.md)
|
|
87
|
+
- Editing the `DataSeedRun` ledger directly → never; it is
|
|
88
|
+
framework-owned, the dispatcher writes it
|
|
89
|
+
- Introducing a brand-new mode or trigger kind → engine-level
|
|
90
|
+
framework change, not application authoring
|
|
91
|
+
- Adding `__seed` overlay to user-authored data (non-seed) → the
|
|
92
|
+
overlay is dispatcher-managed; never write it from app code
|
|
93
|
+
|
|
94
|
+
## The Five Authoring Decisions
|
|
95
|
+
|
|
96
|
+
### Decision 1: Level — A vs B
|
|
97
|
+
|
|
98
|
+
**Level A** = application lifecycle. Triggered by events that happen
|
|
99
|
+
to the **deployment itself**, not to any single resource row.
|
|
100
|
+
|
|
101
|
+
| Trigger kind | Fires when |
|
|
102
|
+
|------------------------------------|---------------------------------------------------------------------|
|
|
103
|
+
| `ON_APP_INIT` | First boot for this APPLICATION (empty `DataSeedRun` history) |
|
|
104
|
+
| `ON_APP_VERSION_UPGRADE` | Declaration `version` > recorded version in `DataSeedRun` |
|
|
105
|
+
| `ON_SCHEDULED_REFRESH` | The engine cron batch picks up a seed with a `schedule?` block |
|
|
106
|
+
| `ON_MANUAL_TRIGGER` | Admin re-runs the seed via the back-office or admin endpoint |
|
|
107
|
+
|
|
108
|
+
**Level B** = resource lifecycle. Triggered by an operation on a
|
|
109
|
+
specific resource row. The triggering row's `_id` is the natural
|
|
110
|
+
`relatedId` for the `DataSeedRun` record.
|
|
111
|
+
|
|
112
|
+
| Trigger kind | Fires when |
|
|
113
|
+
|----------------------|-----------------------------------------------------------------------------------------|
|
|
114
|
+
| `RESOURCE_LIFECYCLE` | `(beforeCreate \| afterCreate \| beforeUpdate \| afterUpdate \| beforeDelete \| afterDelete)` of a named resource type |
|
|
115
|
+
| `LAZY_ACCESS` | First call to a named `(resource, operation)` pair for the resolved scope |
|
|
116
|
+
|
|
117
|
+
> Common trap: `onOrganizationCreate` is **Level B** (Organization
|
|
118
|
+
> is a resource, not a deployment event). The same applies to any
|
|
119
|
+
> "on creation of resource X" pattern.
|
|
120
|
+
|
|
121
|
+
### Decision 2: Mode — pick by re-run semantics
|
|
122
|
+
|
|
123
|
+
| Mode | Re-run safe? | Touches existing rows? | Required fields | Pick when … |
|
|
124
|
+
|------------|--------------|--------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
125
|
+
| `LAZY` | Yes | No | `lazyAccess`, `entry()` | "Default X appears the first time the user opens Y" |
|
|
126
|
+
| `ADDITIVE` | Yes | Yes — full payload re-stamped | none beyond the base | "New rows shipped in vN+1 should appear; existing rows are re-stamped from the declared payload" |
|
|
127
|
+
| `UPGRADE` | Yes | Yes — only `managedFields` | `managedFields[]` (non-empty), optional `migrators.fromVersion[n]` | "Re-deploy the framework-owned subject line, keep user-edited body" |
|
|
128
|
+
| `SYNC` | Yes | Yes — controlled by `onOrphan` | `onOrphan` (`DELETE` / `DEPRECATE` / `REPORT`), `managedFields[]` | "Closed enum materialized as rows; declaration is the source of truth" |
|
|
129
|
+
|
|
130
|
+
The §3.6 matrix rejects illegal cells at factory time:
|
|
131
|
+
|
|
132
|
+
| | `ON_APP_INIT` | `ON_APP_VERSION_UPGRADE` | `ON_SCHEDULED_REFRESH` / `ON_MANUAL_TRIGGER` | `RESOURCE_LIFECYCLE` | `LAZY_ACCESS` |
|
|
133
|
+
|-------------|---------------|--------------------------|-----------------------------------------------|----------------------|---------------|
|
|
134
|
+
| `LAZY` | ✗ | ✗ | ✗ | ✗ | ✓ (auto-injected) |
|
|
135
|
+
| `ADDITIVE` | ✓ | ✓ | ✓ | ✓ | ✗ |
|
|
136
|
+
| `UPGRADE` | ✗ | ✓ | ✓ | ✗ | ✗ |
|
|
137
|
+
| `SYNC` | ✓ | ✓ | ✓ | ✗ | ✗ |
|
|
138
|
+
|
|
139
|
+
### Decision 3: Business key — stable identity on the resource
|
|
140
|
+
|
|
141
|
+
The framework only knows `_id` (random / cuid) by default. Safe
|
|
142
|
+
upsert / upgrade / sync requires a **declaration-side identifier**
|
|
143
|
+
that survives across deploys. Declare it on the resource Zod schema:
|
|
144
|
+
|
|
145
|
+
<!-- TIER C WAIVER: Side-by-side single-field vs composite businessKey contrast is exactly what Decision 3 teaches; splitting these two schemas across separate Tier A anchors would lose the visual contrast (`isBusinessKey()` decorator vs `.businessKeySet([...])` chain). Promote to Tier A `example.seeding.authoring.business-key-shapes` once both shapes exist in a stable application example. -->
|
|
146
|
+
```ts
|
|
147
|
+
export const SystemEmailTemplate_BaseSchema = z.object({
|
|
148
|
+
_id: z.string().isPrimaryKey(),
|
|
149
|
+
organizationId: z.string().isForeignKey(),
|
|
150
|
+
templateKey: z.string().isBusinessKey(), // single-field
|
|
151
|
+
subject: z.string(),
|
|
152
|
+
bodyHtml: z.string(),
|
|
153
|
+
});
|
|
154
|
+
|
|
155
|
+
export const Workspace_BaseSchema = z.object({
|
|
156
|
+
_id: z.string().isPrimaryKey(),
|
|
157
|
+
organizationId: z.string().isForeignKey(),
|
|
158
|
+
name: z.string(),
|
|
159
|
+
slug: z.string(),
|
|
160
|
+
}).businessKeySet(['organizationId', 'slug']); // composite
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Behavioral effects:
|
|
164
|
+
|
|
165
|
+
- The repo gains `findByBusinessKey(...)` and `upsertByBusinessKey(...)`.
|
|
166
|
+
- The seed's `entries[*].businessKey` is matched against this shape
|
|
167
|
+
(single field → object with one key; composite → object with all
|
|
168
|
+
keys present).
|
|
169
|
+
- Cross-seed references via `dependsOn[]` resolve to `_id` at
|
|
170
|
+
dispatch time, so renaming the business key never breaks foreign
|
|
171
|
+
keys (the DB still references `_id`, immutable).
|
|
172
|
+
|
|
173
|
+
### Decision 4: Managed fields — what the seed *owns*
|
|
174
|
+
|
|
175
|
+
`managedFields[]` is the explicit declaration of what the seed
|
|
176
|
+
**owns** vs what the user controls:
|
|
177
|
+
|
|
178
|
+
- **Owned** (in `managedFields`): replaced from the declaration on
|
|
179
|
+
every UPGRADE / SYNC pass.
|
|
180
|
+
- **Not owned**: never touched by the dispatcher.
|
|
181
|
+
|
|
182
|
+
Required non-empty for `UPGRADE` (otherwise the factory rejects:
|
|
183
|
+
"the upgrade has nothing to apply"). Recommended for `SYNC`.
|
|
184
|
+
Harmless / empty for `LAZY` and for `ADDITIVE`. Note for `ADDITIVE`
|
|
185
|
+
(audit L2-6): although the writer DOES re-stamp the declared payload
|
|
186
|
+
on every pass, it bypasses the `managedFields` projection — the full
|
|
187
|
+
declared payload is the source of truth on that mode, so leaving
|
|
188
|
+
`managedFields` empty is the right default. Use `UPGRADE` if you
|
|
189
|
+
need version-gated mutation that preserves user customization on
|
|
190
|
+
non-managed columns.
|
|
191
|
+
|
|
192
|
+
The dispatcher writes a `__seed` overlay onto each row recording
|
|
193
|
+
which fields it owns and which version owned them — this is the
|
|
194
|
+
runtime side of the contract; authors only declare `managedFields[]`.
|
|
195
|
+
|
|
196
|
+
> **Note on overlay field names** (audit L1-7, post-Phase-7
|
|
197
|
+
> close-out): the `__seed` overlay tracks **`managedSince`**
|
|
198
|
+
> (the wall-clock `Date` at which the framework first stamped
|
|
199
|
+
> the row — preserved across subsequent passes by
|
|
200
|
+
> `buildDataSeedRowMetadataForUpsert`, and only re-set when the
|
|
201
|
+
> row is created). It does NOT carry `mode`, `runId`, or
|
|
202
|
+
> `seededAt` — earlier drafts
|
|
203
|
+
> of this guide and some forum discussions referenced those
|
|
204
|
+
> names as if they were persisted on the row. They are NOT:
|
|
205
|
+
> `mode` lives on the seed definition (not the row), `runId`
|
|
206
|
+
> lives on `DataSeedRun` (one row per pass, not per seeded
|
|
207
|
+
> document), and `seededAt` was renamed to `managedSince`
|
|
208
|
+
> early in the design to clarify the "first-stamp wall-clock"
|
|
209
|
+
> semantic. Authors should never need to read or write any of
|
|
210
|
+
> these — the overlay is dispatcher-private — but the naming
|
|
211
|
+
> matters for tests and for the `data-seed-row-metadata.shared.schemas.ts`
|
|
212
|
+
> source file.
|
|
213
|
+
|
|
214
|
+
### Decision 5: Rename ledger — preserve identity across business-key changes
|
|
215
|
+
|
|
216
|
+
When you change a business-key VALUE in the declaration (e.g.
|
|
217
|
+
`templateKey: 'hello'` → `templateKey: 'welcome'`), the dispatcher
|
|
218
|
+
on the next pass would **insert a duplicate** at the new key and
|
|
219
|
+
treat the old row as either an orphan (SYNC) or a legacy unowned
|
|
220
|
+
row (UPGRADE / ADDITIVE). The rename ledger fixes that:
|
|
221
|
+
|
|
222
|
+
```ts
|
|
223
|
+
renames: [
|
|
224
|
+
{ field: 'templateKey', from: 'hello', to: 'welcome' },
|
|
225
|
+
],
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
The dispatcher rewrites the existing row's `templateKey` from
|
|
229
|
+
`'hello'` to `'welcome'` BEFORE the reconcile loop runs, so
|
|
230
|
+
`findByBusinessKey({ templateKey: 'welcome' })` re-locates the
|
|
231
|
+
existing row instead of declaring it missing.
|
|
232
|
+
|
|
233
|
+
Factory-time invariants (rejected with actionable errors):
|
|
234
|
+
|
|
235
|
+
- `rename.field` MUST be a business-key field on the target
|
|
236
|
+
resource (otherwise the rewrite silently no-ops for identity and
|
|
237
|
+
the next pass duplicates).
|
|
238
|
+
- `rename.to` MUST appear as a declared business-key value in
|
|
239
|
+
`entries[*].businessKey` (catches typos like `'welcome-emai'`).
|
|
240
|
+
|
|
241
|
+
## Workflow
|
|
242
|
+
|
|
243
|
+
### Step 1: Confirm the resource has a business key
|
|
244
|
+
|
|
245
|
+
Open the target resource's Zod schema (`<resource>.schemas.ts`).
|
|
246
|
+
Verify either an `isBusinessKey()` decorator on a single field or a
|
|
247
|
+
`businessKeySet([...])` call at the schema root. If absent, add it
|
|
248
|
+
NOW — this is a one-line edit on the schema, but it's a public
|
|
249
|
+
contract change (the repo's `findByBusinessKey` becomes available
|
|
250
|
+
once the marker is present).
|
|
251
|
+
|
|
252
|
+
### Step 2: Pick the level + trigger
|
|
253
|
+
|
|
254
|
+
Walk Decision 1. Land on a single trigger kind (or a small set for
|
|
255
|
+
Level A). For Level B, name the resource type and the lifecycle
|
|
256
|
+
phase. For LAZY, declare `lazyAccess.{ onResource, onOperation }`
|
|
257
|
+
ONLY — the factory auto-injects the matching trigger. Never declare
|
|
258
|
+
`triggers` AND `lazyAccess` together.
|
|
259
|
+
|
|
260
|
+
### Step 3: Pick the mode
|
|
261
|
+
|
|
262
|
+
Walk Decision 2. Cross-check the §3.6 matrix cell. If the cell is
|
|
263
|
+
empty (e.g. UPGRADE × `RESOURCE_LIFECYCLE`), restructure the seed:
|
|
264
|
+
either change the level (move to Level A `ON_APP_VERSION_UPGRADE`)
|
|
265
|
+
or change the mode (use ADDITIVE for the per-row case).
|
|
266
|
+
|
|
267
|
+
### Step 4: Declare the seed
|
|
268
|
+
|
|
269
|
+
Author a single file (recommended: `<seed-key>.seed.ts` co-located
|
|
270
|
+
under `backend-api/src/modules/<module>/seeds/`, but no naming is
|
|
271
|
+
factory-enforced yet — pick a convention per module and stick to
|
|
272
|
+
it). Default-export the result of `createDataSeedDefinition({...})`.
|
|
273
|
+
Mirror the worked example below for the input shape; tailor
|
|
274
|
+
`entries`/`entry`, `managedFields`, `migrators`, `renames`, and
|
|
275
|
+
`version` to your seed. Import the factory from the focused
|
|
276
|
+
subpath barrel:
|
|
277
|
+
|
|
278
|
+
<!-- TIER C WAIVER: This is the canonical subpath-barrel import statement; the entire paragraph that follows the snippet is named after the import path (`/data-seeding-models`) being shown literally here. Tier A promotion is unnecessary because the symbol list IS the contract. -->
|
|
279
|
+
```ts
|
|
280
|
+
import {
|
|
281
|
+
createDataSeedDefinition,
|
|
282
|
+
DataSeedMode,
|
|
283
|
+
DataSeedScopeKind,
|
|
284
|
+
DataSeedTriggerKind,
|
|
285
|
+
} from '@wildo-ai/saas-backend-lib/data-seeding-models';
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
Importing from `@wildo-ai/saas-backend-lib/data-seeding-models`
|
|
289
|
+
(NOT the package root) keeps the seed file off the full backend
|
|
290
|
+
library footprint — the focused subpath barrel exists exactly so
|
|
291
|
+
that seed files and the spec slice can share the runtime contract
|
|
292
|
+
without dragging in inversify / external-connectors / batches.
|
|
293
|
+
|
|
294
|
+
### Step 5: Aggregate + register
|
|
295
|
+
|
|
296
|
+
Aggregate every seed in the module under a single
|
|
297
|
+
`DataSeedDefinition[]` (recommended: a default-exported array from
|
|
298
|
+
`module/seeds/index.ts`). Wire that array onto the module's typed
|
|
299
|
+
`BackendDomainModule` record under the `seeds?: DataSeedDefinition[]`
|
|
300
|
+
slot (the same record that already carries `operations`,
|
|
301
|
+
`controllers`, `flowsActors`, `dataSeedScopeResolvers`). The
|
|
302
|
+
backend bootstrap calls `mergeBackendDomainModules(...)` which
|
|
303
|
+
flat-maps every module's `seeds[]` into the assembly's
|
|
304
|
+
`dataSeeds[]` slot — no per-module registry call required.
|
|
305
|
+
|
|
306
|
+
### Step 6: Bump `version` only when re-applying matters
|
|
307
|
+
|
|
308
|
+
`version: number` is the dispatcher's "re-run me on existing
|
|
309
|
+
scopes" signal for UPGRADE / SYNC. Bumping requires:
|
|
310
|
+
|
|
311
|
+
- For UPGRADE: a `migrators.fromVersion[n]` entry for every
|
|
312
|
+
persisted `n < new version` (otherwise older rows skip the
|
|
313
|
+
migration step and only get the `managedFields` re-applied — may
|
|
314
|
+
or may not be safe depending on the field shape change).
|
|
315
|
+
- For SYNC: nothing extra; the dispatcher's reconcile loop
|
|
316
|
+
re-applies the declared set against persisted state.
|
|
317
|
+
|
|
318
|
+
Do NOT bump `version` for cosmetic edits to the declaration that
|
|
319
|
+
don't intend to write to the DB.
|
|
320
|
+
|
|
321
|
+
## Worked Example
|
|
322
|
+
|
|
323
|
+
Two minimal seeds — one Level-A UPGRADE on app version upgrade, one
|
|
324
|
+
Level-B ADDITIVE on Organization `afterCreate` — anchored from a
|
|
325
|
+
dedicated example file co-located with the runtime contract:
|
|
326
|
+
|
|
327
|
+
|
|
328
|
+
## Usage Example
|
|
329
|
+
|
|
330
|
+
```typescript
|
|
331
|
+
import {
|
|
332
|
+
createDataSeedDefinition,
|
|
333
|
+
DataSeedMode,
|
|
334
|
+
DataSeedResourceLifecyclePhase,
|
|
335
|
+
DataSeedScopeKind,
|
|
336
|
+
DataSeedTriggerKind,
|
|
337
|
+
} from '~wildo-backend-lib/data-seeding/models/data-seed.shared.schemas';
|
|
338
|
+
|
|
339
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
340
|
+
// Level-A example — UPGRADE on app version upgrade.
|
|
341
|
+
// "System email templates" is the canonical use case: the framework
|
|
342
|
+
// owns `subject` + `bodyHtml` (managed); ops can override the default
|
|
343
|
+
// reply-to address per-org and that customization survives every
|
|
344
|
+
// upgrade. Bumping `version` re-runs the seed on existing rows; the
|
|
345
|
+
// optional `migrators.fromVersion` map walks them up first, then the
|
|
346
|
+
// dispatcher re-applies `managedFields` from `entries`.
|
|
347
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
348
|
+
const systemEmailTemplatesSeed = createDataSeedDefinition({
|
|
349
|
+
seedKey: 'system-emails:welcome',
|
|
350
|
+
scope: { kind: DataSeedScopeKind.APPLICATION },
|
|
351
|
+
resourceType: 'system-email-template',
|
|
352
|
+
// `ON_APP_INIT` is deliberately ABSENT: the §3.6 trigger × mode matrix
|
|
353
|
+
// forbids `UPGRADE × onAppInit` — a fresh init has nothing to upgrade,
|
|
354
|
+
// and the factory throws on that cell. Nothing is lost, because UPGRADE
|
|
355
|
+
// already "inserts missing" rows whenever it fires, so the templates are
|
|
356
|
+
// still created on the first version upgrade. Reach for `ADDITIVE` or
|
|
357
|
+
// `SYNC` if you genuinely need a seed to run at `onAppInit`.
|
|
358
|
+
triggers: [
|
|
359
|
+
{ triggerKind: DataSeedTriggerKind.ON_APP_VERSION_UPGRADE },
|
|
360
|
+
{ triggerKind: DataSeedTriggerKind.ON_MANUAL_TRIGGER },
|
|
361
|
+
],
|
|
362
|
+
mode: DataSeedMode.UPGRADE,
|
|
363
|
+
version: 2,
|
|
364
|
+
managedFields: ['subject', 'bodyHtml'],
|
|
365
|
+
entries: [
|
|
366
|
+
{
|
|
367
|
+
businessKey: { templateKey: 'welcome' },
|
|
368
|
+
data: {
|
|
369
|
+
subject: 'Welcome to {{appName}}!',
|
|
370
|
+
bodyHtml: '<p>Welcome aboard.</p>',
|
|
371
|
+
},
|
|
372
|
+
},
|
|
373
|
+
],
|
|
374
|
+
migrators: {
|
|
375
|
+
fromVersion: {
|
|
376
|
+
1: (row) => ({
|
|
377
|
+
...row,
|
|
378
|
+
// v1 stored a plain `body` field; v2 renamed it to `bodyHtml`.
|
|
379
|
+
bodyHtml: typeof row.body === 'string' ? row.body : '',
|
|
380
|
+
}),
|
|
381
|
+
},
|
|
382
|
+
},
|
|
383
|
+
renames: [
|
|
384
|
+
// Authors used to ship the welcome template under `templateKey: 'hello'`.
|
|
385
|
+
// The rename ledger relocates existing rows to the new business-key
|
|
386
|
+
// value before the reconcile loop runs, preserving identity.
|
|
387
|
+
{ field: 'templateKey', from: 'hello', to: 'welcome' },
|
|
388
|
+
],
|
|
389
|
+
});
|
|
390
|
+
|
|
391
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
392
|
+
// Level-B example — ADDITIVE on Organization afterCreate.
|
|
393
|
+
// "When an Organization is created, spawn its default Workspace once."
|
|
394
|
+
// Computed `entry` lets the seed read the triggering row's `_id` and
|
|
395
|
+
// the audit `triggeredByUserId` for attribution. ADDITIVE is safe to
|
|
396
|
+
// re-run: the dispatcher inspects `DataSeedRun` keyed on
|
|
397
|
+
// `(seedKey, scopeKind, relatedId)` and skips on COMPLETED.
|
|
398
|
+
//
|
|
399
|
+
// Note (audit L2-6): although ADDITIVE never DELETES rows or walks
|
|
400
|
+
// orphans, every successful pass DOES re-stamp the declared payload
|
|
401
|
+
// onto matching rows (full payload, not via `managedFields`). Use
|
|
402
|
+
// `UPGRADE` instead when you need version-gated mutation that
|
|
403
|
+
// preserves user customization on non-managed columns.
|
|
404
|
+
// ─────────────────────────────────────────────────────────────────────
|
|
405
|
+
const organizationDefaultWorkspaceSeed = createDataSeedDefinition({
|
|
406
|
+
seedKey: 'tasks-manager:org-default-workspace',
|
|
407
|
+
scope: {
|
|
408
|
+
kind: DataSeedScopeKind.CUSTOM,
|
|
409
|
+
relatedResourceType: 'organization',
|
|
410
|
+
},
|
|
411
|
+
resourceType: 'workspace',
|
|
412
|
+
triggers: [
|
|
413
|
+
{
|
|
414
|
+
triggerKind: DataSeedTriggerKind.RESOURCE_LIFECYCLE,
|
|
415
|
+
resourceType: 'organization',
|
|
416
|
+
phase: DataSeedResourceLifecyclePhase.AFTER_CREATE,
|
|
417
|
+
},
|
|
418
|
+
],
|
|
419
|
+
mode: DataSeedMode.ADDITIVE,
|
|
420
|
+
version: 1,
|
|
421
|
+
// `managedFields` is deliberately OMITTED here — it defaults to `[]`.
|
|
422
|
+
// ADDITIVE re-stamps the FULL declared payload and never consults the
|
|
423
|
+
// list, so naming fields would imply an ownership boundary the
|
|
424
|
+
// dispatcher does not enforce. Declare it only for `UPGRADE` (which
|
|
425
|
+
// DOES project through it, and rejects an empty list) or `SYNC`. See
|
|
426
|
+
// the `DataSeedMode` JSDoc for the full mode-by-mode contract.
|
|
427
|
+
entry: ({ triggeringRow, executionContext }) => ({
|
|
428
|
+
businessKey: { workspaceKey: 'default' },
|
|
429
|
+
data: {
|
|
430
|
+
organizationId: triggeringRow?._id,
|
|
431
|
+
name: 'My Workspace',
|
|
432
|
+
ownerId: executionContext.triggeredByUserId,
|
|
433
|
+
},
|
|
434
|
+
}),
|
|
435
|
+
});
|
|
436
|
+
|
|
437
|
+
export { organizationDefaultWorkspaceSeed, systemEmailTemplatesSeed };
|
|
438
|
+
```
|
|
439
|
+
|
|
440
|
+
What earns its place in this block:
|
|
441
|
+
|
|
442
|
+
- **Stable `seedKey` with module prefix** —
|
|
443
|
+
`'system-emails:welcome'` and
|
|
444
|
+
`'tasks-manager:org-default-workspace'`. The colon segments are
|
|
445
|
+
convention; the dispatcher only requires non-empty.
|
|
446
|
+
- **Explicit `scope`** discriminated by `kind`. Level-A seeds for
|
|
447
|
+
per-application data use `APPLICATION`. Level-B seeds tied to a
|
|
448
|
+
resource row use `CUSTOM` with `relatedResourceType` (here
|
|
449
|
+
`'organization'`), so the dispatcher knows to materialize one
|
|
450
|
+
pass per Organization row.
|
|
451
|
+
- **Mode-appropriate fields**: UPGRADE ships `managedFields` +
|
|
452
|
+
`migrators.fromVersion[1]` + `renames`. ADDITIVE has no
|
|
453
|
+
`managedFields` because the writer bypasses that projection on
|
|
454
|
+
ADDITIVE and re-stamps the full declared payload on every pass;
|
|
455
|
+
it uses a computed `entry` because the triggering row's `_id` is
|
|
456
|
+
the natural input.
|
|
457
|
+
- **Trigger × mode alignment** — UPGRADE on Level-A
|
|
458
|
+
`ON_APP_VERSION_UPGRADE` (allowed); ADDITIVE on Level-B
|
|
459
|
+
`RESOURCE_LIFECYCLE` `AFTER_CREATE` (allowed). Both cells are
|
|
460
|
+
green in the §3.6 matrix.
|
|
461
|
+
- **`renames[]` cross-checked against `entries`** — the rename's
|
|
462
|
+
`field: 'templateKey'` is part of every `entries[*].businessKey`
|
|
463
|
+
(F-10), and `rename.to: 'welcome'` matches a declared business-key
|
|
464
|
+
value (F-3). Both invariants are factory-enforced.
|
|
465
|
+
|
|
466
|
+
What is **not** in this block (and shouldn't be):
|
|
467
|
+
|
|
468
|
+
- No `triggers` declaration on the LAZY case (we don't show LAZY
|
|
469
|
+
here; if shown, `triggers` would be omitted and `lazyAccess`
|
|
470
|
+
would be the SOLE declaration site).
|
|
471
|
+
- No `schedule` block — both examples are non-cron. Cron-driven
|
|
472
|
+
seeds are an operational surface; declaring `schedule?` opts in
|
|
473
|
+
to the engine cron batch
|
|
474
|
+
([`seeding-operations`](../seeding-operations/SKILL.md)
|
|
475
|
+
Decision 1).
|
|
476
|
+
- No inline business-key declaration on the row — the business key
|
|
477
|
+
is declared once on the resource schema (Step 1), then the seed's
|
|
478
|
+
`entries[*].businessKey` references it by shape.
|
|
479
|
+
- No direct `__seed` writes — the dispatcher manages the row-side
|
|
480
|
+
overlay; never write it from app code.
|
|
481
|
+
|
|
482
|
+
## References
|
|
483
|
+
|
|
484
|
+
- `references/framework-data-seeding-api.md` — `DataSeedMode` enum +
|
|
485
|
+
`DataSeedDefinitionInput` interface (the canonical authoring
|
|
486
|
+
surface — what every field means, what's required for each mode)
|
|
487
|
+
- `references/data-seeding-mode-picker.md` — extended decision tree
|
|
488
|
+
for Decision 2 (mode picker) with worked failure modes for each
|
|
489
|
+
mode
|
|
490
|
+
|
|
491
|
+
## Verification
|
|
492
|
+
|
|
493
|
+
- [ ] Resource schema declares `isBusinessKey()` or `businessKeySet([...])`
|
|
494
|
+
- [ ] Seed file default-exports the result of `createDataSeedDefinition({...})`
|
|
495
|
+
- [ ] `seedKey` is stable across deploys (kebab-case segments joined by `:`)
|
|
496
|
+
- [ ] Mode × trigger cell is allowed by the §3.6 matrix
|
|
497
|
+
- [ ] LAZY seeds declare `lazyAccess` and OMIT `triggers`
|
|
498
|
+
- [ ] Non-LAZY seeds declare `triggers[]` (≥1) and OMIT `lazyAccess`
|
|
499
|
+
- [ ] UPGRADE seeds declare non-empty `managedFields[]`
|
|
500
|
+
- [ ] SYNC seeds declare `onOrphan` explicitly
|
|
501
|
+
- [ ] `renames[*].field` is a business-key field on the resource
|
|
502
|
+
- [ ] `renames[*].to` matches a declared `entries[*].businessKey[field]`
|
|
503
|
+
- [ ] Seed surfaced on the module's `BackendDomainModule.seeds?: DataSeedDefinition[]` slot
|
|
504
|
+
(aggregated by `mergeBackendDomainModules` and threaded into the assembly's `dataSeeds`)
|
|
505
|
+
|
|
506
|
+
### Grep invariants
|
|
507
|
+
|
|
508
|
+
Run from the app root, substituting `<module>` and `<seed-key>`:
|
|
509
|
+
|
|
510
|
+
| Invariant | Command |
|
|
511
|
+
|------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
512
|
+
| Seed file uses `createDataSeedDefinition` | `rg -n 'createDataSeedDefinition' backend-api/src/modules/<module>/` |
|
|
513
|
+
| Seed file imports the factory from the focused subpath | `rg -n "from '@wildo-ai/saas-backend-lib/data-seeding-models'" backend-api/src/modules/<module>/` |
|
|
514
|
+
| Seed file does NOT import from the package root | `rg -n "from '@wildo-ai/saas-backend-lib'" backend-api/src/modules/<module>/seeds/` (must be empty for seed files) |
|
|
515
|
+
| Resource schema declares a business key | `rg -n 'isBusinessKey\(\)\|businessKeySet\(' shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts` |
|
|
516
|
+
| Module record wires `seeds` | `rg -n '\bseeds\s*:' backend-api/src/modules/<module>/index.ts` |
|
|
517
|
+
|
|
518
|
+
The high-signal invariants are **"resource schema declares a
|
|
519
|
+
business key"** combined with **"seed file uses
|
|
520
|
+
`createDataSeedDefinition`"** — without the schema marker, the
|
|
521
|
+
factory has nothing to validate `entries[*].businessKey` against,
|
|
522
|
+
and the dispatcher's `findByBusinessKey` lookup at runtime fails
|
|
523
|
+
with an actionable error.
|
|
524
|
+
|
|
525
|
+
## Common Rationalizations
|
|
526
|
+
|
|
527
|
+
| Rationalization | Reality |
|
|
528
|
+
|-----------------|---------|
|
|
529
|
+
| "I'll skip `managedFields` on UPGRADE — there's nothing to manage yet" | Factory rejects: UPGRADE with empty `managedFields` is a no-op write. If the seed currently has nothing to manage, it should be ADDITIVE; switch when ownership emerges. |
|
|
530
|
+
| "I'll declare `triggers` AND `lazyAccess` to be safe" | Factory rejects (Phase 5 audit F-2/F-12/F-18: single declaration site). The auto-injection is the contract; double-declaring just creates divergence surface. |
|
|
531
|
+
| "I'll default `onOrphan: REPORT` for SYNC" | The framework refuses to default destructive policies (D3). Each option (`DELETE` / `DEPRECATE` / `REPORT`) has a different operational blast-radius; the developer must pick deliberately per seed. |
|
|
532
|
+
| "I'll rename the resource field directly without a `renames` entry" | Without the rename ledger, the next pass inserts a duplicate at the new business-key value and orphans the existing row (SYNC) or leaves it unowned (UPGRADE / ADDITIVE). Always ship the ledger entry in the same commit as the value change. |
|
|
533
|
+
| "I don't need `version` to bump for this UPGRADE" | UPGRADE re-applies `managedFields` only when `seedVersion < declared` — without bumping, existing rows skip the upgrade. Bump per material change. |
|
|
534
|
+
|
|
535
|
+
## Red Flags
|
|
536
|
+
|
|
537
|
+
- Resource schema lacks `isBusinessKey()` / `businessKeySet([...])`
|
|
538
|
+
but a seed targets it (factory's structural parse passes; runtime
|
|
539
|
+
lookup fails)
|
|
540
|
+
- LAZY seed declares `triggers` (factory rejects, but if you see
|
|
541
|
+
this in a draft PR — restructure)
|
|
542
|
+
- UPGRADE seed bumps `version` without a corresponding
|
|
543
|
+
`migrators.fromVersion[n]` entry for every persisted version
|
|
544
|
+
(older rows silently skip the schema migration)
|
|
545
|
+
- Business-key value renamed in `entries` with no matching
|
|
546
|
+
`renames[]` entry (next pass duplicates the row at the new key)
|
|
547
|
+
- SYNC seed with `onOrphan: DELETE` and a computed `entry()` whose
|
|
548
|
+
`businessKey` depends on a runtime input (the orphan set might
|
|
549
|
+
include rows you actually want to keep — verify the orphan set
|
|
550
|
+
before merging)
|
|
551
|
+
- Seed declared on a resource with cascade-delete relationships and
|
|
552
|
+
no `onOrphan: REPORT` first pass to confirm the orphan set is
|
|
553
|
+
empty
|
|
554
|
+
- `schedule.cron` declared on a LAZY seed (factory rejects — LAZY's
|
|
555
|
+
contract is "first access creates the row, never re-applied")
|
|
556
|
+
|
|
557
|
+
## Related Skills
|
|
558
|
+
|
|
559
|
+
- [`seeding-operations`](../seeding-operations/SKILL.md) — operate
|
|
560
|
+
the running seeding subsystem (schedule, manual re-run, ledger
|
|
561
|
+
queries, admin endpoint config, boot wiring trace) once a seed
|
|
562
|
+
has been authored
|
|
563
|
+
- `resource-schema-authoring` — declaring `isBusinessKey()` /
|
|
564
|
+
`businessKeySet([...])` on the target resource
|
|
565
|
+
- `backend-addon-wiring` — the `BackendDomainModule.seeds?` slot on
|
|
566
|
+
the module backend record (alongside `operations`, `controllers`,
|
|
567
|
+
`flowsActors`, `dataSeedScopeResolvers`)
|
|
568
|
+
- `module-registration` — module identity parity (shared / frontend
|
|
569
|
+
/ backend) so the seed's module prefix in `seedKey` stays stable
|