@wildo-ai/framework-knowledge 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pdf-template-authoring
|
|
3
|
+
description: Add or edit generated PDF template files end-to-end — `z_file({ generation: { source: FileGenerationSource.PDF_TEMPLATE, templateId } })`, backend-only React-PDF `PdfTemplateDefinition`, `definePdfTemplateBindings(...)` startup wiring, and resource `pdfTemplates` specification metadata. Use when the user says "add a generated PDF", "create a PDF template for a resource", "wire a PDF regenerate operation", "generatedSummaryPdf", "react-pdf template", or "document PDF generation in specs".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# PDF Template Authoring
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Generated PDFs are resource file fields rendered by backend operations.
|
|
23
|
+
They are **not user-uploaded files** and they are **not a resource type**.
|
|
24
|
+
The authoring chain has four layers that must ship together:
|
|
25
|
+
|
|
26
|
+
1. **Shared schema marker** — a `z_file()` field with
|
|
27
|
+
`generation.source: FileGenerationSource.PDF_TEMPLATE` and a stable
|
|
28
|
+
`templateId`. This makes the field read-visible, write-stripped,
|
|
29
|
+
non-uploadable, and eligible for generated REGENERATE operation
|
|
30
|
+
derivation.
|
|
31
|
+
2. **Backend template** — a backend-only `PdfTemplateDefinition`
|
|
32
|
+
imported directly by startup code. `buildContext()` owns I/O; `body()`
|
|
33
|
+
returns React-PDF JSX and stays pure.
|
|
34
|
+
3. **Backend binding** — `definePdfTemplateBindings(...)` maps
|
|
35
|
+
`resourceType -> fieldName -> template`. Duplicate field keys across
|
|
36
|
+
merged modules are errors, not overrides.
|
|
37
|
+
4. **Resource specification** — the resource spec documents the same
|
|
38
|
+
boundary in `pdfTemplates`: PDF output, no upload route, synchronous
|
|
39
|
+
CREATE rendering, no UPDATE auto-render, and explicit REGENERATE
|
|
40
|
+
operation identity.
|
|
41
|
+
|
|
42
|
+
## App Paths
|
|
43
|
+
|
|
44
|
+
| Surface | Glob (relative to app root) |
|
|
45
|
+
|---------|------------------------------|
|
|
46
|
+
| Shared resource schema | `shared-lib/src/modules/*/resources/**/*.schemas.ts` |
|
|
47
|
+
| Resource config | `shared-lib/src/modules/*/resources/**/*.resources-config.ts` |
|
|
48
|
+
| Backend template | `backend-api/src/modules/**/pdf/**/*.template.tsx` or module-local equivalent |
|
|
49
|
+
| Backend PDF bindings | `backend-api/src/modules/**/module-pdf-template-bindings.ts` or backend module registry file |
|
|
50
|
+
| Resource spec | `specifications/src/modules/*/resources/*.resource.specification.ts` |
|
|
51
|
+
|
|
52
|
+
## When to Use
|
|
53
|
+
|
|
54
|
+
- Adding a generated PDF field to a resource
|
|
55
|
+
- Creating or editing a React-PDF template bound to a resource field
|
|
56
|
+
- Wiring generated PDF bindings during backend startup
|
|
57
|
+
- Updating specs after adding generated PDF behavior
|
|
58
|
+
- Debugging missing or mismatched `templateId` / REGENERATE metadata
|
|
59
|
+
|
|
60
|
+
## When NOT to Use
|
|
61
|
+
|
|
62
|
+
- User-uploaded files with upload routes → use `resource-add-field`
|
|
63
|
+
and the generic `z_file()` file-field guidance.
|
|
64
|
+
- Transactional emails → use `email-add-template`.
|
|
65
|
+
- Pure spec catch-up after the PDF implementation is already correct →
|
|
66
|
+
use `spec-resource-update`, but keep this skill open for the
|
|
67
|
+
`pdfTemplates` semantics.
|
|
68
|
+
|
|
69
|
+
## Workflow
|
|
70
|
+
|
|
71
|
+
### Step 1: Mark the resource field
|
|
72
|
+
|
|
73
|
+
Add a single-file `z_file()` field with generation metadata:
|
|
74
|
+
|
|
75
|
+
- `source: FileGenerationSource.PDF_TEMPLATE`
|
|
76
|
+
- `templateId: '<stable.module.template.v1>'`
|
|
77
|
+
- PDF MIME only; do not set `multiple: true`
|
|
78
|
+
- Do not add `rag`, `scanPolicy`, upload-only overrides, or
|
|
79
|
+
user-upload semantics
|
|
80
|
+
|
|
81
|
+
Generated PDF fields must not live inside arrays or dynamic containers.
|
|
82
|
+
They are materialized by resource operations, not by frontend upload
|
|
83
|
+
forms.
|
|
84
|
+
|
|
85
|
+
Read `references/framework-pdf-template-api.md` for the source-backed
|
|
86
|
+
`z_file` generation contract.
|
|
87
|
+
|
|
88
|
+
### Step 2: Author the backend template
|
|
89
|
+
|
|
90
|
+
Create a backend-only React-PDF template typed as
|
|
91
|
+
`PdfTemplateDefinition<TRecord, TContext>`.
|
|
92
|
+
|
|
93
|
+
Rules:
|
|
94
|
+
|
|
95
|
+
- `id` must exactly match `z_file({ generation.templateId })`.
|
|
96
|
+
- `buildContext(input)` is the only hook that performs I/O. Use
|
|
97
|
+
`input.readResource(...)`; do not import repositories or reach into DI.
|
|
98
|
+
- `body({ context, locale, labels })` returns the React-PDF document.
|
|
99
|
+
Keep it pure: no network calls, no repository reads, no template lookup
|
|
100
|
+
by string.
|
|
101
|
+
- Treat CREATE context as operation-visible parent data only. Nested
|
|
102
|
+
children may not exist yet. REGENERATE can use the persisted record and
|
|
103
|
+
supported populated relationships.
|
|
104
|
+
- Import React-PDF primitives from `@react-pdf/renderer` only in
|
|
105
|
+
backend-only template files.
|
|
106
|
+
|
|
107
|
+
### Step 3: Bind at backend startup
|
|
108
|
+
|
|
109
|
+
Add the module binding with `definePdfTemplateBindings(...)` and merge it
|
|
110
|
+
through the backend domain-module assembly.
|
|
111
|
+
|
|
112
|
+
The binding is keyed by resource type and field name. The shared schema
|
|
113
|
+
stores only a stable `templateId`; the binding stores the live imported
|
|
114
|
+
template object. Do not introduce a `CoreResourceType.PDF_TEMPLATES`
|
|
115
|
+
resource or any runtime string lookup registry.
|
|
116
|
+
|
|
117
|
+
Read `references/framework-pdf-template-api.md` for the binding contract.
|
|
118
|
+
|
|
119
|
+
### Step 4: Update the resource spec
|
|
120
|
+
|
|
121
|
+
In the resource specification, add a `pdfTemplates` entry for the field.
|
|
122
|
+
It should document the literal V1 semantics:
|
|
123
|
+
|
|
124
|
+
- `output.mimeType: 'application/pdf'`
|
|
125
|
+
- `multiple: false`
|
|
126
|
+
- `readVisible: true`
|
|
127
|
+
- `writeStripped: true`
|
|
128
|
+
- `uploadRoute: ResourcePdfTemplateOutputUploadRoute.NONE`
|
|
129
|
+
- `operations.create: RENDERS_SYNCHRONOUSLY`
|
|
130
|
+
- `operations.update: DOES_NOT_AUTO_RENDER`
|
|
131
|
+
- `operations.regenerateOperationIdentifier` matches the generated
|
|
132
|
+
operation id
|
|
133
|
+
- `contextAvailability.create: PARENT_PAYLOAD_AND_PARENTS_ONLY`
|
|
134
|
+
- `contextAvailability.regenerate:
|
|
135
|
+
PERSISTED_RECORD_AND_SUPPORTED_RELATIONSHIPS`
|
|
136
|
+
|
|
137
|
+
Read `references/framework-pdf-template-spec-api.md` for the source-backed
|
|
138
|
+
spec shape.
|
|
139
|
+
|
|
140
|
+
## References
|
|
141
|
+
|
|
142
|
+
- `references/framework-pdf-template-api.md` — `z_file` generation metadata, `PdfTemplateDefinition`, and backend bindings
|
|
143
|
+
- `references/framework-pdf-template-spec-api.md` — resource `pdfTemplates` specification shape
|
|
144
|
+
|
|
145
|
+
## Verification
|
|
146
|
+
|
|
147
|
+
- [ ] The generated file field is stripped from CREATE/UPDATE request DTOs.
|
|
148
|
+
- [ ] CREATE renders synchronously; UPDATE does not auto-render.
|
|
149
|
+
- [ ] A generated REGENERATE operation exists for the top-level field.
|
|
150
|
+
- [ ] `template.id` matches `generation.templateId`.
|
|
151
|
+
- [ ] Backend bindings use direct imports and duplicate field keys throw.
|
|
152
|
+
- [ ] Resource spec `pdfTemplates` matches the schema field and generated operation id.
|
|
153
|
+
- [ ] Frontend/spec generation can load the shared schema without importing `@react-pdf/renderer` or backend template files.
|
|
154
|
+
|
|
155
|
+
### Grep invariants
|
|
156
|
+
|
|
157
|
+
| Check | Command (must pass as described) |
|
|
158
|
+
|-------|------------------------------------|
|
|
159
|
+
| Schema marks the field as a generated PDF | `rg -n "FileGenerationSource\.PDF_TEMPLATE" shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts` returns at least one line |
|
|
160
|
+
| `template.id` and `generation.templateId` agree | `rg -n "templateId:\s*['\"]<id>['\"]" shared-lib backend-api` returns matching ids in both layers |
|
|
161
|
+
| Backend bindings register the resource → field → template mapping | `rg -n "definePdfTemplateBindings" backend-api/src/modules/<module>/` returns at least one line |
|
|
162
|
+
| No `@react-pdf/renderer` imports leak into shared / frontend / spec code | `rg -n "from\s+['\"]@react-pdf/renderer['\"]" shared-lib specifications frontend/src` returns empty |
|
|
163
|
+
| No persisted PDF-template resource type | `rg -n "PDF_TEMPLATES" shared-lib specifications` returns empty |
|
|
164
|
+
|
|
165
|
+
## Red Flags
|
|
166
|
+
|
|
167
|
+
- A `CoreResourceType.PDF_TEMPLATES` enum or persisted template resource.
|
|
168
|
+
- Runtime lookup by template id instead of direct imported bindings.
|
|
169
|
+
- `buildContext()` importing repositories/DI directly.
|
|
170
|
+
- `body()` performing I/O or resolving labels/templates dynamically.
|
|
171
|
+
- Generated PDF fields inside arrays, records, maps, sets, tuples, or
|
|
172
|
+
dynamic containers.
|
|
173
|
+
- A frontend bundle importing `@react-pdf/renderer` or backend PDF
|
|
174
|
+
template files.
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
# PDF template authoring contracts (source)
|
|
2
|
+
|
|
3
|
+
- **`FileGenerationSource` / `FileGenerationConfig`** — frontend-safe schema metadata for generated PDF file fields.
|
|
4
|
+
- **`PdfTemplateDefinition`** — backend-only React-PDF template contract with `buildContext()` and `body()`.
|
|
5
|
+
- **`PdfTemplateBindingsMap` / `definePdfTemplateBindings`** — direct-import binding shape used during backend startup.
|
|
6
|
+
|
|
7
|
+
## Import Origins
|
|
8
|
+
|
|
9
|
+
- `@wildo-ai/zod-decorators`
|
|
10
|
+
|
|
11
|
+
## Source Excerpts
|
|
12
|
+
|
|
13
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
14
|
+
|
|
15
|
+
```typescript
|
|
16
|
+
*
|
|
17
|
+
* Generation sources supported by `z_file()`.
|
|
18
|
+
*
|
|
19
|
+
* Keep this enum in `zod-decorators` instead of `saas-models` so shared schemas
|
|
20
|
+
* can mark generated files without creating a dependency cycle back into the
|
|
21
|
+
* resource/model packages that already consume decorators.
|
|
22
|
+
*/
|
|
23
|
+
export enum FileGenerationSource {
|
|
24
|
+
PDF_TEMPLATE = 'pdfTemplate',
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Frontend-safe file generation metadata.
|
|
29
|
+
*
|
|
30
|
+
* This is deliberately a stable identifier only. The backend binds that
|
|
31
|
+
* identifier to an imported `PdfTemplateDefinition` during application startup,
|
|
32
|
+
* which keeps live functions and React components out of shared schema metadata.
|
|
33
|
+
*/
|
|
34
|
+
export interface FileGenerationConfig {
|
|
35
|
+
/** The generation system responsible for materializing the file value. */
|
|
36
|
+
source: FileGenerationSource.PDF_TEMPLATE;
|
|
37
|
+
/** Stable id of the backend-bound PDF template definition. */
|
|
38
|
+
templateId: string;
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Import Origins
|
|
43
|
+
|
|
44
|
+
- `@wildo-ai/saas-backend-lib`
|
|
45
|
+
|
|
46
|
+
## Source Excerpts
|
|
47
|
+
|
|
48
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
49
|
+
|
|
50
|
+
```typescript
|
|
51
|
+
*
|
|
52
|
+
* Narrow read facade available to PDF templates while building render context.
|
|
53
|
+
*
|
|
54
|
+
* Templates often need a few extra records, but they should not import
|
|
55
|
+
* repositories or reach into DI directly. The orchestrator supplies this facade
|
|
56
|
+
* so reads remain scoped, mockable, and tied to the current execution context.
|
|
57
|
+
*/
|
|
58
|
+
export type PdfTemplateReadResource = <TRecord = unknown>(
|
|
59
|
+
resourceType: ResourceType,
|
|
60
|
+
idOrFilter: IdOrIdsOrFilterType,
|
|
61
|
+
options?: RepositoryOptions,
|
|
62
|
+
) => Promise<TRecord | null>;
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Operation-available object context supplied to a PDF template.
|
|
66
|
+
*
|
|
67
|
+
* CREATE renders run before nested children are persisted, so this context must
|
|
68
|
+
* be understood as "what the operation already knows", not a promise that every
|
|
69
|
+
* eventual relationship row exists in storage. REGENERATE paths can provide the
|
|
70
|
+
* persisted/populated context available from `ResourcePopulationBackendService`.
|
|
71
|
+
*/
|
|
72
|
+
export type PdfTemplateObjectContext = Record<string, unknown>;
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* User-facing render context resolved by the orchestrator.
|
|
76
|
+
*
|
|
77
|
+
* Keep this deliberately broad for v1: authentication systems can represent
|
|
78
|
+
* users, API keys, anonymous sessions, and machine actors differently. Templates
|
|
79
|
+
* that require stricter shape should narrow this value in `buildContext()`.
|
|
80
|
+
*/
|
|
81
|
+
export interface PdfTemplateUserContext {
|
|
82
|
+
initiator?: unknown;
|
|
83
|
+
addressee?: unknown;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Base input passed to `PdfTemplateDefinition.buildContext()`.
|
|
88
|
+
*
|
|
89
|
+
* The orchestrator owns assembling this object once per render. Template authors
|
|
90
|
+
* receive the current record, operation-visible context, locale, scoped
|
|
91
|
+
* execution context, and the read facade, which is enough for data fetching
|
|
92
|
+
* without exposing framework internals.
|
|
93
|
+
*/
|
|
94
|
+
export interface PdfBuildContextInput<TRecord = unknown> {
|
|
95
|
+
/** Parent record currently being created or regenerated. */
|
|
96
|
+
currentObject: TRecord;
|
|
97
|
+
/** Operation-visible related data; CREATE excludes not-yet-persisted nested children. */
|
|
98
|
+
objectContext: PdfTemplateObjectContext;
|
|
99
|
+
/** Initiator/addressee information resolved for this render. */
|
|
100
|
+
userContext: PdfTemplateUserContext;
|
|
101
|
+
/** Execution context that owns auth, scope, operation identity, and audit context. */
|
|
102
|
+
executionContext: ExecutionContext<any>;
|
|
103
|
+
/** Scoped read facade; use this instead of importing repositories or DI. */
|
|
104
|
+
readResource: PdfTemplateReadResource;
|
|
105
|
+
/** Locale selected by request/user/default fallback before label fallback runs. */
|
|
106
|
+
locale: string;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Backend-only PDF template definition.
|
|
111
|
+
*
|
|
112
|
+
* A template is imported directly by application backend startup and bound to a
|
|
113
|
+
* resource file field through `PdfTemplateBindingsMap`. Shared schemas carry
|
|
114
|
+
* only `templateId`; the live React builder and I/O-bearing `buildContext`
|
|
115
|
+
* function stay in backend-only modules.
|
|
116
|
+
*/
|
|
117
|
+
export interface PdfTemplateDefinition<TRecord = unknown, TContext = unknown> {
|
|
118
|
+
/**
|
|
119
|
+
* Stable template id mirrored by `z_file({ generation.templateId })`.
|
|
120
|
+
*
|
|
121
|
+
* Startup binding validation checks this value against the schema metadata so
|
|
122
|
+
* telemetry, specs, REGENERATE semantics, and backend direct imports all refer
|
|
123
|
+
* to the same template identity.
|
|
124
|
+
*/
|
|
125
|
+
id: string;
|
|
126
|
+
/**
|
|
127
|
+
* Optional locale-keyed label maps.
|
|
128
|
+
*
|
|
129
|
+
* The orchestrator resolves exact-locale, base-language, then default-locale
|
|
130
|
+
* fallback and passes the resulting flat label map to `body()`.
|
|
131
|
+
*/
|
|
132
|
+
labels?: Record<string, Record<string, string>>;
|
|
133
|
+
/**
|
|
134
|
+
* Build dynamic render context for this template.
|
|
135
|
+
*
|
|
136
|
+
* This is the only template hook intended to perform I/O. Keeping reads here
|
|
137
|
+
* makes data needs explicit and keeps `body()` focused on JSX construction.
|
|
138
|
+
*/
|
|
139
|
+
buildContext(input: PdfBuildContextInput<TRecord>): Promise<TContext>;
|
|
140
|
+
/**
|
|
141
|
+
* Build the React-PDF document body.
|
|
142
|
+
*
|
|
143
|
+
* Rendering receives already-built context and resolved labels. It should not
|
|
144
|
+
* perform additional I/O or resolve templates by string key.
|
|
145
|
+
*/
|
|
146
|
+
body(props: {
|
|
147
|
+
context: TContext;
|
|
148
|
+
locale: string;
|
|
149
|
+
labels: Record<string, string>;
|
|
150
|
+
}): ReactElement;
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## Import Origins
|
|
155
|
+
|
|
156
|
+
- `@wildo-ai/saas-backend-lib`
|
|
157
|
+
|
|
158
|
+
## Source Excerpts
|
|
159
|
+
|
|
160
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
161
|
+
|
|
162
|
+
```typescript
|
|
163
|
+
*
|
|
164
|
+
* Backend-only binding for one generated file field.
|
|
165
|
+
*
|
|
166
|
+
* The shared schema stores only `generation.templateId`; this binding stores
|
|
167
|
+
* the direct imported template object. Startup validation later checks
|
|
168
|
+
* `template.id === generation.templateId`, preserving compile-time imports
|
|
169
|
+
* without leaking live functions into schema metadata.
|
|
170
|
+
*/
|
|
171
|
+
export interface PdfTemplateFieldBinding<
|
|
172
|
+
TRecord = unknown,
|
|
173
|
+
TContext = unknown,
|
|
174
|
+
> {
|
|
175
|
+
/** Directly imported backend template definition for this file field. */
|
|
176
|
+
template: PdfTemplateDefinition<TRecord, TContext>;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* PDF template bindings keyed by resource type then file field name.
|
|
181
|
+
*
|
|
182
|
+
* This shape mirrors how generated files are discovered: a resource owns a file
|
|
183
|
+
* field, and the backend binds that exact field to one direct template object.
|
|
184
|
+
* There is no scanner, registry ref, or global `CoreResourceType.PDF_TEMPLATES`.
|
|
185
|
+
*/
|
|
186
|
+
export type PdfTemplateBindingsMap = Partial<Record<
|
|
187
|
+
ResourceType,
|
|
188
|
+
Record<string, PdfTemplateFieldBinding<any, any>>
|
|
189
|
+
>>;
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Authoring helper for backend startup bindings.
|
|
193
|
+
*
|
|
194
|
+
* It intentionally performs no runtime lookup. Its job is to preserve the
|
|
195
|
+
* strongly typed object shape at the callsite while later startup services own
|
|
196
|
+
* validation against resource schemas.
|
|
197
|
+
*/
|
|
198
|
+
export function definePdfTemplateBindings<
|
|
199
|
+
TBindings extends PdfTemplateBindingsMap,
|
|
200
|
+
>(bindings: TBindings): TBindings {
|
|
201
|
+
return bindings;
|
|
202
|
+
}
|
|
203
|
+
```
|
package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# PDF template resource specification contract (source)
|
|
2
|
+
|
|
3
|
+
- **`ResourcePdfTemplateSpecification`** — companion-facing semantic projection for generated PDF file fields.
|
|
4
|
+
- **PDF operation semantics** — synchronous CREATE render, no UPDATE auto-render, explicit generated REGENERATE operation.
|
|
5
|
+
- **Context availability** — CREATE sees parent payload and parent context; REGENERATE sees the persisted record and supported relationships.
|
|
6
|
+
|
|
7
|
+
## Import Origins
|
|
8
|
+
|
|
9
|
+
- `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
## Source Excerpts
|
|
12
|
+
|
|
13
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
14
|
+
|
|
15
|
+
```typescript
|
|
16
|
+
*
|
|
17
|
+
* Companion-facing semantic projection for generated PDF file fields.
|
|
18
|
+
*
|
|
19
|
+
* Runtime truth lives in the shared `z_file({ generation })` metadata and the
|
|
20
|
+
* backend-only `PdfTemplateDefinition` binding. `ResourcePdfTemplateSpecification`
|
|
21
|
+
* documents the same boundary for app developers and companion prompts:
|
|
22
|
+
* read-visible file output, no upload route, synchronous CREATE rendering,
|
|
23
|
+
* no UPDATE auto-render, and explicit REGENERATE operation identity.
|
|
24
|
+
*/
|
|
25
|
+
export enum ResourcePdfTemplateOutputUploadRoute {
|
|
26
|
+
NONE = 'none',
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export enum ResourcePdfTemplateCreateBehavior {
|
|
30
|
+
RENDERS_SYNCHRONOUSLY = 'rendersSynchronously',
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export enum ResourcePdfTemplateUpdateBehavior {
|
|
34
|
+
DOES_NOT_AUTO_RENDER = 'doesNotAutoRender',
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export enum ResourcePdfTemplateContextAvailability {
|
|
38
|
+
PARENT_PAYLOAD_AND_PARENTS_ONLY = 'parentPayloadAndParentsOnly',
|
|
39
|
+
PERSISTED_RECORD_AND_SUPPORTED_RELATIONSHIPS = 'persistedRecordAndSupportedRelationships',
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export type ResourcePdfTemplateSpecification = {
|
|
43
|
+
fieldName: string;
|
|
44
|
+
templateId: string;
|
|
45
|
+
output: {
|
|
46
|
+
mimeType: 'application/pdf';
|
|
47
|
+
multiple: false;
|
|
48
|
+
readVisible: true;
|
|
49
|
+
writeStripped: true;
|
|
50
|
+
uploadRoute: ResourcePdfTemplateOutputUploadRoute.NONE;
|
|
51
|
+
};
|
|
52
|
+
operations: {
|
|
53
|
+
create: ResourcePdfTemplateCreateBehavior.RENDERS_SYNCHRONOUSLY;
|
|
54
|
+
update: ResourcePdfTemplateUpdateBehavior.DOES_NOT_AUTO_RENDER;
|
|
55
|
+
regenerateOperationIdentifier: string;
|
|
56
|
+
};
|
|
57
|
+
contextAvailability: {
|
|
58
|
+
create: ResourcePdfTemplateContextAvailability.PARENT_PAYLOAD_AND_PARENTS_ONLY;
|
|
59
|
+
regenerate: ResourcePdfTemplateContextAvailability.PERSISTED_RECORD_AND_SUPPORTED_RELATIONSHIPS;
|
|
60
|
+
};
|
|
61
|
+
};
|
|
62
|
+
```
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: provider-frontend-file-picker
|
|
3
|
+
description: Add or tune the frontend FILE PICKER provider — the browser-bound FrontendAppProviderModule that gives every framework file form field its accepted MIME types, size limit and selection count, and that custom views resolve for their own upload chrome. Use when the user says "add a file picker", "let users attach files", "restrict uploads to PDFs/images", "raise the upload size limit", "file field accepts anything", "picker allows too many files", or "wire a file upload provider for the app".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Frontend File-Picker Provider
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for the **frontend file-picker provider** — a
|
|
23
|
+
`FrontendAppProviderModule` carrying the `FRONTEND_FILE_PICKER`
|
|
24
|
+
provider capability over the `FRONTEND_SDK` protocol. It is the ONE
|
|
25
|
+
place the application declares its browser-side upload posture:
|
|
26
|
+
|
|
27
|
+
1. **Framework file form fields** resolve their picker constraints
|
|
28
|
+
from it automatically (`resolveFormFieldFileProviderConstraints`):
|
|
29
|
+
a file field's own schema metadata always wins, the provider's
|
|
30
|
+
`publicConfig` fills the gaps.
|
|
31
|
+
2. **Custom views** (flow execution views, bespoke upload chrome)
|
|
32
|
+
resolve the same module from the frontend provider registry by
|
|
33
|
+
capability + protocol, so every upload surface shares one
|
|
34
|
+
constraint vocabulary.
|
|
35
|
+
|
|
36
|
+
The provider is a plain object plus three registration surfaces — no
|
|
37
|
+
class, no runtime call. `wildo compose add-file-picker-provider`
|
|
38
|
+
scaffolds all of it; this skill is the manual path and the tuning
|
|
39
|
+
guide.
|
|
40
|
+
|
|
41
|
+
## App Paths
|
|
42
|
+
|
|
43
|
+
| Surface | Glob (relative to app root) |
|
|
44
|
+
|-------------------------------|--------------------------------------------------------------|
|
|
45
|
+
| Provider module | `frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
|
|
46
|
+
| Providers barrel | `frontend/src/engine/providers/index.ts` |
|
|
47
|
+
| Companion contribution | `frontend/src/provider-contributions.ts` |
|
|
48
|
+
| SaaS-config provider scope | `wildo.saas.config.ts` → `providers.scopes.frontendServices.app.providers.<ref>` |
|
|
49
|
+
| Framework field consumer | (engine-owned — nothing to edit; fields resolve automatically) |
|
|
50
|
+
|
|
51
|
+
Apps scaffolded before the 2026-08 `frontend/` rename may still name this
|
|
52
|
+
package `app/` — substitute it in the first three rows if so.
|
|
53
|
+
|
|
54
|
+
## When to Use
|
|
55
|
+
|
|
56
|
+
- Adding the application's first file-picker provider.
|
|
57
|
+
- Changing accepted MIME types, the size limit (`maxFileSizeMb`), the
|
|
58
|
+
selection count (`maxSelectionCount`) or the `uploadNamespace`.
|
|
59
|
+
- A custom view needs the picker constraints or display label.
|
|
60
|
+
|
|
61
|
+
## When NOT to Use
|
|
62
|
+
|
|
63
|
+
- Per-FIELD constraints (one field stricter than the app default) —
|
|
64
|
+
author them on the field's schema (`resource-schema-authoring`);
|
|
65
|
+
schema metadata overrides the provider.
|
|
66
|
+
- Backend/storage providers or secrets — this module is browser-bound
|
|
67
|
+
and secret-free by design (`configure-billing` shows the
|
|
68
|
+
backend-reachable provider chain).
|
|
69
|
+
- Registering React components (`engine-component-registration`).
|
|
70
|
+
|
|
71
|
+
## Workflow
|
|
72
|
+
|
|
73
|
+
### Step 1: Author (or edit) the provider module
|
|
74
|
+
|
|
75
|
+
One `FrontendAppProviderModule` under
|
|
76
|
+
`frontend/src/engine/providers/`. Read
|
|
77
|
+
`references/framework-frontend-provider-module-api.md` for the
|
|
78
|
+
contract. The file-picker `publicConfig` vocabulary the framework
|
|
79
|
+
reads: `acceptedMimeTypes` (string[]), `maxFileSizeMb` (number),
|
|
80
|
+
`maxSelectionCount` (number), `uploadNamespace` (string).
|
|
81
|
+
|
|
82
|
+
### Step 2: Export it through the providers barrel
|
|
83
|
+
|
|
84
|
+
`frontend/src/engine/providers/index.ts` re-exports the module; the
|
|
85
|
+
package's `./frontend-providers` entry exposes that barrel — the
|
|
86
|
+
`runtimeImportPath` the contribution names in Step 3.
|
|
87
|
+
|
|
88
|
+
### Step 3: Append the companion contribution
|
|
89
|
+
|
|
90
|
+
In `frontend/src/provider-contributions.ts`, append one entry to
|
|
91
|
+
`frontendProviderContributions`. Derive every duplicated field
|
|
92
|
+
(capabilities, protocols, metadata, publicConfig) FROM the module
|
|
93
|
+
object — see the worked example. `sourceModuleId` names the module
|
|
94
|
+
that owns the provider semantically.
|
|
95
|
+
|
|
96
|
+
### Step 4: Declare the saas-config scope entry
|
|
97
|
+
|
|
98
|
+
`wildo.saas.config.ts` → `providers.scopes.frontendServices.app.providers.<ref>`
|
|
99
|
+
with `providerCapabilities: ['FRONTEND_FILE_PICKER']` and
|
|
100
|
+
`protocols: ['FRONTEND_SDK']`. The provider-runtime sync
|
|
101
|
+
cross-validates the contribution against this scope — a missing entry
|
|
102
|
+
fails reachability validation, it does not silently no-op.
|
|
103
|
+
|
|
104
|
+
### Step 5: Verify the consumers
|
|
105
|
+
|
|
106
|
+
Framework file fields pick the constraints up with no further wiring
|
|
107
|
+
(`references/framework-file-provider-constraints-api.md` explains the
|
|
108
|
+
precedence). A custom view resolves the module via
|
|
109
|
+
`findByProviderCapabilityAndProtocol(FRONTEND_FILE_PICKER, FRONTEND_SDK)`.
|
|
110
|
+
|
|
111
|
+
## Worked Example
|
|
112
|
+
|
|
113
|
+
The complete provider module — the generalized file-picker shape:
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
## Usage Example
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
export const ApplicationFilePickerFrontendAppProvider: FrontendAppProviderModule = {
|
|
120
|
+
metadata: {
|
|
121
|
+
ref: 'wonderTodosFilePicker',
|
|
122
|
+
displayNameLabelKey: buildProviderDisplayNameLabelKey('wonderTodosFilePicker'),
|
|
123
|
+
},
|
|
124
|
+
providerCapabilities: [BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER],
|
|
125
|
+
protocols: [BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK],
|
|
126
|
+
publicConfig: {
|
|
127
|
+
acceptedMimeTypes: ['image/*', 'application/pdf'],
|
|
128
|
+
maxFileSizeMb: 25,
|
|
129
|
+
maxSelectionCount: 10,
|
|
130
|
+
uploadNamespace: 'task-attachments',
|
|
131
|
+
},
|
|
132
|
+
};
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
What earns its place:
|
|
136
|
+
|
|
137
|
+
- `displayNameLabelKey: buildProviderDisplayNameLabelKey(ref)` —
|
|
138
|
+
translation-ready key, never a frozen localized string; the i18n
|
|
139
|
+
pipeline owns the rendered name.
|
|
140
|
+
- `BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER` +
|
|
141
|
+
`BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK` — typed vocabulary members,
|
|
142
|
+
not string literals; the constraint resolver looks the module up by
|
|
143
|
+
exactly this pair.
|
|
144
|
+
- `publicConfig` carries ONLY the four picker keys — no secrets, no
|
|
145
|
+
labels, no per-field decisions.
|
|
146
|
+
|
|
147
|
+
And its companion contribution — the registration half:
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
## Usage Example
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
function buildFilePickerContribution(): ProviderCompanionContribution {
|
|
154
|
+
return {
|
|
155
|
+
ref: ApplicationFilePickerFrontendAppProvider.metadata.ref,
|
|
156
|
+
runtimeImportPath: FRONTEND_PROVIDERS_IMPORT_PATH,
|
|
157
|
+
runtimeTargets: [{ kind: 'frontendService', serviceType: AppFrontendType.SAAS_APP }],
|
|
158
|
+
engineCapabilities: [],
|
|
159
|
+
providerCapabilities: [...ApplicationFilePickerFrontendAppProvider.providerCapabilities],
|
|
160
|
+
protocols: [...ApplicationFilePickerFrontendAppProvider.protocols],
|
|
161
|
+
secretsContractShape: [],
|
|
162
|
+
frontendEntry: {
|
|
163
|
+
metadata: ApplicationFilePickerFrontendAppProvider.metadata,
|
|
164
|
+
providerCapabilities: [...ApplicationFilePickerFrontendAppProvider.providerCapabilities],
|
|
165
|
+
protocols: [...ApplicationFilePickerFrontendAppProvider.protocols],
|
|
166
|
+
publicConfig: ApplicationFilePickerFrontendAppProvider.publicConfig,
|
|
167
|
+
},
|
|
168
|
+
sourceModuleId: 'tasks-manager',
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
export const frontendProviderContributions = [
|
|
173
|
+
...engineFrontendAppProviderContributions,
|
|
174
|
+
buildFilePickerContribution(),
|
|
175
|
+
] satisfies ReadonlyArray<ProviderCompanionContribution>;
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
- Every duplicated field reads FROM the module object
|
|
179
|
+
(`...Provider.providerCapabilities`, `publicConfig: Provider.publicConfig`)
|
|
180
|
+
so the contribution cannot drift from the module.
|
|
181
|
+
- `runtimeImportPath` is the app package's `./frontend-providers`
|
|
182
|
+
entry — the door the provider-runtime sync validates.
|
|
183
|
+
- The engine contributions spread (`...engineFrontendAppProviderContributions`)
|
|
184
|
+
stays first; app providers append after it.
|
|
185
|
+
|
|
186
|
+
## References
|
|
187
|
+
|
|
188
|
+
- `references/framework-frontend-provider-module-api.md` — the
|
|
189
|
+
`FrontendAppProviderModule` contract (source-backed)
|
|
190
|
+
- `references/framework-file-provider-constraints-api.md` — how
|
|
191
|
+
framework file fields resolve constraints from the provider
|
|
192
|
+
(source-backed)
|
|
193
|
+
|
|
194
|
+
## Verification
|
|
195
|
+
|
|
196
|
+
- [ ] Module lives under `frontend/src/engine/providers/` and exports a typed `FrontendAppProviderModule`
|
|
197
|
+
- [ ] Capability/protocol use the `BUILTIN_PROVIDER_*` vocabulary members, not string literals
|
|
198
|
+
- [ ] `publicConfig` holds only the picker keys — no secret, no localized string
|
|
199
|
+
- [ ] Barrel + `./frontend-providers` entry expose the module
|
|
200
|
+
- [ ] Contribution derives its fields from the module object and names `sourceModuleId`
|
|
201
|
+
- [ ] `wildo.saas.config.ts` scope entry exists for `<ref>` (reachability validation passes)
|
|
202
|
+
- [ ] A file form field without schema-level constraints shows the provider's limits
|
|
203
|
+
|
|
204
|
+
### Grep invariants
|
|
205
|
+
|
|
206
|
+
Run from the app root, substituting `<ref>`:
|
|
207
|
+
|
|
208
|
+
| Invariant | Command |
|
|
209
|
+
|---|---|
|
|
210
|
+
| Module declares the typed capability pair | `rg -n "FRONTEND_FILE_PICKER" frontend/src/engine/providers/` |
|
|
211
|
+
| No string-literal capability/protocol in the module | `rg -n "providerCapabilities: \['" frontend/src/engine/providers/` (must be empty) |
|
|
212
|
+
| Contribution derives from the module (no re-typed literals) | `rg -n "publicConfig: .*Provider.publicConfig" frontend/src/provider-contributions.ts` |
|
|
213
|
+
| Scope entry present | `rg -n "<ref>" wildo.saas.config.ts` |
|
|
214
|
+
| No secret-looking key in publicConfig | `rg -in "secret\|apikey\|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts` (must be empty) |
|
|
215
|
+
|
|
216
|
+
## Common Rationalizations
|
|
217
|
+
|
|
218
|
+
| Rationalization | Reality |
|
|
219
|
+
|-----------------|---------|
|
|
220
|
+
| "I'll hardcode limits in my upload component" | Framework file fields resolve the provider automatically; a hardcoded component drifts from every other upload surface the day the limits change. |
|
|
221
|
+
| "String literals for capability/protocol are fine" | The resolver looks the module up by the exact vocabulary pair; a typo silently yields schema-only constraints with no error. |
|
|
222
|
+
| "The provider should carry the field's stricter limit" | Per-field constraints belong on the field's schema — schema metadata deliberately WINS over the provider so one strict field never loosens the app default. |
|
|
223
|
+
| "Skip the saas-config scope entry, it already works in dev" | The provider-runtime sync cross-validates contribution ↔ scope; the missing entry fails reachability validation at sync time, after you have moved on. |
|
|
224
|
+
| "Put the display name in publicConfig" | Display text is i18n-owned: `metadata.displayNameLabelKey` + the label pipeline. A frozen string ships one language to every locale. |
|
|
225
|
+
|
|
226
|
+
## Red Flags
|
|
227
|
+
|
|
228
|
+
- A capability or protocol string literal in the module (catch with the **no string-literal** grep)
|
|
229
|
+
- The contribution re-types capabilities/protocols/publicConfig instead of reading them from the module (catch with the **derives from the module** grep)
|
|
230
|
+
- A secret, publishable-key-lookalike or localized string inside `publicConfig` (catch with the **no secret-looking key** grep)
|
|
231
|
+
- An upload surface with its own hardcoded MIME/size table beside the provider
|
|
232
|
+
- `maxFileSizeMb` treated as bytes somewhere — the resolver converts Mb → bytes; consumers must not convert again
|
|
233
|
+
|
|
234
|
+
## Related Skills
|
|
235
|
+
|
|
236
|
+
- `resource-schema-authoring` — per-field file constraints (they override the provider)
|
|
237
|
+
- `configure-billing` — the backend-reachable provider chain (5-surface config)
|
|
238
|
+
- `engine-component-registration` — registering the custom views that consume the picker
|
|
239
|
+
- `module-companion-exports` — the wider companion-exports surface the contribution lives in
|