@wildo-ai/framework-knowledge 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,505 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: seeding-operations
|
|
3
|
+
description: Operate the running data-seeding subsystem — schedule a seed for periodic re-run via the engine cron batch, re-run a seed manually via the admin endpoints, query the `DataSeedRun` ledger to investigate a failed pass, configure the engine cron tick + `APPLICATION_ADMIN_SECRET`, and understand the boot-time wiring (Level-A dispatch, Level-B hooks, LAZY guards). Use when the user says "schedule a seed for hourly re-run", "configure the data-seeding cron tick", "re-run the welcome-emails seed via curl", "query the data-seed runs for org X", "what does DataSeedRun status PARTIAL mean", "set APPLICATION_ADMIN_SECRET", "the cron seed isn't firing", "explain the data-seeding boot order", or any operational/runtime question about a seed AFTER it has been authored.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Seeding Operations
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Operate the running data-seeding subsystem from outside the
|
|
23
|
+
declaration surface. The authoring side
|
|
24
|
+
([`seeding-authoring`](../seeding-authoring/SKILL.md)) is about WHAT
|
|
25
|
+
a seed declares; this skill is about WHAT THE FRAMEWORK DOES with
|
|
26
|
+
that declaration at runtime, and how an operator (or author) reaches
|
|
27
|
+
into that runtime to schedule, re-run, query, or configure it.
|
|
28
|
+
|
|
29
|
+
Four operational decisions, ordered by the surface most consumers
|
|
30
|
+
touch first:
|
|
31
|
+
|
|
32
|
+
1. **Schedule** — opt a seed into the engine-owned
|
|
33
|
+
`data-seeding:scheduled-rerun` cron batch by declaring a
|
|
34
|
+
`schedule?: { cron, iterationStrategy, customResolverKey? }`
|
|
35
|
+
block on the seed. Picking the right `iterationStrategy` is the
|
|
36
|
+
key decision (it determines per-tick fan-out shape).
|
|
37
|
+
2. **Re-run manually** — invoke `POST
|
|
38
|
+
/internal/admin/data-seeding/rerun` from `curl`, an external
|
|
39
|
+
`CronJob`, or any operator script. Authenticated via
|
|
40
|
+
`X-Admin-Secret` header; `force: true` re-runs LAZY seeds whose
|
|
41
|
+
prior run COMPLETED.
|
|
42
|
+
3. **Query the ledger** — `GET
|
|
43
|
+
/internal/admin/data-seeding/seeds` for the registered-seed
|
|
44
|
+
overview (with `lastRun` per seed); `GET
|
|
45
|
+
/internal/admin/data-seeding/runs` for the paginated raw
|
|
46
|
+
`DataSeedRun` listing with filters.
|
|
47
|
+
4. **Configure + observe** — set `APPLICATION_ADMIN_SECRET` to opt
|
|
48
|
+
into the admin endpoints; tune the engine tick via
|
|
49
|
+
`DataSeedingConfig.scheduledRerunCronSchedule` on the app config;
|
|
50
|
+
read the `data_seeding_run_total` Prometheus counter for cross-
|
|
51
|
+
engine outcome attribution.
|
|
52
|
+
|
|
53
|
+
Plus a fifth "deep" decision when something is wrong:
|
|
54
|
+
|
|
55
|
+
5. **Boot wiring** — understand the order of operations inside
|
|
56
|
+
`runDataSeedingApplicationBootstrap` (Level-A dispatch, Level-B
|
|
57
|
+
pre/post hooks per resource, LAZY pre-only guards per
|
|
58
|
+
`(resourceType, operation)`, platform-mode skip) so you can
|
|
59
|
+
explain why a seed fired, didn't fire, or fired in an unexpected
|
|
60
|
+
order.
|
|
61
|
+
|
|
62
|
+
## App Paths
|
|
63
|
+
|
|
64
|
+
| Surface | Glob (relative to app root) |
|
|
65
|
+
|---------|------------------------------------------------------------|
|
|
66
|
+
| App config (cron tick override) | `infrastructure/local/wildo.infra.local.config.ts` (and the `infrastructure/<env>/wildo.infra.<env>.config.ts` siblings for staging / prod) — populates `dataSeeding.scheduledRerunCronSchedule` on the resolved `AppConfiguration_Shared_Schema`. |
|
|
67
|
+
| Admin secret | `wildo-secrets/environments/<env>/secrets.json` — sets `APPLICATION_ADMIN_SECRET` in the app process env. NOT a typed schema field on `ApplicationEnvConfigurationSchema` (it is read directly from `process.env` so the surface stays self-contained to `saas-backend-lib`). |
|
|
68
|
+
| Module backend record (where `schedule?` is declared) | `backend-api/src/modules/<module>/seeds/<seed-key>.seed.ts` — same authoring file `seeding-authoring` covers; the `schedule?` block is one of the optional inputs to `createDataSeedDefinition({...})`. |
|
|
69
|
+
| Custom resolver registration | `backend-api/src/modules/<module>/index.ts` — the `dataSeedScopeResolvers?: Record<string, DataSeedScopeResolver>` slot on the typed `BackendDomainModule` (same record that carries `seeds`). Aggregated by `mergeBackendDomainModules` and threaded through `ApplicationInitializationConfig.dataSeedScopeResolvers`. |
|
|
70
|
+
| Curl runbook | n/a (operator action) — endpoint root is `/internal/admin/data-seeding`, header is `X-Admin-Secret: <APPLICATION_ADMIN_SECRET value>`. |
|
|
71
|
+
|
|
72
|
+
## When to Use
|
|
73
|
+
|
|
74
|
+
- Adding a `schedule?` block to an existing seed (cron expression,
|
|
75
|
+
iteration strategy, custom resolver wiring)
|
|
76
|
+
- Triggering a one-off re-run from an operator console / `curl` /
|
|
77
|
+
k8s `CronJob`
|
|
78
|
+
- Investigating a `DataSeedRun` row whose status is `PARTIAL` /
|
|
79
|
+
`FAILED` / stuck `RUNNING`
|
|
80
|
+
- Configuring `APPLICATION_ADMIN_SECRET` for a fresh deployment, or
|
|
81
|
+
rotating the secret
|
|
82
|
+
- Tuning `dataSeeding.scheduledRerunCronSchedule` for a deployment
|
|
83
|
+
whose seeds run daily/hourly (relax the default minute tick)
|
|
84
|
+
- Explaining why a Level-B seed fired (or didn't fire) on a
|
|
85
|
+
resource lifecycle event
|
|
86
|
+
- Explaining why a LAZY seed materialized (or short-circuited) on a
|
|
87
|
+
request
|
|
88
|
+
|
|
89
|
+
## When NOT to Use
|
|
90
|
+
|
|
91
|
+
- **Authoring** the seed itself (Level / mode / business key /
|
|
92
|
+
managed fields / rename ledger) → use
|
|
93
|
+
[`seeding-authoring`](../seeding-authoring/SKILL.md)
|
|
94
|
+
- Editing the `DataSeedRun` ledger directly → never; it is
|
|
95
|
+
framework-owned. Drop the row through the dispatcher (`POST
|
|
96
|
+
/rerun` with `force: true` for LAZY; bumping `seed.version` for
|
|
97
|
+
ADDITIVE / UPGRADE / SYNC) or — exceptionally — DELETE the row
|
|
98
|
+
via the database to clear a stuck `RUNNING` slot (prefer the
|
|
99
|
+
re-run path which patches the existing row in place).
|
|
100
|
+
- Authoring custom batch manifests → that lives in
|
|
101
|
+
`engine-custom-batch-manifests.ts`; the data-seeding cron batch is
|
|
102
|
+
already registered there as
|
|
103
|
+
`ENGINE_DATA_SEEDING_SCHEDULED_RERUN_BATCH_MANIFEST` and is
|
|
104
|
+
conditionally wired by `StartApplicationBackendService.initialize`.
|
|
105
|
+
- Building a back-office UI on top of the admin endpoints — possible
|
|
106
|
+
in principle (the `GET /seeds` payload is shaped for it) but
|
|
107
|
+
intentionally NOT shipped today (Item 49 dropped per `seeding-
|
|
108
|
+
first-class.md`); any future UI consumes this same surface
|
|
109
|
+
verbatim.
|
|
110
|
+
|
|
111
|
+
## The Five Operational Decisions
|
|
112
|
+
|
|
113
|
+
### Decision 1: Schedule — opt a seed into the cron path
|
|
114
|
+
|
|
115
|
+
A seed is cron-eligible iff it declares a `schedule?` block on
|
|
116
|
+
`createDataSeedDefinition({...})`. The block is the SOLE opt-in
|
|
117
|
+
signal — seeds without `schedule?` are NEVER picked up by the cron
|
|
118
|
+
batch (they still fire on their Level-A or Level-B trigger and via
|
|
119
|
+
manual re-run).
|
|
120
|
+
|
|
121
|
+
<!-- TIER C WAIVER: The `schedule?` opt-in shape IS the contract called out by the prose above ("the SOLE opt-in signal"); the three field-level invariants paragraph immediately below addresses each property by literal name (`cron`, `iterationStrategy`, `customResolverKey`). Keep it as Tier C until a focused, stable application example is deliberately anchored. -->
|
|
122
|
+
```ts
|
|
123
|
+
schedule: {
|
|
124
|
+
cron: '0 * * * *', // hourly
|
|
125
|
+
iterationStrategy: DataSeedScopeIterationStrategy.ALL_ORGANIZATIONS,
|
|
126
|
+
// customResolverKey: 'tasks-manager:active-orgs', // only when CUSTOM_RESOLVER
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Three field-level invariants enforced at factory time:
|
|
131
|
+
|
|
132
|
+
- **`cron`** parsed by `cron-parser` at definition time (malformed
|
|
133
|
+
expression throws with the `seedKey` in the message — app
|
|
134
|
+
startup fails loudly).
|
|
135
|
+
- **`iterationStrategy`** must align with the seed's `scope.kind`
|
|
136
|
+
per the `ALLOWED_ITERATION_STRATEGIES_BY_SCOPE_KIND` matrix
|
|
137
|
+
(e.g. `scope.kind === ORGANIZATION` requires
|
|
138
|
+
`ALL_ORGANIZATIONS` or `CUSTOM_RESOLVER`).
|
|
139
|
+
- **`customResolverKey`** is REQUIRED iff `iterationStrategy ===
|
|
140
|
+
CUSTOM_RESOLVER` and FORBIDDEN otherwise.
|
|
141
|
+
|
|
142
|
+
Plus one mode-level invariant: `mode === LAZY` × `schedule?` is
|
|
143
|
+
rejected at factory time. LAZY's contract is "first access creates
|
|
144
|
+
the row, never re-applied" — periodic re-runs would contradict
|
|
145
|
+
that.
|
|
146
|
+
|
|
147
|
+
The five iteration strategies determine per-tick fan-out:
|
|
148
|
+
|
|
149
|
+
| Strategy | Per-tick fan-out | Legal scope kinds |
|
|
150
|
+
|----------|------------------|-------------------|
|
|
151
|
+
| `GLOBAL` | 1 dispatch (no anchor) | `GLOBAL` only |
|
|
152
|
+
| `ALL_APPLICATIONS` | 1 dispatch per `applications` row | `APPLICATION` |
|
|
153
|
+
| `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `APPLICATION` (cross-tenant) / `ORGANIZATION` |
|
|
154
|
+
| `ALL_USERS` | 1 dispatch per `users` row | `APPLICATION` (cross-tenant) / `USER` |
|
|
155
|
+
| `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | every kind (incl. `CUSTOM`) — REQUIRED for `CUSTOM` |
|
|
156
|
+
|
|
157
|
+
Anchoring (N8): the cron batch runs per-app under its own
|
|
158
|
+
application's process. `ALL_ORGANIZATIONS` and `ALL_USERS`
|
|
159
|
+
yield every org/user VISIBLE to the host application (i.e.
|
|
160
|
+
children of the anchoring app). Platform-wide fan-out across
|
|
161
|
+
every app is not a supported mode.
|
|
162
|
+
|
|
163
|
+
### Decision 2: Re-run a seed manually
|
|
164
|
+
|
|
165
|
+
`POST /internal/admin/data-seeding/rerun` invokes the dispatcher's
|
|
166
|
+
`runManual` path with a typed payload. Returns the dispatcher's
|
|
167
|
+
`DataSeedManualReport` verbatim.
|
|
168
|
+
|
|
169
|
+
<!-- TIER C WAIVER: Concrete `runManual` POST payload shape; the three field semantics paragraphs that follow this curl reference each JSON field by literal name (`seedKeys`, `scope`, `force`), so the inline payload IS the contract being explained. -->
|
|
170
|
+
```bash
|
|
171
|
+
curl -X POST https://<app>/internal/admin/data-seeding/rerun \
|
|
172
|
+
-H "X-Admin-Secret: $APPLICATION_ADMIN_SECRET" \
|
|
173
|
+
-H "Content-Type: application/json" \
|
|
174
|
+
-d '{
|
|
175
|
+
"seedKeys": ["system-emails:welcome"],
|
|
176
|
+
"scope": { "kind": "application" },
|
|
177
|
+
"force": false
|
|
178
|
+
}'
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Three field semantics:
|
|
182
|
+
|
|
183
|
+
- **`seedKeys[]`** — at least one required. Re-runs all named
|
|
184
|
+
seeds against the same `scope`.
|
|
185
|
+
- **`scope`** — explicitly declared (the dispatcher does NOT derive
|
|
186
|
+
scope from the request context for `runManual`, unlike
|
|
187
|
+
`runLazy`). Discriminated by `kind`; `relatedId` /
|
|
188
|
+
`relatedResourceType` populated as required by the kind
|
|
189
|
+
(`relatedId` for `ORGANIZATION` / `USER` / `CUSTOM`;
|
|
190
|
+
`relatedResourceType` for `CUSTOM` only).
|
|
191
|
+
- **`force?: boolean`** — only meaningful for LAZY seeds. When
|
|
192
|
+
`true`, the dispatcher paginates and DELETES every prior
|
|
193
|
+
COMPLETED `DataSeedRun` row for the seed × scope before
|
|
194
|
+
re-running. Without `force`, a LAZY seed whose prior run
|
|
195
|
+
COMPLETED short-circuits via the C1 cache. ADDITIVE / UPGRADE /
|
|
196
|
+
SYNC always re-run on `seed.version` bump regardless of `force`.
|
|
197
|
+
|
|
198
|
+
External-cron bridge: operators that need periodic re-runs
|
|
199
|
+
WITHOUT declaring `schedule?` (e.g. cross-tenant orchestration
|
|
200
|
+
beyond the host-app's child set) can invoke this endpoint from a
|
|
201
|
+
k8s `CronJob` with the secret header. The external cron is the
|
|
202
|
+
deliberate substitute for in-process scheduling when the seed's
|
|
203
|
+
fan-out exceeds the engine batch's anchoring rules.
|
|
204
|
+
|
|
205
|
+
### Decision 3: Query the run ledger
|
|
206
|
+
|
|
207
|
+
Two endpoints cover the operator drill-in flow:
|
|
208
|
+
|
|
209
|
+
<!-- TIER C WAIVER: Side-by-side `/seeds` (overview) vs `/runs` (drill-in) endpoints; Decision 3's prose immediately below disambiguates the two by reference to these calls and the contrast is the load-bearing teaching. -->
|
|
210
|
+
```bash
|
|
211
|
+
# Overview: every registered seed with its latest run summary
|
|
212
|
+
curl https://<app>/internal/admin/data-seeding/seeds \
|
|
213
|
+
-H "X-Admin-Secret: $APPLICATION_ADMIN_SECRET"
|
|
214
|
+
|
|
215
|
+
# Drill-in: paginated raw DataSeedRun rows with filters
|
|
216
|
+
curl 'https://<app>/internal/admin/data-seeding/runs?seedKey=system-emails:welcome&status=failed&limit=10' \
|
|
217
|
+
-H "X-Admin-Secret: $APPLICATION_ADMIN_SECRET"
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
`GET /seeds` returns one DTO per registered seed with `lastRun`
|
|
221
|
+
populated (latest by `createdAt`, may belong to a different
|
|
222
|
+
`relatedId` for non-singleton scopes) and a `cachedVersionMismatch`
|
|
223
|
+
boolean (LAZY-only — true when the C1 cache is honouring an older
|
|
224
|
+
COMPLETED row whose `seedVersion` is below the declared version, so
|
|
225
|
+
a `force: true` re-run is required to apply the new version).
|
|
226
|
+
|
|
227
|
+
`GET /runs` filters: `seedKey`, `scopeKind`, `relatedId`,
|
|
228
|
+
`relatedResourceType`, `status`, `page` (default 1), `limit`
|
|
229
|
+
(default 50, max 100). Sort is fixed at `createdAt DESC`. Empty
|
|
230
|
+
filter lists every row.
|
|
231
|
+
|
|
232
|
+
The four `DataSeedRun.status` values:
|
|
233
|
+
|
|
234
|
+
| Status | Meaning | Operator action |
|
|
235
|
+
|--------|---------|-----------------|
|
|
236
|
+
| `RUNNING` | Pass started, no terminal outcome yet. Rows older than the startup window are treated as crashed and re-run by the next dispatcher pass. | Wait one dispatcher cycle; if still RUNNING, the next cron tick or manual re-run will recover it via the same row (`upsertByBusinessKey`). |
|
|
237
|
+
| `COMPLETED` | Every entry succeeded. | None. `entriesAttempted == entriesInserted + entriesSkipped + entriesUpdated + entriesUpgraded` (per-mode). |
|
|
238
|
+
| `PARTIAL` | At least one entry failed but the pass did not abort. | Read `failureReport.entries[]` for per-entry error context. Re-run the seed; PARTIAL passes are idempotent (successful entries skip on the retry, failed ones retry). |
|
|
239
|
+
| `FAILED` | The pass threw before reaching its terminal phase, or every entry failed. | Read `failureReport.passLevelError` (pass-level throw) AND `failureReport.entries[]` (entry-level failures). Common causes: registry mis-config, exec-context build failure, transport outage. |
|
|
240
|
+
|
|
241
|
+
For SYNC passes, also read `failureReport.orphans[]` — every
|
|
242
|
+
orphan (missing entry vs persisted row) is recorded with its
|
|
243
|
+
`action` (`DELETE` / `DEPRECATE` / `REPORT`) and `businessKey` even
|
|
244
|
+
when `onOrphan === REPORT` (the only place the diff lives in
|
|
245
|
+
that case).
|
|
246
|
+
|
|
247
|
+
### Decision 4: Configure + observe
|
|
248
|
+
|
|
249
|
+
Two operator-tunable knobs and one Prometheus counter:
|
|
250
|
+
|
|
251
|
+
**`APPLICATION_ADMIN_SECRET` (env var)** — secret for the
|
|
252
|
+
`X-Admin-Secret` header. Read directly from `process.env`; NOT a
|
|
253
|
+
typed field on `ApplicationEnvConfigurationSchema`. Three failure
|
|
254
|
+
modes are kept distinct so operators can read the cause from the
|
|
255
|
+
HTTP response without consulting logs:
|
|
256
|
+
|
|
257
|
+
1. **Endpoints disabled** (env var unset/empty) → `503
|
|
258
|
+
INFRASTRUCTURE` — safe-default for fresh deployments. Set the
|
|
259
|
+
env var to high-entropy bytes (e.g. `openssl rand -base64 48`)
|
|
260
|
+
to enable the surface.
|
|
261
|
+
2. **Header missing** → `401 AUTHENTICATION` ("Missing X-Admin-
|
|
262
|
+
Secret header").
|
|
263
|
+
3. **Header mismatch** → `401 AUTHENTICATION` ("Invalid X-Admin-
|
|
264
|
+
Secret"). Constant-time compare via SHA-256 digests defeats the
|
|
265
|
+
timing oracle that a length-mismatch early-out would introduce.
|
|
266
|
+
|
|
267
|
+
Recommendation: rotate after every operator off-boarding and at
|
|
268
|
+
least quarterly. There is NO in-process throttle; deploy behind a
|
|
269
|
+
network-level rate limiter (LB / ingress).
|
|
270
|
+
|
|
271
|
+
**`dataSeeding.scheduledRerunCronSchedule` (`AppConfiguration_Shared_Schema.dataSeeding`)** —
|
|
272
|
+
operator override for the engine tick that wakes the
|
|
273
|
+
`data-seeding:scheduled-rerun` batch. Default `'* * * * *'`
|
|
274
|
+
(every minute). Per-seed cadence is encoded on each
|
|
275
|
+
`DataSeedDefinition.schedule.cron`; the engine tick must wake
|
|
276
|
+
frequently enough to honour every per-seed cron without surprising
|
|
277
|
+
drift. Override to a coarser cadence when no registered seed needs
|
|
278
|
+
minute-level precision (e.g. set to `'*/5 * * * *'` when every
|
|
279
|
+
seed runs hourly or daily).
|
|
280
|
+
|
|
281
|
+
**`data_seeding_run_total` (Prometheus counter)** — incremented
|
|
282
|
+
inside the shared ledger writers (`completeDataSeedRun` /
|
|
283
|
+
`failDataSeedRun` / `writeFreshFailedDataSeedRun`) so EVERY
|
|
284
|
+
`DataSeedRun` terminal write across ALL engines (ADDITIVE /
|
|
285
|
+
UPGRADE / SYNC / LAZY / runManual) is counted exactly once with no
|
|
286
|
+
per-engine drift. Labels: `seed`, `status`, `triggerOrigin`. Use
|
|
287
|
+
this counter for cross-engine outcome attribution (e.g. "every
|
|
288
|
+
PARTIAL pass on the `welcome-emails` seed across LAZY + manual
|
|
289
|
+
re-runs in the last 24 hours").
|
|
290
|
+
|
|
291
|
+
### Decision 5: Boot wiring (deep)
|
|
292
|
+
|
|
293
|
+
`runDataSeedingApplicationBootstrap` is invoked once during app
|
|
294
|
+
startup (Step 7.7). The order matters; understanding it explains
|
|
295
|
+
every "why did this seed fire / not fire / fire twice" question.
|
|
296
|
+
|
|
297
|
+
The bootstrap fires this sequence (each step's annotation explains
|
|
298
|
+
when it runs):
|
|
299
|
+
|
|
300
|
+
1. `registry.registerSeeds(seeds)` — ALWAYS, even in platform mode
|
|
301
|
+
2. `scopeResolverRegistry.registerResolvers(map)` — ALWAYS, even when
|
|
302
|
+
`map` is `{}`
|
|
303
|
+
3. `wireLevelBResourceLifecycleHooks(...)` — ALWAYS; pre/post hooks
|
|
304
|
+
per resource type
|
|
305
|
+
4. `wireLazyAccessGuards(...)` — ALWAYS; pre-only hooks per
|
|
306
|
+
`(resourceType, operation)`
|
|
307
|
+
5. `if isPlatformMode → return` — platform apps-manager skips dispatch
|
|
308
|
+
6. `dispatcher.runApplicationLifecycle('onAppInit')`
|
|
309
|
+
7. `dispatcher.runApplicationLifecycle('onAppVersionUpgrade')`
|
|
310
|
+
|
|
311
|
+
Three operational consequences:
|
|
312
|
+
|
|
313
|
+
- **Platform mode** (apps-manager) registers seeds but does NOT
|
|
314
|
+
dispatch. Tenant apps boot through their own
|
|
315
|
+
`StartApplicationBackendService.initialize()` and run their own
|
|
316
|
+
Level-A pass. Lookups for "why did the seed not fire on the
|
|
317
|
+
apps-manager process?" land here.
|
|
318
|
+
- **Hook wiring runs unconditionally** (even in platform mode,
|
|
319
|
+
even before the dispatch decision). A Level-B seed registered on
|
|
320
|
+
the apps-manager profile WILL fire when the apps-manager
|
|
321
|
+
process itself does a resource-lifecycle write on the named
|
|
322
|
+
resource (rare in practice but possible).
|
|
323
|
+
- **`onAppInit` precedes `onAppVersionUpgrade`** — required because
|
|
324
|
+
the upgrade pass may mutate rows created by the init pass.
|
|
325
|
+
Reversing the order would cause UPGRADE seeds to walk migrators
|
|
326
|
+
on rows that don't exist yet, then fail their `entriesAttempted`
|
|
327
|
+
loop.
|
|
328
|
+
|
|
329
|
+
A fatal throw from either dispatch pass propagates unchanged. The
|
|
330
|
+
intentional recovery surface is the dispatcher's FAILED
|
|
331
|
+
`DataSeedRun` ledger entries (the next boot retries any
|
|
332
|
+
non-terminal row); a try/catch here would hide a half-applied
|
|
333
|
+
seed corpus and silently break downstream ops.
|
|
334
|
+
|
|
335
|
+
## Workflow
|
|
336
|
+
|
|
337
|
+
### Workflow A: Schedule a seed for periodic re-run
|
|
338
|
+
|
|
339
|
+
1. Confirm the seed is NOT `mode === LAZY` (factory rejects the
|
|
340
|
+
pair).
|
|
341
|
+
2. Pick the cron expression — standard 5-field crontab. Use the
|
|
342
|
+
coarsest cadence that meets the operational need; the engine
|
|
343
|
+
tick (default minute) is the upper bound on responsiveness.
|
|
344
|
+
3. Pick the iteration strategy from the table in Decision 1. If
|
|
345
|
+
the strategy is `CUSTOM_RESOLVER`, register the resolver under
|
|
346
|
+
`BackendDomainModule.dataSeedScopeResolvers` in the same
|
|
347
|
+
commit (see [Custom resolver registration](#app-paths)).
|
|
348
|
+
4. Add the `schedule?` block to the seed's `createDataSeedDefinition({...})`
|
|
349
|
+
call. Run the unit test for the seed file (factory invariants
|
|
350
|
+
reject every misalignment at parse time).
|
|
351
|
+
5. Verify the engine cron batch will register at boot:
|
|
352
|
+
`StartApplicationBackendService.initialize()` registers it iff
|
|
353
|
+
`(dataSeeds ?? []).some((seed) => seed.schedule !== undefined)`,
|
|
354
|
+
so the first `schedule?` block in the corpus opts the entire
|
|
355
|
+
app into the cron batch.
|
|
356
|
+
|
|
357
|
+
### Workflow B: Re-run a seed manually (operator)
|
|
358
|
+
|
|
359
|
+
1. Confirm `APPLICATION_ADMIN_SECRET` is set on the target app
|
|
360
|
+
process. If `503 INFRASTRUCTURE`, set the env var and restart.
|
|
361
|
+
2. Identify the seed key + scope. For app-scoped seeds, scope is
|
|
362
|
+
`{ kind: 'application' }`. For `CUSTOM`-scope seeds, supply
|
|
363
|
+
both `relatedResourceType` and `relatedId`.
|
|
364
|
+
3. Decide on `force`: only LAZY benefits from `force: true` (deletes
|
|
365
|
+
prior COMPLETED rows so the next access re-runs the body).
|
|
366
|
+
ADDITIVE / UPGRADE / SYNC re-run on `seed.version` bump
|
|
367
|
+
regardless.
|
|
368
|
+
4. `POST /internal/admin/data-seeding/rerun` with the `X-Admin-
|
|
369
|
+
Secret` header. The response is the `DataSeedManualReport`
|
|
370
|
+
verbatim (same shape the dispatcher's tests assert against).
|
|
371
|
+
5. Inspect the response's per-seed `runs[]` for outcome (status,
|
|
372
|
+
counters, failureReport). For PARTIAL/FAILED runs, drill into
|
|
373
|
+
`failureReport.entries[]` and `failureReport.passLevelError`.
|
|
374
|
+
|
|
375
|
+
### Workflow C: Investigate a stuck or failed run
|
|
376
|
+
|
|
377
|
+
1. `GET /seeds` to find the seed's `lastRun` summary.
|
|
378
|
+
2. If `cachedVersionMismatch === true` for a LAZY seed → re-run
|
|
379
|
+
with `force: true` to clear the C1 cache.
|
|
380
|
+
3. `GET /runs?seedKey=<key>` for the per-scope run history (sort
|
|
381
|
+
`createdAt DESC`, page 1 is the most recent).
|
|
382
|
+
4. For `RUNNING` rows older than the startup window: do nothing —
|
|
383
|
+
the next dispatcher pass will recover via `upsertByBusinessKey`
|
|
384
|
+
on the same row.
|
|
385
|
+
5. For `PARTIAL` / `FAILED` rows: read `failureReport.entries[*].error`
|
|
386
|
+
(per-entry `WildoError_BackendSchema` payload) and
|
|
387
|
+
`failureReport.passLevelError` (pass-level throw, `null` when
|
|
388
|
+
every failure was entry-scoped). For SYNC passes, also read
|
|
389
|
+
`failureReport.orphans[]` (recorded even on COMPLETED runs when
|
|
390
|
+
`onOrphan === REPORT`).
|
|
391
|
+
6. After remediation, re-run the seed via Workflow B. Successful
|
|
392
|
+
entries skip on the retry; failed ones retry.
|
|
393
|
+
|
|
394
|
+
### Workflow D: Tune the engine cron tick
|
|
395
|
+
|
|
396
|
+
1. Identify the coarsest per-seed cron in the registered corpus
|
|
397
|
+
(`GET /seeds`, scan `schedule.cron` per seed).
|
|
398
|
+
2. Pick an engine tick at most as coarse as that seed (the tick
|
|
399
|
+
bounds responsiveness — a 5-minute tick can never fire a seed
|
|
400
|
+
whose own cron is `'* * * * *'`).
|
|
401
|
+
3. Set `dataSeeding.scheduledRerunCronSchedule` on the
|
|
402
|
+
environment's `wildo.infra.<env>.config.ts` (the resolved
|
|
403
|
+
`AppConfiguration_Shared_Schema.dataSeeding`).
|
|
404
|
+
4. Restart the app process. The cron registration is gated at
|
|
405
|
+
boot; live config changes are NOT picked up.
|
|
406
|
+
|
|
407
|
+
## References
|
|
408
|
+
|
|
409
|
+
- `references/framework-data-seeding-operations-api.md` — the four
|
|
410
|
+
source-anchored API surfaces (cron schedule + iteration strategy,
|
|
411
|
+
admin endpoint constants, run ledger + status enum, bootstrap
|
|
412
|
+
wiring contract). Authoritative when JSDoc ↔ runbook diverge.
|
|
413
|
+
- `references/data-seeding-cron-scheduler.md` — extended runbook
|
|
414
|
+
for Decisions 1 + 4: per-tick algorithm, alignment matrix, when
|
|
415
|
+
to use `CUSTOM_RESOLVER`, fan-out anchoring rules.
|
|
416
|
+
- `references/data-seeding-admin-runbook.md` — extended runbook
|
|
417
|
+
for Decisions 2 + 3 + 5: `curl` recipes, ledger-status decision
|
|
418
|
+
tree, boot-wiring trace for "why did/didn't the seed fire"
|
|
419
|
+
questions.
|
|
420
|
+
|
|
421
|
+
## Verification
|
|
422
|
+
|
|
423
|
+
- [ ] Seed declares `schedule?` block iff cron-eligibility is
|
|
424
|
+
desired (LAZY rejects this combination)
|
|
425
|
+
- [ ] `schedule.iterationStrategy` aligns with `seed.scope.kind`
|
|
426
|
+
per the matrix in Decision 1
|
|
427
|
+
- [ ] `schedule.customResolverKey` present iff `iterationStrategy
|
|
428
|
+
=== CUSTOM_RESOLVER`
|
|
429
|
+
- [ ] Custom resolver registered in
|
|
430
|
+
`BackendDomainModule.dataSeedScopeResolvers` in the same
|
|
431
|
+
commit as the seed declaring it
|
|
432
|
+
- [ ] `APPLICATION_ADMIN_SECRET` set on every environment that
|
|
433
|
+
needs the admin surface enabled (otherwise `503
|
|
434
|
+
INFRASTRUCTURE`)
|
|
435
|
+
- [ ] Operators have a tested `curl` recipe for the seed they may
|
|
436
|
+
need to re-run (Workflow B)
|
|
437
|
+
- [ ] `dataSeeding.scheduledRerunCronSchedule` override (if any)
|
|
438
|
+
is at most as coarse as the coarsest per-seed cron in the
|
|
439
|
+
registered corpus
|
|
440
|
+
|
|
441
|
+
### Grep invariants
|
|
442
|
+
|
|
443
|
+
Run from the app root, substituting `<module>` and `<seed-key>`:
|
|
444
|
+
|
|
445
|
+
| Invariant | Command |
|
|
446
|
+
|-----------|---------|
|
|
447
|
+
| Seed declares a `schedule?` block | `rg -n "schedule:\s*\{" backend-api/src/modules/<module>/seeds/` |
|
|
448
|
+
| Custom resolver registered when CUSTOM_RESOLVER used | `rg -n "dataSeedScopeResolvers:" backend-api/src/modules/<module>/index.ts` |
|
|
449
|
+
| Engine cron tick override declared | `rg -n "scheduledRerunCronSchedule" infrastructure/` |
|
|
450
|
+
| `APPLICATION_ADMIN_SECRET` provisioned | `rg -n "APPLICATION_ADMIN_SECRET" ../wildo-secrets/environments/` |
|
|
451
|
+
|
|
452
|
+
The high-signal invariants are **"`schedule?` declared in the seed
|
|
453
|
+
file"** combined with **"custom resolver registered when
|
|
454
|
+
`CUSTOM_RESOLVER` is the chosen strategy"** — a missing resolver
|
|
455
|
+
silently iterates zero rows on every cron tick (no error, no
|
|
456
|
+
failed run row, no observable signal except a flat
|
|
457
|
+
`data_seeding_run_total` counter for that seed).
|
|
458
|
+
|
|
459
|
+
## Common Rationalizations
|
|
460
|
+
|
|
461
|
+
| Rationalization | Reality |
|
|
462
|
+
|-----------------|---------|
|
|
463
|
+
| "I'll just declare `schedule?` on the LAZY seed; it'll re-run on the cron tick" | Factory rejects (`mode === LAZY` × `schedule` is N10). LAZY's contract is "first access creates the row, never re-applied" — periodic re-runs would either duplicate rows (no idempotency on the second access) or contradict the cache semantics (force a cache invalidation on every tick, which is a `force: true` re-run, which deletes COMPLETED rows). If you want periodic re-run, switch to ADDITIVE / UPGRADE / SYNC. |
|
|
464
|
+
| "I'll set `force: true` on every manual re-run to be safe" | `force: true` only affects LAZY seeds (it deletes prior COMPLETED rows so the next access re-runs the body). For ADDITIVE / UPGRADE / SYNC it is a no-op. Setting it indiscriminately costs nothing on those modes but signals confusion in the `runManual` audit trail (`triggeredByUserId` + payload echoed in logs). |
|
|
465
|
+
| "I'll skip `APPLICATION_ADMIN_SECRET` since the endpoints are internal" | The endpoints mount on `/internal/admin/data-seeding` but are NOT firewalled by path. Without the env var, every endpoint returns `503 INFRASTRUCTURE` (safe-default). Set the secret AND deploy behind a network-level rate limiter (LB / ingress) — there is NO in-process throttle. |
|
|
466
|
+
| "I'll override the engine tick to `'*/30 * * * * *'` (every 30 seconds) for faster propagation" | 6-field "second-aware" cron is NOT supported by the parser. The minimum is 5-field (1-minute resolution). If you need sub-minute responsiveness, restructure the seed to fire on a Level-B trigger or LAZY access instead — those run synchronously inside the request that needs them. |
|
|
467
|
+
| "The seed's `lastRun` is RUNNING, I'll DELETE the row to retry" | The dispatcher uses `upsertByBusinessKey` on `(seedKey, scope, version)` — the next dispatcher pass (cron tick or manual re-run) PATCHES the existing RUNNING row to its terminal state. DELETE-ing the row is rarely needed; only do it when the row is `RUNNING` AND the dispatcher's recovery window has expired AND the next pass is not coming soon enough. |
|
|
468
|
+
|
|
469
|
+
## Red Flags
|
|
470
|
+
|
|
471
|
+
- A seed declares `schedule?` but its `iterationStrategy` is
|
|
472
|
+
`CUSTOM_RESOLVER` and no resolver is registered in the module's
|
|
473
|
+
`dataSeedScopeResolvers` slot (silent zero-row iteration on every
|
|
474
|
+
tick — flat `data_seeding_run_total` for that seed)
|
|
475
|
+
- `APPLICATION_ADMIN_SECRET` set to a low-entropy string (e.g.
|
|
476
|
+
`admin123`) — the constant-time SHA-256 compare defeats the
|
|
477
|
+
timing oracle but a brute-forced secret defeats the secret
|
|
478
|
+
- A `RUNNING` `DataSeedRun` row older than 1 hour — usually means
|
|
479
|
+
the app process crashed mid-pass; the next dispatcher pass will
|
|
480
|
+
recover via `upsertByBusinessKey`, but if no pass is scheduled
|
|
481
|
+
(no cron, no manual re-run), the row stays RUNNING
|
|
482
|
+
- A SYNC seed with `onOrphan: DELETE` was re-run on production
|
|
483
|
+
data and the operator is surprised by the orphan set — always
|
|
484
|
+
run with `onOrphan: REPORT` first on production, audit the
|
|
485
|
+
orphan set, THEN switch to `DELETE` (Decision 5 / Workflow C in
|
|
486
|
+
`seeding-authoring`)
|
|
487
|
+
- The cron seed isn't firing AND `(dataSeeds ?? []).some((seed) =>
|
|
488
|
+
seed.schedule !== undefined)` is `true` AND the engine tick is
|
|
489
|
+
coarser than the seed's own cron — the tick bounds the seed
|
|
490
|
+
cron's resolution; tune the tick down
|
|
491
|
+
|
|
492
|
+
## Related Skills
|
|
493
|
+
|
|
494
|
+
- [`seeding-authoring`](../seeding-authoring/SKILL.md) — author a
|
|
495
|
+
`DataSeedDefinition` end-to-end (Level / mode / business key /
|
|
496
|
+
managed fields / rename ledger). The `schedule?` block is one
|
|
497
|
+
of the optional inputs covered there.
|
|
498
|
+
- `infra-environment-config` — populate
|
|
499
|
+
`dataSeeding.scheduledRerunCronSchedule` and
|
|
500
|
+
`APPLICATION_ADMIN_SECRET` on the environment's
|
|
501
|
+
`wildo.infra.<env>.config.ts` and `wildo-secrets/environments/<env>/`.
|
|
502
|
+
- `backend-addon-wiring` — the
|
|
503
|
+
`BackendDomainModule.dataSeedScopeResolvers?` slot on the
|
|
504
|
+
module backend record (alongside `seeds`, `operations`,
|
|
505
|
+
`controllers`, `flowsActors`).
|