@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,75 @@
|
|
|
1
|
+
# Polymorphic (Per-Scope) Resources
|
|
2
|
+
|
|
3
|
+
Read this when a resource must exist **once per organization AND once per
|
|
4
|
+
application** (or per user) — i.e. the *same* shape parented to different
|
|
5
|
+
scopes — or when you are reasoning about the framework-provided per-scope
|
|
6
|
+
resources your app consumes (SSO / SIEM / SCIM configuration, webhook config,
|
|
7
|
+
billing account). This is a **different** mechanism from a discriminated-union
|
|
8
|
+
schema family (`references/schema-variants-and-discriminators.md`): a schema
|
|
9
|
+
family is one resource with variant *shapes*; a polymorphic resource is one
|
|
10
|
+
shape stamped out per *scope*.
|
|
11
|
+
|
|
12
|
+
## What it produces
|
|
13
|
+
|
|
14
|
+
A polymorphic declaration (`declarePolymorphicSchemas` + a variant set such as
|
|
15
|
+
`AUTH_SCOPE_VARIANTS`, from `@wildo-ai/saas-models`) takes one base schema and
|
|
16
|
+
produces a **distinct resource type per scope** — e.g. an `organization…` and
|
|
17
|
+
an `application…` variant. Into each variant it **injects the scope foreign
|
|
18
|
+
key** (`organizationId` for the org variant, `applicationId` for the app
|
|
19
|
+
variant, `userId` for the user variant). You never hand-write that FK on the
|
|
20
|
+
base schema; the engine adds it, correctly named, per variant.
|
|
21
|
+
|
|
22
|
+
You will mostly **consume** these (the framework ships several). You author your
|
|
23
|
+
own only in the rare case where a resource genuinely lives once-per-org *and*
|
|
24
|
+
once-per-app.
|
|
25
|
+
|
|
26
|
+
## The one decision that matters: SINGLETON vs MULTI-ROW per scope
|
|
27
|
+
|
|
28
|
+
For every polymorphic resource, answer: **can a scope hold more than one row?**
|
|
29
|
+
|
|
30
|
+
| Answer | What it is | What you declare | DB result |
|
|
31
|
+
|--------|-----------|------------------|-----------|
|
|
32
|
+
| **No — one per scope** (a *singleton*) | Per-scope *configuration* / a 1:1 scope bridge (e.g. "the SSO config for this org", "the billing account for this org") | Nothing extra — the default for a primary-scope variant | The injected scope FK becomes the **business key** and a **UNIQUE index** → the database enforces *at most one row per scope* |
|
|
33
|
+
| **Yes — many per scope** | Per-scope *collections* (logs, tokens, connections, delivery rows, usage records) | Wrap the variants with `optOutPolymorphicAutoBusinessKey` | The scope FK is a plain, **non-unique** index; many rows share a scope |
|
|
34
|
+
|
|
35
|
+
The default is **singleton**. If your resource is a collection, you **must**
|
|
36
|
+
opt out — forgetting is now a loud, immediate failure, not a subtle one.
|
|
37
|
+
|
|
38
|
+
### Multi-row: opt out explicitly
|
|
39
|
+
|
|
40
|
+
```ts
|
|
41
|
+
import { AUTH_SCOPE_VARIANTS, optOutPolymorphicAutoBusinessKey } from '@wildo-ai/saas-models';
|
|
42
|
+
// variants: [...AUTH_SCOPE_VARIANTS].map(optOutPolymorphicAutoBusinessKey)
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
If you skip the opt-out on a multi-row resource, **two** things break: (1) the
|
|
46
|
+
scope FK gets a **unique** index, so the *second* row you insert for a scope is
|
|
47
|
+
rejected with a duplicate-key error; and (2) any `upsertByBusinessKey` routes
|
|
48
|
+
every row in the scope onto a single document. Both are wrong — the resource is
|
|
49
|
+
not a singleton.
|
|
50
|
+
|
|
51
|
+
## What the singleton guarantee buys consumers
|
|
52
|
+
|
|
53
|
+
For a singleton, the database itself enforces **at most one row per scope**, so
|
|
54
|
+
code that reads "the config for this org" can rely on a single row. The
|
|
55
|
+
framework keeps that row *present* by seeding a disabled-default at scope
|
|
56
|
+
creation (and, for a few auth configs, lazily materialising it on first read),
|
|
57
|
+
so a singleton read returns the honest "feature available, switched off" state
|
|
58
|
+
rather than a missing-row error. You do not manage that lifecycle — you consume
|
|
59
|
+
the guaranteed single row.
|
|
60
|
+
|
|
61
|
+
## Recognizing them
|
|
62
|
+
|
|
63
|
+
- The resource type name is scope-prefixed: `organization…` / `application…`.
|
|
64
|
+
- The base schema does **not** declare `organizationId` / `applicationId` — the
|
|
65
|
+
scope FK is injected by the polymorphism engine, so its absence from the base
|
|
66
|
+
`.schemas.ts` is expected, not a bug.
|
|
67
|
+
- The declaration uses `declarePolymorphicSchemas` (schema layer) paired with
|
|
68
|
+
`createPolymorphicResourceConfigurations` (config layer).
|
|
69
|
+
|
|
70
|
+
## Exact API shapes
|
|
71
|
+
|
|
72
|
+
For the source-backed `PolymorphicVariantDefinition` (the per-variant shape —
|
|
73
|
+
`isPrimaryScope`, `businessKeyFields`, inherited scope fields) and the
|
|
74
|
+
`optOutPolymorphicAutoBusinessKey` helper signature + contract, see
|
|
75
|
+
`references/framework-polymorphic-resources-api.md`.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Schema Variants and Discriminators
|
|
2
|
+
|
|
3
|
+
Open this file before changing a discriminator field or any schema-family
|
|
4
|
+
structure.
|
|
5
|
+
|
|
6
|
+
## When This Applies
|
|
7
|
+
|
|
8
|
+
Use this reference when:
|
|
9
|
+
|
|
10
|
+
- one resource has variant-specific fields
|
|
11
|
+
- a discriminator field controls which fields are valid
|
|
12
|
+
- a field should exist only for some variants
|
|
13
|
+
- a change may move a field between base schema and variant extension
|
|
14
|
+
|
|
15
|
+
## Core Rules
|
|
16
|
+
|
|
17
|
+
- The discriminator field belongs in the **base schema**
|
|
18
|
+
- The discriminator field should carry `.isDiscriminator()`
|
|
19
|
+
- Shared fields stay in the base schema
|
|
20
|
+
- Variant-only fields stay in extension schemas
|
|
21
|
+
- A discriminator change is never local: review config, spec, and often UI
|
|
22
|
+
|
|
23
|
+
## Typical Pattern
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
export const Todo_BaseSchema = z.object({
|
|
27
|
+
type: z.enum(TodoType).isDiscriminator(),
|
|
28
|
+
title: z.string().min(1),
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
const recurringExtension = z.object({
|
|
32
|
+
intervalDays: z.number().min(1),
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
export const TodoSchemaFamily = createSchemaFamily({
|
|
36
|
+
base: Todo_BaseSchema,
|
|
37
|
+
discriminator: {
|
|
38
|
+
field: 'type',
|
|
39
|
+
baseValues: [TodoType.STANDARD],
|
|
40
|
+
},
|
|
41
|
+
variants: {
|
|
42
|
+
[TodoType.RECURRING]: { extend: recurringExtension },
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Review Checklist
|
|
48
|
+
|
|
49
|
+
Before finishing a variant-related change, ask:
|
|
50
|
+
|
|
51
|
+
- Is the discriminator still defined in the base schema?
|
|
52
|
+
- Does the changed field belong to every variant or only one?
|
|
53
|
+
- Did a variant-only field accidentally leak into the shared base schema?
|
|
54
|
+
- Does config/spec/frontend behavior need to branch on the updated variant shape?
|
|
55
|
+
|
|
56
|
+
If the broader task is "add a field" rather than "repair one schema-family
|
|
57
|
+
contract", continue with `resource-add-field` after the shared-layer edit.
|
|
58
|
+
|
|
59
|
+
## Source-Backed API
|
|
60
|
+
|
|
61
|
+
Read `framework-schema-family-api.md` for the anchored `createSchemaFamily`
|
|
62
|
+
contract exposed from `@wildo-ai/saas-models`.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Shared-Layer Decorator Checklist
|
|
2
|
+
|
|
3
|
+
Use this file when you already know the field belongs in
|
|
4
|
+
`*.schemas.ts` and need to choose structural decorators deliberately.
|
|
5
|
+
|
|
6
|
+
## Common Patterns
|
|
7
|
+
|
|
8
|
+
| Field concern | Typical shared-layer decorators | Notes |
|
|
9
|
+
|---------------|---------------------------------|-------|
|
|
10
|
+
| Primary identifier | `.isPrimaryKey()` and often `.isSummaryField()` | Keep the resource identifiable in lists and references. |
|
|
11
|
+
| Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` | Common for `organizationId`, `createdByUserId`, and similar fields. |
|
|
12
|
+
| User-visible summary field | `.isSummaryField()` | Use when the field should appear in list views or FK displays. |
|
|
13
|
+
| Immutable after creation | `.excludeFromUpdate()` | Use for ownership or one-time setup fields. |
|
|
14
|
+
| Server-managed field | `.excludeFromCreate()` and often `.excludeFromUpdate()` | Typical for timestamps and values the client must not control. |
|
|
15
|
+
| Sensitive backend-only field | `.isBackendOnly()` | This is the security boundary. |
|
|
16
|
+
| Discriminator field | `.isDiscriminator()` | Required when schema-family behavior depends on the field. |
|
|
17
|
+
| Frequently queried field | `.isDBIndexed()` | Use for real query/filter/join needs, not by habit. |
|
|
18
|
+
|
|
19
|
+
## Never Confuse These
|
|
20
|
+
|
|
21
|
+
- `.isBackendOnly()` -> prevents the field from being exposed to the frontend
|
|
22
|
+
- `.isHidden()` -> presentation concern, **not** a security boundary
|
|
23
|
+
- `.isSummaryField()` -> list/reference visibility hint, **not** a substitute for UI behavior
|
|
24
|
+
|
|
25
|
+
## Quick Pattern Snippets
|
|
26
|
+
|
|
27
|
+
### Ownership / audit FK
|
|
28
|
+
|
|
29
|
+
```typescript
|
|
30
|
+
organizationId: z.string().min(1)
|
|
31
|
+
.isDBIndexed()
|
|
32
|
+
.isForeignKey()
|
|
33
|
+
.excludeFromUpdate(),
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Server-managed timestamp
|
|
37
|
+
|
|
38
|
+
```typescript
|
|
39
|
+
createdAt: z.date()
|
|
40
|
+
.default(() => new Date())
|
|
41
|
+
.excludeFromCreate()
|
|
42
|
+
.excludeFromUpdate(),
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Sensitive backend-only field
|
|
46
|
+
|
|
47
|
+
```typescript
|
|
48
|
+
apiSecret: z.string()
|
|
49
|
+
.min(1)
|
|
50
|
+
.isBackendOnly(),
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Review Questions
|
|
54
|
+
|
|
55
|
+
Before leaving the schema file, ask:
|
|
56
|
+
|
|
57
|
+
- Should clients create this field?
|
|
58
|
+
- Should clients update this field?
|
|
59
|
+
- Does the framework need to know it is a FK?
|
|
60
|
+
- Should this field appear in lists or FK references?
|
|
61
|
+
- Is this field sensitive enough to stay backend-only?
|
|
62
|
+
- Does this field change schema-family routing?
|
|
63
|
+
|
|
64
|
+
## Source-Backed API
|
|
65
|
+
|
|
66
|
+
When engine source is unavailable, read
|
|
67
|
+
`framework-shared-decorator-methods-api.md` for the actual anchored shared
|
|
68
|
+
method surface, then `framework-shared-structural-params-api.md` for the real
|
|
69
|
+
parameter contracts behind those decorators.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Special Factories
|
|
2
|
+
|
|
3
|
+
Use these helpers when the field carries domain semantics that should not be
|
|
4
|
+
flattened into a plain primitive.
|
|
5
|
+
|
|
6
|
+
## Factory Map
|
|
7
|
+
|
|
8
|
+
| Factory | Stored shape | Use when |
|
|
9
|
+
|---------|--------------|----------|
|
|
10
|
+
| `z_money(options?)` | `{ amount: bigint, currency, decimals }` | Monetary values with currency/precision semantics |
|
|
11
|
+
| `z_file(options?)` | file reference payload | File uploads or file attachments |
|
|
12
|
+
| `z_range(type, options?)` | `{ from, to }` | Number/date/time intervals |
|
|
13
|
+
| `z_duration(options?)` | `{ value, unit }` | Durations that must keep unit meaning |
|
|
14
|
+
| `z_phone(options?)` | normalized phone string | Phone numbers with dedicated formatting/validation semantics |
|
|
15
|
+
| `z_code(options?)` | `{ content, language }` | Code snippets or editable code payloads |
|
|
16
|
+
| `z_bigdecimal(options?)` | decimal string | Arbitrary precision numeric values |
|
|
17
|
+
|
|
18
|
+
## Shared-Layer Rule
|
|
19
|
+
|
|
20
|
+
These helpers still belong to the shared schema layer because they define
|
|
21
|
+
**persisted shape**. After choosing the factory, you can still chain structural
|
|
22
|
+
decorators on top:
|
|
23
|
+
|
|
24
|
+
```typescript
|
|
25
|
+
budget: z_money()
|
|
26
|
+
.isSummaryField()
|
|
27
|
+
.excludeFromUpdate(),
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Do Not Flatten Them
|
|
31
|
+
|
|
32
|
+
Avoid replacing a domain factory with a plain primitive just because it is
|
|
33
|
+
quicker. That loses framework semantics and creates extra work later in the UI,
|
|
34
|
+
spec, and runtime layers.
|
|
35
|
+
|
|
36
|
+
## Follow-Up Reminder
|
|
37
|
+
|
|
38
|
+
Choosing a special factory does **not** remove the need for downstream review.
|
|
39
|
+
If the field is user-facing or business-significant, the add-field workflow
|
|
40
|
+
still needs frontend/spec/label follow-up.
|
|
41
|
+
|
|
42
|
+
## Source-Backed API
|
|
43
|
+
|
|
44
|
+
Read `framework-special-factories-api.md` for the actual anchored factory
|
|
45
|
+
definitions exposed from the framework.
|
|
@@ -0,0 +1,389 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-ui-behavior
|
|
3
|
+
description: Author or modify `*.ui-behavior.tsx` for layouts, sections, field display/edit modes, enum chrome (`BADGE` / `SELECT` / `RADIO`), conditional visibility (`showWhen`), operation views, and action-button icons. Use when the user says "change how <field> renders", "make <enum> a badge", "hide <field> when ...", "use a radio for <field>", "give <operation> an icon", "the action buttons show a placeholder / ! icon", "rework the read/edit layout", "render <field> as markdown", "edit <field> with a markdown editor", or "show the foreign-key picker as a summary card vs a label" — i.e. when the visual contract changes but the persisted shape stays the same.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Resource UI Behavior
|
|
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
|
+
Configures **frontend resource behavior** only. The persisted shape
|
|
23
|
+
stays in `*.schemas.ts`; this file expresses how each field and
|
|
24
|
+
operation **presents** to the user (display vs edit modes, per-value
|
|
25
|
+
enum chrome, conditional visibility, layout sections, operation views).
|
|
26
|
+
|
|
27
|
+
The most common quality leak is letting visual concerns drift into the
|
|
28
|
+
schema (forbidden), or letting structural decorators sneak into the UI
|
|
29
|
+
behavior file (also forbidden). Treat this skill as the **frontend
|
|
30
|
+
boundary keeper** for a resource.
|
|
31
|
+
|
|
32
|
+
## App Paths
|
|
33
|
+
|
|
34
|
+
| Surface | Glob (relative to app root) |
|
|
35
|
+
|----------------------|------------------------------------------------------------------------------------------|
|
|
36
|
+
| UI behavior file | `frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
|
|
37
|
+
| Sibling: schema | `shared-lib/src/modules/*/resources/*/*.schemas.ts` |
|
|
38
|
+
| Sibling: operations | `shared-lib/src/modules/*/resources/*/*.resources-config.ts` |
|
|
39
|
+
| Custom view hosts | `frontend/src/modules/*/resources/*/<Resource>*View.tsx` (custom display / execution / composite) |
|
|
40
|
+
|
|
41
|
+
If layout uses a custom React view, edit it next to the behavior file
|
|
42
|
+
and reference it from the `views: [...]` map.
|
|
43
|
+
|
|
44
|
+
## When to Use
|
|
45
|
+
|
|
46
|
+
- Adding a field to the read / create / update layout
|
|
47
|
+
- Changing per-value chrome (badge color, icon) for an enum
|
|
48
|
+
- Switching display vs edit mode (e.g. `BADGE` ↔ `INLINE`, `SELECT` ↔ `RADIO`)
|
|
49
|
+
- Adding `showWhen` conditional visibility
|
|
50
|
+
- Wiring or replacing an operation view (default vs custom React)
|
|
51
|
+
- Giving an operation — or the resource itself — its action-button icon (`iconOverride` / `icon`)
|
|
52
|
+
- Reworking sections / chrome modes without touching the schema
|
|
53
|
+
- Making a long-form string field a markdown field — rich display (`StringDisplayMode.MARKDOWN`) paired with source editing (`StringEditMode.MARKDOWN`)
|
|
54
|
+
- Choosing how a foreign-key field renders — its read-view value and its reference picker's dropdown rows (one-line label vs the referenced resource's summary card)
|
|
55
|
+
- Setting a resource's instance label via `getFrontendResourceLabel` — and, for a junction/row whose name lives on a RELATED resource, referencing a `forwardedLabel` virtual field (authored in the schema; see `resource-config-wiring`) as `getFrontendResourceLabel: ['<field>']`
|
|
56
|
+
|
|
57
|
+
## When NOT to Use
|
|
58
|
+
|
|
59
|
+
- Changing DB field type, FK, or lifecycle decorators -> `resource-schema-authoring`
|
|
60
|
+
- Adding a brand-new field across all surfaces -> `resource-add-field`
|
|
61
|
+
- Rewiring operations / relationships registry -> `resource-config-wiring`
|
|
62
|
+
- Editing companion-facing business prose -> `spec-update-after-change`
|
|
63
|
+
|
|
64
|
+
## Workflow
|
|
65
|
+
|
|
66
|
+
### Step 1: Open the behavior file
|
|
67
|
+
|
|
68
|
+
**Typical:** `./frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
69
|
+
|
|
70
|
+
Use the same builder pattern (`resourceUIBehavior`, `sh`, `fieldDisplay`,
|
|
71
|
+
etc.) as sibling resources. If unsure, open the file next door and
|
|
72
|
+
mirror its top-level shape — module, helpers, `fields`, `views`,
|
|
73
|
+
`layout`, `relationshipOverrides` — and only diverge with a reason.
|
|
74
|
+
|
|
75
|
+
### Step 2: Classify the UI change
|
|
76
|
+
|
|
77
|
+
| Need | Read next |
|
|
78
|
+
|-------------------------------------|---------------------------------------------------------------------------------|
|
|
79
|
+
| Layout / sections | Mirror sibling resource structure |
|
|
80
|
+
| Operation keys / `ResourceUIBehaviorConfig` / preset map | `references/framework-frontend-resource-ui-contracts-api.md` |
|
|
81
|
+
| Enum visuals + modes | `references/framework-enum-frontend-handling-api.md` |
|
|
82
|
+
| Display vs edit mode vocabulary | `references/framework-display-edit-modes-api.md` |
|
|
83
|
+
| Conditional fields | `references/framework-conditional-visibility-api.md` |
|
|
84
|
+
| Primitive chrome | `references/framework-primitive-ui-api.md`, `references/framework-per-primitive-ui-api.md` |
|
|
85
|
+
| Foreign-key value display / picker rows | `references/framework-foreign-key-ui-api.md` |
|
|
86
|
+
|
|
87
|
+
### Step 3: Preserve layer boundaries
|
|
88
|
+
|
|
89
|
+
Read `references/ui-layer-boundaries.md`. Do not move structural
|
|
90
|
+
concerns here (lifecycle decorators, validation, persisted defaults
|
|
91
|
+
that change DTO shape, FK semantics) — those belong in the schema.
|
|
92
|
+
|
|
93
|
+
### Step 4: Sync specification
|
|
94
|
+
|
|
95
|
+
When labels or operation presentation change **meaning** (not just
|
|
96
|
+
chrome), follow `spec-update-after-change` to keep companion semantics
|
|
97
|
+
truthful.
|
|
98
|
+
|
|
99
|
+
### Step 5: Labels
|
|
100
|
+
|
|
101
|
+
User-visible new strings (field labels, enum value labels, custom view
|
|
102
|
+
copy) -> `i18n-rerun-pipeline`.
|
|
103
|
+
|
|
104
|
+
### Step 6: Give every operation (and the resource) an action-button icon
|
|
105
|
+
|
|
106
|
+
Action clusters render one icon per operation. The framework supplies a sensible
|
|
107
|
+
default for each **core** operation (CREATE / READ / LIST / UPDATE / DELETE /
|
|
108
|
+
SEARCH); **custom** operations have **no** default and render a placeholder
|
|
109
|
+
"missing icon" until you give them one.
|
|
110
|
+
|
|
111
|
+
- **Resource icon** — set `icon` on the `resourceUIBehavior(...)` config to a
|
|
112
|
+
`lucide-react` component (e.g. `icon: CheckSquare`). Every resource needs one.
|
|
113
|
+
- **Custom-operation icon** — set `iconOverride` on the operation's entry in
|
|
114
|
+
`views: [...]`, e.g.
|
|
115
|
+
`[MyOps.ARCHIVE, { isAddressable: false, iconOverride: Archive }]`.
|
|
116
|
+
- Pass a component **reference** (`iconOverride: Archive`) — never a JSX element
|
|
117
|
+
(`<Archive />`). `IconLike` is `ComponentType | string`, so a
|
|
118
|
+
`StandardIconReference` string is also valid, but a `lucide-react` component is
|
|
119
|
+
the default choice (always renders, most expressive).
|
|
120
|
+
- Pair related actions with mirrored icons (assign/unassign → `UserPlus` /
|
|
121
|
+
`UserMinus`, archive/restore → `Archive` / `ArchiveRestore`).
|
|
122
|
+
|
|
123
|
+
In development, an unconfigured operation logs a one-time
|
|
124
|
+
`[IconRegistry] Operation "<resource>:<op>" has no icon …` warning — treat any
|
|
125
|
+
such warning as a missing `iconOverride`.
|
|
126
|
+
|
|
127
|
+
### Step 7: Compose the surface with a layout template (when relevant)
|
|
128
|
+
|
|
129
|
+
Only when the generated default cannot express what the surface needs. Classify first:
|
|
130
|
+
|
|
131
|
+
| What you need | Where it goes |
|
|
132
|
+
|---|---|
|
|
133
|
+
| Something beside the record NAME — a status badge after it, an accent swatch before it | `layout.header`; the template places `<ResourceHeaderTitle />` itself |
|
|
134
|
+
| Field grouping / ordering on the detail or form surface | `layout.display` / `layout.edit` |
|
|
135
|
+
| The card + FK-popover summary | `layout.summary` |
|
|
136
|
+
| WHICH related resources appear on the detail surface, in what order | `layout.display`, placing them — see Step 7b |
|
|
137
|
+
| Nothing above applies | author no template — the generated one is the correct default |
|
|
138
|
+
|
|
139
|
+
Do NOT restate a field in two surfaces: a value shown on the header identity line
|
|
140
|
+
should leave the display strip, or the second copy reads as a different fact.
|
|
141
|
+
|
|
142
|
+
⚠️ Adding a **named** `<Section>` to any template is a three-place obligation — the
|
|
143
|
+
JSX name, the `layout.refs` manifest, and a documented spec slot with `textSlots`.
|
|
144
|
+
Missing the spec slot throws at import time. See
|
|
145
|
+
`references/framework-resource-layout-templates-api.md` before adding one.
|
|
146
|
+
|
|
147
|
+
### Step 7b: Place related resources (when the default set or order is wrong)
|
|
148
|
+
|
|
149
|
+
A parent does NOT configure how its children appear inside its own view — there
|
|
150
|
+
is no per-edge setting, and there are exactly two modes:
|
|
151
|
+
|
|
152
|
+
| Mode | You write | You get |
|
|
153
|
+
|---|---|---|
|
|
154
|
+
| **Automatic** (default) | nothing | Every owned child; 1:1 inline, collections as tabs; registration order |
|
|
155
|
+
| **Template-owned** | `<RelatedResourceSections targets={[...]} config={...} />` in `layout.display` | Exactly those children, in that order |
|
|
156
|
+
|
|
157
|
+
The switch is the ACT of placing, not a flag: place one child and the template
|
|
158
|
+
owns the whole region, so a template placing two of five shows **two**. Use
|
|
159
|
+
`targets={[]}` to say "this surface composes no children" deliberately.
|
|
160
|
+
|
|
161
|
+
Prefer `RelatedResourceSections` over hand-wiring: it takes each title from the
|
|
162
|
+
CHILD's own header label, so it adds no `layout.refs` entry, no spec slot and no
|
|
163
|
+
new label key. For one collection, `<EmbedRelatedResourceList resourceType={...} />`.
|
|
164
|
+
|
|
165
|
+
⚠️ If the host has TWO relationships to the same target, pass `viaForeignKey` —
|
|
166
|
+
without it the resolver picks an edge and renders a plausible-looking WRONG
|
|
167
|
+
collection, silently. Read
|
|
168
|
+
`references/framework-related-resource-embeds-api.md` before placing children.
|
|
169
|
+
|
|
170
|
+
### Step 8: Foreign-key reference display & picker rows (when relevant)
|
|
171
|
+
|
|
172
|
+
A foreign-key field renders in two places, both authored via `.foreignKeyUI(...)`:
|
|
173
|
+
its saved VALUE in read views (`display.mode`) and each ROW in the reference
|
|
174
|
+
picker's dropdown — the picker is shared by forms and collection filters
|
|
175
|
+
(`edit.optionDisplayMode`). Modes: `ID`, `LABEL` (one-line label, the picker
|
|
176
|
+
default), `SUMMARY` (the referenced resource's summary card, no action bar).
|
|
177
|
+
|
|
178
|
+
```ts
|
|
179
|
+
assigneeUserId: z.string().isForeignKey().foreignKeyUI({
|
|
180
|
+
edit: { optionDisplayMode: ForeignKeyDisplayMode.SUMMARY }, // dropdown rows = summary card
|
|
181
|
+
})
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
`SUMMARY` reuses the referenced resource's own summary layout — no per-picker
|
|
185
|
+
markup. See `references/framework-foreign-key-ui-api.md`.
|
|
186
|
+
|
|
187
|
+
### Step 9: Long-form markdown fields (when relevant)
|
|
188
|
+
|
|
189
|
+
For authored long-form content (bio, description, notes), pair the two markdown
|
|
190
|
+
modes on the same field:
|
|
191
|
+
|
|
192
|
+
```ts
|
|
193
|
+
display: { displayMode: StringDisplayMode.MARKDOWN },
|
|
194
|
+
edit: { editMode: StringEditMode.MARKDOWN },
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
- The persisted value stays **plain markdown source** in both modes — no schema
|
|
198
|
+
change is involved; this is a pure presentation decision.
|
|
199
|
+
- Display renders rich GFM through the theme's typography recipes; edit opens a
|
|
200
|
+
syntax-tinted markdown SOURCE editor (deliberately not a WYSIWYG). The editor
|
|
201
|
+
is lazy-loaded, so the mode costs nothing until a user actually edits.
|
|
202
|
+
- Plain `StringEditMode.TEXTAREA` remains valid for markdown-displayed fields
|
|
203
|
+
when source highlighting isn't wanted.
|
|
204
|
+
- Full mode vocabulary: `references/framework-display-edit-modes-api.md`.
|
|
205
|
+
|
|
206
|
+
## Worked Example
|
|
207
|
+
|
|
208
|
+
The `priority` enum on an application's `todos` resource shows the
|
|
209
|
+
canonical enum-with-badge pattern: explicit `displayMode`, paired
|
|
210
|
+
`edit` config, one `BadgeSemanticVariant.*` per value (no hex codes,
|
|
211
|
+
no Tailwind classes). The block below is the live source extract:
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
## Usage Example
|
|
215
|
+
|
|
216
|
+
```tsx
|
|
217
|
+
// Per-value color + icon are cross-context: the detail page renders
|
|
218
|
+
// BADGE (icon + label inside the colored badge), while `summaryOverride`
|
|
219
|
+
// switches cards / FK previews to ICON — the compact icon-only badge
|
|
220
|
+
// (label stays available to assistive tech and on hover).
|
|
221
|
+
priority: sh.priority.enumUI({
|
|
222
|
+
display: { displayMode: EnumDisplayMode.BADGE, showDescription: true },
|
|
223
|
+
summaryOverride: { displayMode: EnumDisplayMode.ICON },
|
|
224
|
+
edit: { showDescription: true },
|
|
225
|
+
values: {
|
|
226
|
+
[Todos_Priority.LOW]: { color: BadgeSemanticVariant.SECONDARY, icon: ArrowDown },
|
|
227
|
+
[Todos_Priority.MEDIUM]: { color: BadgeSemanticVariant.DEFAULT, icon: Minus },
|
|
228
|
+
[Todos_Priority.HIGH]: { color: BadgeSemanticVariant.WARNING, icon: ArrowUp },
|
|
229
|
+
[Todos_Priority.URGENT]: { color: BadgeSemanticVariant.DESTRUCTIVE, icon: AlertTriangle },
|
|
230
|
+
},
|
|
231
|
+
}),
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
Why this is the reference shape:
|
|
235
|
+
|
|
236
|
+
- `display.displayMode: EnumDisplayMode.BADGE` is the **explicit choice**
|
|
237
|
+
required for enums — no silent default.
|
|
238
|
+
- `values: { [Todos_Priority.X]: { color: BadgeSemanticVariant.Y } }`
|
|
239
|
+
uses the framework enum, not a hex code or class string. This keeps
|
|
240
|
+
the badge style consistent with the design system theme.
|
|
241
|
+
- `edit` is configured side-by-side; the user can toggle `editMode` to
|
|
242
|
+
`RADIO` or `SEGMENTED` without touching anywhere else.
|
|
243
|
+
- `showDescription: true` is set in both `display` and `edit` —
|
|
244
|
+
keep the choice symmetric unless there is product reason to diverge.
|
|
245
|
+
|
|
246
|
+
For the matching schema declaration see
|
|
247
|
+
`resource-add-field/examples/add-priority-field-to-todos.example.md`.
|
|
248
|
+
|
|
249
|
+
### Operation icons
|
|
250
|
+
|
|
251
|
+
The same `todos` resource gives every custom operation an explicit `iconOverride`
|
|
252
|
+
while leaving the core operations to inherit framework defaults:
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
## Usage Example
|
|
256
|
+
|
|
257
|
+
```tsx
|
|
258
|
+
// Action-button icons. Core operations (CREATE/READ/LIST/UPDATE/DELETE/SEARCH)
|
|
259
|
+
// inherit sensible default icons from the framework, so they need no
|
|
260
|
+
// `iconOverride`. Custom operations have NO default — each one must declare an
|
|
261
|
+
// `iconOverride` (a lucide-react component *reference*, not a `<JSX />` element)
|
|
262
|
+
// or it renders the placeholder "missing icon". Pair related actions with
|
|
263
|
+
// mirrored icons (assign/unassign, recurring/one-time).
|
|
264
|
+
views: [
|
|
265
|
+
// Create is an OVERLAY (the "new" affordance opens a modal; the URL stays on
|
|
266
|
+
// the collection). It is intentionally NON-addressable: core CREATE adds no
|
|
267
|
+
// URL segment, so an addressable create would resolve to the bare collection
|
|
268
|
+
// path `…/todos` and collide with LIST — shadowing the listing on refresh.
|
|
269
|
+
[Op.CREATE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
270
|
+
[Op.READ, {
|
|
271
|
+
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
272
|
+
customView: TodoReadCustomView,
|
|
273
|
+
}],
|
|
274
|
+
[Op.LIST, {
|
|
275
|
+
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
276
|
+
// Dogfood the collection capabilities: selectable cards/table surface the
|
|
277
|
+
// bulk operations declared on the todos config (change-status, assign,
|
|
278
|
+
// delete, …) via the shared bulk bar; per-card actions sit in the top-end
|
|
279
|
+
// corner instead of the mid-row default.
|
|
280
|
+
collectionDisplayConfig: {
|
|
281
|
+
selectable: true,
|
|
282
|
+
cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END },
|
|
283
|
+
},
|
|
284
|
+
}],
|
|
285
|
+
[Op.SEARCH, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
286
|
+
[Op.UPDATE, { surface: ResourceOperationFrontendSurface.ADDRESSABLE }],
|
|
287
|
+
[Op.DELETE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
288
|
+
[Todos_Operations.CHANGE_STATUS, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: CircleDot }],
|
|
289
|
+
[Todos_Operations.ASSIGN, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: UserPlus }],
|
|
290
|
+
[Todos_Operations.UNASSIGN, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: UserMinus }],
|
|
291
|
+
[Todos_Operations.SET_AS_RECURRING, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Repeat }],
|
|
292
|
+
[Todos_Operations.SET_AS_ONE_TIME, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Repeat1 }],
|
|
293
|
+
],
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
- Core ops (`Op.CREATE`, `Op.READ`, …) carry no `iconOverride` — they inherit the
|
|
297
|
+
framework's per-core-operation default icon, so they never show the placeholder.
|
|
298
|
+
- Every custom op (`Todos_Operations.*`) declares an `iconOverride` `lucide-react`
|
|
299
|
+
component **reference**, so the action cluster shows a meaningful glyph.
|
|
300
|
+
- The resource-level `icon: CheckSquare` (top of the same `resourceUIBehavior`
|
|
301
|
+
config) is the resource's own identity icon.
|
|
302
|
+
|
|
303
|
+
## References
|
|
304
|
+
|
|
305
|
+
- `references/framework-frontend-resource-ui-contracts-api.md` — source-backed `OperationKey`, operation config, `ResourceUIBehaviorConfig`
|
|
306
|
+
- `references/ui-layer-boundaries.md` — shared vs frontend split
|
|
307
|
+
- `references/framework-display-edit-modes-api.md` — source-backed modes
|
|
308
|
+
- `references/framework-enum-frontend-handling-api.md` — source-backed enum UI
|
|
309
|
+
- `references/framework-conditional-visibility-api.md` — source-backed `showWhen`
|
|
310
|
+
- `references/framework-primitive-ui-api.md` — source-backed primitive UI base
|
|
311
|
+
- `references/framework-per-primitive-ui-api.md` — source-backed per-type UI
|
|
312
|
+
- `references/framework-foreign-key-ui-api.md` — source-backed FK reference display & picker row modes (`LABEL` / `SUMMARY`)
|
|
313
|
+
- `references/framework-resource-layout-templates-api.md` — source-backed `layout.{edit,display,summary,header}`, the `layout.refs` manifest, and `<ResourceHeaderTitle />`
|
|
314
|
+
- `references/framework-related-resource-embeds-api.md` — source-backed `RelatedResourceSections`, the `EmbedRelated*` family, `viaForeignKey` edge disambiguation, preview, and descent bounding
|
|
315
|
+
|
|
316
|
+
## Verification
|
|
317
|
+
|
|
318
|
+
- [ ] No structural decorators added; the schema file is unchanged unless the change was coordinated through `resource-schema-authoring`
|
|
319
|
+
- [ ] Every enum field has explicit `display.displayMode` AND a `values: { ... }` map (no silent default rendering)
|
|
320
|
+
- [ ] Per-value enum chrome uses framework enums (`BadgeSemanticVariant`, etc.) — no hex codes or Tailwind classes
|
|
321
|
+
- [ ] `showWhen` rules use only operators listed in `references/framework-conditional-visibility-api.md`
|
|
322
|
+
- [ ] Every operation referenced by `views: [...]` exists in this resource's `*.resources-config.ts`
|
|
323
|
+
- [ ] The resource sets `icon` (a `lucide-react` component) on its `resourceUIBehavior(...)` config
|
|
324
|
+
- [ ] Every **custom** operation in `views: [...]` sets `iconOverride` (a component reference — not a `<JSX />` element); core operations may omit it (they inherit defaults)
|
|
325
|
+
- [ ] If a foreign-key picker should show summary cards, the FK field sets `edit.optionDisplayMode: ForeignKeyDisplayMode.SUMMARY` via `.foreignKeyUI(...)` (default is the one-line `LABEL`)
|
|
326
|
+
- [ ] Every `RelatedResourceSections` / `EmbedRelated*` target whose host has TWO relationships to that same resource passes `viaForeignKey` (otherwise a silently wrong collection renders)
|
|
327
|
+
- [ ] No child is placed in a template AND expected to also appear automatically — placing one child means the template owns the whole child region
|
|
328
|
+
- [ ] User-visible new strings have label keys queued for `i18n-rerun-pipeline`
|
|
329
|
+
- [ ] Dev watcher (TypeScript) is green across `app` and `shared-lib`
|
|
330
|
+
|
|
331
|
+
### Grep invariants
|
|
332
|
+
|
|
333
|
+
Run from the app root and substitute the resource path:
|
|
334
|
+
|
|
335
|
+
| Invariant | Command |
|
|
336
|
+
|----------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
|
|
337
|
+
| No raw color strings in enum chrome | `rg -n "color:\s*['\"]#" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
338
|
+
| No Tailwind class smuggling | `rg -n "className:\s*['\"](bg-\|text-\|border-)" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
339
|
+
| Every UI field exists in the schema | `comm -23 <(rg -oN "^\s*(\w+):\s*sh\." frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u) <(rg -oN "^\s*(\w+):\s*z\." shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u)` |
|
|
340
|
+
| No `isForeignKey` / `isDBIndexed` / `excludeFrom*` accidentally added here | `rg -n "isForeignKey\|isDBIndexed\|excludeFrom" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
341
|
+
|
|
342
|
+
Related-resource placement invariants:
|
|
343
|
+
|
|
344
|
+
| Invariant | Command |
|
|
345
|
+
|---|---|
|
|
346
|
+
| Every placed target that needs edge disambiguation has it — list placements, then check each `resourceType` against the host's relationships | `rg -n "resourceType:\s*'[^']+'" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` then `rg -n "<target>" shared-lib/src/modules/*/resources/*/*.resources-config.ts` — two hits for one target means `viaForeignKey` is REQUIRED |
|
|
347
|
+
| No named `<Section>` hand-wired around children (re-incurs the three-place obligation `RelatedResourceSections` avoids) | `rg -n "<Section[^>]*name=" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
348
|
+
|
|
349
|
+
Icon invariants (same resource-path substitution):
|
|
350
|
+
|
|
351
|
+
- Custom op missing an `iconOverride` (should be empty): `rg -nP "[A-Za-z]+_Operations\.[A-Z_]+,\s*\{(?:(?!iconOverride)[^}])*\}\]" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
352
|
+
- `iconOverride` passed as JSX instead of a component reference (should be empty): `rg -n "iconOverride:\s*<" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
353
|
+
|
|
354
|
+
## Common Rationalizations
|
|
355
|
+
|
|
356
|
+
| Rationalization | Reality |
|
|
357
|
+
|--------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
358
|
+
| "Default enum rendering is fine" | The framework requires explicit UI choices for enums in Wildo apps; an unconfigured enum is a UX defect, not a graceful fallback. |
|
|
359
|
+
| "I'll just use a hex code / Tailwind class for this badge color" | Per-value chrome must come from `BadgeSemanticVariant` (or the matching framework enum); raw colors break theming and dark mode. |
|
|
360
|
+
| "I'll copy the layout from another module without checking operations" | Operation ids referenced under `views: [...]` must exist in **this** resource's `*.resources-config.ts`; copy-paste silently breaks routing. |
|
|
361
|
+
| "Adding `excludeFromUpdate` here is faster than touching the schema" | Lifecycle and DTO shape decorators are structural — they belong in the schema, not in UI behavior. Putting them here drifts the persisted contract.|
|
|
362
|
+
| "I'll set a flag on the relationship to hide this child from the parent view" | There is no such flag — per-edge composition config was deleted. Place the children you want; the ones you did not place do not render. |
|
|
363
|
+
| "I only want to reorder one child, so I'll place just that one" | Placing ANY child makes the template own the whole region. Place all the children that surface should show, in the order it should show them. |
|
|
364
|
+
| "`resourceType` is enough to identify the child collection" | Not when the host has two relationships to that resource. The resolver picks an edge and renders a plausible-looking WRONG collection, silently. |
|
|
365
|
+
|
|
366
|
+
## Red Flags
|
|
367
|
+
|
|
368
|
+
- UI references a field absent from the schema (catch with the "every UI field exists in schema" grep above)
|
|
369
|
+
- An enum field has no explicit `displayMode` or no `values: { ... }` map (silent default rendering)
|
|
370
|
+
- Per-value chrome uses a hex code or `className: 'bg-...'` instead of `BadgeSemanticVariant.*` (catch with the "no raw color strings" / "no Tailwind class smuggling" greps)
|
|
371
|
+
- `showWhen` uses guessed operators not listed in `references/framework-conditional-visibility-api.md`
|
|
372
|
+
- `views: [...]` references an operation that does not exist in `*.resources-config.ts`
|
|
373
|
+
- Lifecycle / structural decorators (`isForeignKey`, `excludeFromUpdate`, …) appear in the UI behavior file (catch with the "no structural decorators here" grep)
|
|
374
|
+
- New user-visible strings landed without queueing `i18n-rerun-pipeline`
|
|
375
|
+
- A foreign-key picker is expected to show summary cards but the FK field has no `edit.optionDisplayMode` (it silently renders one-line labels)
|
|
376
|
+
- A custom operation in `views: [...]` has no `iconOverride` — it renders the placeholder "missing icon" (catch with the "custom op missing an iconOverride" grep above)
|
|
377
|
+
- A placed target whose host has two relationships to that resource has no `viaForeignKey` — a wrong collection renders with no error (catch with the "edge disambiguation" grep above)
|
|
378
|
+
- A template places some children and the author still expects the rest to appear automatically — placing one means owning all (catch by comparing the placed `targets` against the resource's owned relationships)
|
|
379
|
+
- A hand-wired named `<Section>` wraps children instead of using `RelatedResourceSections` — re-incurs the three-place obligation, and a missing spec slot throws at import (catch with the "no named Section" grep above)
|
|
380
|
+
- `iconOverride` is written as a JSX element (`<Icon />`) instead of a component reference (catch with the "iconOverride passed as JSX" grep above) — `IconLike` is `ComponentType | string`, so pass `Icon`, not `<Icon />`
|
|
381
|
+
|
|
382
|
+
## Related Skills
|
|
383
|
+
|
|
384
|
+
- `resource-schema-authoring` — shared-layer schema work
|
|
385
|
+
- `resource-config-wiring` — relationships / operations / config registry; also the `forwardedLabel` recipe (label a junction/row by a related resource's fields)
|
|
386
|
+
- `resource-add-field` — end-to-end "add this field" orchestrator
|
|
387
|
+
- `spec-update-after-change` — companion-facing semantics
|
|
388
|
+
- `i18n-rerun-pipeline` — translation and label workflow
|
|
389
|
+
- `views-add-custom-view` — when default view chrome is not enough
|