@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,174 @@
|
|
|
1
|
+
# saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* First concrete producer for the participation-prefetch tier (Slice K).
|
|
14
|
+
*
|
|
15
|
+
* Sub-anchor of `loading-aggregation.participation-prefetch`. Defines the
|
|
16
|
+
* contract for the framework-shipped producer pair:
|
|
17
|
+
*
|
|
18
|
+
* - **`useExecutionParticipationPrefetch`** — generic primitive hook. Owns
|
|
19
|
+
* the begin/end pairing for `ExecutionPendingPrefetch` entries, the
|
|
20
|
+
* `AbortController`-driven cancellation on unmount / re-run, the
|
|
21
|
+
* stable per-mount `prefetchKey`, and the optional bridge of failures
|
|
22
|
+
* into `execution.errors.failedActions` under
|
|
23
|
+
* `ExecutionFailedActionScope.PARTICIPATION_PREFETCH`. Consumers
|
|
24
|
+
* provide an async `run({ signal })` callback that performs the actual
|
|
25
|
+
* work — typical use is a `doOperation()` invocation, but the hook is
|
|
26
|
+
* intentionally fetch-mechanism-agnostic so future producers (a
|
|
27
|
+
* relationship-projection source-resource hydrator, a lazy-binding
|
|
28
|
+
* resolver) can reuse the same lifecycle plumbing without adopting
|
|
29
|
+
* `doOperation()` semantics they do not need.
|
|
30
|
+
*
|
|
31
|
+
* - **`useExecutionParticipationDataPrefetch`** — opinionated wrapper over
|
|
32
|
+
* the primitive that targets the most common case: hydrate a single
|
|
33
|
+
* participation's resource data via `doOperation()` (the canonical
|
|
34
|
+
* READ operation for the resolved resource type). Consumers pass
|
|
35
|
+
* `{ participationRef, intent }` and receive
|
|
36
|
+
* `{ data, isLoading, error, refetch, prefetchKey }`. The wrapper
|
|
37
|
+
* threads `intent`, computes the operation path key from the
|
|
38
|
+
* participation's resource type, supplies the AbortController, and
|
|
39
|
+
* defaults `bridgeFailuresToShellAggregator` per-intent (see invariant
|
|
40
|
+
* #6 below).
|
|
41
|
+
*
|
|
42
|
+
* **Why two layers (decision: layered API).** A single opinionated hook
|
|
43
|
+
* would force every future producer (relationship-projection hydrator,
|
|
44
|
+
* lazy-binding resolver, …) to either go through the same READ-shaped
|
|
45
|
+
* `doOperation()` path or drop to the raw nav helpers and duplicate the
|
|
46
|
+
* lifecycle plumbing. A single primitive-only hook would push the
|
|
47
|
+
* "fetch a participation's data" boilerplate (operation path key
|
|
48
|
+
* derivation, intent-driven bridge default, single-ref shape) onto every
|
|
49
|
+
* call site of the most common case. Layering the two solves both:
|
|
50
|
+
* primitive owns lifecycle, wrapper owns the canonical fetch shape, and
|
|
51
|
+
* consumers pick whichever level matches their use case. Rejected
|
|
52
|
+
* alternatives: (a) primitive only — common-case boilerplate cost,
|
|
53
|
+
* (b) wrapper only — fetch-mechanism rot risk for future producers,
|
|
54
|
+
* (c) wrapper as method on `useExecution()` — would couple the public
|
|
55
|
+
* `useExecution()` surface to a single fetch shape and obscure the
|
|
56
|
+
* primitive seam.
|
|
57
|
+
*
|
|
58
|
+
* **Why call `doOperation()` directly, not `actions.operation().execute()`
|
|
59
|
+
* (decision: `fetch-doOperation-direct`).** `actions.operation().execute()`
|
|
60
|
+
* registers a `pendingAction` in the *execute-action* tier, which would
|
|
61
|
+
* double-count the same logical work in `loading.isBusy` (once via the
|
|
62
|
+
* pending action, once via the prefetch entry) and would trigger the
|
|
63
|
+
* shell's failure-handling-contract bridge for both tiers. The wrapper
|
|
64
|
+
* therefore calls `navigation.doOperation(...)` directly inside the
|
|
65
|
+
* `run({ signal })` callback, keeping the prefetch tier semantically
|
|
66
|
+
* separate from the execute-action tier. The action-status snapshot's
|
|
67
|
+
* JSDoc already documents that prefetches don't carry an
|
|
68
|
+
* `operationPathKey` correlation key — this is the producer side of
|
|
69
|
+
* that decision: prefetches are not "actions" the framework can retry
|
|
70
|
+
* via `action.retry()`; they are revalidation cycles the consumer
|
|
71
|
+
* controls via `refetch()`. Rejected alternative: route through
|
|
72
|
+
* `execute()` for "free" outcome emission and consistency — the
|
|
73
|
+
* double-tier accounting and re-emit risk outweigh the consistency win.
|
|
74
|
+
*
|
|
75
|
+
* Contract invariants (specialization of the parent sub-anchor's
|
|
76
|
+
* invariants):
|
|
77
|
+
*
|
|
78
|
+
* 1. **Stable `prefetchKey` per logical unit.** The hook caches a
|
|
79
|
+
* `prefetchKey` per mount (typically derived from the consumer's
|
|
80
|
+
* keying inputs — resource type + participation ref + intent — or
|
|
81
|
+
* explicitly authored). The same key is reused across consecutive
|
|
82
|
+
* `refetch()` cycles so the shell's
|
|
83
|
+
* `clearFailedActionsForPrefetchKey(key)` verb can drop matching
|
|
84
|
+
* entries on the next successful settle. Distinct from
|
|
85
|
+
* `prefetchRuntimeId`, which rotates on every fire so the parent
|
|
86
|
+
* sub-anchor's invariant #1 ("producer-minted ids; same-id
|
|
87
|
+
* re-register is idempotent-by-overwrite") is honored without the
|
|
88
|
+
* consumer having to think about it.
|
|
89
|
+
*
|
|
90
|
+
* 2. **One in-flight unit per hook instance.** A new `run()` while a
|
|
91
|
+
* prior one is in flight aborts the prior `AbortController` and
|
|
92
|
+
* `endParticipationPrefetch`es the prior `prefetchRuntimeId` before
|
|
93
|
+
* minting a fresh id and beginning the new unit. Prevents two
|
|
94
|
+
* concurrent units from accumulating in `pendingPrefetches` for the
|
|
95
|
+
* same logical key (which would inflate `isBusy` and confuse
|
|
96
|
+
* per-ref UX). Consumers who legitimately want parallel hydration
|
|
97
|
+
* of distinct participations mount distinct hook instances — one
|
|
98
|
+
* instance per logical unit is the framework rule, mirroring the
|
|
99
|
+
* `useEffect`-per-effect pattern.
|
|
100
|
+
*
|
|
101
|
+
* 3. **Settle always clears (parent invariant #2 specialization).** The
|
|
102
|
+
* primitive's `try`/`finally` around the consumer's `run(...)`
|
|
103
|
+
* guarantees `endParticipationPrefetch(prefetchRuntimeId)` runs on
|
|
104
|
+
* success, throw, AND `AbortError`. On unmount, the cleanup branch
|
|
105
|
+
* aborts the controller and ends the prefetch synchronously — the
|
|
106
|
+
* in-flight `doOperation()` rejection arrives later in a no-op
|
|
107
|
+
* settle (the runtime id is already gone, so `endParticipationPrefetch`
|
|
108
|
+
* is a no-op per the public JSDoc).
|
|
109
|
+
*
|
|
110
|
+
* 4. **Stale-while-revalidate for `REFRESH`.** When `intent === REFRESH`,
|
|
111
|
+
* the wrapper keeps the prior `data` value visible while the new
|
|
112
|
+
* fetch is in flight (returning `{ data: <stale>, isLoading: true,
|
|
113
|
+
* error }`). When `intent === INITIAL`, `data` is `undefined` until
|
|
114
|
+
* the first successful settle. This split mirrors the parent
|
|
115
|
+
* sub-anchor's intent classification ("full-screen skeleton" vs
|
|
116
|
+
* "subtle indicator") on the data side.
|
|
117
|
+
*
|
|
118
|
+
* 5. **Latest-error surfacing.** The hook always surfaces the *latest*
|
|
119
|
+
* settle's `error` (or `undefined` on success) in its return value —
|
|
120
|
+
* `error` is reset to `undefined` on every successful settle and is
|
|
121
|
+
* set to the rejection on every failed one. This is the consumer's
|
|
122
|
+
* primary error-display channel; the optional shell-aggregator
|
|
123
|
+
* bridge (next invariant) is for cross-component aggregation and
|
|
124
|
+
* persistent failure history.
|
|
125
|
+
*
|
|
126
|
+
* 6. **Optional shell-aggregator bridge (`bridgeFailuresToShellAggregator`).**
|
|
127
|
+
* When `true` (the wrapper's default for `INITIAL`, opt-in for
|
|
128
|
+
* `REFRESH`), failures are also captured via
|
|
129
|
+
* `execution.errors.capture({ scope: PARTICIPATION_PREFETCH,
|
|
130
|
+
* prefetchKey, ... })`, where they participate in the cross-component
|
|
131
|
+
* `failedActions` aggregator and auto-prune on the next successful
|
|
132
|
+
* settle for the same key (via
|
|
133
|
+
* `clearFailedActionsForPrefetchKey(prefetchKey)`, called by the hook).
|
|
134
|
+
* When `false`, failures are surfaced only via the hook's `error`
|
|
135
|
+
* return value — the right choice for "background revalidation that
|
|
136
|
+
* must not raise a global banner". The default split (INITIAL=true,
|
|
137
|
+
* REFRESH=false in the wrapper) reflects the typical UX: an initial
|
|
138
|
+
* hydration failure is noteworthy enough to surface globally; a
|
|
139
|
+
* silent revalidation failure usually is not. The primitive defaults
|
|
140
|
+
* to `false` (consumers explicitly opt in) because it has no
|
|
141
|
+
* intent-aware default to lean on.
|
|
142
|
+
*
|
|
143
|
+
* 7. **No retry verb.** Refetch is the only retry pattern. The hook
|
|
144
|
+
* exposes `refetch()` (re-runs with the same inputs); the shell does
|
|
145
|
+
* not synthesize a `retry()` analog of the action-status one because
|
|
146
|
+
* prefetches don't carry an `operationPathKey` correlation key (see
|
|
147
|
+
* `ExecutionOperationActionStatus.isPending` JSDoc on the per-tier
|
|
148
|
+
* separation). Consumers wanting "clear failure + refetch" call
|
|
149
|
+
* `refetch()` — the bridge auto-prunes the prior failure on
|
|
150
|
+
* successful settle.
|
|
151
|
+
*
|
|
152
|
+
* 8. **`PARTICIPATION_PREFETCH` scope is dedicated.** Failures bridged
|
|
153
|
+
* by these hooks land under `ExecutionFailedActionScope.PARTICIPATION_PREFETCH`
|
|
154
|
+
* (NOT `CUSTOM`), which is auto-cleared by
|
|
155
|
+
* `clearFailedActionsForPrefetchKey(prefetchKey)`. This is the
|
|
156
|
+
* fourth scope and exists specifically because the auto-prune
|
|
157
|
+
* lifecycle (per-key on successful settle) is genuinely distinct
|
|
158
|
+
* from the zone-transition-based pruning of `EMBEDDED_CONTENT` /
|
|
159
|
+
* `LOCAL_PANE` and the manual-only model of `CUSTOM`. See the
|
|
160
|
+
* failure-handling-contract anchor for the full scope vocabulary.
|
|
161
|
+
*
|
|
162
|
+
* **Where it composes with the rest of the shell.** A consumer view that
|
|
163
|
+
* needs to hydrate a participation's data ahead of an interaction (the
|
|
164
|
+
* Slice K dogfood: chrome banner showing `todoList.name`, inspector
|
|
165
|
+
* node hover prewarming the inspector pane) calls
|
|
166
|
+
* `useExecutionParticipationDataPrefetch({ participationRef, intent })`
|
|
167
|
+
* and threads the returned `{ data, isLoading, error }` into its UI.
|
|
168
|
+
* Per-tier loading questions still flow through the public aggregator:
|
|
169
|
+
* `execution.loading.isParticipationPrefetching((p) =>
|
|
170
|
+
* p.participationRefs.includes(ref))` answers "is *this ref* being
|
|
171
|
+
* hydrated?" from the chrome's perspective without knowing which hook
|
|
172
|
+
* mounted the prefetch.
|
|
173
|
+
*
|
|
174
|
+
```
|
package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# saas.frontend.execution-view.navigation-handling-and-embedding
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Execution navigation handling & embedding principle.
|
|
14
|
+
*
|
|
15
|
+
* An execution view has exactly two ways to move the user toward a downstream
|
|
16
|
+
* resource operation surface:
|
|
17
|
+
*
|
|
18
|
+
* 1. **`EMBED_LOCALLY`** — the execution shell mounts the resulting surface
|
|
19
|
+
* *inside itself* as locally embedded content. A single embedded-content
|
|
20
|
+
* slot is owned by the execution runtime; opening a new embed replaces the
|
|
21
|
+
* current one.
|
|
22
|
+
* 2. **`DELEGATE_TO_ROUTER`** — the execution view yields control to the app
|
|
23
|
+
* router (the "parent" navigation stack). The surface is rendered by the
|
|
24
|
+
* router's navigation zones, not by the execution shell.
|
|
25
|
+
*
|
|
26
|
+
* Invariants that make this a principle, not a convenience:
|
|
27
|
+
*
|
|
28
|
+
* - **Provenance is preserved either way.** Whether delegated or embedded, the
|
|
29
|
+
* target surface receives the same `NavigationInitiatorContext`
|
|
30
|
+
* (`sourceZone`, `launcher`, `sourceOperation`, `sourceRelationship`). An
|
|
31
|
+
* embedded read surface of a parent todo must behave indistinguishably from
|
|
32
|
+
* a routed read surface of that same todo.
|
|
33
|
+
* - **Transport is untouched.** Embedding only changes *where* the resulting
|
|
34
|
+
* surface mounts. `doOperation()` remains the read/orchestration transport;
|
|
35
|
+
* the Resource Mutation Manager remains the mutation runtime.
|
|
36
|
+
* - **Resource-exclusive.** Only `NavigationContent.RESOURCE_OPERATION` is
|
|
37
|
+
* embeddable today — not arbitrary React content. See
|
|
38
|
+
* `ExecutionEmbeddableContent`.
|
|
39
|
+
* - **Authored default, per-call override.** `ExecutionNavigationPolicyDefinition`
|
|
40
|
+
* on the view authors the default handling mode; action verbs on
|
|
41
|
+
* `execution.actions.operation(...)` can override per call (`embed()`,
|
|
42
|
+
* `navigate()`, `navigateToRead()`).
|
|
43
|
+
* - **One owner of the shell.** The `ExecutionView` component owns rendering
|
|
44
|
+
* of the embedded-content slot (including the close affordance). Consumers
|
|
45
|
+
* do not reinvent the shell.
|
|
46
|
+
*/
|
|
47
|
+
export enum ExecutionNavigationHandlingMode {
|
|
48
|
+
/** The execution shell mounts the resulting surface inside itself. */
|
|
49
|
+
EMBED_LOCALLY = 'embed-locally',
|
|
50
|
+
/** The execution view yields to the app router ("parent" navigation stack). */
|
|
51
|
+
DELEGATE_TO_ROUTER = 'delegate-to-router',
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export const ExecutionConcreteOperationIdentitySchema = z.union([
|
|
55
|
+
z.string().min(1),
|
|
56
|
+
z.tuple([z.string().min(1), z.string().min(1)]),
|
|
57
|
+
]);
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Per-operation override of the default navigation handling mode.
|
|
61
|
+
*
|
|
62
|
+
* Matches against a concrete resource operation (resource type + operation
|
|
63
|
+
* key, including variants) and replaces the policy's default handling mode
|
|
64
|
+
* for that single operation.
|
|
65
|
+
*/
|
|
66
|
+
export interface ExecutionNavigationPolicyExceptionRule {
|
|
67
|
+
resourceType: string;
|
|
68
|
+
operation: OperationKey;
|
|
69
|
+
handlingMode: ExecutionNavigationHandlingMode;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
export const ExecutionNavigationPolicyExceptionRuleSchema = z.object({
|
|
73
|
+
resourceType: ResourceTypeSchema,
|
|
74
|
+
operation: ExecutionConcreteOperationIdentitySchema,
|
|
75
|
+
handlingMode: z.enum(ExecutionNavigationHandlingMode),
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Declarative navigation handling policy attached to an execution view.
|
|
80
|
+
*
|
|
81
|
+
* `defaultHandlingMode` governs every operation the view reaches via its
|
|
82
|
+
* action verbs unless an `operationHandlingExceptions` entry matches. A view
|
|
83
|
+
* that does not declare a policy delegates to the router by default, which
|
|
84
|
+
* preserves the pre-embedding behavior.
|
|
85
|
+
*/
|
|
86
|
+
export interface ExecutionNavigationPolicyDefinition {
|
|
87
|
+
defaultHandlingMode: ExecutionNavigationHandlingMode;
|
|
88
|
+
operationHandlingExceptions?: ExecutionNavigationPolicyExceptionRule[];
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export const ExecutionNavigationPolicyDefinitionSchema = z.object({
|
|
92
|
+
defaultHandlingMode: z.enum(ExecutionNavigationHandlingMode)
|
|
93
|
+
.default(ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER),
|
|
94
|
+
operationHandlingExceptions: ExecutionNavigationPolicyExceptionRuleSchema.array().optional(),
|
|
95
|
+
});
|
|
96
|
+
```
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# saas.frontend.execution-view.navigation-handling-and-embedding.resolution
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Resolve the navigation handling mode for a single operation on an execution
|
|
14
|
+
* view. Applies the authored default first, then overrides with a matching
|
|
15
|
+
* `operationHandlingExceptions` entry if one is declared. This is the
|
|
16
|
+
* canonical decision point used by `execution.actions.operation(...).navigate()`
|
|
17
|
+
* to pick between embedding and router delegation.
|
|
18
|
+
*
|
|
19
|
+
* Companion span to the principle anchor
|
|
20
|
+
* `saas.frontend.execution-view.navigation-handling-and-embedding` (above
|
|
21
|
+
* — the policy enum + schema). Split into a dedicated `.resolution` anchor
|
|
22
|
+
* so the principle and its runtime resolver can be referenced
|
|
23
|
+
* independently in documentation.
|
|
24
|
+
*/
|
|
25
|
+
export function resolveExecutionNavigationHandlingMode(params: {
|
|
26
|
+
viewDefinition: Pick<ExecutionViewDefinition, 'navigationPolicy'>;
|
|
27
|
+
resourceType: string;
|
|
28
|
+
operation: Pick<
|
|
29
|
+
FrontendResourceConfiguration_Operation,
|
|
30
|
+
'operationIdentifier' | 'variantKey' | 'isOperationDefault'
|
|
31
|
+
>;
|
|
32
|
+
}): ExecutionNavigationHandlingMode {
|
|
33
|
+
const defaultHandlingMode = params.viewDefinition.navigationPolicy?.defaultHandlingMode
|
|
34
|
+
?? ExecutionNavigationHandlingMode.DELEGATE_TO_ROUTER;
|
|
35
|
+
const operationIdentity = buildExecutionConcreteOperationIdentity(params.operation);
|
|
36
|
+
const exception = params.viewDefinition.navigationPolicy?.operationHandlingExceptions?.find(
|
|
37
|
+
(candidate) => (
|
|
38
|
+
candidate.resourceType === params.resourceType
|
|
39
|
+
&& matchesExecutionConcreteOperationIdentity(candidate.operation, operationIdentity)
|
|
40
|
+
),
|
|
41
|
+
);
|
|
42
|
+
|
|
43
|
+
return exception?.handlingMode ?? defaultHandlingMode;
|
|
44
|
+
}
|
|
45
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# saas.frontend.execution-view.outcome-emission-contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* Execution-shell operation-outcome emission contract.
|
|
14
|
+
*
|
|
15
|
+
* The execution shell is a **canonical producer** on the app-level
|
|
16
|
+
* `FrontendEvents` bus (`EventBus`) for every successful `.execute()` call.
|
|
17
|
+
* It does *not* introduce a parallel execution-scoped outcome bus — the
|
|
18
|
+
* framework already has one (`RESOURCE_OPERATION_EXECUTED` + `RESOURCE_REFRESH`
|
|
19
|
+
* consumed by `NotificationContext`, `WebSocketEventBridge`, `useListInvalidation`,
|
|
20
|
+
* and `resourceRefreshEvent` subscribers). A second bus would double-plumb the
|
|
21
|
+
* same signal and force every subscriber to learn two APIs.
|
|
22
|
+
*
|
|
23
|
+
* Emission site: `useExecution().execute()` → `emitResourceOperationOutcome`
|
|
24
|
+
* (see `execution-outcome-emission.utils.ts`). Payloads mirror
|
|
25
|
+
* `useResourceOperationActions.handleExecuteOperation` exactly, so
|
|
26
|
+
* execution-shell-driven operations are indistinguishable from
|
|
27
|
+
* resource-layout-driven ones on the wire.
|
|
28
|
+
*
|
|
29
|
+
* Contract invariants:
|
|
30
|
+
*
|
|
31
|
+
* 1. **Single canonical bus.** No new public surface on `useExecution()` for
|
|
32
|
+
* outcomes. Consumers subscribe via `useEventBus` / `useEventSubscription`
|
|
33
|
+
* just like for any other operation producer. An execution-local bus
|
|
34
|
+
* would hide signals from app-global subscribers (toast policy, WS bridge,
|
|
35
|
+
* analytics) that must see every operation.
|
|
36
|
+
*
|
|
37
|
+
* 2. **Emit `RESOURCE_OPERATION_EXECUTED` unconditionally on success.**
|
|
38
|
+
* Every resolved `.execute()` is a canonical operation-outcome event.
|
|
39
|
+
* `NotificationContext` does *not* subscribe to this event (it is under
|
|
40
|
+
* `NEED_REFRESH`, not `NOTIFY_USER`), so emitting for READ / LIST / custom
|
|
41
|
+
* operations never produces unintended toasts. User-visible toasts travel
|
|
42
|
+
* on `NOTIFY_RESOURCE_*`, which the backend drives.
|
|
43
|
+
*
|
|
44
|
+
* 3. **Emit `RESOURCE_REFRESH` only for real mutations + WS disconnected.**
|
|
45
|
+
* Gate: `shouldEmitResourceRefreshAfterDirectOperation(operation)
|
|
46
|
+
* && !isWebSocketConnected`. When the WS bridge is up it pushes refreshes
|
|
47
|
+
* natively; emitting from here too would double-fire every listener.
|
|
48
|
+
* Non-mutating operations (READ / LIST / custom) never trigger list
|
|
49
|
+
* refreshes — refresh is an authored consequence of data change, not a
|
|
50
|
+
* signal of "some operation happened".
|
|
51
|
+
*
|
|
52
|
+
* 4. **Silent on failure.** Rejected promises do *not* emit an outcome
|
|
53
|
+
* event — subscribers use `.catch()` or the `NOTIFY_RESOURCE_ERROR`
|
|
54
|
+
* channel for failure UX. Emitting a failure variant here would force a
|
|
55
|
+
* specific error-UX on every consumer, which mirrors the dirty-state
|
|
56
|
+
* contract's "informative, not restrictive" stance.
|
|
57
|
+
*
|
|
58
|
+
* 5. **Emission before settle.** Emit fires *inside* the `try` block, *before*
|
|
59
|
+
* the `finally` clause calls `endPendingAction`. Subscribers that check
|
|
60
|
+
* `execution.loading.isBusy` during their handler therefore still see
|
|
61
|
+
* `true` — this matches `runPostOperationEffects` in
|
|
62
|
+
* `useResourceOperationActions`, which runs before its own
|
|
63
|
+
* `isExecuting = false` cleanup.
|
|
64
|
+
*
|
|
65
|
+
* 6. **Payload parity with canonical.** Shape, field names, and optional
|
|
66
|
+
* discriminator threading must match the emissions from
|
|
67
|
+
* `useResourceOperationActions` / `ResourceLayout_Update`. Any drift is a
|
|
68
|
+
* bug — downstream subscribers rely on a single uniform payload across
|
|
69
|
+
* producers.
|
|
70
|
+
*/
|
|
71
|
+
```
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# saas.frontend.execution-view.participation-and-anchor
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Execution view anchors, participation sources, and navigation policy enums/schemas.
|
|
14
|
+
*/
|
|
15
|
+
export enum ExecutionViewAnchorBindingSource {
|
|
16
|
+
PARENT_RESOURCE_REQUIREMENT = 'parent-resource-requirement',
|
|
17
|
+
ADDITIONAL_RESOURCE_REQUIREMENT = 'additional-resource-requirement',
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Declarative anchor contract for execution views.
|
|
22
|
+
*
|
|
23
|
+
* The anchor must point to one stable declared binding key instead of relying on
|
|
24
|
+
* requirement-array ordering or "first matching requirement" inference.
|
|
25
|
+
*/
|
|
26
|
+
export const ExecutionViewAnchorDefinitionSchema = z.object({
|
|
27
|
+
bindingKey: z.string().min(1),
|
|
28
|
+
source: z.enum(ExecutionViewAnchorBindingSource),
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
export interface ExecutionViewAnchorDefinition {
|
|
32
|
+
bindingKey: string;
|
|
33
|
+
source: ExecutionViewAnchorBindingSource;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export enum ExecutionParticipationSource {
|
|
37
|
+
ANCHOR = 'anchor',
|
|
38
|
+
PARENT_RESOURCE_REQUIREMENT = 'parent-resource-requirement',
|
|
39
|
+
ADDITIONAL_RESOURCE_REQUIREMENT = 'additional-resource-requirement',
|
|
40
|
+
RELATIONSHIP_PROJECTION = 'relationship-projection',
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const ExecutionParticipationAnchorDefinitionSchema = z.object({
|
|
44
|
+
source: z.literal(ExecutionParticipationSource.ANCHOR),
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
const ExecutionParticipationParentRequirementDefinitionSchema = z.object({
|
|
48
|
+
source: z.literal(ExecutionParticipationSource.PARENT_RESOURCE_REQUIREMENT),
|
|
49
|
+
bindingKey: z.string().min(1),
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
const ExecutionParticipationAdditionalRequirementDefinitionSchema = z.object({
|
|
53
|
+
source: z.literal(ExecutionParticipationSource.ADDITIONAL_RESOURCE_REQUIREMENT),
|
|
54
|
+
bindingKey: z.string().min(1),
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
const ExecutionParticipationRelationshipProjectionDefinitionSchema = z.object({
|
|
58
|
+
source: z.literal(ExecutionParticipationSource.RELATIONSHIP_PROJECTION),
|
|
59
|
+
fromParticipationRef: z.string().min(1),
|
|
60
|
+
targetResourceType: ResourceTypeSchema,
|
|
61
|
+
foreignKeyField: z.string().min(1).optional(),
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Authored execution participation contracts stay intentionally small.
|
|
66
|
+
*
|
|
67
|
+
* They identify one framework-native resolution source, but they do not
|
|
68
|
+
* duplicate derived relationship semantics, cardinality, or transport field
|
|
69
|
+
* mapping. Those details are resolved later from the existing registry and
|
|
70
|
+
* shared relationship helpers.
|
|
71
|
+
*/
|
|
72
|
+
export const ExecutionParticipationDefinitionSchema = z.discriminatedUnion('source', [
|
|
73
|
+
ExecutionParticipationAnchorDefinitionSchema,
|
|
74
|
+
ExecutionParticipationParentRequirementDefinitionSchema,
|
|
75
|
+
ExecutionParticipationAdditionalRequirementDefinitionSchema,
|
|
76
|
+
ExecutionParticipationRelationshipProjectionDefinitionSchema,
|
|
77
|
+
]);
|
|
78
|
+
|
|
79
|
+
export type ExecutionParticipationDefinition = z.infer<typeof ExecutionParticipationDefinitionSchema>;
|
|
80
|
+
```
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
# saas.frontend.execution-view.three-zone-contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* Three-zone contract for execution-view child intent.
|
|
14
|
+
*
|
|
15
|
+
* An execution view has exactly three zones where frontend-only state and
|
|
16
|
+
* child navigation intent can live. Each zone has a **distinct semantic
|
|
17
|
+
* purpose**, and a consumer must pick exactly one per intent. The zones are
|
|
18
|
+
* not stylistic variants — collapsing any two into each other destroys the
|
|
19
|
+
* execution shell's ability to reason about what it owns vs what the router
|
|
20
|
+
* owns.
|
|
21
|
+
*
|
|
22
|
+
* | Zone | Lives in | Payload | Owner | Purpose |
|
|
23
|
+
* |---|---|---|---|---|
|
|
24
|
+
* | **A. `embeddedContent`** | `ExecutionRuntimeState` | `ExecutionEmbeddableContent` (`NavigationContent.RESOURCE_OPERATION` only) | Execution shell (`ExecutionView`) | Mount a downstream resource-operation surface inside the shell instead of delegating to the router (the "embed" seam) |
|
|
25
|
+
* | **B. `localPane`** | `ExecutionRuntimeState` | `{ paneId: string; payload?: unknown }` — renderer-opaque data, **never** `NavigationContent` | Custom component (the view's own `viewComponent`) | Ephemeral shell state — inspectors, drawers, selection metadata. Not navigation content. |
|
|
26
|
+
* | **C. `delegateToParent`** | App router (parent navigation stack) | Any `NavigationContent` | App router | Yield control to the router. The execution view loses the screen for this intent. |
|
|
27
|
+
*
|
|
28
|
+
* Invariants that make this a contract, not three coincidental state fields:
|
|
29
|
+
*
|
|
30
|
+
* 1. **Mutual exclusivity by purpose.** A single intent picks exactly one
|
|
31
|
+
* zone. "Open a read surface next to the current view" is zone A. "Remember
|
|
32
|
+
* which node the user clicked" is zone B. "Send the user back to the home
|
|
33
|
+
* page" is zone C.
|
|
34
|
+
* 2. **No content-type confusion.** Zone A is resource-operation-only (typed
|
|
35
|
+
* as `ExecutionEmbeddableContent`). Zone B's `payload` is **not**
|
|
36
|
+
* `NavigationContent` — if a consumer finds itself tempted to put
|
|
37
|
+
* `{ contentType: NavigationContentType.RESOURCE_OPERATION, ... }` into a
|
|
38
|
+
* pane payload, that intent belongs in zone A. Zone C is the only zone
|
|
39
|
+
* that accepts arbitrary `NavigationContent`, and it hands it off.
|
|
40
|
+
* 3. **Shell owns the shell.** Zones A and B both live in
|
|
41
|
+
* `ExecutionRuntimeState`, but the rendering responsibility differs:
|
|
42
|
+
* `ExecutionView` renders zone A (including the close affordance);
|
|
43
|
+
* the custom component renders zone B itself using the pane state it
|
|
44
|
+
* authored. Consumers never reinvent the zone A shell.
|
|
45
|
+
* 4. **One slot per zone.** Zones A and B are single-slot. Opening a new
|
|
46
|
+
* embed replaces the previous one; opening a new pane replaces the
|
|
47
|
+
* previous one. If a surface truly needs "many open inspectors at once",
|
|
48
|
+
* that's renderer state inside a single pane payload, not multiple panes.
|
|
49
|
+
* 5. **Provenance parity.** Zones A and C both thread
|
|
50
|
+
* `NavigationInitiatorContext` (`sourceZone`, `launcher`, `sourceOperation`,
|
|
51
|
+
* `sourceRelationship`) — see the embedding-principle anchor at
|
|
52
|
+
* `saas.frontend.execution-view.navigation-handling-and-embedding`. An
|
|
53
|
+
* embedded read surface behaves indistinguishably from a routed read
|
|
54
|
+
* surface of the same resource.
|
|
55
|
+
* 6. **Defensive validation at the zone boundary.** The runtime fails fast
|
|
56
|
+
* when a caller misroutes an intent — `openLocalPane` rejects payloads
|
|
57
|
+
* shaped like `ExecutionEmbeddableContent` and `openEmbeddedContent`
|
|
58
|
+
* rejects non-`RESOURCE_OPERATION` content — see
|
|
59
|
+
* `assertExecutionLocalPanePayloadIsNotEmbeddableContent` and
|
|
60
|
+
* `assertExecutionEmbeddableContent` below. These assertions are
|
|
61
|
+
* belt-and-braces over the type layer; they exist so dynamic callers (test
|
|
62
|
+
* mocks, deserialized state, authored dictionaries) cannot silently collapse
|
|
63
|
+
* the zones.
|
|
64
|
+
*/
|
|
65
|
+
export interface ExecutionRuntimeState {
|
|
66
|
+
embeddedContent: ExecutionEmbeddedContentState | null;
|
|
67
|
+
localPane: ExecutionLocalPaneState | null;
|
|
68
|
+
/**
|
|
69
|
+
* Pending shell-tracked actions keyed by `actionRuntimeId`. See the
|
|
70
|
+
* loading-aggregation anchor above — this is operational telemetry, not
|
|
71
|
+
* a navigation zone.
|
|
72
|
+
*/
|
|
73
|
+
pendingActions: Record<string, ExecutionPendingAction>;
|
|
74
|
+
/**
|
|
75
|
+
* In-flight participation prefetch entries keyed by `prefetchRuntimeId`.
|
|
76
|
+
* See the `loading-aggregation.participation-prefetch` sub-anchor above.
|
|
77
|
+
* Today this slot is wired but not populated — no in-tree producer
|
|
78
|
+
* registers prefetches because participation resolution is fully
|
|
79
|
+
* synchronous. The slot exists so that the day a real async producer
|
|
80
|
+
* materializes, the public `ExecutionLoadingValue` can expose
|
|
81
|
+
* `participationPrefetchActions` / `isAnyParticipationPrefetching` /
|
|
82
|
+
* `isParticipationPrefetching(...)` without re-shaping the API.
|
|
83
|
+
*/
|
|
84
|
+
participationPrefetchActions: Record<string, ExecutionPendingPrefetch>;
|
|
85
|
+
/**
|
|
86
|
+
* Authored dirty-state markers keyed by `markerId`. See the
|
|
87
|
+
* dirty-state-contract anchor above — scope-based auto-cleanup applies at
|
|
88
|
+
* zone transitions but the shell never synthesizes or forces-blocks on
|
|
89
|
+
* these markers.
|
|
90
|
+
*/
|
|
91
|
+
dirtyMarkers: Record<string, ExecutionDirtyMarker>;
|
|
92
|
+
/**
|
|
93
|
+
* Captured failed-action entries keyed by `failureRuntimeId`. See the
|
|
94
|
+
* failure-handling-contract anchor — scope-based auto-cleanup mirrors
|
|
95
|
+
* `dirtyMarkers`; the shell captures and bridges, but does not retry or
|
|
96
|
+
* suppress consumer error UX.
|
|
97
|
+
*/
|
|
98
|
+
failedActions: Record<string, ExecutionFailedAction>;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Validates that a `localPane` payload is not accidentally an
|
|
103
|
+
* `ExecutionEmbeddableContent`. See the three-zone contract above: zone B
|
|
104
|
+
* payloads are renderer-opaque data, not navigation content.
|
|
105
|
+
*
|
|
106
|
+
* Throws with a message pointing the caller to
|
|
107
|
+
* `openEmbeddedContent`/`execution.actions.operation(...).embed()` when a
|
|
108
|
+
* misroute is detected. No-op for normal renderer payloads.
|
|
109
|
+
*/
|
|
110
|
+
export function assertExecutionLocalPanePayloadIsNotEmbeddableContent(
|
|
111
|
+
payload: unknown,
|
|
112
|
+
): void {
|
|
113
|
+
if (payload === null || typeof payload !== 'object') {
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
const candidate = payload as { contentType?: unknown };
|
|
117
|
+
if (candidate.contentType === NavigationContentType.RESOURCE_OPERATION) {
|
|
118
|
+
throw new Error(
|
|
119
|
+
'[ExecutionView] localPane payload must not be an ExecutionEmbeddableContent. '
|
|
120
|
+
+ 'Resource-operation content belongs in the embedded-content slot. '
|
|
121
|
+
+ 'Use openEmbeddedContent() or execution.actions.operation(...).embed() instead.',
|
|
122
|
+
);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Validates that a value claimed to be `ExecutionEmbeddableContent` truly is
|
|
128
|
+
* one. Today that means `contentType === NavigationContent.RESOURCE_OPERATION`;
|
|
129
|
+
* see the three-zone contract above.
|
|
130
|
+
*
|
|
131
|
+
* The type layer already enforces this, so this assertion is belt-and-braces
|
|
132
|
+
* for dynamic callers (test mocks, deserialized content, authored action
|
|
133
|
+
* dictionaries) where the type may have been widened via `as`/`unknown`.
|
|
134
|
+
*/
|
|
135
|
+
export function assertExecutionEmbeddableContent(
|
|
136
|
+
content: ExecutionEmbeddableContent,
|
|
137
|
+
): void {
|
|
138
|
+
if (!content || content.contentType !== NavigationContentType.RESOURCE_OPERATION) {
|
|
139
|
+
throw new Error(
|
|
140
|
+
'[ExecutionView] embeddedContent.content must be a '
|
|
141
|
+
+ 'NavigationContent.RESOURCE_OPERATION. Non-resource-operation '
|
|
142
|
+
+ 'navigation content must go through delegateToParent() (the app router), '
|
|
143
|
+
+ 'not the execution shell\'s embed slot.',
|
|
144
|
+
);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
```
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# saas.frontend.flows-actors-view
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Authoring shape for a standalone flows-actors view. Add entries to a frontend
|
|
14
|
+
* module's `flowsActorsViews` (an app-level-views contribution); an addressable
|
|
15
|
+
* one routes at `/flows-actors/:ref` and is surfaced by a launcher item
|
|
16
|
+
* (`LauncherItemTargetKind.VIEW`, `viewRef: <ref>`). The engine `FlowsActorsView`
|
|
17
|
+
* host renders each referenced system's actor/flow graph beside a streaming chat.
|
|
18
|
+
*
|
|
19
|
+
* Import type from `@wildo-ai/saas-frontend-lib/companion`.
|
|
20
|
+
*
|
|
21
|
+
* @property ref unique view id (used in the `/flows-actors/:ref` URL).
|
|
22
|
+
* @property systemRefs one or more registered flow/actor system refs to expose (min 1).
|
|
23
|
+
* @property layoutPreset layout arrangement — `'graph-primary'` | `'chat-primary'` | `'Default'`.
|
|
24
|
+
* @property isAddressable set `true` to give the view its own URL/route.
|
|
25
|
+
* @property primaryScope scope whose context is injected for access/navigation.
|
|
26
|
+
*/
|
|
27
|
+
export interface FlowsActorsViewDefinition {
|
|
28
|
+
scope: FrontendView_ScopeMode;
|
|
29
|
+
parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
30
|
+
additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
31
|
+
ref: string;
|
|
32
|
+
isAddressable: boolean;
|
|
33
|
+
operationLike: CoreResourceOperation;
|
|
34
|
+
primaryScope: ResourcePrimaryScope;
|
|
35
|
+
systemRefs: string[];
|
|
36
|
+
layoutPreset: string;
|
|
37
|
+
/** Required features for this view — gates navigation + route access */
|
|
38
|
+
requiredFeatures?: RequiredFeaturesConfig;
|
|
39
|
+
}
|
|
40
|
+
```
|