@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,59 @@
|
|
|
1
|
+
# saas.data-seeding.admin-endpoints
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Environment variable that holds the secret required to authenticate
|
|
14
|
+
* against the data-seeding admin endpoints. When unset (or empty), every
|
|
15
|
+
* endpoint returns 503 `INFRASTRUCTURE` ("data-seeding admin endpoints
|
|
16
|
+
* disabled"). This is the safe-default — fresh deployments don't
|
|
17
|
+
* accidentally expose the admin surface.
|
|
18
|
+
*/
|
|
19
|
+
export const DataSeedingAdminEndpointEnvKey = 'APPLICATION_ADMIN_SECRET' as const;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* HTTP request header carrying the admin secret. Compared against
|
|
23
|
+
* `process.env[APPLICATION_ADMIN_SECRET]` via a hash-then-compare:
|
|
24
|
+
* both the provided header value and the expected env value are
|
|
25
|
+
* SHA-256 digested first, then compared with `crypto.timingSafeEqual`
|
|
26
|
+
* over the resulting fixed-length 32-byte buffers. Hashing first
|
|
27
|
+
* removes the length-mismatch timing oracle that a raw
|
|
28
|
+
* `timingSafeEqual` over the variable-length secrets would
|
|
29
|
+
* introduce (audit P5/6 L-2). The compare itself remains
|
|
30
|
+
* constant-time, defeating the per-byte timing oracle.
|
|
31
|
+
*/
|
|
32
|
+
export const DataSeedingAdminEndpointHeaderKey = 'X-Admin-Secret' as const;
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Root mount path. Lives under `/internal/...` (NOT `/api/v1/...`) to
|
|
36
|
+
* signal "operator surface, not consumer API" — mirrors the convention
|
|
37
|
+
* used by other root-mounted operational controllers (e.g. `/health`).
|
|
38
|
+
*
|
|
39
|
+
* `/internal/admin/data-seeding/...` — no per-app routing in the URL
|
|
40
|
+
* (P6-C-ARCH=M1: the app process is single-tenant per process).
|
|
41
|
+
*/
|
|
42
|
+
export const DataSeedingAdminEndpointMountBasePath = '/internal/admin/data-seeding' as const;
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Sub-paths exposed by the controller, relative to
|
|
46
|
+
* {@link DataSeedingAdminEndpointMountBasePath}.
|
|
47
|
+
*/
|
|
48
|
+
export const DataSeedingAdminEndpointPath = {
|
|
49
|
+
/** GET — list registered seeds with their `lastRun` summary. */
|
|
50
|
+
SEEDS: '/seeds',
|
|
51
|
+
/** GET — paginated `DataSeedRun` ledger listing with filters. */
|
|
52
|
+
RUNS: '/runs',
|
|
53
|
+
/** POST — invoke `DataSeedDispatcher.runManual`. Returns `DataSeedManualReport`. */
|
|
54
|
+
RERUN: '/rerun',
|
|
55
|
+
} as const;
|
|
56
|
+
|
|
57
|
+
export type DataSeedingAdminEndpointPathValue =
|
|
58
|
+
(typeof DataSeedingAdminEndpointPath)[keyof typeof DataSeedingAdminEndpointPath];
|
|
59
|
+
```
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# saas.data-seeding.bootstrap-wiring
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Inputs to {@link runDataSeedingApplicationBootstrap}. Kept as a typed
|
|
14
|
+
* record (instead of positional args) so callers from different startup
|
|
15
|
+
* orchestrators stay readable when the surface grows in later phases.
|
|
16
|
+
*/
|
|
17
|
+
export interface DataSeedApplicationBootstrapInput {
|
|
18
|
+
/**
|
|
19
|
+
* Declarative seed definitions collected from `BackendDomainModule.seeds`
|
|
20
|
+
* and forwarded by the orchestrator. `undefined` is treated as `[]`
|
|
21
|
+
* (registration still runs to keep the registry's "initialized" semantics
|
|
22
|
+
* consistent across boots).
|
|
23
|
+
*/
|
|
24
|
+
dataSeeds: readonly DataSeedDefinition[] | undefined;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Phase 7 / Item 47 (cron scheduler) — Slice 3.
|
|
28
|
+
*
|
|
29
|
+
* Aggregated `customResolverKey → DataSeedScopeResolver` map collected
|
|
30
|
+
* from `BackendDomainModule.dataSeedScopeResolvers` (cross-module
|
|
31
|
+
* duplicate keys already rejected by `mergeBackendDomainModules`).
|
|
32
|
+
* `undefined` / `{}` is treated identically — a no-op registration
|
|
33
|
+
* that leaves the registry empty so future cron seeds with
|
|
34
|
+
* `iterationStrategy === CUSTOM_RESOLVER` fail loudly at first
|
|
35
|
+
* invocation rather than silently iterating zero rows.
|
|
36
|
+
*/
|
|
37
|
+
dataSeedScopeResolvers?: Readonly<Record<string, DataSeedScopeResolver>>;
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* `true` when the caller is the platform apps-manager (or another
|
|
41
|
+
* profile that bootstraps tenant apps later through their own
|
|
42
|
+
* `StartApplicationBackendService.initialize()` call). Dispatch is
|
|
43
|
+
* skipped in that case — see plan §2.F.
|
|
44
|
+
*/
|
|
45
|
+
isPlatformMode: boolean;
|
|
46
|
+
|
|
47
|
+
logger: LoggerService;
|
|
48
|
+
/** Used to log Step 7.7 progress under the same channel as the host service. */
|
|
49
|
+
logDebug: (message: string, context?: Record<string, unknown>) => void;
|
|
50
|
+
|
|
51
|
+
registry: DataSeedRegistryBackendService;
|
|
52
|
+
/**
|
|
53
|
+
* Phase 7 / Item 47 — Slice 3. Hydrated from
|
|
54
|
+
* {@link DataSeedApplicationBootstrapInput.dataSeedScopeResolvers}
|
|
55
|
+
* BEFORE Level-A dispatch / Level-B + LAZY hook wiring (registration
|
|
56
|
+
* is dispatch-independent — keeping it before the platform-mode
|
|
57
|
+
* skip ensures both the platform process AND tenant boots see the
|
|
58
|
+
* same registry state).
|
|
59
|
+
*/
|
|
60
|
+
scopeResolverRegistry: DataSeedScopeResolverRegistryBackendService;
|
|
61
|
+
dispatcher: DataSeedDispatcherBackendService;
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Required for Level-B auto-wiring (Phase 3, plan decision P3-B=B1).
|
|
65
|
+
* After registering seeds, the bootstrap walks the registry and
|
|
66
|
+
* registers pre/post-operation hooks on this services registry so
|
|
67
|
+
* that any resource-lifecycle trigger (`beforeCreate`/`afterCreate`/
|
|
68
|
+
* `beforeUpdate`/`afterUpdate`/`beforeDelete`/`afterDelete`) fires
|
|
69
|
+
* the dispatcher's `runResourceLifecycle` when the matching
|
|
70
|
+
* operation runs.
|
|
71
|
+
*/
|
|
72
|
+
servicesRegistry: ServicesRegistryHandlerBackendService;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Step 7.7 — register the seed corpus and (outside platform mode) dispatch
|
|
77
|
+
* the application-lifecycle passes (`onAppInit` then `onAppVersionUpgrade`).
|
|
78
|
+
*
|
|
79
|
+
* Contract:
|
|
80
|
+
* - Registration ALWAYS runs (even in platform mode) so future Level-B
|
|
81
|
+
* and lazy-access dispatch paths can resolve seed declarations.
|
|
82
|
+
* - Dispatcher is invoked twice in order: `onAppInit` MUST precede
|
|
83
|
+
* `onAppVersionUpgrade` because the upgrade pass may mutate rows
|
|
84
|
+
* created by the init pass.
|
|
85
|
+
* - Any throw from the dispatcher is rethrown unchanged. Booting with
|
|
86
|
+
* a half-applied seed corpus would silently break downstream ops, so
|
|
87
|
+
* the dispatcher's FAILED `DataSeedRun` ledger entries (which the
|
|
88
|
+
* next boot retries) are the intended recovery surface — not a try/
|
|
89
|
+
* catch here.
|
|
90
|
+
*
|
|
91
|
+
* Operational invariants (operator-facing):
|
|
92
|
+
* 1. Seed registry hydrated unconditionally (platform mode + tenant boot)
|
|
93
|
+
* so Level-B + LAZY hooks can resolve declarations regardless of who
|
|
94
|
+
* runs the Level-A pass.
|
|
95
|
+
* 2. Custom-resolver registry hydrated next (Item 47 / Slice 3) — empty
|
|
96
|
+
* map is a no-op call, so any future cron seed declaring
|
|
97
|
+
* `iterationStrategy === CUSTOM_RESOLVER` against an unregistered key
|
|
98
|
+
* fails loudly at first invocation rather than silently iterating
|
|
99
|
+
* zero rows.
|
|
100
|
+
* 3. Level-B hooks wired BEFORE Level-A dispatch (P3-B=B1) — per-tenant
|
|
101
|
+
* resource-lifecycle seeds must be live before any boot pass, so
|
|
102
|
+
* cross-tenant boots see consistent hook state.
|
|
103
|
+
* 4. LAZY guards wired symmetric with Level-B (P5-D=D1) — pre-only
|
|
104
|
+
* hooks per `(resourceType, operation)` pair, coalesced to one hook
|
|
105
|
+
* per resource type with internal route map.
|
|
106
|
+
* 5. Platform-mode skip: dispatch is suppressed for the apps-manager
|
|
107
|
+
* profile (it bootstraps tenant apps which run their own pass).
|
|
108
|
+
*/
|
|
109
|
+
export async function runDataSeedingApplicationBootstrap(
|
|
110
|
+
input: DataSeedApplicationBootstrapInput,
|
|
111
|
+
): Promise<void> {
|
|
112
|
+
const {
|
|
113
|
+
dataSeeds,
|
|
114
|
+
dataSeedScopeResolvers,
|
|
115
|
+
isPlatformMode,
|
|
116
|
+
logger,
|
|
117
|
+
logDebug,
|
|
118
|
+
registry,
|
|
119
|
+
scopeResolverRegistry,
|
|
120
|
+
dispatcher,
|
|
121
|
+
servicesRegistry,
|
|
122
|
+
} = input;
|
|
123
|
+
|
|
124
|
+
const seeds = dataSeeds ?? [];
|
|
125
|
+
logDebug('🌱 Registering data-seed definitions...', { count: seeds.length });
|
|
126
|
+
registry.registerSeeds(seeds);
|
|
127
|
+
logDebug('✅ Data-seed registry populated');
|
|
128
|
+
|
|
129
|
+
// Phase 7 / Item 47 — Slice 3 — register custom-resolver scope iterators.
|
|
130
|
+
// Runs unconditionally (even in platform mode + when the map is empty)
|
|
131
|
+
// so the registry's lifecycle is symmetric with `DataSeedRegistry`'s
|
|
132
|
+
// (always-initialized at boot). The empty-map case is a no-op call
|
|
133
|
+
// that registers zero entries; future cron seeds (Slice 5) probing
|
|
134
|
+
// the registry via `hasResolver` get a clean `false` instead of a
|
|
135
|
+
// "registry not initialized" error.
|
|
136
|
+
const resolversMap = dataSeedScopeResolvers ?? {};
|
|
137
|
+
const resolverCount = Object.keys(resolversMap).length;
|
|
138
|
+
logDebug('🌱 Registering data-seed scope resolvers...', { count: resolverCount });
|
|
139
|
+
scopeResolverRegistry.registerResolvers(resolversMap);
|
|
140
|
+
logDebug('✅ Data-seed scope-resolver registry populated', { count: resolverCount });
|
|
141
|
+
|
|
142
|
+
// Phase 3 (P3-B=B1) — auto-wire Level-B hooks into the services
|
|
143
|
+
// registry. Runs BEFORE the Level-A dispatch (and in platform mode
|
|
144
|
+
// too) so Level-B seeds fire on per-tenant resource lifecycle events
|
|
145
|
+
// regardless of who runs the Level-A pass.
|
|
146
|
+
wireLevelBResourceLifecycleHooks({ registry, dispatcher, servicesRegistry, logDebug });
|
|
147
|
+
|
|
148
|
+
// Phase 5 (P5-D=D1) — auto-wire LAZY-access guards into the services
|
|
149
|
+
// registry. Symmetric with Level-B wiring (registers pre-operation
|
|
150
|
+
// hooks per `(resourceType, operation)` pair declared by LAZY
|
|
151
|
+
// seeds). Runs BEFORE the Level-A dispatch (and in platform mode
|
|
152
|
+
// too — same rationale as the Level-B wiring above: lazy guards
|
|
153
|
+
// are per-tenant request hooks, the host running the Level-A pass
|
|
154
|
+
// is irrelevant to their availability at request time).
|
|
155
|
+
wireLazyAccessGuards({ registry, dispatcher, servicesRegistry, logDebug });
|
|
156
|
+
|
|
157
|
+
if (isPlatformMode) {
|
|
158
|
+
logDebug('🌱 Skipping application-lifecycle data-seed dispatch in platform mode (tenant apps will run their own pass via apps-manager)');
|
|
159
|
+
return;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
logger.info('🌱 Running application-lifecycle data seeds (onAppInit + onAppVersionUpgrade)...');
|
|
163
|
+
try {
|
|
164
|
+
const initReport = await dispatcher.runApplicationLifecycle('onAppInit');
|
|
165
|
+
logDebug('✅ onAppInit data-seed pass complete', {
|
|
166
|
+
seedsProcessed: initReport.seedsProcessed,
|
|
167
|
+
completed: initReport.runs.filter((r) => r.status === DataSeedRunStatus.COMPLETED).length,
|
|
168
|
+
partial: initReport.runs.filter((r) => r.status === DataSeedRunStatus.PARTIAL).length,
|
|
169
|
+
failed: initReport.runs.filter((r) => r.status === DataSeedRunStatus.FAILED).length,
|
|
170
|
+
});
|
|
171
|
+
|
|
172
|
+
const upgradeReport = await dispatcher.runApplicationLifecycle('onAppVersionUpgrade');
|
|
173
|
+
logDebug('✅ onAppVersionUpgrade data-seed pass complete', {
|
|
174
|
+
seedsProcessed: upgradeReport.seedsProcessed,
|
|
175
|
+
completed: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.COMPLETED).length,
|
|
176
|
+
partial: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.PARTIAL).length,
|
|
177
|
+
failed: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.FAILED).length,
|
|
178
|
+
});
|
|
179
|
+
} catch (error) {
|
|
180
|
+
logger.error('❌ Data-seed application-lifecycle pass failed (fatal):', error);
|
|
181
|
+
throw error;
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
```
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# saas.data-seeding.definition-input
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Authoring-time input shape passed to {@link createDataSeedDefinition}.
|
|
14
|
+
* Adds the function-typed fields that Zod cannot validate — they are
|
|
15
|
+
* passed through verbatim by the factory.
|
|
16
|
+
*
|
|
17
|
+
* `triggers` is optional only for LAZY seeds: the factory derives one trigger
|
|
18
|
+
* from `lazyAccess`. Non-LAZY seeds must declare their trigger explicitly so
|
|
19
|
+
* startup never guesses when a mutation is admissible.
|
|
20
|
+
*
|
|
21
|
+
* Required-vs-optional summary (cross-mode):
|
|
22
|
+
*
|
|
23
|
+
* - `seedKey`, `scope`, `resourceType`, `mode`, `version` — always required.
|
|
24
|
+
* - `entries` xor `entry` — exactly one (static array vs computed
|
|
25
|
+
* function). Computed `entry` requires at least one Level-B trigger.
|
|
26
|
+
* - `managedFields` — OPTIONAL to write; defaults to `[]`. Required
|
|
27
|
+
* non-empty for `UPGRADE` (the factory rejects an empty list, whether
|
|
28
|
+
* you wrote it or inherited the default), recommended for `SYNC`.
|
|
29
|
+
* OMIT it for `ADDITIVE` and `LAZY`: those modes never consult the
|
|
30
|
+
* list — `ADDITIVE` re-stamps the FULL declared payload on every pass,
|
|
31
|
+
* bypassing the projection entirely — so writing `managedFields: []`
|
|
32
|
+
* there is noise that implies an ownership boundary the dispatcher
|
|
33
|
+
* does not enforce.
|
|
34
|
+
* - `triggers` — required for non-LAZY modes (≥1 trigger), MUST be
|
|
35
|
+
* omitted for LAZY (factory auto-injects from `lazyAccess`).
|
|
36
|
+
* - `lazyAccess` — required for LAZY, FORBIDDEN otherwise.
|
|
37
|
+
* - `onOrphan` — required for SYNC, forbidden otherwise.
|
|
38
|
+
* - `renames` — optional rename ledger; each `rename.field` MUST be a
|
|
39
|
+
* business-key field and `rename.to` MUST appear as a declared
|
|
40
|
+
* business-key value (F-3 + F-10).
|
|
41
|
+
* - `migrators` — optional per-version migrator map for UPGRADE; the
|
|
42
|
+
* dispatcher walks `fromVersion` from the persisted row's
|
|
43
|
+
* `seedVersion` up to `version - 1`, then re-applies
|
|
44
|
+
* `managedFields` from the declared entries.
|
|
45
|
+
* - `dependsOn` — optional cross-seed dependency declarations (DAG
|
|
46
|
+
* resolved at dispatch time).
|
|
47
|
+
* - `schedule` — optional cron-driven re-run binding; presence is the
|
|
48
|
+
* sole opt-in signal for the engine cron batch. FORBIDDEN for
|
|
49
|
+
* `mode === LAZY`.
|
|
50
|
+
*/
|
|
51
|
+
export interface DataSeedDefinitionInput extends DataSeedDefinitionAuthored, DataSeedDefinitionCallbacks {}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* The two function-typed fields Zod cannot model or validate. The factory
|
|
55
|
+
* captures them before the structural parse and re-attaches them to its result
|
|
56
|
+
* verbatim, so they appear identically on the authoring and runtime shapes.
|
|
57
|
+
*/
|
|
58
|
+
export interface DataSeedDefinitionCallbacks {
|
|
59
|
+
/**
|
|
60
|
+
* Computed entry generator (mutually exclusive with `entries`). Typical
|
|
61
|
+
* for Level-B seeds that need data from the triggering row
|
|
62
|
+
* (`afterCreate` of an Organization → spawn its default Workspace).
|
|
63
|
+
*/
|
|
64
|
+
entry?: DataSeedComputedEntryFn;
|
|
65
|
+
/**
|
|
66
|
+
* Per-version migrators applied sequentially from the persisted row's
|
|
67
|
+
* recorded `seedVersion` up to `version - 1`. After all applicable
|
|
68
|
+
* migrators run the dispatcher then re-applies the declared
|
|
69
|
+
* `managedFields` from the seed entries.
|
|
70
|
+
*/
|
|
71
|
+
migrators?: {
|
|
72
|
+
fromVersion: Record<number, DataSeedMigratorFn>;
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Runtime shape returned by {@link createDataSeedDefinition} and consumed
|
|
78
|
+
* by the registry / dispatcher.
|
|
79
|
+
*
|
|
80
|
+
* This is built on the PARSED (output) shape, not on
|
|
81
|
+
* {@link DataSeedDefinitionInput}, and the difference is load-bearing: every
|
|
82
|
+
* defaulted field is guaranteed present here because the factory returns the
|
|
83
|
+
* parser's result. Dispatcher and registry consumers can therefore read
|
|
84
|
+
* `seed.managedFields` as a plain `string[]` — no `?? []` guard — even when the
|
|
85
|
+
* author omitted it.
|
|
86
|
+
*
|
|
87
|
+
* `triggers` is additionally narrowed to GUARANTEED non-empty: the LAZY branch
|
|
88
|
+
* is auto-populated by the factory and every other branch enforces explicit
|
|
89
|
+
* declaration, so consumers can call `seed.triggers.some(...)` without a
|
|
90
|
+
* defensive guard.
|
|
91
|
+
*/
|
|
92
|
+
export interface DataSeedDefinition extends DataSeedDefinitionParsed, DataSeedDefinitionCallbacks {
|
|
93
|
+
triggers: DataSeedTrigger[];
|
|
94
|
+
}
|
|
95
|
+
```
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# saas.data-seeding.modes
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* The four data-seeding modes — the **mode picker** is the single most
|
|
14
|
+
* consequential authoring decision for a `DataSeedDefinition`. Each mode
|
|
15
|
+
* has different write semantics and re-run safety. Pick by answering
|
|
16
|
+
* "what should happen on the SECOND pass?":
|
|
17
|
+
*
|
|
18
|
+
* - **`LAZY`** — "create on first access, never touch again". Deferred
|
|
19
|
+
* materialization, per-scope idempotency cache. Cannot combine with
|
|
20
|
+
* `schedule?` (periodic re-run contradicts the contract). Write path
|
|
21
|
+
* bypasses the operation pipeline (no hook re-entry from the seed's
|
|
22
|
+
* own write).
|
|
23
|
+
* - **`ADDITIVE`** — "insert if business key absent; on present rows,
|
|
24
|
+
* re-apply the entry's `data` payload via `upsertByBusinessKey`'s
|
|
25
|
+
* `$set` semantics (no managed-fields gating, no version comparison)".
|
|
26
|
+
* Operationally additive — the dispatcher never deletes rows or
|
|
27
|
+
* walks orphans for ADDITIVE — but each pass DOES re-stamp the
|
|
28
|
+
* declared payload on every existing row. Use `UPGRADE` instead when
|
|
29
|
+
* you need explicit version-gated mutation with `managedFields`
|
|
30
|
+
* protecting user customization on non-managed columns. Do not describe
|
|
31
|
+
* ADDITIVE as immutable for existing rows: its `upsertByBusinessKey`
|
|
32
|
+
* behavior intentionally reapplies the declared payload.
|
|
33
|
+
* - **`UPGRADE`** — "insert missing; on present rows whose
|
|
34
|
+
* `seedVersion < declared`, migrate via declared `migrators` and
|
|
35
|
+
* re-apply `managedFields`". Requires non-empty `managedFields`
|
|
36
|
+
* (otherwise the upgrade has nothing to write). Preserves user
|
|
37
|
+
* customization on non-managed fields.
|
|
38
|
+
* - **`SYNC`** — "declared set is source of truth: insert missing,
|
|
39
|
+
* update changed managed fields, handle orphans per `onOrphan`".
|
|
40
|
+
* Requires explicit `onOrphan` policy (D3 — destructive semantics
|
|
41
|
+
* must be declared, never defaulted). The most aggressive mode;
|
|
42
|
+
* reserve for closed enums materialized as rows.
|
|
43
|
+
*
|
|
44
|
+
* Rejected alternatives:
|
|
45
|
+
* - `REPLACE` (full overwrite of every field on every run) — hostile
|
|
46
|
+
* to user customization. `SYNC` with managed-fields semantics covers
|
|
47
|
+
* the same intent safely.
|
|
48
|
+
*/
|
|
49
|
+
export enum DataSeedMode {
|
|
50
|
+
/** Create on first read/access if missing (per scope). Always re-run safe. */
|
|
51
|
+
LAZY = 'lazy',
|
|
52
|
+
/**
|
|
53
|
+
* Insert if business key absent; on present rows, re-apply the
|
|
54
|
+
* declared `entry.data` payload via `upsertByBusinessKey` (`$set`
|
|
55
|
+
* semantics, no managed-fields gating, no version comparison).
|
|
56
|
+
* Operationally additive at the row-set level (no delete, no orphan
|
|
57
|
+
* walk) but NOT immutable per row — see schema-level mode JSDoc
|
|
58
|
+
* (audit L2-6) for the full contract.
|
|
59
|
+
*/
|
|
60
|
+
ADDITIVE = 'additive',
|
|
61
|
+
/**
|
|
62
|
+
* Insert if absent; if present and `seedVersion < declared` → migrate via
|
|
63
|
+
* declared migrators (or replace declared-managed fields).
|
|
64
|
+
*/
|
|
65
|
+
UPGRADE = 'upgrade',
|
|
66
|
+
/**
|
|
67
|
+
* Full reconciliation: declared set becomes source of truth. Insert missing,
|
|
68
|
+
* update changed, optionally delete orphans (controlled by `onOrphan`).
|
|
69
|
+
*/
|
|
70
|
+
SYNC = 'sync',
|
|
71
|
+
}
|
|
72
|
+
```
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
# saas.data-seeding.run-ledger
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Persistence shape for a single dispatcher pass.
|
|
14
|
+
*
|
|
15
|
+
* **Authority model** (see plan §3.7 + D4): the seed code itself ALWAYS
|
|
16
|
+
* runs as `INTERNALLY_INITIATED_REQUEST` with super-admin roles, identical
|
|
17
|
+
* to a batch. The `triggeredByUserId` field is **metadata for audit
|
|
18
|
+
* attribution**, not authority — it merely records which user's action
|
|
19
|
+
* caused the dispatcher to fire (e.g. the user whose first LIST call
|
|
20
|
+
* triggered a lazy seed, or the admin who hit the manual re-run button).
|
|
21
|
+
*
|
|
22
|
+
* **Idempotency contract**: the composite business key
|
|
23
|
+
* `(seedKey, scopeKind, relatedResourceType, relatedId, seedVersion)`
|
|
24
|
+
* uniquely identifies a pass. The dispatcher uses `upsertByBusinessKey`
|
|
25
|
+
* to either create a fresh `running` row or recover a previous attempt's
|
|
26
|
+
* row before writing the terminal outcome. `relatedId` is `null` for
|
|
27
|
+
* `scopeKind: 'global'` (the only kind without a per-row anchor).
|
|
28
|
+
* `relatedResourceType` is `null` for the four built-in scope kinds and
|
|
29
|
+
* the resource-type identifier (e.g. `'Workspace'`) for `'custom'`.
|
|
30
|
+
*/
|
|
31
|
+
export const DataSeedRunSchema = z.object({
|
|
32
|
+
/**
|
|
33
|
+
* MongoDB document ID — auto-generated. Marked `.isPrimaryKey()` so
|
|
34
|
+
* framework introspection utilities (`getPrimaryKeyField()`, the
|
|
35
|
+
* ZodToMongoose convertor, etc.) recognize it the same way they
|
|
36
|
+
* recognize `_id` on every other resource. Required by plan §3.7 +
|
|
37
|
+
* §5 Phase 2.A.2.
|
|
38
|
+
*/
|
|
39
|
+
_id: z.string().isPrimaryKey(),
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
// === Seed identity ===
|
|
43
|
+
/** Stable seed identifier (matches `DataSeedDefinition.seedKey`). */
|
|
44
|
+
seedKey: z.string().min(1).isDBIndexed(),
|
|
45
|
+
/**
|
|
46
|
+
* Declaration version at the time of this pass. Bumping the declaration's
|
|
47
|
+
* `version` is the developer's signal to re-run; the dispatcher answers by
|
|
48
|
+
* comparing the `MAX(seedVersion)` of completed rows for this scope to the
|
|
49
|
+
* declared version (see plan §3.7 skip-rule matrix).
|
|
50
|
+
*/
|
|
51
|
+
seedVersion: z.number().int().nonnegative(),
|
|
52
|
+
/**
|
|
53
|
+
* Reconciliation mode of the pass (mirror of `DataSeedDefinition.mode`).
|
|
54
|
+
*
|
|
55
|
+
* Phase 4.A.18 / P4-G (G1): persisting `mode` here lets back-office
|
|
56
|
+
* dashboards filter by engine ("show every UPGRADE pass that produced
|
|
57
|
+
* PARTIAL", "every SYNC pass that deprecated > 0 rows") without joining
|
|
58
|
+
* back to the in-memory `DataSeedRegistry`. Indexed for that reason.
|
|
59
|
+
*
|
|
60
|
+
* NOT part of the business key — flipping a declaration from ADDITIVE
|
|
61
|
+
* to UPGRADE between deploys must NOT duplicate the ledger entry for
|
|
62
|
+
* the same `(seedKey, scope, version)` triple, otherwise the dispatcher
|
|
63
|
+
* would silently re-run the same pass under a different mode label.
|
|
64
|
+
*/
|
|
65
|
+
mode: z.enum(DataSeedMode).isDBIndexed(),
|
|
66
|
+
|
|
67
|
+
// === Scope ===
|
|
68
|
+
/** Which scope kind this run materializes (mirror of the declaration). */
|
|
69
|
+
scopeKind: z.enum(DataSeedScopeKind).isDBIndexed(),
|
|
70
|
+
/**
|
|
71
|
+
* For `scopeKind: 'custom'` — the resource type whose row anchors the
|
|
72
|
+
* scope. `null` for the four built-in scope kinds (their resource is
|
|
73
|
+
* implicit — APPLICATION/ORGANIZATION/USER/GLOBAL).
|
|
74
|
+
*
|
|
75
|
+
* Part of the business key (see schema-level JSDoc / F-4) so two
|
|
76
|
+
* `CUSTOM` seeds whose `relatedId` happens to collide across
|
|
77
|
+
* different resource types still get distinct ledger rows. Indexed
|
|
78
|
+
* to keep the compound index column-aligned with the business-key
|
|
79
|
+
* order.
|
|
80
|
+
*/
|
|
81
|
+
relatedResourceType: z.string().nullable().isDBIndexed(),
|
|
82
|
+
/**
|
|
83
|
+
* `_id` of the scope-defining row. `null` only for `scopeKind: 'global'`
|
|
84
|
+
* (database-wide, no anchor row).
|
|
85
|
+
*/
|
|
86
|
+
relatedId: z.string().nullable().isDBIndexed(),
|
|
87
|
+
|
|
88
|
+
// === Trigger context (audit / debugging only — see authority model above) ===
|
|
89
|
+
/** Which trigger fired this run. Verbatim copy of the declaration's trigger. */
|
|
90
|
+
trigger: DataSeedTriggerSchema,
|
|
91
|
+
/**
|
|
92
|
+
* Coarse classification of the trigger origin. Persisted alongside
|
|
93
|
+
* `trigger` for filtering / dashboarding without parsing the discriminated
|
|
94
|
+
* union (e.g. "show me every lazy-access run for org X this week").
|
|
95
|
+
*/
|
|
96
|
+
triggerOrigin: z.enum(DataSeedTriggerOrigin).isDBIndexed(),
|
|
97
|
+
/**
|
|
98
|
+
* The user whose action caused the dispatcher to fire (lazy access,
|
|
99
|
+
* manual re-run, resource-lifecycle write that triggered a Level-B
|
|
100
|
+
* seed). `null` for framework-initiated passes (`onAppInit`,
|
|
101
|
+
* `onAppVersionUpgrade`, `onScheduledRefresh`).
|
|
102
|
+
*/
|
|
103
|
+
triggeredByUserId: z.string().nullable(),
|
|
104
|
+
|
|
105
|
+
// === Outcome ===
|
|
106
|
+
status: z.enum(DataSeedRunStatus).isDBIndexed(),
|
|
107
|
+
startedAt: z.date(),
|
|
108
|
+
/** `null` while `status === RUNNING`; set on every terminal transition. */
|
|
109
|
+
finishedAt: z.date().nullable(),
|
|
110
|
+
|
|
111
|
+
// === Counters (always populated, even on FAILED runs — zeros if pass aborted before entry loop) ===
|
|
112
|
+
//
|
|
113
|
+
// Phase 4 / P4-E (E1) widened the counter set with engine-specific
|
|
114
|
+
// outcomes so dashboards stay legible across mode boundaries — every
|
|
115
|
+
// counter has exactly one meaning regardless of `mode`.
|
|
116
|
+
//
|
|
117
|
+
// Counter conventions:
|
|
118
|
+
// - `entriesAttempted` — total *declared* entries (i.e. the contents
|
|
119
|
+
// of `seed.entries[]` for the pass) the dispatcher iterated over.
|
|
120
|
+
// This counter is incremented exactly once per declared entry,
|
|
121
|
+
// BEFORE the per-entry try/catch, so it always equals the declared
|
|
122
|
+
// set size regardless of insert / update / upgrade / skip / fail
|
|
123
|
+
// outcome. Renames (`seed.renames[]`) and SYNC orphan handling
|
|
124
|
+
// (`onOrphan` policy) are NOT included — they have their own
|
|
125
|
+
// dedicated counters (`entriesRenamed`, `entriesDeleted`,
|
|
126
|
+
// `entriesDeprecated`, `entriesReportedOrphans`). The intent is
|
|
127
|
+
// that `entriesAttempted == seed.entries.length` for any
|
|
128
|
+
// well-formed pass, so dashboards can spot config drift at a
|
|
129
|
+
// glance (F-8 / F-15).
|
|
130
|
+
// - `entriesInserted` — declared entries written via the insert path
|
|
131
|
+
// (row absent → upsert created it). Applies to ADDITIVE / UPGRADE / SYNC.
|
|
132
|
+
// - `entriesUpdated` — declared entries whose row was present at
|
|
133
|
+
// pass time and got the declared `entry.data` payload re-stamped
|
|
134
|
+
// via `upsertByBusinessKey`'s `$set` semantics. Used by ADDITIVE
|
|
135
|
+
// on every present row (mode contract is "operationally additive
|
|
136
|
+
// at row-set level, payload re-applied per pass" — audit L2-6,
|
|
137
|
+
// post-Phase-7 close-out). UPGRADE / SYNC use `entriesUpgraded` /
|
|
138
|
+
// `entriesInserted` / `entriesDeprecated` / `entriesDeleted`
|
|
139
|
+
// instead — the present-but-unchanged ADDITIVE row IS what this
|
|
140
|
+
// counter measures.
|
|
141
|
+
// - `entriesUpgraded` — declared entries that received a real version
|
|
142
|
+
// migration in `mode: UPGRADE` (persisted version < declared version,
|
|
143
|
+
// migrators walked, managed fields re-applied). Phase 4.A.
|
|
144
|
+
// - `entriesRenamed` — declared entries whose row was relocated from a
|
|
145
|
+
// prior business-key value via `seed.renames[]`. Phase 4.A.
|
|
146
|
+
// - `entriesSkipped` — entries the dispatcher chose not to write
|
|
147
|
+
// (already-at-version, downgrade-attempt with B1 skip-with-warn,
|
|
148
|
+
// user-customized when A2/A3 ever land). Reasons surface in logs +
|
|
149
|
+
// future per-row report; this counter just tallies them.
|
|
150
|
+
// - `entriesDeleted` — orphan rows hard-deleted by `mode: SYNC` with
|
|
151
|
+
// `onOrphan: 'delete'`. Phase 4.B.
|
|
152
|
+
// - `entriesDeprecated` — orphan rows marked deprecated (nested
|
|
153
|
+
// `__seed.deprecated`) by `mode: SYNC` with `onOrphan: 'deprecate'`.
|
|
154
|
+
// Phase 4.B / P4-C (C1).
|
|
155
|
+
// - `entriesReportedOrphans` — orphan rows surfaced into
|
|
156
|
+
// `failureReport.orphans[]` by `mode: SYNC` with `onOrphan: 'report'`
|
|
157
|
+
// (no row mutation). Phase 4.B.
|
|
158
|
+
// - `entriesFailed` — entries whose write threw (entry-scoped failure;
|
|
159
|
+
// pass continues with PARTIAL outcome). Includes per-orphan write
|
|
160
|
+
// failures for SYNC.
|
|
161
|
+
entriesAttempted: z.number().int().nonnegative().default(0),
|
|
162
|
+
entriesInserted: z.number().int().nonnegative().default(0),
|
|
163
|
+
entriesUpdated: z.number().int().nonnegative().default(0),
|
|
164
|
+
entriesUpgraded: z.number().int().nonnegative().default(0),
|
|
165
|
+
entriesRenamed: z.number().int().nonnegative().default(0),
|
|
166
|
+
entriesSkipped: z.number().int().nonnegative().default(0),
|
|
167
|
+
entriesDeleted: z.number().int().nonnegative().default(0),
|
|
168
|
+
entriesDeprecated: z.number().int().nonnegative().default(0),
|
|
169
|
+
entriesReportedOrphans: z.number().int().nonnegative().default(0),
|
|
170
|
+
entriesFailed: z.number().int().nonnegative().default(0),
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* Structured failure breakdown. `null` for `COMPLETED` runs; populated
|
|
174
|
+
* for `PARTIAL` (entry-level errors only) and `FAILED` (entry-level
|
|
175
|
+
* errors and/or `passLevelError`).
|
|
176
|
+
*/
|
|
177
|
+
failureReport: DataSeedFailureReportSchema.nullable(),
|
|
178
|
+
})
|
|
179
|
+
/**
|
|
180
|
+
* Composite business key declares the natural identity of a pass and
|
|
181
|
+
* doubles as the basis for the critical compound index
|
|
182
|
+
* `{ seedKey:1, scopeKind:1, relatedResourceType:1, relatedId:1, seedVersion:1 }`.
|
|
183
|
+
* The `findByBusinessKey` / `upsertByBusinessKey` methods that Phase 2
|
|
184
|
+
* lands on the repository base will derive their Mongo filter from this
|
|
185
|
+
* exact key list, so changing it ALSO changes the dispatcher's
|
|
186
|
+
* idempotency contract — handle with care.
|
|
187
|
+
*
|
|
188
|
+
* `relatedResourceType` placement: kept BEFORE `relatedId` so the
|
|
189
|
+
* compound index supports prefix lookups by `(seedKey, scopeKind,
|
|
190
|
+
* relatedResourceType)` (e.g. "every CUSTOM run for `Workspace`")
|
|
191
|
+
* without requiring `relatedId` in the predicate. Built-in scope
|
|
192
|
+
* kinds have `relatedResourceType: null`, which the index handles
|
|
193
|
+
* uniformly (Mongo treats `null` as a valid index entry).
|
|
194
|
+
*/
|
|
195
|
+
.businessKeySet(['seedKey', 'scopeKind', 'relatedResourceType', 'relatedId', 'seedVersion']);
|
|
196
|
+
|
|
197
|
+
export type DataSeedRun = z.infer<typeof DataSeedRunSchema>;
|
|
198
|
+
```
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# saas.data-seeding.run-status
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Outcome classification for a {@link DataSeedRunSchema} row.
|
|
14
|
+
*
|
|
15
|
+
* - `RUNNING` — pass started, no terminal outcome yet. Crash recovery
|
|
16
|
+
* is handled at the START of the next dispatcher pass via
|
|
17
|
+
* `startDataSeedRun`'s `findByBusinessKey` recover branch (audit
|
|
18
|
+
* L2-1): if the prior `RUNNING` row is found for the same business
|
|
19
|
+
* key it is immediately superseded by a fresh `RUNNING` row. There
|
|
20
|
+
* is NO heartbeat / startup-window timeout — recovery is purely
|
|
21
|
+
* "next pass wins". (The pre-Phase-7 JSDoc that mentioned a
|
|
22
|
+
* "startup window" was aspirational; this fix realigns the JSDoc
|
|
23
|
+
* with the implemented behavior — L4-9, post-Phase-7 close-out.)
|
|
24
|
+
* - `COMPLETED` — every entry succeeded.
|
|
25
|
+
* - `PARTIAL` — at least one entry failed but the pass did not abort
|
|
26
|
+
* (collect-and-report behavior, per resolved D10).
|
|
27
|
+
* - `FAILED` — the pass threw before reaching its terminal phase.
|
|
28
|
+
*/
|
|
29
|
+
export enum DataSeedRunStatus {
|
|
30
|
+
RUNNING = 'running',
|
|
31
|
+
COMPLETED = 'completed',
|
|
32
|
+
PARTIAL = 'partial',
|
|
33
|
+
FAILED = 'failed',
|
|
34
|
+
}
|
|
35
|
+
```
|