@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,738 @@
|
|
|
1
|
+
# Framework — relationship semantics & authoring (saas-models)
|
|
2
|
+
|
|
3
|
+
Source-backed excerpts for `RelationshipNature`, handling models, Zod relationship schema, TypeScript declaration/runtime types, `createResourcesRelationship()` builder parameters, and the write-time scope-confinement contract (`scopeMembership` + `referenceConstraints`).
|
|
4
|
+
|
|
5
|
+
Read this when you need the exact authoring surface — which fields exist, what they accept, and which of them confine a foreign key at write time.
|
|
6
|
+
|
|
7
|
+
## Import Origins
|
|
8
|
+
|
|
9
|
+
- `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
## Source Excerpts
|
|
12
|
+
|
|
13
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
14
|
+
|
|
15
|
+
```typescript
|
|
16
|
+
*
|
|
17
|
+
* High-level semantic kind of relationship.
|
|
18
|
+
*
|
|
19
|
+
* This is the primary shared meaning. Resolver/runtime layers may later derive
|
|
20
|
+
* engine-facing handling from it, but the declaration should start here rather
|
|
21
|
+
* than from low-level DTO or lifecycle toggles.
|
|
22
|
+
*
|
|
23
|
+
* Developer-facing interpretation:
|
|
24
|
+
*
|
|
25
|
+
* - `COMPOSITION`
|
|
26
|
+
* The parent owns an aggregate boundary around the child. The relationship is
|
|
27
|
+
* about parent-managed nested resources. Child lifecycle is typically
|
|
28
|
+
* dependent on the parent, and nested create/update/delete is the natural UX.
|
|
29
|
+
*
|
|
30
|
+
* - `REFERENCE`
|
|
31
|
+
* The current resource points to another independent resource. The default UX
|
|
32
|
+
* is "select existing / clear / navigate". A future "quick create" shortcut
|
|
33
|
+
* may exist, but it still means "create independent resource, then set the
|
|
34
|
+
* reference" rather than aggregate-managed nested creation.
|
|
35
|
+
*
|
|
36
|
+
* - `ASSOCIATION`
|
|
37
|
+
* The current resource is linked to peer resources through membership/link
|
|
38
|
+
* semantics. The default UX is "link / unlink / replace peer set". A future
|
|
39
|
+
* "quick create" shortcut may exist, but it still means "create independent
|
|
40
|
+
* peer, then link it" rather than treating the peer as an owned child.
|
|
41
|
+
*
|
|
42
|
+
* Important rule:
|
|
43
|
+
* - "quick create" is a frontend workflow capability layered on top of a
|
|
44
|
+
* relationship, not a fourth relationship nature.
|
|
45
|
+
*/
|
|
46
|
+
export enum RelationshipNature {
|
|
47
|
+
COMPOSITION = 'composition',
|
|
48
|
+
REFERENCE = 'reference',
|
|
49
|
+
ASSOCIATION = 'association',
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Parent-surface DTO model implied by relationship semantics.
|
|
54
|
+
*
|
|
55
|
+
* This tells the framework what kind of shape the parent-facing interaction
|
|
56
|
+
* should expose:
|
|
57
|
+
* - `NESTED_RESOURCE` → full nested child payloads
|
|
58
|
+
* - `REFERENCE_HANDLE` → handle/pointer semantics to an independent resource
|
|
59
|
+
* - `ASSOCIATION_HANDLE` → peer membership/link semantics
|
|
60
|
+
*/
|
|
61
|
+
export enum RelationshipDtoModel {
|
|
62
|
+
NESTED_RESOURCE = 'nested_resource',
|
|
63
|
+
REFERENCE_HANDLE = 'reference_handle',
|
|
64
|
+
ASSOCIATION_HANDLE = 'association_handle',
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Parent-driven mutation semantics for the relationship.
|
|
69
|
+
*
|
|
70
|
+
* Interpretation:
|
|
71
|
+
* - `AGGREGATE_MANAGED` → parent can orchestrate nested child CRUD
|
|
72
|
+
* - `REFERENCE_MANAGED` → parent mutates only the reference handle/pointer
|
|
73
|
+
* - `ASSOCIATION_MANAGED` → parent mutates membership/link state to peers
|
|
74
|
+
* - `NONE` → no parent-driven relationship-object mutation contract
|
|
75
|
+
*/
|
|
76
|
+
export enum RelationshipMutationModel {
|
|
77
|
+
AGGREGATE_MANAGED = 'aggregate_managed',
|
|
78
|
+
REFERENCE_MANAGED = 'reference_managed',
|
|
79
|
+
ASSOCIATION_MANAGED = 'association_managed',
|
|
80
|
+
NONE = 'none',
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Lifecycle dependency semantics between the parent and the related element.
|
|
85
|
+
*
|
|
86
|
+
* This is about dependency, not frontend chrome:
|
|
87
|
+
* - `DEPENDENT` → child lifecycle follows parent ownership
|
|
88
|
+
* - `INDEPENDENT` → related resource lives independently
|
|
89
|
+
* - `LINK_ONLY` → only the relationship membership/link is owned here
|
|
90
|
+
*/
|
|
91
|
+
export enum RelationshipLifecycleModel {
|
|
92
|
+
DEPENDENT = 'dependent',
|
|
93
|
+
INDEPENDENT = 'independent',
|
|
94
|
+
LINK_ONLY = 'link_only',
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* Shared read intent for the relationship.
|
|
99
|
+
*
|
|
100
|
+
* Important: this is NOT the same semantic plane as `DataMode`,
|
|
101
|
+
* `ContextPolicy_ObjectMode`, or `childOperations.nested.onRead`.
|
|
102
|
+
* It is the high-level engine-facing read intent that later resolver steps may
|
|
103
|
+
* project into those operational surfaces where the meaning is truly identical.
|
|
104
|
+
*
|
|
105
|
+
* Interpretation:
|
|
106
|
+
* - `EMBEDDED` → read as an owned nested child/children
|
|
107
|
+
* - `REFERENCE_ONLY` → read as a pointer/reference surface
|
|
108
|
+
* - `ASSOCIATION_EMBEDDED` → read as associated peers, while preserving peer
|
|
109
|
+
* semantics rather than collapsing them into composition
|
|
110
|
+
*/
|
|
111
|
+
export enum RelationshipReadModel {
|
|
112
|
+
EMBEDDED = 'embedded',
|
|
113
|
+
REFERENCE_ONLY = 'reference_only',
|
|
114
|
+
ASSOCIATION_EMBEDDED = 'association_embedded',
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
## Import Origins
|
|
118
|
+
|
|
119
|
+
- `@wildo-ai/saas-models`
|
|
120
|
+
|
|
121
|
+
## Source Excerpts
|
|
122
|
+
|
|
123
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
124
|
+
|
|
125
|
+
```typescript
|
|
126
|
+
*
|
|
127
|
+
* Explicit semantic read contract for a relationship.
|
|
128
|
+
*
|
|
129
|
+
* This answers the semantic question "how should this relationship read?" and
|
|
130
|
+
* intentionally stays separate from the low-level nested projection in
|
|
131
|
+
* `childOperations.nested.onRead`, which still carries payload-shaping details
|
|
132
|
+
* like `dataMode`, list behavior, limits, and sort order.
|
|
133
|
+
*/
|
|
134
|
+
export const RelationshipHandlingReadSettingsSchema = z.object({
|
|
135
|
+
model: z.enum(RelationshipReadModel),
|
|
136
|
+
});
|
|
137
|
+
export type RelationshipHandlingReadSettings = z.infer<typeof RelationshipHandlingReadSettingsSchema>;
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Narrow mutation refinements under the semantic handling contract.
|
|
141
|
+
*
|
|
142
|
+
* These are still low-level operational hints, not a replacement for
|
|
143
|
+
* `nature` or the top-level handling models.
|
|
144
|
+
*/
|
|
145
|
+
export const RelationshipHandlingMutationSettingsSchema = z.object({
|
|
146
|
+
allowParentCreate: z.boolean().optional(),
|
|
147
|
+
allowParentUpdate: z.boolean().optional(),
|
|
148
|
+
allowParentDelete: z.boolean().optional(),
|
|
149
|
+
maxDepth: z.number().int().min(0).optional(),
|
|
150
|
+
});
|
|
151
|
+
export type RelationshipHandlingMutationSettings = z.infer<typeof RelationshipHandlingMutationSettingsSchema>;
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Narrow lifecycle refinements under the semantic handling contract.
|
|
155
|
+
*/
|
|
156
|
+
export const RelationshipHandlingLifecycleOnParentDeleteSettingsSchema = z.object({
|
|
157
|
+
enabled: z.boolean().optional(),
|
|
158
|
+
/** Execution TIMING of the cascade (IMMEDIATE / LAZY) — orthogonal to `strategy`. */
|
|
159
|
+
mode: z.enum(ChildLifecycleMode).optional(),
|
|
160
|
+
/**
|
|
161
|
+
* What the cascade DOES to the child — hard-delete vs impersonalize-and-retain (scrub the personal
|
|
162
|
+
* fields, keep the row for a legal/audit obligation). Carried on the derived semantic contract so a
|
|
163
|
+
* consumer reading `handling.lifecycle.onParentDelete` can tell the two apart; omitting it here
|
|
164
|
+
* would merge two semantically distinct teardowns, which is exactly what splitting this axis from
|
|
165
|
+
* `mode` exists to prevent.
|
|
166
|
+
*/
|
|
167
|
+
strategy: z.enum(ChildLifecycleStrategy).optional(),
|
|
168
|
+
maxDepth: z.number().int().min(0).optional(),
|
|
169
|
+
});
|
|
170
|
+
export type RelationshipHandlingLifecycleOnParentDeleteSettings = z.infer<typeof RelationshipHandlingLifecycleOnParentDeleteSettingsSchema>;
|
|
171
|
+
|
|
172
|
+
export const RelationshipHandlingLifecycleSettingsSchema = z.object({
|
|
173
|
+
onParentDelete: RelationshipHandlingLifecycleOnParentDeleteSettingsSchema.optional(),
|
|
174
|
+
});
|
|
175
|
+
export type RelationshipHandlingLifecycleSettings = z.infer<typeof RelationshipHandlingLifecycleSettingsSchema>;
|
|
176
|
+
```
|
|
177
|
+
## Import Origins
|
|
178
|
+
|
|
179
|
+
- `@wildo-ai/saas-models`
|
|
180
|
+
|
|
181
|
+
## Source Excerpts
|
|
182
|
+
|
|
183
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
184
|
+
|
|
185
|
+
```typescript
|
|
186
|
+
*
|
|
187
|
+
* Fully resolved relationship handling contract.
|
|
188
|
+
*
|
|
189
|
+
* This describes the engine-facing semantic handling after `nature` has been
|
|
190
|
+
* resolved. The `read` block is the semantic source of truth, while
|
|
191
|
+
* `childOperations.nested.onRead` remains the low-level operational projection
|
|
192
|
+
* for payload shaping.
|
|
193
|
+
*/
|
|
194
|
+
export const RelationshipHandlingContractSchema = z.object({
|
|
195
|
+
dtoModelMode: z.enum(RelationshipDtoModel),
|
|
196
|
+
mutationModelMode: z.enum(RelationshipMutationModel),
|
|
197
|
+
lifecycleModelMode: z.enum(RelationshipLifecycleModel),
|
|
198
|
+
readModelMode: z.enum(RelationshipReadModel),
|
|
199
|
+
read: RelationshipHandlingReadSettingsSchema,
|
|
200
|
+
mutation: RelationshipHandlingMutationSettingsSchema.optional(),
|
|
201
|
+
lifecycle: RelationshipHandlingLifecycleSettingsSchema.optional(),
|
|
202
|
+
});
|
|
203
|
+
export type RelationshipHandlingContract = z.infer<typeof RelationshipHandlingContractSchema>;
|
|
204
|
+
```
|
|
205
|
+
## Import Origins
|
|
206
|
+
|
|
207
|
+
- `@wildo-ai/saas-models`
|
|
208
|
+
|
|
209
|
+
## Source Excerpts
|
|
210
|
+
|
|
211
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
212
|
+
|
|
213
|
+
```typescript
|
|
214
|
+
*
|
|
215
|
+
* Serializable relationship declaration fields validated at registry build.
|
|
216
|
+
*/
|
|
217
|
+
export const ResourceRelationshipSchema = z.object({
|
|
218
|
+
cardinality1: z.enum(ResourceRelationshipCardinality),
|
|
219
|
+
cardinality2: z.enum(ResourceRelationshipCardinality),
|
|
220
|
+
resourceType1: ResourceTypeSchema,
|
|
221
|
+
resourceType2: ResourceTypeSchema,
|
|
222
|
+
accessScopeStrategy: z.enum(ResourceRelationshipAccessScopeStrategy).default(ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT),
|
|
223
|
+
parentResourceRequirement: z.enum(ResourceParentResourceRequirement).default(ResourceParentResourceRequirement.MANDATORY),
|
|
224
|
+
jointResourceType : ResourceTypeSchema.optional(),
|
|
225
|
+
isPrimaryScope : z.boolean().optional().default(false),
|
|
226
|
+
primaryScope : z.enum(ResourcePrimaryScope).optional(),
|
|
227
|
+
/**
|
|
228
|
+
* Opt-in flag for relationships that form cycles in the resource graph.
|
|
229
|
+
* When `true`, schema-level cycle detection (at registration) allows this edge.
|
|
230
|
+
* Applies to all cycle types: direct self-reference (A→A), M:N self-reference
|
|
231
|
+
* (A↔A via junction), and edges participating in transitive cycles (A→B→C→A).
|
|
232
|
+
*
|
|
233
|
+
* Default `false` — cycles are rejected at registration unless every edge
|
|
234
|
+
* in the cycle has `allowCycle: true`.
|
|
235
|
+
*/
|
|
236
|
+
allowCycle : z.boolean().optional().default(false),
|
|
237
|
+
isDisabled : z.boolean().optional().default(false),
|
|
238
|
+
|
|
239
|
+
// Context policy for this relationship - controls how related resources are fetched
|
|
240
|
+
contextPolicy: RelationshipContextPolicySchema.optional(),
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* High-level shared meaning of the relationship.
|
|
244
|
+
*
|
|
245
|
+
* Greenfield direction:
|
|
246
|
+
* - `nature` remains the primary semantic field app developers author.
|
|
247
|
+
* - `read` is the explicit semantic read intent when the default read meaning
|
|
248
|
+
* derived from low-level nested projection is not precise enough.
|
|
249
|
+
* - The framework derives its internal handling contract from that semantic
|
|
250
|
+
* declaration plus structural topology.
|
|
251
|
+
*
|
|
252
|
+
*/
|
|
253
|
+
nature: z.enum(RelationshipNature),
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* Explicit semantic read contract for this relationship.
|
|
257
|
+
*
|
|
258
|
+
* This is the authored read intent. It does NOT replace
|
|
259
|
+
* `childOperations.nested.onRead`, which still carries the low-level nested
|
|
260
|
+
* response projection details when embedding is operationally enabled.
|
|
261
|
+
*/
|
|
262
|
+
read: RelationshipHandlingReadSettingsSchema.optional(),
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* Child operations configuration for this relationship.
|
|
266
|
+
* Handles BACKEND concerns: lifecycle cascade and nested DTO aggregation.
|
|
267
|
+
*
|
|
268
|
+
* - lifecycle.onParentDelete: Delete children when parent is deleted
|
|
269
|
+
* - nested.onRead: Include children in parent READ response
|
|
270
|
+
* - nested.onCreate/onUpdate: Allow child mutations in parent requests
|
|
271
|
+
*/
|
|
272
|
+
childOperations: ChildOperationsConfigSchema.optional(),
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Static discriminator filter for conditional relationships.
|
|
276
|
+
* When specified, this relationship only applies when the PARENT resource's
|
|
277
|
+
* discriminator field matches one of the specified values.
|
|
278
|
+
*
|
|
279
|
+
* This field is part of the Zod schema (serializable). For arbitrary function-based
|
|
280
|
+
* conditions, use the `condition` field on the `ResourceRelationship` TypeScript type
|
|
281
|
+
* (which extends this schema via intersection).
|
|
282
|
+
*
|
|
283
|
+
* Runtime evaluation uses the shared
|
|
284
|
+
* `Resources_SharedUtils.matchesRelationshipDiscriminator()` helper, which
|
|
285
|
+
* applies `String()` coercion:
|
|
286
|
+
* `values.includes(String(parent[discriminatorField]))`.
|
|
287
|
+
*
|
|
288
|
+
* @see ResourceRelationshipDiscriminatorSchema — for the full schema definition
|
|
289
|
+
* @see ResourceRelationship — for the full type including the `condition` function
|
|
290
|
+
*
|
|
291
|
+
* @example Recurring todos have occurrences, one-time todos don't:
|
|
292
|
+
* { discriminatorField: 'recurringType', values: ['RECURRING'] }
|
|
293
|
+
*/
|
|
294
|
+
discriminator: ResourceRelationshipDiscriminatorSchema.optional(),
|
|
295
|
+
|
|
296
|
+
/**
|
|
297
|
+
* Frontend relationship presentation configuration.
|
|
298
|
+
*
|
|
299
|
+
* This remains on the frontend/UI plane:
|
|
300
|
+
* - read composition in parent/child views
|
|
301
|
+
* - narrow interaction hints such as `interaction.allowQuickCreate`
|
|
302
|
+
*
|
|
303
|
+
* It must NOT redefine the core meaning of the relationship. In particular,
|
|
304
|
+
* `display.interaction.allowQuickCreate` is only a workflow shortcut hint:
|
|
305
|
+
* - for `REFERENCE`: "create independent resource, then set reference"
|
|
306
|
+
* - for `ASSOCIATION`: "create independent peer, then link/replace"
|
|
307
|
+
* - for `COMPOSITION`: usually ignored because nested creation is already the
|
|
308
|
+
* native aggregate workflow
|
|
309
|
+
*
|
|
310
|
+
* Labels remain managed by the i18n mechanism.
|
|
311
|
+
*/
|
|
312
|
+
display: RelationshipDisplayConfigSchema.optional(),
|
|
313
|
+
|
|
314
|
+
/**
|
|
315
|
+
* Foreign key field name for this relationship.
|
|
316
|
+
*
|
|
317
|
+
* When omitted: Inferred from parent's resourceFieldIdentifier via allResourceFieldIdentifiers map.
|
|
318
|
+
* When specified: Used for disambiguation when multiple FKs point to same resource type,
|
|
319
|
+
* or when FK field name differs from standard naming convention.
|
|
320
|
+
*
|
|
321
|
+
* Examples:
|
|
322
|
+
* - Standard: ORGANIZATIONS → TODOS uses organizationId (inferred)
|
|
323
|
+
* - Disambiguation: TODOS → USERS via assignedToUserId vs createdByUserId (explicit)
|
|
324
|
+
* - M:N self-reference: TODOS → TODOS via junction table uses todoId/targetTodoId (explicit)
|
|
325
|
+
*/
|
|
326
|
+
foreignKeyField: z.string().optional(),
|
|
327
|
+
|
|
328
|
+
/**
|
|
329
|
+
* Scope-via-junction tag (scope-required reference search).
|
|
330
|
+
*
|
|
331
|
+
* Set ONLY on the synthetic `S → T` edge the M:N expansion adds so a target
|
|
332
|
+
* `T` (e.g. `users`) becomes addressable under a scope `S` (e.g.
|
|
333
|
+
* `organizations`) for SEARCH/LIST — e.g.
|
|
334
|
+
* `GET /organizations/{organizationId}/users/search`. Names the junction `J`
|
|
335
|
+
* (e.g. `organizationMembers`) the scope is resolved through. `T` carries NO
|
|
336
|
+
* real foreign-key column for `S`, so the backend contextual filter scopes via
|
|
337
|
+
* a junction subquery (`T._id ∈ { J.targetFk : J.scopeFk = S_id }`) and
|
|
338
|
+
* authorization keys off `S`-membership instead of `T`'s own primary scope.
|
|
339
|
+
* Absent on every normal relationship.
|
|
340
|
+
*
|
|
341
|
+
* NOTE: this is a READ/SEARCH-side tag on a synthetic scope-anchored edge. To constrain a WRITE — a
|
|
342
|
+
* real reference FK must point at a member of the writer's scope — declare {@link scopeMembership},
|
|
343
|
+
* NOT this field.
|
|
344
|
+
*/
|
|
345
|
+
scopeViaJunction: ResourceTypeSchema.optional(),
|
|
346
|
+
|
|
347
|
+
/**
|
|
348
|
+
* Write-time SCOPE CONFINEMENT for this reference FK — the STRUCTURE half (see
|
|
349
|
+
* {@link ScopeMembershipSchema}).
|
|
350
|
+
*
|
|
351
|
+
* Opt-in and additive: absent ⇒ unchanged existence-only behavior. `scopeMembership: true` requires
|
|
352
|
+
* the referenced target to be linked to the writing row's scope through the auto-resolved junction;
|
|
353
|
+
* the object form names the junction / columns when convention cannot (self-referential junctions).
|
|
354
|
+
* Enforced on CREATE and UPDATE by the adapter-neutral write-integrity authority; a non-member /
|
|
355
|
+
* cross-tenant reference is refused with `404`, leaking nothing.
|
|
356
|
+
*
|
|
357
|
+
* POLICY (status, roles, junction-field / target-row constraints, or disabling) is NOT declared here —
|
|
358
|
+
* it varies per operation variant and lives on the operation config as `referenceConstraints`
|
|
359
|
+
* (see {@link ReferenceScopeConstraintSchema}), beside the caller-side `roles`.
|
|
360
|
+
*/
|
|
361
|
+
scopeMembership: ScopeMembershipSchema.optional(),
|
|
362
|
+
|
|
363
|
+
/**
|
|
364
|
+
* Restricts which core operations' URLs this relationship contributes to.
|
|
365
|
+
*
|
|
366
|
+
* When set, the URL builder emits this parent edge ONLY for the listed core
|
|
367
|
+
* operations (e.g. `[SEARCH, LIST]`). Used by the scope-via-junction edge so it
|
|
368
|
+
* produces `/{scope}/{target}/search|list` without leaking onto
|
|
369
|
+
* READ/CREATE/UPDATE/DELETE routes — a peer-under-scope path is a read-only
|
|
370
|
+
* access pattern. Absent ⇒ the edge contributes to every operation's URLs.
|
|
371
|
+
*/
|
|
372
|
+
urlOperationScope: z.array(z.enum(CoreResourceOperation)).optional(),
|
|
373
|
+
});
|
|
374
|
+
```
|
|
375
|
+
## Import Origins
|
|
376
|
+
|
|
377
|
+
- `@wildo-ai/saas-models`
|
|
378
|
+
|
|
379
|
+
## Source Excerpts
|
|
380
|
+
|
|
381
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
382
|
+
|
|
383
|
+
```typescript
|
|
384
|
+
*
|
|
385
|
+
* Condition function, resolved semantics contract (factory output shape).
|
|
386
|
+
*/
|
|
387
|
+
/**
|
|
388
|
+
* Function-based condition for conditional relationships.
|
|
389
|
+
* Evaluated at runtime with the PARENT resource data.
|
|
390
|
+
* Return `true` to include the relationship, `false` to exclude it.
|
|
391
|
+
*
|
|
392
|
+
* Unlike the static `discriminator` (which is a simple field+values match),
|
|
393
|
+
* this allows arbitrary logic: cross-field checks, computed conditions, etc.
|
|
394
|
+
*
|
|
395
|
+
* When both `discriminator` and `condition` are present on a relationship,
|
|
396
|
+
* they are combined with AND semantics — the relationship is active only when
|
|
397
|
+
* both pass.
|
|
398
|
+
*
|
|
399
|
+
* Error handling is selected by the runtime caller through
|
|
400
|
+
* `Resources_SharedUtils.isRelationshipActiveForParent()`:
|
|
401
|
+
* - Backend callers propagate condition errors normally.
|
|
402
|
+
* - Frontend callers may fail safe and exclude the relationship.
|
|
403
|
+
*
|
|
404
|
+
* @param parentResource - The parent resource's data object.
|
|
405
|
+
* @returns `true` to include the relationship, `false` to exclude it.
|
|
406
|
+
*/
|
|
407
|
+
export type ResourceRelationshipConditionFn = (parentResource: Record<string, any>) => boolean;
|
|
408
|
+
|
|
409
|
+
export type ResolvedRelationshipNatureCalculationMode = 'explicit';
|
|
410
|
+
export type ResolvedRelationshipReadCalculationMode =
|
|
411
|
+
| 'explicit'
|
|
412
|
+
| 'legacy_nested_read_fallback'
|
|
413
|
+
| 'default_reference_only';
|
|
414
|
+
|
|
415
|
+
/**
|
|
416
|
+
* Internal relationship contract built once from the developer-authored
|
|
417
|
+
* declaration and then reused by runtime consumers.
|
|
418
|
+
*/
|
|
419
|
+
export interface ResolvedRelationshipSemantics {
|
|
420
|
+
nature: RelationshipNature;
|
|
421
|
+
natureCalculationMode: ResolvedRelationshipNatureCalculationMode;
|
|
422
|
+
/**
|
|
423
|
+
* Documents whether the semantic read intent came from explicit authored
|
|
424
|
+
* `read`, from the legacy `childOperations.nested.onRead` compatibility seam,
|
|
425
|
+
* or from the default non-embedded fallback when neither is authored.
|
|
426
|
+
*/
|
|
427
|
+
readCalculationMode: ResolvedRelationshipReadCalculationMode;
|
|
428
|
+
handling: RelationshipHandlingContract;
|
|
429
|
+
persistence: RelationshipPersistenceContract;
|
|
430
|
+
childOperations?: ChildOperationsConfig_Parsed;
|
|
431
|
+
}
|
|
432
|
+
```
|
|
433
|
+
## Import Origins
|
|
434
|
+
|
|
435
|
+
- `@wildo-ai/saas-models`
|
|
436
|
+
|
|
437
|
+
## Source Excerpts
|
|
438
|
+
|
|
439
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
440
|
+
|
|
441
|
+
```typescript
|
|
442
|
+
*
|
|
443
|
+
* Developer-authored relationship declaration.
|
|
444
|
+
*
|
|
445
|
+
* The `condition` function cannot be represented in a Zod schema (functions aren't
|
|
446
|
+
* serializable), so we extend via a TypeScript intersection type. This means:
|
|
447
|
+
* - The Zod schema (`ResourceRelationshipSchema`) defines all serializable fields,
|
|
448
|
+
* including the static `discriminator` object.
|
|
449
|
+
* - This intersection adds the optional `condition` function on top.
|
|
450
|
+
* - The `createResourcesRelationship()` factory accepts both and returns this type.
|
|
451
|
+
* - `nature` + optional `read` form the authored semantic surface; the
|
|
452
|
+
* framework compiles that into `resolvedSemantics.handling`.
|
|
453
|
+
*
|
|
454
|
+
* ## Conditional Relationship Architecture
|
|
455
|
+
*
|
|
456
|
+
* Relationships may optionally carry two kinds of runtime filters:
|
|
457
|
+
*
|
|
458
|
+
* 1. **`discriminator`** (static) — A simple field+values match on the parent resource.
|
|
459
|
+
* Defined as `{ discriminatorField: string, values: string[] }`.
|
|
460
|
+
* Example: "this relationship only applies when `recurringType === 'RECURRING'`".
|
|
461
|
+
*
|
|
462
|
+
* 2. **`condition`** (dynamic) — An arbitrary function evaluated with the parent
|
|
463
|
+
* resource data. Use for cross-field logic, computed conditions, etc.
|
|
464
|
+
*
|
|
465
|
+
* Both are evaluated against the PARENT resource, never the child. When both are
|
|
466
|
+
* present, they use AND semantics (both must pass for the relationship to be active).
|
|
467
|
+
*
|
|
468
|
+
* ## Where Conditions Are Evaluated at Runtime
|
|
469
|
+
*
|
|
470
|
+
* | Layer | Evaluates discriminator/condition? | Against which resource? |
|
|
471
|
+
* |-------------------------------|------------------------------------|-------------------------|
|
|
472
|
+
* | **Factory** (startup) | No — stores them inline | N/A |
|
|
473
|
+
* | **DTO Builder** (startup) | No — generates DTOs for ALL rels | N/A |
|
|
474
|
+
* | **URL Builder** (startup) | No — synthetic parents clear them | N/A |
|
|
475
|
+
* | **ResourceContext** (backend) | Yes, via shared activation helper | parentResource |
|
|
476
|
+
* | **ServicesRegistryHandler** | Yes, via shared activation helper | parentResult/state |
|
|
477
|
+
* | **ContainerNested** (frontend)| Yes, via shared activation helper | parentData |
|
|
478
|
+
*
|
|
479
|
+
* The key design insight is that conditions are a RUNTIME concern. At startup
|
|
480
|
+
* (factory/DTO/URL), all relationships are processed unconditionally — conditions
|
|
481
|
+
* are evaluated only when actual parent data is available.
|
|
482
|
+
*
|
|
483
|
+
* Runtime registry rows also carry `resolvedSemantics` (see `ResourceRelationship`).
|
|
484
|
+
*/
|
|
485
|
+
export type ResourceRelationshipDeclaration = z.infer<typeof ResourceRelationshipSchema> & {
|
|
486
|
+
condition?: ResourceRelationshipConditionFn;
|
|
487
|
+
};
|
|
488
|
+
|
|
489
|
+
/**
|
|
490
|
+
* Internal runtime relationship shape.
|
|
491
|
+
*
|
|
492
|
+
* This mirrors the resource-configuration pattern: app developers author the
|
|
493
|
+
* declaration shape, and the factory compiles/stores the internal semantics
|
|
494
|
+
* once so runtime consumers reuse the resolved form instead of rebuilding it.
|
|
495
|
+
*/
|
|
496
|
+
export type ResourceRelationship = ResourceRelationshipDeclaration & {
|
|
497
|
+
resolvedSemantics: ResolvedRelationshipSemantics;
|
|
498
|
+
};
|
|
499
|
+
```
|
|
500
|
+
## Import Origins
|
|
501
|
+
|
|
502
|
+
- `@wildo-ai/saas-models`
|
|
503
|
+
|
|
504
|
+
## Source Excerpts
|
|
505
|
+
|
|
506
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
507
|
+
|
|
508
|
+
```typescript
|
|
509
|
+
*
|
|
510
|
+
* Parameters accepted by `createResourcesRelationship()` (app registry authoring).
|
|
511
|
+
*/
|
|
512
|
+
export type ResourceRelationship_BuilderParameters = {
|
|
513
|
+
isDisabled? : boolean,
|
|
514
|
+
isPrimaryScope? : boolean,
|
|
515
|
+
parentResourceRequirement? : ResourceParentResourceRequirement,
|
|
516
|
+
accessScopeStrategy? : ResourceRelationshipAccessScopeStrategy,
|
|
517
|
+
jointResourceType?: ResourceType,
|
|
518
|
+
/**
|
|
519
|
+
* Opt-in flag for relationships that form cycles in the resource graph.
|
|
520
|
+
* Required on every edge in a cycle for schema-level validation to pass.
|
|
521
|
+
* @see ResourceRelationshipSchema.allowCycle
|
|
522
|
+
*/
|
|
523
|
+
allowCycle?: boolean,
|
|
524
|
+
/** Context policy for this relationship - controls how related resources are fetched */
|
|
525
|
+
contextPolicy?: RelationshipContextPolicy,
|
|
526
|
+
/**
|
|
527
|
+
* High-level shared meaning of the relationship.
|
|
528
|
+
*
|
|
529
|
+
* This is the primary semantic field app developers should author. The
|
|
530
|
+
* framework derives the deeper internal handling contract from it plus the
|
|
531
|
+
* optional explicit read intent when present.
|
|
532
|
+
*/
|
|
533
|
+
nature: RelationshipNature,
|
|
534
|
+
/**
|
|
535
|
+
* Optional explicit semantic read intent.
|
|
536
|
+
*
|
|
537
|
+
* This does not replace `childOperations.nested.onRead`; it only declares the
|
|
538
|
+
* semantic read model the framework should resolve.
|
|
539
|
+
*/
|
|
540
|
+
read?: RelationshipHandlingReadSettings,
|
|
541
|
+
/**
|
|
542
|
+
* Child operations configuration for this relationship.
|
|
543
|
+
* Handles BACKEND concerns: lifecycle cascade and nested DTO aggregation.
|
|
544
|
+
*/
|
|
545
|
+
childOperations?: ChildOperationsConfig,
|
|
546
|
+
/**
|
|
547
|
+
* Static discriminator filter for conditional relationships.
|
|
548
|
+
* When specified, this relationship only applies when the parent resource's
|
|
549
|
+
* discriminator field matches one of the specified values.
|
|
550
|
+
*/
|
|
551
|
+
discriminator?: ResourceRelationshipDiscriminator,
|
|
552
|
+
/**
|
|
553
|
+
* Function-based condition for conditional relationships.
|
|
554
|
+
* Evaluated at runtime with the parent resource data.
|
|
555
|
+
* Unlike the static `discriminator`, this allows arbitrary logic.
|
|
556
|
+
*/
|
|
557
|
+
condition?: ResourceRelationshipConditionFn,
|
|
558
|
+
/**
|
|
559
|
+
* Frontend display configuration for this relationship.
|
|
560
|
+
* Defines how related resources are displayed in the UI.
|
|
561
|
+
*/
|
|
562
|
+
display?: RelationshipDisplayConfig,
|
|
563
|
+
/**
|
|
564
|
+
* Foreign key field name for this relationship.
|
|
565
|
+
*
|
|
566
|
+
* When omitted: Inferred from parent's resourceFieldIdentifier via allResourceFieldIdentifiers map.
|
|
567
|
+
* When specified: Used for disambiguation when multiple FKs point to same resource type,
|
|
568
|
+
* or when FK field name differs from standard naming convention.
|
|
569
|
+
*
|
|
570
|
+
* Examples:
|
|
571
|
+
* - Standard: ORGANIZATIONS → TODOS uses organizationId (inferred, no foreignKeyField needed)
|
|
572
|
+
* - Disambiguation: TODOS → USERS via assignedToUserId vs createdByUserId (explicit)
|
|
573
|
+
* - Self-referencing M:N is not expressed as one relationship declaration;
|
|
574
|
+
* declare two explicit junction-resource edges so source and target FK
|
|
575
|
+
* identities remain distinct.
|
|
576
|
+
*/
|
|
577
|
+
foreignKeyField?: string,
|
|
578
|
+
/**
|
|
579
|
+
* Write-time SCOPE CONFINEMENT for a REFERENCE foreign key: the referenced target must be linked to
|
|
580
|
+
* the writing row's scope through a junction, enforced on CREATE and UPDATE. Opt-in and additive —
|
|
581
|
+
* omit for unchanged behavior.
|
|
582
|
+
*
|
|
583
|
+
* STRUCTURE only. `scopeMembership: true` is the simple case (junction auto-resolved from the M:N
|
|
584
|
+
* scope-junction map); the object form names the junction / its columns when convention cannot — a
|
|
585
|
+
* SELF-REFERENTIAL junction (organizations ↔ organizations). Per-variant POLICY (status, roles, typed
|
|
586
|
+
* junction rows) is declared on the operation config's `referenceConstraints`.
|
|
587
|
+
*
|
|
588
|
+
* @example todos.assignedToUserId must be a member of the row's organization:
|
|
589
|
+
* { nature: RelationshipNature.REFERENCE, foreignKeyField: 'assignedToUserId', scopeMembership: true }
|
|
590
|
+
*
|
|
591
|
+
* @example todos.sharedWithOrganizationId must be a partner of the row's organization:
|
|
592
|
+
* { nature: RelationshipNature.REFERENCE, foreignKeyField: 'sharedWithOrganizationId',
|
|
593
|
+
* scopeMembership: { junction: CoreResourceType.ORGANIZATION_PARTNERSHIPS } }
|
|
594
|
+
*/
|
|
595
|
+
scopeMembership?: ScopeMembership,
|
|
596
|
+
};
|
|
597
|
+
```
|
|
598
|
+
## Import Origins
|
|
599
|
+
|
|
600
|
+
- `@wildo-ai/saas-models`
|
|
601
|
+
|
|
602
|
+
## Source Excerpts
|
|
603
|
+
|
|
604
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
605
|
+
|
|
606
|
+
```typescript
|
|
607
|
+
*
|
|
608
|
+
* Write-time scope confinement of a REFERENCE foreign key — the STRUCTURE half.
|
|
609
|
+
*
|
|
610
|
+
* A lateral `REFERENCE` FK to a target that is NOT itself tenant-scoped — a `users` id on an
|
|
611
|
+
* org-scoped row, another `organizations` id — carries no `organizationId` column to compare, so the
|
|
612
|
+
* ordinary write-integrity tenant check can only confirm the target EXISTS, never that it belongs to
|
|
613
|
+
* the writer's tenant. That admits a cross-tenant reference (assign a todo to a user from another org).
|
|
614
|
+
* Declaring `scopeMembership` closes it: the referenced target must have a row in a junction linking it
|
|
615
|
+
* to the writing row's scope — enforced on CREATE and UPDATE, refused with `404` (identical to the
|
|
616
|
+
* existing cross-tenant refusal, so nothing leaks).
|
|
617
|
+
*
|
|
618
|
+
* **This type carries STRUCTURE ONLY — which junction, and which columns.** It is a fact about the data
|
|
619
|
+
* shape, uniform across every write. The POLICY half (status / role / field tightening, or disabling)
|
|
620
|
+
* varies per operation VARIANT and therefore lives on the operation config as `referenceConstraints`
|
|
621
|
+
* (see {@link ReferenceScopeConstraintSchema}) — beside the caller-side `roles`, where authorization
|
|
622
|
+
* already lives. Keeping them apart is what stops a relationship from growing its own per-variant
|
|
623
|
+
* authorization table duplicating the operation/variant structure.
|
|
624
|
+
*
|
|
625
|
+
* Fully OPT-IN: a relationship without `scopeMembership` keeps its existing existence-only behavior.
|
|
626
|
+
*/
|
|
627
|
+
export const ScopeMembershipStructureSchema = z.object({
|
|
628
|
+
/**
|
|
629
|
+
* The writing row's scope field whose value the target must be a member of. Defaults to the
|
|
630
|
+
* resource's primary-scope FK (e.g. `organizationId`). Set only when the confining scope is a
|
|
631
|
+
* non-primary field.
|
|
632
|
+
*/
|
|
633
|
+
scopeField: z.string().optional(),
|
|
634
|
+
/**
|
|
635
|
+
* The junction resource linking scope → target (e.g. `organizationMembers`, `organizationPartnerships`).
|
|
636
|
+
* Omit to auto-resolve from the registry's `(target, scope)` M:N scope-junction map — which works when
|
|
637
|
+
* the junction's two sides are DIFFERENT resource types (organizations ↔ users). Name it explicitly for
|
|
638
|
+
* a SELF-REFERENTIAL junction (organizations ↔ organizations), which the map does not infer.
|
|
639
|
+
*/
|
|
640
|
+
junction: ResourceTypeSchema.optional(),
|
|
641
|
+
/**
|
|
642
|
+
* The junction column holding the SCOPE id (the writer's tenant), e.g. `organizationId`.
|
|
643
|
+
*
|
|
644
|
+
* Needed only when convention cannot pick it: for a self-referential junction both columns have the
|
|
645
|
+
* same resource type, so the guard takes the column NAMED LIKE the writing row's scope field as the
|
|
646
|
+
* scope side and the other same-typed column as the target side. Set this (with
|
|
647
|
+
* {@link junctionTargetField}) when the junction names its columns differently
|
|
648
|
+
* (e.g. `sourceOrganizationId` / `targetOrganizationId`).
|
|
649
|
+
*/
|
|
650
|
+
junctionScopeField: z.string().optional(),
|
|
651
|
+
/**
|
|
652
|
+
* The junction column holding the TARGET id (the referenced row), e.g. `partnerOrganizationId`.
|
|
653
|
+
* See {@link junctionScopeField} — set both or neither.
|
|
654
|
+
*/
|
|
655
|
+
junctionTargetField: z.string().optional(),
|
|
656
|
+
});
|
|
657
|
+
export type ScopeMembershipStructure = z.infer<typeof ScopeMembershipStructureSchema>;
|
|
658
|
+
|
|
659
|
+
/**
|
|
660
|
+
* Relationship `scopeMembership` value: `true` for the simple case (junction auto-resolved from the
|
|
661
|
+
* registry's M:N scope-junction map), or a {@link ScopeMembershipStructureSchema} when the junction or
|
|
662
|
+
* its columns must be named (self-referential junctions, non-primary scope fields).
|
|
663
|
+
*
|
|
664
|
+
* Policy — status, roles, junction-field and target-row constraints, or disabling — is NOT here; it is
|
|
665
|
+
* per-variant and lives on the operation config's `referenceConstraints`.
|
|
666
|
+
*/
|
|
667
|
+
export const ScopeMembershipSchema = z.union([z.literal(true), ScopeMembershipStructureSchema]);
|
|
668
|
+
export type ScopeMembership = z.infer<typeof ScopeMembershipSchema>;
|
|
669
|
+
|
|
670
|
+
/**
|
|
671
|
+
* Write-time scope confinement of a REFERENCE foreign key — the POLICY half, declared PER OPERATION
|
|
672
|
+
* VARIANT on the operation config (`referenceConstraints`), keyed by foreign-key field.
|
|
673
|
+
*
|
|
674
|
+
* The relationship's {@link ScopeMembershipSchema} already guarantees the baseline: the referenced
|
|
675
|
+
* target must be linked to the writing row's scope through the junction. This type TIGHTENS that
|
|
676
|
+
* baseline for one variant — the ordinary "assign" accepts any member while a "make reviewer" variant
|
|
677
|
+
* requires an `ORG_ADMIN`; a plain "share" accepts any partnership while "share with write access"
|
|
678
|
+
* requires a typed one. It sits beside the operation's own `roles`, which gate the CALLER; these gate
|
|
679
|
+
* the TARGET.
|
|
680
|
+
*
|
|
681
|
+
* Absent for a foreign key ⇒ the relationship's baseline membership applies unchanged. `false` ⇒
|
|
682
|
+
* enforcement is DISABLED for that foreign key on that variant.
|
|
683
|
+
*
|
|
684
|
+
* Note on rigor: the baseline membership check is TENANT ISOLATION and is enforced strictly. The
|
|
685
|
+
* refinements below are ACCESS MANAGEMENT — `requiredRoles` reuses the shared hierarchy matcher
|
|
686
|
+
* (`userRolesSatisfyRequiredRoles`), which is deliberately permissive about app-custom roles it cannot
|
|
687
|
+
* expand rather than fail-closed on them.
|
|
688
|
+
*/
|
|
689
|
+
export const ReferenceScopeConstraintSchema = z.object({
|
|
690
|
+
/**
|
|
691
|
+
* Junction-row `status` values that qualify (e.g. `['ACTIVE']`). Omit ⇒ any status qualifies (mere
|
|
692
|
+
* membership — still refuses a cross-tenant reference). Use to reject e.g. a `SUSPENDED` member.
|
|
693
|
+
*/
|
|
694
|
+
qualifyingStatuses: z.array(z.string()).optional(),
|
|
695
|
+
/**
|
|
696
|
+
* Hierarchy-aware role requirement on the qualifying junction row's `roles` (e.g. the referenced user
|
|
697
|
+
* must be an `ORG_ADMIN` of the row's organization). Matched with the SAME hierarchy walk the
|
|
698
|
+
* operation role gate uses — a member holding an ancestor role (e.g. `ORG_OWNER`) satisfies a
|
|
699
|
+
* requirement of `ORG_ADMIN`. Omit ⇒ no role constraint.
|
|
700
|
+
*/
|
|
701
|
+
requiredRoles: z.object({
|
|
702
|
+
scope: z.enum(ResourcePrimaryScope),
|
|
703
|
+
roles: z.array(z.string()).min(1),
|
|
704
|
+
}).optional(),
|
|
705
|
+
/**
|
|
706
|
+
* Equality constraints on the qualifying JUNCTION row beyond status (e.g. a typed partnership:
|
|
707
|
+
* `{ partnershipType: 'collaboration' }`). All entries must match. Omit ⇒ no field constraint.
|
|
708
|
+
*/
|
|
709
|
+
qualifyingFields: z.record(z.string(), z.unknown()).optional(),
|
|
710
|
+
/**
|
|
711
|
+
* Equality constraints on the referenced TARGET ROW itself (not the junction) — e.g. the assignee must
|
|
712
|
+
* be a user of a given type `{ userTypes: 'agent' }`, or a partner org of a given type
|
|
713
|
+
* `{ type: 'enterprise' }`. Applied to the target row the guard already reads. Omit ⇒ none.
|
|
714
|
+
*/
|
|
715
|
+
targetConstraints: z.record(z.string(), z.unknown()).optional(),
|
|
716
|
+
});
|
|
717
|
+
export type ReferenceScopeConstraint = z.infer<typeof ReferenceScopeConstraintSchema>;
|
|
718
|
+
|
|
719
|
+
/**
|
|
720
|
+
* An operation variant's per-foreign-key reference policy: `foreignKeyField → constraint | false`.
|
|
721
|
+
*
|
|
722
|
+
* `false` WAIVES the scope-membership requirement for that foreign key on this variant (a break-glass
|
|
723
|
+
* verb that must write a not-yet-member reference). It waives that and nothing else: the target must
|
|
724
|
+
* still EXIST, and an ORG-SCOPED target must still share the write's tenant.
|
|
725
|
+
*
|
|
726
|
+
* ⚠️ **On an ORG-LESS target the junction IS the tenant signal.** `users` and `organizations` carry no
|
|
727
|
+
* tenant column to fall back on, so waiving membership there reduces the check to existence and a
|
|
728
|
+
* cross-tenant id becomes admissible. That is occasionally the intent (an incident override), but it is
|
|
729
|
+
* never incidental — reach for a narrower policy first (a wider `qualifyingStatuses`, or a second
|
|
730
|
+
* junction that models the exception) and use `false` only when the variant genuinely means
|
|
731
|
+
* "any existing row, tenant notwithstanding".
|
|
732
|
+
*/
|
|
733
|
+
export const ReferenceConstraintsSchema = z.record(
|
|
734
|
+
z.string(),
|
|
735
|
+
z.union([z.literal(false), ReferenceScopeConstraintSchema]),
|
|
736
|
+
);
|
|
737
|
+
export type ReferenceConstraints = z.infer<typeof ReferenceConstraintsSchema>;
|
|
738
|
+
```
|