@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,181 @@
|
|
|
1
|
+
# `.ragSource()` — the corpus-source declaration API
|
|
2
|
+
|
|
3
|
+
Read this when you need the exact contract rather than the workflow:
|
|
4
|
+
|
|
5
|
+
- the chunking vocabulary (`RAGChunkingStrategy`) and which member matches which content shape;
|
|
6
|
+
- the config object (`RagSourceConfiguration`) and the rules each knob must satisfy;
|
|
7
|
+
- the chainable method signature, including which schema kinds carry it;
|
|
8
|
+
- the programmatic escape hatch (`addRagSource`) and the reader (`getRagSourceConfig`).
|
|
9
|
+
|
|
10
|
+
Everything below is imported from `@wildo-ai/zod-decorators`.
|
|
11
|
+
|
|
12
|
+
Two contracts to internalise before you author anything:
|
|
13
|
+
|
|
14
|
+
1. **There is no `enabled` flag.** A field either carries the decorator — it IS a corpus source —
|
|
15
|
+
or it does not. `z.string().ragSource()` with no argument is a complete declaration.
|
|
16
|
+
2. **The config is validated at DECORATION time**, when the schema module loads, not at ingestion
|
|
17
|
+
time. A pathological chunking pair fails the application's own startup with a named message
|
|
18
|
+
rather than degrading quietly in a background job.
|
|
19
|
+
|
|
20
|
+
## Import Origins
|
|
21
|
+
|
|
22
|
+
- `@wildo-ai/zod-decorators`
|
|
23
|
+
|
|
24
|
+
## Source Excerpts
|
|
25
|
+
|
|
26
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
27
|
+
|
|
28
|
+
```typescript
|
|
29
|
+
*
|
|
30
|
+
* How a RAG-source field's text is split into retrieval chunks.
|
|
31
|
+
*
|
|
32
|
+
* Import from `@wildo-ai/zod-decorators`. Every member is a chunking STRATEGY — pick the one that
|
|
33
|
+
* matches the field's real content shape, because chunk boundaries decide what a retrieval hit can
|
|
34
|
+
* quote: a heading-aware split over markdown returns a coherent section, while a fixed-size split
|
|
35
|
+
* over the same text returns whatever fell inside the window.
|
|
36
|
+
*
|
|
37
|
+
* **This is the single named home for the chunking vocabulary** (semantic-string-literals rule).
|
|
38
|
+
* It lives in `zod-decorators` — not `saas-models` — because the dependency arrow points the other
|
|
39
|
+
* way: `saas-models` depends on this package, while the `.ragSource()` decorator params below could
|
|
40
|
+
* never import a `saas-models` enum. Chunking is authored ON THE FIELD, through `.ragSource()`;
|
|
41
|
+
* there is no separate agent-level chunking configuration to keep in step with it.
|
|
42
|
+
*
|
|
43
|
+
* - `FIXED_SIZE` — split every `chunkSize` characters/tokens regardless of structure.
|
|
44
|
+
* - `RECURSIVE` — split on a separator hierarchy (paragraph → sentence → word) down to `chunkSize`.
|
|
45
|
+
* - `SEMANTIC` — split at embedding-detected topic boundaries.
|
|
46
|
+
* - `MARKDOWN` — split on markdown structure (headings, lists, code fences).
|
|
47
|
+
* - `CODE` — split on source-code structure (functions, classes, blocks). Unified in (2026-08-26)
|
|
48
|
+
* from a second copy of this vocabulary that `saas-models` then carried: the member sets differed
|
|
49
|
+
* only by this entry, and shrinking the vocabulary to fit the field decorator would have silently
|
|
50
|
+
* invalidated configurations authored against the wider one — so the union won. That second copy,
|
|
51
|
+
* and the agent-level RAG configuration schemas around it, were retired on 2026-08-27 as a
|
|
52
|
+
* pre-capability design the shipped capability superseded; this object is now the only home.
|
|
53
|
+
*/
|
|
54
|
+
export const RAGChunkingStrategy = {
|
|
55
|
+
FIXED_SIZE: 'fixed_size',
|
|
56
|
+
RECURSIVE: 'recursive',
|
|
57
|
+
SEMANTIC: 'semantic',
|
|
58
|
+
MARKDOWN: 'markdown',
|
|
59
|
+
CODE: 'code',
|
|
60
|
+
} as const;
|
|
61
|
+
export type RAGChunkingStrategy = typeof RAGChunkingStrategy[keyof typeof RAGChunkingStrategy];
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Stored metadata for the RAG-source declaration (`.ragSource()` / `addRagSource()` /
|
|
65
|
+
* `z_file({ ragSource })`).
|
|
66
|
+
*
|
|
67
|
+
* Every knob is optional — `z.string().ragSource()` is a complete declaration that accepts the
|
|
68
|
+
* framework chunking defaults — and there is deliberately NO `enabled` flag: a field either carries
|
|
69
|
+
* the decorator (it IS a retrieval-corpus source) or it does not. A boolean that could say
|
|
70
|
+
* "decorated but disabled" would make every downstream reader (detection, chunk store, erasure
|
|
71
|
+
* seams) re-ask a question the decorator's presence already answers.
|
|
72
|
+
*
|
|
73
|
+
* Validated at decoration time by the `applySingleDecorator` chokepoint (shared by the fluent
|
|
74
|
+
* method and the escape hatch): `chunkingStrategy` must be a {@link RAGChunkingStrategy} member,
|
|
75
|
+
* `chunkSize` a positive integer, `chunkOverlap` a non-negative integer strictly smaller than
|
|
76
|
+
* `chunkSize` when both are present. Read the stored config back with `getRagSourceConfig(schema)`.
|
|
77
|
+
*
|
|
78
|
+
* Note the split of concerns with file fields: this object configures CHUNKING — how text becomes
|
|
79
|
+
* retrieval chunks — and is identical for a plain string field and a file field. How the TEXT is
|
|
80
|
+
* OBTAINED in the first place is the text provider's concern: trivial for a string field (the value
|
|
81
|
+
* is the text), file-side config for a file field (`FileSchemaOptions.textExtraction`, e.g. OCR).
|
|
82
|
+
*/
|
|
83
|
+
export interface RagSourceConfiguration {
|
|
84
|
+
/** Chunking strategy for this field's text. Omitted = the framework default strategy. */
|
|
85
|
+
chunkingStrategy?: RAGChunkingStrategy;
|
|
86
|
+
/** Target chunk size. Positive integer; omitted = the strategy's default size. */
|
|
87
|
+
chunkSize?: number;
|
|
88
|
+
/** Overlap carried between consecutive chunks. Non-negative integer, `< chunkSize` when both are set. */
|
|
89
|
+
chunkOverlap?: number;
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
94
|
+
|
|
95
|
+
```typescript
|
|
96
|
+
*
|
|
97
|
+
* Read a field's stored RAG-source configuration, declared via the fluent `.ragSource(config?)`
|
|
98
|
+
* method, the `addRagSource(schema, config?)` helper, or `z_file({ ragSource })`.
|
|
99
|
+
*
|
|
100
|
+
* Import from `@wildo-ai/zod-decorators`. Use it in custom implementations or checks that need to
|
|
101
|
+
* ask "is this field part of the retrieval corpus?" — never to re-derive the corpus itself, which
|
|
102
|
+
* the framework already does.
|
|
103
|
+
*
|
|
104
|
+
* `undefined` means the field is NOT a retrieval-corpus source — presence of the returned object is
|
|
105
|
+
* the declaration itself (there is no `enabled` flag), and a bare `.ragSource()` reads back as `{}`
|
|
106
|
+
* because the decorator chokepoint normalizes an omitted config to the empty object.
|
|
107
|
+
*
|
|
108
|
+
* Reads through wrapper types (`getMetadataRecursive` walks outer → inner), so it observes the
|
|
109
|
+
* declaration whether it was made before or after `.optional()` / `.nullable()` / `.nullish()` /
|
|
110
|
+
* `.default()` — corpus-source fields (descriptions, knowledge bodies) are routinely optional.
|
|
111
|
+
* This is the ONE detection door: `RagSourceFieldDetection` in the backend walks resource schemas
|
|
112
|
+
* with it, uniformly for plain string fields and `z_file()` fields.
|
|
113
|
+
*/
|
|
114
|
+
export function getRagSourceConfig(schema: z.ZodTypeAny): RagSourceConfiguration | undefined {
|
|
115
|
+
const metadata = getMetadataRecursive(schema);
|
|
116
|
+
// Typed as the normalized object, but read defensively as `unknown`: metadata written by any
|
|
117
|
+
// path that bypassed the chokepoint's normalization (a raw `true` sentinel) must still read as
|
|
118
|
+
// "declared, default config" rather than silently reading as NOT-a-source, which would drop the
|
|
119
|
+
// field from every downstream seam (detection, chunk store, erasure).
|
|
120
|
+
const value = metadata?.[ZodDecorator.RAG_SOURCE] as unknown;
|
|
121
|
+
if (value === undefined || value === null || value === false) return undefined;
|
|
122
|
+
return typeof value === 'object' ? (value as RagSourceConfiguration) : {};
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
127
|
+
|
|
128
|
+
```typescript
|
|
129
|
+
*
|
|
130
|
+
* `.ragSource(config?)` — declare this field's text a source of the application's retrieval
|
|
131
|
+
* corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
|
|
132
|
+
* `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
|
|
133
|
+
* wrappers, so it composes anywhere in a decorator chain.
|
|
134
|
+
*
|
|
135
|
+
* The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
|
|
136
|
+
* declaration that accepts the framework chunking defaults. Presence IS enablement.
|
|
137
|
+
*
|
|
138
|
+
* @example
|
|
139
|
+
* z.string().ragSource()
|
|
140
|
+
* @example
|
|
141
|
+
* z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
|
|
142
|
+
*/
|
|
143
|
+
[ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<T>;
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
147
|
+
|
|
148
|
+
```typescript
|
|
149
|
+
*
|
|
150
|
+
* Standalone form of `.ragSource(config?)` — declare a field's text a RAG retrieval-corpus source.
|
|
151
|
+
*
|
|
152
|
+
* Import from `@wildo-ai/zod-decorators`.
|
|
153
|
+
*
|
|
154
|
+
* The fluent `.ragSource()` method is the idiomatic authoring form and is live on every
|
|
155
|
+
* string-backed type plus the Optional / Nullable / Default wrappers. This helper is the
|
|
156
|
+
* programmatic escape hatch for schemas held as an erased/generic type, and it is the door
|
|
157
|
+
* `z_file({ ragSource })` uses to register the SAME decorator on a file schema (a `ZodObject`,
|
|
158
|
+
* which deliberately carries no fluent `.ragSource()` — see the applicable-types entry).
|
|
159
|
+
*
|
|
160
|
+
* Both doors funnel through `applySingleDecorator`, so both validate the config identically and
|
|
161
|
+
* both enforce the refused companions (`isPassword` / `isOtp` / `isWriteOnlySecret` /
|
|
162
|
+
* `isEphemeral` / `ttl`) in both application orders. Read the stored config back with
|
|
163
|
+
* `getRagSourceConfig(schema)`.
|
|
164
|
+
*
|
|
165
|
+
* @example
|
|
166
|
+
* // A complete declaration — framework chunking defaults apply.
|
|
167
|
+
* addRagSource(z.string())
|
|
168
|
+
* @example
|
|
169
|
+
* // Authored chunking for a markdown knowledge field.
|
|
170
|
+
* addRagSource(z.string(), { chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 })
|
|
171
|
+
*/
|
|
172
|
+
export function addRagSource<T extends z.ZodTypeAny>(
|
|
173
|
+
schema: T,
|
|
174
|
+
config?: RagSourceConfiguration,
|
|
175
|
+
): T {
|
|
176
|
+
ensureZodDecoratorsLoaded(z);
|
|
177
|
+
return addDecorators(schema, [
|
|
178
|
+
{ ref: ZodDecorator.RAG_SOURCE, params: config },
|
|
179
|
+
]);
|
|
180
|
+
}
|
|
181
|
+
```
|
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-schema-authoring
|
|
3
|
+
description: Author or modify shared-layer resource schemas using Zod with structural decorators in `shared-lib/**/resources/**/*.schemas.ts`. Use when the user says "add a field to <resource>'s schema", "change <field> to an enum", "make <field> a foreign key", "exclude <field> from create/update", "mark <field> as backend-only", "add a discriminator", or "use the money/file/range factory" — anything that changes persisted shape or structural metadata on the shared schema.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Resource Schema Authoring (Shared Layer)
|
|
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
|
+
Use this skill to make a correct change in the **shared schema layer only**.
|
|
23
|
+
The goal is to leave `*.schemas.ts` truthful about persisted structure,
|
|
24
|
+
structural decorators, and schema-family shape without mixing in frontend or
|
|
25
|
+
specification concerns.
|
|
26
|
+
|
|
27
|
+
There is **one schema per resource**. Separate create/read/update schemas do
|
|
28
|
+
not exist. Lifecycle and visibility behavior are controlled by decorators on
|
|
29
|
+
that shared schema.
|
|
30
|
+
|
|
31
|
+
When engine source is not available, use the source-backed references in this
|
|
32
|
+
skill folder. They inline anchored framework APIs into the compiled skill
|
|
33
|
+
package so the application-level AI can still inspect the real shared
|
|
34
|
+
decorator method surface, structural param types, lifecycle param contracts,
|
|
35
|
+
chainable runtime behavior, special factories, and schema-family contracts.
|
|
36
|
+
|
|
37
|
+
## App Paths
|
|
38
|
+
|
|
39
|
+
Locate the shared schema and the layers this skill explicitly does **not**
|
|
40
|
+
touch (so the AI knows where misplaced decorators would belong instead).
|
|
41
|
+
|
|
42
|
+
| Surface | Glob (relative to app root) |
|
|
43
|
+
|----------------------|------------------------------------------------------------------------------------------|
|
|
44
|
+
| Shared schema (this) | `shared-lib/src/modules/*/resources/*/*.schemas.ts` |
|
|
45
|
+
| Resources config | `shared-lib/src/modules/*/resources/*/*.resources-config.ts` |
|
|
46
|
+
| Frontend UI behavior | `frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
|
|
47
|
+
| Specification | `specifications/src/modules/*/resources/*.resource.specification.ts` |
|
|
48
|
+
| Module relationships | `shared-lib/src/modules/*/resources/*.relationships.ts` |
|
|
49
|
+
|
|
50
|
+
If the project diverges from this layout, find the resource by grepping for
|
|
51
|
+
`initZodDecorators(z)` and the existing `Z.object({` or `createSchemaFamily(`
|
|
52
|
+
declaration.
|
|
53
|
+
|
|
54
|
+
## When to Use
|
|
55
|
+
|
|
56
|
+
- Creating a new resource schema from scratch
|
|
57
|
+
- Adding a field to an existing resource
|
|
58
|
+
- Changing a field's type, constraints, or structural decorators
|
|
59
|
+
- Configuring enum declarations and defaults
|
|
60
|
+
- Configuring field DB behavior (indexes, uniqueness, TTL)
|
|
61
|
+
- Controlling field lifecycle and visibility
|
|
62
|
+
- Setting up discriminator-driven variants via `createSchemaFamily`
|
|
63
|
+
- Declaring or reasoning about a per-scope polymorphic resource (one shape per org/app/user)
|
|
64
|
+
|
|
65
|
+
## When NOT to Use
|
|
66
|
+
|
|
67
|
+
- Configuring how fields render in UI -> use `resource-ui-behavior`
|
|
68
|
+
- Adding business semantics for the companion -> use `spec-update-after-change`
|
|
69
|
+
- Wiring a schema change to operations/relationships -> use `resource-config-wiring`
|
|
70
|
+
- Completing an end-to-end field addition by itself -> also load `resource-add-field`
|
|
71
|
+
|
|
72
|
+
## Workflow
|
|
73
|
+
|
|
74
|
+
### Step 1: Classify the change before editing
|
|
75
|
+
|
|
76
|
+
**File:** `./shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts`
|
|
77
|
+
|
|
78
|
+
Decide which branch applies before you touch the schema:
|
|
79
|
+
|
|
80
|
+
| Change type | Shared-layer action | Read next |
|
|
81
|
+
|-------------|---------------------|-----------|
|
|
82
|
+
| Primitive or standard enum field | Add/change the field in the main schema with structural decorators only | `references/field-type-selection.md` |
|
|
83
|
+
| Special domain type (`money`, `file`, `range`, etc.) | Use the dedicated `z_*` factory instead of forcing a plain primitive | `references/special-factories.md` |
|
|
84
|
+
| Foreign key or ownership/audit field | Add the field plus the structural relationship decorators | `references/shared-layer-decorator-checklist.md` |
|
|
85
|
+
| Backend-only or server-managed field | Add lifecycle/security decorators up front | `references/shared-layer-decorator-checklist.md` |
|
|
86
|
+
| Discriminator or variant change | Review the whole schema-family contract before editing | `references/schema-variants-and-discriminators.md` |
|
|
87
|
+
| Per-scope polymorphic resource (one shape per org/app/user) | Decide **singleton vs multi-row** before declaring — the default enforces a one-per-scope unique index; a collection must opt out | `references/polymorphic-per-scope-resources.md` |
|
|
88
|
+
|
|
89
|
+
If the user asked to **add a field to the resource as a whole**, this skill is
|
|
90
|
+
only the shared-layer portion. Load `resource-add-field` too so the work does
|
|
91
|
+
not stop after the schema edit.
|
|
92
|
+
|
|
93
|
+
### Step 2: Preserve shared-layer boundaries
|
|
94
|
+
|
|
95
|
+
This file owns **persisted shape and structural metadata only**.
|
|
96
|
+
|
|
97
|
+
- Keep `initZodDecorators(z)` on the same `z` instance used to define schemas.
|
|
98
|
+
- Put only structural decorators here:
|
|
99
|
+
`.isPrimaryKey()`, `.isDBIndexed()`, `.isForeignKey()`,
|
|
100
|
+
`.excludeFromCreate()`, `.excludeFromUpdate()`, `.isBackendOnly()`,
|
|
101
|
+
`.isSummaryField()`, `.isDiscriminator()`, and similar shared-layer concerns.
|
|
102
|
+
- Do **not** add UI decorators here (`.stringUI()`, `.enumUI()`, etc.).
|
|
103
|
+
- Do **not** add specification decorators here (`.stringSpec()`, `.enumSpec()`, etc.).
|
|
104
|
+
|
|
105
|
+
```typescript
|
|
106
|
+
import { z } from 'zod';
|
|
107
|
+
import { initZodDecorators } from '@wildo-ai/zod-decorators';
|
|
108
|
+
|
|
109
|
+
initZodDecorators(z);
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Without that initialization, chainable decorator methods fail at runtime.
|
|
113
|
+
|
|
114
|
+
### Step 3: Choose the right field shape
|
|
115
|
+
|
|
116
|
+
Make the field shape truthful before thinking about chrome or labels:
|
|
117
|
+
|
|
118
|
+
| Need | Preferred shared-layer pattern |
|
|
119
|
+
|------|-------------------------------|
|
|
120
|
+
| Finite vocabulary | TypeScript `enum` + `z.enum(MyEnum)` |
|
|
121
|
+
| Foreign key id | `z.string().min(1)...isForeignKey()` |
|
|
122
|
+
| Domain type with framework semantics | Use `z_money()`, `z_file()`, `z_range()`, etc. |
|
|
123
|
+
| Technical/system field | Plain schema type + lifecycle/security decorators |
|
|
124
|
+
| Variant-only field | Put it in the variant extension, not in the common base schema |
|
|
125
|
+
|
|
126
|
+
Read `references/field-type-selection.md` when the type choice is not obvious.
|
|
127
|
+
|
|
128
|
+
### Step 4: Apply structural decorators deliberately
|
|
129
|
+
|
|
130
|
+
Use structural decorators to express **system truth**, not presentation:
|
|
131
|
+
|
|
132
|
+
| Concern | Typical decorator choices |
|
|
133
|
+
|---------|---------------------------|
|
|
134
|
+
| Resource identity | `.isPrimaryKey()` and often `.isSummaryField()` |
|
|
135
|
+
| Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` |
|
|
136
|
+
| Visible in lists / FK references | `.isSummaryField()` |
|
|
137
|
+
| Immutable after creation | `.excludeFromUpdate()` |
|
|
138
|
+
| Server-managed value | `.excludeFromCreate()` and often `.excludeFromUpdate()` |
|
|
139
|
+
| Sensitive backend-only value | `.isBackendOnly()` |
|
|
140
|
+
| Discriminator field | `.isDiscriminator()` |
|
|
141
|
+
|
|
142
|
+
Use `references/shared-layer-decorator-checklist.md` for the higher-signal
|
|
143
|
+
field patterns and "never do this" reminders.
|
|
144
|
+
|
|
145
|
+
### Step 5: Handle schema-family changes explicitly
|
|
146
|
+
|
|
147
|
+
If the change touches a discriminator, variant-only fields, or schema-family
|
|
148
|
+
shape:
|
|
149
|
+
|
|
150
|
+
- review whether the field belongs in the base schema or one variant only
|
|
151
|
+
- keep the discriminator field in the base schema
|
|
152
|
+
- keep extension schemas focused on variant-only fields
|
|
153
|
+
- re-check downstream config/spec behavior because discriminator changes are
|
|
154
|
+
never local to the shared schema
|
|
155
|
+
|
|
156
|
+
Use `references/schema-variants-and-discriminators.md` before editing any
|
|
157
|
+
schema-family contract.
|
|
158
|
+
|
|
159
|
+
### Step 6: Close the shared-layer change cleanly
|
|
160
|
+
|
|
161
|
+
Before leaving the file:
|
|
162
|
+
|
|
163
|
+
- export the schema and inferred type
|
|
164
|
+
- keep naming and existing schema-family conventions intact
|
|
165
|
+
- make sure enum fields use a TypeScript enum and `z.enum(MyEnum)`
|
|
166
|
+
- confirm sensitive data uses `.isBackendOnly()`, not `.isHidden()`
|
|
167
|
+
- if the task is broader than shared-layer authoring, continue with
|
|
168
|
+
`resource-add-field` or the appropriate downstream skill
|
|
169
|
+
|
|
170
|
+
## Worked Example
|
|
171
|
+
|
|
172
|
+
An application's `priority` field is the canonical "enum field done right"
|
|
173
|
+
shape on the shared layer. The compiled extract below is the live source —
|
|
174
|
+
both the named enum and the field declaration are anchored, accumulated
|
|
175
|
+
under a single id, and rendered together:
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
## Usage Example
|
|
179
|
+
|
|
180
|
+
```typescript
|
|
181
|
+
export enum Todos_Priority {
|
|
182
|
+
LOW = 'low',
|
|
183
|
+
MEDIUM = 'medium',
|
|
184
|
+
HIGH = 'high',
|
|
185
|
+
URGENT = 'urgent',
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## Usage Example
|
|
190
|
+
|
|
191
|
+
```typescript
|
|
192
|
+
priority: z.enum(Todos_Priority).default(Todos_Priority.MEDIUM).isSummaryField(),
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
What earns its place here:
|
|
196
|
+
|
|
197
|
+
- `enum Todos_Priority { ... }` is a **named TypeScript enum**, not an
|
|
198
|
+
inline `['low', 'medium', ...]` array. The framework relies on the named
|
|
199
|
+
vocabulary downstream (specs, UI, i18n).
|
|
200
|
+
- `z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)` is the canonical
|
|
201
|
+
shape — typed, with a sensible default that doesn't force users to pick
|
|
202
|
+
on create.
|
|
203
|
+
- `.isSummaryField()` is the **only** decorator on the field. This is a
|
|
204
|
+
structural concern (which fields appear in summary projections / FK
|
|
205
|
+
hydration / list views).
|
|
206
|
+
- There is **no `.enumUI(...)` here**. If you find yourself reaching for
|
|
207
|
+
one, stop — it belongs in the matching `*.ui-behavior.tsx`. See the
|
|
208
|
+
badge wiring on the same field:
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
## Usage Example
|
|
212
|
+
|
|
213
|
+
```tsx
|
|
214
|
+
// Per-value color + icon are cross-context: the detail page renders
|
|
215
|
+
// BADGE (icon + label inside the colored badge), while `summaryOverride`
|
|
216
|
+
// switches cards / FK previews to ICON — the compact icon-only badge
|
|
217
|
+
// (label stays available to assistive tech and on hover).
|
|
218
|
+
priority: sh.priority.enumUI({
|
|
219
|
+
display: { displayMode: EnumDisplayMode.BADGE, showDescription: true },
|
|
220
|
+
summaryOverride: { displayMode: EnumDisplayMode.ICON },
|
|
221
|
+
edit: { showDescription: true },
|
|
222
|
+
values: {
|
|
223
|
+
[Todos_Priority.LOW]: { color: BadgeSemanticVariant.SECONDARY, icon: ArrowDown },
|
|
224
|
+
[Todos_Priority.MEDIUM]: { color: BadgeSemanticVariant.DEFAULT, icon: Minus },
|
|
225
|
+
[Todos_Priority.HIGH]: { color: BadgeSemanticVariant.WARNING, icon: ArrowUp },
|
|
226
|
+
[Todos_Priority.URGENT]: { color: BadgeSemanticVariant.DESTRUCTIVE, icon: AlertTriangle },
|
|
227
|
+
},
|
|
228
|
+
}),
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
The two snippets together show the boundary this skill enforces: the
|
|
232
|
+
shared schema declares the **truth**, the UI behavior file declares the
|
|
233
|
+
**chrome**.
|
|
234
|
+
|
|
235
|
+
## References
|
|
236
|
+
|
|
237
|
+
- `references/decorator-layer-map.md` — decide which file/layer owns the next change
|
|
238
|
+
- `references/shared-layer-decorator-checklist.md` — common structural decorator patterns
|
|
239
|
+
- `references/field-type-selection.md` — choose between primitive, enum, FK, and factory shapes
|
|
240
|
+
- `references/special-factories.md` — dedicated `z_*` factory choices
|
|
241
|
+
- `references/schema-variants-and-discriminators.md` — schema-family guidance
|
|
242
|
+
- `references/polymorphic-per-scope-resources.md` — per-scope (org/app/user) polymorphic resources: singleton vs multi-row + one-per-scope uniqueness
|
|
243
|
+
- `references/framework-shared-decorator-methods-api.md` — source-backed shared decorator method surface
|
|
244
|
+
- `references/framework-shared-structural-params-api.md` — source-backed shared structural param contracts
|
|
245
|
+
- `references/framework-special-factories-api.md` — source-backed special factory definitions
|
|
246
|
+
- `references/framework-schema-family-api.md` — source-backed `createSchemaFamily` contract
|
|
247
|
+
- `references/framework-polymorphic-resources-api.md` — source-backed `PolymorphicVariantDefinition` + `optOutPolymorphicAutoBusinessKey` contract
|
|
248
|
+
- `references/framework-decorator-vocabulary-api.md` — source-backed `ZodDecorator` enum + `SCHEMA_METADATA` symbol
|
|
249
|
+
- `references/framework-personal-data-category-api.md` — source-backed `.dataCategories()` + `PersonalDataCategory` vocabulary, for any field holding personal data
|
|
250
|
+
- `references/framework-zod-lifecycle-and-chainable-api.md` — lifecycle structural params + chainable runtime (`initZodDecorators` alignment)
|
|
251
|
+
- `examples/add-enum-field-with-ui.example.md` — worked three-layer example
|
|
252
|
+
- `examples/basic-resource-schema.example.md` — full from-scratch resource schema
|
|
253
|
+
|
|
254
|
+
## Verification
|
|
255
|
+
|
|
256
|
+
- [ ] `initZodDecorators(z)` is still called before schema definitions
|
|
257
|
+
- [ ] The changed field uses the truthful schema shape (`z.enum`, special factory, FK string, variant extension, etc.)
|
|
258
|
+
- [ ] Structural decorators express lifecycle/security/indexing truth for the field
|
|
259
|
+
- [ ] No UI decorators (`.stringUI()`, `.enumUI()`, etc.) were added to the schema file
|
|
260
|
+
- [ ] No specification decorators (`.stringSpec()`, `.enumSpec()`, etc.) were added to the schema file
|
|
261
|
+
- [ ] Enum fields use a named TypeScript enum with `z.enum(MyEnum)`
|
|
262
|
+
- [ ] Sensitive fields use `.isBackendOnly()` rather than `.isHidden()`
|
|
263
|
+
- [ ] The schema export and inferred type still exist
|
|
264
|
+
- [ ] If the user asked for an end-to-end field/resource change, downstream follow-up was explicitly continued or handed off
|
|
265
|
+
|
|
266
|
+
### Grep invariants
|
|
267
|
+
|
|
268
|
+
Run from the app root and substitute the resource path / field name:
|
|
269
|
+
|
|
270
|
+
| Invariant | Command |
|
|
271
|
+
|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
272
|
+
| The schema file initializes Zod decorators | `rg -n "initZodDecorators\\(z\\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
273
|
+
| **No UI decorators** leaked into the shared schema (this MUST return zero matches) | `rg -n "\\.\\w+UI\\(" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
274
|
+
| **No spec decorators** leaked into the shared schema (this MUST return zero matches) | `rg -n "\\.\\w+Spec\\(" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
275
|
+
| Every FK-shaped field carries the explicit decorator | `rg -n "UserId\\\|OrganizationId\\\|ListId" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \\| rg -v "isForeignKey\\(\\)"` |
|
|
276
|
+
| Every `isForeignKey()` field has a registered relationship edge (per FK field `<fkField>`) | `rg -n "foreignKeyField: '<fkField>'" shared-lib/src/modules/*/resources/*.relationships.ts` |
|
|
277
|
+
| Enum fields use a named TS enum, not an inline literal array | `rg -n "z\\.enum\\(\\[" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
278
|
+
| Sensitive backend-only fields are not using `.isHidden()` as a security boundary | `rg -n "\\.isHidden\\(\\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
279
|
+
|
|
280
|
+
If the second or third grep returns any match, the layer boundary has been
|
|
281
|
+
broken. Move the offending decorator to the right file before stopping.
|
|
282
|
+
|
|
283
|
+
The relationship-edge grep must return one match **per FK field you authored**
|
|
284
|
+
(run it once per field, substituting `<fkField>`). `.isForeignKey()` marks the
|
|
285
|
+
field; it does NOT resolve it — resolution happens through the module's
|
|
286
|
+
registered relationships (`*.relationships.ts`), and a marked-but-unregistered
|
|
287
|
+
FK passes typecheck, boots the backend registry, and then fails the FRONTEND
|
|
288
|
+
registry at first page load with `frontend_fk_resolution_failed`. Author the
|
|
289
|
+
edge with the `module-relationships` skill in the same pass as the field.
|
|
290
|
+
|
|
291
|
+
## Common Rationalizations
|
|
292
|
+
|
|
293
|
+
| Rationalization | Reality |
|
|
294
|
+
|-----------------|---------|
|
|
295
|
+
| "I'll just put the `enumUI()` here for convenience" | UI decorators in `*.schemas.ts` collapse the shared/frontend boundary and make the schema lie about its responsibility. |
|
|
296
|
+
| "This FK is obvious, I don't need `isForeignKey()`" | Without the FK decorator, the framework loses relationship-aware behavior even if the field name looks correct. |
|
|
297
|
+
| "The `.isForeignKey()` decorator is enough — the relationship can come later" | The decorator only MARKS the field; resolution needs a registered relationship edge. Deferring it ships an app whose frontend refuses to initialize (`frontend_fk_resolution_failed`), invisible to typecheck and to the backend boot. |
|
|
298
|
+
| "I can use `.isHidden()` for sensitive data" | `isHidden` is not a security boundary. Sensitive values must stay backend-only. |
|
|
299
|
+
| "Inline enum strings are good enough" | Inline arrays lose the named enum contract the rest of the system depends on. |
|
|
300
|
+
| "I only changed one discriminator field, the variants don't matter" | Discriminator changes alter the shape contract for every variant consumer, not just the local field. |
|
|
301
|
+
|
|
302
|
+
## Red Flags
|
|
303
|
+
|
|
304
|
+
- UI or specification decorators appear in a `*.schemas.ts` file (catch with the **No UI decorators** / **No spec decorators** greps above).
|
|
305
|
+
- A new FK-like field was added without `.isForeignKey()` (catch with the **Every FK-shaped field** grep above).
|
|
306
|
+
- An `isForeignKey()` field has no matching `foreignKeyField:` entry in the module's `*.relationships.ts` (catch with the **registered relationship edge** grep above).
|
|
307
|
+
- A sensitive field uses `.isHidden()` instead of `.isBackendOnly()` (catch with the **Sensitive backend-only fields** grep above).
|
|
308
|
+
- A new enum uses inline string literals instead of a named TypeScript enum (catch with the **Enum fields use a named TS enum** grep above).
|
|
309
|
+
- A discriminator or variant change was made without reviewing schema-family structure (manual review against `references/schema-variants-and-discriminators.md`).
|
|
310
|
+
- The task was end-to-end, but the work stopped after the shared schema edit (cross-skill handoff missing — load `resource-add-field`).
|
|
311
|
+
|
|
312
|
+
## Related Skills
|
|
313
|
+
|
|
314
|
+
- `resource-add-field` — orchestrator that completes end-to-end field addition (this skill is its shared-layer step)
|
|
315
|
+
- `resource-config-wiring` — relationships, operations, and config follow-up
|
|
316
|
+
- `resource-ui-behavior` — frontend display/edit behavior
|
|
317
|
+
- `spec-update-after-change` — specification follow-up after shared changes
|
|
318
|
+
- `i18n-rerun-pipeline` — user-facing label/translation follow-up
|
package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md
ADDED
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# Example: Add an Enum Field, Cleanly Split Across Layers
|
|
2
|
+
|
|
3
|
+
## Scenario
|
|
4
|
+
|
|
5
|
+
Add a `priority` enum field to an existing `Todos` resource. This skill
|
|
6
|
+
owns only the shared-layer half — the example shows that half in detail
|
|
7
|
+
and points to the matching frontend / spec snippets so you can verify the
|
|
8
|
+
**boundary** is being respected.
|
|
9
|
+
|
|
10
|
+
The same field is anchored end-to-end in
|
|
11
|
+
`resource-add-field/examples/add-priority-field-to-todos.example.md`; this
|
|
12
|
+
example is the focused shared-layer view.
|
|
13
|
+
|
|
14
|
+
## Step 1: Shared-layer schema (this skill)
|
|
15
|
+
|
|
16
|
+
**File: `./shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts`**
|
|
17
|
+
|
|
18
|
+
The named enum and the field declaration go in the same file, with **only
|
|
19
|
+
structural decorators**. The compiled extract below is a live application
|
|
20
|
+
source example:
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
## Usage Example
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
export enum Todos_Priority {
|
|
27
|
+
LOW = 'low',
|
|
28
|
+
MEDIUM = 'medium',
|
|
29
|
+
HIGH = 'high',
|
|
30
|
+
URGENT = 'urgent',
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Usage Example
|
|
35
|
+
|
|
36
|
+
```typescript
|
|
37
|
+
priority: z.enum(Todos_Priority).default(Todos_Priority.MEDIUM).isSummaryField(),
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Why these are the right choices on the shared layer:
|
|
41
|
+
|
|
42
|
+
- `enum Todos_Priority { ... }` — named TypeScript enum. The framework
|
|
43
|
+
uses this enum value as a stable identifier in specs, UI behavior, and
|
|
44
|
+
i18n; an inline `['low', 'medium', ...]` array would break that
|
|
45
|
+
contract.
|
|
46
|
+
- `z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)` — typed and
|
|
47
|
+
defaulted. Defaulting on shared schema avoids forcing every create-side
|
|
48
|
+
caller to pick a value.
|
|
49
|
+
- `.isSummaryField()` — the only decorator. This is structural truth: the
|
|
50
|
+
field appears in summary projections, FK-derived listings, and list
|
|
51
|
+
views.
|
|
52
|
+
- **No `.enumUI(...)`** — the chrome belongs in the next file (Step 2).
|
|
53
|
+
- **No `.enumSpec(...)`** — the prose belongs in Step 3.
|
|
54
|
+
|
|
55
|
+
## Step 2: UI behavior (separate skill — `resource-ui-behavior`)
|
|
56
|
+
|
|
57
|
+
**File: `./frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`**
|
|
58
|
+
|
|
59
|
+
The UI chrome (`displayMode`, `BadgeSemanticVariant`, value→color map)
|
|
60
|
+
lives in the matching `*.ui-behavior.tsx` file and uses the same
|
|
61
|
+
`Todos_Priority` enum imported from the shared schema:
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
## Usage Example
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
// Per-value color + icon are cross-context: the detail page renders
|
|
68
|
+
// BADGE (icon + label inside the colored badge), while `summaryOverride`
|
|
69
|
+
// switches cards / FK previews to ICON — the compact icon-only badge
|
|
70
|
+
// (label stays available to assistive tech and on hover).
|
|
71
|
+
priority: sh.priority.enumUI({
|
|
72
|
+
display: { displayMode: EnumDisplayMode.BADGE, showDescription: true },
|
|
73
|
+
summaryOverride: { displayMode: EnumDisplayMode.ICON },
|
|
74
|
+
edit: { showDescription: true },
|
|
75
|
+
values: {
|
|
76
|
+
[Todos_Priority.LOW]: { color: BadgeSemanticVariant.SECONDARY, icon: ArrowDown },
|
|
77
|
+
[Todos_Priority.MEDIUM]: { color: BadgeSemanticVariant.DEFAULT, icon: Minus },
|
|
78
|
+
[Todos_Priority.HIGH]: { color: BadgeSemanticVariant.WARNING, icon: ArrowUp },
|
|
79
|
+
[Todos_Priority.URGENT]: { color: BadgeSemanticVariant.DESTRUCTIVE, icon: AlertTriangle },
|
|
80
|
+
},
|
|
81
|
+
}),
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
This is **not** part of the schema authoring skill — but it's shown here
|
|
85
|
+
so the boundary is visible. If this code drifted into the schema file,
|
|
86
|
+
both the **No UI decorators** grep in `Verification` and the audit of
|
|
87
|
+
`*.ui-behavior.tsx` would catch it.
|
|
88
|
+
|
|
89
|
+
## Step 3: Specification (separate skill — `spec-resource-update`)
|
|
90
|
+
|
|
91
|
+
**File: `./specifications/src/modules/<module>/resources/<resource>.resource.specification.ts`**
|
|
92
|
+
|
|
93
|
+
The semantic prose (`meaning`, `whyItMatters`, per-value `meaning` map)
|
|
94
|
+
goes into the spec layer for the same field:
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
## Usage Example
|
|
98
|
+
|
|
99
|
+
```typescript
|
|
100
|
+
priority: schemaShape.priority.enumSpec({
|
|
101
|
+
meaning: 'Expresses urgency and ordering pressure among open todos.',
|
|
102
|
+
whyItMatters: 'It helps the application decide what should visually stand out or be treated first.',
|
|
103
|
+
enumDeclaration: {
|
|
104
|
+
packageName: '@your-app/shared-lib',
|
|
105
|
+
exportName: 'Todos_Priority',
|
|
106
|
+
symbolKind: CodeSymbolKind.ENUM,
|
|
107
|
+
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
108
|
+
},
|
|
109
|
+
values: {
|
|
110
|
+
[Todos_Priority.LOW]: { meaning: 'Can wait — no time pressure.' },
|
|
111
|
+
[Todos_Priority.MEDIUM]: { meaning: 'Normal urgency — should be handled in due course.' },
|
|
112
|
+
[Todos_Priority.HIGH]: { meaning: 'Needs attention soon — may block other work.' },
|
|
113
|
+
[Todos_Priority.URGENT]: { meaning: 'Immediate action required — top of the queue.' },
|
|
114
|
+
},
|
|
115
|
+
}),
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Same pattern: the spec layer carries the **business meaning**, not the
|
|
119
|
+
shape (which the schema owns) and not the chrome (which the UI behavior
|
|
120
|
+
owns).
|
|
121
|
+
|
|
122
|
+
## Key Takeaway
|
|
123
|
+
|
|
124
|
+
Adding a field touches **three separate files** across three layers:
|
|
125
|
+
|
|
126
|
+
1. Schema (shared-lib) — structural decorators only (this skill).
|
|
127
|
+
2. UI behavior (frontend) — display/edit chrome (`resource-ui-behavior`).
|
|
128
|
+
3. Specification (specs) — business semantics (`spec-resource-update`).
|
|
129
|
+
|
|
130
|
+
The `resource-add-field` workflow skill orchestrates all three. If the
|
|
131
|
+
user is adding a real new field — not just renaming or tweaking
|
|
132
|
+
constraints on an existing one — load that orchestrator next.
|