@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,143 @@
|
|
|
1
|
+
# saas.models.scope-membership
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Write-time scope confinement of a REFERENCE foreign key — the STRUCTURE half.
|
|
14
|
+
*
|
|
15
|
+
* A lateral `REFERENCE` FK to a target that is NOT itself tenant-scoped — a `users` id on an
|
|
16
|
+
* org-scoped row, another `organizations` id — carries no `organizationId` column to compare, so the
|
|
17
|
+
* ordinary write-integrity tenant check can only confirm the target EXISTS, never that it belongs to
|
|
18
|
+
* the writer's tenant. That admits a cross-tenant reference (assign a todo to a user from another org).
|
|
19
|
+
* Declaring `scopeMembership` closes it: the referenced target must have a row in a junction linking it
|
|
20
|
+
* to the writing row's scope — enforced on CREATE and UPDATE, refused with `404` (identical to the
|
|
21
|
+
* existing cross-tenant refusal, so nothing leaks).
|
|
22
|
+
*
|
|
23
|
+
* **This type carries STRUCTURE ONLY — which junction, and which columns.** It is a fact about the data
|
|
24
|
+
* shape, uniform across every write. The POLICY half (status / role / field tightening, or disabling)
|
|
25
|
+
* varies per operation VARIANT and therefore lives on the operation config as `referenceConstraints`
|
|
26
|
+
* (see {@link ReferenceScopeConstraintSchema}) — beside the caller-side `roles`, where authorization
|
|
27
|
+
* already lives. Keeping them apart is what stops a relationship from growing its own per-variant
|
|
28
|
+
* authorization table duplicating the operation/variant structure.
|
|
29
|
+
*
|
|
30
|
+
* Fully OPT-IN: a relationship without `scopeMembership` keeps its existing existence-only behavior.
|
|
31
|
+
*/
|
|
32
|
+
export const ScopeMembershipStructureSchema = z.object({
|
|
33
|
+
/**
|
|
34
|
+
* The writing row's scope field whose value the target must be a member of. Defaults to the
|
|
35
|
+
* resource's primary-scope FK (e.g. `organizationId`). Set only when the confining scope is a
|
|
36
|
+
* non-primary field.
|
|
37
|
+
*/
|
|
38
|
+
scopeField: z.string().optional(),
|
|
39
|
+
/**
|
|
40
|
+
* The junction resource linking scope → target (e.g. `organizationMembers`, `organizationPartnerships`).
|
|
41
|
+
* Omit to auto-resolve from the registry's `(target, scope)` M:N scope-junction map — which works when
|
|
42
|
+
* the junction's two sides are DIFFERENT resource types (organizations ↔ users). Name it explicitly for
|
|
43
|
+
* a SELF-REFERENTIAL junction (organizations ↔ organizations), which the map does not infer.
|
|
44
|
+
*/
|
|
45
|
+
junction: ResourceTypeSchema.optional(),
|
|
46
|
+
/**
|
|
47
|
+
* The junction column holding the SCOPE id (the writer's tenant), e.g. `organizationId`.
|
|
48
|
+
*
|
|
49
|
+
* Needed only when convention cannot pick it: for a self-referential junction both columns have the
|
|
50
|
+
* same resource type, so the guard takes the column NAMED LIKE the writing row's scope field as the
|
|
51
|
+
* scope side and the other same-typed column as the target side. Set this (with
|
|
52
|
+
* {@link junctionTargetField}) when the junction names its columns differently
|
|
53
|
+
* (e.g. `sourceOrganizationId` / `targetOrganizationId`).
|
|
54
|
+
*/
|
|
55
|
+
junctionScopeField: z.string().optional(),
|
|
56
|
+
/**
|
|
57
|
+
* The junction column holding the TARGET id (the referenced row), e.g. `partnerOrganizationId`.
|
|
58
|
+
* See {@link junctionScopeField} — set both or neither.
|
|
59
|
+
*/
|
|
60
|
+
junctionTargetField: z.string().optional(),
|
|
61
|
+
});
|
|
62
|
+
export type ScopeMembershipStructure = z.infer<typeof ScopeMembershipStructureSchema>;
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Relationship `scopeMembership` value: `true` for the simple case (junction auto-resolved from the
|
|
66
|
+
* registry's M:N scope-junction map), or a {@link ScopeMembershipStructureSchema} when the junction or
|
|
67
|
+
* its columns must be named (self-referential junctions, non-primary scope fields).
|
|
68
|
+
*
|
|
69
|
+
* Policy — status, roles, junction-field and target-row constraints, or disabling — is NOT here; it is
|
|
70
|
+
* per-variant and lives on the operation config's `referenceConstraints`.
|
|
71
|
+
*/
|
|
72
|
+
export const ScopeMembershipSchema = z.union([z.literal(true), ScopeMembershipStructureSchema]);
|
|
73
|
+
export type ScopeMembership = z.infer<typeof ScopeMembershipSchema>;
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Write-time scope confinement of a REFERENCE foreign key — the POLICY half, declared PER OPERATION
|
|
77
|
+
* VARIANT on the operation config (`referenceConstraints`), keyed by foreign-key field.
|
|
78
|
+
*
|
|
79
|
+
* The relationship's {@link ScopeMembershipSchema} already guarantees the baseline: the referenced
|
|
80
|
+
* target must be linked to the writing row's scope through the junction. This type TIGHTENS that
|
|
81
|
+
* baseline for one variant — the ordinary "assign" accepts any member while a "make reviewer" variant
|
|
82
|
+
* requires an `ORG_ADMIN`; a plain "share" accepts any partnership while "share with write access"
|
|
83
|
+
* requires a typed one. It sits beside the operation's own `roles`, which gate the CALLER; these gate
|
|
84
|
+
* the TARGET.
|
|
85
|
+
*
|
|
86
|
+
* Absent for a foreign key ⇒ the relationship's baseline membership applies unchanged. `false` ⇒
|
|
87
|
+
* enforcement is DISABLED for that foreign key on that variant.
|
|
88
|
+
*
|
|
89
|
+
* Note on rigor: the baseline membership check is TENANT ISOLATION and is enforced strictly. The
|
|
90
|
+
* refinements below are ACCESS MANAGEMENT — `requiredRoles` reuses the shared hierarchy matcher
|
|
91
|
+
* (`userRolesSatisfyRequiredRoles`), which is deliberately permissive about app-custom roles it cannot
|
|
92
|
+
* expand rather than fail-closed on them.
|
|
93
|
+
*/
|
|
94
|
+
export const ReferenceScopeConstraintSchema = z.object({
|
|
95
|
+
/**
|
|
96
|
+
* Junction-row `status` values that qualify (e.g. `['ACTIVE']`). Omit ⇒ any status qualifies (mere
|
|
97
|
+
* membership — still refuses a cross-tenant reference). Use to reject e.g. a `SUSPENDED` member.
|
|
98
|
+
*/
|
|
99
|
+
qualifyingStatuses: z.array(z.string()).optional(),
|
|
100
|
+
/**
|
|
101
|
+
* Hierarchy-aware role requirement on the qualifying junction row's `roles` (e.g. the referenced user
|
|
102
|
+
* must be an `ORG_ADMIN` of the row's organization). Matched with the SAME hierarchy walk the
|
|
103
|
+
* operation role gate uses — a member holding an ancestor role (e.g. `ORG_OWNER`) satisfies a
|
|
104
|
+
* requirement of `ORG_ADMIN`. Omit ⇒ no role constraint.
|
|
105
|
+
*/
|
|
106
|
+
requiredRoles: z.object({
|
|
107
|
+
scope: z.enum(ResourcePrimaryScope),
|
|
108
|
+
roles: z.array(z.string()).min(1),
|
|
109
|
+
}).optional(),
|
|
110
|
+
/**
|
|
111
|
+
* Equality constraints on the qualifying JUNCTION row beyond status (e.g. a typed partnership:
|
|
112
|
+
* `{ partnershipType: 'collaboration' }`). All entries must match. Omit ⇒ no field constraint.
|
|
113
|
+
*/
|
|
114
|
+
qualifyingFields: z.record(z.string(), z.unknown()).optional(),
|
|
115
|
+
/**
|
|
116
|
+
* Equality constraints on the referenced TARGET ROW itself (not the junction) — e.g. the assignee must
|
|
117
|
+
* be a user of a given type `{ userTypes: 'agent' }`, or a partner org of a given type
|
|
118
|
+
* `{ type: 'enterprise' }`. Applied to the target row the guard already reads. Omit ⇒ none.
|
|
119
|
+
*/
|
|
120
|
+
targetConstraints: z.record(z.string(), z.unknown()).optional(),
|
|
121
|
+
});
|
|
122
|
+
export type ReferenceScopeConstraint = z.infer<typeof ReferenceScopeConstraintSchema>;
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* An operation variant's per-foreign-key reference policy: `foreignKeyField → constraint | false`.
|
|
126
|
+
*
|
|
127
|
+
* `false` WAIVES the scope-membership requirement for that foreign key on this variant (a break-glass
|
|
128
|
+
* verb that must write a not-yet-member reference). It waives that and nothing else: the target must
|
|
129
|
+
* still EXIST, and an ORG-SCOPED target must still share the write's tenant.
|
|
130
|
+
*
|
|
131
|
+
* ⚠️ **On an ORG-LESS target the junction IS the tenant signal.** `users` and `organizations` carry no
|
|
132
|
+
* tenant column to fall back on, so waiving membership there reduces the check to existence and a
|
|
133
|
+
* cross-tenant id becomes admissible. That is occasionally the intent (an incident override), but it is
|
|
134
|
+
* never incidental — reach for a narrower policy first (a wider `qualifyingStatuses`, or a second
|
|
135
|
+
* junction that models the exception) and use `false` only when the variant genuinely means
|
|
136
|
+
* "any existing row, tenant notwithstanding".
|
|
137
|
+
*/
|
|
138
|
+
export const ReferenceConstraintsSchema = z.record(
|
|
139
|
+
z.string(),
|
|
140
|
+
z.union([z.literal(false), ReferenceScopeConstraintSchema]),
|
|
141
|
+
);
|
|
142
|
+
export type ReferenceConstraints = z.infer<typeof ReferenceConstraintsSchema>;
|
|
143
|
+
```
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# saas.models.shared-domain-module
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Cross-runtime module slice: resource factories, field identifiers, and relationship declarations merged across packages.
|
|
14
|
+
*/
|
|
15
|
+
export interface SharedDomainModule {
|
|
16
|
+
resourceConfigurations?: Record<string, ResourceConfiguration_InitializationFactory<any, any, any>>;
|
|
17
|
+
resourceFieldIdentifiers?: Record<string, string>;
|
|
18
|
+
resourceRelationships?: ResourceRelationship[];
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function mergeSharedDomainModules(
|
|
22
|
+
...modules: SharedDomainModule[]
|
|
23
|
+
): SharedDomainModule {
|
|
24
|
+
return {
|
|
25
|
+
resourceConfigurations: Object.assign(
|
|
26
|
+
{},
|
|
27
|
+
...modules.map(m => m.resourceConfigurations).filter(Boolean),
|
|
28
|
+
) as Record<string, ResourceConfiguration_InitializationFactory<any, any, any>>,
|
|
29
|
+
resourceFieldIdentifiers: Object.assign(
|
|
30
|
+
{},
|
|
31
|
+
...modules.map(m => m.resourceFieldIdentifiers).filter(Boolean),
|
|
32
|
+
) as Record<string, string>,
|
|
33
|
+
resourceRelationships: modules.flatMap(m => m.resourceRelationships ?? []),
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
```
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# saas.models.shared-saas-module
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* App module contract: id, kind, roles, feature/milestone/product/notification-badge definition hooks layered on shared resources.
|
|
14
|
+
*/
|
|
15
|
+
export interface SharedSaaSModule extends SharedDomainModule {
|
|
16
|
+
moduleId: string;
|
|
17
|
+
kind?: ApplicationModuleKind;
|
|
18
|
+
customRoles?: RolesConfiguration;
|
|
19
|
+
customFeatureDefinitions?: FeatureDefinitionWithAutoRegister[];
|
|
20
|
+
customFeatureConfiguration?: {
|
|
21
|
+
profiles?: Record<string, ScopeFeatures>;
|
|
22
|
+
defaultProfile?: string;
|
|
23
|
+
unavailabilityPolicy?: Partial<FeatureConfiguration['unavailabilityPolicy']>;
|
|
24
|
+
};
|
|
25
|
+
customMilestoneDefinitions?: MilestoneDefinition[];
|
|
26
|
+
productDefinitions?: ProductDefinition[];
|
|
27
|
+
/**
|
|
28
|
+
* Notification badge definitions owned by this module (a module declares the
|
|
29
|
+
* badges derived from / driven by its own resources — e.g. a tasks module owns
|
|
30
|
+
* an "incomplete todos" count). Aggregated across modules by
|
|
31
|
+
* `buildSharedSaaSModulesRegistry` and threaded into the app init config, so a
|
|
32
|
+
* module owns its badge concern end-to-end with no app-level wiring.
|
|
33
|
+
*/
|
|
34
|
+
notificationBadgeDefinitions?: NotificationBadgeDefinition[];
|
|
35
|
+
}
|
|
36
|
+
```
|
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
# saas.public-runtime.contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* @wildo-package-subpath @wildo-ai/saas-models/public-runtime
|
|
14
|
+
*
|
|
15
|
+
* Browser-safe, decorator-framework-free atom subset of
|
|
16
|
+
* `@wildo-ai/saas-models`.
|
|
17
|
+
*
|
|
18
|
+
* Why this subpath exists:
|
|
19
|
+
* The package's root barrel (`./index.ts`) calls `initZodDecorators()` at
|
|
20
|
+
* module load (line 3) and re-exports the entire decorator-framework-bound
|
|
21
|
+
* schema graph (~150 schemas, transitively pulls
|
|
22
|
+
* `@wildo-ai/external-connectors-models` + `@wildo-ai/zod-decorators` +
|
|
23
|
+
* `reflect-metadata`). Browser bundles that need only a handful of stable
|
|
24
|
+
* atoms (cross-frontend handoff DTOs, canonical HTTP header keys, locale
|
|
25
|
+
* enums) should NOT pay that cost.
|
|
26
|
+
*
|
|
27
|
+
* This subpath exposes that minimal stable surface, sourced from
|
|
28
|
+
* side-effect-free atom files (saas-models-public-runtime.md K-1 / K-2 /
|
|
29
|
+
* K-4):
|
|
30
|
+
*
|
|
31
|
+
* - Cross-Frontend Handoff + Token Exchange DTO atoms
|
|
32
|
+
* (`../security/authentications/cross-frontend-handoff.shared.dto.schemas`):
|
|
33
|
+
* `CrossFrontendHandoffErrorCode`, `CrossFrontendHandoffRequestSchema`,
|
|
34
|
+
* `CrossFrontendHandoffResponseSchema`, `TokenExchangeRequestSchema`,
|
|
35
|
+
* `TokenExchangeResponseSchema`,
|
|
36
|
+
* `CrossFrontendHandoffRequest`, `CrossFrontendHandoffResponse`,
|
|
37
|
+
* `TokenExchangeRequest`, `TokenExchangeResponse`. The token-exchange
|
|
38
|
+
* schemas were added
|
|
39
|
+
* in cross-app-jwt-propagation.md Step 5 — every receiver of an
|
|
40
|
+
* AUTH_CODE_EXCHANGE token (SaaS app, docs site) is by construction
|
|
41
|
+
* a client-bundle target, so the response shape MUST live here too
|
|
42
|
+
* (not just in the heavy backend schemas barrel).
|
|
43
|
+
* - Frontend-kind enum
|
|
44
|
+
* (`../config/app-frontend-type.shared.schemas`): `AppFrontendType`
|
|
45
|
+
* — the SAAS_APP / STATIC_WEBSITE / TECH_DOC runtime taxonomy.
|
|
46
|
+
* Consumed by website discovery, scaffolding, CSP config, and
|
|
47
|
+
* companion services that need to introspect a service's runtime
|
|
48
|
+
* kind without booting the full schema graph. The atom file's
|
|
49
|
+
* file-level JSDoc is the canonical home for the kind-by-kind
|
|
50
|
+
* rationale AND the locked "no native variants" design decision
|
|
51
|
+
* — read that file before authoring any AppFrontendType-driven
|
|
52
|
+
* conditional.
|
|
53
|
+
* - Canonical HTTP header keys (`../requests/header-keys.shared`):
|
|
54
|
+
* `WildoHeaderKeys` (already a zero-dep `as const` atom — re-exported
|
|
55
|
+
* whole; per K-2 splitting it would itself violate DRY).
|
|
56
|
+
* - Locale enums (re-exported transparently from
|
|
57
|
+
* `@wildo-ai/presets-components-models/public-runtime`):
|
|
58
|
+
* `AvailableLanguage`, `TextDirection`. Consumers see ONE import path
|
|
59
|
+
* (`@wildo-ai/saas-models/public-runtime`) — the
|
|
60
|
+
* `presets-components-models/public-runtime` subpath is an internal
|
|
61
|
+
* seam (saas-models-public-runtime.md K-6).
|
|
62
|
+
*
|
|
63
|
+
* @wildo-boundary (saas-models-public-runtime.md K-3)
|
|
64
|
+
* - This file and every file it transitively imports MUST NOT import from:
|
|
65
|
+
* `@wildo-ai/zod-decorators`, `@wildo-ai/external-connectors-models`,
|
|
66
|
+
* the `@wildo-ai/presets-components-models` ROOT barrel (only the
|
|
67
|
+
* `/public-runtime` subpath of that package is allowed), `inversify`,
|
|
68
|
+
* `reflect-metadata`, `mongoose`, `axios`, `express`, `socket.io`,
|
|
69
|
+
* `pino`, `helmet`, `argon2`, `bcrypt`, `jsonwebtoken`.
|
|
70
|
+
* - DO NOT import from this package's ROOT barrel (`../index`) — that
|
|
71
|
+
* barrel runs `initZodDecorators()` and pulls the full schema tree.
|
|
72
|
+
* - Allowed imports: `zod` (peer dep, browser-safe), files inside
|
|
73
|
+
* `./public-runtime/`, the atom files extracted by Steps 1 + 2 of the
|
|
74
|
+
* plan, and the
|
|
75
|
+
* `@wildo-ai/presets-components-models/public-runtime` subpath.
|
|
76
|
+
*
|
|
77
|
+
* @wildo-bundle-budget
|
|
78
|
+
* The output of this barrel + transitive imports MUST stay free of:
|
|
79
|
+
* `initZodDecorators()` invocation, `reflect-metadata`, the full
|
|
80
|
+
* `authentication.shared.dto.schemas.ts` web of types
|
|
81
|
+
* (`UserContextSchema`, `SessionType`, `AuthMethod`, `AuthFactorLevel`,
|
|
82
|
+
* `AuthSessionPurpose`, `AuthUtils`). The Step 5 vitest boundary test
|
|
83
|
+
* snapshots `Object.getOwnPropertyNames(z.ZodType.prototype)` before and
|
|
84
|
+
* after importing this module and asserts the prototype is unchanged
|
|
85
|
+
* (proof that `initZodDecorators` did NOT run).
|
|
86
|
+
*
|
|
87
|
+
* @wildo-dry-contract
|
|
88
|
+
* Every atom exposed here lives in EXACTLY one source file. The original
|
|
89
|
+
* home (e.g. `authentication.shared.dto.schemas.ts`,
|
|
90
|
+
* `localization/language.shared.schemas.ts`) re-exports from the same atom
|
|
91
|
+
* so existing root-barrel consumers keep working unchanged. Adding a new
|
|
92
|
+
* atom: split it out of its current heavy file FIRST (matching K-2
|
|
93
|
+
* protocol), add a re-export at the original home, then add the import
|
|
94
|
+
* here. NEVER duplicate a declaration into a `_public-runtime/` folder.
|
|
95
|
+
*/
|
|
96
|
+
|
|
97
|
+
export {
|
|
98
|
+
CrossFrontendHandoffErrorCode,
|
|
99
|
+
CrossFrontendHandoffRequestSchema,
|
|
100
|
+
CrossFrontendHandoffResponseSchema,
|
|
101
|
+
TokenExchangeRequestSchema,
|
|
102
|
+
TokenExchangeResponseSchema,
|
|
103
|
+
type CrossFrontendHandoffRequest,
|
|
104
|
+
type CrossFrontendHandoffResponse,
|
|
105
|
+
type TokenExchangeRequest,
|
|
106
|
+
type TokenExchangeResponse,
|
|
107
|
+
} from '../security/authentications/cross-frontend-handoff.shared.dto.schemas';
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* The single same-origin redirect predicate.
|
|
111
|
+
*
|
|
112
|
+
* On the bundle-safe seam because the two BROWSER receivers of a post-authentication redirect — the
|
|
113
|
+
* SaaS app (`saas-frontend-lib`) and the docs site (`saas-technical-doc`) — are client-bundle targets
|
|
114
|
+
* by construction, while the ISSUER-side schema in this package validates the same value on the
|
|
115
|
+
* server. All three must reach one predicate or they drift; they already had, in the same direction,
|
|
116
|
+
* across four hand-written copies. The source atom is import-free, so it adds nothing to the budget.
|
|
117
|
+
*/
|
|
118
|
+
export { isSameOriginRedirectPath } from '../security/authentications/same-origin-redirect-path.shared';
|
|
119
|
+
|
|
120
|
+
export { WildoHeaderKeys } from '../requests/header-keys.shared';
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Main API mount prefix (`/api/v1`) — the SINGLE SOURCE OF TRUTH for the path
|
|
124
|
+
* under which the entire main controllers registry is served. Exposed on the
|
|
125
|
+
* bundle-safe seam because browser-bound runtimes that call the SaaS backend
|
|
126
|
+
* (e.g. the docs auth client's token-exchange / cross-frontend-handoff
|
|
127
|
+
* requests) must prefix their request URLs with the SAME value the backend
|
|
128
|
+
* mounts and the SaaS-app HTTP client uses. Deriving every consumer from one
|
|
129
|
+
* symbol is what prevents the prefix-drift class — a mismatched prefix
|
|
130
|
+
* silently breaks auth (see the refresh-cookie `Path` regression that
|
|
131
|
+
* motivated the shared symbol). The source atom
|
|
132
|
+
* (`../requests/manual-controllers-routes-urls`) is import-free, so it adds
|
|
133
|
+
* nothing to the decorator-free bundle budget.
|
|
134
|
+
*/
|
|
135
|
+
export { MAIN_API_BASE_PATH } from '../requests/manual-controllers-routes-urls';
|
|
136
|
+
|
|
137
|
+
export { AppFrontendType } from '../config/app-frontend-type.shared.schemas';
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Canonical Zod-issue rendering. Browser-bound runtimes validate untrusted
|
|
141
|
+
* input too — MDX frontmatter at build time, API responses at runtime — and
|
|
142
|
+
* each one previously re-derived its own `path: message` formatter, drifting on
|
|
143
|
+
* root labels and truncation. The source atom is import-free (the issue shape is
|
|
144
|
+
* structural, not a `zod` type import), so it adds nothing to the bundle budget.
|
|
145
|
+
*/
|
|
146
|
+
export {
|
|
147
|
+
ALL_ZOD_ISSUES,
|
|
148
|
+
DEFAULT_ZOD_ISSUE_RENDER_LIMIT,
|
|
149
|
+
ZOD_ROOT_ISSUE_PATH_LABEL,
|
|
150
|
+
formatZodIssue,
|
|
151
|
+
formatZodIssues,
|
|
152
|
+
summarizeZodIssues,
|
|
153
|
+
type FormattableZodIssue,
|
|
154
|
+
type ZodIssueFormattingOptions,
|
|
155
|
+
} from '../errors/zod-issue-formatting.shared.utils';
|
|
156
|
+
|
|
157
|
+
export {
|
|
158
|
+
AvailableLanguage,
|
|
159
|
+
TextDirection,
|
|
160
|
+
} from '@wildo-ai/presets-components-models/public-runtime';
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Provider metadata atom (provider-registration-refactor §Phase 0.1 +
|
|
164
|
+
* §Phase 1.g). The schema is built with plain Zod (no decorator
|
|
165
|
+
* framework) and the type is `z.infer<…>`. Re-exported here so the
|
|
166
|
+
* browser-bound `@wildo-ai/external-connectors-public/app`,
|
|
167
|
+
* `@wildo-ai/external-connectors-public/techdoc`, and
|
|
168
|
+
* `@wildo-ai/external-connectors-public/website` can consume it WITHOUT
|
|
169
|
+
* pulling the saas-models
|
|
170
|
+
* root barrel (which would boot `initZodDecorators()`).
|
|
171
|
+
*/
|
|
172
|
+
export {
|
|
173
|
+
buildProviderDisplayNameLabelKey,
|
|
174
|
+
ProviderMetadataSchema,
|
|
175
|
+
type ProviderMetadata,
|
|
176
|
+
} from '../external-providers/provider-metadata.shared.schemas';
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Frontend-provider bootstrap atoms shared by browser-bound runtimes.
|
|
180
|
+
*
|
|
181
|
+
* Safe for `/public-runtime` because the entry/block schemas depend only on
|
|
182
|
+
* plain Zod plus `ProviderMetadataSchema`; the heavier
|
|
183
|
+
* `AppConfiguration_FrontendBootstrapResponse` contract stays on the root-barrel
|
|
184
|
+
* side.
|
|
185
|
+
*/
|
|
186
|
+
export {
|
|
187
|
+
FrontendProviderEntrySchema,
|
|
188
|
+
FrontendProvidersBlockSchema,
|
|
189
|
+
type FrontendProviderEntry,
|
|
190
|
+
type FrontendProvidersBlock,
|
|
191
|
+
} from '../external-providers/frontend-provider-entry.shared.schemas';
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Provider capability atoms (provider-registration-refactor §Phase 0.2
|
|
195
|
+
* + §Phase 1.g). Closed built-in enum + open declaration-merging seam
|
|
196
|
+
* + computed union type. Pure types and `as const` — no Zod, no
|
|
197
|
+
* decorators, no side effects. Required by every facet's provider
|
|
198
|
+
* module shape, so it MUST live on the bundle-safe seam.
|
|
199
|
+
*/
|
|
200
|
+
export {
|
|
201
|
+
BUILTIN_PROVIDER_CAPABILITY,
|
|
202
|
+
type BuiltinProviderCapability,
|
|
203
|
+
type AppCustomProviderCapabilities,
|
|
204
|
+
type ProviderCapability,
|
|
205
|
+
} from '../external-providers/provider-capability.shared.schemas';
|
|
206
|
+
export {
|
|
207
|
+
BUILTIN_PROVIDER_PROTOCOL,
|
|
208
|
+
type BuiltinProviderProtocol,
|
|
209
|
+
type ProviderProtocol,
|
|
210
|
+
} from '../external-providers/provider-protocol.shared.schemas';
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Generic registry composition core (provider-registration-refactor
|
|
214
|
+
* §Phase 1.e + §Phase 1.g). Used by every facet's `compose<Facet>Providers`
|
|
215
|
+
* wrapper (backend, frontend-app, frontend-techdoc, frontend-website).
|
|
216
|
+
* The browser-bound facets need this on the bundle-safe seam; the backend
|
|
217
|
+
* facet inherits via the same import path for DRY.
|
|
218
|
+
*
|
|
219
|
+
* Pure runtime — only TYPE-imports `ProviderCapability` from the atom
|
|
220
|
+
* above, so the closure stays decorator-free.
|
|
221
|
+
*/
|
|
222
|
+
export {
|
|
223
|
+
composeProviderRegistry,
|
|
224
|
+
ProviderCompositionConflictError,
|
|
225
|
+
type ProviderRegistryFragment,
|
|
226
|
+
type ComposedProviderRegistry,
|
|
227
|
+
type ProviderCompositionConflict,
|
|
228
|
+
} from '../external-providers/compose-provider-registry.shared';
|
|
229
|
+
```
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# saas.rag.retrieval-bounds
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Every bound this call hit, and every row it dropped — returned on `result.truncation`.
|
|
14
|
+
*
|
|
15
|
+
* Imported from `@wildo-ai/saas-backend-lib`. Reported ALWAYS, never only when something was cut:
|
|
16
|
+
* "the corpus had nothing", "the budget ran out" and "you may not read those rows" are three
|
|
17
|
+
* different answers, and a caller that cannot tell them apart tunes the wrong thing — usually by
|
|
18
|
+
* raising a limit that was never the constraint.
|
|
19
|
+
*
|
|
20
|
+
* **Read the flags to decide whether to ask again; read the counters to decide whether to worry.**
|
|
21
|
+
* A flag means a BOUND bit, so a narrower query or a higher `limit` may return more. A counter means
|
|
22
|
+
* rows were REMOVED after matching, and the three counters are deliberately not one number:
|
|
23
|
+
* `droppedUnreadableRows` and `droppedUnreadableRelatedRows` are the access boundary working as
|
|
24
|
+
* designed and need no action, while `droppedByReadFailure` is an operator problem — a missing READ
|
|
25
|
+
* operation or a datastore fault. Summing them would report an outage as a permissions result.
|
|
26
|
+
*
|
|
27
|
+
* The numeric ceilings behind the flags are framework-owned and readable on
|
|
28
|
+
* {@link RAG_RETRIEVAL_DEFAULTS}; only the context-character budget is caller-settable, through
|
|
29
|
+
* `maxContextCharacters`.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* // Distinguish "there is more" from "we could not read some of it".
|
|
33
|
+
* if (result.truncation.reachedContextCharacterBudget) {
|
|
34
|
+
* // The answer is complete for the budget given — raise it, or ask a narrower question.
|
|
35
|
+
* }
|
|
36
|
+
* if (result.truncation.droppedByReadFailure > 0) {
|
|
37
|
+
* logger.warn('Some matched rows could not be read', result.truncation);
|
|
38
|
+
* }
|
|
39
|
+
*/
|
|
40
|
+
export interface RagRetrievalTruncationReport {
|
|
41
|
+
/** The chunk search returned `limit` hits — more may exist. */
|
|
42
|
+
reachedHitLimit: boolean;
|
|
43
|
+
/** At least one hit row had more expandable related rows than the per-hit ceiling. */
|
|
44
|
+
reachedRelatedRowsPerHitCeiling: boolean;
|
|
45
|
+
/** The call hit the whole-call expansion ceiling; later hits were not expanded. */
|
|
46
|
+
reachedTotalExpandedRowsCeiling: boolean;
|
|
47
|
+
/** The assembled context reached the character budget; later rows were not included. */
|
|
48
|
+
reachedContextCharacterBudget: boolean;
|
|
49
|
+
/** Rows whose chunks matched but whose row the caller could not read — GATE 2 drops. */
|
|
50
|
+
droppedUnreadableRows: number;
|
|
51
|
+
/** Related rows the caller could not read — the per-hop access check doing its job. */
|
|
52
|
+
droppedUnreadableRelatedRows: number;
|
|
53
|
+
/**
|
|
54
|
+
* Rows dropped because the READ could not be ATTEMPTED or FAILED — NOT because the caller lacked
|
|
55
|
+
* authority. Counted apart from the two above deliberately: an access decision and a broken read
|
|
56
|
+
* are different problems, and conflating them makes a datastore fault, a resource that exposes no
|
|
57
|
+
* usable READ operation, or a retrieval invoked from too deep inside another operation read as a
|
|
58
|
+
* permissions result. A non-zero value here is worth an alert; the two counters above are not.
|
|
59
|
+
*/
|
|
60
|
+
droppedByReadFailure: number;
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
65
|
+
|
|
66
|
+
```typescript
|
|
67
|
+
/**
|
|
68
|
+
* The framework-owned bounds every retrieval call enforces, exposed so a caller can READ the number
|
|
69
|
+
* a truncation flag refers to instead of guessing it.
|
|
70
|
+
*
|
|
71
|
+
* Imported from `@wildo-ai/saas-backend-lib`. Frozen, and deliberately not configuration: only
|
|
72
|
+
* `limit` and `maxContextCharacters` are caller-settable (both clamped by the values here), because
|
|
73
|
+
* every other bound protects a cost the caller does not pay locally — an unbounded index scan, a
|
|
74
|
+
* fan-out of authorized reads, or a prompt that silently outgrows a model's window.
|
|
75
|
+
*
|
|
76
|
+
* - `DEFAULT_HIT_LIMIT` / `MAX_HIT_LIMIT` — chunk hits per call when unspecified, and the ceiling
|
|
77
|
+
* a larger `limit` is clamped to.
|
|
78
|
+
* - `CANDIDATE_POOL_MULTIPLIER` / `MAX_CANDIDATE_POOL` — how many rows each search arm may consider
|
|
79
|
+
* before the two are fused. Internal to ranking quality; nothing a caller acts on.
|
|
80
|
+
* - `MAX_EXPANSION_HOPS` — always 1. A CONSTANT, not a parameter: two hops fan out
|
|
81
|
+
* multiplicatively and need cycle detection, so multi-hop traversal is a different capability
|
|
82
|
+
* rather than a bigger number here.
|
|
83
|
+
* - `MAX_RELATED_ROWS_PER_HIT` / `MAX_TOTAL_EXPANDED_ROWS` — related rows admitted per matched row,
|
|
84
|
+
* and across the whole call. Reaching either raises the matching `truncation` flag.
|
|
85
|
+
* - `MAX_RELATED_ROW_TEXT_CHARS` — text carried from any ONE related row; its header is always
|
|
86
|
+
* kept. Reaching it sets that related row's `textTruncated`.
|
|
87
|
+
* - `DEFAULT_CONTEXT_CHARACTER_BUDGET` — assembled-context characters when the caller names none.
|
|
88
|
+
*
|
|
89
|
+
* @example
|
|
90
|
+
* // Report a ceiling honestly, using the number the framework actually applied.
|
|
91
|
+
* if (result.truncation.reachedTotalExpandedRowsCeiling) {
|
|
92
|
+
* logger.info(`Expansion stopped at ${RAG_RETRIEVAL_DEFAULTS.MAX_TOTAL_EXPANDED_ROWS} related rows.`);
|
|
93
|
+
* }
|
|
94
|
+
*/
|
|
95
|
+
export const RAG_RETRIEVAL_DEFAULTS = Object.freeze({
|
|
96
|
+
DEFAULT_HIT_LIMIT,
|
|
97
|
+
MAX_HIT_LIMIT,
|
|
98
|
+
CANDIDATE_POOL_MULTIPLIER,
|
|
99
|
+
MAX_CANDIDATE_POOL,
|
|
100
|
+
MAX_EXPANSION_HOPS,
|
|
101
|
+
MAX_RELATED_ROWS_PER_HIT,
|
|
102
|
+
MAX_TOTAL_EXPANDED_ROWS,
|
|
103
|
+
MAX_RELATED_ROW_TEXT_CHARS,
|
|
104
|
+
DEFAULT_CONTEXT_CHARACTER_BUDGET,
|
|
105
|
+
});
|
|
106
|
+
```
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# saas.rag.retrieval-refusals
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Why a resource type with a corpus contributed nothing — the closed vocabulary of refusals.
|
|
14
|
+
*
|
|
15
|
+
* Imported from `@wildo-ai/saas-backend-lib`. Reported per call on the result's
|
|
16
|
+
* `refusedResourceTypes`, so a caller can always tell a refusal from an empty corpus.
|
|
17
|
+
*
|
|
18
|
+
* **These are DATA, not errors.** A retrieval call does not throw when a resource type is refused;
|
|
19
|
+
* it searches everything else and names what it skipped. That is the whole point — an answer built
|
|
20
|
+
* from three of four resource types is still a good answer, and the caller is the only party that
|
|
21
|
+
* knows whether the missing one mattered. Read this list; do not ignore it and do not treat a
|
|
22
|
+
* non-empty list as a failure.
|
|
23
|
+
*
|
|
24
|
+
* **Only one member is an access decision.** {@link OPERATION_ROLES_DENIED} means this caller may
|
|
25
|
+
* not read this resource type, and is working as designed — it will differ from caller to caller
|
|
26
|
+
* and needs no fix. Every other member describes a configuration or topology fact that is the same
|
|
27
|
+
* for every caller, and therefore names something an operator can actually repair.
|
|
28
|
+
*
|
|
29
|
+
* Declared as ONE enum rather than reusing the scope authority's own binding vocabulary verbatim,
|
|
30
|
+
* because the two populations only overlap: two members mirror a scope-authority decision and two
|
|
31
|
+
* describe a failure the scope authority never sees. A `reason` field typed as the union of two
|
|
32
|
+
* enums would make "which vocabulary is this value from?" a question every reader has to answer.
|
|
33
|
+
*/
|
|
34
|
+
export enum RagRetrievalRefusalReason {
|
|
35
|
+
/** The execution context resolves no value on the resource's declared scope axis (fail closed). */
|
|
36
|
+
UNRESOLVED_CALLER_SCOPE = 'unresolved-caller-scope',
|
|
37
|
+
/** The resource's scope axis is one the chunk tier does not denormalize (today: ANONYMOUS). */
|
|
38
|
+
UNREPRESENTABLE_SCOPE_AXIS = 'unrepresentable-scope-axis',
|
|
39
|
+
/** The resource declares RAG fields but its configuration could not be resolved (an orphan type). */
|
|
40
|
+
RESOURCE_CONFIGURATION_UNAVAILABLE = 'resource-configuration-unavailable',
|
|
41
|
+
/** The RAG-source field walk threw for this resource — its corpus cannot be characterised. */
|
|
42
|
+
RAG_FIELD_DETECTION_FAILED = 'rag-field-detection-failed',
|
|
43
|
+
/**
|
|
44
|
+
* The caller's ROLES do not admit the resource's READ operation (gate 0).
|
|
45
|
+
*
|
|
46
|
+
* An ACCESS DECISION, and the only member of this enum that is one — every other reason describes
|
|
47
|
+
* a configuration or topology fact that is the same for every caller. Kept separate from
|
|
48
|
+
* {@link UNRESOLVED_CALLER_SCOPE} for exactly that reason: that one says "we could not tell WHICH
|
|
49
|
+
* rows are yours", this one says "you may not read this type at all", and collapsing them would
|
|
50
|
+
* make an operator reading the report unable to tell a misconfigured scope axis from a working
|
|
51
|
+
* refusal. The refusal itself is also recorded as `RESOURCE_OPERATION_DENIED` by the authorizer.
|
|
52
|
+
*/
|
|
53
|
+
OPERATION_ROLES_DENIED = 'operation-roles-denied',
|
|
54
|
+
/**
|
|
55
|
+
* The READ authorization context for this resource could not be BUILT, so its role gate could not
|
|
56
|
+
* be evaluated at all: the resource exposes no resolvable READ operation, or the sub-call budget
|
|
57
|
+
* (depth / cycle detection) refused the context.
|
|
58
|
+
*
|
|
59
|
+
* Deliberately NOT folded into {@link OPERATION_ROLES_DENIED}. That one is an answer; this one is
|
|
60
|
+
* the absence of a question, and reporting an unbuildable context as a role refusal would send an
|
|
61
|
+
* operator to the role table for a configuration defect. A question that cannot be asked is still
|
|
62
|
+
* answered NO — the resource is not searched — but the report must say which happened.
|
|
63
|
+
*/
|
|
64
|
+
READ_AUTHORITY_UNRESOLVABLE = 'read-authority-unresolvable',
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Why a resource type contributed nothing — reported per call so a fail-closed refusal is VISIBLE.
|
|
69
|
+
*
|
|
70
|
+
* A silent zero is the failure mode this exists to prevent: "retrieval returned nothing" and
|
|
71
|
+
* "retrieval refused to look" are operationally different answers, and only one of them is a
|
|
72
|
+
* configuration problem an operator can fix.
|
|
73
|
+
*
|
|
74
|
+
* @example
|
|
75
|
+
* // Surface a repairable refusal; stay quiet about a working permission boundary.
|
|
76
|
+
* const repairable = result.refusedResourceTypes.filter(
|
|
77
|
+
* (refusal) => refusal.reason !== RagRetrievalRefusalReason.OPERATION_ROLES_DENIED,
|
|
78
|
+
* );
|
|
79
|
+
* for (const refusal of repairable) {
|
|
80
|
+
* logger.warn(`Corpus skipped for ${refusal.resourceType}: ${refusal.detail}`);
|
|
81
|
+
* }
|
|
82
|
+
*/
|
|
83
|
+
export interface RagRetrievalResourceRefusal {
|
|
84
|
+
resourceType: ResourceType;
|
|
85
|
+
reason: RagRetrievalRefusalReason;
|
|
86
|
+
/** Operator-facing sentence naming what was missing and what would admit the resource. */
|
|
87
|
+
detail: string;
|
|
88
|
+
}
|
|
89
|
+
```
|