@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,302 @@
|
|
|
1
|
+
# saas.frontend.execution-view.failure-handling-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 failure-handling contract.
|
|
14
|
+
*
|
|
15
|
+
* The execution shell aggregates **failed actions** as a symmetric counterpart
|
|
16
|
+
* to the loading-aggregation tier (Slice B) and the outcome-emission tier
|
|
17
|
+
* (Slice D). Every `useExecution().execute()` rejection — and any
|
|
18
|
+
* consumer-authored failure (render-adjacent caught exceptions, manual
|
|
19
|
+
* `errors.capture(...)` calls) — is captured into a single shell-owned bag of
|
|
20
|
+
* `ExecutionFailedAction` entries. Consumers read `execution.errors` to drive
|
|
21
|
+
* inline retry UX without rebuilding ad hoc per-component error state.
|
|
22
|
+
*
|
|
23
|
+
* What this tier owns (and why):
|
|
24
|
+
*
|
|
25
|
+
* - **Captured failures.** The shell's `execute()` catch path captures the
|
|
26
|
+
* raw error alongside the originating action's identity (`actionRuntimeId`,
|
|
27
|
+
* `operationPathKey`, `resourceType`, `operationId`) so consumers can render
|
|
28
|
+
* targeted "Retry CREATE on Task" affordances instead of generic banners.
|
|
29
|
+
* - **Conditional bridge to the canonical bus.** Most rejections come from
|
|
30
|
+
* the HTTP layer, which has *already* been processed by
|
|
31
|
+
* `errorManagement.handleHttpError(...)` (built a `WildoError_Frontend`,
|
|
32
|
+
* applied the configured behavior, conditionally emitted `ERROR_OCCURED`
|
|
33
|
+
* based on the per-status policy and the request's `silent` flag). The
|
|
34
|
+
* shell detects this via the `error.wildoError` marker that
|
|
35
|
+
* `wildo-http-client` attaches and **defers to that upstream processing
|
|
36
|
+
* instead of re-emitting**. Synchronous throws and non-axios rejections
|
|
37
|
+
* (no `wildoError`) are bridged once via `errorManagement.handleError(...)`
|
|
38
|
+
* so global subscribers (`GlobalErrorHandler`, `NotificationContext` for
|
|
39
|
+
* `NOTIFY_RESOURCE_ERROR`) still see them.
|
|
40
|
+
*
|
|
41
|
+
* Note: HTTP rejections marked by `wildo-http-client` may not have
|
|
42
|
+
* actually emitted to the bus (silent requests, `emitEvent: false` in
|
|
43
|
+
* the per-status matrix). The shell honors that consumer-requested
|
|
44
|
+
* silence rather than re-emitting on its own — see
|
|
45
|
+
* `markedByHttpClient` vs. `bridgedByExecutionShell` on
|
|
46
|
+
* `ExecutionFailedAction` for the truthful per-entry provenance.
|
|
47
|
+
*
|
|
48
|
+
* What this tier intentionally does **not** own:
|
|
49
|
+
*
|
|
50
|
+
* - **A second error bus.** The framework already has `ERROR_OCCURED`,
|
|
51
|
+
* `NOTIFY_RESOURCE_ERROR`, and `NOTIFY_CUSTOM_ERROR` on the canonical bus.
|
|
52
|
+
* Adding an execution-scoped error stream would force consumers to learn
|
|
53
|
+
* two APIs and would hide failures from app-global subscribers.
|
|
54
|
+
* - **A new render-error boundary.** Render crashes inside the execution view
|
|
55
|
+
* surface through the existing application `ErrorBoundary` (see
|
|
56
|
+
* `core/errors/ErrorBoundary.tsx`) which already emits `ERROR_OCCURED` and
|
|
57
|
+
* renders the canonical `AppLayout_ErrorBoundary` fallback. The execution
|
|
58
|
+
* shell wraps its content in that boundary instead of reinventing one.
|
|
59
|
+
* - **Built-in retry orchestration.** The shell exposes failed-action
|
|
60
|
+
* metadata; the consumer owns the retry call site. A built-in
|
|
61
|
+
* `retry()` would have to re-author the original action verb (which the
|
|
62
|
+
* shell does not retain), and would obscure idempotency / context-refresh
|
|
63
|
+
* decisions that only the consumer can make. Consumers retry by re-invoking
|
|
64
|
+
* the same action verb after `clear(failureRuntimeId)`.
|
|
65
|
+
*
|
|
66
|
+
* **Scopes** classify a failure's lifecycle so the shell can safely
|
|
67
|
+
* auto-clean without asking the publisher. They mirror
|
|
68
|
+
* `ExecutionDirtyMarkerScope` exactly to keep the mental model uniform:
|
|
69
|
+
*
|
|
70
|
+
* - `EMBEDDED_CONTENT` — the failure belongs to the current embed slot.
|
|
71
|
+
* Auto-cleared on `openEmbeddedContent` / `closeEmbeddedContent`.
|
|
72
|
+
* - `LOCAL_PANE` — the failure belongs to the currently-open `localPane`.
|
|
73
|
+
* Auto-cleared on pane close, or when a different `paneId` opens.
|
|
74
|
+
* - `CUSTOM` — consumer-owned lifecycle. Default for all `execute()`-captured
|
|
75
|
+
* failures (the shell does not know which zone the consumer's action verb
|
|
76
|
+
* belongs to). The shell never auto-clears these.
|
|
77
|
+
* - `PARTICIPATION_PREFETCH` — the failure originated from the participation-
|
|
78
|
+
* prefetch tier (Slice K's first producer). Auto-cleared on the next
|
|
79
|
+
* *successful* prefetch with the same `prefetchKey`. The 4th scope was
|
|
80
|
+
* added rather than overloading `CUSTOM` because the auto-prune lifecycle
|
|
81
|
+
* is genuinely distinct: prefetch failures live in a "stale-data
|
|
82
|
+
* indicator" UX where the next successful refetch implicitly resolves
|
|
83
|
+
* them, whereas `CUSTOM` failures persist until consumer-cleared. Carries
|
|
84
|
+
* a `prefetchKey: string` discriminant payload — the consumer-authored
|
|
85
|
+
* stable identity (NOT the per-run `prefetchRuntimeId` which rotates per
|
|
86
|
+
* in-flight unit) — so the shell's `clearFailedActionsForPrefetchKey(key)`
|
|
87
|
+
* verb can target the right entries on settle. See the
|
|
88
|
+
* `loading-aggregation.participation-prefetch.shell-data-hydrator`
|
|
89
|
+
* sub-anchor for the producer-side contract this scope serves.
|
|
90
|
+
*
|
|
91
|
+
* Contract invariants:
|
|
92
|
+
*
|
|
93
|
+
* 1. **Capture always, bridge at most once.** Every `execute()` rejection
|
|
94
|
+
* produces exactly one `ExecutionFailedAction` entry. The shell calls
|
|
95
|
+
* `errorManagement.handleError(...)` only when no upstream layer has
|
|
96
|
+
* already processed the error (detected via the `error.wildoError`
|
|
97
|
+
* marker that `wildo-http-client.handleHttpError` attaches). The shell
|
|
98
|
+
* never re-bridges an HTTP-marked error even if that upstream processing
|
|
99
|
+
* suppressed emission via `silent` or `emitEvent: false` — honoring
|
|
100
|
+
* consumer-requested silence is part of the contract. Each captured
|
|
101
|
+
* entry records `markedByHttpClient` and `bridgedByExecutionShell`
|
|
102
|
+
* truthfully so consumers can reason about provenance per entry.
|
|
103
|
+
* 2. **Re-throw after capture.** `execute()` re-throws the original error
|
|
104
|
+
* after capturing + (conditionally) bridging, so consumer `.catch()`
|
|
105
|
+
* handlers and `await`-style call sites still observe the rejection.
|
|
106
|
+
* The shell augments the canonical contract; it does not swallow it.
|
|
107
|
+
* 3. **Capture happens before pending clears, but the renderer sees both
|
|
108
|
+
* in the same React commit.** Mechanically the `catch` block runs
|
|
109
|
+
* `captureFailedAction(...)` then re-throws, after which the `finally`
|
|
110
|
+
* block runs `endPendingAction(...)`. React batches the resulting
|
|
111
|
+
* `setState` updates inside the same microtask, so consumers render
|
|
112
|
+
* with `pending=false` and `errored=true` simultaneously — there is no
|
|
113
|
+
* intermediate "still-pending-but-already-failed" state visible to a
|
|
114
|
+
* rendered component. (Subscribers that observe state through refs or
|
|
115
|
+
* custom selectors during the catch microtask may briefly see both
|
|
116
|
+
* flags true; that path is shell-internal plumbing only.)
|
|
117
|
+
* 4. **Auto-cleanup at zone boundaries (and at prefetch settle).**
|
|
118
|
+
* `openEmbeddedContent`/`closeEmbeddedContent` clear all
|
|
119
|
+
* `EMBEDDED_CONTENT`-scoped failures; `openLocalPane`/`closeLocalPane`
|
|
120
|
+
* clear all `LOCAL_PANE`-scoped failures whose `paneId` no longer matches
|
|
121
|
+
* the active pane; `PARTICIPATION_PREFETCH`-scoped failures are cleared
|
|
122
|
+
* by `clearFailedActionsForPrefetchKey(prefetchKey)` (called by the
|
|
123
|
+
* Slice K hooks on the next *successful* settle of the same prefetch
|
|
124
|
+
* unit). `CUSTOM` failures are untouched by every auto-cleanup path —
|
|
125
|
+
* the shell never collects them on its own. This mirrors the
|
|
126
|
+
* dirty-state contract auto-cleanup so consumers reason about all tiers
|
|
127
|
+
* with the same scope vocabulary, just with one extra trigger
|
|
128
|
+
* (per-`prefetchKey` settle) for the prefetch lifecycle.
|
|
129
|
+
* 5. **Stable failure ids.** `failureRuntimeId` is generated by the shell at
|
|
130
|
+
* capture time. Re-capturing an `originatingActionRuntimeId` (e.g.
|
|
131
|
+
* consumer retried, action failed again) produces a *new* failure entry
|
|
132
|
+
* rather than mutating the prior one — the timeline is preserved so
|
|
133
|
+
* consumers can render attempt count or last-attempt-time UX.
|
|
134
|
+
* 6. **Per-runtime-instance scope.** The aggregator lives on
|
|
135
|
+
* `ExecutionRuntimeState`, not globally. Two execution views mounted in
|
|
136
|
+
* the same app do not share failed-action state.
|
|
137
|
+
* 7. **Shell is informative, not restrictive.** Capturing a failure does
|
|
138
|
+
* *not* alter execution lifecycle, block transitions, or veto subsequent
|
|
139
|
+
* `execute()` calls. UX (banner vs. toast vs. inline retry button) is
|
|
140
|
+
* owned by the consumer.
|
|
141
|
+
*/
|
|
142
|
+
export enum ExecutionFailedActionScope {
|
|
143
|
+
EMBEDDED_CONTENT = 'embedded-content',
|
|
144
|
+
LOCAL_PANE = 'local-pane',
|
|
145
|
+
CUSTOM = 'custom',
|
|
146
|
+
/**
|
|
147
|
+
* Slice K — failure originated from the participation-prefetch tier
|
|
148
|
+
* (the shell-data-hydrator producer hooks). Carries a discriminant
|
|
149
|
+
* `prefetchKey: string` so the shell can auto-prune on the next
|
|
150
|
+
* successful prefetch with the same key. See the
|
|
151
|
+
* `loading-aggregation.participation-prefetch.shell-data-hydrator`
|
|
152
|
+
* sub-anchor for the producer-side contract.
|
|
153
|
+
*/
|
|
154
|
+
PARTICIPATION_PREFETCH = 'participation-prefetch',
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* Common shape for every captured failure entry, regardless of scope.
|
|
159
|
+
*
|
|
160
|
+
* Intentionally not exported on its own — consumers use the
|
|
161
|
+
* `ExecutionFailedAction` discriminated union below so the type system
|
|
162
|
+
* enforces "LOCAL_PANE entries carry a `paneId`" without requiring
|
|
163
|
+
* defensive `!== undefined` checks at every read site.
|
|
164
|
+
*/
|
|
165
|
+
interface ExecutionFailedActionBase {
|
|
166
|
+
/**
|
|
167
|
+
* Stable id for the failed action entry. Generated by the shell at capture
|
|
168
|
+
* time, distinct from the originating `actionRuntimeId` so re-attempts
|
|
169
|
+
* produce fresh entries.
|
|
170
|
+
*/
|
|
171
|
+
failureRuntimeId: string;
|
|
172
|
+
/**
|
|
173
|
+
* Mirrors `ExecutionPendingAction.actionRuntimeId` for `execute()`-captured
|
|
174
|
+
* failures. Absent for consumer-authored captures via
|
|
175
|
+
* `execution.errors.capture(...)` that did not originate from the shell's
|
|
176
|
+
* `execute()` bridge.
|
|
177
|
+
*
|
|
178
|
+
* **Informational only — no first-class selector today.** The shell
|
|
179
|
+
* does not expose a `errors.findByOriginatingAction(actionRuntimeId)`
|
|
180
|
+
* helper because no in-tree consumer needs it yet (the dogfood derives
|
|
181
|
+
* `latestFailure` purely from `capturedAt`). Consumers that want to
|
|
182
|
+
* correlate a failure entry to a specific pending action can do so via
|
|
183
|
+
* `errors.isErrored((entry) => entry.originatingActionRuntimeId === id)`
|
|
184
|
+
* or by filtering `errors.failedActions` directly. A dedicated selector
|
|
185
|
+
* will be added the first time per-button retry UX dogfoods this field.
|
|
186
|
+
*/
|
|
187
|
+
originatingActionRuntimeId?: string;
|
|
188
|
+
/** Canonical operation path key, when available. */
|
|
189
|
+
operationPathKey?: string;
|
|
190
|
+
/** Resource the failed action targeted, when available. */
|
|
191
|
+
resourceType?: string;
|
|
192
|
+
/** Operation identifier the failed action invoked, when available. */
|
|
193
|
+
operationId?: string;
|
|
194
|
+
/** `Date.now()` when capture happened. */
|
|
195
|
+
capturedAt: number;
|
|
196
|
+
/**
|
|
197
|
+
* Mirrors the originating pending action's `startedAt` so consumers can
|
|
198
|
+
* render duration-aware UX. Absent for consumer-authored captures.
|
|
199
|
+
*/
|
|
200
|
+
startedAt?: number;
|
|
201
|
+
/**
|
|
202
|
+
* Raw error reference. Consumers may inspect `error.wildoError` (set by
|
|
203
|
+
* `wildo-http-client`) for typed metadata, but the shell does not normalize
|
|
204
|
+
* the shape — keeping the original preserves whatever upstream provenance
|
|
205
|
+
* the rejected value carried (stack traces for `Error` instances, typed
|
|
206
|
+
* payloads for HTTP-marked errors, primitive values when the call site
|
|
207
|
+
* threw something exotic).
|
|
208
|
+
*/
|
|
209
|
+
error: unknown;
|
|
210
|
+
/**
|
|
211
|
+
* Optional human-readable label ("Could not load todo graph"). Consumers
|
|
212
|
+
* may render it inline; the shell treats it as opaque metadata.
|
|
213
|
+
*/
|
|
214
|
+
label?: string;
|
|
215
|
+
/**
|
|
216
|
+
* `true` when the originating error carries the `wildoError` marker
|
|
217
|
+
* stamped by `wildo-http-client.handleHttpError`. That marker means an
|
|
218
|
+
* upstream layer already classified the error and applied its configured
|
|
219
|
+
* behavior (potentially emitting `ERROR_OCCURED`, potentially staying
|
|
220
|
+
* silent if the request opted in or the per-status policy disabled
|
|
221
|
+
* emission). The shell defers to that processing instead of re-bridging.
|
|
222
|
+
*/
|
|
223
|
+
markedByHttpClient: boolean;
|
|
224
|
+
/**
|
|
225
|
+
* `true` when this capture site invoked `errorManagement.handleError(...)`
|
|
226
|
+
* itself. The shell sets this:
|
|
227
|
+
* - `true` for `execute()` rejections without `markedByHttpClient`.
|
|
228
|
+
* - `false` for `execute()` rejections WITH `markedByHttpClient` (deferred
|
|
229
|
+
* to upstream).
|
|
230
|
+
* - `true`/`false` per `bridgeToCanonicalBus` opt-out for
|
|
231
|
+
* `execution.errors.capture(...)` calls.
|
|
232
|
+
*
|
|
233
|
+
* Note: `bridgedByExecutionShell === true` does not strictly guarantee
|
|
234
|
+
* an `ERROR_OCCURED` event was emitted — `errorManagement.handleError`
|
|
235
|
+
* may itself drop emission for silent contexts. Consumers needing the
|
|
236
|
+
* ground truth of "was a canonical event emitted" should subscribe to
|
|
237
|
+
* `FrontendEvents.ERROR_OCCURED` directly rather than infer it from this
|
|
238
|
+
* flag.
|
|
239
|
+
*/
|
|
240
|
+
bridgedByExecutionShell: boolean;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* Discriminated union of captured failure entries.
|
|
245
|
+
*
|
|
246
|
+
* The discriminant `scope` makes "`paneId` is required for `LOCAL_PANE`
|
|
247
|
+
* entries, absent on the others" a compile-time invariant. Combined with
|
|
248
|
+
* the runtime assertion `assertExecutionFailedActionShape`, dynamic
|
|
249
|
+
* callers (test mocks, deserialized state, authored dictionaries) cannot
|
|
250
|
+
* collapse the variants either.
|
|
251
|
+
*/
|
|
252
|
+
export type ExecutionFailedAction =
|
|
253
|
+
| (ExecutionFailedActionBase & { scope: ExecutionFailedActionScope.EMBEDDED_CONTENT })
|
|
254
|
+
| (ExecutionFailedActionBase & { scope: ExecutionFailedActionScope.LOCAL_PANE; paneId: string })
|
|
255
|
+
| (ExecutionFailedActionBase & { scope: ExecutionFailedActionScope.CUSTOM })
|
|
256
|
+
| (ExecutionFailedActionBase & {
|
|
257
|
+
scope: ExecutionFailedActionScope.PARTICIPATION_PREFETCH;
|
|
258
|
+
/**
|
|
259
|
+
* Stable consumer-authored identity for the prefetch unit. Distinct
|
|
260
|
+
* from the per-run `prefetchRuntimeId` (which rotates on every fire);
|
|
261
|
+
* the same `prefetchKey` is reused across consecutive settle cycles
|
|
262
|
+
* of the same logical prefetch so the shell's
|
|
263
|
+
* `clearFailedActionsForPrefetchKey(key)` verb can drop matching
|
|
264
|
+
* entries on the next successful settle.
|
|
265
|
+
*/
|
|
266
|
+
prefetchKey: string;
|
|
267
|
+
});
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* Belt-and-braces runtime check that an `ExecutionFailedAction` matches
|
|
271
|
+
* its discriminant invariants. The type layer already enforces these for
|
|
272
|
+
* statically-shaped callers; this assertion exists for dynamic callers
|
|
273
|
+
* (test mocks, deserialized payloads, authored dictionaries) where the
|
|
274
|
+
* type may have been widened via `as`/`unknown`.
|
|
275
|
+
*
|
|
276
|
+
* Throws synchronously when a `LOCAL_PANE` entry is captured without a
|
|
277
|
+
* `paneId` — the only invariant that cannot be expressed any other way.
|
|
278
|
+
*/
|
|
279
|
+
export function assertExecutionFailedActionShape(failedAction: ExecutionFailedAction): void {
|
|
280
|
+
if (failedAction.scope === ExecutionFailedActionScope.LOCAL_PANE) {
|
|
281
|
+
const candidate = failedAction as { paneId?: unknown };
|
|
282
|
+
if (typeof candidate.paneId !== 'string' || candidate.paneId.length === 0) {
|
|
283
|
+
throw new Error(
|
|
284
|
+
'[ExecutionView] LOCAL_PANE-scoped failed action must carry a non-empty `paneId` '
|
|
285
|
+
+ 'so the shell can auto-clear it on pane transitions. '
|
|
286
|
+
+ 'Use scope=CUSTOM for failures that should outlive any single pane.',
|
|
287
|
+
);
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
if (failedAction.scope === ExecutionFailedActionScope.PARTICIPATION_PREFETCH) {
|
|
291
|
+
const candidate = failedAction as { prefetchKey?: unknown };
|
|
292
|
+
if (typeof candidate.prefetchKey !== 'string' || candidate.prefetchKey.length === 0) {
|
|
293
|
+
throw new Error(
|
|
294
|
+
'[ExecutionView] PARTICIPATION_PREFETCH-scoped failed action must carry a '
|
|
295
|
+
+ 'non-empty `prefetchKey` so the shell can auto-clear it on the next '
|
|
296
|
+
+ 'successful prefetch settle for the same key. '
|
|
297
|
+
+ 'Use scope=CUSTOM for failures that should outlive any single prefetch unit.',
|
|
298
|
+
);
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
```
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# saas.frontend.execution-view.loading-aggregation
|
|
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 loading aggregation.
|
|
14
|
+
*
|
|
15
|
+
* The execution shell publishes **one** authoritative loading signal per
|
|
16
|
+
* runtime-instance, aggregating only what the shell itself truthfully owns.
|
|
17
|
+
* Consumers get a single `execution.loading` surface instead of re-authoring
|
|
18
|
+
* spinner state for every action button.
|
|
19
|
+
*
|
|
20
|
+
* What the aggregator owns (and why):
|
|
21
|
+
*
|
|
22
|
+
* - **Pending execute actions.** Every `execute()` on a resource-operation
|
|
23
|
+
* action verb runs through the shell's `doOperation()` bridge. The shell
|
|
24
|
+
* registers a `ExecutionPendingAction` before the call and clears it on
|
|
25
|
+
* settle (success *or* failure).
|
|
26
|
+
* - **Participation prefetch entries.** A second tier for in-flight async
|
|
27
|
+
* hydration of one or more execution participations. Wired in Slice H as
|
|
28
|
+
* scaffolding ahead of a real producer (no in-tree producer exists today
|
|
29
|
+
* because participation resolution is fully synchronous), so a future
|
|
30
|
+
* async participation source can register prefetches without re-shaping
|
|
31
|
+
* the public `ExecutionLoadingValue` surface. Spec lives at the
|
|
32
|
+
* `participation-prefetch` sub-anchor below.
|
|
33
|
+
*
|
|
34
|
+
* What the aggregator intentionally does **not** own:
|
|
35
|
+
*
|
|
36
|
+
* - **Embedded-content layout loading.** The embedded slot mounts a
|
|
37
|
+
* `ResourceOperationSurface`, which has its own internal read/write
|
|
38
|
+
* loading contract. The execution shell does not shadow or duplicate that
|
|
39
|
+
* contract; `hasEmbeddedContent` alone is not a loading signal.
|
|
40
|
+
* - **Router-delegated content.** Once `delegateToParent(...)` fires, the
|
|
41
|
+
* execution view has yielded ownership. Any downstream loading lives on
|
|
42
|
+
* the router's navigation stack.
|
|
43
|
+
* - **Consumer-pushed phases.** App code cannot register synthetic "phase"
|
|
44
|
+
* entries to make `isBusy` reflect a multi-step workflow it owns. Every
|
|
45
|
+
* tier is shell-owned (see invariant #1) — that constraint is what makes
|
|
46
|
+
* the aggregator's truthfulness portable across consumers.
|
|
47
|
+
*
|
|
48
|
+
* Contract invariants:
|
|
49
|
+
*
|
|
50
|
+
* 1. **Shell-owned tracking only.** The aggregator is populated exclusively
|
|
51
|
+
* by shell-owned hooks (`execute()` for the pending-action tier; future
|
|
52
|
+
* framework-owned participation resolvers for the participation-prefetch
|
|
53
|
+
* tier). App code must not push entries into it directly — the
|
|
54
|
+
* `begin/endPendingAction` and `begin/endParticipationPrefetch` helpers
|
|
55
|
+
* on `ExecutionNavigationValue` are internal plumbing.
|
|
56
|
+
* 2. **Settle always clears.** Every `beginPendingAction` /
|
|
57
|
+
* `beginParticipationPrefetch` has a matching `endPendingAction` /
|
|
58
|
+
* `endParticipationPrefetch`, called in the promise's `finally` path.
|
|
59
|
+
* Rejections clear the entry just like resolutions.
|
|
60
|
+
* 3. **Per-runtime-instance scope.** The aggregator lives on the execution
|
|
61
|
+
* runtime, not globally. Two execution views mounted in the same app do
|
|
62
|
+
* not share pending-action or prefetch state.
|
|
63
|
+
* 4. **Orthogonal to the three-zone contract.** Pending actions and prefetches
|
|
64
|
+
* are operational telemetry, not a fourth navigation zone. They coexist
|
|
65
|
+
* with `embeddedContent` and `localPane` on `ExecutionRuntimeState` but
|
|
66
|
+
* do not represent child intent.
|
|
67
|
+
* 5. **`isBusy` aggregates every tier.**
|
|
68
|
+
* `execution.loading.isBusy = pendingActions.length > 0 ||
|
|
69
|
+
* participationPrefetchActions.length > 0`. The renderer-facing label
|
|
70
|
+
* "anything in flight" stays honest as new tiers are added. Per-tier
|
|
71
|
+
* narrowing is reached via `isPending(...)` (execute actions) and
|
|
72
|
+
* `isParticipationPrefetching(...)` (prefetches) explicitly.
|
|
73
|
+
*/
|
|
74
|
+
export interface ExecutionPendingAction {
|
|
75
|
+
/**
|
|
76
|
+
* Stable id for the pending action. Generated by the shell at `begin` time
|
|
77
|
+
* so `end` can clear the matching entry even if the caller forgets it.
|
|
78
|
+
*/
|
|
79
|
+
actionRuntimeId: string;
|
|
80
|
+
/** Canonical `operationPathKey` the shell passed to `doOperation()`. */
|
|
81
|
+
operationPathKey: string;
|
|
82
|
+
/** Resource the action targets, for per-resource UI filtering. */
|
|
83
|
+
resourceType: string;
|
|
84
|
+
/** Operation identifier (e.g. `READ`, `UPDATE`, dictionary key). */
|
|
85
|
+
operationId: string;
|
|
86
|
+
/** `Date.now()` when tracking began — useful for stale-spinner detection. */
|
|
87
|
+
startedAt: number;
|
|
88
|
+
}
|
|
89
|
+
```
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# saas.frontend.execution-view.loading-aggregation.participation-prefetch
|
|
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 loading aggregation — participation-prefetch tier (Slice H).
|
|
14
|
+
*
|
|
15
|
+
* Sub-anchor of `saas.frontend.execution-view.loading-aggregation`. Defines
|
|
16
|
+
* the loading aggregator's second tier: in-flight async hydration of one or
|
|
17
|
+
* more execution participations.
|
|
18
|
+
*
|
|
19
|
+
* **First producer landed in Slice K.** `resolveExecutionParticipations(...)`
|
|
20
|
+
* itself is still synchronous (a pure derivation from `viewDefinition` +
|
|
21
|
+
* `registry` + `anchor` + `contextResourceIdentifiers`), but the first
|
|
22
|
+
* concrete producer for this tier ships as a pair of consumer-callable
|
|
23
|
+
* hooks — `useExecutionParticipationPrefetch` (generic primitive) and
|
|
24
|
+
* `useExecutionParticipationDataPrefetch` (opinionated wrapper). They
|
|
25
|
+
* orchestrate `doOperation()`-driven async data fetches around the
|
|
26
|
+
* `beginParticipationPrefetch` / `endParticipationPrefetch` lifecycle
|
|
27
|
+
* helpers below. See the
|
|
28
|
+
* `loading-aggregation.participation-prefetch.shell-data-hydrator`
|
|
29
|
+
* sub-anchor (immediately after this one) for the producer-side contract.
|
|
30
|
+
* Future async participation sources (e.g. a relationship-projection
|
|
31
|
+
* participation that needs to fetch the source resource's data to
|
|
32
|
+
* disambiguate the projection edge, or a future "lazy participation"
|
|
33
|
+
* mode that hydrates an aliased identifier from a remote call) can
|
|
34
|
+
* register through the same `beginParticipationPrefetch` /
|
|
35
|
+
* `endParticipationPrefetch` seam without re-shaping the public
|
|
36
|
+
* `ExecutionLoadingValue` surface.
|
|
37
|
+
*
|
|
38
|
+
* **What a "participation prefetch" is.** A bounded async unit of work
|
|
39
|
+
* whose purpose is to hydrate the data backing one or more participation
|
|
40
|
+
* refs *before* the consuming custom view treats those participations as
|
|
41
|
+
* fully resolved. Examples that would qualify (none exist today):
|
|
42
|
+
*
|
|
43
|
+
* - A relationship-projection participation that needs the source
|
|
44
|
+
* resource's data to pick the right edge — the helper
|
|
45
|
+
* `resolveExecutionParticipations` already accepts a
|
|
46
|
+
* `sourceResourceDataByParticipationRef` parameter, but it is unused at
|
|
47
|
+
* the `ExecutionView` call site because no async source feeds it.
|
|
48
|
+
* - A future "participation lazy-binding" mode where an anchor or
|
|
49
|
+
* requirement participation hydrates an aliased identifier from a remote
|
|
50
|
+
* call instead of from URL/ambient scope.
|
|
51
|
+
*
|
|
52
|
+
* Things that are NOT participation prefetches and must not be registered
|
|
53
|
+
* here (parent invariant #1 plus tier-specific clarifications):
|
|
54
|
+
*
|
|
55
|
+
* - Consumer-driven graph reads via
|
|
56
|
+
* `useExecution().actions.operation(...).execute()`. Those are pending
|
|
57
|
+
* execute actions and live in the `pendingActions` tier already (and
|
|
58
|
+
* carry their own `operationPathKey` correlation key, which prefetches
|
|
59
|
+
* intentionally do not).
|
|
60
|
+
* - Embedded-layout internal loading. Owned by the embed slot's own
|
|
61
|
+
* contract; the parent anchor explicitly excludes it.
|
|
62
|
+
* - Workflow / multi-step phases authored by the consumer. The aggregator
|
|
63
|
+
* does not accept consumer pushes; a consumer that wants a "view is
|
|
64
|
+
* warming up" boolean composes one in its own `useState` from
|
|
65
|
+
* `execution.loading.isParticipationPrefetching(...)` plus its own
|
|
66
|
+
* bookkeeping.
|
|
67
|
+
*
|
|
68
|
+
* **Intent classification.** Each entry carries an
|
|
69
|
+
* `ExecutionParticipationPrefetchIntent`:
|
|
70
|
+
*
|
|
71
|
+
* - `INITIAL` — first-time hydration during shell bootstrap. Renderers
|
|
72
|
+
* typically gate the entire view on this (full-screen skeleton).
|
|
73
|
+
* - `REFRESH` — re-hydration of an already-resolved participation
|
|
74
|
+
* (background revalidation). Renderers typically render through with a
|
|
75
|
+
* subtle indicator. Distinct from `INITIAL` so consumers can tell the
|
|
76
|
+
* two apart without authoring a side-channel boolean.
|
|
77
|
+
*
|
|
78
|
+
* **Aggregation into `isBusy` (parent invariant #5).** Prefetch entries
|
|
79
|
+
* count toward `execution.loading.isBusy` exactly like pending execute
|
|
80
|
+
* actions. Per-tier narrowing is reached via the dedicated
|
|
81
|
+
* `isParticipationPrefetching(predicate?)` helper on
|
|
82
|
+
* `ExecutionLoadingValue` (no overlap with `isPending(...)` which stays
|
|
83
|
+
* about execute actions).
|
|
84
|
+
*
|
|
85
|
+
* **Producer registration.** Producers call the low-level
|
|
86
|
+
* `beginParticipationPrefetch` / `endParticipationPrefetch` helpers
|
|
87
|
+
* directly on `ExecutionNavigationValue` (mirrors the Slice B
|
|
88
|
+
* `beginPendingAction` / `endPendingAction` pattern). The Slice K hooks
|
|
89
|
+
* (`useExecutionParticipationPrefetch` /
|
|
90
|
+
* `useExecutionParticipationDataPrefetch`) are the framework-shipped
|
|
91
|
+
* wrappers around this seam — they own begin/end pairing, cancellation
|
|
92
|
+
* via `AbortController`, latest-error surfacing, and the optional
|
|
93
|
+
* bridge to `execution.errors.failedActions` (with the dedicated
|
|
94
|
+
* `PARTICIPATION_PREFETCH` scope and `clearFailedActionsForPrefetchKey`
|
|
95
|
+
* auto-prune lifecycle). Custom producers (e.g. a future shell-owned
|
|
96
|
+
* lazy-participation resolver) call the raw helpers directly and MUST
|
|
97
|
+
* pair every begin with a matching end inside a `try`/`finally` so
|
|
98
|
+
* parent invariant #2 ("settle always clears") holds for this tier too.
|
|
99
|
+
*
|
|
100
|
+
* Contract invariants (specialization of the parent anchor's invariants):
|
|
101
|
+
*
|
|
102
|
+
* 1. **Producer-minted ids; same-id re-register is idempotent-by-overwrite.**
|
|
103
|
+
* `prefetchRuntimeId` is minted by the producer (in contrast to
|
|
104
|
+
* `actionRuntimeId`, which the shell mints at the `doOperation()` bridge).
|
|
105
|
+
* The shell does not de-duplicate semantically distinct units that happen
|
|
106
|
+
* to share an id — calling `beginParticipationPrefetch` with an existing
|
|
107
|
+
* id REPLACES the prior entry (last-write-wins). Producers MUST mint a
|
|
108
|
+
* fresh id per in-flight unit so the timeline (start time, intent,
|
|
109
|
+
* participation refs) is not silently overwritten by a concurrent unit
|
|
110
|
+
* that happened to recycle the id.
|
|
111
|
+
* 2. **Non-empty participation refs.** `participationRefs` MUST contain at
|
|
112
|
+
* least one ref. A prefetch that hydrates "no participation" has no
|
|
113
|
+
* correlation handle and would be invisible to per-ref UX.
|
|
114
|
+
* `assertExecutionPendingPrefetchShape` rejects empty arrays at the
|
|
115
|
+
* nav helper boundary so dynamic callers (test mocks, deserialized
|
|
116
|
+
* state, future authored hydrators) cannot bypass this.
|
|
117
|
+
*
|
|
118
|
+
* **Not validated against `viewDefinition.participations`.** The shape
|
|
119
|
+
* guard intentionally does not check that each ref exists in the
|
|
120
|
+
* resolved participations registry. Doing so would couple this seam
|
|
121
|
+
* to the view-definition layer (the nav helpers don't currently
|
|
122
|
+
* receive the view definition), and would forbid producers from
|
|
123
|
+
* pre-registering prefetches for participations that materialize
|
|
124
|
+
* after the prefetch begins (a plausible pattern for the future
|
|
125
|
+
* "participation lazy-binding" mode mentioned above). When the first
|
|
126
|
+
* real producer ships, re-evaluate this trade-off — until then the
|
|
127
|
+
* consequence of a typoed ref is "the entry will register but no
|
|
128
|
+
* `isParticipationPrefetching((p) => p.participationRefs.includes(...))`
|
|
129
|
+
* predicate will ever match", which is observable in renderer UX and
|
|
130
|
+
* therefore self-correcting.
|
|
131
|
+
* 3. **Resource type required.** The `resourceType` field mirrors
|
|
132
|
+
* `ExecutionPendingAction.resourceType` so per-resource UI filtering
|
|
133
|
+
* (e.g. "is anything tasks-related loading?") composes uniformly across
|
|
134
|
+
* both tiers.
|
|
135
|
+
* 4. **Intent must be a known value.** `INITIAL` or `REFRESH`. Unknown
|
|
136
|
+
* intents would silently bypass renderer narrowing UX.
|
|
137
|
+
* `assertExecutionPendingPrefetchShape` enforces this.
|
|
138
|
+
*
|
|
139
|
+
* **Acknowledged rot risk.** The `INITIAL`/`REFRESH` vocabulary was
|
|
140
|
+
* pinned ahead of any real producer (Slice H scaffolding). Plausible
|
|
141
|
+
* additions a real producer might want — `BACKGROUND_SYNC` (idle-time
|
|
142
|
+
* revalidation), `LAZY_HYDRATE` (visibility-triggered), `RETRY` (after
|
|
143
|
+
* a failure) — would extend the enum additively. If a producer's
|
|
144
|
+
* needed dimension does not fit the enum at all (e.g. priority,
|
|
145
|
+
* cancellability), revisit `intent`'s shape rather than overload it.
|
|
146
|
+
*/
|
|
147
|
+
export enum ExecutionParticipationPrefetchIntent {
|
|
148
|
+
INITIAL = 'initial',
|
|
149
|
+
REFRESH = 'refresh',
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
export interface ExecutionPendingPrefetch {
|
|
153
|
+
/**
|
|
154
|
+
* Stable id for this in-flight prefetch entry. **Minted by the producer**
|
|
155
|
+
* (in contrast to `actionRuntimeId`, which the shell mints at the
|
|
156
|
+
* `doOperation()` bridge). Same-id re-register is idempotent-by-overwrite:
|
|
157
|
+
* the shell REPLACES the prior entry rather than de-duplicating two
|
|
158
|
+
* semantically distinct units. Producers MUST mint a fresh id per
|
|
159
|
+
* in-flight unit so the timeline is preserved — see invariant #1 in the
|
|
160
|
+
* sub-anchor JSDoc above.
|
|
161
|
+
*/
|
|
162
|
+
prefetchRuntimeId: string;
|
|
163
|
+
/**
|
|
164
|
+
* Participation refs whose data is being hydrated by this prefetch.
|
|
165
|
+
* Multiple refs are allowed: one fetch can resolve several participations
|
|
166
|
+
* (e.g. a relationship-projection that needs both endpoints).
|
|
167
|
+
*
|
|
168
|
+
* Must contain at least one ref — a prefetch with no refs cannot be
|
|
169
|
+
* narrowed to per-ref UX and is a contract bug. Enforced at the nav
|
|
170
|
+
* helper boundary by `assertExecutionPendingPrefetchShape`.
|
|
171
|
+
*/
|
|
172
|
+
participationRefs: readonly string[];
|
|
173
|
+
/**
|
|
174
|
+
* Primary resource type being hydrated. Mirrors
|
|
175
|
+
* `ExecutionPendingAction.resourceType` so per-resource UI filtering
|
|
176
|
+
* composes uniformly across both tiers of the loading aggregator.
|
|
177
|
+
*/
|
|
178
|
+
resourceType: string;
|
|
179
|
+
/**
|
|
180
|
+
* Whether this is the first-time hydration (`INITIAL`) or a background
|
|
181
|
+
* re-hydration (`REFRESH`). Lets renderers distinguish "full-screen
|
|
182
|
+
* skeleton" vs "subtle indicator" without a side-channel boolean.
|
|
183
|
+
*/
|
|
184
|
+
intent: ExecutionParticipationPrefetchIntent;
|
|
185
|
+
/** `Date.now()` when tracking began. */
|
|
186
|
+
startedAt: number;
|
|
187
|
+
/** Optional human-readable label ("Loading task graph"). Opaque to the shell. */
|
|
188
|
+
label?: string;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Belt-and-braces runtime check that an `ExecutionPendingPrefetch` entry
|
|
193
|
+
* is well-formed. Mirrors `assertExecutionDirtyMarkerShape` /
|
|
194
|
+
* `assertExecutionFailedActionShape` — exists for dynamic callers (test
|
|
195
|
+
* mocks, deserialized state, future authored hydrators) where the type
|
|
196
|
+
* may have been widened via `as`/`unknown`.
|
|
197
|
+
*
|
|
198
|
+
* Throws synchronously when:
|
|
199
|
+
* - `participationRefs` is missing or empty (would render the entry
|
|
200
|
+
* un-narrowable for per-ref UX);
|
|
201
|
+
* - `resourceType` is missing or empty (breaks per-resource UI filtering
|
|
202
|
+
* uniformity with the pending-action tier);
|
|
203
|
+
* - `intent` is not a known `ExecutionParticipationPrefetchIntent` value
|
|
204
|
+
* (would silently bypass renderer narrowing UX).
|
|
205
|
+
*/
|
|
206
|
+
export function assertExecutionPendingPrefetchShape(prefetch: ExecutionPendingPrefetch): void {
|
|
207
|
+
if (!Array.isArray(prefetch.participationRefs) || prefetch.participationRefs.length === 0) {
|
|
208
|
+
throw new Error(
|
|
209
|
+
'[ExecutionView] ExecutionPendingPrefetch must carry at least one participation ref. '
|
|
210
|
+
+ 'A prefetch with no refs cannot be narrowed to per-ref UX. '
|
|
211
|
+
+ 'If the work is not tied to any participation, do not register it as a participation prefetch.',
|
|
212
|
+
);
|
|
213
|
+
}
|
|
214
|
+
if (typeof prefetch.resourceType !== 'string' || prefetch.resourceType.length === 0) {
|
|
215
|
+
throw new Error(
|
|
216
|
+
'[ExecutionView] ExecutionPendingPrefetch must carry a non-empty `resourceType` '
|
|
217
|
+
+ 'so per-resource UI filtering composes uniformly with the pending-action tier.',
|
|
218
|
+
);
|
|
219
|
+
}
|
|
220
|
+
if (
|
|
221
|
+
prefetch.intent !== ExecutionParticipationPrefetchIntent.INITIAL
|
|
222
|
+
&& prefetch.intent !== ExecutionParticipationPrefetchIntent.REFRESH
|
|
223
|
+
) {
|
|
224
|
+
throw new Error(
|
|
225
|
+
'[ExecutionView] ExecutionPendingPrefetch.intent must be one of '
|
|
226
|
+
+ '`INITIAL` | `REFRESH` so renderers can distinguish full-screen '
|
|
227
|
+
+ 'vs background hydration UX without a side-channel flag.',
|
|
228
|
+
);
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
```
|