@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,287 @@
|
|
|
1
|
+
# assertions.specification.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The Assertion Surface's authored layer (master plan S1, revised
|
|
14
|
+
* 2026-07-02: assertions are SERVED, not filed in a static plan
|
|
15
|
+
* document). An assertion is a statement about the platform that the
|
|
16
|
+
* app-creation meta-workflows build against — served to consumers by
|
|
17
|
+
* the companion `assertions-list` / `assertions-resolve` /
|
|
18
|
+
* `assertions-reconcile` behaviors, with status
|
|
19
|
+
* (assumed → landed → drifted) COMPUTED by reconcile, never
|
|
20
|
+
* hand-maintained.
|
|
21
|
+
*
|
|
22
|
+
* Shape decision (implementation-spec P-3): a **versioned wrapper
|
|
23
|
+
* containing a keyed map**. The wrapper gives the family the
|
|
24
|
+
* format-version seam every served payload needs (market-snapshot
|
|
25
|
+
* style — G15); the keyed `entries` map gives entry-level identity
|
|
26
|
+
* for status/reconcile (definition-family style). Rejected
|
|
27
|
+
* alternatives: a bare aggregate object (market style — no
|
|
28
|
+
* entry-level reconcile identity) and a bare `Record` (definition
|
|
29
|
+
* style — no format-version seam).
|
|
30
|
+
*
|
|
31
|
+
* Prose fields (`statement`, `scope`, `blastRadius`, probe
|
|
32
|
+
* `expectation`) are **inline TS strings**, NOT referenced markdown
|
|
33
|
+
* files (implementation-spec P-4): specification families are pure TS
|
|
34
|
+
* by precedent; markdown machinery lives on the framework-knowledge
|
|
35
|
+
* playbook side (`method.md`), which is where long-form refinable
|
|
36
|
+
* prose belongs.
|
|
37
|
+
*/
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Versioning for the assertion-snapshot payload format itself.
|
|
41
|
+
* `V1` — initial shape (versioned wrapper + keyed entries map).
|
|
42
|
+
* The shape grows additively across versions; the `version` field is
|
|
43
|
+
* the explicit marker for consumers that need to branch on era.
|
|
44
|
+
*/
|
|
45
|
+
export enum AssertionSnapshotVersion {
|
|
46
|
+
V1 = 'v1',
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* What KIND of claim an assertion makes — drives how the reconcile
|
|
51
|
+
* behavior treats it:
|
|
52
|
+
*
|
|
53
|
+
* - `ASSUMED_FUTURE` — a bet about platform capabilities that do not
|
|
54
|
+
* exist yet (e.g. "the file-journal persistence lands in L4").
|
|
55
|
+
* Reconcile reports it `assumed` until reality confirms it
|
|
56
|
+
* (`landed`) or contradicts it (`drifted`).
|
|
57
|
+
* - `PINNED_CONTRACT` — a claim backed by deterministic pins (Zod
|
|
58
|
+
* contract + unit tests referenced via `reconciliation.pinRefs`).
|
|
59
|
+
* The pins are the trust floor: LLM interpretation can never soften
|
|
60
|
+
* a failing pin (S1 held condition (a)).
|
|
61
|
+
* - `DERIVED_LIVE` — a claim current reality can answer at query time
|
|
62
|
+
* via an introspection probe (`reconciliation.probe`); never copied,
|
|
63
|
+
* so it cannot rot by construction (S1 layer 2).
|
|
64
|
+
*/
|
|
65
|
+
export enum AssertionKind {
|
|
66
|
+
ASSUMED_FUTURE = 'assumed_future',
|
|
67
|
+
PINNED_CONTRACT = 'pinned_contract',
|
|
68
|
+
DERIVED_LIVE = 'derived_live',
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* The dev-only lane marker (implementation-spec P-4, REQUIRED on
|
|
73
|
+
* every entry — master plan S1 held condition (c)):
|
|
74
|
+
*
|
|
75
|
+
* - `FRAMEWORK_DEV` — framework-development knowledge (end-state
|
|
76
|
+
* platform bets, engine landmines). Authored in the dogfood app's
|
|
77
|
+
* specifications package during the framework-parallel era, but it
|
|
78
|
+
* must NEVER compile into shipped app knowledge — every consumer
|
|
79
|
+
* that materializes app-facing output filters this lane out.
|
|
80
|
+
* - `APP` — application-level assertions that legitimately ship with
|
|
81
|
+
* the generated app's knowledge surface.
|
|
82
|
+
*
|
|
83
|
+
* A required enum field was chosen over a file-location convention
|
|
84
|
+
* (rejected alternative): location conventions are invisible to the
|
|
85
|
+
* type system and silently break the moment a file moves; the enum
|
|
86
|
+
* forces every author to decide the lane and every consumer to filter
|
|
87
|
+
* deliberately.
|
|
88
|
+
*/
|
|
89
|
+
export enum AssertionLane {
|
|
90
|
+
FRAMEWORK_DEV = 'framework_dev',
|
|
91
|
+
APP = 'app',
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Live-reality probe for `assertions-reconcile` / `assertions-resolve`
|
|
96
|
+
* (S1 layer 2 — live derivation). Names a companion introspection
|
|
97
|
+
* behavior whose response answers the assertion, plus the prose
|
|
98
|
+
* expectation the answer is judged against. The subprocess evaluates
|
|
99
|
+
* probes deterministically where possible; LLM interpretation (S1
|
|
100
|
+
* layer 3) composes on top in the parent process and can never
|
|
101
|
+
* replace the deterministic layers.
|
|
102
|
+
*/
|
|
103
|
+
export const AssertionProbeConfigSchema = z.object({
|
|
104
|
+
/**
|
|
105
|
+
* Companion introspection behavior id to invoke (e.g.
|
|
106
|
+
* `resources-registry`, `resource-specifications`). Flat string —
|
|
107
|
+
* the behavior-id vocabulary is owned by the companion introspection
|
|
108
|
+
* plane; validators cross-check it only when handed the live id set
|
|
109
|
+
* (fail-soft otherwise).
|
|
110
|
+
*/
|
|
111
|
+
behaviorId: NonEmptyStringSchema,
|
|
112
|
+
/**
|
|
113
|
+
* Optional JSON-safe request payload forwarded to the behavior.
|
|
114
|
+
* Kept loose (`unknown` values) on purpose: each behavior owns its
|
|
115
|
+
* request contract and hand-parses defensively at the IPC boundary.
|
|
116
|
+
*/
|
|
117
|
+
request: z.record(z.string(), z.unknown()).optional(),
|
|
118
|
+
/**
|
|
119
|
+
* Prose describing what in the behavior's response confirms (or
|
|
120
|
+
* denies) the assertion. Inline TS string per P-4.
|
|
121
|
+
*/
|
|
122
|
+
expectation: NonEmptyStringSchema,
|
|
123
|
+
});
|
|
124
|
+
export type AssertionProbeConfig = z.infer<typeof AssertionProbeConfigSchema>;
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* How an assertion is reconciled against reality. Both channels are
|
|
128
|
+
* optional per entry — but the snapshot validator WARNs when the
|
|
129
|
+
* entry's `kind` promises a channel the entry does not carry
|
|
130
|
+
* (`PINNED_CONTRACT` without `pinRefs`, `DERIVED_LIVE` without
|
|
131
|
+
* `probe`).
|
|
132
|
+
*/
|
|
133
|
+
export const AssertionReconciliationSchema = z.object({
|
|
134
|
+
/**
|
|
135
|
+
* Refs of the deterministic pins (Zod contract + unit-test pairs)
|
|
136
|
+
* backing this assertion — see `AssertionPinRef`. Additive array,
|
|
137
|
+
* `default([])` so older payloads keep parsing.
|
|
138
|
+
*/
|
|
139
|
+
pinRefs: z.array(NonEmptyStringSchema).default([]),
|
|
140
|
+
/** Live introspection probe, when reality can answer at query time. */
|
|
141
|
+
probe: AssertionProbeConfigSchema.optional(),
|
|
142
|
+
});
|
|
143
|
+
export type AssertionReconciliation = z.infer<typeof AssertionReconciliationSchema>;
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* One authored assertion entry (implementation-spec P-4).
|
|
147
|
+
*
|
|
148
|
+
* Audit metadata posture (S1 held condition (b)): `confidence` and
|
|
149
|
+
* `blastRadius` are REQUIRED top-level fields — they are first-class
|
|
150
|
+
* audit state the reconcile behavior reports, not optional
|
|
151
|
+
* provenance. Status is deliberately NOT a field: it is computed by
|
|
152
|
+
* `assertions-reconcile` diffing the assumption against introspected
|
|
153
|
+
* reality (a stored status field would be a second, rotting truth).
|
|
154
|
+
*/
|
|
155
|
+
export const AssertionSpecificationConfigSchema = z.object({
|
|
156
|
+
/** Spec identity — kebab-case, `assertion-` prefixed (never `id`). */
|
|
157
|
+
ref: AssertionRefSchema,
|
|
158
|
+
/** The claim itself, business/engineering prose (inline TS string). */
|
|
159
|
+
statement: NonEmptyStringSchema,
|
|
160
|
+
/**
|
|
161
|
+
* Prose naming the surface the assertion covers (e.g. "companion
|
|
162
|
+
* claude-cli provider configuration", "generated-app skeleton
|
|
163
|
+
* companion-exports slots"). Deliberately prose, not an enum: the
|
|
164
|
+
* surface vocabulary grows with the platform and an enum here would
|
|
165
|
+
* freeze it for zero checking benefit. NOT the same concept as the
|
|
166
|
+
* behaviors' `scope` request filter (`Journey_Scope` — a
|
|
167
|
+
* module/resource subset selector); this field DESCRIBES, that one
|
|
168
|
+
* FILTERS.
|
|
169
|
+
*/
|
|
170
|
+
scope: NonEmptyStringSchema,
|
|
171
|
+
/** What kind of claim this is — see `AssertionKind`. */
|
|
172
|
+
kind: z.enum(AssertionKind),
|
|
173
|
+
/** Dev-only lane marker — see `AssertionLane`. REQUIRED (P-4). */
|
|
174
|
+
lane: z.enum(AssertionLane),
|
|
175
|
+
/**
|
|
176
|
+
* Author's confidence in the claim. Reuses the family-agnostic
|
|
177
|
+
* `AuthoredConfidence` vocabulary (LOW / MEDIUM / HIGH) from the
|
|
178
|
+
* authored-metadata pattern.
|
|
179
|
+
*/
|
|
180
|
+
confidence: z.enum(AuthoredConfidence),
|
|
181
|
+
/**
|
|
182
|
+
* Prose describing what breaks if the assertion turns out false
|
|
183
|
+
* (e.g. "choreographer AND labelling break together"). Prose over a
|
|
184
|
+
* severity enum (rejected alternative): the value of this field is
|
|
185
|
+
* the named consumer chain, which a LOW/MEDIUM/HIGH tier would
|
|
186
|
+
* erase.
|
|
187
|
+
*/
|
|
188
|
+
blastRadius: NonEmptyStringSchema,
|
|
189
|
+
/**
|
|
190
|
+
* Reconciliation channels. Defaults to `{ pinRefs: [] }` so
|
|
191
|
+
* `ASSUMED_FUTURE` entries (which legitimately have neither pins
|
|
192
|
+
* nor probes yet) stay light to author.
|
|
193
|
+
*
|
|
194
|
+
* The default MUST stay in function form: Zod 4 returns literal
|
|
195
|
+
* defaults by (shallow-cloned) reference, so a literal
|
|
196
|
+
* `{ pinRefs: [] }` would hand every defaulted entry the SAME
|
|
197
|
+
* nested array — one consumer mutation would corrupt every sibling
|
|
198
|
+
* entry AND persist into all future parses. The function is
|
|
199
|
+
* re-executed per parse, guaranteeing isolation.
|
|
200
|
+
*/
|
|
201
|
+
reconciliation: AssertionReconciliationSchema.default(() => ({ pinRefs: [] })),
|
|
202
|
+
/** Authoring provenance + version stamps — REQUIRED (see P-5 sibling file). */
|
|
203
|
+
authoredMetadata: AssertionAuthoredMetadataSchema,
|
|
204
|
+
});
|
|
205
|
+
export type AssertionSpecificationConfig = z.infer<typeof AssertionSpecificationConfigSchema>;
|
|
206
|
+
|
|
207
|
+
/**
|
|
208
|
+
* The AUTHORING surface of one entry — the schema's INPUT type, on
|
|
209
|
+
* which defaulted fields (`reconciliation`) are optional. This is
|
|
210
|
+
* what `buildAssertionSpecificationMap` accepts, so authors lean on
|
|
211
|
+
* schema defaults instead of hand-writing them; the parsed OUTPUT
|
|
212
|
+
* type (`AssertionSpecificationConfig`) is what the map stores.
|
|
213
|
+
*/
|
|
214
|
+
export type AssertionSpecificationConfigInput = z.input<typeof AssertionSpecificationConfigSchema>;
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* THE assertion family payload (implementation-spec P-3): versioned
|
|
218
|
+
* wrapper containing the keyed entries map. This is the shape the
|
|
219
|
+
* `assertionSpecifications` companion-exports slot carries and the
|
|
220
|
+
* `assertions-*` behaviors serve from.
|
|
221
|
+
*
|
|
222
|
+
* `entries` is keyed by `AssertionRef` — key and `entry.ref` MUST
|
|
223
|
+
* agree; `buildAssertionSpecificationMap` derives the key from the
|
|
224
|
+
* ref so hand-assembled drift is impossible on the factory path, and
|
|
225
|
+
* `validateAssertionSpecificationSnapshot` re-checks it for payloads
|
|
226
|
+
* assembled by hand.
|
|
227
|
+
*/
|
|
228
|
+
export const AssertionSpecificationSnapshotSchema = z.object({
|
|
229
|
+
version: z.enum(AssertionSnapshotVersion).default(AssertionSnapshotVersion.V1),
|
|
230
|
+
/**
|
|
231
|
+
* Keys are parse-enforced against `AssertionRefSchema` (Zod 4
|
|
232
|
+
* validates record key schemas), so a hand-assembled map with a
|
|
233
|
+
* malformed key fails at parse time — the walker's key↔ref checks
|
|
234
|
+
* remain for payloads that never went through `parse()`.
|
|
235
|
+
*/
|
|
236
|
+
entries: z.record(AssertionRefSchema, AssertionSpecificationConfigSchema).default({}),
|
|
237
|
+
});
|
|
238
|
+
export type AssertionSpecificationSnapshot = z.infer<typeof AssertionSpecificationSnapshotSchema>;
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Build the keyed `entries` map from a flat list of authored entries.
|
|
242
|
+
*
|
|
243
|
+
* Accepts the INPUT type (`AssertionSpecificationConfigInput`) so
|
|
244
|
+
* authors may omit defaulted fields (`reconciliation`); the returned
|
|
245
|
+
* map holds the PARSED output — defaults materialized, one fresh
|
|
246
|
+
* `reconciliation` instance per entry.
|
|
247
|
+
*
|
|
248
|
+
* Fail-closed at module load (definition-family convention — same
|
|
249
|
+
* posture as `buildFeatureSpecificationMap`):
|
|
250
|
+
*
|
|
251
|
+
* 1. Every entry is Zod-parsed against
|
|
252
|
+
* `AssertionSpecificationConfigSchema` — an invalid entry throws
|
|
253
|
+
* with a ref-prefixed message pointing at the exact authoring bug.
|
|
254
|
+
* 2. Duplicate refs throw — a duplicate almost always signals a
|
|
255
|
+
* copy-paste authoring slip, and failing at boot beats a silently
|
|
256
|
+
* last-wins map.
|
|
257
|
+
*
|
|
258
|
+
* The map is keyed by `entry.ref`, so key↔ref drift cannot happen on
|
|
259
|
+
* this path. Callers assemble the wrapper themselves:
|
|
260
|
+
* `{ version: AssertionSnapshotVersion.V1, entries: buildAssertionSpecificationMap(...) }`.
|
|
261
|
+
*/
|
|
262
|
+
export function buildAssertionSpecificationMap(
|
|
263
|
+
...entries: AssertionSpecificationConfigInput[]
|
|
264
|
+
): Record<AssertionRef, AssertionSpecificationConfig> {
|
|
265
|
+
const result: Record<AssertionRef, AssertionSpecificationConfig> = {};
|
|
266
|
+
|
|
267
|
+
for (const entry of entries) {
|
|
268
|
+
const parsed = AssertionSpecificationConfigSchema.safeParse(entry);
|
|
269
|
+
if (!parsed.success) {
|
|
270
|
+
const ref = typeof entry?.ref === 'string' && entry.ref.length > 0 ? entry.ref : '(missing ref)';
|
|
271
|
+
const details = formatZodIssues(parsed.error.issues).join('; ');
|
|
272
|
+
throw new Error(
|
|
273
|
+
`buildAssertionSpecificationMap(): assertion specification "${ref}": ${details}`,
|
|
274
|
+
);
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
if (result[parsed.data.ref]) {
|
|
278
|
+
throw new Error(
|
|
279
|
+
`buildAssertionSpecificationMap(): duplicate assertion specification ref "${parsed.data.ref}".`,
|
|
280
|
+
);
|
|
281
|
+
}
|
|
282
|
+
result[parsed.data.ref] = parsed.data;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
return result;
|
|
286
|
+
}
|
|
287
|
+
```
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
# brand.asset.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* A single **resolved brand asset** — one concrete image file, described
|
|
14
|
+
* by THREE ORTHOGONAL AXES rather than a single flat role. The collection
|
|
15
|
+
* of these on `BrandSnapshot.resolvedAssets` is THE single source of truth
|
|
16
|
+
* for the application's visual identity: the historically-fragmented logo
|
|
17
|
+
* strings (org branding, app config, email brand tokens, email context,
|
|
18
|
+
* auth DTO, loose favicon files) all resolve to a `BrandAsset` by axis
|
|
19
|
+
* instead of carrying their own free-form URL.
|
|
20
|
+
*
|
|
21
|
+
* **Why three axes, not one flat role** (framework mindset — preserve the
|
|
22
|
+
* distinctions, do not fold them for a shorter enum): a logo varies
|
|
23
|
+
* independently along composition, theme, and technical purpose. A single
|
|
24
|
+
* flat enum would multiply combinatorially (SYMBOL_DARK_FAVICON, …) and
|
|
25
|
+
* conflate three unrelated concerns. Consumers resolve by the axes they
|
|
26
|
+
* care about — the collapsed sidebar rail asks for `(SYMBOL, DARK)`, the
|
|
27
|
+
* app-shell header asks for `(LOCKUP, DEFAULT)` — and never touch a
|
|
28
|
+
* favicon slot for an in-app UI mark.
|
|
29
|
+
*
|
|
30
|
+
* - **`composition`** — the FORM (`BrandAssetComposition`): the symbol
|
|
31
|
+
* alone, the wordmark alone, or the two locked together. Distinct from
|
|
32
|
+
* `logoDirection.markType` (the brand's chosen archetype, an INPUT to
|
|
33
|
+
* generation) — a `COMBINATION_MARK` brand produces both a `LOCKUP` and
|
|
34
|
+
* a `SYMBOL` asset; a `WORDMARK` brand produces only a `WORDMARK` asset.
|
|
35
|
+
* - **`theme`** — the color context (`BrandAssetTheme`): the default mark,
|
|
36
|
+
* or a variant tuned for dark/light backgrounds, or a single-color
|
|
37
|
+
* knockout.
|
|
38
|
+
* - **`purpose`** — the technical consumption slot (`BrandAssetPurpose`):
|
|
39
|
+
* `MASTER` is the full-resolution source; `PRIMARY` is the base
|
|
40
|
+
* DISPLAY form a UI surface renders; the rest (`FAVICON`,
|
|
41
|
+
* `APPLE_TOUCH_ICON`, `MASKABLE_ICON`, `OG_IMAGE`, `EMAIL`) are
|
|
42
|
+
* size/format-constrained targets. Everything except `MASTER` is derived.
|
|
43
|
+
*
|
|
44
|
+
* Provenance is first-class so a regeneration is idempotent and auditable:
|
|
45
|
+
* - **`ref`** — stable kebab-case identity (the `_core` "ref is identity"
|
|
46
|
+
* convention), unique within `resolvedAssets`. `derivedFrom` addresses it.
|
|
47
|
+
* - **`storageRef`** — the `APPLICATION`-scoped storage locator the file
|
|
48
|
+
* lives at (a stored-file reference, NOT a loose CDN URL). Consumers
|
|
49
|
+
* resolve a servable URL from this ref through the file store.
|
|
50
|
+
* - **`derivedFrom`** — the `ref` of the asset this one was deterministically
|
|
51
|
+
* derived from (Layer-4 pipeline). `undefined` marks a **generated
|
|
52
|
+
* primary** — an asset the image model produced directly, which in a
|
|
53
|
+
* fully-derived brand is the `MASTER`. Every derived asset must trace,
|
|
54
|
+
* through a `derivedFrom` chain, back to a generated primary (the snapshot
|
|
55
|
+
* validator enforces reachability + no cycles). Note this is a PROVENANCE
|
|
56
|
+
* fact and `purpose` is a CONSUMPTION fact: they coincide for `MASTER` in
|
|
57
|
+
* the normal pipeline, but a brand whose derivation degraded ships its
|
|
58
|
+
* generated primary AT `PRIMARY`, so the two must not be conflated.
|
|
59
|
+
* - **`generatedAt`** / **`promptDigest`** — when it was produced and a
|
|
60
|
+
* stable digest of the generation inputs, so the companion can skip
|
|
61
|
+
* regeneration when nothing upstream changed, and the validator can flag
|
|
62
|
+
* assets older than a re-authored direction (freshness-lock parity with
|
|
63
|
+
* the i18n-labelling step).
|
|
64
|
+
*/
|
|
65
|
+
export enum BrandAssetComposition {
|
|
66
|
+
/** The symbol/icon alone — square-ish; favicons, app icons, sidebar rail. */
|
|
67
|
+
SYMBOL = 'SYMBOL',
|
|
68
|
+
/** The styled name alone (text-only) — a brand with no separable symbol. */
|
|
69
|
+
WORDMARK = 'WORDMARK',
|
|
70
|
+
/** Symbol + wordmark locked together (horizontal) — headers, OG, PDF. */
|
|
71
|
+
LOCKUP = 'LOCKUP',
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export enum BrandAssetTheme {
|
|
75
|
+
/** The default full-color mark on its intended background. */
|
|
76
|
+
DEFAULT = 'DEFAULT',
|
|
77
|
+
/** Variant tuned for dark backgrounds. */
|
|
78
|
+
DARK = 'DARK',
|
|
79
|
+
/** Variant tuned for light backgrounds. */
|
|
80
|
+
LIGHT = 'LIGHT',
|
|
81
|
+
/** Single-color knockout for monochrome contexts. */
|
|
82
|
+
MONOCHROME = 'MONOCHROME',
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export enum BrandAssetPurpose {
|
|
86
|
+
/**
|
|
87
|
+
* The full-resolution generated source for a (composition, theme) — what the
|
|
88
|
+
* image model produced, before any size constraint. Its consumers are print,
|
|
89
|
+
* high-DPI/retina export, and re-derivation; a UI surface must NOT render it.
|
|
90
|
+
*
|
|
91
|
+
* SEPARATE FROM `PRIMARY` DELIBERATELY. The two were one slot until 2026-08-19,
|
|
92
|
+
* and the merge was expensive rather than merely untidy: `resolveBrandAsset`'s
|
|
93
|
+
* fallback ladder ends at `(DEFAULT, PRIMARY)` for ANY composition, so PRIMARY
|
|
94
|
+
* is the universal last-resort every unresolved query in the system degrades
|
|
95
|
+
* to. With the master sitting there, the cheapest-to-reach slot held the most
|
|
96
|
+
* expensive file — Your Application' app-shell sidebar downloaded a 1,043,409-byte
|
|
97
|
+
* master to draw a ~32px mark, while the DARK and MONOCHROME siblings of that
|
|
98
|
+
* same PRIMARY slot were 512x512 derivations two orders of magnitude smaller.
|
|
99
|
+
* `MASTER` is reachable ONLY by an exact query, so full resolution is something
|
|
100
|
+
* a consumer asks for rather than something it is handed by a fallback.
|
|
101
|
+
*/
|
|
102
|
+
MASTER = 'MASTER',
|
|
103
|
+
/**
|
|
104
|
+
* The base DISPLAY form of a (composition, theme) — the mark a UI surface
|
|
105
|
+
* renders when it wants "the logo" and has no size-constrained slot in mind
|
|
106
|
+
* (app-shell header, sidebar rail, docs navbar). Derived from `MASTER` at a
|
|
107
|
+
* display-sensible size; not pixel-pinned by a platform contract the way the
|
|
108
|
+
* icon purposes below are, but never the unbounded source either.
|
|
109
|
+
*
|
|
110
|
+
* This is also the fallback target of every rung of `resolveBrandAsset` that is
|
|
111
|
+
* not an exact match, so a brand that ships anything at all should ship this.
|
|
112
|
+
*/
|
|
113
|
+
PRIMARY = 'PRIMARY',
|
|
114
|
+
/** Browser-chrome favicon (square; ICO/PNG/SVG). */
|
|
115
|
+
FAVICON = 'FAVICON',
|
|
116
|
+
/** iOS home-screen icon (square PNG, 180×180). */
|
|
117
|
+
APPLE_TOUCH_ICON = 'APPLE_TOUCH_ICON',
|
|
118
|
+
/** Android/PWA maskable icon (square PNG, safe-zone padded). */
|
|
119
|
+
MASKABLE_ICON = 'MASKABLE_ICON',
|
|
120
|
+
/** Open-Graph / social share image (1200×630). */
|
|
121
|
+
OG_IMAGE = 'OG_IMAGE',
|
|
122
|
+
/** Email-safe raster (flattened, fixed background for dark clients). */
|
|
123
|
+
EMAIL = 'EMAIL',
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export enum BrandAssetFormat {
|
|
127
|
+
PNG = 'PNG',
|
|
128
|
+
SVG = 'SVG',
|
|
129
|
+
ICO = 'ICO',
|
|
130
|
+
WEBP = 'WEBP',
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
export const BrandAssetConfigSchema = z.object({
|
|
134
|
+
/** Stable kebab-case identity, unique within `resolvedAssets`. `derivedFrom` addresses it. */
|
|
135
|
+
ref: NonEmptyStringSchema,
|
|
136
|
+
/** The FORM axis — symbol, wordmark, or locked-up. */
|
|
137
|
+
composition: z.enum(BrandAssetComposition),
|
|
138
|
+
/** The color-context axis. Defaults to the intended full-color mark. */
|
|
139
|
+
theme: z.enum(BrandAssetTheme).default(BrandAssetTheme.DEFAULT),
|
|
140
|
+
/** The technical consumption axis. Defaults to the base DISPLAY form, never the `MASTER` source. */
|
|
141
|
+
purpose: z.enum(BrandAssetPurpose).default(BrandAssetPurpose.PRIMARY),
|
|
142
|
+
/** `APPLICATION`-scoped stored-file reference (never a loose CDN URL). */
|
|
143
|
+
storageRef: NonEmptyStringSchema,
|
|
144
|
+
/** Concrete file format. */
|
|
145
|
+
format: z.enum(BrandAssetFormat),
|
|
146
|
+
/** Pixel width (undefined for scalable SVG). */
|
|
147
|
+
width: z.number().int().positive().optional(),
|
|
148
|
+
/** Pixel height (undefined for scalable SVG). */
|
|
149
|
+
height: z.number().int().positive().optional(),
|
|
150
|
+
/**
|
|
151
|
+
* The `ref` of the asset this one was derived from. `undefined` marks a
|
|
152
|
+
* generated primary (image-model output). Every derived asset must trace
|
|
153
|
+
* back to a generated primary — enforced by the snapshot validator.
|
|
154
|
+
*/
|
|
155
|
+
derivedFrom: NonEmptyStringSchema.optional(),
|
|
156
|
+
/** ISO-8601 timestamp the asset was produced. */
|
|
157
|
+
generatedAt: z.iso.datetime(),
|
|
158
|
+
/**
|
|
159
|
+
* Stable digest of the generation inputs (brand direction + tone +
|
|
160
|
+
* enrichment). Lets the companion skip regeneration when nothing
|
|
161
|
+
* upstream changed, and lets the validator flag assets older than a
|
|
162
|
+
* re-authored direction — freshness-lock parity with i18n-labelling.
|
|
163
|
+
*/
|
|
164
|
+
promptDigest: NonEmptyStringSchema.optional(),
|
|
165
|
+
});
|
|
166
|
+
export type BrandAssetConfig = z.infer<typeof BrandAssetConfigSchema>;
|
|
167
|
+
```
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# brand.authored-metadata.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Optional per-entity authoring provenance attached to any brand entity
|
|
14
|
+
* (the name, the logo direction, the visual tone) — the brand family's
|
|
15
|
+
* counterpart to `MarketAuthoredMetadataSchema` / `VisionAuthoredMetadataSchema`.
|
|
16
|
+
*
|
|
17
|
+
* Design decision (mirrors the vision-family P-5 note): this is a
|
|
18
|
+
* SIBLING schema, NOT a reshape of `market-authored-metadata.schemas.ts`.
|
|
19
|
+
* The market enums are already family-agnostic in name and meaning, so
|
|
20
|
+
* they are IMPORTED rather than duplicated (`AuthoredConfidence`,
|
|
21
|
+
* `ReviewCadence`): re-declaring either would silently drop it from the
|
|
22
|
+
* package-root barrel (ambiguous `export *` names are excluded), and
|
|
23
|
+
* hand-duplicated vocabularies drift. A shared `_core/authored-metadata`
|
|
24
|
+
* promotion is a `_core` reshape with the full blast-radius checklist —
|
|
25
|
+
* explicitly deferred.
|
|
26
|
+
*
|
|
27
|
+
* Same three concerns as the vision family — confidence (drives prompt
|
|
28
|
+
* enrichment so an AI surface never parrots a LOW-confidence brand
|
|
29
|
+
* direction as settled), recency (`lastAuthoredAt` + optional
|
|
30
|
+
* `reviewCadence`, feeding the snapshot validator's `STALE_AUTHORED`
|
|
31
|
+
* check), and trace (`reviewer` + `notes`). Entirely optional.
|
|
32
|
+
*/
|
|
33
|
+
export const BrandAuthoredMetadataSchema = z.object({
|
|
34
|
+
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
35
|
+
lastAuthoredAt: z.iso.datetime(),
|
|
36
|
+
/** Author's self-assessed confidence in the current content. */
|
|
37
|
+
confidence: z.enum(AuthoredConfidence),
|
|
38
|
+
/**
|
|
39
|
+
* Cadence at which the entity should be re-reviewed. When set, the
|
|
40
|
+
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
41
|
+
* cadence < now`. When omitted, no staleness check runs (same
|
|
42
|
+
* semantics as the market + vision families).
|
|
43
|
+
*/
|
|
44
|
+
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
45
|
+
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
46
|
+
reviewer: NonEmptyStringSchema.optional(),
|
|
47
|
+
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
48
|
+
notes: NonEmptyStringSchema.optional(),
|
|
49
|
+
});
|
|
50
|
+
export type BrandAuthoredMetadata = z.infer<typeof BrandAuthoredMetadataSchema>;
|
|
51
|
+
```
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# brand.logo-direction.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The **logo direction** — the authored creative brief a text-to-image
|
|
14
|
+
* model (`gpt-image`) turns into the master logo raster. One singleton
|
|
15
|
+
* per `BrandSnapshot`; OPTIONAL, because a brand may be named before its
|
|
16
|
+
* mark is directed (the snapshot validator WARNs, never fails, on
|
|
17
|
+
* absence — a partially-authored brand persists and resumes).
|
|
18
|
+
*
|
|
19
|
+
* This is the SEMANTIC HEART of logo generation: the companion logo
|
|
20
|
+
* step reads these fields (enriched with vision idea/mission + market
|
|
21
|
+
* `tonesOfVoice`/`category` in the introspection subprocess) to build
|
|
22
|
+
* the image prompt. Each field maps to a distinct lever of the prompt:
|
|
23
|
+
*
|
|
24
|
+
* - **`markType`** — which of the seven canonical mark archetypes to
|
|
25
|
+
* render (`BrandLogoMarkType`). Drives whether the prompt asks for a
|
|
26
|
+
* wordmark, a standalone symbol, a combination, etc.
|
|
27
|
+
* - **`motifs`** — concrete visual elements to include ("a rising
|
|
28
|
+
* checkmark", "concentric rings"). Short noun phrases, not sentences.
|
|
29
|
+
* - **`symbolism`** — the meaning the mark should evoke, derived from
|
|
30
|
+
* the product's mission/idea ("momentum", "clarity", "trust").
|
|
31
|
+
* - **`avoid`** — imagery don'ts ("no gradients", "no literal robots",
|
|
32
|
+
* "no clip-art gears") — the negative prompt discipline that keeps
|
|
33
|
+
* `gpt-image` output usable.
|
|
34
|
+
* - **`backgroundTreatment`** — how the master must be composed so the
|
|
35
|
+
* Layer-4 derivations (favicon/mono/dark-light) are clean. Defaults
|
|
36
|
+
* to a transparent isolated mark, the only treatment that rasterizes
|
|
37
|
+
* losslessly into every downstream asset role.
|
|
38
|
+
*/
|
|
39
|
+
export enum BrandLogoMarkType {
|
|
40
|
+
/** Text-only, styled name (e.g. "Google"). */
|
|
41
|
+
WORDMARK = 'WORDMARK',
|
|
42
|
+
/** Stylized initials/monogram (e.g. "IBM", "HBO"). */
|
|
43
|
+
LETTERMARK = 'LETTERMARK',
|
|
44
|
+
/** A recognizable pictorial icon of a real thing (e.g. Twitter bird). */
|
|
45
|
+
PICTORIAL_MARK = 'PICTORIAL_MARK',
|
|
46
|
+
/** A non-representational geometric/abstract symbol (e.g. the Nike swoosh). */
|
|
47
|
+
ABSTRACT_MARK = 'ABSTRACT_MARK',
|
|
48
|
+
/** Symbol + wordmark locked together (e.g. Spotify, Slack). */
|
|
49
|
+
COMBINATION_MARK = 'COMBINATION_MARK',
|
|
50
|
+
/** Text inside a contained shape/badge (e.g. Harley-Davidson). */
|
|
51
|
+
EMBLEM = 'EMBLEM',
|
|
52
|
+
/** An illustrated character/mascot (e.g. the Duolingo owl). */
|
|
53
|
+
MASCOT = 'MASCOT',
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* How the master logo raster must be composed. Only `TRANSPARENT_ISOLATED`
|
|
58
|
+
* rasterizes losslessly into every Layer-4 derivation (favicon, maskable,
|
|
59
|
+
* monochrome, dark/light) — the others are explicit opt-ins the companion
|
|
60
|
+
* pipeline must compensate for and are WARNed by the validator.
|
|
61
|
+
*/
|
|
62
|
+
export enum BrandLogoBackgroundTreatment {
|
|
63
|
+
/** Mark isolated on a transparent canvas. The clean default. */
|
|
64
|
+
TRANSPARENT_ISOLATED = 'TRANSPARENT_ISOLATED',
|
|
65
|
+
/** Mark on a solid brand-color field (needs knockout for favicons). */
|
|
66
|
+
SOLID_FIELD = 'SOLID_FIELD',
|
|
67
|
+
/** Mark composed into a scene (unsuitable for favicon/mono derivation). */
|
|
68
|
+
CONTEXTUAL_SCENE = 'CONTEXTUAL_SCENE',
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export const BrandLogoDirectionConfigSchema = z.object({
|
|
72
|
+
/** Which of the seven canonical mark archetypes to render. */
|
|
73
|
+
markType: z.enum(BrandLogoMarkType),
|
|
74
|
+
/** Concrete visual elements to include — short noun phrases, not sentences. */
|
|
75
|
+
motifs: z.array(NonEmptyStringSchema).default([]),
|
|
76
|
+
/** The meaning the mark should evoke, derived from mission/idea. */
|
|
77
|
+
symbolism: z.array(NonEmptyStringSchema).default([]),
|
|
78
|
+
/** Imagery don'ts — the negative-prompt discipline that keeps output usable. */
|
|
79
|
+
avoid: z.array(NonEmptyStringSchema).default([]),
|
|
80
|
+
/** How the master raster is composed so derivations stay clean. */
|
|
81
|
+
backgroundTreatment: z
|
|
82
|
+
.enum(BrandLogoBackgroundTreatment)
|
|
83
|
+
.default(BrandLogoBackgroundTreatment.TRANSPARENT_ISOLATED),
|
|
84
|
+
/** Optional per-entity authoring provenance. */
|
|
85
|
+
authored: BrandAuthoredMetadataSchema.optional(),
|
|
86
|
+
});
|
|
87
|
+
export type BrandLogoDirectionConfig = z.infer<typeof BrandLogoDirectionConfigSchema>;
|
|
88
|
+
```
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# brand.name.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The brand **name** — the anchor lexical identity of a brand brief.
|
|
14
|
+
* One per `BrandSnapshot`; it is the only REQUIRED entity in the family
|
|
15
|
+
* (logo direction and visual tone are elicited progressively and may be
|
|
16
|
+
* absent on an early snapshot), because a brand without a name has
|
|
17
|
+
* nothing for a wordmark/lettermark to render.
|
|
18
|
+
*
|
|
19
|
+
* What earns its place here:
|
|
20
|
+
* - **`brandName`** — the exact string the logo renders and every
|
|
21
|
+
* surface (app shell, website, email, docs) prints. Case-sensitive:
|
|
22
|
+
* `"Northstar Tasks"` ≠ `"northstar tasks"`. Fed verbatim into the
|
|
23
|
+
* text-to-image prompt so `gpt-image` does not re-spell it.
|
|
24
|
+
* - **`tagline`** — the optional supporting line ("Task OS for shipping
|
|
25
|
+
* teams"). Used by combination marks and OG imagery, never mandatory.
|
|
26
|
+
* - **`pronunciation`** — optional phonetic hint for voice/marketing
|
|
27
|
+
* surfaces; carries no visual weight but belongs to lexical identity.
|
|
28
|
+
*
|
|
29
|
+
* Deliberately does NOT model colors/typography here — that is the
|
|
30
|
+
* visual-tone territory (`BrandVisualTone`) and the design-system's
|
|
31
|
+
* `design-system.config.ts`. The brand name stays a lean lexical
|
|
32
|
+
* statement (framework mindset: no overloading one entity with
|
|
33
|
+
* another's semantic weight).
|
|
34
|
+
*/
|
|
35
|
+
export const BrandNameConfigSchema = z.object({
|
|
36
|
+
/** The exact, case-sensitive brand name the logo renders. */
|
|
37
|
+
brandName: NonEmptyStringSchema,
|
|
38
|
+
/** Optional supporting line used by combination marks + OG imagery. */
|
|
39
|
+
tagline: NonEmptyStringSchema.optional(),
|
|
40
|
+
/** Optional phonetic pronunciation hint (voice/marketing surfaces). */
|
|
41
|
+
pronunciation: NonEmptyStringSchema.optional(),
|
|
42
|
+
/** Optional per-entity authoring provenance. */
|
|
43
|
+
authored: BrandAuthoredMetadataSchema.optional(),
|
|
44
|
+
});
|
|
45
|
+
export type BrandNameConfig = z.infer<typeof BrandNameConfigSchema>;
|
|
46
|
+
```
|