@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
package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md
ADDED
|
@@ -0,0 +1,662 @@
|
|
|
1
|
+
# Data seeding — operational contract (source)
|
|
2
|
+
|
|
3
|
+
The six source-anchored surfaces an operator (or author of a
|
|
4
|
+
cron-eligible seed) touches when working with the runtime side of
|
|
5
|
+
the data-seeding subsystem:
|
|
6
|
+
|
|
7
|
+
- **`DataSeedScheduleSchema`** + **`DataSeedScopeIterationStrategy`**
|
|
8
|
+
— the per-seed cron block and the iteration strategy that
|
|
9
|
+
determines per-tick fan-out (Decision 1).
|
|
10
|
+
- **`DataSeedingAdminEndpoint*` constants** — the public path /
|
|
11
|
+
header / env-key contract for the admin controller (Decisions
|
|
12
|
+
2–4); these are the only stable identifiers external consumers
|
|
13
|
+
(operator runbooks, k8s `CronJob`, future back-office UI) should
|
|
14
|
+
reference.
|
|
15
|
+
- **`DataSeedRunSchema`** + **`DataSeedRunStatus`** — the persisted
|
|
16
|
+
ledger of every seed pass (Decision 3) plus its terminal-status
|
|
17
|
+
enum.
|
|
18
|
+
- **`runDataSeedingApplicationBootstrap`** — the single entry
|
|
19
|
+
point that wires registries, Level-B hooks, LAZY guards, and the
|
|
20
|
+
Level-A dispatch passes at app startup (Decision 5).
|
|
21
|
+
|
|
22
|
+
The cron schedule and iteration strategy are exported through the declared
|
|
23
|
+
`@wildo-ai/saas-backend-lib/data-seeding-models` entrypoint. The remaining
|
|
24
|
+
contracts below are delivered to this skill as source-backed references. Do not
|
|
25
|
+
invent an undeclared package subpath for an admin endpoint or bootstrap detail.
|
|
26
|
+
|
|
27
|
+
## 1 · Per-seed cron schedule + iteration strategy
|
|
28
|
+
|
|
29
|
+
The `schedule?` block on every cron-eligible
|
|
30
|
+
`DataSeedDefinition`. Two co-located surfaces — the schema (per-
|
|
31
|
+
seed shape) and the iteration-strategy enum (the legal values for
|
|
32
|
+
`schedule.iterationStrategy`):
|
|
33
|
+
|
|
34
|
+
## Import Origins
|
|
35
|
+
|
|
36
|
+
- `@wildo-ai/saas-backend-lib`
|
|
37
|
+
|
|
38
|
+
## Source Excerpts
|
|
39
|
+
|
|
40
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
41
|
+
|
|
42
|
+
```typescript
|
|
43
|
+
/**
|
|
44
|
+
* The five iteration strategies a scheduled seed may declare. Together they
|
|
45
|
+
* cover every {@link DataSeedScopeKind} without making scope enumeration an
|
|
46
|
+
* implicit, unreviewed behavior.
|
|
47
|
+
*
|
|
48
|
+
* The first four are framework-resolved (the engine paginates the
|
|
49
|
+
* canonical resource for that scope kind via the `iterateAllOfResource`
|
|
50
|
+
* shared helper). `CUSTOM_RESOLVER` defers scope enumeration to a
|
|
51
|
+
* developer-supplied function registered under
|
|
52
|
+
* {@link DataSeedScheduleSchema.shape.customResolverKey} — required when
|
|
53
|
+
* `scope.kind === CUSTOM` and available as an opt-in for the three
|
|
54
|
+
* resource-aligned scopes (e.g., "all applications matching this
|
|
55
|
+
* filter", "users in this org bucket").
|
|
56
|
+
*
|
|
57
|
+
* This is deliberately separate from {@link DataSeedScopeKind}: operator
|
|
58
|
+
* intent and scope kind are orthogonal concerns. Auto-deriving the strategy
|
|
59
|
+
* from `scope.kind` would foreclose the valid use case "I
|
|
60
|
+
* want a curated subset of applications, not all of them" (which
|
|
61
|
+
* `CUSTOM_RESOLVER` covers cleanly even on an `APPLICATION`-scoped
|
|
62
|
+
* seed). Keeping them separate lets an application refine its target audience
|
|
63
|
+
* without changing the seed's data ownership contract.
|
|
64
|
+
*/
|
|
65
|
+
export enum DataSeedScopeIterationStrategy {
|
|
66
|
+
/** Single dispatch with `scope: { kind: GLOBAL }`. Only legal for `scope.kind === GLOBAL`. */
|
|
67
|
+
GLOBAL = 'global',
|
|
68
|
+
/** Paginate every row of the `applications` core resource, dispatch once per `_id`. */
|
|
69
|
+
ALL_APPLICATIONS = 'all-applications',
|
|
70
|
+
/** Paginate every row of the `organizations` core resource, dispatch once per `_id`. */
|
|
71
|
+
ALL_ORGANIZATIONS = 'all-organizations',
|
|
72
|
+
/** Paginate every row of the `users` core resource, dispatch once per `_id`. */
|
|
73
|
+
ALL_USERS = 'all-users',
|
|
74
|
+
/** Defer scope enumeration to a developer-registered resolver (see `customResolverKey`). */
|
|
75
|
+
CUSTOM_RESOLVER = 'custom-resolver',
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Import Origins
|
|
80
|
+
|
|
81
|
+
- `@wildo-ai/saas-backend-lib`
|
|
82
|
+
|
|
83
|
+
## Source Excerpts
|
|
84
|
+
|
|
85
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
86
|
+
|
|
87
|
+
```typescript
|
|
88
|
+
/**
|
|
89
|
+
* Schedule + scope-iteration block on a {@link DataSeedDefinition}.
|
|
90
|
+
*
|
|
91
|
+
* Presence of this object is the sole opt-in signal for scheduled re-runs.
|
|
92
|
+
* Seeds without `schedule?` are never selected by the cron path; they run only
|
|
93
|
+
* through their declared lifecycle, lazy-access or operator-triggered paths.
|
|
94
|
+
*
|
|
95
|
+
* **Field-level invariants enforced by the factory** (not by Zod alone):
|
|
96
|
+
*
|
|
97
|
+
* - `cron` — parsed by `cron-parser` at factory time
|
|
98
|
+
* ({@link validateDataSeedScheduleCronExpression}); reject malformed
|
|
99
|
+
* expressions early so app startup fails loudly instead of the next
|
|
100
|
+
* tick silently logging a parse error.
|
|
101
|
+
* - `iterationStrategy` — must satisfy the alignment matrix in
|
|
102
|
+
* {@link ALLOWED_ITERATION_STRATEGIES_BY_SCOPE_KIND}, enforced by
|
|
103
|
+
* {@link validateDataSeedScheduleAgainstScope}.
|
|
104
|
+
* - `customResolverKey` — REQUIRED iff
|
|
105
|
+
* `iterationStrategy === CUSTOM_RESOLVER`; FORBIDDEN otherwise
|
|
106
|
+
* (enforced inline by the schema's `superRefine`).
|
|
107
|
+
* - **Mode** — `mode === LAZY` + `schedule` is rejected at factory
|
|
108
|
+
* time (a LAZY seed's contract is "first access creates the row,
|
|
109
|
+
* never re-applied" — periodic re-runs contradict that). Enforced by
|
|
110
|
+
* {@link validateModeSpecificFields}.
|
|
111
|
+
*
|
|
112
|
+
* `customResolverKey` is a string lookup against the application-registered
|
|
113
|
+
* resolver. The definition never carries a function directly: keeping it
|
|
114
|
+
* declarative lets the registry and companion inspect the schedule safely.
|
|
115
|
+
*/
|
|
116
|
+
export const DataSeedScheduleSchema = z
|
|
117
|
+
.object({
|
|
118
|
+
/**
|
|
119
|
+
* Standard 5-field crontab expression (e.g. `'0 * * * *'` for
|
|
120
|
+
* hourly). Validated at factory time via `cron-parser`; a malformed
|
|
121
|
+
* expression throws with the seed key in the message so app
|
|
122
|
+
* startup surfaces it immediately.
|
|
123
|
+
*/
|
|
124
|
+
cron: z.string().min(1),
|
|
125
|
+
/**
|
|
126
|
+
* Which scope tuples this seed re-runs over per cron tick. Must
|
|
127
|
+
* align with the seed's declared `scope.kind` per
|
|
128
|
+
* {@link ALLOWED_ITERATION_STRATEGIES_BY_SCOPE_KIND}.
|
|
129
|
+
*/
|
|
130
|
+
iterationStrategy: z.enum(DataSeedScopeIterationStrategy),
|
|
131
|
+
/**
|
|
132
|
+
* String key looked up against the runtime
|
|
133
|
+
* `DataSeedScopeResolverRegistryBackendService`. Resolvers are
|
|
134
|
+
* registered at app startup via
|
|
135
|
+
* `BackendDomainModule.dataSeedScopeResolvers` (aggregated by
|
|
136
|
+
* `mergeBackendDomainModules` and threaded through
|
|
137
|
+
* `ApplicationInitializationConfig.dataSeedScopeResolvers`).
|
|
138
|
+
* REQUIRED when `iterationStrategy === CUSTOM_RESOLVER`,
|
|
139
|
+
* FORBIDDEN otherwise.
|
|
140
|
+
*/
|
|
141
|
+
customResolverKey: z.string().min(1).optional(),
|
|
142
|
+
})
|
|
143
|
+
.strict()
|
|
144
|
+
.superRefine((value, ctx) => {
|
|
145
|
+
const requiresResolver
|
|
146
|
+
= value.iterationStrategy === DataSeedScopeIterationStrategy.CUSTOM_RESOLVER;
|
|
147
|
+
const hasResolver = value.customResolverKey !== undefined;
|
|
148
|
+
if (requiresResolver && !hasResolver) {
|
|
149
|
+
ctx.addIssue({
|
|
150
|
+
code: 'custom',
|
|
151
|
+
path: ['customResolverKey'],
|
|
152
|
+
message:
|
|
153
|
+
'customResolverKey is required when iterationStrategy === CUSTOM_RESOLVER (the resolver returns the explicit list of relatedIds to dispatch).',
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
if (!requiresResolver && hasResolver) {
|
|
157
|
+
ctx.addIssue({
|
|
158
|
+
code: 'custom',
|
|
159
|
+
path: ['customResolverKey'],
|
|
160
|
+
message:
|
|
161
|
+
'customResolverKey is only valid when iterationStrategy === CUSTOM_RESOLVER (other strategies are framework-resolved and would silently ignore the resolver).',
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
});
|
|
165
|
+
|
|
166
|
+
export type DataSeedSchedule = z.infer<typeof DataSeedScheduleSchema>;
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## 2 · Admin endpoint contracts (paths + headers + env key)
|
|
170
|
+
|
|
171
|
+
The PUBLIC, stable identifiers for the admin surface. External
|
|
172
|
+
consumers (operator runbooks, k8s `CronJob`, alerting integrations)
|
|
173
|
+
MUST reference these constants — never hard-code the path strings
|
|
174
|
+
or header name. Any rename of the path / header / env var goes
|
|
175
|
+
through this single file.
|
|
176
|
+
|
|
177
|
+
## Import Origins
|
|
178
|
+
|
|
179
|
+
- `@wildo-ai/saas-backend-lib`
|
|
180
|
+
|
|
181
|
+
## Source Excerpts
|
|
182
|
+
|
|
183
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
184
|
+
|
|
185
|
+
```typescript
|
|
186
|
+
/**
|
|
187
|
+
* Environment variable that holds the secret required to authenticate
|
|
188
|
+
* against the data-seeding admin endpoints. When unset (or empty), every
|
|
189
|
+
* endpoint returns 503 `INFRASTRUCTURE` ("data-seeding admin endpoints
|
|
190
|
+
* disabled"). This is the safe-default — fresh deployments don't
|
|
191
|
+
* accidentally expose the admin surface.
|
|
192
|
+
*/
|
|
193
|
+
export const DataSeedingAdminEndpointEnvKey = 'APPLICATION_ADMIN_SECRET' as const;
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* HTTP request header carrying the admin secret. Compared against
|
|
197
|
+
* `process.env[APPLICATION_ADMIN_SECRET]` via a hash-then-compare:
|
|
198
|
+
* both the provided header value and the expected env value are
|
|
199
|
+
* SHA-256 digested first, then compared with `crypto.timingSafeEqual`
|
|
200
|
+
* over the resulting fixed-length 32-byte buffers. Hashing first
|
|
201
|
+
* removes the length-mismatch timing oracle that a raw
|
|
202
|
+
* `timingSafeEqual` over the variable-length secrets would
|
|
203
|
+
* introduce (audit P5/6 L-2). The compare itself remains
|
|
204
|
+
* constant-time, defeating the per-byte timing oracle.
|
|
205
|
+
*/
|
|
206
|
+
export const DataSeedingAdminEndpointHeaderKey = 'X-Admin-Secret' as const;
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* Root mount path. Lives under `/internal/...` (NOT `/api/v1/...`) to
|
|
210
|
+
* signal "operator surface, not consumer API" — mirrors the convention
|
|
211
|
+
* used by other root-mounted operational controllers (e.g. `/health`).
|
|
212
|
+
*
|
|
213
|
+
* `/internal/admin/data-seeding/...` — no per-app routing in the URL
|
|
214
|
+
* (P6-C-ARCH=M1: the app process is single-tenant per process).
|
|
215
|
+
*/
|
|
216
|
+
export const DataSeedingAdminEndpointMountBasePath = '/internal/admin/data-seeding' as const;
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* Sub-paths exposed by the controller, relative to
|
|
220
|
+
* {@link DataSeedingAdminEndpointMountBasePath}.
|
|
221
|
+
*/
|
|
222
|
+
export const DataSeedingAdminEndpointPath = {
|
|
223
|
+
/** GET — list registered seeds with their `lastRun` summary. */
|
|
224
|
+
SEEDS: '/seeds',
|
|
225
|
+
/** GET — paginated `DataSeedRun` ledger listing with filters. */
|
|
226
|
+
RUNS: '/runs',
|
|
227
|
+
/** POST — invoke `DataSeedDispatcher.runManual`. Returns `DataSeedManualReport`. */
|
|
228
|
+
RERUN: '/rerun',
|
|
229
|
+
} as const;
|
|
230
|
+
|
|
231
|
+
export type DataSeedingAdminEndpointPathValue =
|
|
232
|
+
(typeof DataSeedingAdminEndpointPath)[keyof typeof DataSeedingAdminEndpointPath];
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
## 3 · Run ledger (terminal-status enum + persisted shape)
|
|
236
|
+
|
|
237
|
+
The persistence ledger for every seed pass. `RUNNING` rows are
|
|
238
|
+
recoverable by the next dispatcher pass; `COMPLETED` / `PARTIAL` /
|
|
239
|
+
`FAILED` are terminal and report the per-entry outcome via
|
|
240
|
+
`failureReport`.
|
|
241
|
+
|
|
242
|
+
## Import Origins
|
|
243
|
+
|
|
244
|
+
- `@wildo-ai/saas-backend-lib`
|
|
245
|
+
|
|
246
|
+
## Source Excerpts
|
|
247
|
+
|
|
248
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
249
|
+
|
|
250
|
+
```typescript
|
|
251
|
+
/**
|
|
252
|
+
* Outcome classification for a {@link DataSeedRunSchema} row.
|
|
253
|
+
*
|
|
254
|
+
* - `RUNNING` — pass started, no terminal outcome yet. Crash recovery
|
|
255
|
+
* is handled at the START of the next dispatcher pass via
|
|
256
|
+
* `startDataSeedRun`'s `findByBusinessKey` recover branch (audit
|
|
257
|
+
* L2-1): if the prior `RUNNING` row is found for the same business
|
|
258
|
+
* key it is immediately superseded by a fresh `RUNNING` row. There
|
|
259
|
+
* is NO heartbeat / startup-window timeout — recovery is purely
|
|
260
|
+
* "next pass wins". (The pre-Phase-7 JSDoc that mentioned a
|
|
261
|
+
* "startup window" was aspirational; this fix realigns the JSDoc
|
|
262
|
+
* with the implemented behavior — L4-9, post-Phase-7 close-out.)
|
|
263
|
+
* - `COMPLETED` — every entry succeeded.
|
|
264
|
+
* - `PARTIAL` — at least one entry failed but the pass did not abort
|
|
265
|
+
* (collect-and-report behavior, per resolved D10).
|
|
266
|
+
* - `FAILED` — the pass threw before reaching its terminal phase.
|
|
267
|
+
*/
|
|
268
|
+
export enum DataSeedRunStatus {
|
|
269
|
+
RUNNING = 'running',
|
|
270
|
+
COMPLETED = 'completed',
|
|
271
|
+
PARTIAL = 'partial',
|
|
272
|
+
FAILED = 'failed',
|
|
273
|
+
}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
## Import Origins
|
|
277
|
+
|
|
278
|
+
- `@wildo-ai/saas-backend-lib`
|
|
279
|
+
|
|
280
|
+
## Source Excerpts
|
|
281
|
+
|
|
282
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
283
|
+
|
|
284
|
+
```typescript
|
|
285
|
+
/**
|
|
286
|
+
* Persistence shape for a single dispatcher pass.
|
|
287
|
+
*
|
|
288
|
+
* **Authority model** (see plan §3.7 + D4): the seed code itself ALWAYS
|
|
289
|
+
* runs as `INTERNALLY_INITIATED_REQUEST` with super-admin roles, identical
|
|
290
|
+
* to a batch. The `triggeredByUserId` field is **metadata for audit
|
|
291
|
+
* attribution**, not authority — it merely records which user's action
|
|
292
|
+
* caused the dispatcher to fire (e.g. the user whose first LIST call
|
|
293
|
+
* triggered a lazy seed, or the admin who hit the manual re-run button).
|
|
294
|
+
*
|
|
295
|
+
* **Idempotency contract**: the composite business key
|
|
296
|
+
* `(seedKey, scopeKind, relatedResourceType, relatedId, seedVersion)`
|
|
297
|
+
* uniquely identifies a pass. The dispatcher uses `upsertByBusinessKey`
|
|
298
|
+
* to either create a fresh `running` row or recover a previous attempt's
|
|
299
|
+
* row before writing the terminal outcome. `relatedId` is `null` for
|
|
300
|
+
* `scopeKind: 'global'` (the only kind without a per-row anchor).
|
|
301
|
+
* `relatedResourceType` is `null` for the four built-in scope kinds and
|
|
302
|
+
* the resource-type identifier (e.g. `'Workspace'`) for `'custom'`.
|
|
303
|
+
*/
|
|
304
|
+
export const DataSeedRunSchema = z.object({
|
|
305
|
+
/**
|
|
306
|
+
* MongoDB document ID — auto-generated. Marked `.isPrimaryKey()` so
|
|
307
|
+
* framework introspection utilities (`getPrimaryKeyField()`, the
|
|
308
|
+
* ZodToMongoose convertor, etc.) recognize it the same way they
|
|
309
|
+
* recognize `_id` on every other resource. Required by plan §3.7 +
|
|
310
|
+
* §5 Phase 2.A.2.
|
|
311
|
+
*/
|
|
312
|
+
_id: z.string().isPrimaryKey(),
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
// === Seed identity ===
|
|
316
|
+
/** Stable seed identifier (matches `DataSeedDefinition.seedKey`). */
|
|
317
|
+
seedKey: z.string().min(1).isDBIndexed(),
|
|
318
|
+
/**
|
|
319
|
+
* Declaration version at the time of this pass. Bumping the declaration's
|
|
320
|
+
* `version` is the developer's signal to re-run; the dispatcher answers by
|
|
321
|
+
* comparing the `MAX(seedVersion)` of completed rows for this scope to the
|
|
322
|
+
* declared version (see plan §3.7 skip-rule matrix).
|
|
323
|
+
*/
|
|
324
|
+
seedVersion: z.number().int().nonnegative(),
|
|
325
|
+
/**
|
|
326
|
+
* Reconciliation mode of the pass (mirror of `DataSeedDefinition.mode`).
|
|
327
|
+
*
|
|
328
|
+
* Phase 4.A.18 / P4-G (G1): persisting `mode` here lets back-office
|
|
329
|
+
* dashboards filter by engine ("show every UPGRADE pass that produced
|
|
330
|
+
* PARTIAL", "every SYNC pass that deprecated > 0 rows") without joining
|
|
331
|
+
* back to the in-memory `DataSeedRegistry`. Indexed for that reason.
|
|
332
|
+
*
|
|
333
|
+
* NOT part of the business key — flipping a declaration from ADDITIVE
|
|
334
|
+
* to UPGRADE between deploys must NOT duplicate the ledger entry for
|
|
335
|
+
* the same `(seedKey, scope, version)` triple, otherwise the dispatcher
|
|
336
|
+
* would silently re-run the same pass under a different mode label.
|
|
337
|
+
*/
|
|
338
|
+
mode: z.enum(DataSeedMode).isDBIndexed(),
|
|
339
|
+
|
|
340
|
+
// === Scope ===
|
|
341
|
+
/** Which scope kind this run materializes (mirror of the declaration). */
|
|
342
|
+
scopeKind: z.enum(DataSeedScopeKind).isDBIndexed(),
|
|
343
|
+
/**
|
|
344
|
+
* For `scopeKind: 'custom'` — the resource type whose row anchors the
|
|
345
|
+
* scope. `null` for the four built-in scope kinds (their resource is
|
|
346
|
+
* implicit — APPLICATION/ORGANIZATION/USER/GLOBAL).
|
|
347
|
+
*
|
|
348
|
+
* Part of the business key (see schema-level JSDoc / F-4) so two
|
|
349
|
+
* `CUSTOM` seeds whose `relatedId` happens to collide across
|
|
350
|
+
* different resource types still get distinct ledger rows. Indexed
|
|
351
|
+
* to keep the compound index column-aligned with the business-key
|
|
352
|
+
* order.
|
|
353
|
+
*/
|
|
354
|
+
relatedResourceType: z.string().nullable().isDBIndexed(),
|
|
355
|
+
/**
|
|
356
|
+
* `_id` of the scope-defining row. `null` only for `scopeKind: 'global'`
|
|
357
|
+
* (database-wide, no anchor row).
|
|
358
|
+
*/
|
|
359
|
+
relatedId: z.string().nullable().isDBIndexed(),
|
|
360
|
+
|
|
361
|
+
// === Trigger context (audit / debugging only — see authority model above) ===
|
|
362
|
+
/** Which trigger fired this run. Verbatim copy of the declaration's trigger. */
|
|
363
|
+
trigger: DataSeedTriggerSchema,
|
|
364
|
+
/**
|
|
365
|
+
* Coarse classification of the trigger origin. Persisted alongside
|
|
366
|
+
* `trigger` for filtering / dashboarding without parsing the discriminated
|
|
367
|
+
* union (e.g. "show me every lazy-access run for org X this week").
|
|
368
|
+
*/
|
|
369
|
+
triggerOrigin: z.enum(DataSeedTriggerOrigin).isDBIndexed(),
|
|
370
|
+
/**
|
|
371
|
+
* The user whose action caused the dispatcher to fire (lazy access,
|
|
372
|
+
* manual re-run, resource-lifecycle write that triggered a Level-B
|
|
373
|
+
* seed). `null` for framework-initiated passes (`onAppInit`,
|
|
374
|
+
* `onAppVersionUpgrade`, `onScheduledRefresh`).
|
|
375
|
+
*/
|
|
376
|
+
triggeredByUserId: z.string().nullable(),
|
|
377
|
+
|
|
378
|
+
// === Outcome ===
|
|
379
|
+
status: z.enum(DataSeedRunStatus).isDBIndexed(),
|
|
380
|
+
startedAt: z.date(),
|
|
381
|
+
/** `null` while `status === RUNNING`; set on every terminal transition. */
|
|
382
|
+
finishedAt: z.date().nullable(),
|
|
383
|
+
|
|
384
|
+
// === Counters (always populated, even on FAILED runs — zeros if pass aborted before entry loop) ===
|
|
385
|
+
//
|
|
386
|
+
// Phase 4 / P4-E (E1) widened the counter set with engine-specific
|
|
387
|
+
// outcomes so dashboards stay legible across mode boundaries — every
|
|
388
|
+
// counter has exactly one meaning regardless of `mode`.
|
|
389
|
+
//
|
|
390
|
+
// Counter conventions:
|
|
391
|
+
// - `entriesAttempted` — total *declared* entries (i.e. the contents
|
|
392
|
+
// of `seed.entries[]` for the pass) the dispatcher iterated over.
|
|
393
|
+
// This counter is incremented exactly once per declared entry,
|
|
394
|
+
// BEFORE the per-entry try/catch, so it always equals the declared
|
|
395
|
+
// set size regardless of insert / update / upgrade / skip / fail
|
|
396
|
+
// outcome. Renames (`seed.renames[]`) and SYNC orphan handling
|
|
397
|
+
// (`onOrphan` policy) are NOT included — they have their own
|
|
398
|
+
// dedicated counters (`entriesRenamed`, `entriesDeleted`,
|
|
399
|
+
// `entriesDeprecated`, `entriesReportedOrphans`). The intent is
|
|
400
|
+
// that `entriesAttempted == seed.entries.length` for any
|
|
401
|
+
// well-formed pass, so dashboards can spot config drift at a
|
|
402
|
+
// glance (F-8 / F-15).
|
|
403
|
+
// - `entriesInserted` — declared entries written via the insert path
|
|
404
|
+
// (row absent → upsert created it). Applies to ADDITIVE / UPGRADE / SYNC.
|
|
405
|
+
// - `entriesUpdated` — declared entries whose row was present at
|
|
406
|
+
// pass time and got the declared `entry.data` payload re-stamped
|
|
407
|
+
// via `upsertByBusinessKey`'s `$set` semantics. Used by ADDITIVE
|
|
408
|
+
// on every present row (mode contract is "operationally additive
|
|
409
|
+
// at row-set level, payload re-applied per pass" — audit L2-6,
|
|
410
|
+
// post-Phase-7 close-out). UPGRADE / SYNC use `entriesUpgraded` /
|
|
411
|
+
// `entriesInserted` / `entriesDeprecated` / `entriesDeleted`
|
|
412
|
+
// instead — the present-but-unchanged ADDITIVE row IS what this
|
|
413
|
+
// counter measures.
|
|
414
|
+
// - `entriesUpgraded` — declared entries that received a real version
|
|
415
|
+
// migration in `mode: UPGRADE` (persisted version < declared version,
|
|
416
|
+
// migrators walked, managed fields re-applied). Phase 4.A.
|
|
417
|
+
// - `entriesRenamed` — declared entries whose row was relocated from a
|
|
418
|
+
// prior business-key value via `seed.renames[]`. Phase 4.A.
|
|
419
|
+
// - `entriesSkipped` — entries the dispatcher chose not to write
|
|
420
|
+
// (already-at-version, downgrade-attempt with B1 skip-with-warn,
|
|
421
|
+
// user-customized when A2/A3 ever land). Reasons surface in logs +
|
|
422
|
+
// future per-row report; this counter just tallies them.
|
|
423
|
+
// - `entriesDeleted` — orphan rows hard-deleted by `mode: SYNC` with
|
|
424
|
+
// `onOrphan: 'delete'`. Phase 4.B.
|
|
425
|
+
// - `entriesDeprecated` — orphan rows marked deprecated (nested
|
|
426
|
+
// `__seed.deprecated`) by `mode: SYNC` with `onOrphan: 'deprecate'`.
|
|
427
|
+
// Phase 4.B / P4-C (C1).
|
|
428
|
+
// - `entriesReportedOrphans` — orphan rows surfaced into
|
|
429
|
+
// `failureReport.orphans[]` by `mode: SYNC` with `onOrphan: 'report'`
|
|
430
|
+
// (no row mutation). Phase 4.B.
|
|
431
|
+
// - `entriesFailed` — entries whose write threw (entry-scoped failure;
|
|
432
|
+
// pass continues with PARTIAL outcome). Includes per-orphan write
|
|
433
|
+
// failures for SYNC.
|
|
434
|
+
entriesAttempted: z.number().int().nonnegative().default(0),
|
|
435
|
+
entriesInserted: z.number().int().nonnegative().default(0),
|
|
436
|
+
entriesUpdated: z.number().int().nonnegative().default(0),
|
|
437
|
+
entriesUpgraded: z.number().int().nonnegative().default(0),
|
|
438
|
+
entriesRenamed: z.number().int().nonnegative().default(0),
|
|
439
|
+
entriesSkipped: z.number().int().nonnegative().default(0),
|
|
440
|
+
entriesDeleted: z.number().int().nonnegative().default(0),
|
|
441
|
+
entriesDeprecated: z.number().int().nonnegative().default(0),
|
|
442
|
+
entriesReportedOrphans: z.number().int().nonnegative().default(0),
|
|
443
|
+
entriesFailed: z.number().int().nonnegative().default(0),
|
|
444
|
+
|
|
445
|
+
/**
|
|
446
|
+
* Structured failure breakdown. `null` for `COMPLETED` runs; populated
|
|
447
|
+
* for `PARTIAL` (entry-level errors only) and `FAILED` (entry-level
|
|
448
|
+
* errors and/or `passLevelError`).
|
|
449
|
+
*/
|
|
450
|
+
failureReport: DataSeedFailureReportSchema.nullable(),
|
|
451
|
+
})
|
|
452
|
+
/**
|
|
453
|
+
* Composite business key declares the natural identity of a pass and
|
|
454
|
+
* doubles as the basis for the critical compound index
|
|
455
|
+
* `{ seedKey:1, scopeKind:1, relatedResourceType:1, relatedId:1, seedVersion:1 }`.
|
|
456
|
+
* The `findByBusinessKey` / `upsertByBusinessKey` methods that Phase 2
|
|
457
|
+
* lands on the repository base will derive their Mongo filter from this
|
|
458
|
+
* exact key list, so changing it ALSO changes the dispatcher's
|
|
459
|
+
* idempotency contract — handle with care.
|
|
460
|
+
*
|
|
461
|
+
* `relatedResourceType` placement: kept BEFORE `relatedId` so the
|
|
462
|
+
* compound index supports prefix lookups by `(seedKey, scopeKind,
|
|
463
|
+
* relatedResourceType)` (e.g. "every CUSTOM run for `Workspace`")
|
|
464
|
+
* without requiring `relatedId` in the predicate. Built-in scope
|
|
465
|
+
* kinds have `relatedResourceType: null`, which the index handles
|
|
466
|
+
* uniformly (Mongo treats `null` as a valid index entry).
|
|
467
|
+
*/
|
|
468
|
+
.businessKeySet(['seedKey', 'scopeKind', 'relatedResourceType', 'relatedId', 'seedVersion']);
|
|
469
|
+
|
|
470
|
+
export type DataSeedRun = z.infer<typeof DataSeedRunSchema>;
|
|
471
|
+
```
|
|
472
|
+
|
|
473
|
+
## 4 · Bootstrap wiring (Level-A dispatch + Level-B hooks + LAZY guards)
|
|
474
|
+
|
|
475
|
+
The single bootstrap entry point invoked by the installed application startup
|
|
476
|
+
composition. It wires registries unconditionally; runs
|
|
477
|
+
Level-A dispatch passes only outside platform mode. The order
|
|
478
|
+
inside the function is the source of truth for "why did the seed
|
|
479
|
+
fire / not fire / fire twice" investigations.
|
|
480
|
+
|
|
481
|
+
## Import Origins
|
|
482
|
+
|
|
483
|
+
- `@wildo-ai/saas-backend-lib`
|
|
484
|
+
|
|
485
|
+
## Source Excerpts
|
|
486
|
+
|
|
487
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
488
|
+
|
|
489
|
+
```typescript
|
|
490
|
+
/**
|
|
491
|
+
* Inputs to {@link runDataSeedingApplicationBootstrap}. Kept as a typed
|
|
492
|
+
* record (instead of positional args) so callers from different startup
|
|
493
|
+
* orchestrators stay readable when the surface grows in later phases.
|
|
494
|
+
*/
|
|
495
|
+
export interface DataSeedApplicationBootstrapInput {
|
|
496
|
+
/**
|
|
497
|
+
* Declarative seed definitions collected from `BackendDomainModule.seeds`
|
|
498
|
+
* and forwarded by the orchestrator. `undefined` is treated as `[]`
|
|
499
|
+
* (registration still runs to keep the registry's "initialized" semantics
|
|
500
|
+
* consistent across boots).
|
|
501
|
+
*/
|
|
502
|
+
dataSeeds: readonly DataSeedDefinition[] | undefined;
|
|
503
|
+
|
|
504
|
+
/**
|
|
505
|
+
* Phase 7 / Item 47 (cron scheduler) — Slice 3.
|
|
506
|
+
*
|
|
507
|
+
* Aggregated `customResolverKey → DataSeedScopeResolver` map collected
|
|
508
|
+
* from `BackendDomainModule.dataSeedScopeResolvers` (cross-module
|
|
509
|
+
* duplicate keys already rejected by `mergeBackendDomainModules`).
|
|
510
|
+
* `undefined` / `{}` is treated identically — a no-op registration
|
|
511
|
+
* that leaves the registry empty so future cron seeds with
|
|
512
|
+
* `iterationStrategy === CUSTOM_RESOLVER` fail loudly at first
|
|
513
|
+
* invocation rather than silently iterating zero rows.
|
|
514
|
+
*/
|
|
515
|
+
dataSeedScopeResolvers?: Readonly<Record<string, DataSeedScopeResolver>>;
|
|
516
|
+
|
|
517
|
+
/**
|
|
518
|
+
* `true` when the caller is the platform apps-manager (or another
|
|
519
|
+
* profile that bootstraps tenant apps later through their own
|
|
520
|
+
* `StartApplicationBackendService.initialize()` call). Dispatch is
|
|
521
|
+
* skipped in that case — see plan §2.F.
|
|
522
|
+
*/
|
|
523
|
+
isPlatformMode: boolean;
|
|
524
|
+
|
|
525
|
+
logger: LoggerService;
|
|
526
|
+
/** Used to log Step 7.7 progress under the same channel as the host service. */
|
|
527
|
+
logDebug: (message: string, context?: Record<string, unknown>) => void;
|
|
528
|
+
|
|
529
|
+
registry: DataSeedRegistryBackendService;
|
|
530
|
+
/**
|
|
531
|
+
* Phase 7 / Item 47 — Slice 3. Hydrated from
|
|
532
|
+
* {@link DataSeedApplicationBootstrapInput.dataSeedScopeResolvers}
|
|
533
|
+
* BEFORE Level-A dispatch / Level-B + LAZY hook wiring (registration
|
|
534
|
+
* is dispatch-independent — keeping it before the platform-mode
|
|
535
|
+
* skip ensures both the platform process AND tenant boots see the
|
|
536
|
+
* same registry state).
|
|
537
|
+
*/
|
|
538
|
+
scopeResolverRegistry: DataSeedScopeResolverRegistryBackendService;
|
|
539
|
+
dispatcher: DataSeedDispatcherBackendService;
|
|
540
|
+
|
|
541
|
+
/**
|
|
542
|
+
* Required for Level-B auto-wiring (Phase 3, plan decision P3-B=B1).
|
|
543
|
+
* After registering seeds, the bootstrap walks the registry and
|
|
544
|
+
* registers pre/post-operation hooks on this services registry so
|
|
545
|
+
* that any resource-lifecycle trigger (`beforeCreate`/`afterCreate`/
|
|
546
|
+
* `beforeUpdate`/`afterUpdate`/`beforeDelete`/`afterDelete`) fires
|
|
547
|
+
* the dispatcher's `runResourceLifecycle` when the matching
|
|
548
|
+
* operation runs.
|
|
549
|
+
*/
|
|
550
|
+
servicesRegistry: ServicesRegistryHandlerBackendService;
|
|
551
|
+
}
|
|
552
|
+
|
|
553
|
+
/**
|
|
554
|
+
* Step 7.7 — register the seed corpus and (outside platform mode) dispatch
|
|
555
|
+
* the application-lifecycle passes (`onAppInit` then `onAppVersionUpgrade`).
|
|
556
|
+
*
|
|
557
|
+
* Contract:
|
|
558
|
+
* - Registration ALWAYS runs (even in platform mode) so future Level-B
|
|
559
|
+
* and lazy-access dispatch paths can resolve seed declarations.
|
|
560
|
+
* - Dispatcher is invoked twice in order: `onAppInit` MUST precede
|
|
561
|
+
* `onAppVersionUpgrade` because the upgrade pass may mutate rows
|
|
562
|
+
* created by the init pass.
|
|
563
|
+
* - Any throw from the dispatcher is rethrown unchanged. Booting with
|
|
564
|
+
* a half-applied seed corpus would silently break downstream ops, so
|
|
565
|
+
* the dispatcher's FAILED `DataSeedRun` ledger entries (which the
|
|
566
|
+
* next boot retries) are the intended recovery surface — not a try/
|
|
567
|
+
* catch here.
|
|
568
|
+
*
|
|
569
|
+
* Operational invariants (operator-facing):
|
|
570
|
+
* 1. Seed registry hydrated unconditionally (platform mode + tenant boot)
|
|
571
|
+
* so Level-B + LAZY hooks can resolve declarations regardless of who
|
|
572
|
+
* runs the Level-A pass.
|
|
573
|
+
* 2. Custom-resolver registry hydrated next (Item 47 / Slice 3) — empty
|
|
574
|
+
* map is a no-op call, so any future cron seed declaring
|
|
575
|
+
* `iterationStrategy === CUSTOM_RESOLVER` against an unregistered key
|
|
576
|
+
* fails loudly at first invocation rather than silently iterating
|
|
577
|
+
* zero rows.
|
|
578
|
+
* 3. Level-B hooks wired BEFORE Level-A dispatch (P3-B=B1) — per-tenant
|
|
579
|
+
* resource-lifecycle seeds must be live before any boot pass, so
|
|
580
|
+
* cross-tenant boots see consistent hook state.
|
|
581
|
+
* 4. LAZY guards wired symmetric with Level-B (P5-D=D1) — pre-only
|
|
582
|
+
* hooks per `(resourceType, operation)` pair, coalesced to one hook
|
|
583
|
+
* per resource type with internal route map.
|
|
584
|
+
* 5. Platform-mode skip: dispatch is suppressed for the apps-manager
|
|
585
|
+
* profile (it bootstraps tenant apps which run their own pass).
|
|
586
|
+
*/
|
|
587
|
+
export async function runDataSeedingApplicationBootstrap(
|
|
588
|
+
input: DataSeedApplicationBootstrapInput,
|
|
589
|
+
): Promise<void> {
|
|
590
|
+
const {
|
|
591
|
+
dataSeeds,
|
|
592
|
+
dataSeedScopeResolvers,
|
|
593
|
+
isPlatformMode,
|
|
594
|
+
logger,
|
|
595
|
+
logDebug,
|
|
596
|
+
registry,
|
|
597
|
+
scopeResolverRegistry,
|
|
598
|
+
dispatcher,
|
|
599
|
+
servicesRegistry,
|
|
600
|
+
} = input;
|
|
601
|
+
|
|
602
|
+
const seeds = dataSeeds ?? [];
|
|
603
|
+
logDebug('🌱 Registering data-seed definitions...', { count: seeds.length });
|
|
604
|
+
registry.registerSeeds(seeds);
|
|
605
|
+
logDebug('✅ Data-seed registry populated');
|
|
606
|
+
|
|
607
|
+
// Phase 7 / Item 47 — Slice 3 — register custom-resolver scope iterators.
|
|
608
|
+
// Runs unconditionally (even in platform mode + when the map is empty)
|
|
609
|
+
// so the registry's lifecycle is symmetric with `DataSeedRegistry`'s
|
|
610
|
+
// (always-initialized at boot). The empty-map case is a no-op call
|
|
611
|
+
// that registers zero entries; future cron seeds (Slice 5) probing
|
|
612
|
+
// the registry via `hasResolver` get a clean `false` instead of a
|
|
613
|
+
// "registry not initialized" error.
|
|
614
|
+
const resolversMap = dataSeedScopeResolvers ?? {};
|
|
615
|
+
const resolverCount = Object.keys(resolversMap).length;
|
|
616
|
+
logDebug('🌱 Registering data-seed scope resolvers...', { count: resolverCount });
|
|
617
|
+
scopeResolverRegistry.registerResolvers(resolversMap);
|
|
618
|
+
logDebug('✅ Data-seed scope-resolver registry populated', { count: resolverCount });
|
|
619
|
+
|
|
620
|
+
// Phase 3 (P3-B=B1) — auto-wire Level-B hooks into the services
|
|
621
|
+
// registry. Runs BEFORE the Level-A dispatch (and in platform mode
|
|
622
|
+
// too) so Level-B seeds fire on per-tenant resource lifecycle events
|
|
623
|
+
// regardless of who runs the Level-A pass.
|
|
624
|
+
wireLevelBResourceLifecycleHooks({ registry, dispatcher, servicesRegistry, logDebug });
|
|
625
|
+
|
|
626
|
+
// Phase 5 (P5-D=D1) — auto-wire LAZY-access guards into the services
|
|
627
|
+
// registry. Symmetric with Level-B wiring (registers pre-operation
|
|
628
|
+
// hooks per `(resourceType, operation)` pair declared by LAZY
|
|
629
|
+
// seeds). Runs BEFORE the Level-A dispatch (and in platform mode
|
|
630
|
+
// too — same rationale as the Level-B wiring above: lazy guards
|
|
631
|
+
// are per-tenant request hooks, the host running the Level-A pass
|
|
632
|
+
// is irrelevant to their availability at request time).
|
|
633
|
+
wireLazyAccessGuards({ registry, dispatcher, servicesRegistry, logDebug });
|
|
634
|
+
|
|
635
|
+
if (isPlatformMode) {
|
|
636
|
+
logDebug('🌱 Skipping application-lifecycle data-seed dispatch in platform mode (tenant apps will run their own pass via apps-manager)');
|
|
637
|
+
return;
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
logger.info('🌱 Running application-lifecycle data seeds (onAppInit + onAppVersionUpgrade)...');
|
|
641
|
+
try {
|
|
642
|
+
const initReport = await dispatcher.runApplicationLifecycle('onAppInit');
|
|
643
|
+
logDebug('✅ onAppInit data-seed pass complete', {
|
|
644
|
+
seedsProcessed: initReport.seedsProcessed,
|
|
645
|
+
completed: initReport.runs.filter((r) => r.status === DataSeedRunStatus.COMPLETED).length,
|
|
646
|
+
partial: initReport.runs.filter((r) => r.status === DataSeedRunStatus.PARTIAL).length,
|
|
647
|
+
failed: initReport.runs.filter((r) => r.status === DataSeedRunStatus.FAILED).length,
|
|
648
|
+
});
|
|
649
|
+
|
|
650
|
+
const upgradeReport = await dispatcher.runApplicationLifecycle('onAppVersionUpgrade');
|
|
651
|
+
logDebug('✅ onAppVersionUpgrade data-seed pass complete', {
|
|
652
|
+
seedsProcessed: upgradeReport.seedsProcessed,
|
|
653
|
+
completed: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.COMPLETED).length,
|
|
654
|
+
partial: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.PARTIAL).length,
|
|
655
|
+
failed: upgradeReport.runs.filter((r) => r.status === DataSeedRunStatus.FAILED).length,
|
|
656
|
+
});
|
|
657
|
+
} catch (error) {
|
|
658
|
+
logger.error('❌ Data-seed application-lifecycle pass failed (fatal):', error);
|
|
659
|
+
throw error;
|
|
660
|
+
}
|
|
661
|
+
}
|
|
662
|
+
```
|