@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,134 @@
|
|
|
1
|
+
# Transactional custom-operation core API
|
|
2
|
+
|
|
3
|
+
Read this when PREFIX, core persistence, REPLACE, and POSTFIX must commit
|
|
4
|
+
atomically, especially when a hook reads or writes another resource.
|
|
5
|
+
|
|
6
|
+
The excerpt is the exact `@wildo-ai/saas-backend-lib` authoring contract,
|
|
7
|
+
including the required participant declaration and incompatible modes.
|
|
8
|
+
|
|
9
|
+
This contract is deliberately explicit: startup validates the declared
|
|
10
|
+
participant set, while each nested resource call must forward
|
|
11
|
+
`utils.serviceOptions` to join the transaction. The framework cannot discover
|
|
12
|
+
an undeclared resource access or repair a call that discards those options.
|
|
13
|
+
Conflict handling is equally explicit: a resolver must return `RECONCILED`,
|
|
14
|
+
`RETRY_TRANSACTION`, or `UNHANDLED`; the framework never interprets an absent
|
|
15
|
+
winner as permission to retry.
|
|
16
|
+
|
|
17
|
+
## Import Origins
|
|
18
|
+
|
|
19
|
+
- `@wildo-ai/saas-backend-lib`
|
|
20
|
+
|
|
21
|
+
## Source Excerpts
|
|
22
|
+
|
|
23
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
/**
|
|
27
|
+
* Explicit outcome of a conflict resolver invoked after the owned transaction
|
|
28
|
+
* has aborted.
|
|
29
|
+
*
|
|
30
|
+
* `RECONCILED` returns an already-committed semantic winner.
|
|
31
|
+
* `RETRY_TRANSACTION` requests the framework's single bounded retry of the
|
|
32
|
+
* complete transaction boundary.
|
|
33
|
+
* `UNHANDLED` preserves the original conflict without spending that retry.
|
|
34
|
+
*/
|
|
35
|
+
export enum ResourceCustomServiceImplementationTransactionalCoreConflictAction {
|
|
36
|
+
RECONCILED = 'reconciled',
|
|
37
|
+
RETRY_TRANSACTION = 'retry_transaction',
|
|
38
|
+
UNHANDLED = 'unhandled',
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConflictResolution =
|
|
42
|
+
| {
|
|
43
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.RECONCILED;
|
|
44
|
+
/** Already-committed operation result that is equivalent to this request. */
|
|
45
|
+
value: unknown;
|
|
46
|
+
}
|
|
47
|
+
| {
|
|
48
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.RETRY_TRANSACTION;
|
|
49
|
+
}
|
|
50
|
+
| {
|
|
51
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.UNHANDLED;
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConflictResolver = (
|
|
55
|
+
error: unknown,
|
|
56
|
+
input: unknown,
|
|
57
|
+
executionContext: ExecutionContext<any>,
|
|
58
|
+
utils: ResourceOperation_CustomImplementation_Utils,
|
|
59
|
+
) => Promise<ResourceCustomServiceImplementationTransactionalCoreConflictResolution>;
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Transaction ownership options for one custom-implementation registration.
|
|
63
|
+
*
|
|
64
|
+
* Import this surface from `@wildo-ai/saas-backend-lib` through
|
|
65
|
+
* `createResourceCustomServiceImplementation`. When `transactionalCore` is
|
|
66
|
+
* enabled, PREFIX, core persistence, REPLACE, and POSTFIX execute atomically.
|
|
67
|
+
* The framework includes the operation resource automatically; authors must
|
|
68
|
+
* name every additional resource touched by those phases and forward
|
|
69
|
+
* `utils.serviceOptions` to every nested resource call. Startup validates the
|
|
70
|
+
* declared participant set; it cannot discover an omitted call or make a call
|
|
71
|
+
* that drops `serviceOptions` join the transaction. Use an explicit empty
|
|
72
|
+
* object only for a genuinely single-resource transaction.
|
|
73
|
+
*
|
|
74
|
+
* @example
|
|
75
|
+
* createResourceCustomServiceImplementation({
|
|
76
|
+
* operationPath,
|
|
77
|
+
* transactionalCore: true,
|
|
78
|
+
* transactionParticipants: {
|
|
79
|
+
* owner: CoreResourceType.USERS,
|
|
80
|
+
* organization: CoreResourceType.ORGANIZATIONS,
|
|
81
|
+
* },
|
|
82
|
+
* handlers: { prefixCoreOperations },
|
|
83
|
+
* });
|
|
84
|
+
*
|
|
85
|
+
* The discriminated shape prevents authored TypeScript registrations from
|
|
86
|
+
* attaching a conflict resolver to a pipeline that does not own the core
|
|
87
|
+
* transaction. The registry repeats this check at runtime because factories
|
|
88
|
+
* may arrive through JavaScript, stale compiled output, or type erasure.
|
|
89
|
+
*/
|
|
90
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
91
|
+
| {
|
|
92
|
+
/**
|
|
93
|
+
* Runs PREFIX → core repository mutation → REPLACE → POSTFIX in one
|
|
94
|
+
* declared resource persistence transaction. The operation resource is
|
|
95
|
+
* included automatically; every additional resource accessed by these
|
|
96
|
+
* phases must be named in `transactionParticipants`, and every nested
|
|
97
|
+
* resource call must receive `utils.serviceOptions`.
|
|
98
|
+
*
|
|
99
|
+
* This is an explicit authoring contract, not dynamic access discovery:
|
|
100
|
+
* startup proves adapter compatibility for the declared set, but cannot
|
|
101
|
+
* detect an omitted participant or a call that discards the transaction.
|
|
102
|
+
*
|
|
103
|
+
* `OVERRIDE_ALL` is incompatible because it replaces and exits the
|
|
104
|
+
* pipeline before this boundary.
|
|
105
|
+
*/
|
|
106
|
+
transactionalCore: true;
|
|
107
|
+
/**
|
|
108
|
+
* Additional resource participants touched inside the atomic core phase,
|
|
109
|
+
* keyed by their semantic role at this boundary.
|
|
110
|
+
*
|
|
111
|
+
* An explicit empty object is required for a true single-resource
|
|
112
|
+
* transaction. This makes the absence of extra participants an authored
|
|
113
|
+
* decision instead of an accidental omission hidden behind a boolean.
|
|
114
|
+
* Calls to these resources must forward `utils.serviceOptions`; naming a
|
|
115
|
+
* participant alone does not implicitly propagate the transaction.
|
|
116
|
+
*/
|
|
117
|
+
transactionParticipants: Readonly<Record<string, string>>;
|
|
118
|
+
/**
|
|
119
|
+
* Optional idempotency resolver invoked outside an aborted transaction
|
|
120
|
+
* after a transactional-core conflict. The resolver must explicitly
|
|
121
|
+
* reconcile a committed winner, request the one bounded full-transaction
|
|
122
|
+
* retry, or leave the original conflict unhandled.
|
|
123
|
+
*/
|
|
124
|
+
transactionalCoreConflictResolver?: ResourceCustomServiceImplementationTransactionalCoreConflictResolver;
|
|
125
|
+
}
|
|
126
|
+
| {
|
|
127
|
+
/** Default non-transactional custom-implementation behavior. */
|
|
128
|
+
transactionalCore?: false;
|
|
129
|
+
/** Participant declarations only have meaning for an owned transaction. */
|
|
130
|
+
transactionParticipants?: never;
|
|
131
|
+
/** A conflict resolver has no valid invocation boundary without the transaction. */
|
|
132
|
+
transactionalCoreConflictResolver?: never;
|
|
133
|
+
};
|
|
134
|
+
```
|
package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Custom Operation Files
|
|
2
|
+
|
|
3
|
+
**Typical patterns:**
|
|
4
|
+
|
|
5
|
+
- `./backend-api/src/modules/<module>/resources/<resource>/<resource>.create.default.operation.ts`
|
|
6
|
+
- `./backend-api/src/modules/<module>/resources/<resource>/<resource>.update.default.operation.ts`
|
|
7
|
+
|
|
8
|
+
- Use `@wildo-ai/saas-backend-lib` patterns; handle errors with `isWildoBackendError`.
|
|
9
|
+
- Register the operation in DI/container per module convention.
|
|
10
|
+
- Keep DTO alignment with `shared-lib` schemas.
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: brand-logo-authoring
|
|
3
|
+
description: Author the application's brand-identity brief (the BrandSnapshot — brand name, logo direction, visual tone) that drives automatic logo + brand-image generation. Use when the user says "give the app a logo", "design our logo", "author the brand identity", "set the logo direction", "we need a brand mark", "generate the app logo", "what should our logo look like", "define the visual identity / visual tone", or "make our brand image". NOT for design tokens/colors (config-design-system) or verbal brand voice (market-tone-of-voice).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Brand & Logo Authoring
|
|
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
|
+
Authors the application's **brand-identity brief** — the `BrandSnapshot`, a
|
|
23
|
+
single English-authored visual-identity truth per app (sibling to the vision
|
|
24
|
+
and market snapshots). You author three things: the **name**, the **logo
|
|
25
|
+
direction** (the creative brief), and the **visual tone** (the aesthetic
|
|
26
|
+
register). From that brief the companion generates the master logo and every
|
|
27
|
+
derived asset (favicon, apple-touch, maskable, OG, email, monochrome,
|
|
28
|
+
dark/light), and those become the single source of truth every consumer (app
|
|
29
|
+
shell, website, docs, email, PDF, schema.org) resolves against.
|
|
30
|
+
|
|
31
|
+
The boundary this keeps: you author **direction**, never pixels. You do not
|
|
32
|
+
author the generated `resolvedAssets`, you do not set design-system color
|
|
33
|
+
tokens here, and you do not restate the verbal brand voice — each is a
|
|
34
|
+
distinct concern with its own home.
|
|
35
|
+
|
|
36
|
+
## App Paths
|
|
37
|
+
|
|
38
|
+
| Surface | Glob (relative to app root) |
|
|
39
|
+
|---|---|
|
|
40
|
+
| Brand snapshot instance (authored) | `specifications/src/brand/index.ts` (mirrors `specifications/src/brand/*.ts` member files) |
|
|
41
|
+
| Companion wiring (the slot) | `specifications/src/companion-exports.ts` (the `brandSpecification` slot) |
|
|
42
|
+
| Verbal brand voice (cross-reference, do NOT edit here) | `specifications/src/market/**` (`tonesOfVoice`) |
|
|
43
|
+
| Design-system color tokens (separate concern) | `frontend/src/config/design-system.config.ts` |
|
|
44
|
+
|
|
45
|
+
## When to Use
|
|
46
|
+
|
|
47
|
+
- The app has no logo / brand mark yet and needs one
|
|
48
|
+
- Redirecting the logo (different mark type, motifs, symbolism)
|
|
49
|
+
- Authoring or refining the visual tone (style keywords, mood, color story)
|
|
50
|
+
- Setting up the brand brief so the journey/companion can generate the logo
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- Color / surface / theme tokens → `config-design-system`
|
|
55
|
+
(`frontend/src/config/design-system.config.ts`) — `visualTone.colorIntent` is the
|
|
56
|
+
brand STORY, not token values
|
|
57
|
+
- Verbal brand voice (how the product *writes*) → `market-tone-of-voice`
|
|
58
|
+
- Hand-placing favicon/OG files → those are companion-GENERATED from this
|
|
59
|
+
brief; do not author them by hand
|
|
60
|
+
|
|
61
|
+
## Workflow
|
|
62
|
+
|
|
63
|
+
Classify → author name → direct the mark → set the visual tone → verify.
|
|
64
|
+
|
|
65
|
+
### Step 1: Locate / create the brand snapshot
|
|
66
|
+
|
|
67
|
+
// TODO CLI COMMAND: wildo context spec brand --template brand-all-information
|
|
68
|
+
Author (or open) `specifications/src/brand/index.ts` — the single
|
|
69
|
+
`BrandSnapshot` instance, wired to the companion via the `brandSpecification`
|
|
70
|
+
slot in `specifications/src/companion-exports.ts` (mirrors how
|
|
71
|
+
`marketSpecification` / `visionSpecification` are wired). See
|
|
72
|
+
`references/framework-brand-snapshot-api.md` for the exact shape.
|
|
73
|
+
|
|
74
|
+
### Step 2: Author the name
|
|
75
|
+
|
|
76
|
+
`name.brandName` is REQUIRED — the exact, case-sensitive string the logo
|
|
77
|
+
renders and every surface prints. Add `tagline` for combination marks / OG
|
|
78
|
+
imagery. Nothing visual here — colors and mark live in the next steps.
|
|
79
|
+
|
|
80
|
+
### Step 3: Direct the mark (`logoDirection`)
|
|
81
|
+
|
|
82
|
+
The creative brief the image model turns into the master logo. Pick the
|
|
83
|
+
`markType`, list concrete `motifs`, name the `symbolism` (derive it from the
|
|
84
|
+
vision idea/mission), and list imagery `avoid` don'ts. Keep
|
|
85
|
+
`backgroundTreatment: TRANSPARENT_ISOLATED` unless the brand truly needs
|
|
86
|
+
otherwise. See `references/brand-authoring-decisions.md` for the mark-type
|
|
87
|
+
table and the derivation-safety rules.
|
|
88
|
+
|
|
89
|
+
### Step 4: Set the visual tone (`visualTone`)
|
|
90
|
+
|
|
91
|
+
The VISUAL counterpart to the market voice: 3–7 `styleKeywords`, a one-line
|
|
92
|
+
`mood`, a prose `colorIntent`, and optional hex `colorSeeds`. Translate the
|
|
93
|
+
market `tonesOfVoice` into a look (see the decision aid) — cross-reference it,
|
|
94
|
+
never restate it.
|
|
95
|
+
|
|
96
|
+
### Step 5: Do NOT author `resolvedAssets`
|
|
97
|
+
|
|
98
|
+
Leave `resolvedAssets` empty. The companion logo step populates it (the
|
|
99
|
+
generated primary + derived variants). See
|
|
100
|
+
`references/framework-brand-asset-api.md`.
|
|
101
|
+
|
|
102
|
+
### Step 6: Regenerate + propagate
|
|
103
|
+
|
|
104
|
+
The companion logo step generates the master + derived assets from this brief
|
|
105
|
+
and populates the single source of truth. Consumers (app shell, website, docs,
|
|
106
|
+
email, PDF, schema.org) resolve their asset by `(composition, theme)` — no
|
|
107
|
+
per-consumer logo URLs.
|
|
108
|
+
|
|
109
|
+
## Worked Example
|
|
110
|
+
|
|
111
|
+
An application-owned `BrandSnapshot` is the preferred live reference once it
|
|
112
|
+
exists; until then, this minimal brief shows the three authored surfaces and the
|
|
113
|
+
one-line lesson of each. Author against the real contracts in
|
|
114
|
+
`references/framework-brand-snapshot-api.md`, not this snippet.
|
|
115
|
+
|
|
116
|
+
<!-- TIER C WAIVER: a stable application `BrandSnapshot` example is not yet available, so no honest Tier-A anchor exists to {{REFERENCE}} yet; a minimal illustrative brief is inlined here and should be replaced with a Tier-A example.brand.* anchor once a stable app example ships. -->
|
|
117
|
+
```ts
|
|
118
|
+
import type { BrandSnapshot } from '@wildo-ai/saas-specifications';
|
|
119
|
+
import {
|
|
120
|
+
BrandLogoMarkType, BrandLogoBackgroundTreatment,
|
|
121
|
+
} from '@wildo-ai/saas-specifications';
|
|
122
|
+
|
|
123
|
+
export const appBrandSnapshot: BrandSnapshot = {
|
|
124
|
+
name: { brandName: 'Northstar Tasks', tagline: 'Make the next move clear.' },
|
|
125
|
+
logoDirection: {
|
|
126
|
+
markType: BrandLogoMarkType.COMBINATION_MARK, // yields BOTH lockup + symbol
|
|
127
|
+
motifs: ['a rising checkmark'],
|
|
128
|
+
symbolism: ['momentum', 'clarity'], // derived from the vision mission
|
|
129
|
+
avoid: ['no gradients', 'no literal robots'],
|
|
130
|
+
backgroundTreatment: BrandLogoBackgroundTreatment.TRANSPARENT_ISOLATED, // derivation-safe
|
|
131
|
+
},
|
|
132
|
+
visualTone: {
|
|
133
|
+
styleKeywords: ['geometric', 'minimal', 'warm'], // 3–7, concrete
|
|
134
|
+
mood: 'Calm, precise, quietly confident.',
|
|
135
|
+
colorIntent: 'Cool blues grounded by a warm accent.',
|
|
136
|
+
colorSeeds: [], // pin hex only if already committed
|
|
137
|
+
},
|
|
138
|
+
resolvedAssets: [], // companion-generated — never hand-author
|
|
139
|
+
};
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## References
|
|
143
|
+
|
|
144
|
+
- `references/framework-brand-snapshot-api.md` — source-backed: the `BrandSnapshot` + name / logoDirection / visualTone contracts
|
|
145
|
+
- `references/framework-brand-asset-api.md` — source-backed: the companion-generated `resolvedAssets` (composition × theme × purpose axes)
|
|
146
|
+
- `references/brand-authoring-decisions.md` — decision aid: mark-type selection, background derivation-safety, visualTone-from-market-voice
|
|
147
|
+
|
|
148
|
+
## Verification
|
|
149
|
+
|
|
150
|
+
- [ ] `name.brandName` is set (required)
|
|
151
|
+
- [ ] `markType` chosen deliberately; `COMBINATION_MARK` unless there's a reason
|
|
152
|
+
- [ ] `backgroundTreatment` is `TRANSPARENT_ISOLATED` (or a documented reason otherwise)
|
|
153
|
+
- [ ] `styleKeywords` count is 3–7
|
|
154
|
+
- [ ] `resolvedAssets` is left empty (companion-generated)
|
|
155
|
+
- [ ] The brand snapshot is wired into `specifications/src/companion-exports.ts`
|
|
156
|
+
- [ ] Colors are NOT authored here (they belong to `config-design-system`)
|
|
157
|
+
|
|
158
|
+
### Grep invariants
|
|
159
|
+
|
|
160
|
+
Run from the app root:
|
|
161
|
+
|
|
162
|
+
| Invariant | Command |
|
|
163
|
+
|---|---|
|
|
164
|
+
| A brand snapshot instance exists | `rg -n "BrandSnapshot" specifications/src/brand/index.ts` |
|
|
165
|
+
| It is wired to the companion | `rg -n "brandSpecification" specifications/src/companion-exports.ts` |
|
|
166
|
+
| `resolvedAssets` is not hand-authored (should be `[]`) | `rg -n "resolvedAssets:\s*\[\s*\]" specifications/src/brand/index.ts` |
|
|
167
|
+
| No design-token hex leaked into the brief (colorSeeds aside) | `rg -n "'#[0-9a-fA-F]{3,8}'" specifications/src/brand/index.ts` |
|
|
168
|
+
| Background is derivation-safe | `rg -n "TRANSPARENT_ISOLATED" specifications/src/brand/index.ts` |
|
|
169
|
+
|
|
170
|
+
## Common Rationalizations
|
|
171
|
+
|
|
172
|
+
| Rationalization | Reality |
|
|
173
|
+
|---|---|
|
|
174
|
+
| "I'll just drop a favicon.png in public/" | The favicon is GENERATED from this brief and derived from the master; a hand-placed one drifts and bypasses the single source of truth. |
|
|
175
|
+
| "Put the brand colors in visualTone" | `visualTone.colorIntent` is the color STORY (prose); the actual tokens live in `config-design-system`. Restating hex here creates two sources of truth. |
|
|
176
|
+
| "WORDMARK is fine, we don't need a symbol" | A wordmark can't produce a square favicon/app-icon; the validator WARNs. Use `COMBINATION_MARK` unless the brand is truly wordmark-only. |
|
|
177
|
+
| "Author resolvedAssets so it's ready" | `resolvedAssets` is companion-generated; hand-authoring it fabricates asset references the pipeline will overwrite or the validator will flag. |
|
|
178
|
+
| "Set the visual tone AND the market voice here" | Verbal voice is `market-tone-of-voice`; visual tone is its counterpart. Cross-reference, don't duplicate. |
|
|
179
|
+
|
|
180
|
+
## Red Flags
|
|
181
|
+
|
|
182
|
+
- A `favicon.*` / `og-image.*` committed by hand into `public/` (catch: those are generated — the brief drives them; inspect for hand-placed brand files).
|
|
183
|
+
- `markType: WORDMARK` alongside an expectation of a square app icon (catch with the mark-type table — a wordmark has no symbol).
|
|
184
|
+
- Hex color literals in the brand brief (catch with the **No design-token hex** grep — must be empty aside from intentional `colorSeeds`).
|
|
185
|
+
- `resolvedAssets` populated by hand (catch with the **`resolvedAssets: []`** grep — it must be empty until the companion runs).
|
|
186
|
+
- The brand snapshot authored but not wired (catch with the **wired to the companion** grep — an unwired snapshot never reaches the generator).
|
|
187
|
+
|
|
188
|
+
## Related Skills
|
|
189
|
+
|
|
190
|
+
- `config-design-system` — the design-system color/surface/theme TOKENS (distinct from the brand brief's color STORY)
|
|
191
|
+
- `market-tone-of-voice` — the VERBAL brand voice (visualTone is its visual counterpart)
|
|
192
|
+
- `spec-companion-exports` — wiring the `brandSpecification` slot so the companion sees the brief
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Brand authoring decisions (decision aid)
|
|
2
|
+
|
|
3
|
+
Authored guidance for the three creative decisions the `BrandSnapshot`
|
|
4
|
+
encodes. Pair with `framework-brand-snapshot-api.md` for the exact field
|
|
5
|
+
contracts.
|
|
6
|
+
|
|
7
|
+
## 1. Pick the `markType` (logo archetype)
|
|
8
|
+
|
|
9
|
+
| markType | Use when | Derivation note |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| `WORDMARK` | The name is the identity; no separable symbol (e.g. a typeset name). | ⚠️ Cannot yield a square favicon/symbol — the validator WARNs if a `SYMBOL` or square-icon asset is expected. Avoid unless the brand is truly wordmark-only. |
|
|
12
|
+
| `LETTERMARK` | Stylized initials / monogram — squareable. | Fine for favicons. |
|
|
13
|
+
| `PICTORIAL_MARK` | A recognizable icon of a real thing. | Squareable; good favicon source. |
|
|
14
|
+
| `ABSTRACT_MARK` | A non-representational geometric symbol. | Squareable; good favicon source. |
|
|
15
|
+
| `COMBINATION_MARK` | Symbol + wordmark locked together. | Best default — yields BOTH a lockup (header/OG) and a symbol (favicon/rail). |
|
|
16
|
+
| `EMBLEM` | Text inside a contained badge. | Squareable but dense; test at small sizes. |
|
|
17
|
+
| `MASCOT` | An illustrated character. | Squareable but heavy; test favicon legibility. |
|
|
18
|
+
|
|
19
|
+
**Default to `COMBINATION_MARK`** unless the brand has a clear reason not to —
|
|
20
|
+
it is the only archetype that natively serves both the lockup and the symbol
|
|
21
|
+
composition the derived-asset pipeline needs.
|
|
22
|
+
|
|
23
|
+
## 2. Keep the background derivation-safe
|
|
24
|
+
|
|
25
|
+
Set `backgroundTreatment: TRANSPARENT_ISOLATED` (the default). It is the ONLY
|
|
26
|
+
treatment that rasterizes losslessly into every derived asset (favicon /
|
|
27
|
+
maskable / monochrome / dark-light). `SOLID_FIELD` and `CONTEXTUAL_SCENE` are
|
|
28
|
+
explicit opt-ins the pipeline must compensate for — the validator WARNs on
|
|
29
|
+
them. Author a non-transparent background only when the brand genuinely
|
|
30
|
+
requires it.
|
|
31
|
+
|
|
32
|
+
## 3. Derive `visualTone` from the market voice
|
|
33
|
+
|
|
34
|
+
The visual tone is the VISUAL counterpart of the market family's verbal
|
|
35
|
+
`tonesOfVoice` (Nielsen Norman 4-axis). Translate the voice into a look:
|
|
36
|
+
|
|
37
|
+
- A **serious / formal / respectful** voice → restrained geometry, muted
|
|
38
|
+
palette, generous whitespace.
|
|
39
|
+
- A **funny / casual / irreverent** voice → rounder forms, warmer accent,
|
|
40
|
+
more expressive motifs.
|
|
41
|
+
|
|
42
|
+
Keep `styleKeywords` to 3–7 concrete adjectives ("geometric", "minimal",
|
|
43
|
+
"warm") — fewer is too sparse to triangulate a look, more contradicts itself.
|
|
44
|
+
Put the color STORY in `colorIntent` as prose; only pin `colorSeeds` (hex)
|
|
45
|
+
when the brand has already committed to specific anchors that must agree with
|
|
46
|
+
`frontend/src/config/design-system.config.ts`.
|
|
47
|
+
|
|
48
|
+
## What NOT to author
|
|
49
|
+
|
|
50
|
+
- **`resolvedAssets`** — companion-generated (see `framework-brand-asset-api.md`).
|
|
51
|
+
- **Colors as design tokens** — that is `config-design-system`
|
|
52
|
+
(`frontend/src/config/design-system.config.ts`); `visualTone.colorIntent` is the
|
|
53
|
+
brand STORY, not the token values.
|
|
54
|
+
- **Verbal brand voice** — that is the market family's `tonesOfVoice`
|
|
55
|
+
(`market-tone-of-voice`). Cross-reference it; do not restate it.
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
# Framework — Brand Asset API (source-backed)
|
|
2
|
+
|
|
3
|
+
The `resolvedAssets` collection on the `BrandSnapshot` — the **single source
|
|
4
|
+
of truth** every logo/favicon/brand-image consumer resolves against. Read
|
|
5
|
+
this to understand what the companion logo step PRODUCES (you author the
|
|
6
|
+
direction, not these entries).
|
|
7
|
+
|
|
8
|
+
Each asset is described by three ORTHOGONAL axes — composition × theme ×
|
|
9
|
+
purpose — plus provenance (`ref`, `derivedFrom`, `generatedAt`). Consumers
|
|
10
|
+
resolve by the axes they care about (e.g. the app-shell header asks for
|
|
11
|
+
`(LOCKUP, DEFAULT)`, the collapsed sidebar rail asks for `(SYMBOL, DARK)`);
|
|
12
|
+
they never reach for a favicon slot as an in-app UI mark.
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-specifications`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
*
|
|
24
|
+
* A single **resolved brand asset** — one concrete image file, described
|
|
25
|
+
* by THREE ORTHOGONAL AXES rather than a single flat role. The collection
|
|
26
|
+
* of these on `BrandSnapshot.resolvedAssets` is THE single source of truth
|
|
27
|
+
* for the application's visual identity: the historically-fragmented logo
|
|
28
|
+
* strings (org branding, app config, email brand tokens, email context,
|
|
29
|
+
* auth DTO, loose favicon files) all resolve to a `BrandAsset` by axis
|
|
30
|
+
* instead of carrying their own free-form URL.
|
|
31
|
+
*
|
|
32
|
+
* **Why three axes, not one flat role** (framework mindset — preserve the
|
|
33
|
+
* distinctions, do not fold them for a shorter enum): a logo varies
|
|
34
|
+
* independently along composition, theme, and technical purpose. A single
|
|
35
|
+
* flat enum would multiply combinatorially (SYMBOL_DARK_FAVICON, …) and
|
|
36
|
+
* conflate three unrelated concerns. Consumers resolve by the axes they
|
|
37
|
+
* care about — the collapsed sidebar rail asks for `(SYMBOL, DARK)`, the
|
|
38
|
+
* app-shell header asks for `(LOCKUP, DEFAULT)` — and never touch a
|
|
39
|
+
* favicon slot for an in-app UI mark.
|
|
40
|
+
*
|
|
41
|
+
* - **`composition`** — the FORM (`BrandAssetComposition`): the symbol
|
|
42
|
+
* alone, the wordmark alone, or the two locked together. Distinct from
|
|
43
|
+
* `logoDirection.markType` (the brand's chosen archetype, an INPUT to
|
|
44
|
+
* generation) — a `COMBINATION_MARK` brand produces both a `LOCKUP` and
|
|
45
|
+
* a `SYMBOL` asset; a `WORDMARK` brand produces only a `WORDMARK` asset.
|
|
46
|
+
* - **`theme`** — the color context (`BrandAssetTheme`): the default mark,
|
|
47
|
+
* or a variant tuned for dark/light backgrounds, or a single-color
|
|
48
|
+
* knockout.
|
|
49
|
+
* - **`purpose`** — the technical consumption slot (`BrandAssetPurpose`):
|
|
50
|
+
* `MASTER` is the full-resolution source; `PRIMARY` is the base
|
|
51
|
+
* DISPLAY form a UI surface renders; the rest (`FAVICON`,
|
|
52
|
+
* `APPLE_TOUCH_ICON`, `MASKABLE_ICON`, `OG_IMAGE`, `EMAIL`) are
|
|
53
|
+
* size/format-constrained targets. Everything except `MASTER` is derived.
|
|
54
|
+
*
|
|
55
|
+
* Provenance is first-class so a regeneration is idempotent and auditable:
|
|
56
|
+
* - **`ref`** — stable kebab-case identity (the `_core` "ref is identity"
|
|
57
|
+
* convention), unique within `resolvedAssets`. `derivedFrom` addresses it.
|
|
58
|
+
* - **`storageRef`** — the `APPLICATION`-scoped storage locator the file
|
|
59
|
+
* lives at (a stored-file reference, NOT a loose CDN URL). Consumers
|
|
60
|
+
* resolve a servable URL from this ref through the file store.
|
|
61
|
+
* - **`derivedFrom`** — the `ref` of the asset this one was deterministically
|
|
62
|
+
* derived from (Layer-4 pipeline). `undefined` marks a **generated
|
|
63
|
+
* primary** — an asset the image model produced directly, which in a
|
|
64
|
+
* fully-derived brand is the `MASTER`. Every derived asset must trace,
|
|
65
|
+
* through a `derivedFrom` chain, back to a generated primary (the snapshot
|
|
66
|
+
* validator enforces reachability + no cycles). Note this is a PROVENANCE
|
|
67
|
+
* fact and `purpose` is a CONSUMPTION fact: they coincide for `MASTER` in
|
|
68
|
+
* the normal pipeline, but a brand whose derivation degraded ships its
|
|
69
|
+
* generated primary AT `PRIMARY`, so the two must not be conflated.
|
|
70
|
+
* - **`generatedAt`** / **`promptDigest`** — when it was produced and a
|
|
71
|
+
* stable digest of the generation inputs, so the companion can skip
|
|
72
|
+
* regeneration when nothing upstream changed, and the validator can flag
|
|
73
|
+
* assets older than a re-authored direction (freshness-lock parity with
|
|
74
|
+
* the i18n-labelling step).
|
|
75
|
+
*/
|
|
76
|
+
export enum BrandAssetComposition {
|
|
77
|
+
/** The symbol/icon alone — square-ish; favicons, app icons, sidebar rail. */
|
|
78
|
+
SYMBOL = 'SYMBOL',
|
|
79
|
+
/** The styled name alone (text-only) — a brand with no separable symbol. */
|
|
80
|
+
WORDMARK = 'WORDMARK',
|
|
81
|
+
/** Symbol + wordmark locked together (horizontal) — headers, OG, PDF. */
|
|
82
|
+
LOCKUP = 'LOCKUP',
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export enum BrandAssetTheme {
|
|
86
|
+
/** The default full-color mark on its intended background. */
|
|
87
|
+
DEFAULT = 'DEFAULT',
|
|
88
|
+
/** Variant tuned for dark backgrounds. */
|
|
89
|
+
DARK = 'DARK',
|
|
90
|
+
/** Variant tuned for light backgrounds. */
|
|
91
|
+
LIGHT = 'LIGHT',
|
|
92
|
+
/** Single-color knockout for monochrome contexts. */
|
|
93
|
+
MONOCHROME = 'MONOCHROME',
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export enum BrandAssetPurpose {
|
|
97
|
+
/**
|
|
98
|
+
* The full-resolution generated source for a (composition, theme) — what the
|
|
99
|
+
* image model produced, before any size constraint. Its consumers are print,
|
|
100
|
+
* high-DPI/retina export, and re-derivation; a UI surface must NOT render it.
|
|
101
|
+
*
|
|
102
|
+
* SEPARATE FROM `PRIMARY` DELIBERATELY. The two were one slot until 2026-08-19,
|
|
103
|
+
* and the merge was expensive rather than merely untidy: `resolveBrandAsset`'s
|
|
104
|
+
* fallback ladder ends at `(DEFAULT, PRIMARY)` for ANY composition, so PRIMARY
|
|
105
|
+
* is the universal last-resort every unresolved query in the system degrades
|
|
106
|
+
* to. With the master sitting there, the cheapest-to-reach slot held the most
|
|
107
|
+
* expensive file — Your Application' app-shell sidebar downloaded a 1,043,409-byte
|
|
108
|
+
* master to draw a ~32px mark, while the DARK and MONOCHROME siblings of that
|
|
109
|
+
* same PRIMARY slot were 512x512 derivations two orders of magnitude smaller.
|
|
110
|
+
* `MASTER` is reachable ONLY by an exact query, so full resolution is something
|
|
111
|
+
* a consumer asks for rather than something it is handed by a fallback.
|
|
112
|
+
*/
|
|
113
|
+
MASTER = 'MASTER',
|
|
114
|
+
/**
|
|
115
|
+
* The base DISPLAY form of a (composition, theme) — the mark a UI surface
|
|
116
|
+
* renders when it wants "the logo" and has no size-constrained slot in mind
|
|
117
|
+
* (app-shell header, sidebar rail, docs navbar). Derived from `MASTER` at a
|
|
118
|
+
* display-sensible size; not pixel-pinned by a platform contract the way the
|
|
119
|
+
* icon purposes below are, but never the unbounded source either.
|
|
120
|
+
*
|
|
121
|
+
* This is also the fallback target of every rung of `resolveBrandAsset` that is
|
|
122
|
+
* not an exact match, so a brand that ships anything at all should ship this.
|
|
123
|
+
*/
|
|
124
|
+
PRIMARY = 'PRIMARY',
|
|
125
|
+
/** Browser-chrome favicon (square; ICO/PNG/SVG). */
|
|
126
|
+
FAVICON = 'FAVICON',
|
|
127
|
+
/** iOS home-screen icon (square PNG, 180×180). */
|
|
128
|
+
APPLE_TOUCH_ICON = 'APPLE_TOUCH_ICON',
|
|
129
|
+
/** Android/PWA maskable icon (square PNG, safe-zone padded). */
|
|
130
|
+
MASKABLE_ICON = 'MASKABLE_ICON',
|
|
131
|
+
/** Open-Graph / social share image (1200×630). */
|
|
132
|
+
OG_IMAGE = 'OG_IMAGE',
|
|
133
|
+
/** Email-safe raster (flattened, fixed background for dark clients). */
|
|
134
|
+
EMAIL = 'EMAIL',
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
export enum BrandAssetFormat {
|
|
138
|
+
PNG = 'PNG',
|
|
139
|
+
SVG = 'SVG',
|
|
140
|
+
ICO = 'ICO',
|
|
141
|
+
WEBP = 'WEBP',
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
export const BrandAssetConfigSchema = z.object({
|
|
145
|
+
/** Stable kebab-case identity, unique within `resolvedAssets`. `derivedFrom` addresses it. */
|
|
146
|
+
ref: NonEmptyStringSchema,
|
|
147
|
+
/** The FORM axis — symbol, wordmark, or locked-up. */
|
|
148
|
+
composition: z.enum(BrandAssetComposition),
|
|
149
|
+
/** The color-context axis. Defaults to the intended full-color mark. */
|
|
150
|
+
theme: z.enum(BrandAssetTheme).default(BrandAssetTheme.DEFAULT),
|
|
151
|
+
/** The technical consumption axis. Defaults to the base DISPLAY form, never the `MASTER` source. */
|
|
152
|
+
purpose: z.enum(BrandAssetPurpose).default(BrandAssetPurpose.PRIMARY),
|
|
153
|
+
/** `APPLICATION`-scoped stored-file reference (never a loose CDN URL). */
|
|
154
|
+
storageRef: NonEmptyStringSchema,
|
|
155
|
+
/** Concrete file format. */
|
|
156
|
+
format: z.enum(BrandAssetFormat),
|
|
157
|
+
/** Pixel width (undefined for scalable SVG). */
|
|
158
|
+
width: z.number().int().positive().optional(),
|
|
159
|
+
/** Pixel height (undefined for scalable SVG). */
|
|
160
|
+
height: z.number().int().positive().optional(),
|
|
161
|
+
/**
|
|
162
|
+
* The `ref` of the asset this one was derived from. `undefined` marks a
|
|
163
|
+
* generated primary (image-model output). Every derived asset must trace
|
|
164
|
+
* back to a generated primary — enforced by the snapshot validator.
|
|
165
|
+
*/
|
|
166
|
+
derivedFrom: NonEmptyStringSchema.optional(),
|
|
167
|
+
/** ISO-8601 timestamp the asset was produced. */
|
|
168
|
+
generatedAt: z.iso.datetime(),
|
|
169
|
+
/**
|
|
170
|
+
* Stable digest of the generation inputs (brand direction + tone +
|
|
171
|
+
* enrichment). Lets the companion skip regeneration when nothing
|
|
172
|
+
* upstream changed, and lets the validator flag assets older than a
|
|
173
|
+
* re-authored direction — freshness-lock parity with i18n-labelling.
|
|
174
|
+
*/
|
|
175
|
+
promptDigest: NonEmptyStringSchema.optional(),
|
|
176
|
+
});
|
|
177
|
+
export type BrandAssetConfig = z.infer<typeof BrandAssetConfigSchema>;
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
**You do not author `resolvedAssets`.** It is empty until the companion logo
|
|
181
|
+
step runs; it then populates a generated primary (a `MASTER`-equivalent with
|
|
182
|
+
`derivedFrom` undefined) plus the derived favicon / apple-touch / maskable /
|
|
183
|
+
OG / email / monochrome / dark-light variants. Your job is to author the
|
|
184
|
+
`name` / `logoDirection` / `visualTone` that DRIVE that generation.
|