@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,439 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: email-add-template
|
|
3
|
+
description: Add an email template end-to-end — React Email `template.tsx`, co-located typed `labels.<locale>.ts`, the typed `EmailTemplateDefinition<TLabels>` shape, registration in `module-email-template-definitions.ts`, and the i18n follow-up. Self-contained orchestrator that absorbs the three layer concerns (template authoring · label authoring · registry wiring). Use when the user says "add a transactional email for <event>", "introduce a new notification email", "scaffold an email template called <name>", "send users an email when <event happens>", "wire the new welcome email so it actually sends", "edit the password-reset email JSX", "add labels for the invoice email", or any request that produces a new entry in the module's email definitions map.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Email Add Template
|
|
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
|
+
End-to-end **email template** addition — the canonical orchestrator
|
|
23
|
+
covering all three layers of the email surface in one workflow:
|
|
24
|
+
|
|
25
|
+
1. **Template authoring** — the React Email `template.tsx` source
|
|
26
|
+
declaring the typed `EmailTemplateDefinition<TLabels>` (subject,
|
|
27
|
+
body, type, description). Pure function of
|
|
28
|
+
`EmailTemplateProps<TLabels>`; no global state, no network calls.
|
|
29
|
+
2. **Label authoring** — the co-located `labels.<locale>.ts` files,
|
|
30
|
+
one per locale, each satisfying the template's `TLabels`
|
|
31
|
+
interface key-for-key.
|
|
32
|
+
3. **Registration wiring** — the `module-email-template-definitions.ts`
|
|
33
|
+
entry that registers the template with the module's email
|
|
34
|
+
registry so the runtime sender + companion preview can resolve it
|
|
35
|
+
by id.
|
|
36
|
+
|
|
37
|
+
The **definition shape is stable** (enforced by
|
|
38
|
+
`EmailTemplateDefinition<TLabels>`) even though the application-level
|
|
39
|
+
email tree itself is volatile (templates come and go per product
|
|
40
|
+
needs). The framework consumes the registered definition to render,
|
|
41
|
+
queue, and dispatch the message; the i18n pipeline consumes the
|
|
42
|
+
labels to backfill non-primary locales.
|
|
43
|
+
|
|
44
|
+
This skill is **self-contained**: every step (template, labels,
|
|
45
|
+
registry, i18n) lives here, with grep invariants that catch the
|
|
46
|
+
drift modes per layer. Do not split the work across skills — the
|
|
47
|
+
three leaves (`email-template-authoring`, `email-labels-authoring`,
|
|
48
|
+
`email-definition-wiring`) are now redirect stubs that point back
|
|
49
|
+
here.
|
|
50
|
+
|
|
51
|
+
## App Paths
|
|
52
|
+
|
|
53
|
+
| Surface | Glob (relative to app root) |
|
|
54
|
+
|---------------------|------------------------------------------------------------------------------------------|
|
|
55
|
+
| Template source | `backend-api/src/notifications/email/<template-name>/template.tsx` (typed `EmailTemplateDefinition<TLabels>`) |
|
|
56
|
+
| Per-locale labels | `backend-api/src/notifications/email/<template-name>/labels.<locale>.ts` (satisfies `TLabels`) |
|
|
57
|
+
| Labels interface | Co-located in `template.tsx` (e.g. `interface WelcomeLabels { subject: string; ... }`) |
|
|
58
|
+
| Module definitions | `backend-api/src/notifications/email/module-email-template-definitions.ts` (or app equivalent — `EmailTemplateDefinitionsMap`) |
|
|
59
|
+
| Email type enum | `shared-lib/src/modules/<module>/notifications/<module>-email-template-type.ts` (typed template ids) |
|
|
60
|
+
| Sender call sites | `backend-api/src/modules/<module>/**/*.service.ts` (resolves the template by typed id) |
|
|
61
|
+
|
|
62
|
+
## When to Use
|
|
63
|
+
|
|
64
|
+
- New transactional email (welcome, password reset, invoice, OTP)
|
|
65
|
+
- New notification variant that needs its own template id
|
|
66
|
+
- Editing an existing template's JSX, labels, or registration
|
|
67
|
+
(single skill covers all three layers)
|
|
68
|
+
- Adding a second locale to an existing template
|
|
69
|
+
- Renaming a template id (registration + sender call-site sweep
|
|
70
|
+
in one pass)
|
|
71
|
+
|
|
72
|
+
## When NOT to Use
|
|
73
|
+
|
|
74
|
+
- Only translating already-shipped copy → `i18n-translation-rerun`
|
|
75
|
+
(this skill's Step 6 covers the trigger; the dedicated skill
|
|
76
|
+
drives the translation pipeline itself)
|
|
77
|
+
- Only adjusting design tokens that affect rendered email theme →
|
|
78
|
+
`config-design-system`
|
|
79
|
+
- Sending an in-app notification (toast / inbox), not an email →
|
|
80
|
+
`notifications_in_app`
|
|
81
|
+
- App-wide UI label generation (not email-specific) →
|
|
82
|
+
`i18n-label-generation`. Email labels follow a **separate
|
|
83
|
+
template-colocated pipeline** (the per-template `labels.<locale>.ts`
|
|
84
|
+
files in this skill's Step 3); they are NOT swept by
|
|
85
|
+
`wildo generate labels` / `scanCustomLabelsDirectory`.
|
|
86
|
+
|
|
87
|
+
## Workflow
|
|
88
|
+
|
|
89
|
+
### Step 1: Mirror a sibling template
|
|
90
|
+
|
|
91
|
+
Copy the **folder layout** from the closest existing template in
|
|
92
|
+
the same backend (`backend-api/src/notifications/email/<sibling>/`).
|
|
93
|
+
Mirror **structure**, not content:
|
|
94
|
+
|
|
95
|
+
- `template.tsx` co-located with the labels interface
|
|
96
|
+
- One `labels.<locale>.ts` per supported locale
|
|
97
|
+
- Sibling registration entry as the shape reference
|
|
98
|
+
|
|
99
|
+
This sets the right scaffolding before any of the three layers
|
|
100
|
+
gets edited.
|
|
101
|
+
|
|
102
|
+
### Step 2: Author `template.tsx` (template layer)
|
|
103
|
+
|
|
104
|
+
Author the React Email body. Product templates are intentionally volatile;
|
|
105
|
+
the canonical shape is delivered through the source-backed reference below.
|
|
106
|
+
|
|
107
|
+
Constraints:
|
|
108
|
+
|
|
109
|
+
- **React Email primitives only** (`Html`, `Body`, `Container`,
|
|
110
|
+
`Heading`, `Text`, `Section`, `Button`, `Link`, `Hr`). Custom
|
|
111
|
+
`<div>` / raw HTML breaks inbox rendering across major mail
|
|
112
|
+
clients (Gmail / Outlook / Apple Mail strip or rewrite arbitrary
|
|
113
|
+
layout markup; React Email primitives are inlined-CSS-tested
|
|
114
|
+
against this matrix).
|
|
115
|
+
- **No app SPA imports** in the template. Email compiles in a
|
|
116
|
+
separate bundle without React DOM context; a stray `frontend/` import
|
|
117
|
+
pulls in Vite / browser-only globals that fail at render.
|
|
118
|
+
- **Typed `EmailTemplateDefinition<TLabels>`** — declare the labels
|
|
119
|
+
interface alongside the template (`interface <Name>Labels { ... }`)
|
|
120
|
+
and parameterize the definition with it. Plain
|
|
121
|
+
`EmailTemplateDefinition` (no generic) silently allows
|
|
122
|
+
unrestricted label access; `EmailTemplateDefinition<any>` defeats
|
|
123
|
+
the i18n contract.
|
|
124
|
+
- **`subject` and `body` are pure functions of `EmailTemplateProps<TLabels>`** —
|
|
125
|
+
they receive `context`, `brand`, `labels`. No global state, no
|
|
126
|
+
network calls, no side effects. This is what makes preview /
|
|
127
|
+
test-send / queue replay deterministic.
|
|
128
|
+
- **`brand.backgroundColor` etc. read from props** — never hard-code
|
|
129
|
+
brand colors / domain URLs. The same template renders in dev /
|
|
130
|
+
staging / production with different brand contexts.
|
|
131
|
+
- **`type: EmailTemplateType.*`** — declare the dispatch class on
|
|
132
|
+
the first commit. Transactional vs broadcast affects queueing,
|
|
133
|
+
unsubscribe handling, and deliverability scoring; there is no
|
|
134
|
+
safe default.
|
|
135
|
+
- **`description: string`** in business voice — surfaces in the
|
|
136
|
+
companion's operator dashboards.
|
|
137
|
+
|
|
138
|
+
Read `references/framework-email-template-api.md` for the full
|
|
139
|
+
`EmailTemplateDefinition` contract.
|
|
140
|
+
|
|
141
|
+
### Step 3: Author `labels.<locale>.ts` files (label layer)
|
|
142
|
+
|
|
143
|
+
Co-locate one `labels.<locale>.ts` file per supported locale next
|
|
144
|
+
to `template.tsx`. Each file:
|
|
145
|
+
|
|
146
|
+
- **Satisfies the `TLabels` interface key-for-key.** The compiler
|
|
147
|
+
rejects a labels file that omits a key the template references.
|
|
148
|
+
- **Namespaces keys by template** (the `TLabels` interface name
|
|
149
|
+
enforces this; sibling templates declare their own interfaces).
|
|
150
|
+
No shared key namespace across templates — each template owns
|
|
151
|
+
its label vocabulary.
|
|
152
|
+
- **Includes the subject line as a label** when the app uses
|
|
153
|
+
localized subjects (typical). Subjects in the JSX are strings
|
|
154
|
+
too; route them through `labels.subject` so translation reaches them.
|
|
155
|
+
- **Stays parallel across locales** — every locale file declares
|
|
156
|
+
the same key set. The "primary locale done, secondary lagging"
|
|
157
|
+
pattern is the most common silent drift; treat new keys as
|
|
158
|
+
"missing in every secondary locale" until proven otherwise.
|
|
159
|
+
|
|
160
|
+
For new locales on an existing template, add a `labels.<new>.ts`
|
|
161
|
+
file with the same `TLabels` shape; the i18n translation pipeline
|
|
162
|
+
(Step 6) backfills the values.
|
|
163
|
+
|
|
164
|
+
Read `references/email-artifact-paths.md` for naming /
|
|
165
|
+
co-location conventions.
|
|
166
|
+
|
|
167
|
+
### Step 4: Register in `module-email-template-definitions.ts` (registry layer)
|
|
168
|
+
|
|
169
|
+
Add the typed registry entry. Without this entry the template is
|
|
170
|
+
**unreachable at runtime** — the sender resolves templates by id
|
|
171
|
+
through the registry, never by direct import.
|
|
172
|
+
|
|
173
|
+
The registry entry must:
|
|
174
|
+
|
|
175
|
+
- **Use a stable typed id** — typically a member of the module's
|
|
176
|
+
`<module>EmailTemplateType` enum (in
|
|
177
|
+
`shared-lib/src/modules/<module>/notifications/`). String
|
|
178
|
+
literals drift; the typed enum gives autocomplete + refactor
|
|
179
|
+
safety + collision-prevention across modules.
|
|
180
|
+
- **Match the path on disk** — the registry value points at the
|
|
181
|
+
template definition exported by `template.tsx`. Mistyped paths
|
|
182
|
+
pass TypeScript (the value is the imported binding, not a
|
|
183
|
+
string) but the import statement at the top of the registry file
|
|
184
|
+
is the place the path lives — keep it tight.
|
|
185
|
+
- **Live in the module that owns the business use-case** — a
|
|
186
|
+
password-reset email belongs in the identity module's registry,
|
|
187
|
+
not in a generic shared registry. Ownership-first placement
|
|
188
|
+
keeps the email surface module-coherent.
|
|
189
|
+
- **Sender call sites resolve by id** — never `import { template }
|
|
190
|
+
from '.../<template-name>/template'` in the sending service. The
|
|
191
|
+
sender takes the typed id and goes through the framework's
|
|
192
|
+
email-dispatch service.
|
|
193
|
+
|
|
194
|
+
Read `references/email-artifact-paths.md` for the registry's
|
|
195
|
+
location conventions.
|
|
196
|
+
|
|
197
|
+
### Step 5: Preview / test-send
|
|
198
|
+
|
|
199
|
+
Use the project's email preview / test-send command (typically
|
|
200
|
+
via the dev companion's email surface or `pnpm wildo email
|
|
201
|
+
preview <template-id>`) to verify:
|
|
202
|
+
|
|
203
|
+
- The template renders cleanly with the labels file
|
|
204
|
+
- The subject + body resolve correct strings (no missing keys, no
|
|
205
|
+
raw key fall-through)
|
|
206
|
+
- Brand context applies (logo, color, footer)
|
|
207
|
+
- The companion lists the template as **registered** (the
|
|
208
|
+
registry layer worked)
|
|
209
|
+
|
|
210
|
+
### Step 6: Trigger the i18n pipeline
|
|
211
|
+
|
|
212
|
+
If new label keys were introduced (Step 3), run the translation
|
|
213
|
+
pipeline so non-primary locales backfill. This is the
|
|
214
|
+
`i18n-rerun-pipeline` orchestrator's territory — drive it from
|
|
215
|
+
here on every template change-set rather than deferring to QA.
|
|
216
|
+
|
|
217
|
+
### Re-run Translation When Text Changes
|
|
218
|
+
|
|
219
|
+
If this work changes user-facing text, labels, descriptions, or enum-facing copy,
|
|
220
|
+
re-run the translation workflow before considering the task complete.
|
|
221
|
+
|
|
222
|
+
Use the project translation command/path that applies to the current app/module,
|
|
223
|
+
then verify that generated translation artifacts are updated consistently with
|
|
224
|
+
the source-language change.
|
|
225
|
+
|
|
226
|
+
|
|
227
|
+
## Worked Example
|
|
228
|
+
|
|
229
|
+
Product email trees are intentionally volatile (templates come and go per
|
|
230
|
+
product need), so the **canonical shape** is delivered through the
|
|
231
|
+
source-backed reference. The extract below is the minimal canonical
|
|
232
|
+
template — the same shape applies to a real `WelcomeEmailDefinition`,
|
|
233
|
+
`InvoiceEmailDefinition`, etc.:
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
## Usage Example
|
|
237
|
+
|
|
238
|
+
```tsx
|
|
239
|
+
import * as React from 'react';
|
|
240
|
+
import { Body, Container, Heading, Html, Text } from '@react-email/components';
|
|
241
|
+
import { EmailTemplateType } from '@wildo-ai/saas-models';
|
|
242
|
+
import type {
|
|
243
|
+
EmailTemplateDefinition,
|
|
244
|
+
EmailTemplateProps,
|
|
245
|
+
} from '~wildo-backend-lib/notifications/email/models/email-template-definition';
|
|
246
|
+
|
|
247
|
+
export interface MinimalExampleLabels {
|
|
248
|
+
subject: string;
|
|
249
|
+
greeting: string;
|
|
250
|
+
body: string;
|
|
251
|
+
ctaLabel: string;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
const subject = ({ labels }: EmailTemplateProps<MinimalExampleLabels>): string =>
|
|
255
|
+
labels.subject;
|
|
256
|
+
|
|
257
|
+
const body = ({
|
|
258
|
+
context,
|
|
259
|
+
brand,
|
|
260
|
+
labels,
|
|
261
|
+
}: EmailTemplateProps<MinimalExampleLabels>): React.ReactElement => (
|
|
262
|
+
// `context.objectContext.primaryScopeContext` exposes app- and org-level
|
|
263
|
+
// identifiers a real template would use to build absolute URLs; the static
|
|
264
|
+
// path below keeps this minimal example focused on shape, not on routing.
|
|
265
|
+
<Html>
|
|
266
|
+
<Body style={{ backgroundColor: brand.backgroundColor }}>
|
|
267
|
+
<Container>
|
|
268
|
+
<Heading>{labels.greeting}</Heading>
|
|
269
|
+
<Text>{labels.body}</Text>
|
|
270
|
+
<Text>
|
|
271
|
+
<a href="/inbox">{labels.ctaLabel}</a>
|
|
272
|
+
</Text>
|
|
273
|
+
</Container>
|
|
274
|
+
</Body>
|
|
275
|
+
</Html>
|
|
276
|
+
);
|
|
277
|
+
|
|
278
|
+
const minimalEmailTemplate: EmailTemplateDefinition<MinimalExampleLabels> = {
|
|
279
|
+
subject,
|
|
280
|
+
body,
|
|
281
|
+
type: EmailTemplateType.TRANSACTIONAL,
|
|
282
|
+
description: 'Notify the recipient that <event happened> and link them back to the relevant in-app surface.',
|
|
283
|
+
};
|
|
284
|
+
|
|
285
|
+
export default minimalEmailTemplate;
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
What earns its place:
|
|
289
|
+
|
|
290
|
+
- `EmailTemplateDefinition<MinimalExampleLabels>` — the definition
|
|
291
|
+
is **typed against the labels interface**. The compiler refuses
|
|
292
|
+
to ship a template whose `subject` / `body` reaches for a label
|
|
293
|
+
key that doesn't exist. Drop the generic and you lose the i18n
|
|
294
|
+
contract.
|
|
295
|
+
- `MinimalExampleLabels` is a **dedicated TypeScript interface**
|
|
296
|
+
exporting one key per user-visible string. Inline strings in JSX
|
|
297
|
+
are banned; per-locale files satisfy this interface key-for-key,
|
|
298
|
+
and the i18n pipeline reads it as ground truth.
|
|
299
|
+
- `subject` and `body` are functions of
|
|
300
|
+
`EmailTemplateProps<TLabels>` — they receive `context`, `brand`,
|
|
301
|
+
`labels`. Never global state, never network calls, never side
|
|
302
|
+
effects. This keeps the template **pure and previewable** —
|
|
303
|
+
preview / test-send / queue replay produce identical output for
|
|
304
|
+
the same input.
|
|
305
|
+
- `body` returns React Email primitives (`Html`, `Body`,
|
|
306
|
+
`Container`, `Heading`, `Text`). Custom layout `<div>`s break
|
|
307
|
+
inbox rendering; React Email primitives are inlined-CSS-ready
|
|
308
|
+
and tested against major clients.
|
|
309
|
+
- `brand.backgroundColor` is read from `EmailTemplateProps['brand']` —
|
|
310
|
+
never hard-coded. This is what lets the same template render
|
|
311
|
+
correctly across themed environments (dev vs staging vs
|
|
312
|
+
production, white-label tenants).
|
|
313
|
+
- `type: EmailTemplateType.TRANSACTIONAL` — every template MUST
|
|
314
|
+
declare its dispatch class. Transactional and broadcast emails
|
|
315
|
+
follow different queueing, deliverability, and unsubscribe
|
|
316
|
+
rules; the framework needs the type at registration time, not
|
|
317
|
+
later.
|
|
318
|
+
- `description` is a one-sentence summary of when the template
|
|
319
|
+
fires. The companion engine surfaces it in operator dashboards,
|
|
320
|
+
so write it in business voice (not technical).
|
|
321
|
+
|
|
322
|
+
What is **not** in this block (and shouldn't be):
|
|
323
|
+
|
|
324
|
+
- **No translation strings** — labels live in
|
|
325
|
+
`labels.<locale>.ts`, satisfying the typed `TLabels` interface.
|
|
326
|
+
- **No registry entry** — the registration is a separate concern
|
|
327
|
+
in `module-email-template-definitions.ts` (Step 4 of this
|
|
328
|
+
workflow). The template definition is the **value** the registry
|
|
329
|
+
points at; it doesn't self-register.
|
|
330
|
+
- **No URL-building logic in this minimal example** — real
|
|
331
|
+
templates derive absolute URLs from
|
|
332
|
+
`context.objectContext.primaryScopeContext`. The static
|
|
333
|
+
`/inbox` href in this minimal example keeps the focus on
|
|
334
|
+
shape; production templates compose URLs from the typed
|
|
335
|
+
context.
|
|
336
|
+
- **No app SPA imports** — `frontend/`-bundled components do not
|
|
337
|
+
compile in the email build.
|
|
338
|
+
- **No async work** in the body function — `subject` / `body` are
|
|
339
|
+
synchronous pure functions; pre-fetched data goes into `context`
|
|
340
|
+
before render.
|
|
341
|
+
|
|
342
|
+
This source-backed example is supplied by the installed framework knowledge
|
|
343
|
+
and is intentionally separate from application build output.
|
|
344
|
+
`**/*.example.{ts,tsx}` in `tsconfig.json` /
|
|
345
|
+
`tsconfig.build.json`. It is anchored, not shipped — serving as a
|
|
346
|
+
single self-contained reference shape for app developers.
|
|
347
|
+
|
|
348
|
+
## References
|
|
349
|
+
|
|
350
|
+
- `references/email-artifact-paths.md` — where files live (template, labels, registry, type enum)
|
|
351
|
+
- `references/framework-email-template-api.md` — `EmailTemplateDefinition<TLabels>` + `EmailTemplateDefinitionsMap` types
|
|
352
|
+
- `i18n-rerun-pipeline/SKILL.md` — translation pipeline orchestrator (Step 6 trigger)
|
|
353
|
+
- `backend-addon-wiring/SKILL.md` — the module-level `emailTemplateDefinitions` slot consumer (the registry feeds into this)
|
|
354
|
+
|
|
355
|
+
## Verification
|
|
356
|
+
|
|
357
|
+
- [ ] `template.tsx` exists and renders cleanly in preview
|
|
358
|
+
- [ ] Labels exist for **every** user-visible string (one key per string), satisfying the typed `TLabels` interface key-for-key
|
|
359
|
+
- [ ] Labels files exist for every supported locale (parallel key sets across locales)
|
|
360
|
+
- [ ] Template is registered in `module-email-template-definitions.ts` with a typed enum id
|
|
361
|
+
- [ ] Definition declares an explicit `type: EmailTemplateType.*` (no defaults)
|
|
362
|
+
- [ ] Definition is typed `EmailTemplateDefinition<TLabels>` (not `any`, not bare `EmailTemplateDefinition`)
|
|
363
|
+
- [ ] `subject` / `body` JSX contains **no inline strings** (every string flows through `labels`)
|
|
364
|
+
- [ ] No `frontend/` SPA imports in the template (separate bundle)
|
|
365
|
+
- [ ] Sender call sites resolve the template by typed id, never by direct import
|
|
366
|
+
- [ ] Email status / preview tools show the template as registered + renderable
|
|
367
|
+
- [ ] If new label keys: translation pipeline ran (Step 6)
|
|
368
|
+
|
|
369
|
+
### Grep invariants
|
|
370
|
+
|
|
371
|
+
Run from the app root, substituting `<template>` (e.g. `welcome`),
|
|
372
|
+
`<module>` (e.g. `tasks-manager`), and `<locale>`:
|
|
373
|
+
|
|
374
|
+
| Invariant | Command |
|
|
375
|
+
|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
376
|
+
| Template file exists | `rg --files backend-api/src/notifications/email/<template>/template.tsx` |
|
|
377
|
+
| Definition is typed against a labels interface | `rg -n "EmailTemplateDefinition<[A-Z][A-Za-z0-9]+Labels>" backend-api/src/notifications/email/<template>/template.tsx` |
|
|
378
|
+
| Definition declares `type:` | `rg -n "type:\s+EmailTemplateType\." backend-api/src/notifications/email/<template>/template.tsx` |
|
|
379
|
+
| Subject / body read from `labels.` | `rg -n "labels\.[a-zA-Z]+" backend-api/src/notifications/email/<template>/template.tsx` |
|
|
380
|
+
| Locale files exist for every supported locale | `ls backend-api/src/notifications/email/<template>/labels.*.ts` |
|
|
381
|
+
| Template is registered in the module definitions map | `rg -n "<template>" backend-api/src/notifications/email/module-email-template-definitions.ts` |
|
|
382
|
+
| Per-locale label files share the same key set | `comm -23 <(rg -o '\\w+:' backend-api/src/notifications/email/<template>/labels.<primary-locale>.ts \| sort -u) <(rg -o '\\w+:' backend-api/src/notifications/email/<template>/labels.<locale>.ts \| sort -u)` (output should be empty) |
|
|
383
|
+
| Sender resolves template by typed id | `rg -n "EmailTemplateType\.[A-Z_]+" backend-api/src/modules/<module>/` |
|
|
384
|
+
| **No inline JSX text in subject / body** (must return empty) | `rg -n ">[A-Za-z][^<{}]{2,}<" backend-api/src/notifications/email/<template>/template.tsx` |
|
|
385
|
+
| **No app SPA imports** in the template (must return empty) | `rg -n "from\s+['\"](app|frontend)/" backend-api/src/notifications/email/<template>/template.tsx` |
|
|
386
|
+
| **No direct template import** in sender services (must return empty) | `rg -n "from\s+['\"].*notifications/email/<template>/template['\"]" backend-api/src/modules/<module>/` |
|
|
387
|
+
|
|
388
|
+
The high-signal invariants are **"No inline JSX text in subject /
|
|
389
|
+
body"** combined with **"No direct template import in sender
|
|
390
|
+
services"** — the first guarantees i18n reaches every string; the
|
|
391
|
+
second guarantees the registry is the integration seam.
|
|
392
|
+
|
|
393
|
+
## Common Rationalizations
|
|
394
|
+
|
|
395
|
+
| Rationalization | Reality |
|
|
396
|
+
|-----------------|---------|
|
|
397
|
+
| "Inline strings are faster" | Inline strings skip translation and break the i18n pipeline silently — the **No inline JSX text** grep makes this a bisectable check, not a discovery during release QA. |
|
|
398
|
+
| "I'll register the template later" | Unregistered templates are unreachable at runtime; sender call sites resolve by typed id through the registry. The `module-email-template-definitions.ts` entry is part of the same change set, not a follow-up. |
|
|
399
|
+
| "I can pick `type` later" | Transactional vs broadcast affects queueing and unsubscribe handling. There is no safe default — declare it on first commit. |
|
|
400
|
+
| "Custom `<div>` layout is fine, my mail client renders it" | Inbox rendering varies wildly across Gmail / Outlook / Apple Mail. React Email primitives are inlined-CSS-tested against the major clients; raw HTML is not. |
|
|
401
|
+
| "Use the app's `<Button>` component for consistency" | Email compiles in a separate bundle without React DOM context. App components pull browser-only globals that fail at render. Use React Email's `<Button>`. |
|
|
402
|
+
| "Import the template directly in the sender — fewer indirection" | The registry is the integration seam for tooling (companion preview, audit, dispatch service). Direct imports bypass it and break the typed-id contract. |
|
|
403
|
+
| "English-only labels for now" | Secondary locales break at render the moment a user is provisioned with a non-default locale. Author all locale stubs at template creation time; let `i18n-translation-rerun` backfill values. |
|
|
404
|
+
| "Hard-code the brand color, the company won't change it" | The same template renders across white-label tenants and themed environments. Brand context flows through props — read it, don't hard-code it. |
|
|
405
|
+
|
|
406
|
+
## Red Flags
|
|
407
|
+
|
|
408
|
+
- Template folder without an entry in
|
|
409
|
+
`module-email-template-definitions.ts` (catch with the
|
|
410
|
+
**Template is registered** grep — must return at least 1 line)
|
|
411
|
+
- Subject / body strings only in TSX with no label keys (catch
|
|
412
|
+
with the **No inline JSX text in subject / body** grep — must
|
|
413
|
+
return empty)
|
|
414
|
+
- Definition uses `EmailTemplateDefinition<any>` or
|
|
415
|
+
`EmailTemplateDefinition` without a labels generic (catch with
|
|
416
|
+
the **Definition is typed against a labels interface** grep —
|
|
417
|
+
must match)
|
|
418
|
+
- Definition omits `type:` (catch with the **Definition declares
|
|
419
|
+
`type:`** grep — must return at least 1)
|
|
420
|
+
- Per-locale label files declare different key sets (catch with
|
|
421
|
+
the **Per-locale label files share the same key set** comm —
|
|
422
|
+
must return empty)
|
|
423
|
+
- Sender service imports the template directly instead of
|
|
424
|
+
resolving by typed id (catch with the **No direct template
|
|
425
|
+
import in sender services** grep — must return empty)
|
|
426
|
+
- Template imports from `frontend/` (catch with the **No app SPA
|
|
427
|
+
imports** grep — must return empty)
|
|
428
|
+
- Brand color / domain hard-coded in the body (template no longer
|
|
429
|
+
renders correctly across environments)
|
|
430
|
+
- New label keys committed without a translation rerun (Step 6
|
|
431
|
+
silently skipped — non-primary locales fall back to source-locale)
|
|
432
|
+
|
|
433
|
+
## Related Skills
|
|
434
|
+
|
|
435
|
+
- `i18n-rerun-pipeline` — translation pipeline orchestrator (Step 6 trigger after new label keys)
|
|
436
|
+
- `i18n-translation-rerun` — translate non-primary locales (the dedicated leaf)
|
|
437
|
+
- `i18n-label-generation` — app-wide UI label generation (engine-owned `customLabels` slot via `scanCustomLabelsDirectory`; email labels are a **separate** template-colocated pipeline and are not swept by that scanner)
|
|
438
|
+
- `backend-addon-wiring` — module-level `emailTemplateDefinitions` slot (the registry feeds into this)
|
|
439
|
+
- `notifications_in_app` — in-app notifications (separate dispatch surface)
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Email Template — Artifact Paths
|
|
2
|
+
|
|
3
|
+
| Artifact | Typical location |
|
|
4
|
+
|----------|------------------|
|
|
5
|
+
| React Email template | `./backend-api/.../emails/<template>/template.tsx` (match app convention) |
|
|
6
|
+
| Labels | Co-located `labels.<locale>.ts` next to `template.tsx` |
|
|
7
|
+
| Module definition | `module-email-template-definitions.ts` or project registry |
|
|
8
|
+
|
|
9
|
+
Use sibling templates in the same app as the naming authority.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Email template contract (source)
|
|
2
|
+
|
|
3
|
+
- **`EmailTemplateProps` / `EmailTemplateDefinition`** — subject/body functions and typed co-located labels.
|
|
4
|
+
- **`EmailTemplateEntry` / `EmailTemplateDefinitionsMap`** — registry shape passed to the email template registry at startup.
|
|
5
|
+
|
|
6
|
+
## Import Origins
|
|
7
|
+
|
|
8
|
+
- `@wildo-ai/saas-backend-lib`
|
|
9
|
+
|
|
10
|
+
## Source Excerpts
|
|
11
|
+
|
|
12
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
*
|
|
16
|
+
* Props passed to both subject and body functions.
|
|
17
|
+
*
|
|
18
|
+
* `L` is the shape of the template's co-located label file. Templates
|
|
19
|
+
* declare their label shape for compile-time safety via the generic.
|
|
20
|
+
*/
|
|
21
|
+
export interface EmailTemplateProps<L = Record<string, string>> {
|
|
22
|
+
context: EmailTemplateContext;
|
|
23
|
+
brand: EmailBrandTokens;
|
|
24
|
+
/** Co-located i18n labels resolved from `labels.{locale}.ts` */
|
|
25
|
+
labels: L;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* A complete email template: subject + body in one object.
|
|
30
|
+
*
|
|
31
|
+
* `L` is the labels shape declared in the co-located `labels.{locale}.ts`
|
|
32
|
+
* file. Templates export this as default from `template.tsx`.
|
|
33
|
+
*/
|
|
34
|
+
export interface EmailTemplateDefinition<L = Record<string, string>> {
|
|
35
|
+
/** Returns the rendered subject line string */
|
|
36
|
+
subject: (props: EmailTemplateProps<L>) => string;
|
|
37
|
+
/** Returns the React element for the email body */
|
|
38
|
+
body: (props: EmailTemplateProps<L>) => ReactElement;
|
|
39
|
+
/** Email type for provider routing (default: TRANSACTIONAL) */
|
|
40
|
+
type?: EmailTemplateType;
|
|
41
|
+
/** Diagnostics, docs, and generation assistance */
|
|
42
|
+
description?: string;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// ── Registry input types ────────────────────────────────────────
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Registry entry: a locale-agnostic template paired with per-locale label
|
|
49
|
+
* maps. Produced by `scanEmailTemplateDirectory`.
|
|
50
|
+
*/
|
|
51
|
+
export interface EmailTemplateEntry {
|
|
52
|
+
template: EmailTemplateDefinition<any>;
|
|
53
|
+
/** Per-locale labels. Keys are locale codes (e.g. `en`, `fr`). */
|
|
54
|
+
labels: Record<string, Record<string, string>>;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Map of all email templates keyed by `templateRef`.
|
|
59
|
+
* Passed to `EmailTemplateRegistryBackendService.initialize()` at startup.
|
|
60
|
+
*
|
|
61
|
+
* @example
|
|
62
|
+
* ```ts
|
|
63
|
+
* {
|
|
64
|
+
* "system.password_reset": {
|
|
65
|
+
* template: passwordResetTemplate,
|
|
66
|
+
* labels: { en: { subject: "Reset…", … }, fr: { subject: "Réinitialiser…", … } },
|
|
67
|
+
* },
|
|
68
|
+
* }
|
|
69
|
+
* ```
|
|
70
|
+
*/
|
|
71
|
+
export type EmailTemplateDefinitionsMap = Record<string, EmailTemplateEntry>;
|
|
72
|
+
```
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: email-definition-wiring
|
|
3
|
+
description: Redirect stub → `email-add-template` owns email registry/definition wiring end to end. Use when the user says "register an email template", "email definition wiring", "module-email-template-definitions", "EmailTemplateType", or "move a template between modules" — this stub only routes to the orchestrator (its Step 4 carries the workflow).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Email Definition Wiring → see `email-add-template`
|
|
7
|
+
|
|
8
|
+
This skill is a **router stub**. It exists so that AI agents and
|
|
9
|
+
developers searching for "email definition wiring", "register an email
|
|
10
|
+
template", "module-email-template-definitions", or "EmailTemplateType"
|
|
11
|
+
land on the canonical orchestrator without bouncing through generic
|
|
12
|
+
search.
|
|
13
|
+
|
|
14
|
+
The full workflow for wiring templates into
|
|
15
|
+
`module-email-template-definitions.ts` (typed `EmailTemplateType.*`
|
|
16
|
+
ids, registry-as-integration-seam, ownership-first module placement,
|
|
17
|
+
sender-resolves-by-id contract, module-level `emailTemplateDefinitions`
|
|
18
|
+
slot wiring) lives in **`email-add-template`** — Step 4 covers
|
|
19
|
+
registry wiring. The **`No direct template import in sender services`**
|
|
20
|
+
grep is the high-signal check.
|
|
21
|
+
|
|
22
|
+
## When to Use
|
|
23
|
+
|
|
24
|
+
- The user asks specifically about registry / definition wiring
|
|
25
|
+
(`module-email-template-definitions.ts`, `EmailTemplateType`
|
|
26
|
+
enum, sender resolves-by-id contract, template id rename, moving a
|
|
27
|
+
template between modules).
|
|
28
|
+
|
|
29
|
+
## When NOT to Use
|
|
30
|
+
|
|
31
|
+
- **Authoring or editing the template JSX itself** — open
|
|
32
|
+
`email-template-authoring` (also routes to `email-add-template`).
|
|
33
|
+
- **Authoring or editing per-locale labels** — open
|
|
34
|
+
`email-labels-authoring`.
|
|
35
|
+
- **End-to-end "add a new template" task** — open `email-add-template`
|
|
36
|
+
directly; do not re-enter via this stub.
|
|
37
|
+
|
|
38
|
+
## Verification
|
|
39
|
+
|
|
40
|
+
1. You opened `email-add-template/SKILL.md` (or its Step 4 section)
|
|
41
|
+
before applying any change to `module-email-template-definitions.ts`.
|
|
42
|
+
2. You did NOT copy the workflow into this stub or re-author it
|
|
43
|
+
elsewhere — the canonical orchestrator stays the single source of
|
|
44
|
+
truth.
|
|
45
|
+
3. The new template id appears in the registry — `rg -n "<template-id>" backend-api/src/engine/email/module-email-template-definitions.ts` returns at least one line.
|
|
46
|
+
4. No sender service imports the template module directly — `rg -n "from\s+['\"].*engine/email/<template>/template['\"]" backend-api/src/modules/<module>/` returns empty.
|
|
47
|
+
|
|
48
|
+
## Red Flags
|
|
49
|
+
|
|
50
|
+
1. **You started authoring registry wiring guidance inside this file**
|
|
51
|
+
— stop; the orchestrator is the source of truth. If a real gap
|
|
52
|
+
exists, fix it in `email-add-template`, not here.
|
|
53
|
+
2. **You skipped `email-add-template` and wrote registry edits from
|
|
54
|
+
memory** — the `No direct template import in sender services` grep
|
|
55
|
+
exists because that drift is common; run it.
|
|
56
|
+
|
|
57
|
+
## Related Skills
|
|
58
|
+
|
|
59
|
+
- `email-add-template` — the canonical orchestrator
|
|
60
|
+
- `email-template-authoring` — sibling router stub (template JSX)
|
|
61
|
+
- `email-labels-authoring` — sibling router stub (per-locale labels)
|
|
62
|
+
- `backend-addon-wiring` — module-level `emailTemplateDefinitions` slot consumer
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: email-labels-authoring
|
|
3
|
+
description: Redirect stub → `email-add-template` owns email per-locale label authoring. Use when the user says "email labels", "labels.<locale>.ts", "TLabels interface", "per-locale email keys", or "subject as label" — this stub only routes to the orchestrator (its Step 3 carries the workflow).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Email Labels Authoring → see `email-add-template`
|
|
7
|
+
|
|
8
|
+
This skill is a **router stub**. It exists so that AI agents and
|
|
9
|
+
developers searching for "email labels", "labels.<locale>.ts", "TLabels
|
|
10
|
+
interface", "per-locale email keys", or "subject as label" land on the
|
|
11
|
+
canonical orchestrator without bouncing through generic search.
|
|
12
|
+
|
|
13
|
+
The full workflow for authoring co-located `labels.<locale>.ts` files
|
|
14
|
+
(satisfying the typed `TLabels` interface key-for-key, parallel key
|
|
15
|
+
sets across locales, template-namespaced keys, subject-as-label,
|
|
16
|
+
new-locale backfill via `i18n-translation-rerun`) lives in
|
|
17
|
+
**`email-add-template`** — Step 3 covers label authoring. The
|
|
18
|
+
**`Per-locale label files share the same key set`** `comm` invariant
|
|
19
|
+
is the high-signal drift check.
|
|
20
|
+
|
|
21
|
+
## When to Use
|
|
22
|
+
|
|
23
|
+
- The user asks specifically about email label files (`labels.<primary-locale>.ts`,
|
|
24
|
+
`labels.fr.ts`, the typed `TLabels` interface, key-for-key parity
|
|
25
|
+
across locales, subject-as-label, or backfilling a new locale).
|
|
26
|
+
|
|
27
|
+
## When NOT to Use
|
|
28
|
+
|
|
29
|
+
- **Authoring or editing the template JSX itself** — open
|
|
30
|
+
`email-template-authoring`.
|
|
31
|
+
- **Wiring the template into the registry** — open
|
|
32
|
+
`email-definition-wiring`.
|
|
33
|
+
- **End-to-end "add a new template" task** — open `email-add-template`
|
|
34
|
+
directly; do not re-enter via this stub.
|
|
35
|
+
- **Generating translations for a NEW locale across the whole product**
|
|
36
|
+
— open `i18n-translation-rerun` (handles batched re-translation, not
|
|
37
|
+
the email-specific shape).
|
|
38
|
+
|
|
39
|
+
## Verification
|
|
40
|
+
|
|
41
|
+
1. You opened `email-add-template/SKILL.md` (or its Step 3 section)
|
|
42
|
+
before authoring any `labels.<locale>.ts` file.
|
|
43
|
+
2. You did NOT copy the workflow into this stub or re-author it
|
|
44
|
+
elsewhere — the canonical orchestrator stays the single source of
|
|
45
|
+
truth.
|
|
46
|
+
3. A `labels.<locale>.ts` file exists for every supported locale — `ls backend-api/src/engine/email/<template>/labels.*.ts` lists one entry per locale.
|
|
47
|
+
4. Every locale shares the same key set — `comm -23 <(rg -o '\w+:' backend-api/src/engine/email/<template>/labels.<primary>.ts | sort -u) <(rg -o '\w+:' backend-api/src/engine/email/<template>/labels.<other>.ts | sort -u)` returns empty.
|
|
48
|
+
|
|
49
|
+
## Red Flags
|
|
50
|
+
|
|
51
|
+
1. **You started authoring label-file conventions inside this file** —
|
|
52
|
+
stop; the orchestrator is the source of truth. If a real gap
|
|
53
|
+
exists, fix it in `email-add-template`, not here.
|
|
54
|
+
2. **You added a key to one locale and not the others** — the
|
|
55
|
+
`Per-locale label files share the same key set` `comm` invariant
|
|
56
|
+
exists for exactly this drift; run it before claiming done.
|
|
57
|
+
|
|
58
|
+
## Related Skills
|
|
59
|
+
|
|
60
|
+
- `email-add-template` — the canonical orchestrator
|
|
61
|
+
- `email-template-authoring` — sibling router stub (template JSX)
|
|
62
|
+
- `email-definition-wiring` — sibling router stub (registry wiring)
|
|
63
|
+
- `i18n-translation-rerun` — translate non-primary locales (general,
|
|
64
|
+
not email-specific)
|