@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,115 @@
|
|
|
1
|
+
# saas.frontend.execution-view.action-status-contract.per-action-retry-loop
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Slice J refinement — the per-action retry loop UX pattern enabled by the
|
|
14
|
+
* Slice G `status.latestFailure` selector + `retry()` / `clearMyFailures()`
|
|
15
|
+
* sugar (parent contract: `saas.frontend.execution-view.action-status-contract`).
|
|
16
|
+
*
|
|
17
|
+
* **The pattern (single-action mutation surface):**
|
|
18
|
+
*
|
|
19
|
+
* ```tsx
|
|
20
|
+
* const action = execution.actions.operation({
|
|
21
|
+
* resourceType: 'todos',
|
|
22
|
+
* resourceId,
|
|
23
|
+
* operationLike: CoreResourceOperation.DELETE,
|
|
24
|
+
* failureScope: { scope: ExecutionFailedActionScope.LOCAL_PANE, paneId },
|
|
25
|
+
* });
|
|
26
|
+
*
|
|
27
|
+
* return (
|
|
28
|
+
* <>
|
|
29
|
+
* <Button
|
|
30
|
+
* disabled={action.status.isPending}
|
|
31
|
+
* onClick={() => { void action.execute(); }}
|
|
32
|
+
* >
|
|
33
|
+
* {action.status.isPending ? 'Deleting…' : 'Delete'}
|
|
34
|
+
* </Button>
|
|
35
|
+
* {action.status.latestFailure && (
|
|
36
|
+
* <Banner>
|
|
37
|
+
* {action.status.latestFailure.error.message}
|
|
38
|
+
* <Button onClick={() => { void action.retry(); }}>Retry</Button>
|
|
39
|
+
* <Button onClick={() => { action.clearMyFailures(); }}>Dismiss</Button>
|
|
40
|
+
* </Banner>
|
|
41
|
+
* )}
|
|
42
|
+
* </>
|
|
43
|
+
* );
|
|
44
|
+
* ```
|
|
45
|
+
*
|
|
46
|
+
* The whole retry loop closes inside one `ExecutionOperationAction` value:
|
|
47
|
+
*
|
|
48
|
+
* 1. **Fail path.** `execute()` rejects → the shell appends a captured entry
|
|
49
|
+
* to `failedActions` keyed by a fresh `failureRuntimeId`. On the next
|
|
50
|
+
* render `action.status.latestFailure` flips from `undefined` to the new
|
|
51
|
+
* entry (max-by-`capturedAt` over the operationPathKey-matched subset),
|
|
52
|
+
* `status.isErrored` is `true`, and the banner mounts.
|
|
53
|
+
*
|
|
54
|
+
* 2. **Retry path.** `retry()` runs `clearMyFailures()` first (subscribers
|
|
55
|
+
* reading `execution.errors` during the new `execute()` see a clean
|
|
56
|
+
* slate) then re-invokes `execute()` with the same `requestData`. A
|
|
57
|
+
* second rejection appends a fresh entry with a NEW `failureRuntimeId`
|
|
58
|
+
* — the contract guarantees re-attempts produce fresh entries rather
|
|
59
|
+
* than mutating the prior one (failure-handling-contract invariant #5).
|
|
60
|
+
* `latestFailure` therefore rotates id even when the error message is
|
|
61
|
+
* byte-identical, which lets a `useEffect([action.status.latestFailure
|
|
62
|
+
* ?.failureRuntimeId])` trigger toast/log side effects on every fresh
|
|
63
|
+
* failure rather than just on first appearance.
|
|
64
|
+
*
|
|
65
|
+
* 3. **Success path.** Successful `execute()` rejection-free completion
|
|
66
|
+
* leaves the (already-cleared) operationPathKey-matched subset empty;
|
|
67
|
+
* `latestFailure` settles to `undefined`, `isErrored` flips to `false`,
|
|
68
|
+
* the banner unmounts. No explicit clear-on-success is required because
|
|
69
|
+
* `retry()` already cleared the prior entries before re-executing.
|
|
70
|
+
*
|
|
71
|
+
* **Per-action vs. cross-action separation (load-bearing).** Use this
|
|
72
|
+
* pattern only when one button = one operation = one banner. Multi-action
|
|
73
|
+
* workflows (e.g. a 4-op data-hydration pipeline that surfaces a single
|
|
74
|
+
* shared failure banner) MUST keep using the global aggregator
|
|
75
|
+
* (`execution.errors.failedActions.reduce(...)` + manual
|
|
76
|
+
* `clearGraphLoadFailures()` + workflow-level retry) — `retry()` is single-
|
|
77
|
+
* action by design and forcing it onto a multi-op workflow would either
|
|
78
|
+
* misattribute the retry to one op or require the consumer to call
|
|
79
|
+
* `op1.retry(); op2.retry(); …` which loses the workflow's ordering. The
|
|
80
|
+
* existing `clearMyFailures()` per-op sugar is still the right tool for
|
|
81
|
+
* scoping the cleanup of multi-op workflows; only `retry()` itself stays
|
|
82
|
+
* single-action.
|
|
83
|
+
*
|
|
84
|
+
* **`failureScope` opt-in (Slice J shell extension).** The shell's
|
|
85
|
+
* `execute()` catch path defaults to `ExecutionFailedActionScope.CUSTOM`
|
|
86
|
+
* (failures persist across pane / embed transitions until manually
|
|
87
|
+
* cleared). Single-action mutation surfaces that live inside a pane should
|
|
88
|
+
* set `failureScope: { scope: LOCAL_PANE, paneId }` on the target so the
|
|
89
|
+
* shell's existing prune helpers (`pruneFailedActionsForPaneTransition`,
|
|
90
|
+
* already wired to `closeLocalPane()` and `openLocalPane(newPaneId, ...)`
|
|
91
|
+
* in `ExecutionView`) drop the captured entry on pane swap/close — the
|
|
92
|
+
* inspector closes, the failure goes with it, the consumer authors zero
|
|
93
|
+
* cleanup. Same shape opt-in exists for `EMBEDDED_CONTENT`-scoped
|
|
94
|
+
* surfaces. The opt-in is per-target (settable on dictionary entries OR
|
|
95
|
+
* per-call via `bind({ failureScope: … })` since `paneId` is per-call
|
|
96
|
+
* fresh under the `paneId-fresh-per-open` policy from
|
|
97
|
+
* `dirty-bridge-contract.local-pane`).
|
|
98
|
+
*
|
|
99
|
+
* **Identity invariant.** `action.status` is a lazy getter cached against
|
|
100
|
+
* the live `runtimeState` reference (see the runtimeStateRef comment at
|
|
101
|
+
* the top of `useExecution`); reads are stable inside one render commit
|
|
102
|
+
* and recompute exactly once per commit. The enclosing `actions` value
|
|
103
|
+
* identity does NOT flip on every `setFailedActions` commit, which is
|
|
104
|
+
* what lets the canonical `useEffect([...ops])` workflow pattern
|
|
105
|
+
* (`TodoListFlowExecutionView`'s `loadGraphResources()` shape) coexist
|
|
106
|
+
* with per-action banners that re-render against the new failure entry.
|
|
107
|
+
*
|
|
108
|
+
* **Two-step destructive-confirm UX is consumer-owned.** The shell does
|
|
109
|
+
* not grow modal/inline-confirm primitives (same rule as the dirty-state
|
|
110
|
+
* confirm-on-close UX from `dirty-bridge-contract.local-pane`). Consumers
|
|
111
|
+
* that need a destructive confirm before firing `execute()` author it
|
|
112
|
+
* locally (state machine: `idle → confirm-pending(N seconds) → fire OR
|
|
113
|
+
* revert`); the action verbs only run once the consumer commits.
|
|
114
|
+
*
|
|
115
|
+
```
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
# saas.frontend.execution-view.definition
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Resource-owned execution view: `surfaceInOperations` keys, Zod + TS `ExecutionViewDefinition`,
|
|
14
|
+
* authoring config, and `resourceExecutionView()` helper.
|
|
15
|
+
*/
|
|
16
|
+
export const ExecutionSurfaceInOperationSchema = ExecutionConcreteOperationIdentitySchema;
|
|
17
|
+
export type ExecutionSurfaceInOperation = OperationKey;
|
|
18
|
+
|
|
19
|
+
export const ExecutionViewDefinitionSchema = z.object({
|
|
20
|
+
/**
|
|
21
|
+
* Execution views are resource-owned inserted surfaces.
|
|
22
|
+
*
|
|
23
|
+
* There is no app-level execution-view authoring contract. Keeping the
|
|
24
|
+
* literal here makes the semantic boundary explicit at schema level instead
|
|
25
|
+
* of relying on downstream consumer checks to reject application-scoped
|
|
26
|
+
* declarations.
|
|
27
|
+
*/
|
|
28
|
+
scope: z.literal(FrontendView_ScopeMode.RESOURCE),
|
|
29
|
+
parentResourcesRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),
|
|
30
|
+
additionalResourceRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),
|
|
31
|
+
|
|
32
|
+
/** Unique view reference inside the owning resource's executionViews map. */
|
|
33
|
+
ref: z.string().min(1),
|
|
34
|
+
|
|
35
|
+
/** Whether this resource-owned execution surface can be addressed via URL. */
|
|
36
|
+
isAddressable: z.boolean().default(false),
|
|
37
|
+
|
|
38
|
+
/** Primary scope for context injection. */
|
|
39
|
+
primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Optional declarative anchor contract.
|
|
43
|
+
*
|
|
44
|
+
* When present, the runtime resolves the execution subject only from the
|
|
45
|
+
* explicitly declared binding key and only from explicit navigation-time
|
|
46
|
+
* context bindings.
|
|
47
|
+
*/
|
|
48
|
+
anchor: ExecutionViewAnchorDefinitionSchema.optional(),
|
|
49
|
+
navigationPolicy: ExecutionNavigationPolicyDefinitionSchema.optional(),
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Direct authored execution renderer component.
|
|
53
|
+
*
|
|
54
|
+
* Execution remains custom-renderer-first, but the owning declaration is
|
|
55
|
+
* resource-bound rather than app-global.
|
|
56
|
+
*/
|
|
57
|
+
surfaceInOperations: z.array(ExecutionSurfaceInOperationSchema).optional(),
|
|
58
|
+
participations: z.record(z.string(), ExecutionParticipationDefinitionSchema).optional(),
|
|
59
|
+
viewComponent: z.any(),
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* How and where this view's launcher is presented on the host record page.
|
|
63
|
+
* Omitted → framework default (a labelled button in the record's action
|
|
64
|
+
* cluster). See {@link InsertedViewLauncherConfig}.
|
|
65
|
+
*/
|
|
66
|
+
launcher: InsertedViewLauncherConfigSchema.optional(),
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* Optional view-local i18n label declarations (label refs + interpolation
|
|
70
|
+
* params) for a CUSTOM execution renderer. The labelling pipeline generates
|
|
71
|
+
* `views.execution.resources.<resourceType>.<ref>.<labelRef>` from these so the
|
|
72
|
+
* renderer resolves its own captions via `tView(...)` — beyond the framework's
|
|
73
|
+
* baseline title/description. Item shape is `LabellingMessageDef`; kept
|
|
74
|
+
* permissive here (like `viewComponent`) since it is authored, not user input.
|
|
75
|
+
*/
|
|
76
|
+
labels: z.array(z.any()).optional(),
|
|
77
|
+
|
|
78
|
+
/** Required features for this view — gates navigation + route access via feature availability policy. */
|
|
79
|
+
requiredFeatures: RequiredFeaturesConfigSchema.optional(),
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* View icon — lucide component reference (not `<JSX />`) or a
|
|
83
|
+
* StandardIconReference string. Surfaces on the embedded launcher button
|
|
84
|
+
* inside the host operation view (and any launcher targeting this view);
|
|
85
|
+
* without it those buttons render the generic fallback icon. Registered by
|
|
86
|
+
* the `IconRegistryBridge` under the `view-execution-{ref}` custom-icon key.
|
|
87
|
+
* Declared in the schema AND the interface — schema-unknown keys are
|
|
88
|
+
* stripped wherever the definition is Zod-parsed.
|
|
89
|
+
*/
|
|
90
|
+
icon: z.custom<IconLike>().optional(),
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Explicit interface keeps the resource-exclusive execution contract obvious
|
|
95
|
+
* in TS.
|
|
96
|
+
*
|
|
97
|
+
* Execution views surface exclusively through `surfaceInOperations` (a list,
|
|
98
|
+
* because a single execution surface can legitimately host into multiple
|
|
99
|
+
* operations). They do not carry an `operationLike` field — that field
|
|
100
|
+
* belongs to composite and chart views, which surface into a single
|
|
101
|
+
* operation host. The render-time filter in `ResourceLayout_InsertedViews`
|
|
102
|
+
* uses `surfaceInOperations` for execution views and `operationLike` for the
|
|
103
|
+
* other two families (see `collectExecutionViewSurfaceRefsByOperation` vs
|
|
104
|
+
* `collectOperationLikeViewRefs`).
|
|
105
|
+
*/
|
|
106
|
+
export interface ExecutionViewDefinition {
|
|
107
|
+
scope: FrontendView_ScopeMode.RESOURCE;
|
|
108
|
+
parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
109
|
+
additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
110
|
+
ref: string;
|
|
111
|
+
isAddressable: boolean;
|
|
112
|
+
primaryScope: ResourcePrimaryScope;
|
|
113
|
+
anchor?: ExecutionViewAnchorDefinition;
|
|
114
|
+
navigationPolicy?: ExecutionNavigationPolicyDefinition;
|
|
115
|
+
surfaceInOperations?: ExecutionSurfaceInOperation[];
|
|
116
|
+
participations?: Record<string, ExecutionParticipationDefinition>;
|
|
117
|
+
viewComponent: React.ComponentType<ExecutionViewComponentProps>;
|
|
118
|
+
/** How and where this view's launcher is presented on the host record page. */
|
|
119
|
+
launcher?: InsertedViewLauncherConfig;
|
|
120
|
+
/**
|
|
121
|
+
* View-local i18n label declarations (refs + params) for custom renderers.
|
|
122
|
+
* Drives generation of `views.execution.resources.<type>.<ref>.<labelRef>`,
|
|
123
|
+
* resolved at render time via `tView(...)`.
|
|
124
|
+
*/
|
|
125
|
+
labels?: LabellingMessageDef[];
|
|
126
|
+
/** Required features for this view — gates navigation + route access */
|
|
127
|
+
requiredFeatures?: RequiredFeaturesConfig;
|
|
128
|
+
/** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
|
|
129
|
+
icon?: IconLike;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
|
|
133
|
+
|
|
134
|
+
export interface ResourceExecutionViewAuthoringConfig {
|
|
135
|
+
isAddressable?: boolean;
|
|
136
|
+
primaryScope?: ResourcePrimaryScope;
|
|
137
|
+
anchor?: ExecutionViewAnchorDefinition;
|
|
138
|
+
navigationPolicy?: ExecutionNavigationPolicyDefinition;
|
|
139
|
+
surfaceInOperations?: ExecutionSurfaceInOperation[];
|
|
140
|
+
parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
141
|
+
additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
|
|
142
|
+
participations?: Record<string, ExecutionParticipationDefinition>;
|
|
143
|
+
viewComponent: React.ComponentType<ExecutionViewComponentProps>;
|
|
144
|
+
/** How and where this view's launcher is presented on the host record page. */
|
|
145
|
+
launcher?: InsertedViewLauncherConfig;
|
|
146
|
+
/** View-local i18n label declarations (refs + params) for custom renderers. */
|
|
147
|
+
labels?: LabellingMessageDef[];
|
|
148
|
+
requiredFeatures?: RequiredFeaturesConfig;
|
|
149
|
+
/** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
|
|
150
|
+
icon?: IconLike;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
export type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;
|
|
154
|
+
export type InsertedExecutionDeclaration = ExecutionViewDefinition;
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Small authoring helper for resource-owned execution views.
|
|
158
|
+
*
|
|
159
|
+
* Keeps execution declarations terse at the resource UIBehavior level while
|
|
160
|
+
* preserving execution-specific semantics such as anchors and explicit resource
|
|
161
|
+
* requirements.
|
|
162
|
+
*/
|
|
163
|
+
export function resourceExecutionView(
|
|
164
|
+
viewComponent: React.ComponentType<ExecutionViewComponentProps>,
|
|
165
|
+
config: Omit<ResourceExecutionViewAuthoringConfig, 'viewComponent'> = {},
|
|
166
|
+
): ResourceExecutionViewAuthoringConfig {
|
|
167
|
+
return {
|
|
168
|
+
...config,
|
|
169
|
+
viewComponent,
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
```
|
package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# saas.frontend.execution-view.dirty-bridge-contract.local-pane
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Slice I refinement — `LOCAL_PANE`-flavor specifics for the dirty-bridge
|
|
14
|
+
* contract (Slice F primitive, see parent anchor
|
|
15
|
+
* `saas.frontend.execution-view.dirty-bridge-contract`).
|
|
16
|
+
*
|
|
17
|
+
* The `LOCAL_PANE` scope discriminant has different lifecycle semantics
|
|
18
|
+
* from `EMBEDDED_CONTENT` because it is **paneId-keyed**: the shell prunes
|
|
19
|
+
* `LOCAL_PANE` markers via `pruneDirtyMarkersForPaneTransition(previous,
|
|
20
|
+
* nextPaneId)`, which keeps markers whose `paneId` matches the active pane
|
|
21
|
+
* and drops the rest. That makes paneId stability a first-class consumer
|
|
22
|
+
* decision, not a contract default. This sub-anchor pins the three
|
|
23
|
+
* defensible policies and the trade-offs each one carries so future
|
|
24
|
+
* `LOCAL_PANE` consumers do not relitigate it case-by-case.
|
|
25
|
+
*
|
|
26
|
+
* **paneId derivation policies (consumer chooses; shell stays neutral):**
|
|
27
|
+
*
|
|
28
|
+
* 1. **Fresh per `localPane.open(...)` call** (e.g. `${prefix}-${randomUUID()}`).
|
|
29
|
+
* Every open mints a new paneId; opening a different node, or even the
|
|
30
|
+
* *same* node twice, transitions paneIds and triggers
|
|
31
|
+
* `pruneDirtyMarkersForPaneTransition` to drop the previous pane's
|
|
32
|
+
* `LOCAL_PANE` markers. Pros: aggressive cleanup, drafts never leak
|
|
33
|
+
* across opens. Cons: closing-then-reopening the same logical surface
|
|
34
|
+
* discards in-flight drafts (intentional under this policy).
|
|
35
|
+
*
|
|
36
|
+
* 2. **Stable per inspected entity** (e.g. `${prefix}:${entityId}`).
|
|
37
|
+
* Re-opening the same entity reuses the paneId; markers persist across
|
|
38
|
+
* re-opens (idempotent re-mark). Switching to a different entity
|
|
39
|
+
* transitions paneIds and prunes the prior entity's markers. Pros:
|
|
40
|
+
* drafts survive accidental close-reopen on the same surface. Cons:
|
|
41
|
+
* requires the consumer to invalidate explicitly when the entity's
|
|
42
|
+
* backing data changes server-side, otherwise a stale draft can survive
|
|
43
|
+
* a refresh.
|
|
44
|
+
*
|
|
45
|
+
* 3. **Stable per pane name** (e.g. always `${prefix}`). Switching nodes
|
|
46
|
+
* does NOT change paneId; the prune helper does not fire on payload
|
|
47
|
+
* swap. **This is the trap policy** — drafts leak across logical
|
|
48
|
+
* surfaces inside the same pane. Documented here so consumers do not
|
|
49
|
+
* pick it accidentally; if you genuinely want one shared draft for "any
|
|
50
|
+
* payload of this pane", say so explicitly in the marker label and own
|
|
51
|
+
* the cross-payload semantics.
|
|
52
|
+
*
|
|
53
|
+
* **Auto-clear timing — three independent paths the consumer can rely on:**
|
|
54
|
+
*
|
|
55
|
+
* - `closeLocalPane()` calls `pruneDirtyMarkersForPaneTransition(previous,
|
|
56
|
+
* null)` which drops every `LOCAL_PANE` marker (paneId mismatch with
|
|
57
|
+
* `null`). Belt-and-suspenders cleanup #1.
|
|
58
|
+
*
|
|
59
|
+
* - `openLocalPane(nextPaneId, ...)` calls
|
|
60
|
+
* `pruneDirtyMarkersForPaneTransition(previous, nextPaneId)` which drops
|
|
61
|
+
* markers whose paneId differs from `nextPaneId`. Belt-and-suspenders
|
|
62
|
+
* cleanup #2 — fires before the new pane content even mounts.
|
|
63
|
+
*
|
|
64
|
+
* - The bridge's own `useEffect` cleanup runs on publisher unmount
|
|
65
|
+
* (component goes away when the pane content stops rendering) and on
|
|
66
|
+
* any input-change re-run. Belt-and-suspenders cleanup #3.
|
|
67
|
+
*
|
|
68
|
+
* All three converge on the same end state: no `LOCAL_PANE` marker
|
|
69
|
+
* survives its pane. Consumers should not need to author manual
|
|
70
|
+
* `clearDirty(...)` calls for `LOCAL_PANE` markers in the close path.
|
|
71
|
+
*
|
|
72
|
+
* **Multi-marker per pane is supported.** Nothing in the contract says a
|
|
73
|
+
* pane gets one marker; consumers can call `useExecutionDirtyBridge`
|
|
74
|
+
* multiple times in the same pane subtree (one per editable field, one
|
|
75
|
+
* per logical "change set", etc.) and each call publishes its own
|
|
76
|
+
* marker. The shell's prune helpers are markerId-agnostic — they filter
|
|
77
|
+
* by scope/paneId only — so all markers belonging to the pane are
|
|
78
|
+
* cleared together on transition. This is the pattern the inspector
|
|
79
|
+
* dogfood uses (one marker per draft field).
|
|
80
|
+
*
|
|
81
|
+
* **Confirm-on-close UX is consumer-owned, not framework-owned.** This is
|
|
82
|
+
* the load-bearing rule from the parent dirty-state contract
|
|
83
|
+
* (`saas.frontend.execution-view.dirty-state-contract`): the shell is
|
|
84
|
+
* informative-only — it publishes the dirty signal and prunes on
|
|
85
|
+
* transitions, but it never blocks `closeLocalPane()` on dirty state.
|
|
86
|
+
* If the consumer wants a "Discard unsaved changes?" prompt, the
|
|
87
|
+
* consumer authors it (typically by gating the close button's `onClick`
|
|
88
|
+
* on `execution.dirty.isDirty((m) => m.scope === LOCAL_PANE && m.paneId
|
|
89
|
+
* === currentPaneId)`). The framework refuses to grow modal UX
|
|
90
|
+
* primitives because (a) confirm UX is application-specific (modal /
|
|
91
|
+
* inline / toast / route guard) and (b) gating shell APIs would
|
|
92
|
+
* couple the dirty contract to UX policy.
|
|
93
|
+
*
|
|
94
|
+
* **L1 acknowledged trade-off (carried over from Slice H pattern of
|
|
95
|
+
* recording rot risks at the anchor):** the bridge does not assert
|
|
96
|
+
* `paneId` matches the currently-active `localPane.paneId` when
|
|
97
|
+
* publishing a `LOCAL_PANE` marker. A bug in the consumer (e.g. typo'd
|
|
98
|
+
* paneId, racey re-render holding a stale paneId) would publish a
|
|
99
|
+
* marker that never matches the active pane and therefore never
|
|
100
|
+
* auto-clears via the prune helpers. The unmount cleanup is the only
|
|
101
|
+
* safety net in that case. Validation was rejected because (a) the
|
|
102
|
+
* publisher already lives inside the pane subtree by definition — a
|
|
103
|
+
* paneId mismatch is a programming error, not a runtime condition, and
|
|
104
|
+
* (b) a runtime check would force the bridge to subscribe to
|
|
105
|
+
* `executionContext.runtimeState.localPane`, which would re-fire the
|
|
106
|
+
* effect on every pane open/close (defeating the carefully-tuned deps
|
|
107
|
+
* list documented above). Re-evaluate at the first reported bug.
|
|
108
|
+
*
|
|
109
|
+
```
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# saas.frontend.execution-view.dirty-bridge-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
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Slice F primitive — generic publisher hook for the execution-shell
|
|
14
|
+
* dirty-state contract.
|
|
15
|
+
*
|
|
16
|
+
* The dirty-state contract (see `dirty-state-contract` anchor in
|
|
17
|
+
* `ExecutionRuntimeContext.tsx`) leaves "publisher owns mark/clear" as the
|
|
18
|
+
* load-bearing rule. `useExecutionDirtyBridge` is the canonical primitive
|
|
19
|
+
* that turns any boolean-shaped "is this surface dirty?" signal into a
|
|
20
|
+
* shell-published marker with the right scope, the right lifecycle, and
|
|
21
|
+
* the right cleanup — without the publisher having to know whether it is
|
|
22
|
+
* mounted inside an execution shell, which zone scope it occupies, or
|
|
23
|
+
* how the shell prunes markers on zone transitions.
|
|
24
|
+
*
|
|
25
|
+
* Two key invariants this hook enforces so consumers cannot get them wrong:
|
|
26
|
+
*
|
|
27
|
+
* 1. **No-op outside an execution shell.** When the hook is called from a
|
|
28
|
+
* component tree that is NOT under `ExecutionRuntimeProvider`, it does
|
|
29
|
+
* nothing — no marks, no clears, no errors. This makes the hook safe
|
|
30
|
+
* to call unconditionally from framework components like
|
|
31
|
+
* `ResourceAutomatedForm` that are mounted in plenty of non-execution
|
|
32
|
+
* contexts (resource layouts, composite views, custom views).
|
|
33
|
+
*
|
|
34
|
+
* 2. **Always clear on unmount.** Whether the marker was registered as
|
|
35
|
+
* `EMBEDDED_CONTENT`, `LOCAL_PANE`, or `CUSTOM`, the bridge clears it
|
|
36
|
+
* when the publisher component unmounts. This guarantees that even
|
|
37
|
+
* `CUSTOM` markers (which the shell never auto-prunes) cannot leak
|
|
38
|
+
* when their owning component goes away.
|
|
39
|
+
*
|
|
40
|
+
* Scope inference is delegated to `ExecutionDirtyMarkerScopeContext`
|
|
41
|
+
* (companion file). The shell's embedded slot wraps its content in
|
|
42
|
+
* `<ExecutionDirtyMarkerScopeProvider scope={EMBEDDED_CONTENT}>` so any
|
|
43
|
+
* RMM-backed editor mounted into the embed publishes under the right
|
|
44
|
+
* scope. Consumers that render content into the local pane can wrap their
|
|
45
|
+
* pane content in `<ExecutionDirtyMarkerScopeProvider scope={LOCAL_PANE}
|
|
46
|
+
* paneId={...}>`. When neither provider is in scope, the bridge falls back
|
|
47
|
+
* to `CUSTOM` (informative, never auto-pruned, cleared on unmount).
|
|
48
|
+
*
|
|
49
|
+
* This primitive does not subscribe to any external store. The caller
|
|
50
|
+
* owns subscription (typically `useSyncExternalStore(rmm.subscribe,
|
|
51
|
+
* rmm.getSnapshot)` for an RMM-backed consumer) and feeds the resulting
|
|
52
|
+
* boolean in. That keeps the hook generic and avoids duplicate RMM
|
|
53
|
+
* subscriptions when the caller already has one.
|
|
54
|
+
*
|
|
55
|
+
```
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
# saas.frontend.execution-view.dirty-state-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 dirty-state contract.
|
|
14
|
+
*
|
|
15
|
+
* The execution shell aggregates **authored** dirty-state markers — one per
|
|
16
|
+
* distinguishable unsaved surface — so consumers can query a single truthful
|
|
17
|
+
* `execution.dirty` signal before kicking zone transitions (close the embed,
|
|
18
|
+
* replace the embed, switch panes, delegate to the router). The shell does
|
|
19
|
+
* **not** enforce modals or block transitions; it only publishes the markers.
|
|
20
|
+
* UX decisions (confirm dialog, toast, ignore) live with the consumer.
|
|
21
|
+
*
|
|
22
|
+
* Publisher / subscriber model (mirrors the loading-aggregation tier):
|
|
23
|
+
*
|
|
24
|
+
* - **Publishers** are whoever owns the unsaved state. Today that's either a
|
|
25
|
+
* custom component rendering zone-B content with editable fields, or an
|
|
26
|
+
* adapter wrapping an RMM-backed embedded edit surface (zone A). Publishers
|
|
27
|
+
* call `execution.dirty.mark({ markerId, scope, label?, paneId? })` on
|
|
28
|
+
* first edit and `execution.dirty.clear(markerId)` on save/discard.
|
|
29
|
+
* - **Subscribers** (the execution view renderer, the shell's transition
|
|
30
|
+
* verbs) read `execution.dirty.markers` / `execution.dirty.isAnyDirty` and
|
|
31
|
+
* author UX accordingly.
|
|
32
|
+
*
|
|
33
|
+
* Why the shell doesn't query the embedded layout directly: the shell does
|
|
34
|
+
* not hold a reference to the embedded layout's RMM instance — that
|
|
35
|
+
* `ResourceMutationManager` lives inside the `ResourceOperationSurface` and
|
|
36
|
+
* exposes `hasUnsavedChanges` only through `useResourceMutationManager`
|
|
37
|
+
* subscribers, not through a cross-layer observable. Adding a cross-reach
|
|
38
|
+
* would couple the shell to a specific mutation manager implementation. The
|
|
39
|
+
* publish/subscribe contract keeps the boundary clean.
|
|
40
|
+
*
|
|
41
|
+
* **Scopes** classify a marker's lifecycle so the shell can safely auto-clean
|
|
42
|
+
* without asking the publisher. Scope is not purely decorative — it drives
|
|
43
|
+
* the auto-cleanup invariant below:
|
|
44
|
+
*
|
|
45
|
+
* - `EMBEDDED_CONTENT` — the unsaved state belongs to the current embed
|
|
46
|
+
* slot. When the slot empties (close, replace), the marker is auto-cleared
|
|
47
|
+
* because the layout that authored it is gone by definition.
|
|
48
|
+
* - `LOCAL_PANE` — the unsaved state belongs to the currently-open
|
|
49
|
+
* `localPane`. When the pane closes or a *different* `paneId` opens, the
|
|
50
|
+
* marker is auto-cleared. If the publisher wants the draft to survive
|
|
51
|
+
* pane-id transitions, it should use `CUSTOM` scope.
|
|
52
|
+
* - `CUSTOM` — consumer-owned lifecycle. The shell never auto-clears these.
|
|
53
|
+
* Used for draft state that outlives any single zone transition (e.g.
|
|
54
|
+
* a top-level side panel authored by the custom component itself).
|
|
55
|
+
*
|
|
56
|
+
* Contract invariants:
|
|
57
|
+
*
|
|
58
|
+
* 1. **Publisher owns mark/clear.** The shell never synthesizes markers — no
|
|
59
|
+
* "auto-mark on first type" magic. Publishers call `mark()` explicitly,
|
|
60
|
+
* and symmetrically call `clear()` on save or discard.
|
|
61
|
+
* 2. **Auto-cleanup at zone boundaries.** `closeEmbeddedContent`/
|
|
62
|
+
* `openEmbeddedContent` clear all `EMBEDDED_CONTENT`-scoped markers;
|
|
63
|
+
* `closeLocalPane`/`openLocalPane` clear all `LOCAL_PANE`-scoped markers
|
|
64
|
+
* whose `paneId` no longer matches the active pane. `CUSTOM` markers are
|
|
65
|
+
* untouched.
|
|
66
|
+
* 3. **Stable marker ids.** `markerId` must be stable across re-renders of
|
|
67
|
+
* the same publisher — re-marking an existing id is idempotent (replaces
|
|
68
|
+
* the entry, does not produce a duplicate).
|
|
69
|
+
* 4. **Shell is informative, not restrictive.** Transition verbs
|
|
70
|
+
* (`closeEmbeddedContent`, `openEmbeddedContent`, `delegateToParent`) do
|
|
71
|
+
* *not* block on dirty state. Consumers read `isAnyDirty` and author
|
|
72
|
+
* their own confirm flow before calling the transition. Making the shell
|
|
73
|
+
* block would force a modal UX the framework cannot reasonably author
|
|
74
|
+
* centrally.
|
|
75
|
+
* 5. **Per-runtime-instance scope.** The aggregator lives on
|
|
76
|
+
* `ExecutionRuntimeState`, not globally. Two execution views mounted in
|
|
77
|
+
* the same app do not share dirty markers.
|
|
78
|
+
* 6. **Orthogonal to other shell tiers.** Dirty state is not a navigation
|
|
79
|
+
* zone (three-zone contract) nor operational telemetry (loading
|
|
80
|
+
* aggregation). It is its own shell tier with its own invariants.
|
|
81
|
+
*/
|
|
82
|
+
export enum ExecutionDirtyMarkerScope {
|
|
83
|
+
EMBEDDED_CONTENT = 'embedded-content',
|
|
84
|
+
LOCAL_PANE = 'local-pane',
|
|
85
|
+
CUSTOM = 'custom',
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Common shape for every dirty marker, regardless of scope.
|
|
90
|
+
*
|
|
91
|
+
* Intentionally not exported on its own — consumers use the
|
|
92
|
+
* `ExecutionDirtyMarker` discriminated union below so the type system
|
|
93
|
+
* enforces "LOCAL_PANE markers carry a `paneId`" without requiring
|
|
94
|
+
* defensive `!== undefined` checks at every read site.
|
|
95
|
+
*/
|
|
96
|
+
interface ExecutionDirtyMarkerBase {
|
|
97
|
+
/**
|
|
98
|
+
* Stable publisher-authored id. Re-marking the same id is idempotent —
|
|
99
|
+
* the entry is replaced, not duplicated. Typically derived from a
|
|
100
|
+
* resource identity (e.g. `embed:tasks:task-1:UPDATE`) or a pane-scoped
|
|
101
|
+
* key (e.g. `pane:todo-inspector:draft`).
|
|
102
|
+
*/
|
|
103
|
+
markerId: string;
|
|
104
|
+
/**
|
|
105
|
+
* Optional human-readable reason ("Unsaved task changes", "Draft
|
|
106
|
+
* description"). Consumers may surface it in confirm dialogs or ambient
|
|
107
|
+
* badges; the shell treats it as opaque metadata.
|
|
108
|
+
*/
|
|
109
|
+
label?: string;
|
|
110
|
+
/** `Date.now()` when the marker was first registered. */
|
|
111
|
+
markedAt: number;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Discriminated union of dirty markers.
|
|
116
|
+
*
|
|
117
|
+
* The discriminant `scope` makes "`paneId` is required for `LOCAL_PANE`
|
|
118
|
+
* markers, absent on the others" a compile-time invariant — there is no
|
|
119
|
+
* `paneId?` escape hatch on the non-pane variants. Combined with the
|
|
120
|
+
* runtime assertion `assertExecutionDirtyMarkerShape`, dynamic callers
|
|
121
|
+
* (test mocks, deserialized state, authored dictionaries) cannot collapse
|
|
122
|
+
* the variants either.
|
|
123
|
+
*/
|
|
124
|
+
export type ExecutionDirtyMarker =
|
|
125
|
+
| (ExecutionDirtyMarkerBase & { scope: ExecutionDirtyMarkerScope.EMBEDDED_CONTENT })
|
|
126
|
+
| (ExecutionDirtyMarkerBase & { scope: ExecutionDirtyMarkerScope.LOCAL_PANE; paneId: string })
|
|
127
|
+
| (ExecutionDirtyMarkerBase & { scope: ExecutionDirtyMarkerScope.CUSTOM });
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* Belt-and-braces runtime check that a `ExecutionDirtyMarker` matches its
|
|
131
|
+
* discriminant invariants. The type layer already enforces these for
|
|
132
|
+
* statically-shaped callers; this assertion exists for dynamic callers
|
|
133
|
+
* (test mocks, deserialized payloads, authored dictionaries) where the
|
|
134
|
+
* type may have been widened via `as`/`unknown`.
|
|
135
|
+
*
|
|
136
|
+
* Throws synchronously when a `LOCAL_PANE` marker is registered without a
|
|
137
|
+
* `paneId` — the only invariant that cannot be expressed any other way.
|
|
138
|
+
*/
|
|
139
|
+
export function assertExecutionDirtyMarkerShape(marker: ExecutionDirtyMarker): void {
|
|
140
|
+
if (marker.scope === ExecutionDirtyMarkerScope.LOCAL_PANE) {
|
|
141
|
+
const candidate = marker as { paneId?: unknown };
|
|
142
|
+
if (typeof candidate.paneId !== 'string' || candidate.paneId.length === 0) {
|
|
143
|
+
throw new Error(
|
|
144
|
+
'[ExecutionView] LOCAL_PANE-scoped dirty marker must carry a non-empty `paneId` '
|
|
145
|
+
+ 'so the shell can auto-clear it on pane transitions. '
|
|
146
|
+
+ 'Use scope=CUSTOM for markers that should outlive any single pane.',
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
```
|