@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,261 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: i18n-label-generation
|
|
3
|
+
description: Add or restructure user-facing label keys for resources, modules, and engine surfaces. Per-unit label files (one TS file per unit per locale) are the runtime source of truth — the engine i18n barrel walks them at module load via `scanCustomLabelsDirectory` and feeds the resulting `CustomLabelsMap` into `BackendOwnedModule.customLabels`. Use when the user says "add new labels for my module", "where do I add the title for my new resource", "the label key isn't resolving at runtime", "register engine-level labels", "wire a second locale", or any change that adds/restructures the label key namespace.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# i18n Label Generation
|
|
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
|
+
Mechanism skill for **i18n label generation** — the per-unit TS files
|
|
23
|
+
written by the dev companion's labelling pipeline (`wildo generate
|
|
24
|
+
labels`, `wildo generate translate`) and the engine i18n barrel that
|
|
25
|
+
turns them into a `CustomLabelsMap` at module load.
|
|
26
|
+
|
|
27
|
+
Label generation serves three consumers:
|
|
28
|
+
|
|
29
|
+
1. The **labelling pipeline** — generates one TS file per unit per
|
|
30
|
+
locale in the application label tree
|
|
31
|
+
(`backend-api/src/engine/i18n/<bucket>/<slug>.<locale>.ts`) by introspecting
|
|
32
|
+
resource configs / specs / UI behavior. There is intentionally
|
|
33
|
+
**no monolithic `labels.<locale>.ts`** — per-unit files are the
|
|
34
|
+
runtime source of truth.
|
|
35
|
+
2. The **application i18n barrel** — `backend-api/src/engine/i18n/index.ts` calls
|
|
36
|
+
`scanCustomLabelsDirectory({ importMetaUrl: import.meta.url })` at
|
|
37
|
+
top-level (ESM caches the result for the process lifetime) and
|
|
38
|
+
feeds the deep-merged map into the engine module's
|
|
39
|
+
`BackendOwnedModule.customLabels` slot. Other domain modules
|
|
40
|
+
(e.g. `tasks-manager`) intentionally do NOT duplicate this scan —
|
|
41
|
+
the companion writes every per-unit file under one tree, so a
|
|
42
|
+
single scan from the engine barrel covers everything.
|
|
43
|
+
3. The **runtime label resolver** — at request time, the resolver
|
|
44
|
+
walks `AvailableLanguage` keys looking for matching keys; missing
|
|
45
|
+
keys fall back to the dev locale string (or the key itself when
|
|
46
|
+
the dev locale is also missing).
|
|
47
|
+
|
|
48
|
+
## App Paths
|
|
49
|
+
|
|
50
|
+
| Surface | Glob (relative to app root) |
|
|
51
|
+
|--------------------------------------|----------------------------------------------------------------------------------------------|
|
|
52
|
+
| Engine i18n barrel | `backend-api/src/engine/i18n/index.ts` (calls `scanCustomLabelsDirectory`) |
|
|
53
|
+
| Per-unit generated content (engine) | `backend-api/src/engine/i18n/<bucket>/<slug>.<locale>.ts` (DO NOT EDIT — auto-generated) |
|
|
54
|
+
| Engine wiring slot consumer | `backend-api/src/engine/index.ts` (`customLabels: labels` field on `BackendOwnedModule`) |
|
|
55
|
+
| Domain module wiring | `backend-api/src/modules/<slug>/index.ts` (intentionally NO `customLabels` field) |
|
|
56
|
+
| `AvailableLanguage` enum | `@wildo-ai/presets-components-models` (typed locale identifiers) |
|
|
57
|
+
| `scanCustomLabelsDirectory` | `@wildo-ai/saas-backend-lib` (re-exported from `runtime/utils/scan-default-exports`) |
|
|
58
|
+
|
|
59
|
+
## When to Use
|
|
60
|
+
|
|
61
|
+
- New resource / field / enum value visible to the user
|
|
62
|
+
- New section title in `ui-behavior` (resource-owned views)
|
|
63
|
+
- New module shipping its own labels for the first time
|
|
64
|
+
- Wiring a second locale (no manual barrel work — just rerun the pipeline)
|
|
65
|
+
- Renaming a label key namespace (resource rename, field rename)
|
|
66
|
+
|
|
67
|
+
## When NOT to Use
|
|
68
|
+
|
|
69
|
+
- Rerunning the translation job for non-primary locales →
|
|
70
|
+
`i18n-translation-rerun`
|
|
71
|
+
- Coordinating the full label + translation pipeline →
|
|
72
|
+
`i18n-rerun-pipeline`
|
|
73
|
+
- Editing an auto-generated per-unit `<slug>.<locale>.ts` file
|
|
74
|
+
directly (these get overwritten on the next pipeline run)
|
|
75
|
+
- Hard-coding strings in JSX — those should always go through
|
|
76
|
+
the label resolver instead
|
|
77
|
+
|
|
78
|
+
## Workflow
|
|
79
|
+
|
|
80
|
+
### Step 1: Add the source declaration
|
|
81
|
+
|
|
82
|
+
There is no manual barrel edit required. Label sources live in the
|
|
83
|
+
spec / UI behavior / resource config layers, and the labelling
|
|
84
|
+
pipeline scans those to produce per-unit files.
|
|
85
|
+
|
|
86
|
+
- New field key: declared via the field's `meaning` / `header`
|
|
87
|
+
in the resource spec → picked up by the next pipeline run.
|
|
88
|
+
- New enum value: declared via the enum value's `meaning` in
|
|
89
|
+
spec or `enumUI` block in `ui-behavior` → picked up by the next
|
|
90
|
+
pipeline run.
|
|
91
|
+
- New section title: declared via the `Section` `titleKey` in
|
|
92
|
+
the composite/full-custom view spec.
|
|
93
|
+
- New component label: declared via `registerComponentLabels(...)`
|
|
94
|
+
alongside the component or its preset.
|
|
95
|
+
|
|
96
|
+
Read `references/label-placement.md` for placement conventions
|
|
97
|
+
and `references/framework-labelling-sections-api.md` for the
|
|
98
|
+
section taxonomy (`LabellingTypes`, eager vs backend-only).
|
|
99
|
+
|
|
100
|
+
### Step 2: Wire usage
|
|
101
|
+
|
|
102
|
+
Reference keys from `ui-behavior`, specs, or components — never
|
|
103
|
+
hard-code product strings in JSX. The resolver looks up
|
|
104
|
+
`<resource>.<field>.label` style keys against the merged
|
|
105
|
+
`CustomLabelsMap`.
|
|
106
|
+
|
|
107
|
+
### Step 3: Generate the per-unit files
|
|
108
|
+
|
|
109
|
+
Run the labelling pipeline so the companion writes one per-unit TS
|
|
110
|
+
file per added unit:
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
wildo generate labels
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
The companion writes to
|
|
117
|
+
`backend-api/src/engine/i18n/<bucket>/<slug>.<primary-locale>.ts` using
|
|
118
|
+
`backendConfig.appPreferences.languages.defaultLanguage`, and tracks each
|
|
119
|
+
unit's `inputSha` / `primarySha` in `wildo-saas.lock.json` for incremental
|
|
120
|
+
skips. The engine barrel picks them up automatically
|
|
121
|
+
on the next backend (re)start — top-level `await
|
|
122
|
+
scanCustomLabelsDirectory(...)` runs once at module load.
|
|
123
|
+
|
|
124
|
+
### Step 4: Hand off to translation
|
|
125
|
+
|
|
126
|
+
For non-primary locales, run `i18n-translation-rerun` so the
|
|
127
|
+
translation pipeline backfills the new keys per locale. The same
|
|
128
|
+
per-unit tree gains `<slug>.<locale>.ts` siblings for each target
|
|
129
|
+
locale.
|
|
130
|
+
|
|
131
|
+
## Worked Example
|
|
132
|
+
|
|
133
|
+
The application i18n barrel is the canonical shape — a
|
|
134
|
+
top-level `scanCustomLabelsDirectory` call that returns the
|
|
135
|
+
`CustomLabelsMap` the engine module's `BackendOwnedModule.customLabels`
|
|
136
|
+
slot consumes verbatim:
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
## Usage Example
|
|
140
|
+
|
|
141
|
+
```typescript
|
|
142
|
+
*/
|
|
143
|
+
import { scanCustomLabelsDirectory } from '@wildo-ai/saas-backend-lib';
|
|
144
|
+
|
|
145
|
+
export const customLabels = await scanCustomLabelsDirectory({
|
|
146
|
+
importMetaUrl: import.meta.url,
|
|
147
|
+
});
|
|
148
|
+
|
|
149
|
+
export const labels = customLabels;
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
What earns its place:
|
|
153
|
+
|
|
154
|
+
- `import { scanCustomLabelsDirectory } from '@wildo-ai/saas-backend-lib'`
|
|
155
|
+
— the **runtime helper** that walks the per-unit tree. It uses
|
|
156
|
+
`import.meta.url` to anchor the scan at the calling barrel's own
|
|
157
|
+
directory, so the barrel can live at any depth without parameter
|
|
158
|
+
drift.
|
|
159
|
+
- `await scanCustomLabelsDirectory({ importMetaUrl: import.meta.url })`
|
|
160
|
+
— the **top-level await** runs once when ESM resolves the module
|
|
161
|
+
graph (caches for the process lifetime). The scanner walks
|
|
162
|
+
`<dir>/<bucket>/<slug>.<locale>.js` (compiled form), dynamically
|
|
163
|
+
imports each, and deep-merges the named `labels` exports per
|
|
164
|
+
locale.
|
|
165
|
+
- `export const customLabels = ...` — the **canonical map shape**
|
|
166
|
+
the labelling layer consumes (`Record<locale, StringRecord>`).
|
|
167
|
+
Keys are runtime-validated against `AvailableLanguage` by the
|
|
168
|
+
consumer, so a stray non-locale file would surface as a
|
|
169
|
+
startup-time mismatch rather than a silent miss.
|
|
170
|
+
- `export const labels = customLabels` — the **module-wiring
|
|
171
|
+
contract**. The `BackendOwnedModule.customLabels` slot
|
|
172
|
+
(`backend-addon-wiring`) imports `labels` by convention.
|
|
173
|
+
|
|
174
|
+
What is **not** in this block (and shouldn't be):
|
|
175
|
+
|
|
176
|
+
- No static `import { labels } from './labels.<locale>'` — the per-locale
|
|
177
|
+
monolithic file no longer exists. Trying to import it produces a
|
|
178
|
+
TS error.
|
|
179
|
+
- No manual `customLabels: { [AvailableLanguage.<locale>]: labels }`
|
|
180
|
+
literal — the scanner fills in the locale keys from filenames,
|
|
181
|
+
so adding French is "drop `<slug>.fr.ts` files into the tree",
|
|
182
|
+
not "edit the barrel".
|
|
183
|
+
- No barrel-level transformation logic — the scanner deep-merges
|
|
184
|
+
per-unit content into the canonical shape; custom merging /
|
|
185
|
+
filtering belongs in the label resolver, not the barrel.
|
|
186
|
+
- No duplicate scan in domain modules — every per-unit file lives
|
|
187
|
+
under the engine tree. A second `scanCustomLabelsDirectory` from
|
|
188
|
+
a domain module would either return empty (wrong root) or
|
|
189
|
+
trigger key-collision warnings (same root scanned twice).
|
|
190
|
+
|
|
191
|
+
## References
|
|
192
|
+
|
|
193
|
+
- `references/label-placement.md` — file/key placement conventions
|
|
194
|
+
- `references/framework-labelling-sections-api.md` — section taxonomy (`LabellingTypes`)
|
|
195
|
+
- `i18n-translation-rerun/SKILL.md` — translation pipeline for non-primary locales
|
|
196
|
+
- `i18n-rerun-pipeline/SKILL.md` — coordinated label + translation rerun
|
|
197
|
+
- `backend-addon-wiring/SKILL.md` — the `customLabels` slot on `BackendOwnedModule`
|
|
198
|
+
|
|
199
|
+
## Verification
|
|
200
|
+
|
|
201
|
+
- [ ] Engine barrel calls `scanCustomLabelsDirectory({ importMetaUrl: import.meta.url })`
|
|
202
|
+
- [ ] Per-unit `<slug>.<locale>.ts` files are **not** hand-edited (preserve the auto-generated header)
|
|
203
|
+
- [ ] Primary locale contains every new key (resource / field / enum value / section title)
|
|
204
|
+
- [ ] Keys referenced in code (specs, ui-behavior, components) match definitions in the per-unit files
|
|
205
|
+
- [ ] Engine wiring (`BackendOwnedModule.customLabels`) imports `labels` from the barrel
|
|
206
|
+
- [ ] Domain modules do NOT define `customLabels` (the engine barrel is the single source)
|
|
207
|
+
- [ ] No duplicate meanings under different keys (a single canonical key per concept)
|
|
208
|
+
- [ ] Hard-coded JSX strings replaced with label resolver calls
|
|
209
|
+
|
|
210
|
+
### Grep invariants
|
|
211
|
+
|
|
212
|
+
Run from the app root:
|
|
213
|
+
|
|
214
|
+
| Invariant | Command |
|
|
215
|
+
|--------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
216
|
+
| Engine barrel uses the scan helper | `rg -n "scanCustomLabelsDirectory" backend-api/src/engine/i18n/index.ts` |
|
|
217
|
+
| Engine barrel exports `labels` | `rg -n "^export const labels\s*=" backend-api/src/engine/i18n/index.ts` |
|
|
218
|
+
| Engine wiring consumes `labels` from the barrel | `rg -n "customLabels:\s*labels" backend-api/src/engine/index.ts` |
|
|
219
|
+
| **No monolithic** `labels.<locale>.ts` (must be empty) | `rg --files backend-api/src/engine/i18n -g 'labels.*.ts' -g '!**/<bucket>/**'` |
|
|
220
|
+
| **No duplicate scan** in domain modules (must be empty) | `rg -n "scanCustomLabelsDirectory" backend-api/src/modules/` |
|
|
221
|
+
| **No hard-coded product strings** in JSX touched in this change | `rg -n ">[A-Z][a-z]+ [A-Z][a-z]" frontend/src/modules/<slug>/` |
|
|
222
|
+
|
|
223
|
+
The high-signal invariants are **"engine barrel uses the scan
|
|
224
|
+
helper"** combined with **"no duplicate scan in domain modules"** —
|
|
225
|
+
drift between either pair silently fragments the module's i18n
|
|
226
|
+
bootstrap.
|
|
227
|
+
|
|
228
|
+
## Common Rationalizations
|
|
229
|
+
|
|
230
|
+
| Rationalization | Reality |
|
|
231
|
+
|-----------------|---------|
|
|
232
|
+
| "Just edit a generated `<slug>.<locale>.ts` file directly" | Generated files are overwritten on the next pipeline run. Add the source via spec / ui-behavior, then regenerate. |
|
|
233
|
+
| "Add an aggregated `labels.<locale>.ts` for static imports" | The aggregator was deleted intentionally — per-unit files are the runtime source of truth. The scan helper handles loading. |
|
|
234
|
+
| "Reuse a generic key like `common.title`" | Context-specific wording often needs separate keys (e.g. resource title vs section title vs operation title). Generic keys silently collide as the namespace grows. |
|
|
235
|
+
| "Hard-code the string in JSX, just for now" | "Just for now" never gets revisited. Hard-coded strings break the i18n contract and don't surface in the missing-key audit. |
|
|
236
|
+
| "Add a second `scanCustomLabelsDirectory` call from my domain module" | The companion writes every per-unit file under one tree. A second scan from a domain module either returns empty (wrong root) or collides with the engine scan (same root). |
|
|
237
|
+
|
|
238
|
+
## Red Flags
|
|
239
|
+
|
|
240
|
+
- Hand-edit to a per-unit `<slug>.<locale>.ts` file without a
|
|
241
|
+
corresponding spec / ui-behavior change (the next pipeline run
|
|
242
|
+
loses the edit)
|
|
243
|
+
- New enum value declared in the resource schema but no matching
|
|
244
|
+
`meaning` in the spec layer (catches as a missing-key warning at runtime)
|
|
245
|
+
- A monolithic `labels.<locale>.ts` file appearing at the root of the
|
|
246
|
+
application label tree (the aggregator was deleted; this file should not exist)
|
|
247
|
+
- Domain module declaring `customLabels` on its `BackendOwnedModule`
|
|
248
|
+
(the engine barrel is the single owner)
|
|
249
|
+
- Hard-coded JSX strings in newly added components (catches as a
|
|
250
|
+
missing-key audit gap when locales beyond English ship)
|
|
251
|
+
- Two different keys carrying the same meaning under different paths
|
|
252
|
+
(signals a missing canonical key — pick one, deprecate the other)
|
|
253
|
+
|
|
254
|
+
## Related Skills
|
|
255
|
+
|
|
256
|
+
- `i18n-translation-rerun` — translation pipeline for non-primary locales
|
|
257
|
+
- `i18n-rerun-pipeline` — coordinated label + translation rerun
|
|
258
|
+
- `backend-addon-wiring` — the `customLabels` slot consumer on `BackendOwnedModule`
|
|
259
|
+
- `resource-ui-behavior` — `enumUI` blocks declaring per-value labels
|
|
260
|
+
- `spec-resource-update` — the `meaning` / `whyItMatters` source for label generation
|
|
261
|
+
- `email-add-template` — email-template labels follow a SEPARATE pipeline (template-colocated `labels.<locale>.ts` files)
|
package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Label sections taxonomy (source)
|
|
2
|
+
|
|
3
|
+
- **`LabellingTypes`** — which section bucket a label file belongs to (resources, views, billing, errors, …).
|
|
4
|
+
- **`EAGER_I18N_SECTIONS` / `BACKEND_ONLY_I18N_SECTIONS`** — load policy hints for frontend vs backend-only bundles.
|
|
5
|
+
|
|
6
|
+
## Import Origins
|
|
7
|
+
|
|
8
|
+
- `@wildo-ai/presets-components-models`
|
|
9
|
+
|
|
10
|
+
## Source Excerpts
|
|
11
|
+
|
|
12
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
*
|
|
16
|
+
* Label section taxonomy (`LabellingTypes`) and which sections load eagerly vs backend-only.
|
|
17
|
+
*/
|
|
18
|
+
export enum LabellingTypes {
|
|
19
|
+
ERRORS_MESSAGES = "errors_messages",
|
|
20
|
+
ERRORS_GUIDANCE = "errors_guidance",
|
|
21
|
+
ERRORS_VALIDATION = "errors_validation",
|
|
22
|
+
NOTIFICATIONS_CUSTOM = "notifications_custom",
|
|
23
|
+
COMPONENTS= "components",
|
|
24
|
+
RESOURCES_FIELDS = "resources_fields",
|
|
25
|
+
RESOURCES = "resources",
|
|
26
|
+
RESOURCES_SECTIONS = "resources_sections",
|
|
27
|
+
RESOURCES_WIZARD_STEPS = "resources_wizard_steps",
|
|
28
|
+
ROLES = "roles",
|
|
29
|
+
SYSTEM_ENUMS = "system_enums",
|
|
30
|
+
SIDEBAR_SECTIONS = "sidebar_sections",
|
|
31
|
+
SETTINGS_HUB = "settings_hub",
|
|
32
|
+
COMPOSITE_VIEWS = "composite_views",
|
|
33
|
+
VIEWS = "views",
|
|
34
|
+
GUIDANCE = "guidance",
|
|
35
|
+
MILESTONES = "milestones",
|
|
36
|
+
LIFECYCLE = "lifecycle",
|
|
37
|
+
BILLING_PRODUCTS = "billing_products",
|
|
38
|
+
BILLING_FEATURES = "billing_features",
|
|
39
|
+
BILLING_LIMITS = "billing_limits",
|
|
40
|
+
BILLING_CREDIT_POOLS = "billing_credit_pools",
|
|
41
|
+
BACKEND_AUTH_MESSAGES = "backend_auth_messages",
|
|
42
|
+
BACKEND_SMS = "backend_sms",
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Sections loaded eagerly during app initialization.
|
|
47
|
+
* These are needed globally before any component renders.
|
|
48
|
+
* Everything else is loaded lazily per-component via `requestKeys`.
|
|
49
|
+
*/
|
|
50
|
+
export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
|
|
51
|
+
LabellingTypes.SYSTEM_ENUMS,
|
|
52
|
+
LabellingTypes.ERRORS_MESSAGES,
|
|
53
|
+
LabellingTypes.ERRORS_VALIDATION,
|
|
54
|
+
LabellingTypes.ERRORS_GUIDANCE,
|
|
55
|
+
LabellingTypes.SIDEBAR_SECTIONS,
|
|
56
|
+
LabellingTypes.SETTINGS_HUB,
|
|
57
|
+
LabellingTypes.LIFECYCLE,
|
|
58
|
+
];
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Sections that exist only on the backend and should never be sent to the frontend.
|
|
62
|
+
*/
|
|
63
|
+
export const BACKEND_ONLY_I18N_SECTIONS: LabellingTypes[] = [
|
|
64
|
+
LabellingTypes.BACKEND_AUTH_MESSAGES,
|
|
65
|
+
LabellingTypes.BACKEND_SMS,
|
|
66
|
+
];
|
|
67
|
+
```
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Label Placement
|
|
2
|
+
|
|
3
|
+
- Resource labels: follow module/resource folder conventions used by sibling resources.
|
|
4
|
+
- Engine vs app labels: place under the package your change targets.
|
|
5
|
+
- Keys should be hierarchical: `<resource>.<field>.label`, `<resource>.<field>.<enumValue>`, etc.
|
|
6
|
+
|
|
7
|
+
Use companion `frontend-artifact-placement` behavior when available.
|
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: i18n-rerun-pipeline
|
|
3
|
+
description: Coordinate label authoring + translation pipeline + verification after user-facing strings change (schemas, UI, specs, email). Drives `i18n-label-generation` then `i18n-translation-rerun` in the right order, then verifies missing-key counts. Use when the user says "I added a new field — sort out the i18n", "rerun the i18n pipeline before release", "the spec text changed; update locales", "wire up the new email's translations", or any change that touched user-facing copy across multiple surfaces.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# i18n Rerun Pipeline
|
|
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
|
+
Workflow skill that **orchestrates** label authoring +
|
|
23
|
+
translation rerun + verification after a feature touches
|
|
24
|
+
user-facing copy. The two leaf skills do the actual work:
|
|
25
|
+
|
|
26
|
+
1. **`i18n-label-generation`** — declare / add the source-locale
|
|
27
|
+
keys via the spec / ui-behavior / email layers, then run
|
|
28
|
+
`wildo generate labels` to write per-unit
|
|
29
|
+
`<bucket>/<slug>.<source>.ts` files into the engine i18n tree.
|
|
30
|
+
The engine barrel auto-discovers them via
|
|
31
|
+
`scanCustomLabelsDirectory` (see
|
|
32
|
+
`example.i18n.label-generation.engine-barrel`).
|
|
33
|
+
2. **`i18n-translation-rerun`** — run `wildo generate translate`
|
|
34
|
+
to backfill per-unit `<bucket>/<slug>.<target>.ts` files for
|
|
35
|
+
every non-primary locale.
|
|
36
|
+
|
|
37
|
+
This skill exists because **forgetting either step silently ships
|
|
38
|
+
broken UI**: missing source-locale keys make the resolver fall
|
|
39
|
+
back to raw key strings, missing translated keys make non-primary
|
|
40
|
+
locales fall back to source-locale strings. The pipeline must run
|
|
41
|
+
end-to-end, in order, on every text-bearing change set.
|
|
42
|
+
|
|
43
|
+
## App Paths
|
|
44
|
+
|
|
45
|
+
| Surface | Glob (relative to app root) |
|
|
46
|
+
|--------------------------------------|----------------------------------------------------------------------------------------------|
|
|
47
|
+
| Engine i18n barrel | `backend-api/src/engine/i18n/index.ts` (auto-discovers via `scanCustomLabelsDirectory`) |
|
|
48
|
+
| Per-unit label files | `backend-api/src/engine/i18n/<bucket>/<slug>.<locale>.ts` (auto-generated) |
|
|
49
|
+
| Lock file | `wildo-saas.lock.json` at the SaaS root |
|
|
50
|
+
| Spec layer (label sources) | `specifications/src/modules/<slug>/resources/*.resource.specification.ts` |
|
|
51
|
+
| UI behavior (label sources) | `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` (`enumUI` blocks) |
|
|
52
|
+
| Component label declarations | `frontend/src/.../<component>.preset.ts(x)` via `registerComponentLabels(...)` |
|
|
53
|
+
| Email template definitions | `backend-api/src/modules/<slug>/emails/index.ts` + `templates/<template>.tsx` (SEPARATE pipeline) |
|
|
54
|
+
| Labelling CLI | `wildo generate labels` (primary locale comes from backend config) |
|
|
55
|
+
| Translation CLI | `wildo generate translate --locales=<csv>` |
|
|
56
|
+
|
|
57
|
+
## When to Use
|
|
58
|
+
|
|
59
|
+
- Added user-visible fields, enum values, or section titles
|
|
60
|
+
- Changed copy in specifications, UI behavior, or component label
|
|
61
|
+
registrations
|
|
62
|
+
- New module or resource shipping labels for the first time
|
|
63
|
+
- Renamed a key namespace (resource rename, field rename) —
|
|
64
|
+
source AND every translated locale must follow
|
|
65
|
+
- Pre-release sweep: every text-bearing change since last
|
|
66
|
+
translation run must be rerun
|
|
67
|
+
|
|
68
|
+
## When NOT to Use
|
|
69
|
+
|
|
70
|
+
- Backend-only changes with no user-facing strings (no labels
|
|
71
|
+
affected — skip the entire pipeline)
|
|
72
|
+
- Single-language internal tools that intentionally skip i18n
|
|
73
|
+
(explicit product decision; the pipeline still verifies the
|
|
74
|
+
source locale has all keys)
|
|
75
|
+
- Authoring keys without any translation requirement →
|
|
76
|
+
`i18n-label-generation` alone is enough
|
|
77
|
+
- Rerunning translation without any new keys →
|
|
78
|
+
`i18n-translation-rerun` alone is enough
|
|
79
|
+
- Email-template translations → those follow a separate
|
|
80
|
+
template-colocated pipeline (see `email-add-template`)
|
|
81
|
+
|
|
82
|
+
## Workflow
|
|
83
|
+
|
|
84
|
+
### Step 1: Inventory the change set
|
|
85
|
+
|
|
86
|
+
List every file you touched that produced user-facing copy:
|
|
87
|
+
|
|
88
|
+
- Schema files declaring fields / enum values
|
|
89
|
+
- Spec files declaring `meaning` / `whyItMatters` / `purpose` /
|
|
90
|
+
`useWhen` / `avoidWhen` prose
|
|
91
|
+
- UI behavior files declaring `enumUI` per-value labels or
|
|
92
|
+
`Section` titles
|
|
93
|
+
- Preset files calling `registerComponentLabels(...)`
|
|
94
|
+
- Email template files declaring subject / heading / button copy
|
|
95
|
+
(separate pipeline — escape-hatch only)
|
|
96
|
+
|
|
97
|
+
For each, identify which labelling unit it feeds (component,
|
|
98
|
+
resource, theme, system enum, etc.) — `wildo generate labels --plan`
|
|
99
|
+
prints the planned unit list.
|
|
100
|
+
|
|
101
|
+
Read `references/i18n-routing.md` for the routing table and
|
|
102
|
+
`references/framework-labelling-sections-api.md` for the section
|
|
103
|
+
taxonomy (eager vs backend-only).
|
|
104
|
+
|
|
105
|
+
### Step 2: Run `i18n-label-generation`
|
|
106
|
+
|
|
107
|
+
Run `wildo generate labels`. The labelling pipeline writes one per-unit
|
|
108
|
+
`<bucket>/<slug>.<primary-locale>.ts` file per touched unit into the engine
|
|
109
|
+
i18n tree and updates `wildo-saas.lock.json`. The
|
|
110
|
+
engine barrel auto-picks them up — there is no manual barrel edit,
|
|
111
|
+
ever. Adding a brand-new locale requires no barrel edit either —
|
|
112
|
+
the scanner discovers locale files by basename suffix.
|
|
113
|
+
|
|
114
|
+
### Step 3: Run `i18n-translation-rerun`
|
|
115
|
+
|
|
116
|
+
Run `wildo generate translate --locales=fr,de,...`. The translation
|
|
117
|
+
pipeline reads each unit's primary-locale file plus the spec context
|
|
118
|
+
and emits a sibling `<bucket>/<slug>.<target>.ts` for every requested
|
|
119
|
+
target locale, updating the lock's per-locale entries.
|
|
120
|
+
|
|
121
|
+
### Re-run Translation When Text Changes
|
|
122
|
+
|
|
123
|
+
If this work changes user-facing text, labels, descriptions, or enum-facing copy,
|
|
124
|
+
re-run the translation workflow before considering the task complete.
|
|
125
|
+
|
|
126
|
+
Use the project translation command/path that applies to the current app/module,
|
|
127
|
+
then verify that generated translation artifacts are updated consistently with
|
|
128
|
+
the source-language change.
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
### Step 4: Verify the missing-key audit
|
|
132
|
+
|
|
133
|
+
Check the CLI report from each step. Per-locale missing key count
|
|
134
|
+
must be zero (or match the agreed acceptance threshold for the
|
|
135
|
+
locale's release readiness). Spot-check the runtime resolver for
|
|
136
|
+
a representative key per locale (after backend restart so the
|
|
137
|
+
scanner picks up new files).
|
|
138
|
+
|
|
139
|
+
### Step 5: Commit + flag for QA
|
|
140
|
+
|
|
141
|
+
Commit the regenerated per-unit `<slug>.<locale>.ts` files plus
|
|
142
|
+
`wildo-saas.lock.json` alongside the spec / ui-behavior / preset
|
|
143
|
+
edits. They're auto-generated but **must** be committed — the
|
|
144
|
+
runtime resolver reads them at backend startup. QA verifies UI
|
|
145
|
+
strings render correctly per locale.
|
|
146
|
+
|
|
147
|
+
## Worked Example
|
|
148
|
+
|
|
149
|
+
The engine i18n barrel is the **shape every pipeline run writes
|
|
150
|
+
into** — auto-discovery via `scanCustomLabelsDirectory`:
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
## Usage Example
|
|
154
|
+
|
|
155
|
+
```typescript
|
|
156
|
+
*/
|
|
157
|
+
import { scanCustomLabelsDirectory } from '@wildo-ai/saas-backend-lib';
|
|
158
|
+
|
|
159
|
+
export const customLabels = await scanCustomLabelsDirectory({
|
|
160
|
+
importMetaUrl: import.meta.url,
|
|
161
|
+
});
|
|
162
|
+
|
|
163
|
+
export const labels = customLabels;
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
A canonical pipeline run for "added a `priority` enum field" looks
|
|
167
|
+
like:
|
|
168
|
+
|
|
169
|
+
1. **Schema edit** — `priority` enum added in
|
|
170
|
+
`tasks-manager/resources/todos/todos.schemas.ts` (covered by
|
|
171
|
+
`resource-add-field`, `example.resource.add-field.priority-enum`).
|
|
172
|
+
2. **Spec edit** — `priority` `enumSpec(...)` added in
|
|
173
|
+
`tasks-manager/resources/todos.resource.specification.ts` with
|
|
174
|
+
per-value `meaning` (covered by `spec-resource-update`,
|
|
175
|
+
`example.spec.resource.semantic-field`).
|
|
176
|
+
3. **UI behavior edit** — `priority` `enumUI` block added with
|
|
177
|
+
per-value badge mapping (covered by `resource-ui-behavior`,
|
|
178
|
+
`example.resource.ui-behavior.enum-badge`).
|
|
179
|
+
4. **`i18n-label-generation`** — `wildo generate labels` writes /
|
|
180
|
+
updates `resources/todos.<primary-locale>.ts` (and any sibling theme
|
|
181
|
+
units touched) under the engine i18n tree. The barrel re-discovers
|
|
182
|
+
them automatically on next backend start.
|
|
183
|
+
5. **`i18n-translation-rerun`** — `wildo generate translate
|
|
184
|
+
--locales=fr` writes / updates `resources/todos.fr.ts`.
|
|
185
|
+
6. **Verify** — missing-key audit shows `0` per locale; resolver
|
|
186
|
+
spot-check confirms localized strings render after restart.
|
|
187
|
+
|
|
188
|
+
This skill is the **glue that runs steps 4–6 in order**, after
|
|
189
|
+
the feature work in steps 1–3. It is *not* the one that authors
|
|
190
|
+
the spec / UI behavior — those are the source-of-truth layers
|
|
191
|
+
that feed the labelling pipeline.
|
|
192
|
+
|
|
193
|
+
## References
|
|
194
|
+
|
|
195
|
+
- `references/i18n-routing.md` — which sub-skill to use
|
|
196
|
+
- `references/framework-labelling-sections-api.md` — `LabellingTypes` source
|
|
197
|
+
- `i18n-label-generation/SKILL.md` — the **author** step (source-locale per-unit files)
|
|
198
|
+
- `i18n-translation-rerun/SKILL.md` — the **translate** step (target-locale per-unit files)
|
|
199
|
+
|
|
200
|
+
## Verification
|
|
201
|
+
|
|
202
|
+
- [ ] Every new user-visible string has a per-unit `<slug>.<source>.ts` entry under the engine i18n tree
|
|
203
|
+
- [ ] Every requested target locale has a sibling `<slug>.<target>.ts` per touched unit
|
|
204
|
+
- [ ] Per-unit generated files preserve the auto-generated header
|
|
205
|
+
- [ ] Both `wildo generate labels` and `wildo generate translate` ran without per-unit failures (or were explicitly skipped with a recorded reason)
|
|
206
|
+
- [ ] Missing-translation count per locale is zero (or matches the agreed acceptance threshold)
|
|
207
|
+
- [ ] No hard-coded product strings remain in JSX for the changed surfaces
|
|
208
|
+
- [ ] Regenerated per-unit files AND `wildo-saas.lock.json` are committed alongside the spec / ui-behavior / preset edits
|
|
209
|
+
- [ ] Runtime resolver returns localized strings (not raw keys, not source-locale fallbacks) after backend restart for a representative sample
|
|
210
|
+
|
|
211
|
+
### Grep invariants
|
|
212
|
+
|
|
213
|
+
Run from the app root, substituting `<source>` and `<target>`:
|
|
214
|
+
|
|
215
|
+
| Invariant | Command |
|
|
216
|
+
|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
217
|
+
| Engine barrel uses the scanner (single owner) | `rg -n 'scanCustomLabelsDirectory' backend-api/src/engine/i18n/index.ts` |
|
|
218
|
+
| At least one per-unit source-locale file exists | `rg --files backend-api/src/engine/i18n -g '*.<source>.ts' \| head` |
|
|
219
|
+
| Per-unit count matches between source and target | `diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' \| sed 's/<source>/X/' \| sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' \| sed 's/<target>/X/' \| sort)` |
|
|
220
|
+
| Lock file is up-to-date with both locales | `rg -n '"localeCode":\s*"(<source>\|<target>)"' wildo-saas.lock.json` |
|
|
221
|
+
| **No empty values** in any per-unit file (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.ts'` |
|
|
222
|
+
| **No hard-coded product strings** in JSX touched in this change | `rg -n ">[A-Z][a-z]+ [A-Z][a-z]" frontend/src/modules/<slug>/` |
|
|
223
|
+
| Every per-unit file preserves the auto-generated header | `rg -L "DO NOT EDIT THIS FILE MANUALLY" backend-api/src/engine/i18n -g '*.ts'` (output should be empty) |
|
|
224
|
+
| **No** monolithic `labels.<locale>.ts` (must be empty) | `rg --files backend-api/src/engine/i18n -g 'labels.*.ts' \| rg -v '/'` |
|
|
225
|
+
|
|
226
|
+
The high-signal invariant is **"per-unit count matches between
|
|
227
|
+
source and target"** combined with **"no empty values"** — drift
|
|
228
|
+
in either direction means the pipeline missed units or silently
|
|
229
|
+
emitted blank strings.
|
|
230
|
+
|
|
231
|
+
## Common Rationalizations
|
|
232
|
+
|
|
233
|
+
| Rationalization | Reality |
|
|
234
|
+
|-----------------|---------|
|
|
235
|
+
| "English-only for now" | Missing keys still break runtime label resolution in many setups (resolver returns the raw key as a string). Even single-locale apps must run the labelling pipeline. |
|
|
236
|
+
| "I'll translate everything before release" | Untranslated keys accumulate; release-day translation runs are slow, error-prone, and miss spec edits made between changes. Run the pipeline per change set. |
|
|
237
|
+
| "Skip translation for non-customer-facing keys" | Generic-sounding keys often surface in unexpected places (audit logs, error toasts, email subjects). Translate them all; suppress at the resolver if a locale truly skips. |
|
|
238
|
+
| "Just commit the spec change; QA can flag missing translations" | QA isn't the gate — the pipeline is. Shift the audit left so missing keys never leave the dev loop. |
|
|
239
|
+
| "I edited the generated per-unit `<slug>.fr.ts` directly to fix a typo" | Direct edits are overwritten on the next pipeline run. Fix the source (spec / ui-behavior / preset registration) and rerun translation; the typo propagates correctly per locale. |
|
|
240
|
+
| "Add a `customLabels` field to my new module so the engine doesn't have to scan it" | Wrong — the engine barrel is the **single owner** of `customLabels`; per-module duplicate scans cause key collisions and double-counting. Drop new units into the engine i18n tree and let the scanner pick them up. |
|
|
241
|
+
|
|
242
|
+
## Red Flags
|
|
243
|
+
|
|
244
|
+
- Spec / ui-behavior / preset edit committed without a labelling
|
|
245
|
+
rerun (the source locale silently lacks the new keys)
|
|
246
|
+
- Per-unit generated file missing the auto-generated header
|
|
247
|
+
(someone hand-edited it — the next run loses the change)
|
|
248
|
+
- A monolithic `labels.<locale>.ts` reappears under the engine i18n
|
|
249
|
+
tree (the aggregator is gone — anything claiming to need it is a
|
|
250
|
+
regression)
|
|
251
|
+
- Source-locale per-unit file exists but no target-locale sibling
|
|
252
|
+
(resolver falls back to source for every key in that unit)
|
|
253
|
+
- Domain module exporting its own `customLabels` slot (every label
|
|
254
|
+
flows through the engine barrel — module-level slots double-scan)
|
|
255
|
+
- Enum value added to schema without matching unit re-labellize +
|
|
256
|
+
re-translate (most-common silent drift)
|
|
257
|
+
- New email template subject / body strings shipped without their
|
|
258
|
+
template-side translation step (separate pipeline; this skill
|
|
259
|
+
doesn't drive it — see `email-add-template`)
|
|
260
|
+
|
|
261
|
+
## Related Skills
|
|
262
|
+
|
|
263
|
+
- `i18n-label-generation` — author source-locale per-unit files
|
|
264
|
+
- `i18n-translation-rerun` — translate non-primary locales
|
|
265
|
+
- `resource-add-field` — schema source feeding the pipeline
|
|
266
|
+
- `resource-ui-behavior` — `enumUI` source feeding the pipeline
|
|
267
|
+
- `spec-resource-update` — spec prose source feeding the pipeline
|
|
268
|
+
- `email-add-template` — email copy uses a SEPARATE template-colocated pipeline
|
|
269
|
+
- `backend-addon-wiring` — the engine module owns the `customLabels` slot
|