@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,108 @@
|
|
|
1
|
+
# Error-message specification — source
|
|
2
|
+
|
|
3
|
+
- The fourth definition-backed family: `ErrorMessageSpecificationConfig`. It
|
|
4
|
+
extends the same shared base as product / role / milestone / feature specs
|
|
5
|
+
(`ref` + `purpose` + `businessRole`) and adds a required `audience`
|
|
6
|
+
(`LabelAudience`). Import from `@wildo-ai/saas-specifications`.
|
|
7
|
+
- **Consumer:** the i18n label generator. A per-ref `purpose` + `audience`
|
|
8
|
+
turns `errors_messages.<ref>.msg` copy from a key-string guess into
|
|
9
|
+
register-appropriate user wording (END_USER / ADMIN / DEVELOPER).
|
|
10
|
+
- **Scope:** app-level only (`app.<ref>`); error references are engine-global,
|
|
11
|
+
never resource-owned — so, unlike the other four families, there is no
|
|
12
|
+
resource-scoped variant.
|
|
13
|
+
- **Authoring reality:** the engine ships an EXHAUSTIVE overlay over every
|
|
14
|
+
`ErrorCustomMessageReference` (authored draft OR `null` for internal refs),
|
|
15
|
+
so applications inherit quality error copy automatically. Read this contract
|
|
16
|
+
when overriding a reference's wording register/intent or when reviewing how
|
|
17
|
+
generated error copy is grounded.
|
|
18
|
+
|
|
19
|
+
## Import Origins
|
|
20
|
+
|
|
21
|
+
- `@wildo-ai/saas-specifications`
|
|
22
|
+
|
|
23
|
+
## Source Excerpts
|
|
24
|
+
|
|
25
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
*
|
|
29
|
+
* Semantic overlay for one `ErrorCustomMessageReference` — the missing
|
|
30
|
+
* "what should the user be told, and in whose register" layer beside the
|
|
31
|
+
* bare error-reference enum. Import from `@wildo-ai/saas-specifications`.
|
|
32
|
+
*
|
|
33
|
+
* # Why this family exists
|
|
34
|
+
*
|
|
35
|
+
* `ErrorCustomMessageReference` (`@wildo-ai/saas-models`) is a flat string
|
|
36
|
+
* enum. The label generator turns each member into an
|
|
37
|
+
* `errors_messages.<ref>.msg` label, but with NO semantic input it can
|
|
38
|
+
* only guess copy from the key string — producing generic text
|
|
39
|
+
* ("Token expired", "Join access denied"). Every other high-quality
|
|
40
|
+
* label family (resources, components, roles) feeds the generator an
|
|
41
|
+
* authored `purpose` + `audience`; this overlay is the errors-side
|
|
42
|
+
* source of that same input, so generated error copy reaches
|
|
43
|
+
* hand-authoring quality.
|
|
44
|
+
*
|
|
45
|
+
* # Field semantics (specialised from the shared base)
|
|
46
|
+
*
|
|
47
|
+
* - `purpose` — the **user-facing intent**: what the reader needs to
|
|
48
|
+
* understand and, where useful, what to do next. This is the string
|
|
49
|
+
* the label generator uses as the `msg` seed. Keep it a plain,
|
|
50
|
+
* user-directed statement (NOT the developer rationale that lives in
|
|
51
|
+
* the enum's JSDoc).
|
|
52
|
+
* - `businessRole` — the **system/functional role**: what condition the
|
|
53
|
+
* error guards or blocks. Carries real weight for an error (it is not
|
|
54
|
+
* filler): it gives the generator the situational background and lets
|
|
55
|
+
* downstream tooling explain the error to an operator.
|
|
56
|
+
* - `audience` — the register the message must be written in
|
|
57
|
+
* (`END_USER` for consumer-facing flows, `ADMIN` for back-office /
|
|
58
|
+
* operator surfaces, `DEVELOPER` for integration/API errors). Drives
|
|
59
|
+
* the label generator's voice AND signals which errors deserve
|
|
60
|
+
* quality investment. **Required** — it is the axis that most changes
|
|
61
|
+
* the produced copy.
|
|
62
|
+
*
|
|
63
|
+
* # Scope
|
|
64
|
+
*
|
|
65
|
+
* The family is **app-level only** (`app.<errorRef>` keys). Error
|
|
66
|
+
* references are engine-global — never resource-owned — so unlike the
|
|
67
|
+
* four bi-scoped definition families there is no resource-scoped variant.
|
|
68
|
+
*
|
|
69
|
+
* @example
|
|
70
|
+
* ```ts
|
|
71
|
+
* const spec: ErrorMessageSpecificationConfig = {
|
|
72
|
+
* ref: ErrorCustomMessageReference.INVITATION_NO_LONGER_VALID,
|
|
73
|
+
* audience: LabelAudience.END_USER,
|
|
74
|
+
* purpose:
|
|
75
|
+
* 'Tell the invitee the invitation link can no longer be used and to ask the inviting administrator for a new one.',
|
|
76
|
+
* businessRole:
|
|
77
|
+
* '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.',
|
|
78
|
+
* };
|
|
79
|
+
* ```
|
|
80
|
+
*/
|
|
81
|
+
export interface ErrorMessageSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
82
|
+
/** Register the user-facing message must be written in. Drives the generator's voice + quality investment. */
|
|
83
|
+
audience: LabelAudience;
|
|
84
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
85
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* App-level error-message specification map.
|
|
90
|
+
*
|
|
91
|
+
* Keys are `app.<errorRef>` (see
|
|
92
|
+
* {@link appLevelErrorMessageSpecificationKeyFor}); values are
|
|
93
|
+
* {@link ErrorMessageSpecificationConfig}. Built once at module load via
|
|
94
|
+
* {@link buildErrorMessageSpecificationMap}, which validates every entry
|
|
95
|
+
* and fails closed on duplicate keys.
|
|
96
|
+
*/
|
|
97
|
+
export type ErrorMessageSpecification = Record<string, ErrorMessageSpecificationConfig>;
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* Author-supplied draft for one {@link ErrorMessageSpecificationConfig}.
|
|
101
|
+
*
|
|
102
|
+
* The `ref` is injected from the exhaustive classification record's key
|
|
103
|
+
* (the `ErrorCustomMessageReference` value) so the runtime enum member
|
|
104
|
+
* stays the single source of truth for the identifier — authors never
|
|
105
|
+
* repeat the ref inside the draft body.
|
|
106
|
+
*/
|
|
107
|
+
export type ErrorMessageSpecificationDraft = Omit<ErrorMessageSpecificationConfig, 'ref'>;
|
|
108
|
+
```
|
package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md
ADDED
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
# Family specifications (product / milestone / role) — source
|
|
2
|
+
|
|
3
|
+
- Keyed record types and shared prose/config fields for `*.product`, `*.milestone`, `*.role` specification files.
|
|
4
|
+
|
|
5
|
+
## Import Origins
|
|
6
|
+
|
|
7
|
+
- `@wildo-ai/saas-specifications`
|
|
8
|
+
|
|
9
|
+
## Source Excerpts
|
|
10
|
+
|
|
11
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
*
|
|
15
|
+
* Product, milestone, and role specification record types sharing the definition-spec base prose layer.
|
|
16
|
+
*
|
|
17
|
+
* All three families adopt the same bi-scoped key namespace as
|
|
18
|
+
* `FeatureSpecification` (Q5-5): keys are `app.<ref>` or
|
|
19
|
+
* `resources.<resourceType>.<ref>`. Use the typed key helpers
|
|
20
|
+
* (`appLevelMilestoneSpecificationKeyFor`,
|
|
21
|
+
* `resourceLevelMilestoneSpecificationKeyFor`, etc.) rather than
|
|
22
|
+
* building keys manually.
|
|
23
|
+
*/
|
|
24
|
+
export interface MilestoneSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
25
|
+
/** Role this milestone plays inside progression and motivation flows. */
|
|
26
|
+
progressionRole?: string;
|
|
27
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
28
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Resource-scoped variant of {@link MilestoneSpecificationConfig}.
|
|
33
|
+
* See {@link ResourceFeatureSpecificationConfig} JSDoc for the
|
|
34
|
+
* discriminator rationale (identical across all 4 families).
|
|
35
|
+
*/
|
|
36
|
+
export interface ResourceMilestoneSpecificationConfig extends MilestoneSpecificationConfig {
|
|
37
|
+
/** Runtime resource-type identifier the milestone is semantically owned by. */
|
|
38
|
+
resourceType: string;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Bi-scoped milestone specification map.
|
|
43
|
+
*
|
|
44
|
+
* Keys: `app.<milestoneRef>` | `resources.<resourceType>.<milestoneRef>`.
|
|
45
|
+
* See {@link FeatureSpecificationConfig} JSDoc for the full bi-scoped
|
|
46
|
+
* key-shape rationale (the contract is identical across the four
|
|
47
|
+
* definition-backed families).
|
|
48
|
+
*/
|
|
49
|
+
export type MilestoneSpecification = Record<
|
|
50
|
+
string,
|
|
51
|
+
MilestoneSpecificationConfig | ResourceMilestoneSpecificationConfig
|
|
52
|
+
>;
|
|
53
|
+
|
|
54
|
+
export interface ProductSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
55
|
+
/** Commercial or packaging role played by the product/catalog entry. */
|
|
56
|
+
commercialRole?: string;
|
|
57
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
58
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Resource-scoped variant of {@link ProductSpecificationConfig}.
|
|
63
|
+
* See {@link ResourceFeatureSpecificationConfig} JSDoc for the
|
|
64
|
+
* discriminator rationale.
|
|
65
|
+
*/
|
|
66
|
+
export interface ResourceProductSpecificationConfig extends ProductSpecificationConfig {
|
|
67
|
+
/** Runtime resource-type identifier the product is semantically owned by. */
|
|
68
|
+
resourceType: string;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Bi-scoped product specification map.
|
|
73
|
+
*
|
|
74
|
+
* Keys: `app.<productRef>` | `resources.<resourceType>.<productRef>`.
|
|
75
|
+
* See {@link FeatureSpecificationConfig} JSDoc for the bi-scoped
|
|
76
|
+
* key-shape rationale.
|
|
77
|
+
*/
|
|
78
|
+
export type ProductSpecification = Record<
|
|
79
|
+
string,
|
|
80
|
+
ProductSpecificationConfig | ResourceProductSpecificationConfig
|
|
81
|
+
>;
|
|
82
|
+
|
|
83
|
+
export interface RoleSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
84
|
+
/** Boundary of authority or responsibility carried by the role. */
|
|
85
|
+
authorityBoundary?: string;
|
|
86
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
87
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Resource-scoped variant of {@link RoleSpecificationConfig}.
|
|
92
|
+
* See {@link ResourceFeatureSpecificationConfig} JSDoc for the
|
|
93
|
+
* discriminator rationale.
|
|
94
|
+
*/
|
|
95
|
+
export interface ResourceRoleSpecificationConfig extends RoleSpecificationConfig {
|
|
96
|
+
/** Runtime resource-type identifier the role is semantically owned by. */
|
|
97
|
+
resourceType: string;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Bi-scoped role specification map.
|
|
102
|
+
*
|
|
103
|
+
* Keys: `app.<roleRef>` | `resources.<resourceType>.<roleRef>`.
|
|
104
|
+
* See {@link FeatureSpecificationConfig} JSDoc for the bi-scoped
|
|
105
|
+
* key-shape rationale.
|
|
106
|
+
*/
|
|
107
|
+
export type RoleSpecification = Record<
|
|
108
|
+
string,
|
|
109
|
+
RoleSpecificationConfig | ResourceRoleSpecificationConfig
|
|
110
|
+
>;
|
|
111
|
+
```
|
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-feature-update
|
|
3
|
+
description: Author or update `*.feature.specification.ts` for product capabilities, related resources, code-handling links, and availability narratives. Use when the user says "spec out this feature flag", "the AI assistant feature needs an addon posture", "wire the feature spec to its enum member", "register a new feature spec", "update the unavailability policy on this feature", or after adding/renaming a feature definition.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec Feature Update
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for **feature specifications** — the
|
|
23
|
+
`FeatureSpecificationConfig` records that author the spec layer for
|
|
24
|
+
each feature flag / capability the product ships. Feature specs serve
|
|
25
|
+
three consumers:
|
|
26
|
+
|
|
27
|
+
1. The **AI / companion / docs pipeline** — `purpose`,
|
|
28
|
+
`businessRole`, `availabilityRole`, `useWhen`, `avoidWhen`, and
|
|
29
|
+
`businessConstraints` ground tools in *what the feature is and
|
|
30
|
+
when it should apply*.
|
|
31
|
+
2. The **definition lookup** — `codeHandling.definitionOwner`,
|
|
32
|
+
`definitionSymbol`, `definitionCollectionEntry`, and
|
|
33
|
+
`identifierDeclaration` let companion follow the spec back to the
|
|
34
|
+
runtime enum member + collection entry that defines the feature.
|
|
35
|
+
3. The **monetization / availability layer** — `availabilityRole`
|
|
36
|
+
and the linked `CUSTOM_UNAVAILABILITY_POLICY` shape determine
|
|
37
|
+
whether the feature surfaces as an upsell boundary, a hidden
|
|
38
|
+
internal toggle, or an always-on capability.
|
|
39
|
+
|
|
40
|
+
Feature specs describe **what the product delivers**, not how a
|
|
41
|
+
single resource stores rows. A feature usually maps 1:1 to an enum
|
|
42
|
+
member of `ApplicationFeature` and an entry in `CUSTOM_FEATURE_DEFINITIONS`.
|
|
43
|
+
|
|
44
|
+
## App Paths
|
|
45
|
+
|
|
46
|
+
| Surface | Glob (relative to repo root) |
|
|
47
|
+
|--------------------------------------|-----------------------------------------------------------------------------------------------------------|
|
|
48
|
+
| App / module feature spec | `specifications/src/engine/features/<feature>.feature.specification.ts` or `specifications/src/modules/<slug>/features/<feature>.feature.specification.ts` |
|
|
49
|
+
| Feature spec barrel | `specifications/src/engine/features/index.ts` (`featureSpecifications` map) |
|
|
50
|
+
| Companion exports | `specifications/src/companion-exports.ts` (`featureSpecifications` slot) |
|
|
51
|
+
| Feature enum (parity) | `shared-lib/src/features/application-feature.ts` (`ApplicationFeature` enum) |
|
|
52
|
+
| Feature definitions collection | `shared-lib/src/features/custom-feature-definitions.ts` (`CUSTOM_FEATURE_DEFINITIONS`) |
|
|
53
|
+
| Unavailability policy | `shared-lib/src/features/custom-unavailability-policy.ts` (`CUSTOM_UNAVAILABILITY_POLICY`) |
|
|
54
|
+
| Feature profiles | `shared-lib/src/features/feature-profiles.ts` (`FEATURE_PROFILES`) |
|
|
55
|
+
|
|
56
|
+
## When to Use
|
|
57
|
+
|
|
58
|
+
- Launching a new feature flag — author the spec alongside the enum
|
|
59
|
+
member + collection entry
|
|
60
|
+
- Retiring or renaming a feature — update the spec's
|
|
61
|
+
`identifierDeclaration` + collection entry + supporting symbols
|
|
62
|
+
- Connecting a feature to its monetization narrative
|
|
63
|
+
(`availabilityRole`, addon framing) for AI / upsell surfaces
|
|
64
|
+
- Updating `useWhen` / `avoidWhen` / `businessConstraints` when the
|
|
65
|
+
product team revises feature scope
|
|
66
|
+
|
|
67
|
+
## When NOT to Use
|
|
68
|
+
|
|
69
|
+
- Single resource CRUD semantics → `spec-resource-update`
|
|
70
|
+
- Composite view section semantics → `spec-composite-view-update`
|
|
71
|
+
- Component slot semantics → `spec-component-update`
|
|
72
|
+
- Product / role / milestone family semantics → `spec-family-update`
|
|
73
|
+
- Wiring the spec into companion exports → `module-companion-exports`
|
|
74
|
+
|
|
75
|
+
## Workflow
|
|
76
|
+
|
|
77
|
+
### Step 1: Create / locate the enum member + collection entry
|
|
78
|
+
|
|
79
|
+
A feature spec is meaningless without its runtime backbone:
|
|
80
|
+
|
|
81
|
+
1. Add the member to `ApplicationFeature` (e.g. `AI_ASSISTANT`)
|
|
82
|
+
2. Add the matching entry to `CUSTOM_FEATURE_DEFINITIONS` keyed by
|
|
83
|
+
`identifier: ApplicationFeature.<MEMBER>`
|
|
84
|
+
3. Add or update the entry in `CUSTOM_UNAVAILABILITY_POLICY` if the
|
|
85
|
+
feature ships with addon / paid posture
|
|
86
|
+
4. Add or update `FEATURE_PROFILES` if the feature contributes to a
|
|
87
|
+
profile bundle
|
|
88
|
+
|
|
89
|
+
The spec follows; without these, the spec's `codeHandling` cannot
|
|
90
|
+
resolve.
|
|
91
|
+
|
|
92
|
+
### Step 2: Mirror a sibling feature spec
|
|
93
|
+
|
|
94
|
+
Find the closest sibling under `specifications/src/engine/features/`
|
|
95
|
+
or `specifications/src/modules/<slug>/features/` and copy the
|
|
96
|
+
`FeatureSpecificationConfig` shape.
|
|
97
|
+
|
|
98
|
+
### Step 3: Author the prose blocks
|
|
99
|
+
|
|
100
|
+
- `purpose` — what the feature is *for* (one or two sentences)
|
|
101
|
+
- `businessRole` — what business outcome the feature drives
|
|
102
|
+
- `availabilityRole` — addon / paid / always-on / internal posture
|
|
103
|
+
- `useWhen` — clear inclusion criteria
|
|
104
|
+
- `avoidWhen` — explicit exclusion criteria (prevents flag misuse)
|
|
105
|
+
- `businessConstraints` — guardrails the AI / docs / upsell layer
|
|
106
|
+
must preserve
|
|
107
|
+
|
|
108
|
+
### Step 4: Wire `codeHandling`
|
|
109
|
+
|
|
110
|
+
- `definitionOwner: { ownerId, ownerKind: SpecificationOwnerKind.* }`
|
|
111
|
+
- `definitionSymbol: { packageName, exportName, symbolKind }` — the
|
|
112
|
+
collection symbol (e.g. `CUSTOM_FEATURE_DEFINITIONS`)
|
|
113
|
+
- `definitionCollectionEntry: { collectionSymbol, identifierField:
|
|
114
|
+
'identifier', identifierValue: ApplicationFeature.<MEMBER> }` —
|
|
115
|
+
the lookup contract (resolve the entry by identifier, not by
|
|
116
|
+
position)
|
|
117
|
+
- `identifierDeclaration: { declaration: { packageName, exportName:
|
|
118
|
+
'ApplicationFeature', symbolKind, declarationKind }, memberName }`
|
|
119
|
+
— typed enum member reference
|
|
120
|
+
- `supportingSymbols: [...]` — `FEATURE_PROFILES`,
|
|
121
|
+
`CUSTOM_UNAVAILABILITY_POLICY`, etc., so companion can follow
|
|
122
|
+
the related runtime symbols
|
|
123
|
+
- `notes: [...]` — non-obvious wiring (e.g. "definition lives inside
|
|
124
|
+
a public collection; locate by identifier")
|
|
125
|
+
|
|
126
|
+
### Step 5: Register
|
|
127
|
+
|
|
128
|
+
1. Add the spec to the `featureSpecifications` map keyed by the
|
|
129
|
+
enum member
|
|
130
|
+
2. Re-export from the spec barrel
|
|
131
|
+
3. Verify it lands in `specificationsCompanionExports.featureSpecifications`
|
|
132
|
+
|
|
133
|
+
## Worked Example
|
|
134
|
+
|
|
135
|
+
An application `aiAssistantFeatureSpecification` is a canonical
|
|
136
|
+
addon-posture feature-spec shape — a paid AI capability gated through
|
|
137
|
+
`ApplicationFeature.AI_ASSISTANT`, with a `CUSTOM_UNAVAILABILITY_POLICY`
|
|
138
|
+
upsell narrative attached:
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
## Usage Example
|
|
142
|
+
|
|
143
|
+
```typescript
|
|
144
|
+
export const aiAssistantFeatureSpecification: FeatureSpecificationConfig = {
|
|
145
|
+
ref: ApplicationFeature.AI_ASSISTANT,
|
|
146
|
+
purpose: 'Gate AI-powered assistance that helps users turn task-management intent into faster action.',
|
|
147
|
+
businessRole: 'Premium capability flag controlling access to AI suggestion and automation experiences.',
|
|
148
|
+
availabilityRole: 'Addon-style paid capability that can be surfaced as an upsell boundary when the tenant has not enabled it.',
|
|
149
|
+
useWhen: 'Use this feature when the experience needs generative help, AI-assisted drafting, or automation that goes beyond standard task CRUD.',
|
|
150
|
+
avoidWhen: 'Avoid tying non-AI baseline task management to this flag; core todo creation and execution should remain available without the addon.',
|
|
151
|
+
businessConstraints: [
|
|
152
|
+
'This flag should stay focused on AI-augmented experiences, not become a catch-all switch for unrelated premium UX polish.',
|
|
153
|
+
'Because the authored unavailability policy suggests an addon product, prompts and generators should preserve the monetization posture instead of treating the feature as a hidden internal toggle.',
|
|
154
|
+
],
|
|
155
|
+
codeHandling: {
|
|
156
|
+
definitionOwner: {
|
|
157
|
+
ownerId: 'engine',
|
|
158
|
+
ownerKind: SpecificationOwnerKind.APPLICATION_ENGINE,
|
|
159
|
+
},
|
|
160
|
+
definitionSymbol: {
|
|
161
|
+
packageName: '@your-app/shared-lib',
|
|
162
|
+
exportName: 'CUSTOM_FEATURE_DEFINITIONS',
|
|
163
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
164
|
+
},
|
|
165
|
+
definitionCollectionEntry: {
|
|
166
|
+
collectionSymbol: {
|
|
167
|
+
packageName: '@your-app/shared-lib',
|
|
168
|
+
exportName: 'CUSTOM_FEATURE_DEFINITIONS',
|
|
169
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
170
|
+
},
|
|
171
|
+
identifierField: 'identifier',
|
|
172
|
+
identifierValue: ApplicationFeature.AI_ASSISTANT,
|
|
173
|
+
},
|
|
174
|
+
identifierDeclaration: {
|
|
175
|
+
declaration: {
|
|
176
|
+
packageName: '@your-app/shared-lib',
|
|
177
|
+
exportName: 'ApplicationFeature',
|
|
178
|
+
symbolKind: CodeSymbolKind.ENUM,
|
|
179
|
+
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
180
|
+
},
|
|
181
|
+
memberName: 'AI_ASSISTANT',
|
|
182
|
+
},
|
|
183
|
+
supportingSymbols: [
|
|
184
|
+
{
|
|
185
|
+
packageName: '@your-app/shared-lib',
|
|
186
|
+
exportName: 'FEATURE_PROFILES',
|
|
187
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
packageName: '@your-app/shared-lib',
|
|
191
|
+
exportName: 'CUSTOM_UNAVAILABILITY_POLICY',
|
|
192
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
193
|
+
},
|
|
194
|
+
],
|
|
195
|
+
notes: [
|
|
196
|
+
'The runtime definition lives inside the public `CUSTOM_FEATURE_DEFINITIONS` collection; downstream tools should locate the matching entry by `identifier` rather than assume a dedicated per-feature export exists.',
|
|
197
|
+
'This feature is intentionally linked to paid availability posture, so generated UX or docs should preserve the addon/upgrades framing instead of describing it as always-on engine capability.',
|
|
198
|
+
],
|
|
199
|
+
},
|
|
200
|
+
};
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
What earns its place:
|
|
204
|
+
|
|
205
|
+
- `purpose` + `businessRole` + `availabilityRole` together carry the
|
|
206
|
+
**monetization posture** ("Premium capability flag", "Addon-style
|
|
207
|
+
paid capability that can be surfaced as an upsell boundary"). AI
|
|
208
|
+
surfaces read this to preserve framing instead of treating the
|
|
209
|
+
feature as always-on engine capability.
|
|
210
|
+
- `useWhen` + `avoidWhen` are **explicit inclusion / exclusion
|
|
211
|
+
criteria**, not vague guidance. `avoidWhen: 'Avoid tying non-AI
|
|
212
|
+
baseline task management to this flag…'` prevents the feature from
|
|
213
|
+
becoming a catch-all switch.
|
|
214
|
+
- `businessConstraints` carries the **invariant** the AI / docs
|
|
215
|
+
layer must preserve ("preserve the monetization posture instead of
|
|
216
|
+
treating the feature as a hidden internal toggle").
|
|
217
|
+
- `codeHandling.definitionOwner: { ownerId: 'engine', ownerKind:
|
|
218
|
+
SpecificationOwnerKind.APPLICATION_ENGINE }` — typed enum, not a
|
|
219
|
+
string. Tells companion which owner ships the runtime collection.
|
|
220
|
+
- `codeHandling.definitionCollectionEntry` — the lookup contract.
|
|
221
|
+
Because the runtime definition lives inside the public
|
|
222
|
+
`CUSTOM_FEATURE_DEFINITIONS` collection (rather than as a
|
|
223
|
+
per-feature standalone export), the spec declares **how to locate
|
|
224
|
+
the entry** (`identifierField: 'identifier', identifierValue:
|
|
225
|
+
ApplicationFeature.AI_ASSISTANT`). Companion uses this to follow
|
|
226
|
+
the chain back to the right entry without assuming a per-feature
|
|
227
|
+
symbol exists.
|
|
228
|
+
- `codeHandling.identifierDeclaration` carries the **typed enum
|
|
229
|
+
member reference** (`packageName`, `exportName: 'ApplicationFeature'`,
|
|
230
|
+
`symbolKind: ENUM`, `declarationKind: TYPESCRIPT_ENUM`,
|
|
231
|
+
`memberName: 'AI_ASSISTANT'`). String-only references break
|
|
232
|
+
companion's symbol-following.
|
|
233
|
+
- `supportingSymbols: [FEATURE_PROFILES, CUSTOM_UNAVAILABILITY_POLICY]`
|
|
234
|
+
— declares the **wider runtime context** so companion knows where
|
|
235
|
+
the profile bundles + addon policy live for this feature.
|
|
236
|
+
- `notes:[...]` carries the **non-obvious wiring contracts** —
|
|
237
|
+
collection-by-identifier lookup, monetization posture preservation.
|
|
238
|
+
|
|
239
|
+
What is **not** in this block (and shouldn't be):
|
|
240
|
+
|
|
241
|
+
- No raw label strings (the labelling pipeline generates copy from
|
|
242
|
+
the prose blocks)
|
|
243
|
+
- No JSX or runtime logic — the spec is data-only
|
|
244
|
+
- No string-literal enum references — every typed declaration goes
|
|
245
|
+
through the `{ packageName, exportName, symbolKind, … }` contract
|
|
246
|
+
|
|
247
|
+
## References
|
|
248
|
+
|
|
249
|
+
- `references/feature-spec-scope.md` — what belongs in a feature spec
|
|
250
|
+
- `references/framework-feature-specification-api.md` — `FeatureSpecificationConfig` engine shape
|
|
251
|
+
|
|
252
|
+
## Verification
|
|
253
|
+
|
|
254
|
+
- [ ] `ApplicationFeature.<MEMBER>` exists for the feature
|
|
255
|
+
- [ ] Matching `CUSTOM_FEATURE_DEFINITIONS` entry keyed by `identifier`
|
|
256
|
+
- [ ] Spec is a `FeatureSpecificationConfig` (typed contract, not a loose object)
|
|
257
|
+
- [ ] `codeHandling.definitionOwner.ownerKind` uses `SpecificationOwnerKind.*`
|
|
258
|
+
- [ ] `codeHandling.definitionCollectionEntry.identifierField` is `'identifier'` and `identifierValue` is `ApplicationFeature.<MEMBER>`
|
|
259
|
+
- [ ] `codeHandling.identifierDeclaration.declaration.exportName` is `'ApplicationFeature'` (typed enum reference)
|
|
260
|
+
- [ ] `supportingSymbols` lists `FEATURE_PROFILES` / `CUSTOM_UNAVAILABILITY_POLICY` when applicable
|
|
261
|
+
- [ ] Spec registered in `featureSpecifications` map and exported through the spec barrel
|
|
262
|
+
- [ ] Spec lands in `specificationsCompanionExports.featureSpecifications`
|
|
263
|
+
|
|
264
|
+
### Grep invariants
|
|
265
|
+
|
|
266
|
+
Run from the repo root, substituting `<feature>` (kebab) and
|
|
267
|
+
`<MEMBER>` (enum):
|
|
268
|
+
|
|
269
|
+
| Invariant | Command |
|
|
270
|
+
|---------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
271
|
+
| Spec uses `FeatureSpecificationConfig` typed contract | `rg -n ":\s+FeatureSpecificationConfig" specifications/src/**/<feature>.feature.specification.ts` |
|
|
272
|
+
| Definition collection entry uses the typed enum member | `rg -n "identifierValue:\s+ApplicationFeature\.<MEMBER>" specifications/src/**/<feature>.feature.specification.ts` |
|
|
273
|
+
| **No string-literal identifier value** (must be empty) | `rg -n "identifierValue:\s+'" specifications/src/**/<feature>.feature.specification.ts` |
|
|
274
|
+
| Identifier declaration points at `ApplicationFeature` enum | `rg -n "exportName:\s+'ApplicationFeature'" specifications/src/**/<feature>.feature.specification.ts` |
|
|
275
|
+
| Spec registered in `featureSpecifications` map | `rg -n "<MEMBER>\]:\s+\w+FeatureSpecification" specifications/src/engine/features/index.ts` |
|
|
276
|
+
| Enum member exists in `ApplicationFeature` | `rg -n "<MEMBER>" shared-lib/src/features/application-feature.ts` |
|
|
277
|
+
| Collection entry exists in `CUSTOM_FEATURE_DEFINITIONS` | `rg -n "ApplicationFeature\.<MEMBER>" shared-lib/src/features/custom-feature-definitions.ts` |
|
|
278
|
+
|
|
279
|
+
The high-signal invariant is **"identifier value uses the typed enum
|
|
280
|
+
member"** — string-literal identifiers silently drift and companion
|
|
281
|
+
loses the spec → runtime enum chain.
|
|
282
|
+
|
|
283
|
+
## Common Rationalizations
|
|
284
|
+
|
|
285
|
+
| Rationalization | Reality |
|
|
286
|
+
|-----------------|---------|
|
|
287
|
+
| "Marketing copy can drift" | Specs feed in-app guidance, AI assistants, and upsell surfaces; drift confuses users *and* breaks AI authoring fidelity. |
|
|
288
|
+
| "I'll add the spec later, after the enum lands" | Without the spec, the feature is invisible to companion / AI; addon posture and upsell framing won't propagate. |
|
|
289
|
+
| "I can use a string-literal identifier" | The spec → runtime enum chain is what lets companion follow the spec back to its definition. String literals break the chain. |
|
|
290
|
+
| "Single owner — `definitionOwner` doesn't matter" | `ownerKind` (engine vs domain module vs app) drives which companion path resolves the symbol. Misclassification dead-ends lookup. |
|
|
291
|
+
| "Skip `availabilityRole` — most features are always-on" | A missing `availabilityRole` defaults AI / docs to "always-on" framing; an addon feature framed as always-on becomes free in messaging. |
|
|
292
|
+
|
|
293
|
+
## Red Flags
|
|
294
|
+
|
|
295
|
+
- Feature spec references resources that no longer exist
|
|
296
|
+
- Spec exists but `ApplicationFeature.<MEMBER>` does not (broken chain)
|
|
297
|
+
- Spec exists but no matching `CUSTOM_FEATURE_DEFINITIONS` entry (companion can't resolve definition)
|
|
298
|
+
- `identifierValue:` is a string literal instead of `ApplicationFeature.<MEMBER>`
|
|
299
|
+
- Two specs share the same `identifierValue` (last-registration-wins silently drops one)
|
|
300
|
+
|
|
301
|
+
## Related Skills
|
|
302
|
+
|
|
303
|
+
- `spec-family-update` — product / role / milestone family specs (sibling pattern)
|
|
304
|
+
- `spec-update-after-change` — orchestrating multi-file spec updates after a change
|
|
305
|
+
- `module-companion-exports` — wiring the spec into `companion-exports.ts`
|
|
306
|
+
- `infra-environment-config` — when feature posture is driven by environment-level config
|
package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Feature specification (source)
|
|
2
|
+
|
|
3
|
+
- `FeatureSpecificationConfig` and keyed `FeatureSpecification` map used in `*.feature.specification.ts`.
|
|
4
|
+
|
|
5
|
+
## Import Origins
|
|
6
|
+
|
|
7
|
+
- `@wildo-ai/saas-specifications`
|
|
8
|
+
|
|
9
|
+
## Source Excerpts
|
|
10
|
+
|
|
11
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
*
|
|
15
|
+
* Feature semantic overlay: keyed `FeatureSpecification` maps used in `*.feature.specification.ts`.
|
|
16
|
+
*
|
|
17
|
+
* # Authoring shape
|
|
18
|
+
*
|
|
19
|
+
* `FeatureSpecificationConfig` extends `DefinitionSpecificationBaseConfig`
|
|
20
|
+
* (so every entry carries `ref` + `purpose` + `businessRole`) and adds
|
|
21
|
+
* `availabilityRole` (how the feature participates in gating /
|
|
22
|
+
* availability / packaging) and the standard `codeHandling` import
|
|
23
|
+
* provenance.
|
|
24
|
+
*
|
|
25
|
+
* # Map key shape (bi-scoped, Q5-5)
|
|
26
|
+
*
|
|
27
|
+
* `FeatureSpecification` is a **bi-scoped** record: keys are either
|
|
28
|
+
* `app.<featureRef>` (engine-shipped / cross-resource features) or
|
|
29
|
+
* `resources.<resourceType>.<featureRef>` (features semantically owned
|
|
30
|
+
* by one resource). Use the typed key helpers
|
|
31
|
+
* `appLevelFeatureSpecificationKeyFor(...)` /
|
|
32
|
+
* `resourceLevelFeatureSpecificationKeyFor(...)` rather than building
|
|
33
|
+
* keys manually — string-concatenated keys bypass the prefix
|
|
34
|
+
* vocabulary and fail-soft against the cross-registry validators
|
|
35
|
+
* landing in Phase 8.
|
|
36
|
+
*
|
|
37
|
+
* The `Record<string, ...>` value type intentionally does NOT encode
|
|
38
|
+
* the bi-scoped prefix as a TypeScript template literal type.
|
|
39
|
+
* Template-literal keys make `Object.entries(map)` lose the prefix
|
|
40
|
+
* narrowing on every read, force every consumer to re-parse the key
|
|
41
|
+
* with a runtime guard, and make `merge` operations across maps
|
|
42
|
+
* unnecessarily painful. The validators in `build*SpecificationMap`
|
|
43
|
+
* (Phase 2) enforce the prefix at map-build time, which is the same
|
|
44
|
+
* contract a template-literal key would give but without the value-
|
|
45
|
+
* type ergonomic cost.
|
|
46
|
+
*/
|
|
47
|
+
export interface FeatureSpecificationConfig extends DefinitionSpecificationBaseConfig {
|
|
48
|
+
/** How this feature participates in gating, availability, or packaging. */
|
|
49
|
+
availabilityRole?: string;
|
|
50
|
+
/** Public-import-oriented metadata for coding/transposition consumers. */
|
|
51
|
+
codeHandling?: DefinitionSpecificationCodeHandling;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Resource-scoped variant of {@link FeatureSpecificationConfig}.
|
|
56
|
+
*
|
|
57
|
+
* Carries `resourceType` so the bi-scoped map builder
|
|
58
|
+
* (`buildFeatureSpecificationMap`, Phase 2) can dispatch to
|
|
59
|
+
* `resourceLevelFeatureSpecificationKeyFor(resourceType, ref)` without
|
|
60
|
+
* an extra wrapper argument. Mirrors Step 4's
|
|
61
|
+
* `ResourceOnboardingViewSpecificationConfig` discriminator pattern —
|
|
62
|
+
* scope lives on the config so the union-typed map value carries
|
|
63
|
+
* enough information to round-trip through `Object.entries(map)`
|
|
64
|
+
* without re-parsing the bi-scoped key.
|
|
65
|
+
*
|
|
66
|
+
* `resourceType` is the runtime resource-type identifier
|
|
67
|
+
* (e.g. `'todos'`, `'organizations'`) — same vocabulary as the
|
|
68
|
+
* resource-spec layer's `CoreResourceType` plus app-declared resource
|
|
69
|
+
* types. The spec layer does NOT enum-membership-check it (apps
|
|
70
|
+
* declare custom resource types beyond the engine vocabulary).
|
|
71
|
+
*/
|
|
72
|
+
export interface ResourceFeatureSpecificationConfig extends FeatureSpecificationConfig {
|
|
73
|
+
/** Runtime resource-type identifier the feature is semantically owned by. */
|
|
74
|
+
resourceType: string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Bi-scoped feature specification map.
|
|
79
|
+
*
|
|
80
|
+
* Keys: `app.<featureRef>` | `resources.<resourceType>.<featureRef>`.
|
|
81
|
+
* Values are the union of {@link FeatureSpecificationConfig} (app-scoped)
|
|
82
|
+
* and {@link ResourceFeatureSpecificationConfig} (resource-scoped); the
|
|
83
|
+
* `resourceType` discriminator on the resource variant lets the
|
|
84
|
+
* `buildFeatureSpecificationMap` map builder + downstream renderers
|
|
85
|
+
* recover the scope from any value without re-parsing the bi-scoped
|
|
86
|
+
* key. See {@link FeatureSpecificationConfig} JSDoc for the full
|
|
87
|
+
* key-shape rationale and the typed key helpers
|
|
88
|
+
* (`appLevelFeatureSpecificationKeyFor`,
|
|
89
|
+
* `resourceLevelFeatureSpecificationKeyFor`).
|
|
90
|
+
*/
|
|
91
|
+
export type FeatureSpecification = Record<
|
|
92
|
+
string,
|
|
93
|
+
FeatureSpecificationConfig | ResourceFeatureSpecificationConfig
|
|
94
|
+
>;
|
|
95
|
+
```
|