@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,65 @@
|
|
|
1
|
+
# roadmap.snapshot.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Versioning for the roadmap-snapshot payload format itself. `V1` — initial
|
|
14
|
+
* shape (a single ordered `phases` collection). The shape grows additively
|
|
15
|
+
* across versions — older callers keep parsing newer payloads via
|
|
16
|
+
* `default([])` semantics on the additive members; the `version` field is
|
|
17
|
+
* the explicit marker for consumers that need to branch on era.
|
|
18
|
+
*/
|
|
19
|
+
export enum RoadmapSnapshotVersion {
|
|
20
|
+
V1 = 'v1',
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* THE roadmap-snapshot payload — a **single aggregate per product**
|
|
25
|
+
* (market / vision / requirements style), NOT a keyed entries map
|
|
26
|
+
* (assertions style): there is exactly one delivery roadmap per
|
|
27
|
+
* application. It is the roadmap-layer artifact the app-creation top-down
|
|
28
|
+
* catalog reads/writes (C-4 definition families), and the primary input
|
|
29
|
+
* the scope/roadmap playbook (U9) consumes.
|
|
30
|
+
*
|
|
31
|
+
* **Artifact-family id: `roadmap`.** This schema is the shape of the
|
|
32
|
+
* journey artifact selected by
|
|
33
|
+
* `MetaWorkflow_ArtifactSelector.family === 'roadmap'` (alongside the
|
|
34
|
+
* `market-snapshot` / `vision-brief` / `requirements` ids). The `family`
|
|
35
|
+
* vocabulary is an OPEN string by design (owned by the assertion surface,
|
|
36
|
+
* not a frozen enum — see `MetaWorkflow_ArtifactSelectorSchema`), so it is
|
|
37
|
+
* intentionally NOT re-declared as a constant here; this note is the
|
|
38
|
+
* single place that ties the `RoadmapSnapshot` SHAPE to the `roadmap`
|
|
39
|
+
* family NAME so the scope/roadmap playbook (U9) and the WT dogfood (D1)
|
|
40
|
+
* select it consistently.
|
|
41
|
+
*
|
|
42
|
+
* Shape decision (framework mindset — the member carries its own semantic
|
|
43
|
+
* weight, no folding into `MilestoneSpecification`, `FeatureSpecification`,
|
|
44
|
+
* or the vision / requirements / market families):
|
|
45
|
+
*
|
|
46
|
+
* - **`phases`** — the ONE ref-addressable collection: the ordered
|
|
47
|
+
* releases / stages of the delivery plan (`default([])`), each ordered by
|
|
48
|
+
* its own `sequence` key and optionally cross-referencing the
|
|
49
|
+
* requirements / vision it delivers. An empty collection is a first-class
|
|
50
|
+
* "not yet planned" state surfaced as a WARN by `validateRoadmapSnapshot`,
|
|
51
|
+
* never a parse failure.
|
|
52
|
+
*
|
|
53
|
+
* Authored entirely in English (like the vision / market / requirements
|
|
54
|
+
* families). Authoring-consistency (duplicate refs, ref format, duplicate
|
|
55
|
+
* sequence, incompleteness, staleness, dangling deliver-refs) is checked by
|
|
56
|
+
* `validateRoadmapSnapshot` (see `roadmap-snapshot-validation.ts`); Zod
|
|
57
|
+
* enforces only structural validity here.
|
|
58
|
+
*/
|
|
59
|
+
export const RoadmapSnapshotSchema = z.object({
|
|
60
|
+
version: z.enum(RoadmapSnapshotVersion).default(RoadmapSnapshotVersion.V1),
|
|
61
|
+
/** The ordered releases / stages of the delivery plan. Ref-addressable. */
|
|
62
|
+
phases: z.array(RoadmapPhaseConfigSchema).default([]),
|
|
63
|
+
});
|
|
64
|
+
export type RoadmapSnapshot = z.infer<typeof RoadmapSnapshotSchema>;
|
|
65
|
+
```
|
|
@@ -0,0 +1,325 @@
|
|
|
1
|
+
# roadmap.snapshot.validation
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Authoring-consistency validator for an assembled `RoadmapSnapshot`.
|
|
14
|
+
*
|
|
15
|
+
* The function is a **pure**, **typed** graph walker over the snapshot —
|
|
16
|
+
* no Zod introspection, no registry access, no I/O (the `_core` validator
|
|
17
|
+
* convention shared with `validateMarketSnapshot` / `validateVisionSnapshot`
|
|
18
|
+
* / `validateRequirementsSnapshot` / `validateAssertionSpecificationSnapshot`).
|
|
19
|
+
* Zod already enforces structural validity (ref formats at parse time);
|
|
20
|
+
* this walker adds the cross-entity + completeness checks Zod cannot
|
|
21
|
+
* express, the defence-in-depth ref-format check for type-asserted
|
|
22
|
+
* fixtures that bypass parsing, and the fail-soft cross-family
|
|
23
|
+
* requirement / success-criterion ref resolution.
|
|
24
|
+
*
|
|
25
|
+
* Rule table — 8 kinds (scaffold depth, Phase J1 — deeper roadmap quality
|
|
26
|
+
* / timeline / dependency analysis is Phase J2):
|
|
27
|
+
*
|
|
28
|
+
* | Kind | Severity | Trigger |
|
|
29
|
+
* |-------------------------------|----------|--------------------------------------------------------------------------------|
|
|
30
|
+
* | `INVALID_REF_FORMAT` | ERROR | A phase ref fails the shared pattern (single source of truth with the Zod schema). Defence in depth for type-asserted fixtures. |
|
|
31
|
+
* | `DUPLICATE_REF` | ERROR | Two phases share a ref — the collection silently loses one entity to last-wins indexing. |
|
|
32
|
+
* | `DUPLICATE_SEQUENCE` | WARN | Two phases share a `sequence` — the roadmap order between them is ambiguous. WARN (the phases are still valid; the ordering is just under-specified). |
|
|
33
|
+
* | `DUPLICATE_CROSS_REF` | WARN | The same deliver-ref is listed more than once on ONE phase's deliver-list — the repeat is noise the catalog silently dedupes (or double-counts in coverage). Intra-snapshot, so it runs UNCONDITIONALLY (no external set needed) — each deliver-list is its own namespace. |
|
|
34
|
+
* | `NO_PHASES` | WARN | `phases` empty — the roadmap plans no delivery. |
|
|
35
|
+
* | `STALE_AUTHORED` | WARN | Any phase's `authored.lastAuthoredAt + reviewCadence < now`. No check when `reviewCadence` is undefined or `AS_NEEDED`. |
|
|
36
|
+
* | `UNKNOWN_REQUIREMENT_REF` | ERROR | A `deliversRequirementRefs` entry does not resolve in `options.availableRequirementRefs`. SKIPPED (fail-soft) when no set is passed — the families are decoupled and the catalog resolves refs. |
|
|
37
|
+
* | `UNKNOWN_SUCCESS_CRITERION_REF` | ERROR | A `deliversSuccessCriterionRefs` entry does not resolve in `options.availableSuccessCriterionRefs`. SKIPPED (fail-soft) when no set is passed. |
|
|
38
|
+
*
|
|
39
|
+
* Severity is a TS enum (project rule — enums over literal unions). The
|
|
40
|
+
* validator never mutates the snapshot. Issue ordering is detector-order
|
|
41
|
+
* then walk-order — NOT a stable contract; callers group/sort by `kind` +
|
|
42
|
+
* `severity` themselves.
|
|
43
|
+
*/
|
|
44
|
+
export enum RoadmapSnapshotIssueKind {
|
|
45
|
+
/**
|
|
46
|
+
* A phase ref violates its kebab-case prefix contract. The Zod schema
|
|
47
|
+
* rejects this at parse time; the detector remains as defence in depth
|
|
48
|
+
* for callers that bypass parsing (tests building snapshots with
|
|
49
|
+
* type-asserted fixtures). ERROR.
|
|
50
|
+
*/
|
|
51
|
+
INVALID_REF_FORMAT = 'invalid_ref_format',
|
|
52
|
+
/**
|
|
53
|
+
* Two phases share a ref. The collection is addressed by ref
|
|
54
|
+
* downstream, so a duplicate silently drops one phase. ERROR.
|
|
55
|
+
*/
|
|
56
|
+
DUPLICATE_REF = 'duplicate_ref',
|
|
57
|
+
/**
|
|
58
|
+
* Two phases share a `sequence`. The ordering between them is ambiguous
|
|
59
|
+
* (consumers sort by `sequence`), but no data is lost — WARN, not ERROR.
|
|
60
|
+
* Give each phase a distinct sequence.
|
|
61
|
+
*/
|
|
62
|
+
DUPLICATE_SEQUENCE = 'duplicate_sequence',
|
|
63
|
+
/**
|
|
64
|
+
* The same requirement / success-criterion ref appears more than once on
|
|
65
|
+
* ONE phase's deliver-list. The repeat carries no meaning — the catalog
|
|
66
|
+
* dedupes it (or double-counts it in coverage). WARN, not ERROR: the
|
|
67
|
+
* phase is still valid, the authoring is just untidy. Runs
|
|
68
|
+
* unconditionally (intra-snapshot, needs no external set); each
|
|
69
|
+
* deliver-list is its own namespace, so the same string appearing once
|
|
70
|
+
* in each of the two lists is NOT a duplicate.
|
|
71
|
+
*/
|
|
72
|
+
DUPLICATE_CROSS_REF = 'duplicate_cross_ref',
|
|
73
|
+
/** `phases` empty — the roadmap plans no delivery (WARN). */
|
|
74
|
+
NO_PHASES = 'no_phases',
|
|
75
|
+
/** `lastAuthoredAt + reviewCadence < now` (WARN — market/vision/requirements parity). */
|
|
76
|
+
STALE_AUTHORED = 'stale_authored',
|
|
77
|
+
/**
|
|
78
|
+
* A `deliversRequirementRefs` entry does not resolve against the
|
|
79
|
+
* supplied requirement-ref set — a dangling cross-family reference.
|
|
80
|
+
* ERROR when a set is supplied; the whole check is SKIPPED (fail-soft)
|
|
81
|
+
* when it is not.
|
|
82
|
+
*/
|
|
83
|
+
UNKNOWN_REQUIREMENT_REF = 'unknown_requirement_ref',
|
|
84
|
+
/**
|
|
85
|
+
* A `deliversSuccessCriterionRefs` entry does not resolve against the
|
|
86
|
+
* supplied success-criterion-ref set. ERROR when a set is supplied;
|
|
87
|
+
* SKIPPED (fail-soft) when it is not.
|
|
88
|
+
*/
|
|
89
|
+
UNKNOWN_SUCCESS_CRITERION_REF = 'unknown_success_criterion_ref',
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export enum RoadmapSnapshotIssueSeverity {
|
|
93
|
+
ERROR = 'error',
|
|
94
|
+
WARN = 'warn',
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export interface RoadmapSnapshotIssue {
|
|
98
|
+
kind: RoadmapSnapshotIssueKind;
|
|
99
|
+
/** Dotted path inside the snapshot (e.g. `'phases[2].ref'`). */
|
|
100
|
+
path: string;
|
|
101
|
+
message: string;
|
|
102
|
+
severity: RoadmapSnapshotIssueSeverity;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export interface RoadmapSnapshotValidationResult {
|
|
106
|
+
/** `true` iff no issue has severity `ERROR`. */
|
|
107
|
+
ok: boolean;
|
|
108
|
+
issues: RoadmapSnapshotIssue[];
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
export interface ValidateRoadmapSnapshotOptions {
|
|
112
|
+
/** Override "now" for `STALE_AUTHORED` checks (test affordance). Defaults to `new Date()`. */
|
|
113
|
+
now?: Date;
|
|
114
|
+
/**
|
|
115
|
+
* Resolvable functional-requirement refs. When supplied, every
|
|
116
|
+
* `deliversRequirementRefs` entry not in the set is reported as
|
|
117
|
+
* `UNKNOWN_REQUIREMENT_REF`. When omitted, the check is skipped entirely
|
|
118
|
+
* (fail-soft — the roadmap family is decoupled from the requirements
|
|
119
|
+
* family; the catalog owns resolution).
|
|
120
|
+
*/
|
|
121
|
+
availableRequirementRefs?: ReadonlySet<string>;
|
|
122
|
+
/**
|
|
123
|
+
* Resolvable vision success-criterion refs. Same skip-when-omitted
|
|
124
|
+
* semantics as `availableRequirementRefs`, reported as
|
|
125
|
+
* `UNKNOWN_SUCCESS_CRITERION_REF`.
|
|
126
|
+
*/
|
|
127
|
+
availableSuccessCriterionRefs?: ReadonlySet<string>;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Days-per-cadence mapping, mirrored from the market / vision /
|
|
132
|
+
* requirements / assertions validators (module-local there too — a shared
|
|
133
|
+
* promotion is part of the deferred authored-metadata generalization).
|
|
134
|
+
*/
|
|
135
|
+
const REVIEW_CADENCE_TO_DAYS: Record<ReviewCadence, number> = {
|
|
136
|
+
[ReviewCadence.WEEKLY]: 7,
|
|
137
|
+
[ReviewCadence.MONTHLY]: 31,
|
|
138
|
+
[ReviewCadence.QUARTERLY]: 92,
|
|
139
|
+
[ReviewCadence.YEARLY]: 366,
|
|
140
|
+
[ReviewCadence.AS_NEEDED]: Number.POSITIVE_INFINITY,
|
|
141
|
+
};
|
|
142
|
+
|
|
143
|
+
export function validateRoadmapSnapshot(
|
|
144
|
+
snapshot: RoadmapSnapshot,
|
|
145
|
+
options?: ValidateRoadmapSnapshotOptions,
|
|
146
|
+
): RoadmapSnapshotValidationResult {
|
|
147
|
+
const issues: RoadmapSnapshotIssue[] = [];
|
|
148
|
+
|
|
149
|
+
detectInvalidRefFormats(snapshot, issues);
|
|
150
|
+
detectDuplicateRefs(snapshot, issues);
|
|
151
|
+
detectDuplicateSequences(snapshot, issues);
|
|
152
|
+
detectDuplicateCrossRefs(snapshot, issues);
|
|
153
|
+
detectIncompleteness(snapshot, issues);
|
|
154
|
+
detectStaleAuthored(snapshot, options?.now ?? new Date(), issues);
|
|
155
|
+
detectUnknownCrossRefs(snapshot, options, issues);
|
|
156
|
+
|
|
157
|
+
const ok = issues.every(
|
|
158
|
+
issue => issue.severity !== RoadmapSnapshotIssueSeverity.ERROR,
|
|
159
|
+
);
|
|
160
|
+
return { ok, issues };
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
// ────────────────────────────────────────────────────────────────────
|
|
164
|
+
// Detectors — one per rule, kept small and independently testable.
|
|
165
|
+
// ────────────────────────────────────────────────────────────────────
|
|
166
|
+
|
|
167
|
+
function detectInvalidRefFormats(
|
|
168
|
+
snapshot: RoadmapSnapshot,
|
|
169
|
+
issues: RoadmapSnapshotIssue[],
|
|
170
|
+
): void {
|
|
171
|
+
snapshot.phases.forEach((entry, index) => {
|
|
172
|
+
if (ROADMAP_PHASE_REF_PATTERN.test(entry.ref)) return;
|
|
173
|
+
issues.push({
|
|
174
|
+
kind: RoadmapSnapshotIssueKind.INVALID_REF_FORMAT,
|
|
175
|
+
path: `phases[${index}].ref`,
|
|
176
|
+
message: `Roadmap-phase ref "${entry.ref}" is not kebab-case with the "roadmap-phase-" prefix.`,
|
|
177
|
+
severity: RoadmapSnapshotIssueSeverity.ERROR,
|
|
178
|
+
});
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
function detectDuplicateRefs(
|
|
183
|
+
snapshot: RoadmapSnapshot,
|
|
184
|
+
issues: RoadmapSnapshotIssue[],
|
|
185
|
+
): void {
|
|
186
|
+
const seen = new Set<string>();
|
|
187
|
+
snapshot.phases.forEach((entry, index) => {
|
|
188
|
+
if (!seen.has(entry.ref)) {
|
|
189
|
+
seen.add(entry.ref);
|
|
190
|
+
return;
|
|
191
|
+
}
|
|
192
|
+
issues.push({
|
|
193
|
+
kind: RoadmapSnapshotIssueKind.DUPLICATE_REF,
|
|
194
|
+
path: `phases[${index}].ref`,
|
|
195
|
+
message: `Duplicate ref "${entry.ref}" in phases — refs must be unique; the collection is addressed by ref downstream.`,
|
|
196
|
+
severity: RoadmapSnapshotIssueSeverity.ERROR,
|
|
197
|
+
});
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
function detectDuplicateSequences(
|
|
202
|
+
snapshot: RoadmapSnapshot,
|
|
203
|
+
issues: RoadmapSnapshotIssue[],
|
|
204
|
+
): void {
|
|
205
|
+
const seen = new Set<number>();
|
|
206
|
+
snapshot.phases.forEach((entry, index) => {
|
|
207
|
+
if (!seen.has(entry.sequence)) {
|
|
208
|
+
seen.add(entry.sequence);
|
|
209
|
+
return;
|
|
210
|
+
}
|
|
211
|
+
issues.push({
|
|
212
|
+
kind: RoadmapSnapshotIssueKind.DUPLICATE_SEQUENCE,
|
|
213
|
+
path: `phases[${index}].sequence`,
|
|
214
|
+
message: `Duplicate sequence ${entry.sequence} on phase "${entry.ref}" — two phases share an ordering key, so the roadmap order between them is ambiguous. Give each phase a distinct sequence.`,
|
|
215
|
+
severity: RoadmapSnapshotIssueSeverity.WARN,
|
|
216
|
+
});
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
function detectDuplicateCrossRefs(
|
|
221
|
+
snapshot: RoadmapSnapshot,
|
|
222
|
+
issues: RoadmapSnapshotIssue[],
|
|
223
|
+
): void {
|
|
224
|
+
const checkList = (
|
|
225
|
+
refs: readonly string[] | undefined,
|
|
226
|
+
entry: RoadmapPhaseConfig,
|
|
227
|
+
path: string,
|
|
228
|
+
): void => {
|
|
229
|
+
if (refs === undefined) return;
|
|
230
|
+
const seen = new Set<string>();
|
|
231
|
+
refs.forEach((ref, refIndex) => {
|
|
232
|
+
if (!seen.has(ref)) {
|
|
233
|
+
seen.add(ref);
|
|
234
|
+
return;
|
|
235
|
+
}
|
|
236
|
+
issues.push({
|
|
237
|
+
kind: RoadmapSnapshotIssueKind.DUPLICATE_CROSS_REF,
|
|
238
|
+
path: `${path}[${refIndex}]`,
|
|
239
|
+
message: `Deliver-ref "${ref}" is listed more than once on phase "${entry.ref}" (${path}). Remove the duplicate.`,
|
|
240
|
+
severity: RoadmapSnapshotIssueSeverity.WARN,
|
|
241
|
+
});
|
|
242
|
+
});
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
snapshot.phases.forEach((entry, index) => {
|
|
246
|
+
checkList(entry.deliversRequirementRefs, entry, `phases[${index}].deliversRequirementRefs`);
|
|
247
|
+
checkList(
|
|
248
|
+
entry.deliversSuccessCriterionRefs,
|
|
249
|
+
entry,
|
|
250
|
+
`phases[${index}].deliversSuccessCriterionRefs`,
|
|
251
|
+
);
|
|
252
|
+
});
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
function detectIncompleteness(
|
|
256
|
+
snapshot: RoadmapSnapshot,
|
|
257
|
+
issues: RoadmapSnapshotIssue[],
|
|
258
|
+
): void {
|
|
259
|
+
if (snapshot.phases.length === 0) {
|
|
260
|
+
issues.push({
|
|
261
|
+
kind: RoadmapSnapshotIssueKind.NO_PHASES,
|
|
262
|
+
path: 'phases',
|
|
263
|
+
message: 'Roadmap plans no phases — it describes no delivery of the product.',
|
|
264
|
+
severity: RoadmapSnapshotIssueSeverity.WARN,
|
|
265
|
+
});
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
function detectStaleAuthored(
|
|
270
|
+
snapshot: RoadmapSnapshot,
|
|
271
|
+
now: Date,
|
|
272
|
+
issues: RoadmapSnapshotIssue[],
|
|
273
|
+
): void {
|
|
274
|
+
const checkOne = (authored: RoadmapAuthoredMetadata | undefined, path: string): void => {
|
|
275
|
+
if (authored?.reviewCadence === undefined) return;
|
|
276
|
+
const days = REVIEW_CADENCE_TO_DAYS[authored.reviewCadence];
|
|
277
|
+
if (!Number.isFinite(days)) return;
|
|
278
|
+
const lastAuthored = new Date(authored.lastAuthoredAt).getTime();
|
|
279
|
+
if (Number.isNaN(lastAuthored)) return;
|
|
280
|
+
const ageDays = (now.getTime() - lastAuthored) / (24 * 60 * 60 * 1000);
|
|
281
|
+
if (ageDays <= days) return;
|
|
282
|
+
issues.push({
|
|
283
|
+
kind: RoadmapSnapshotIssueKind.STALE_AUTHORED,
|
|
284
|
+
path,
|
|
285
|
+
message: `Roadmap phase at "${path}" is ${Math.floor(ageDays)} days old (cadence ${authored.reviewCadence} ⇒ ${days}d). Re-author or remove the cadence.`,
|
|
286
|
+
severity: RoadmapSnapshotIssueSeverity.WARN,
|
|
287
|
+
});
|
|
288
|
+
};
|
|
289
|
+
|
|
290
|
+
snapshot.phases.forEach((entry, index) =>
|
|
291
|
+
checkOne(entry.authored, `phases[${index}].authored`),
|
|
292
|
+
);
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
function detectUnknownCrossRefs(
|
|
296
|
+
snapshot: RoadmapSnapshot,
|
|
297
|
+
options: ValidateRoadmapSnapshotOptions | undefined,
|
|
298
|
+
issues: RoadmapSnapshotIssue[],
|
|
299
|
+
): void {
|
|
300
|
+
snapshot.phases.forEach((entry, index) => {
|
|
301
|
+
if (options?.availableRequirementRefs !== undefined) {
|
|
302
|
+
entry.deliversRequirementRefs?.forEach((reqRef, refIndex) => {
|
|
303
|
+
if (options.availableRequirementRefs!.has(reqRef)) return;
|
|
304
|
+
issues.push({
|
|
305
|
+
kind: RoadmapSnapshotIssueKind.UNKNOWN_REQUIREMENT_REF,
|
|
306
|
+
path: `phases[${index}].deliversRequirementRefs[${refIndex}]`,
|
|
307
|
+
message: `Requirement ref "${reqRef}" on phase "${entry.ref}" does not resolve in the supplied requirement-ref set.`,
|
|
308
|
+
severity: RoadmapSnapshotIssueSeverity.ERROR,
|
|
309
|
+
});
|
|
310
|
+
});
|
|
311
|
+
}
|
|
312
|
+
if (options?.availableSuccessCriterionRefs !== undefined) {
|
|
313
|
+
entry.deliversSuccessCriterionRefs?.forEach((scRef, refIndex) => {
|
|
314
|
+
if (options.availableSuccessCriterionRefs!.has(scRef)) return;
|
|
315
|
+
issues.push({
|
|
316
|
+
kind: RoadmapSnapshotIssueKind.UNKNOWN_SUCCESS_CRITERION_REF,
|
|
317
|
+
path: `phases[${index}].deliversSuccessCriterionRefs[${refIndex}]`,
|
|
318
|
+
message: `Success-criterion ref "${scRef}" on phase "${entry.ref}" does not resolve in the supplied success-criterion-ref set.`,
|
|
319
|
+
severity: RoadmapSnapshotIssueSeverity.ERROR,
|
|
320
|
+
});
|
|
321
|
+
});
|
|
322
|
+
}
|
|
323
|
+
});
|
|
324
|
+
}
|
|
325
|
+
```
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# saas.backend.app-config.backend-authored
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* The contract `backend-api/src/saas-config.backend.ts` default-exports.
|
|
14
|
+
*
|
|
15
|
+
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
16
|
+
*
|
|
17
|
+
* A DEEP-PARTIAL of the backend-authored managed sections — but several
|
|
18
|
+
* branches are REQUIRED WITH NO ENGINE DEFAULT, so omitting them does not
|
|
19
|
+
* fall back, it breaks the application: the full per-user-type auth posture
|
|
20
|
+
* and `auth.passkeyConfig` and `email.from` are refused at STARTUP (the
|
|
21
|
+
* loader only carries placeholders, and placeholder values fail validation),
|
|
22
|
+
* while a missing `frontendServices.<service>.usersManagement.<userType>`
|
|
23
|
+
* entry only surfaces at FIRST LOGIN — `/auth/identify` answers
|
|
24
|
+
* `authentication_method_not_supported` and nobody can ever sign in.
|
|
25
|
+
*
|
|
26
|
+
* Never redeclare runtime topology, database addresses, or the `jwt` branch
|
|
27
|
+
* here — those are platform-managed and the mutation-boundary rules reject
|
|
28
|
+
* them.
|
|
29
|
+
*/
|
|
30
|
+
export type AppConfiguration_BackendAuthored =
|
|
31
|
+
DeepPartial<BackendAuthoredManagedSections>;
|
|
32
|
+
```
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# saas.backend.application-initialization.assembly
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Input shape for assembling `ApplicationInitializationConfig` from the merged shared registry plus backend operations/controllers/flows.
|
|
14
|
+
*/
|
|
15
|
+
export interface ApplicationInitializationAssemblyInput {
|
|
16
|
+
sharedRegistry: Pick<
|
|
17
|
+
SharedSaaSModulesRegistry,
|
|
18
|
+
| 'resourceConfigurations'
|
|
19
|
+
| 'resourceFieldIdentifiers'
|
|
20
|
+
| 'resourceRelationships'
|
|
21
|
+
| 'customRoles'
|
|
22
|
+
| 'customFeatureDefinitions'
|
|
23
|
+
| 'customFeatureConfiguration'
|
|
24
|
+
| 'customMilestoneDefinitions'
|
|
25
|
+
| 'productDefinitions'
|
|
26
|
+
| 'notificationBadgeDefinitions'
|
|
27
|
+
>;
|
|
28
|
+
backendRegistry: Pick<BackendDomainModule, 'operations' | 'controllers' | 'flowsActors' | 'pdfTemplateBindings' | 'chartDefinitions' | 'seeds' | 'dataSeedScopeResolvers'>;
|
|
29
|
+
defaultFlowsActorsRegistry?: ApplicationInitializationConfig['flowsActorsRegistry'];
|
|
30
|
+
defaultCustomLabels?: ApplicationInitializationConfig['customLabels'];
|
|
31
|
+
defaultBackendProviderRegistry?: ApplicationInitializationConfig['backendProviderRegistry'];
|
|
32
|
+
defaultProductDefinitions?: ApplicationInitializationConfig['productDefinitions'];
|
|
33
|
+
defaultEmailTemplateDefinitions?: ApplicationInitializationConfig['emailTemplateDefinitions'];
|
|
34
|
+
defaultBackendConfig?: ApplicationInitializationConfig['backendConfig'];
|
|
35
|
+
defaultProviderRuntime?: ApplicationInitializationConfig['providerRuntime'];
|
|
36
|
+
overrides?: ApplicationInitializationOverrides;
|
|
37
|
+
}
|
|
38
|
+
```
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# saas.backend.billing.resolution-failure-reasons
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Why billing-provider resolution failed at startup. Each reason maps 1:1 to a
|
|
14
|
+
* DISTINCT config surface an app author must fix, so `billing.enabled: true`
|
|
15
|
+
* that cannot resolve a provider fails LOUD with an actionable message instead
|
|
16
|
+
* of the historical catch-all ("set providerRef + its secret") that misdirected
|
|
17
|
+
* authors to the secret when the real gap was backend-scope authoring.
|
|
18
|
+
*
|
|
19
|
+
* Read this as a debugging map — the fatal startup message names the surface,
|
|
20
|
+
* and each reason below is the surface:
|
|
21
|
+
* - PROVIDER_REF_UNSET → `billing.providerRef` in `./backend-api/src/saas-config.backend.ts`
|
|
22
|
+
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts` + a matching backend contribution in `./backend-api/src/provider-contributions.ts` (the classic trap: authored only in a frontend scope), then `wildo config sync`
|
|
23
|
+
* - PROVIDER_DISABLED → the ref resolves but is disabled for the BILLING protocol in external-provider config
|
|
24
|
+
* - SECRET_MISSING → the env var named by the provider's `secretRef` is absent from the per-env `providerEnv` secrets
|
|
25
|
+
* - RESOLUTION_ERROR → the provider threw while resolving (registry / billing-SDK fault)
|
|
26
|
+
*/
|
|
27
|
+
enum BillingProviderResolutionFailureReason {
|
|
28
|
+
/** `billing.enabled` is true but `billing.providerRef` is unset. */
|
|
29
|
+
PROVIDER_REF_UNSET = 'provider-ref-unset',
|
|
30
|
+
/**
|
|
31
|
+
* `providerRef` is set, but no billing runtime contract is exposed to the
|
|
32
|
+
* backend registry for it — the provider is not authored in
|
|
33
|
+
* `providers.scopes.backend` (a common trap: it is authored only in a
|
|
34
|
+
* frontend scope) and/or has no matching backend runtime-owner
|
|
35
|
+
* contribution. The provider is filtered out of the active catalog.
|
|
36
|
+
*/
|
|
37
|
+
PROVIDER_NOT_REACHABLE_ON_BACKEND = 'provider-not-reachable-on-backend',
|
|
38
|
+
/** The provider resolves but is disabled by external-provider configuration. */
|
|
39
|
+
PROVIDER_DISABLED = 'provider-disabled',
|
|
40
|
+
/** The provider resolves but its secret (env var `secretRef`) is absent. */
|
|
41
|
+
SECRET_MISSING = 'secret-missing',
|
|
42
|
+
/** An unexpected error was thrown while resolving (registry/SDK fault). */
|
|
43
|
+
RESOLUTION_ERROR = 'resolution-error',
|
|
44
|
+
}
|
|
45
|
+
```
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# saas.backend.custom-operation.authoritative-fields
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Fields whose value this implementation's `prefixCoreOperations` hook OWNS.
|
|
14
|
+
*
|
|
15
|
+
* ## Why this exists
|
|
16
|
+
*
|
|
17
|
+
* A prefix that authors a server-owned field (one marked `.excludeFromCreate()` /
|
|
18
|
+
* `.excludeFromUpdate()`) relies on `preserveServerInjectedFields` to carry that value past the
|
|
19
|
+
* repository's strict `requestDto` re-parse. That allow-list is normally derived by diffing the
|
|
20
|
+
* prefix output against a snapshot of the payload keys taken BEFORE the prefix ran, so only keys
|
|
21
|
+
* the hook *introduced* are preserved — which is what stops a client smuggling a value into a
|
|
22
|
+
* field it may not write.
|
|
23
|
+
*
|
|
24
|
+
* That inference has a hole: the snapshot is taken at the SERVICE tier, after a LOOSE parse
|
|
25
|
+
* (`z.looseObject`) that passes unknown keys through. A caller that reaches the service tier with
|
|
26
|
+
* the field already present — MCP `callTool` forwards its arguments with no strict parse — puts
|
|
27
|
+
* the key into the snapshot. The prefix's own value is then not classified as introduced, the
|
|
28
|
+
* repository strips it, and the operation answers success having written nothing.
|
|
29
|
+
*
|
|
30
|
+
* Declaring the field here makes the authorship EXPLICIT instead of inferred: the value is always
|
|
31
|
+
* preserved, and it is always the POST-prefix value, so a caller-supplied value is overwritten
|
|
32
|
+
* rather than honored. Reachability of the field by a client is unchanged — that remains governed
|
|
33
|
+
* by the operation's `requestDto` and the schema decorators.
|
|
34
|
+
*
|
|
35
|
+
* ## Why not "preserve any field whose value the prefix changed"
|
|
36
|
+
*
|
|
37
|
+
* Rejected as unsafe. `preserveServerInjectedFields` copies the post-prefix value, and a
|
|
38
|
+
* pass-through prefix (`return input` — the idiom used by guard hooks that only validate) which
|
|
39
|
+
* rebuilt an object-valued field would produce a reference change with identical content. That
|
|
40
|
+
* would allow-list a field the caller supplied and the hook never intended to endorse. Primitives
|
|
41
|
+
* compare safely by value, object graphs do not, and making the guarantee depend on how each hook
|
|
42
|
+
* happens to construct its return value is exactly the implicit rule this contract removes.
|
|
43
|
+
*
|
|
44
|
+
* @example
|
|
45
|
+
* createResourceCustomServiceImplementation({
|
|
46
|
+
* operationPath: { resourceIdentifier: CoreResourceType.ORGANIZATIONS, operationIdentifier: 'suspend', ... },
|
|
47
|
+
* // `status` is `.excludeFromUpdate()`; this operation is the authority that sets it.
|
|
48
|
+
* authoritativeFields: ['status'],
|
|
49
|
+
* handlers: { prefixCoreOperations: async () => ({ status: OrganizationStatus.SUSPENDED }) },
|
|
50
|
+
* });
|
|
51
|
+
*/
|
|
52
|
+
export type ResourceCustomServiceImplementationAuthoritativeFields = readonly string[];
|
|
53
|
+
```
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# saas.backend.custom-operation.transactional-core
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Explicit outcome of a conflict resolver invoked after the owned transaction
|
|
14
|
+
* has aborted.
|
|
15
|
+
*
|
|
16
|
+
* `RECONCILED` returns an already-committed semantic winner.
|
|
17
|
+
* `RETRY_TRANSACTION` requests the framework's single bounded retry of the
|
|
18
|
+
* complete transaction boundary.
|
|
19
|
+
* `UNHANDLED` preserves the original conflict without spending that retry.
|
|
20
|
+
*/
|
|
21
|
+
export enum ResourceCustomServiceImplementationTransactionalCoreConflictAction {
|
|
22
|
+
RECONCILED = 'reconciled',
|
|
23
|
+
RETRY_TRANSACTION = 'retry_transaction',
|
|
24
|
+
UNHANDLED = 'unhandled',
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConflictResolution =
|
|
28
|
+
| {
|
|
29
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.RECONCILED;
|
|
30
|
+
/** Already-committed operation result that is equivalent to this request. */
|
|
31
|
+
value: unknown;
|
|
32
|
+
}
|
|
33
|
+
| {
|
|
34
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.RETRY_TRANSACTION;
|
|
35
|
+
}
|
|
36
|
+
| {
|
|
37
|
+
action: ResourceCustomServiceImplementationTransactionalCoreConflictAction.UNHANDLED;
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConflictResolver = (
|
|
41
|
+
error: unknown,
|
|
42
|
+
input: unknown,
|
|
43
|
+
executionContext: ExecutionContext<any>,
|
|
44
|
+
utils: ResourceOperation_CustomImplementation_Utils,
|
|
45
|
+
) => Promise<ResourceCustomServiceImplementationTransactionalCoreConflictResolution>;
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Transaction ownership options for one custom-implementation registration.
|
|
49
|
+
*
|
|
50
|
+
* Import this surface from `@wildo-ai/saas-backend-lib` through
|
|
51
|
+
* `createResourceCustomServiceImplementation`. When `transactionalCore` is
|
|
52
|
+
* enabled, PREFIX, core persistence, REPLACE, and POSTFIX execute atomically.
|
|
53
|
+
* The framework includes the operation resource automatically; authors must
|
|
54
|
+
* name every additional resource touched by those phases and forward
|
|
55
|
+
* `utils.serviceOptions` to every nested resource call. Startup validates the
|
|
56
|
+
* declared participant set; it cannot discover an omitted call or make a call
|
|
57
|
+
* that drops `serviceOptions` join the transaction. Use an explicit empty
|
|
58
|
+
* object only for a genuinely single-resource transaction.
|
|
59
|
+
*
|
|
60
|
+
* @example
|
|
61
|
+
* createResourceCustomServiceImplementation({
|
|
62
|
+
* operationPath,
|
|
63
|
+
* transactionalCore: true,
|
|
64
|
+
* transactionParticipants: {
|
|
65
|
+
* owner: CoreResourceType.USERS,
|
|
66
|
+
* organization: CoreResourceType.ORGANIZATIONS,
|
|
67
|
+
* },
|
|
68
|
+
* handlers: { prefixCoreOperations },
|
|
69
|
+
* });
|
|
70
|
+
*
|
|
71
|
+
* The discriminated shape prevents authored TypeScript registrations from
|
|
72
|
+
* attaching a conflict resolver to a pipeline that does not own the core
|
|
73
|
+
* transaction. The registry repeats this check at runtime because factories
|
|
74
|
+
* may arrive through JavaScript, stale compiled output, or type erasure.
|
|
75
|
+
*/
|
|
76
|
+
export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
77
|
+
| {
|
|
78
|
+
/**
|
|
79
|
+
* Runs PREFIX → core repository mutation → REPLACE → POSTFIX in one
|
|
80
|
+
* declared resource persistence transaction. The operation resource is
|
|
81
|
+
* included automatically; every additional resource accessed by these
|
|
82
|
+
* phases must be named in `transactionParticipants`, and every nested
|
|
83
|
+
* resource call must receive `utils.serviceOptions`.
|
|
84
|
+
*
|
|
85
|
+
* This is an explicit authoring contract, not dynamic access discovery:
|
|
86
|
+
* startup proves adapter compatibility for the declared set, but cannot
|
|
87
|
+
* detect an omitted participant or a call that discards the transaction.
|
|
88
|
+
*
|
|
89
|
+
* `OVERRIDE_ALL` is incompatible because it replaces and exits the
|
|
90
|
+
* pipeline before this boundary.
|
|
91
|
+
*/
|
|
92
|
+
transactionalCore: true;
|
|
93
|
+
/**
|
|
94
|
+
* Additional resource participants touched inside the atomic core phase,
|
|
95
|
+
* keyed by their semantic role at this boundary.
|
|
96
|
+
*
|
|
97
|
+
* An explicit empty object is required for a true single-resource
|
|
98
|
+
* transaction. This makes the absence of extra participants an authored
|
|
99
|
+
* decision instead of an accidental omission hidden behind a boolean.
|
|
100
|
+
* Calls to these resources must forward `utils.serviceOptions`; naming a
|
|
101
|
+
* participant alone does not implicitly propagate the transaction.
|
|
102
|
+
*/
|
|
103
|
+
transactionParticipants: Readonly<Record<string, string>>;
|
|
104
|
+
/**
|
|
105
|
+
* Optional idempotency resolver invoked outside an aborted transaction
|
|
106
|
+
* after a transactional-core conflict. The resolver must explicitly
|
|
107
|
+
* reconcile a committed winner, request the one bounded full-transaction
|
|
108
|
+
* retry, or leave the original conflict unhandled.
|
|
109
|
+
*/
|
|
110
|
+
transactionalCoreConflictResolver?: ResourceCustomServiceImplementationTransactionalCoreConflictResolver;
|
|
111
|
+
}
|
|
112
|
+
| {
|
|
113
|
+
/** Default non-transactional custom-implementation behavior. */
|
|
114
|
+
transactionalCore?: false;
|
|
115
|
+
/** Participant declarations only have meaning for an owned transaction. */
|
|
116
|
+
transactionParticipants?: never;
|
|
117
|
+
/** A conflict resolver has no valid invocation boundary without the transaction. */
|
|
118
|
+
transactionalCoreConflictResolver?: never;
|
|
119
|
+
};
|
|
120
|
+
```
|