@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,530 @@
|
|
|
1
|
+
# saas.specifications.companion-exports.contract
|
|
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
|
+
* Typed companion export surface: registries of resource specs, definitions, and view specs the dev companion materializes.
|
|
14
|
+
*/
|
|
15
|
+
export interface SpecificationsCompanionExports<
|
|
16
|
+
TResourceSpecifications = ResourceSpecification,
|
|
17
|
+
TBusinessSemanticsSnapshot = BusinessSemanticsSnapshot,
|
|
18
|
+
TFeatureSpecifications = FeatureSpecification,
|
|
19
|
+
TMilestoneSpecifications = MilestoneSpecification,
|
|
20
|
+
TProductSpecifications = ProductSpecification,
|
|
21
|
+
TRoleSpecifications = RoleSpecification,
|
|
22
|
+
TFrontendComponentSpecifications = FrontendComponentSpecification,
|
|
23
|
+
TCompositeViewSpecifications = CompositeViewSpecification,
|
|
24
|
+
TFullCustomViewSpecifications = FullCustomViewSpecification,
|
|
25
|
+
TFlowsActorsViewSpecifications = FlowsActorsViewSpecification,
|
|
26
|
+
TChartViewSpecifications = ChartViewSpecification,
|
|
27
|
+
TExecutionViewSpecifications = ExecutionViewSpecification,
|
|
28
|
+
TSystemEmailTemplateSpecifications = SystemEmailTemplateSpecification,
|
|
29
|
+
TOnboardingViewSpecifications = OnboardingViewSpecification,
|
|
30
|
+
TGuidanceFlowSpecifications = GuidanceFlowSpecification,
|
|
31
|
+
TDataSeedSpecifications = DataSeedSpecification,
|
|
32
|
+
TMarketSnapshot = MarketSnapshot,
|
|
33
|
+
TCatalogSpecifications = CatalogSpecifications,
|
|
34
|
+
// Appended LAST (not inserted mid-list): consumers pass these generics
|
|
35
|
+
// positionally (see the app companion-exports), so a new param must go at the
|
|
36
|
+
// end to avoid shifting existing ones onto the wrong types.
|
|
37
|
+
TSidebarSectionSpecifications = SidebarSectionSpecification,
|
|
38
|
+
TAssertionSpecifications = AssertionSpecificationSnapshot,
|
|
39
|
+
// ── app-creation meta-workflows C-4 definition families (U1–U4) — RESERVED SLOTS ──
|
|
40
|
+
// Four sibling `_core` families each register ONE companion-exports slot here,
|
|
41
|
+
// appended STRICTLY LAST in this FIXED order. Each session appends its generic
|
|
42
|
+
// param (below) AND its interface field (further down) AFTER the previous
|
|
43
|
+
// family's — NEVER re-order, NEVER insert mid-list. Consumers pass generics
|
|
44
|
+
// positionally, so re-ordering silently shifts every later app onto the wrong
|
|
45
|
+
// type. The reservation order (do not change):
|
|
46
|
+
// All four reserved families are now registered (U1–U4 done); the
|
|
47
|
+
// reserved-slots block below is fully filled and no further reservation
|
|
48
|
+
// follows. The final order (do not change):
|
|
49
|
+
// 1. vision (U1 — registered below)
|
|
50
|
+
// 2. requirements (U2 — registered below)
|
|
51
|
+
// 3. roadmap (U3 — registered below)
|
|
52
|
+
// 4. business-model-lite (U4 — registered below, LAST)
|
|
53
|
+
TVisionSnapshot = VisionSnapshot,
|
|
54
|
+
TRequirementsSnapshot = RequirementsSnapshot,
|
|
55
|
+
TRoadmapSnapshot = RoadmapSnapshot,
|
|
56
|
+
TBuildPlanTaskGraph = BuildPlanTaskGraph,
|
|
57
|
+
TPlacementPlan = PlacementPlan,
|
|
58
|
+
TDomainPlanOutputSet = DomainPlanOutputSet,
|
|
59
|
+
TBusinessModelLiteSnapshot = BusinessModelLiteSnapshot,
|
|
60
|
+
// Appended STRICTLY LAST (positional generics — never insert mid-list):
|
|
61
|
+
// the brand visual-identity definition family (`brand-brief`).
|
|
62
|
+
TBrandSnapshot = BrandSnapshot,
|
|
63
|
+
// Appended STRICTLY LAST: the expert-personas family (derived worker-persona
|
|
64
|
+
// charters — plural array, unlike the singleton snapshot families above).
|
|
65
|
+
TExpertPersonaCharters = ExpertPersonaCharter[],
|
|
66
|
+
// Appended STRICTLY LAST: accepted spec-first feature intent. This is
|
|
67
|
+
// deliberately distinct from `featureSpecifications`, whose entries already
|
|
68
|
+
// decorate runtime FeatureDefinitions and therefore represent a later stage.
|
|
69
|
+
TFeatureSpecificationDrafts = FeatureSpecificationDrafts,
|
|
70
|
+
// Appended STRICTLY LAST: accepted application compliance policy. The slot
|
|
71
|
+
// remains optional so applications that do not opt into `compliance-program`
|
|
72
|
+
// preserve their existing projection and family-head behavior.
|
|
73
|
+
TComplianceSpecification = AssuranceProgramSpecification,
|
|
74
|
+
// Appended STRICTLY LAST: the application's accepted public-document
|
|
75
|
+
// publication variants (`document-publication` family). Separate from
|
|
76
|
+
// `complianceSpecification` on purpose — see the field's JSDoc.
|
|
77
|
+
TDocumentPublicationSpecification = ApplicationDocumentPublicationSpecification,
|
|
78
|
+
// Appended STRICTLY LAST: accepted document facts that cannot be inferred
|
|
79
|
+
// from other semantic families. Raw decisions only; runtime grants,
|
|
80
|
+
// approvals and releases never enter companion exports.
|
|
81
|
+
TDocumentFactSpecification = ApplicationDocumentFactSpecification,
|
|
82
|
+
// Appended STRICTLY LAST: release-process selection is a separate accepted
|
|
83
|
+
// decision, never an implicit default of routing or document necessity.
|
|
84
|
+
TDocumentReleasePolicySpecification = ApplicationDocumentReleasePolicySpecification,
|
|
85
|
+
// Appended STRICTLY LAST: WHO else processes personal data, under what legal
|
|
86
|
+
// identity and where (issue #88). Optional, and the optionality is the design:
|
|
87
|
+
// a partial register is useful and its holes are REPORTED per provider against
|
|
88
|
+
// the application's configured set, rather than blocking anything.
|
|
89
|
+
TProcessorRegister = ApplicationProcessorRegister,
|
|
90
|
+
> {
|
|
91
|
+
resourceSpecifications: TResourceSpecifications;
|
|
92
|
+
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
93
|
+
/**
|
|
94
|
+
* Feature overlays exposed to the dev companion.
|
|
95
|
+
*
|
|
96
|
+
* **Required** (promoted 2026-04-22, carryforward #5 of the
|
|
97
|
+
* `non-view-specification-coverage` plan). The engine ships 7 explicit
|
|
98
|
+
* `CoreFeature` overlays plus an `EngineCapability`-derived programmatic
|
|
99
|
+
* module via `engineFeatureSpecifications`, so apps always have
|
|
100
|
+
* something to expose. Apps with no app-level feature overlays should
|
|
101
|
+
* pass `engineFeatureSpecifications` directly; apps with overlays
|
|
102
|
+
* should merge their own bi-scoped map on top using the same
|
|
103
|
+
* `buildFeatureSpecificationMap(...)` factory used by Your Application.
|
|
104
|
+
*/
|
|
105
|
+
featureSpecifications: TFeatureSpecifications;
|
|
106
|
+
/**
|
|
107
|
+
* Milestone overlays exposed to the dev companion.
|
|
108
|
+
*
|
|
109
|
+
* **Required** (promoted 2026-04-22, carryforward #5). Engine ships
|
|
110
|
+
* zero milestone overlays today (apps own the catalog), but the
|
|
111
|
+
* required discipline forces apps to either pass an explicit
|
|
112
|
+
* `buildMilestoneSpecificationMap()` (empty or otherwise) or wire a
|
|
113
|
+
* real overlay registry — eliminating the silent "I forgot to wire
|
|
114
|
+
* this surface" failure mode the optional shape allowed.
|
|
115
|
+
*/
|
|
116
|
+
milestoneSpecifications: TMilestoneSpecifications;
|
|
117
|
+
/**
|
|
118
|
+
* Product overlays exposed to the dev companion.
|
|
119
|
+
*
|
|
120
|
+
* **Required** (promoted 2026-04-22, carryforward #5). Same rationale
|
|
121
|
+
* as `milestoneSpecifications` — engine ships zero today, but the
|
|
122
|
+
* required shape eliminates the silent-omission failure mode.
|
|
123
|
+
*/
|
|
124
|
+
productSpecifications: TProductSpecifications;
|
|
125
|
+
/**
|
|
126
|
+
* Role overlays exposed to the dev companion.
|
|
127
|
+
*
|
|
128
|
+
* **Required** (promoted 2026-04-22, carryforward #5). Engine ships
|
|
129
|
+
* 12 explicit core-role overlays via `engineRoleSpecifications` (one
|
|
130
|
+
* per `CORE_APP_ROLES.*` member), so apps always have something to
|
|
131
|
+
* expose. Apps with no app-level roles should pass
|
|
132
|
+
* `engineRoleSpecifications` directly.
|
|
133
|
+
*/
|
|
134
|
+
roleSpecifications: TRoleSpecifications;
|
|
135
|
+
frontendComponentSpecifications?: TFrontendComponentSpecifications;
|
|
136
|
+
compositeViewSpecifications?: TCompositeViewSpecifications;
|
|
137
|
+
fullCustomViewSpecifications?: TFullCustomViewSpecifications;
|
|
138
|
+
flowsActorsViewSpecifications?: TFlowsActorsViewSpecifications;
|
|
139
|
+
chartViewSpecifications?: TChartViewSpecifications;
|
|
140
|
+
executionViewSpecifications?: TExecutionViewSpecifications;
|
|
141
|
+
/**
|
|
142
|
+
* Sidebar-section overlays exposed to the dev companion. Optional: sidebar
|
|
143
|
+
* sections are structural app-shell config with no prose of their own; an app
|
|
144
|
+
* that wants grounded sidebar labels authors a
|
|
145
|
+
* `buildSidebarSectionSpecificationMap(...)` here, otherwise the family falls
|
|
146
|
+
* back to keys-only generation.
|
|
147
|
+
*/
|
|
148
|
+
sidebarSectionSpecifications?: TSidebarSectionSpecifications;
|
|
149
|
+
/**
|
|
150
|
+
* System-email template overlays exposed to the dev companion.
|
|
151
|
+
*
|
|
152
|
+
* **Required** because the engine ships 12 templates out of the box
|
|
153
|
+
* (`engineSystemEmailTemplateSpecifications`); apps therefore always have
|
|
154
|
+
* something to expose, and forgetting to wire this surface would silently
|
|
155
|
+
* lose the entire system-email companion family. Apps with no app-level
|
|
156
|
+
* templates should pass `engineSystemEmailTemplateSpecifications` directly.
|
|
157
|
+
*/
|
|
158
|
+
systemEmailTemplateSpecifications: TSystemEmailTemplateSpecifications;
|
|
159
|
+
/**
|
|
160
|
+
* Onboarding-view overlays exposed to the dev companion.
|
|
161
|
+
*
|
|
162
|
+
* **Required** (promoted 2026-04-22, carryforward #5). Engine ships
|
|
163
|
+
* zero onboarding views by default, but the required shape eliminates
|
|
164
|
+
* the silent-omission failure mode. Apps with no app-level onboarding
|
|
165
|
+
* views should pass an empty `buildOnboardingViewSpecificationMap()`
|
|
166
|
+
* rather than omitting the field.
|
|
167
|
+
*/
|
|
168
|
+
onboardingViewSpecifications: TOnboardingViewSpecifications;
|
|
169
|
+
/**
|
|
170
|
+
* Guidance-flow overlays exposed to the dev companion.
|
|
171
|
+
*
|
|
172
|
+
* **Required** (promoted 2026-04-22, carryforward #5). Same discipline
|
|
173
|
+
* as `onboardingViewSpecifications` — engine ships zero by default,
|
|
174
|
+
* but the required shape eliminates the silent-omission failure mode.
|
|
175
|
+
* Apps with no app-level guidance flows should pass an empty
|
|
176
|
+
* `buildGuidanceFlowSpecificationMap()` rather than omitting the field.
|
|
177
|
+
*/
|
|
178
|
+
guidanceFlowSpecifications: TGuidanceFlowSpecifications;
|
|
179
|
+
/**
|
|
180
|
+
* Data-seeding overlays exposed to the dev companion.
|
|
181
|
+
*
|
|
182
|
+
* **Optional** in Phase 1 because the engine ships zero seeds yet — the
|
|
183
|
+
* `DataSeedRegistry` and the dispatcher land in Phase 2. Authoring a seed
|
|
184
|
+
* spec without the runtime declaration is allowed (the spec slice is
|
|
185
|
+
* useful as design documentation on its own); authoring a runtime seed
|
|
186
|
+
* without a spec is also allowed (no companion grounding, dispatcher
|
|
187
|
+
* still runs it). Once Phase 2 ships engine seeds this field will be
|
|
188
|
+
* promoted to required, mirroring `systemEmailTemplateSpecifications`.
|
|
189
|
+
*
|
|
190
|
+
* Apps with no app-level seeds should pass an empty
|
|
191
|
+
* `buildDataSeedSpecificationMap()` rather than omitting the field once
|
|
192
|
+
* Phase 2 lands.
|
|
193
|
+
*/
|
|
194
|
+
dataSeedSpecifications?: TDataSeedSpecifications;
|
|
195
|
+
/**
|
|
196
|
+
* Application market specification — the English-authored marketing /
|
|
197
|
+
* positioning truth (category, ICPs, personas, jobs/pains/gains, tones
|
|
198
|
+
* of voice, benefits, positionings, message templates). Optional today
|
|
199
|
+
* because not every example app authors a market snapshot yet; once it
|
|
200
|
+
* graduates to required, app bootstraps should run
|
|
201
|
+
* `validateMarketSnapshot` on the value before wiring it here.
|
|
202
|
+
*
|
|
203
|
+
* Authored entirely in English. Geographic targeting (the only
|
|
204
|
+
* "localization" the slice models) lives inside
|
|
205
|
+
* `MarketICP.profile.geographies`.
|
|
206
|
+
*/
|
|
207
|
+
marketSpecification?: TMarketSnapshot;
|
|
208
|
+
/**
|
|
209
|
+
* Catalog specifications — declarations of EXTERNAL vocabularies the
|
|
210
|
+
* framework reasons about (Schema.org JSON-LD today; future:
|
|
211
|
+
* OpenAPI, RSS, JSON-Feed). Distinct from overlay specs above —
|
|
212
|
+
* overlay specs decorate registry entries (resources, features,
|
|
213
|
+
* views); catalog specs OWN the contract for an external
|
|
214
|
+
* vocabulary's per-entity shape (required / optional / deprecated
|
|
215
|
+
* field declarations).
|
|
216
|
+
*
|
|
217
|
+
* **Composition**: apps spread the engine catalog (e.g.
|
|
218
|
+
* `ENGINE_SCHEMA_ORG_CATALOG`) and append app-side extensions /
|
|
219
|
+
* overrides. The companion's catalog reconciliation runs against
|
|
220
|
+
* this merged surface — emission sites in `@wildo-ai/saas-website`
|
|
221
|
+
* sections (via `getStructuredData()`) are checked against the
|
|
222
|
+
* merged `schemaOrg` catalog, with warnings on missing required
|
|
223
|
+
* fields, deprecated-field usage, and (when wired) missing
|
|
224
|
+
* recommended optionals. Catalog overrides (app entry redefining
|
|
225
|
+
* an engine entry's `@type`) emit a `catalog-override` boot
|
|
226
|
+
* warning.
|
|
227
|
+
*
|
|
228
|
+
* **Optional** in v1 because not every app emits structured data
|
|
229
|
+
* yet. Apps wiring an engine catalog explicitly opt into
|
|
230
|
+
* companion reconciliation by populating the matching slot.
|
|
231
|
+
*/
|
|
232
|
+
catalogSpecifications?: TCatalogSpecifications;
|
|
233
|
+
/**
|
|
234
|
+
* Assertion surface — the authored layer of the dynamic Assertion
|
|
235
|
+
* Surface (app-creation meta-workflows, master plan S1): statements
|
|
236
|
+
* about the platform served via the companion `assertions-list` /
|
|
237
|
+
* `assertions-resolve` / `assertions-reconcile` behaviors, with
|
|
238
|
+
* status computed by reconcile rather than hand-maintained.
|
|
239
|
+
*
|
|
240
|
+
* **Optional** — the launch posture of every new family: not every
|
|
241
|
+
* example app authors assertions yet, and the family must not break
|
|
242
|
+
* existing companion exports on arrival. Once it graduates to
|
|
243
|
+
* required, app bootstraps should run
|
|
244
|
+
* `validateAssertionSpecificationSnapshot` on the value before
|
|
245
|
+
* wiring it here (the behavior resolver validates on entry either
|
|
246
|
+
* way, market-style).
|
|
247
|
+
*
|
|
248
|
+
* Lane discipline: entries carrying
|
|
249
|
+
* `lane: AssertionLane.FRAMEWORK_DEV` are framework-development
|
|
250
|
+
* knowledge (end-state platform bets authored in the dogfood app
|
|
251
|
+
* during the framework-parallel era) and must NEVER compile into
|
|
252
|
+
* shipped app knowledge — consumers filter on `lane` deliberately.
|
|
253
|
+
*/
|
|
254
|
+
assertionSpecifications?: TAssertionSpecifications;
|
|
255
|
+
// ── app-creation meta-workflows C-4 definition families (U1–U4) — FIELDS ──
|
|
256
|
+
// One field per family, in the SAME fixed order as the generic params
|
|
257
|
+
// above. All four are now registered (U1–U4 done); no reservation remains:
|
|
258
|
+
// 1. visionSpecification (U1 — below)
|
|
259
|
+
// 2. requirementsSpecification (U2 — below)
|
|
260
|
+
// 3. roadmapSpecification (U3 — below)
|
|
261
|
+
// 4. businessModelLiteSpecification (U4 — below, LAST)
|
|
262
|
+
/**
|
|
263
|
+
* Application **vision** specification — the foundational-intent truth
|
|
264
|
+
* (idea, problem statement, mission, success criteria, constraints incl.
|
|
265
|
+
* compliance) the app-creation top-down catalog reads/writes (C-4
|
|
266
|
+
* definition families). A single aggregate per app (market-snapshot
|
|
267
|
+
* style), validated by `validateVisionSnapshot`.
|
|
268
|
+
*
|
|
269
|
+
* **Optional** — the launch posture of every new family (market /
|
|
270
|
+
* assertions parity): not every example app authors a vision snapshot
|
|
271
|
+
* yet, and the family must not break existing companion exports on
|
|
272
|
+
* arrival. Once it graduates to required, app bootstraps should run
|
|
273
|
+
* `validateVisionSnapshot` on the value before wiring it here.
|
|
274
|
+
*/
|
|
275
|
+
visionSpecification?: TVisionSnapshot;
|
|
276
|
+
/**
|
|
277
|
+
* Application **requirements** specification — the requirements-layer
|
|
278
|
+
* truth (functional requirements + non-functional requirements, each
|
|
279
|
+
* optionally cross-referencing market ICPs / jobs) the app-creation
|
|
280
|
+
* top-down capability-map catalog reads/writes (C-4 definition
|
|
281
|
+
* families). A single aggregate per app (market-snapshot style),
|
|
282
|
+
* validated by `validateRequirementsSnapshot`.
|
|
283
|
+
*
|
|
284
|
+
* **Optional** — the launch posture of every new family (vision /
|
|
285
|
+
* market / assertions parity): not every example app authors a
|
|
286
|
+
* requirements snapshot yet, and the family must not break existing
|
|
287
|
+
* companion exports on arrival. Once it graduates to required, app
|
|
288
|
+
* bootstraps should run `validateRequirementsSnapshot` on the value
|
|
289
|
+
* before wiring it here.
|
|
290
|
+
*/
|
|
291
|
+
requirementsSpecification?: TRequirementsSnapshot;
|
|
292
|
+
/**
|
|
293
|
+
* Application **roadmap** specification — the delivery-roadmap truth (a
|
|
294
|
+
* product's delivery plan as an ordered collection of releases/phases,
|
|
295
|
+
* each optionally cross-referencing the requirements /
|
|
296
|
+
* vision-success-criteria it delivers) the app-creation top-down
|
|
297
|
+
* scope/roadmap catalog reads/writes (C-4 definition families). A single
|
|
298
|
+
* aggregate per app (market-snapshot style), validated by
|
|
299
|
+
* `validateRoadmapSnapshot`. Distinct from `milestoneSpecifications` (a
|
|
300
|
+
* dated registry-overlay surface) — a roadmap phase is a planning
|
|
301
|
+
* artifact, not a runtime milestone.
|
|
302
|
+
*
|
|
303
|
+
* **Optional** — the launch posture of every new family (vision /
|
|
304
|
+
* requirements / market / assertions parity): not every example app
|
|
305
|
+
* authors a roadmap snapshot yet, and the family must not break existing
|
|
306
|
+
* companion exports on arrival. Once it graduates to required, app
|
|
307
|
+
* bootstraps should run `validateRoadmapSnapshot` on the value before
|
|
308
|
+
* wiring it here.
|
|
309
|
+
*/
|
|
310
|
+
roadmapSpecification?: TRoadmapSnapshot;
|
|
311
|
+
/**
|
|
312
|
+
* Application **build-plan** specification — the ORDERED typed task graph
|
|
313
|
+
* (`BuildPlanTaskGraph`, `_core/build-plan/`) that turns the accepted domain
|
|
314
|
+
* plan into buildable units; produced by the build-decompose playbook and
|
|
315
|
+
* consumed one READY task at a time by build-dispatch. Optional until an
|
|
316
|
+
* application reaches the bottom-up phase; app bootstraps should run
|
|
317
|
+
* `validateBuildPlanTaskGraph` on the value before wiring it here.
|
|
318
|
+
*/
|
|
319
|
+
buildPlanSpecification?: TBuildPlanTaskGraph;
|
|
320
|
+
/**
|
|
321
|
+
* Application **placement** specification — WHERE every settings destination,
|
|
322
|
+
* resource operation and app view sits in the shell, and WHY (`PlacementPlan`,
|
|
323
|
+
* `_core/placement-plan/`).
|
|
324
|
+
*
|
|
325
|
+
* Produced by the `bottom_up.placement-plan` playbook as an expert-panel
|
|
326
|
+
* DELIBERATION rather than a creator elicitation: the creator does not choose
|
|
327
|
+
* placement, so each decision carries a `rationale` that answers "why is this
|
|
328
|
+
* here?" without re-running the panel. Consumed by build-decompose, which
|
|
329
|
+
* turns it into the coding tasks that author `settings-hub.config.ts` and
|
|
330
|
+
* `app-shell.config.ts`.
|
|
331
|
+
*
|
|
332
|
+
* Optional until an application reaches the bottom-up phase; app bootstraps
|
|
333
|
+
* should run `validatePlacementPlan` on the value before wiring it here.
|
|
334
|
+
*/
|
|
335
|
+
placementPlanSpecification?: TPlacementPlan;
|
|
336
|
+
/**
|
|
337
|
+
* Application **domain-plan** specification — the atomic module decomposition
|
|
338
|
+
* PLUS relationship drafts (`DomainPlanOutputSet`, `_core/domain-plan/`);
|
|
339
|
+
* produced by the domain-plan playbook, decomposed by build-decompose.
|
|
340
|
+
* Optional until an application reaches the bottom-up phase.
|
|
341
|
+
*/
|
|
342
|
+
domainPlanSpecification?: TDomainPlanOutputSet;
|
|
343
|
+
/**
|
|
344
|
+
* Application **business-model-lite** specification — the lightweight
|
|
345
|
+
* business-model truth (a coarse product-level revenue model + a pricing-
|
|
346
|
+
* plan sketch, each plan optionally cross-referencing the market ICPs it
|
|
347
|
+
* targets and the requirements it includes) the app-creation top-down
|
|
348
|
+
* catalog reads/writes (C-4 definition families). A single aggregate per
|
|
349
|
+
* app (market-snapshot style), validated by
|
|
350
|
+
* `validateBusinessModelLiteSnapshot`. A PLANNING artifact — deliberately
|
|
351
|
+
* NOT the live billing / Stripe product-catalog runtime (it models
|
|
352
|
+
* pricing INTENT, never chargeable state). The `-lite` is the
|
|
353
|
+
* scaffold-depth qualifier of the Phase-J1 increment; the artifact-family
|
|
354
|
+
* id is `business-model`.
|
|
355
|
+
*
|
|
356
|
+
* **Optional** — the launch posture of every new family (vision /
|
|
357
|
+
* requirements / roadmap / market / assertions parity): not every example
|
|
358
|
+
* app authors a business-model snapshot yet, and the family must not break
|
|
359
|
+
* existing companion exports on arrival. Once it graduates to required,
|
|
360
|
+
* app bootstraps should run `validateBusinessModelLiteSnapshot` on the
|
|
361
|
+
* value before wiring it here.
|
|
362
|
+
*/
|
|
363
|
+
businessModelLiteSpecification?: TBusinessModelLiteSnapshot;
|
|
364
|
+
/**
|
|
365
|
+
* Application **brand** specification — the visual-identity brief (brand
|
|
366
|
+
* name + logo direction + visual tone; `resolvedAssets` populated by the
|
|
367
|
+
* companion logo step) the app-creation top-down `brand-identity` playbook
|
|
368
|
+
* reads/writes. A single aggregate per app (vision-snapshot style),
|
|
369
|
+
* validated by `validateBrandSnapshot`. Read by the companion
|
|
370
|
+
* `brand-render-prompt` behavior to assemble the logo generation prompt;
|
|
371
|
+
* the artifact-family id is `brand-brief`.
|
|
372
|
+
*
|
|
373
|
+
* **Optional** — the launch posture of every new family: not every example
|
|
374
|
+
* app authors a brand snapshot yet, and the family must not break existing
|
|
375
|
+
* companion exports on arrival.
|
|
376
|
+
*/
|
|
377
|
+
brandSpecification?: TBrandSnapshot;
|
|
378
|
+
/**
|
|
379
|
+
* Application **expert-persona charters** — the DERIVED worker-persona
|
|
380
|
+
* instances (`ExpertPersonaCharter[]`) of the framework's
|
|
381
|
+
* `EXPERT_ROLE_TEMPLATES` (art-director, copy-chief, …), committed under
|
|
382
|
+
* `specifications/src/personas/` by the companion's derive→accept flow
|
|
383
|
+
* (and hand-editable thereafter; a human edit is recorded in `authored`).
|
|
384
|
+
*
|
|
385
|
+
* Consumed by the companion's `expert-persona-charters` introspection
|
|
386
|
+
* behavior: the deliberation system builds each expert's agent from the
|
|
387
|
+
* committed charter at startup, and the accept step reads the set for its
|
|
388
|
+
* human-edit overwrite guard + `validateExpertPersonaCharters` run.
|
|
389
|
+
*
|
|
390
|
+
* PLURAL by design (unlike the singleton snapshot families above): an app
|
|
391
|
+
* has one charter per role, several roles. Distinct from the market
|
|
392
|
+
* family's `personas` (BUYER personas — who the app sells to); these are
|
|
393
|
+
* WORKER personas (who does the creative work).
|
|
394
|
+
*
|
|
395
|
+
* **Optional** — the launch posture of every new family: not every example
|
|
396
|
+
* app has derived charters yet, and the family must not break existing
|
|
397
|
+
* companion exports on arrival. Apps with charters should export the
|
|
398
|
+
* generated `appExpertPersonaCharters` aggregate from
|
|
399
|
+
* `specifications/src/personas/`.
|
|
400
|
+
*/
|
|
401
|
+
expertPersonaCharters?: TExpertPersonaCharters;
|
|
402
|
+
/**
|
|
403
|
+
* Accepted **feature drafts** produced by the top-down capability-map.
|
|
404
|
+
*
|
|
405
|
+
* Drafts carry product intent only: purpose, business role, lifecycle and
|
|
406
|
+
* availability guidance. They deliberately exclude runtime-definition
|
|
407
|
+
* provenance and executable scope. Phase-gate and domain-planning evidence
|
|
408
|
+
* consume this member; `featureSpecifications` remains the separate
|
|
409
|
+
* runtime-backed overlay surface used after capabilities are implemented.
|
|
410
|
+
*
|
|
411
|
+
* **Optional** at the aggregate contract boundary because applications that
|
|
412
|
+
* have not entered the app-creation workflow may not have accepted drafts.
|
|
413
|
+
* A treatment selecting the `feature-drafts` family fails closed when the
|
|
414
|
+
* member is absent.
|
|
415
|
+
*/
|
|
416
|
+
featureDraftsSpecification?: TFeatureSpecificationDrafts;
|
|
417
|
+
/**
|
|
418
|
+
* Accepted application **compliance program** policy.
|
|
419
|
+
*
|
|
420
|
+
* This is the configured application's reusable source/scope/objective,
|
|
421
|
+
* implementation-choice, responsibility, gap/exception and documentation
|
|
422
|
+
* truth. It deliberately excludes live organizations, assignees, reviewer
|
|
423
|
+
* identities, evidence bytes and operating-effectiveness claims.
|
|
424
|
+
*
|
|
425
|
+
* **Optional** at launch. If the application declares the
|
|
426
|
+
* `compliance-program` family, the semantic family authority requires this
|
|
427
|
+
* member and validates it fail closed. Applications without that family must
|
|
428
|
+
* not synthesize this value or receive positive compliance-program claims.
|
|
429
|
+
*/
|
|
430
|
+
complianceSpecification?: TComplianceSpecification;
|
|
431
|
+
/**
|
|
432
|
+
* Accepted application **public-document publication variants**.
|
|
433
|
+
*
|
|
434
|
+
* The exact locale × jurisdiction combinations in which this application
|
|
435
|
+
* publishes public governed documents. It is the ONLY source a governed
|
|
436
|
+
* document candidate may take its locale and jurisdictions from: the
|
|
437
|
+
* candidate host seals these bytes into a publication-variant authority
|
|
438
|
+
* bound to the `document-publication` family's retained head, and refuses
|
|
439
|
+
* any combination that is not an exact member.
|
|
440
|
+
*
|
|
441
|
+
* Distinct from `complianceSpecification` by design. The assurance program
|
|
442
|
+
* decides which documents are required and who approves them; this slot
|
|
443
|
+
* decides where and in which language they are published. Folding the two
|
|
444
|
+
* would let a document requirement widen its own publication routing.
|
|
445
|
+
*
|
|
446
|
+
* **Optional** at the aggregate contract boundary. An application that
|
|
447
|
+
* declares no `document-publication` family publishes no public governed
|
|
448
|
+
* document, and candidate creation fails closed rather than defaulting to a
|
|
449
|
+
* locale or jurisdiction nobody accepted.
|
|
450
|
+
*/
|
|
451
|
+
documentPublicationSpecification?: TDocumentPublicationSpecification;
|
|
452
|
+
/**
|
|
453
|
+
* Accepted application selection of the human release lane for each exact
|
|
454
|
+
* governed-document requirement. Optional at the aggregate boundary: an
|
|
455
|
+
* application with no policy can still generate a working draft, but every
|
|
456
|
+
* exposure attempt fails closed rather than assuming operator attestation or
|
|
457
|
+
* qualified review.
|
|
458
|
+
*/
|
|
459
|
+
documentReleasePolicySpecification?: TDocumentReleasePolicySpecification;
|
|
460
|
+
/**
|
|
461
|
+
* Accepted application **governed-document facts**.
|
|
462
|
+
*
|
|
463
|
+
* This optional slot carries raw application, creator-decision and
|
|
464
|
+
* qualified-review fact declarations from the dedicated `document-facts`
|
|
465
|
+
* specification family. The application-creation host validates the exact
|
|
466
|
+
* accepted family head and seals derived contribution digests and validation
|
|
467
|
+
* receipts; application code never authors those host identities.
|
|
468
|
+
*
|
|
469
|
+
* Reviewer authority grants, review decisions, candidates and immutable
|
|
470
|
+
* releases are runtime/private custody and are forbidden from this slot.
|
|
471
|
+
* Omitting it is honest: unresolved document facts remain visible gaps.
|
|
472
|
+
*/
|
|
473
|
+
documentFactSpecification?: TDocumentFactSpecification;
|
|
474
|
+
/**
|
|
475
|
+
* WHO else processes this application's personal data — legal identity, processing region and the
|
|
476
|
+
* processor's own subprocessors (issue #88).
|
|
477
|
+
*
|
|
478
|
+
* A configured provider already establishes THAT a third party is involved and what function it
|
|
479
|
+
* performs. None of that is what a privacy notice's recipient statement needs, and an
|
|
480
|
+
* international-transfer statement cannot be made at all without a region.
|
|
481
|
+
*
|
|
482
|
+
* Optional, and its holes are reported rather than blocking: the companion compares this register
|
|
483
|
+
* against the application's CONFIGURED providers and names each one that is undeclared, so a partial
|
|
484
|
+
* register is useful and an empty one still produces an actionable document. An absent entry means
|
|
485
|
+
* nobody has established that processor's identity — never that the provider is unused.
|
|
486
|
+
*/
|
|
487
|
+
processorRegister?: TProcessorRegister;
|
|
488
|
+
/**
|
|
489
|
+
* Accepted application-declared semantic causality between whole
|
|
490
|
+
* specification-family states. This is not the registry's physical
|
|
491
|
+
* dependency graph and not Actor/Flow execution order. The runtime resolves
|
|
492
|
+
* these declarations only through the exact CURRENT accepted projection,
|
|
493
|
+
* then may derive a rebuildable impact index; this export itself does not
|
|
494
|
+
* authorize a journal write, review queue or application mutation.
|
|
495
|
+
*
|
|
496
|
+
* Optional because semantic impact is an advanced application-creation
|
|
497
|
+
* capability. An application that declares the dedicated
|
|
498
|
+
* `semantic-dependencies` family must provide this field; a resolver refuses
|
|
499
|
+
* a missing or malformed value rather than infer dependencies from imports
|
|
500
|
+
* or registry edges.
|
|
501
|
+
*/
|
|
502
|
+
}
|
|
503
|
+
|
|
504
|
+
/**
|
|
505
|
+
* Aggregate of every catalog vocabulary an app can wire on the
|
|
506
|
+
* `catalogSpecifications` companion-exports slot.
|
|
507
|
+
*
|
|
508
|
+
* Each vocabulary is a flat array of validated entries (engine
|
|
509
|
+
* + app entries merged at wiring time). The companion harness keys
|
|
510
|
+
* each vocabulary by its discriminator (`@type` for Schema.org;
|
|
511
|
+
* future vocabularies can use `operationId`, `kind`, etc.); app
|
|
512
|
+
* entries silently override engine entries on collision and the
|
|
513
|
+
* harness emits a `catalog-override` warning for each override at
|
|
514
|
+
* boot.
|
|
515
|
+
*
|
|
516
|
+
* **Why an aggregate type and not per-slot fields**: every future
|
|
517
|
+
* vocabulary lands as a sibling field on this single type rather
|
|
518
|
+
* than as a new top-level companion-exports field. This keeps the
|
|
519
|
+
* `SpecificationsCompanionExports` shape stable as the catalog
|
|
520
|
+
* surface grows.
|
|
521
|
+
*/
|
|
522
|
+
export interface CatalogSpecifications {
|
|
523
|
+
/**
|
|
524
|
+
* Schema.org JSON-LD vocabulary catalog. Compose with
|
|
525
|
+
* `ENGINE_SCHEMA_ORG_CATALOG` (engine-shipped standard entries)
|
|
526
|
+
* spread, then append app-side extensions / overrides.
|
|
527
|
+
*/
|
|
528
|
+
schemaOrg?: readonly SchemaOrgCatalogEntryBase[];
|
|
529
|
+
}
|
|
530
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# saas.specifications.composite-view-specification
|
|
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
|
+
* Composite view semantic overlay: `codeHandling`, section/translation slots, and keyed `CompositeViewSpecification` map.
|
|
14
|
+
*/
|
|
15
|
+
export interface CompositeViewSpecificationCodeHandling {
|
|
16
|
+
/** Module/application owner that authored the view. */
|
|
17
|
+
definitionOwner?: SpecificationOwnerRef;
|
|
18
|
+
/** Public symbol exposing the authored composite view component. */
|
|
19
|
+
viewComponentSymbol?: PublicCodeSymbolRef;
|
|
20
|
+
/** Public declarations where the composite view is wired into runtime registries. */
|
|
21
|
+
declarationSymbols?: PublicCodeSymbolRef[];
|
|
22
|
+
/** Extra caveats for coding/transposition consumers. */
|
|
23
|
+
notes?: string[];
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export interface CompositeViewSpecificationConfig {
|
|
27
|
+
/** Stable runtime translation identity for this composite surface. */
|
|
28
|
+
translationRef: string;
|
|
29
|
+
/** Why this composite surface exists from a product/workflow perspective. */
|
|
30
|
+
purpose: string;
|
|
31
|
+
/** Interaction role this composite plays in the surrounding UX. */
|
|
32
|
+
uiRole: string;
|
|
33
|
+
/** Situations where this composite surface is the right destination. */
|
|
34
|
+
useWhen?: string;
|
|
35
|
+
/** Situations where another surface should be preferred. */
|
|
36
|
+
avoidWhen?: string;
|
|
37
|
+
/** Meaning of the composite-view-level translatable slots. */
|
|
38
|
+
textSlots?: TranslationSlotSpecificationMap;
|
|
39
|
+
/** Meaning of each declared section inside the composite. */
|
|
40
|
+
sections?: Record<string, StructuralTranslationSlotSpecification>;
|
|
41
|
+
/** Additional domain constraints that matter beyond raw runtime structure. */
|
|
42
|
+
businessConstraints?: string[];
|
|
43
|
+
/** Import-oriented coding/transposition metadata. */
|
|
44
|
+
codeHandling?: CompositeViewSpecificationCodeHandling;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Keyed by the stable runtime translation identity (for example `app.foo`). */
|
|
48
|
+
export type CompositeViewSpecification = Record<string, CompositeViewSpecificationConfig>;
|
|
49
|
+
```
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# saas.specifications.error-message-specification
|
|
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
|
+
* Semantic overlay for one `ErrorCustomMessageReference` — the missing
|
|
14
|
+
* "what should the user be told, and in whose register" layer beside the
|
|
15
|
+
* bare error-reference enum. Import from `@wildo-ai/saas-specifications`.
|
|
16
|
+
*
|
|
17
|
+
* # Why this family exists
|
|
18
|
+
*
|
|
19
|
+
* `ErrorCustomMessageReference` (`@wildo-ai/saas-models`) is a flat string
|
|
20
|
+
* enum. The label generator turns each member into an
|
|
21
|
+
* `errors_messages.<ref>.msg` label, but with NO semantic input it can
|
|
22
|
+
* only guess copy from the key string — producing generic text
|
|
23
|
+
* ("Token expired", "Join access denied"). Every other high-quality
|
|
24
|
+
* label family (resources, components, roles) feeds the generator an
|
|
25
|
+
* authored `purpose` + `audience`; this overlay is the errors-side
|
|
26
|
+
* source of that same input, so generated error copy reaches
|
|
27
|
+
* hand-authoring quality.
|
|
28
|
+
*
|
|
29
|
+
* # Field semantics (specialised from the shared base)
|
|
30
|
+
*
|
|
31
|
+
* - `purpose` — the **user-facing intent**: what the reader needs to
|
|
32
|
+
* understand and, where useful, what to do next. This is the string
|
|
33
|
+
* the label generator uses as the `msg` seed. Keep it a plain,
|
|
34
|
+
* user-directed statement (NOT the developer rationale that lives in
|
|
35
|
+
* the enum's JSDoc).
|
|
36
|
+
* - `businessRole` — the **system/functional role**: what condition the
|
|
37
|
+
* error guards or blocks. Carries real weight for an error (it is not
|
|
38
|
+
* filler): it gives the generator the situational background and lets
|
|
39
|
+
* downstream tooling explain the error to an operator.
|
|
40
|
+
* - `audience` — the register the message must be written in
|
|
41
|
+
* (`END_USER` for consumer-facing flows, `ADMIN` for back-office /
|
|
42
|
+
* operator surfaces, `DEVELOPER` for integration/API errors). Drives
|
|
43
|
+
* the label generator's voice AND signals which errors deserve
|
|
44
|
+
* quality investment. **Required** — it is the axis that most changes
|
|
45
|
+
* the produced copy.
|
|
46
|
+
*
|
|
47
|
+
* # Scope
|
|
48
|
+
*
|
|
49
|
+
* The family is **app-level only** (`app.<errorRef>` keys). Error
|
|
50
|
+
* references are engine-global — never resource-owned — so unlike the
|
|
51
|
+
* four bi-scoped definition families there is no resource-scoped variant.
|
|
52
|
+
*
|
|
53
|
+
* @example
|
|
54
|
+
* ```ts
|
|
55
|
+
* const spec: ErrorMessageSpecificationConfig = {
|
|
56
|
+
* ref: ErrorCustomMessageReference.INVITATION_NO_LONGER_VALID,
|
|
57
|
+
* audience: LabelAudience.END_USER,
|
|
58
|
+
* purpose:
|
|
59
|
+
* 'Tell the invitee the invitation link can no longer be used and to ask the inviting administrator for a new one.',
|
|
60
|
+
* businessRole:
|
|
61
|
+
* 'Terminal guard on the public invitation-accept flow when the token is unrecognised, expired, already consumed, or the membership is not in an acceptable state.',
|
|
62
|
+
* };
|
|
63
|
+
* ```
|
|
64
|
+
*/
|
|
65
|
+
export interface ErrorMessageSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
66
|
+
/** Register the user-facing message must be written in. Drives the generator's voice + quality investment. */
|
|
67
|
+
audience: LabelAudience;
|
|
68
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
69
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* App-level error-message specification map.
|
|
74
|
+
*
|
|
75
|
+
* Keys are `app.<errorRef>` (see
|
|
76
|
+
* {@link appLevelErrorMessageSpecificationKeyFor}); values are
|
|
77
|
+
* {@link ErrorMessageSpecificationConfig}. Built once at module load via
|
|
78
|
+
* {@link buildErrorMessageSpecificationMap}, which validates every entry
|
|
79
|
+
* and fails closed on duplicate keys.
|
|
80
|
+
*/
|
|
81
|
+
export type ErrorMessageSpecification = Record<string, ErrorMessageSpecificationConfig>;
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Author-supplied draft for one {@link ErrorMessageSpecificationConfig}.
|
|
85
|
+
*
|
|
86
|
+
* The `ref` is injected from the exhaustive classification record's key
|
|
87
|
+
* (the `ErrorCustomMessageReference` value) so the runtime enum member
|
|
88
|
+
* stays the single source of truth for the identifier — authors never
|
|
89
|
+
* repeat the ref inside the draft body.
|
|
90
|
+
*/
|
|
91
|
+
export type ErrorMessageSpecificationDraft = Omit<ErrorMessageSpecificationConfig, 'ref'>;
|
|
92
|
+
```
|