@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,322 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-add-module
|
|
3
|
+
description: Scaffold a new application module slice (folders + index files + module-registration objects) across `shared-lib`, `app`, `specifications`, and (when applicable) `backend-api`, then declare it in `wildo.saas.config.ts > modules` with the explicit `services: [...]` array. Use when the user says "add a new module", "create a `<name>` module", "scaffold a bounded context", "wire a new domain area", "add a new feature slice", or "split this domain into its own module" — NOT when adding a single resource inside an existing module.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Resource Add Module — Scaffold Workflow
|
|
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
|
+
> **Framework rule.** A module is the **unit of cross-runtime
|
|
21
|
+
> ownership** in Wildo. A single module folder appears in **up to 4
|
|
22
|
+
> sibling trees** (`shared-lib/src/modules/<m>/`,
|
|
23
|
+
> `frontend/src/modules/<m>/`, `specifications/src/modules/<m>/`,
|
|
24
|
+
> `backend-api/src/modules/<m>/`) and is declared **once** in
|
|
25
|
+
> `wildo.saas.config.ts > modules` with an explicit
|
|
26
|
+
> `services: ['backendApi', 'app', …]` array that gates which
|
|
27
|
+
> runtimes load it. Each per-runtime tree exports a typed
|
|
28
|
+
> registration object (`SharedSaaSModule` /
|
|
29
|
+
> `BackendOwnedModule` / `ModuleBusinessSemantics`) that the engine
|
|
30
|
+
> wires automatically — the consumer authors the slice; the engine
|
|
31
|
+
> owns the wiring contract.
|
|
32
|
+
|
|
33
|
+
## Overview
|
|
34
|
+
|
|
35
|
+
This skill creates a **new module slice**: parallel folders, typed
|
|
36
|
+
registration objects, and the single `wildo.saas.config.ts > modules`
|
|
37
|
+
entry that gates them. It deliberately mirrors a chosen reference
|
|
38
|
+
module's topology rather than inventing a one-off layout — every
|
|
39
|
+
tool and skill that walks the module tree assumes each module
|
|
40
|
+
shares the same per-runtime shape.
|
|
41
|
+
|
|
42
|
+
A module declared in `wildo.saas.config.ts > modules` but missing
|
|
43
|
+
from a per-runtime tree it lists in `services: [...]` is a build
|
|
44
|
+
break (the runtime fails to find its `BackendDomainModule` /
|
|
45
|
+
`SharedSaaSModule` registration). Conversely, a per-runtime folder
|
|
46
|
+
that isn't declared in `modules` is dead code (the engine never
|
|
47
|
+
loads it).
|
|
48
|
+
|
|
49
|
+
## App Paths
|
|
50
|
+
|
|
51
|
+
The installed `@wildo-ai/*` packages provide the framework contracts. Module
|
|
52
|
+
scaffolding touches the consumer app at:
|
|
53
|
+
|
|
54
|
+
| Surface | Glob (relative to app root) | Required for |
|
|
55
|
+
|---|---|---|
|
|
56
|
+
| Saas-config root | `wildo.saas.config.ts` | every module (single source of truth for which runtimes load the module) |
|
|
57
|
+
| Shared-lib slice | `shared-lib/src/modules/<module>/index.ts` (`SharedSaaSModule`) | every module (resources, relationships, milestones) |
|
|
58
|
+
| Shared-lib resources sub-tree | `shared-lib/src/modules/<module>/resources/**` | every module that owns resources (the dominant case) |
|
|
59
|
+
| App slice | `frontend/src/modules/<module>/index.ts` (+ `resources/`, `app-level-views/`) | every module the `app` runtime loads |
|
|
60
|
+
| App UI behavior | `frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx` | every resource the `app` runtime renders |
|
|
61
|
+
| Specifications slice | `specifications/src/modules/<module>/index.ts` (`ModuleBusinessSemantics`) + `resources/`, `composite-views/`, `milestones/` | every module that has spec coverage (typical) |
|
|
62
|
+
| Backend slice | `backend-api/src/modules/<module>/index.ts` (`BackendOwnedModule`) + `resources/`, `addons/`, `emails/` (i18n is engine-owned — no per-module `i18n/` directory) | every module the `backendApi` runtime loads |
|
|
63
|
+
|
|
64
|
+
## When to Use
|
|
65
|
+
|
|
66
|
+
- **Adding a new bounded context** to an app (e.g. user says "add a
|
|
67
|
+
`billing` module", "create a `notifications` module",
|
|
68
|
+
"scaffold a new domain for support tickets").
|
|
69
|
+
- **Cloning the topology** of an existing module to host a new
|
|
70
|
+
feature slice that needs its own resources / specs / backend
|
|
71
|
+
surface.
|
|
72
|
+
- **Splitting an oversized module** in two — both halves go through
|
|
73
|
+
this skill; deletion of the old module is a separate concern.
|
|
74
|
+
- The user explicitly mentions any of: `wildo.saas.config.ts >
|
|
75
|
+
modules`, `SharedSaaSModule`, `BackendOwnedModule`,
|
|
76
|
+
`ModuleBusinessSemantics`, "module registration", "new domain
|
|
77
|
+
area", or "new feature slice".
|
|
78
|
+
|
|
79
|
+
## When NOT to Use
|
|
80
|
+
|
|
81
|
+
- **Adding a single resource inside an existing module** — use
|
|
82
|
+
`resource-add-resource`. A resource lives under a module's
|
|
83
|
+
`resources/` tree, never as a sibling of `modules/`.
|
|
84
|
+
- **Changing only SaaS-wide service lists** (`services` map at the
|
|
85
|
+
saas-config root) without a new module — use `config-saas`.
|
|
86
|
+
- **Module-registration mechanics** for a module that already exists
|
|
87
|
+
(rename, move between modules, fix the `services: [...]` array) —
|
|
88
|
+
use `module-registration` directly.
|
|
89
|
+
- **Companion-export wiring** for an already-scaffolded module — use
|
|
90
|
+
`module-companion-exports`.
|
|
91
|
+
- **Engine or platform work** — out of scope for app skills; the
|
|
92
|
+
engine packages (`@wildo-ai/saas-models`,
|
|
93
|
+
`@wildo-ai/saas-backend-lib`, `@wildo-ai/saas-specifications`,
|
|
94
|
+
`@wildo-ai/platform-config-lib`) own the schemas this skill
|
|
95
|
+
writes against.
|
|
96
|
+
|
|
97
|
+
## Workflow
|
|
98
|
+
|
|
99
|
+
### Step 1: Pick a reference module
|
|
100
|
+
|
|
101
|
+
Find the most structurally similar existing module in this app
|
|
102
|
+
(`<reference_module>`). The choice drives every subsequent step —
|
|
103
|
+
copy its **folder topology + registration shape**, not its
|
|
104
|
+
business content. Use the `## App Paths` table above to enumerate
|
|
105
|
+
which trees the reference module actually populates; the new
|
|
106
|
+
module copies exactly that subset.
|
|
107
|
+
|
|
108
|
+
If the app has no existing modules, start from the application module template
|
|
109
|
+
and the source-backed module references (see
|
|
110
|
+
`## Worked Example` below).
|
|
111
|
+
|
|
112
|
+
### Step 2: Decide the runtime gates
|
|
113
|
+
|
|
114
|
+
Open `wildo.saas.config.ts > modules` and decide which services
|
|
115
|
+
the new module loads in. The default is `['backendApi', 'app']`
|
|
116
|
+
for a domain module that has both server-side operations and a
|
|
117
|
+
frontend. A docs-only module might use `['app']`; a
|
|
118
|
+
worker-only module might use `['backendApi']`. The `services`
|
|
119
|
+
array is the **single switch** that opts a runtime into loading
|
|
120
|
+
the module — no other wiring gates it.
|
|
121
|
+
|
|
122
|
+
### Step 3: Create parallel folders
|
|
123
|
+
|
|
124
|
+
Mirror the reference module's tree in each runtime the new
|
|
125
|
+
`services: [...]` array names, plus `specifications/src/modules/`
|
|
126
|
+
if the app uses spec coverage. Apply the per-surface convention
|
|
127
|
+
from `## App Paths`. Do NOT create folders for runtimes the new
|
|
128
|
+
module is NOT declared for (dead code).
|
|
129
|
+
|
|
130
|
+
Run `references/module-scaffold-layout.md` for the package-level
|
|
131
|
+
checklist if you are unsure which sub-folders the reference
|
|
132
|
+
module ships.
|
|
133
|
+
|
|
134
|
+
### Step 4: Author the typed registration objects
|
|
135
|
+
|
|
136
|
+
For each per-runtime slice, author the index file that exports
|
|
137
|
+
the typed registration object (the engine reads these by name —
|
|
138
|
+
the symbol is implicit, the type is explicit):
|
|
139
|
+
|
|
140
|
+
| Tree | Type imported from | Object shape |
|
|
141
|
+
|---|---|---|
|
|
142
|
+
| `shared-lib/src/modules/<m>/index.ts` | `@wildo-ai/saas-models` | `SharedSaaSModule` (`moduleId`, `kind`, `resourceConfigurations`, `resourceFieldIdentifiers`, `resourceRelationships`, optional `customMilestoneDefinitions`) |
|
|
143
|
+
| `backend-api/src/modules/<m>/index.ts` | `@wildo-ai/saas-backend-lib` (+ app-local `BackendOwnedModule`) | `BackendOwnedModule` (`moduleId`, `kind`, `backendModule` extending the shared module with `flowsActors`, `emailTemplateDefinitions`). `customLabels` is engine-owned (single owner via `scanCustomLabelsDirectory`) — do NOT set it on domain modules. |
|
|
144
|
+
| `specifications/src/modules/<m>/index.ts` | `@wildo-ai/saas-specifications` | `ModuleBusinessSemantics` (`relatedModuleId`, `purpose`, `businessCapability`, `businessDomain`, `primaryActors`, `mainResources`, `supportingResources`, `integrationSurfaces`) |
|
|
145
|
+
| `frontend/src/modules/<m>/index.ts` | (consumer-side; mirrors the reference module) | App entry that re-exports `resources/` + `app-level-views/` |
|
|
146
|
+
|
|
147
|
+
The `moduleId` value MUST equal the folder name AND the key used
|
|
148
|
+
in `wildo.saas.config.ts > modules` — three-way string equality.
|
|
149
|
+
|
|
150
|
+
### Step 5: Declare the module in `wildo.saas.config.ts`
|
|
151
|
+
|
|
152
|
+
Add the entry to the `modules` map of `defineSaasConfig({...})`:
|
|
153
|
+
|
|
154
|
+
<!-- TIER C WAIVER: 7-non-blank-line `ts` block showing the exact saas-config `modules` map insertion shape required by `ApplicationModulesSchema`. This inline block is the consumer-facing template with `<new_module>` placeholder + the explicit `services` / `haveSamlIntegration` keys the schema requires. Keep it as Tier C until a focused, stable application example is deliberately anchored. -->
|
|
155
|
+
```ts
|
|
156
|
+
modules: {
|
|
157
|
+
'<new_module>': {
|
|
158
|
+
services: ['backendApi', 'app'],
|
|
159
|
+
haveSamlIntegration: false,
|
|
160
|
+
},
|
|
161
|
+
// existing modules unchanged
|
|
162
|
+
},
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
The string key MUST match `moduleId` in every per-runtime
|
|
166
|
+
registration object from Step 4.
|
|
167
|
+
|
|
168
|
+
### Step 6: Smoke-check imports + registration
|
|
169
|
+
|
|
170
|
+
Boot each affected runtime once. The engine loads the per-runtime
|
|
171
|
+
registration objects by walking `wildo.saas.config.ts > modules`
|
|
172
|
+
and resolving each entry via the conventional path
|
|
173
|
+
(`<runtime>/src/modules/<moduleId>/index.ts`). A missing
|
|
174
|
+
registration export (or a `moduleId` mismatch) throws at boot
|
|
175
|
+
with the failing path in the message.
|
|
176
|
+
|
|
177
|
+
Add a trivial export from the new module (e.g. an enum or
|
|
178
|
+
type-only export) and import it from the app bootstrap path used
|
|
179
|
+
by sibling modules — the loud-failure boot prevents silent
|
|
180
|
+
mis-registration.
|
|
181
|
+
|
|
182
|
+
### Step 7: Smoke-check the audit invariants
|
|
183
|
+
|
|
184
|
+
Run the grep invariants in `## Verification` below. Each one is
|
|
185
|
+
designed to catch a specific drift the engine doesn't catch at
|
|
186
|
+
boot (e.g. shared-lib slice present but missing from `services:
|
|
187
|
+
[...]`, leaving the module loaded by the bundler but never
|
|
188
|
+
exercised by any runtime).
|
|
189
|
+
|
|
190
|
+
## Worked Example
|
|
191
|
+
|
|
192
|
+
An application can ship several declared modules. A representative cross-runtime
|
|
193
|
+
domain module demonstrates the same relationship, while
|
|
194
|
+
`example-dev` demonstrates an app-only contribution with no fabricated
|
|
195
|
+
shared/backend owners.
|
|
196
|
+
|
|
197
|
+
| Step | Source-backed reference | File |
|
|
198
|
+
|---|---|---|
|
|
199
|
+
| Saas-config entry | Root SaaS composition contract | `wildo.saas.config.ts` (`modules` declares the runtime service bindings for each module) |
|
|
200
|
+
| Shared-lib registration | `example.module.registration.shared` | `shared-lib/src/modules/tasks-manager/index.ts` (full `SharedSaaSModule` value) |
|
|
201
|
+
| Backend-api registration | `example.backend.addon-wiring.module` | `backend-api/src/modules/tasks-manager/index.ts` (full `BackendOwnedModule` value, illustrates how `flowsActors` / `emailTemplateDefinitions` compose onto the shared `BackendDomainModule`; note `customLabels` is intentionally absent — engine-owned via `scanCustomLabelsDirectory`) |
|
|
202
|
+
| Specifications semantics | (none — read directly) | `specifications/src/modules/tasks-manager/index.ts` (`tasksManagerModuleBusinessSemantics` value) |
|
|
203
|
+
|
|
204
|
+
Promote any of these to a Tier A `example.module.*`
|
|
205
|
+
anchor when you need to inline the snippet inside this skill.
|
|
206
|
+
|
|
207
|
+
## References
|
|
208
|
+
|
|
209
|
+
- `references/module-scaffold-layout.md` — package-level
|
|
210
|
+
expectations and the per-surface checklist.
|
|
211
|
+
- `references/framework-new-module-wiring-api.md` —
|
|
212
|
+
`ApplicationModulesSchema` (saas-config side) +
|
|
213
|
+
`SharedSaaSModule` (shared-lib side) anchored API surface
|
|
214
|
+
delivered by the declared package contracts.
|
|
215
|
+
- `module-registration` skill —
|
|
216
|
+
`references/framework-domain-modules-api.md` for the full
|
|
217
|
+
cross-runtime module contracts (use when editing an existing
|
|
218
|
+
registration object, not when scaffolding from scratch).
|
|
219
|
+
|
|
220
|
+
## Verification
|
|
221
|
+
|
|
222
|
+
- [ ] **Three-way string equality.** Folder name = `moduleId`
|
|
223
|
+
in every registration object = key in
|
|
224
|
+
`wildo.saas.config.ts > modules`.
|
|
225
|
+
- [ ] **Runtime gating is explicit.** `services: [...]` is
|
|
226
|
+
authored deliberately (not omitted to "default to all"); it
|
|
227
|
+
lists exactly the runtimes that have a per-runtime slice.
|
|
228
|
+
- [ ] **No orphan slices.** Every per-runtime
|
|
229
|
+
`<runtime>/src/modules/<moduleId>/index.ts` corresponds to
|
|
230
|
+
a runtime listed in `services: [...]`. Conversely, every
|
|
231
|
+
runtime in `services: [...]` has a corresponding
|
|
232
|
+
`index.ts`.
|
|
233
|
+
- [ ] **Typed registration object exported by default.** Each
|
|
234
|
+
per-runtime `index.ts` has `export default <module>` (the
|
|
235
|
+
engine resolves the registration via the default export).
|
|
236
|
+
- [ ] **Reference module's topology preserved.** Every
|
|
237
|
+
sub-folder the reference module ships (e.g. `addons/`,
|
|
238
|
+
`i18n/`, `emails/`) is either present in the new module or
|
|
239
|
+
consciously omitted with reason (don't ship empty
|
|
240
|
+
sub-folders that mislead future readers).
|
|
241
|
+
- [ ] **No circular imports** at first resource addition (the
|
|
242
|
+
`<module>/resources/index.ts` re-export chain is
|
|
243
|
+
acyclic).
|
|
244
|
+
- [ ] **Specifications path exists** if the app uses spec
|
|
245
|
+
coverage — `specifications/src/modules/<m>/index.ts`
|
|
246
|
+
exports a `ModuleBusinessSemantics` value.
|
|
247
|
+
- [ ] **Boot smoke-test passes.** Each runtime in `services:
|
|
248
|
+
[...]` boots without "module not found" / "moduleId
|
|
249
|
+
mismatch" errors.
|
|
250
|
+
|
|
251
|
+
### Grep invariants
|
|
252
|
+
|
|
253
|
+
| Invariant | Command |
|
|
254
|
+
|---|---|
|
|
255
|
+
| Module declared in saas-config | `rg -n "^\\s*'<module>'\\s*:" wildo.saas.config.ts` (must return ≥1 inside the `modules` map) |
|
|
256
|
+
| Default export per runtime | `rg -n "^export default " <runtime>/src/modules/<module>/index.ts` (must return exactly 1 per runtime in `services: [...]`) |
|
|
257
|
+
| `moduleId` matches folder | `rg -n "moduleId:\\s*'<module>'" {shared-lib,backend-api,app}/src/modules/<module>/index.ts` (must return ≥1 per runtime in `services: [...]` that uses the field) |
|
|
258
|
+
| Specs `relatedModuleId` matches | `rg -n "relatedModuleId:\\s*'<module>'" specifications/src/modules/<module>/index.ts` (must return ≥1 if the spec slice exists) |
|
|
259
|
+
| No orphan per-runtime slice | `ls -d {shared-lib,backend-api,app,specifications}/src/modules/<module>/ 2>/dev/null` cross-checked against the `services: [...]` array (each listed runtime must appear; specifications is conventionally always present if the app uses specs) |
|
|
260
|
+
|
|
261
|
+
## Common Rationalizations
|
|
262
|
+
|
|
263
|
+
| Rationalization | Reality |
|
|
264
|
+
|---|---|
|
|
265
|
+
| "I'll register the module later, after I get the resource shape right." | Unregistered modules are invisible — every dependency the resource graph adds (relationships, labels, milestones, backend addons) is silently dropped by the engine until registration lands. Register first; iterate the resource shape inside a registered module. |
|
|
266
|
+
| "Shared-lib alone is enough — I can wire the app and backend later." | App-side resources (`ui-behavior.tsx`, custom views) and backend-side ops (`flowsActors`, `emailTemplateDefinitions`) live in their own per-runtime trees. Skipping them now means the resource technically exists but renders nothing in the app and serves no operations on the backend. Add the parallel folders even if their `index.ts` re-exports an empty barrel — it makes the omission deliberate. |
|
|
267
|
+
| "I'll skip the `services: [...]` array and let the framework default to all." | The schema requires it; `defineSaasConfig` rejects the saas-config at parse time. The array is the **single switch** that gates which runtimes load the module — there's no implicit default that makes architectural sense. |
|
|
268
|
+
| "I'll re-use the reference module's `moduleId` constant by importing it." | `moduleId` is a string literal that MUST equal the folder name AND the saas-config key — three-way string equality. Importing a constant breaks the symmetry and hides the literal from the grep invariants above. Author the literal three times; the loud-failure boot catches mismatches immediately. |
|
|
269
|
+
| "I'll author the spec-side `ModuleBusinessSemantics` later — the engine doesn't need it to boot." | True for boot, false for the audit. The spec-side value is the source of truth for `purpose` / `businessCapability` / `primaryActors` consumed by every downstream skill that reads spec semantics (resource specs reference module semantics for cross-resource reasoning). Skipping it leaves the module structurally valid but semantically opaque. |
|
|
270
|
+
| "I'll put the new module's resources directly under `shared-lib/src/modules/` (no `<module>/` parent)." | The engine resolves modules by walking `<runtime>/src/modules/<moduleId>/`. A flat layout breaks resolution for every runtime — the loud-failure boot will tell you which one first, but all of them break. |
|
|
271
|
+
|
|
272
|
+
## Red Flags
|
|
273
|
+
|
|
274
|
+
1. **A new folder appears under any `src/modules/` tree but
|
|
275
|
+
`wildo.saas.config.ts > modules` is unchanged** — module is
|
|
276
|
+
dead code; maps to Verification: "**Three-way string
|
|
277
|
+
equality**" + boot smoke-test.
|
|
278
|
+
2. **`services: ['backendApi']` declared but no
|
|
279
|
+
`backend-api/src/modules/<m>/index.ts` exists** (or vice
|
|
280
|
+
versa) — runtime fails to load at boot; maps to Verification:
|
|
281
|
+
"**No orphan slices**".
|
|
282
|
+
3. **Per-runtime `index.ts` lacks a default export** — engine
|
|
283
|
+
throws "registration object not found"; maps to Verification:
|
|
284
|
+
"**Typed registration object exported by default**" + grep
|
|
285
|
+
invariant "Default export per runtime".
|
|
286
|
+
4. **Sub-folders copied wholesale from the reference module
|
|
287
|
+
without populating them** (e.g. an empty `emails/` directory
|
|
288
|
+
that never ships any template) — misleads future readers and
|
|
289
|
+
leaves dangling barrel exports nobody can resolve;
|
|
290
|
+
maps to Verification: "**Reference module's topology
|
|
291
|
+
preserved**" with conscious omission.
|
|
292
|
+
5. **Spec-side `ModuleBusinessSemantics.relatedModuleId`
|
|
293
|
+
doesn't match the folder name** — silent semantic drift; the
|
|
294
|
+
engine doesn't catch it (no boot-time validation), but
|
|
295
|
+
downstream skills consuming spec semantics will load
|
|
296
|
+
semantics for the wrong module; maps to grep invariant
|
|
297
|
+
"Specs `relatedModuleId` matches".
|
|
298
|
+
6. **A second module is added in the same change-set without
|
|
299
|
+
running the workflow per-module** — the per-module
|
|
300
|
+
verification invariants don't compose; running them once
|
|
301
|
+
against "both modules" passes silently while one of the two
|
|
302
|
+
is half-wired. Apply the workflow per-module.
|
|
303
|
+
|
|
304
|
+
## Related Skills
|
|
305
|
+
|
|
306
|
+
- `resource-add-resource` — add a single resource inside this
|
|
307
|
+
(or any existing) module's `resources/` tree.
|
|
308
|
+
- `module-registration` — edit registration objects after
|
|
309
|
+
scaffolding (rename, change `services: [...]`, move between
|
|
310
|
+
apps).
|
|
311
|
+
- `module-companion-exports` — wire the per-runtime barrel
|
|
312
|
+
exports (`./resources`, `./addons`, `./emails`, `./i18n`)
|
|
313
|
+
the engine and the audit expect.
|
|
314
|
+
- `config-saas` — change the saas-config-root surfaces
|
|
315
|
+
(`services` map, `engineCapabilities`, `providers`, `dataServices`)
|
|
316
|
+
that this skill leaves untouched.
|
|
317
|
+
- `backend-addon-wiring` — once the backend slice exists, wire
|
|
318
|
+
`flowsActors` / `emailTemplateDefinitions` via the addon
|
|
319
|
+
convention (i18n is engine-owned; do not add `customLabels`).
|
|
320
|
+
- `i18n-label-generation` — engine-owned per-unit labels that
|
|
321
|
+
the spec slice's `mainResources` reference (single owner via
|
|
322
|
+
`scanCustomLabelsDirectory`).
|
package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# New module — config & shared shape (source)
|
|
2
|
+
|
|
3
|
+
- Declare the module under **`modules`** in `wildo.saas.config.ts` (`ApplicationModulesSchema`).
|
|
4
|
+
- Implement the shared-lib slice as **`SharedSaaSModule`** (resources, relationships, optional product/feature/milestone hooks).
|
|
5
|
+
|
|
6
|
+
## Import Origins
|
|
7
|
+
|
|
8
|
+
- `@wildo-ai/platform-config-lib`
|
|
9
|
+
|
|
10
|
+
## Source Excerpts
|
|
11
|
+
|
|
12
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
*
|
|
16
|
+
* SaaS root `modules` map: each module id binds to the service keys it consumes (`ApplicationModulesSchema`).
|
|
17
|
+
*/
|
|
18
|
+
export const ApplicationModuleBindingSchema = z.object({
|
|
19
|
+
services: z.array(z.string().min(1)).min(1),
|
|
20
|
+
/**
|
|
21
|
+
* When true, at least one backend workload for this module requires the
|
|
22
|
+
* Java-enabled framework backend base image (for example SAML/XSD flows).
|
|
23
|
+
*/
|
|
24
|
+
haveSamlIntegration: z.boolean().optional(),
|
|
25
|
+
});
|
|
26
|
+
export type ApplicationModuleBinding = z.infer<typeof ApplicationModuleBindingSchema>;
|
|
27
|
+
|
|
28
|
+
export const ApplicationModulesSchema = z.record(
|
|
29
|
+
z.string().min(1),
|
|
30
|
+
ApplicationModuleBindingSchema,
|
|
31
|
+
).optional();
|
|
32
|
+
export type ApplicationModules = z.infer<typeof ApplicationModulesSchema>;
|
|
33
|
+
```
|
|
34
|
+
## Import Origins
|
|
35
|
+
|
|
36
|
+
- `@wildo-ai/saas-models`
|
|
37
|
+
|
|
38
|
+
## Source Excerpts
|
|
39
|
+
|
|
40
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
41
|
+
|
|
42
|
+
```typescript
|
|
43
|
+
*
|
|
44
|
+
* App module contract: id, kind, roles, feature/milestone/product/notification-badge definition hooks layered on shared resources.
|
|
45
|
+
*/
|
|
46
|
+
export interface SharedSaaSModule extends SharedDomainModule {
|
|
47
|
+
moduleId: string;
|
|
48
|
+
kind?: ApplicationModuleKind;
|
|
49
|
+
customRoles?: RolesConfiguration;
|
|
50
|
+
customFeatureDefinitions?: FeatureDefinitionWithAutoRegister[];
|
|
51
|
+
customFeatureConfiguration?: {
|
|
52
|
+
profiles?: Record<string, ScopeFeatures>;
|
|
53
|
+
defaultProfile?: string;
|
|
54
|
+
unavailabilityPolicy?: Partial<FeatureConfiguration['unavailabilityPolicy']>;
|
|
55
|
+
};
|
|
56
|
+
customMilestoneDefinitions?: MilestoneDefinition[];
|
|
57
|
+
productDefinitions?: ProductDefinition[];
|
|
58
|
+
/**
|
|
59
|
+
* Notification badge definitions owned by this module (a module declares the
|
|
60
|
+
* badges derived from / driven by its own resources — e.g. a tasks module owns
|
|
61
|
+
* an "incomplete todos" count). Aggregated across modules by
|
|
62
|
+
* `buildSharedSaaSModulesRegistry` and threaded into the app init config, so a
|
|
63
|
+
* module owns its badge concern end-to-end with no app-level wiring.
|
|
64
|
+
*/
|
|
65
|
+
notificationBadgeDefinitions?: NotificationBadgeDefinition[];
|
|
66
|
+
}
|
|
67
|
+
```
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Module Scaffold — Typical Layout
|
|
2
|
+
|
|
3
|
+
Wildo apps usually mirror structure across packages. When adding a module,
|
|
4
|
+
align with existing modules in the same app.
|
|
5
|
+
|
|
6
|
+
| Package | Typical additions |
|
|
7
|
+
|---------|-------------------|
|
|
8
|
+
| `shared-lib` | `./shared-lib/src/modules/<module>/` — resources, enums, module index |
|
|
9
|
+
| `app` | `./frontend/src/modules/<module>/` — UI behavior, custom views, module frontend entry |
|
|
10
|
+
| `specifications` | `./specifications/src/modules/<module>/` — resource and view specs |
|
|
11
|
+
| `backend-api` | If the app splits backend by module — follow existing pattern |
|
|
12
|
+
|
|
13
|
+
Also check `wildo.saas.config.ts` (or project equivalent) for module registration
|
|
14
|
+
if your app lists modules explicitly — use `config-saas` when changing global
|
|
15
|
+
service/module lists.
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-add-resource
|
|
3
|
+
description: Scaffold a new resource (schema, resources-config, relationships, factory wiring, optional UI behavior and specification) across `shared-lib`, `app`, and `specifications`. Use when the user says "add a new resource <name>", "create a <name> resource in the <module> module", "scaffold <name> alongside the existing tasks/todos", or "introduce a new persisted entity for <feature>" — anything that creates a brand-new resource type, not a field addition or operation tweak on an existing one.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Resource Add Resource — Scaffold Workflow
|
|
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
|
+
This skill scaffolds a **new resource** end-to-end enough that the app can
|
|
23
|
+
compile and the resource participates in the framework registries. It does
|
|
24
|
+
**not** replace deep authoring in each layer — it ensures no surface is
|
|
25
|
+
forgotten and that the new resource is discoverable from the module's
|
|
26
|
+
factory map.
|
|
27
|
+
|
|
28
|
+
The single most common scaffold mistake is leaving the new resource
|
|
29
|
+
**unregistered**: schema and config exist, but the module factory map does
|
|
30
|
+
not include the new resource type, so it never reaches the runtime
|
|
31
|
+
registry.
|
|
32
|
+
|
|
33
|
+
## App Paths
|
|
34
|
+
|
|
35
|
+
| Surface | Glob (relative to app root) |
|
|
36
|
+
|----------------------|------------------------------------------------------------------------------------------|
|
|
37
|
+
| Shared schema | `shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts` |
|
|
38
|
+
| Resources config | `shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts` |
|
|
39
|
+
| Module factory map | `shared-lib/src/modules/<module>/resources/<module>.resource-configs.ts` |
|
|
40
|
+
| Module relationships | `shared-lib/src/modules/<module>/resources/<module>.relationships.ts` |
|
|
41
|
+
| Resource type enum | `shared-lib/src/modules/<module>/resources/<module>.resources-types.ts` |
|
|
42
|
+
| Frontend UI behavior | `frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
43
|
+
| Specification | `specifications/src/modules/<module>/resources/<resource>.resource.specification.ts` |
|
|
44
|
+
| Module barrel | `shared-lib/src/modules/<module>/index.ts` |
|
|
45
|
+
|
|
46
|
+
## When to Use
|
|
47
|
+
|
|
48
|
+
- Introducing a new resource type in a module
|
|
49
|
+
- Splitting a conceptual entity into its own resource with its own lifecycle
|
|
50
|
+
- Adding a resource that needs CRUD-like operations and specifications
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- Adding one field to an existing resource -> `resource-add-field`
|
|
55
|
+
- Only editing `*.schemas.ts` -> `resource-schema-authoring`
|
|
56
|
+
- Only adjusting operations or relationships on an existing resource -> `resource-config-wiring`
|
|
57
|
+
|
|
58
|
+
## Workflow
|
|
59
|
+
|
|
60
|
+
### Step 1: Name the resource and module
|
|
61
|
+
|
|
62
|
+
Fix `<module>` and `<resource>`. Folder + file prefix conventions must
|
|
63
|
+
match the existing module's resources (kebab-case folder, kebab-case file
|
|
64
|
+
prefix, e.g. `tasks-manager/resources/draft-notes/draft-notes.schemas.ts`).
|
|
65
|
+
|
|
66
|
+
Add the new value to the module's `<Module>_ResourceType` enum first —
|
|
67
|
+
every other surface keys off it.
|
|
68
|
+
|
|
69
|
+
### Step 2: Create shared-layer artifacts first
|
|
70
|
+
|
|
71
|
+
| Order | Artifact | Read next |
|
|
72
|
+
|-------|----------|-----------|
|
|
73
|
+
| 1 | `<resource>.schemas.ts` with `initZodDecorators(z)` and truthful shape | `resource-schema-authoring` |
|
|
74
|
+
| 2 | `<resource>.resources-config.ts` with operations, variants | `resource-config-wiring` |
|
|
75
|
+
| 3 | New `createResourcesRelationship(...)` entries in `<module>.relationships.ts` for every FK / parent-child link | `resource-config-wiring` |
|
|
76
|
+
|
|
77
|
+
Follow `resource-schema-authoring` for structural decorators only on the
|
|
78
|
+
schema. Mirror operation choices from the closest sibling resource in the
|
|
79
|
+
same module.
|
|
80
|
+
|
|
81
|
+
### Step 3: Wire the module factory map
|
|
82
|
+
|
|
83
|
+
Register the new factory in the module's central
|
|
84
|
+
`<module>.resource-configs.ts` map. **This is the step most often forgotten
|
|
85
|
+
when copy-pasting a sibling resource.**
|
|
86
|
+
|
|
87
|
+
The compiled extract below is a live application `tasks-manager`
|
|
88
|
+
factory map — copy this shape and add a new line keyed by the new
|
|
89
|
+
`TasksManager_ResourceType.<NEW>` enum value:
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
## Usage Example
|
|
93
|
+
|
|
94
|
+
```typescript
|
|
95
|
+
export const moduleResourcesConfigurationsFactoryMap: ResourceConfiguration_InitializationFactoryMap<TasksManager_ResourceType> = {
|
|
96
|
+
[TasksManager_ResourceType.TODO_LISTS]: todoLists_ResourceConfiguration_InitializationFactory,
|
|
97
|
+
[TasksManager_ResourceType.TODOS]: todos_ResourceConfiguration_InitializationFactory,
|
|
98
|
+
[TasksManager_ResourceType.TASKS]: tasks_ResourceConfiguration_InitializationFactory,
|
|
99
|
+
[TasksManager_ResourceType.TODOS_RELATIONSHIPS]: todosRelationships_ResourceConfiguration_InitializationFactory,
|
|
100
|
+
[TasksManager_ResourceType.TODOS_RECURRING_OCCURRENCES]: todoRecurringOccurrences_ResourceConfiguration_InitializationFactory,
|
|
101
|
+
[TasksManager_ResourceType.DRAFT_NOTES]: draftNotes_ResourceConfiguration_InitializationFactory,
|
|
102
|
+
[TasksManager_ResourceType.APP_ANNOUNCEMENTS]: appAnnouncements_ResourceConfiguration_InitializationFactory,
|
|
103
|
+
[TasksManager_ResourceType.TEAM_GOALS]: teamGoals_ResourceConfiguration_InitializationFactory,
|
|
104
|
+
[TasksManager_ResourceType.ORGANIZATION_PARTNERSHIPS]: organizationPartnerships_ResourceConfiguration_InitializationFactory,
|
|
105
|
+
[TasksManager_ResourceType.ORGANIZATION_ESCALATION_CONTACTS]: organizationEscalationContacts_ResourceConfiguration_InitializationFactory,
|
|
106
|
+
[TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS]: accountErasureRequests_ResourceConfiguration_InitializationFactory,
|
|
107
|
+
[TasksManager_ResourceType.KNOWLEDGE_DOCUMENTS]: knowledgeDocuments_ResourceConfiguration_InitializationFactory,
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
What the snippet shows:
|
|
112
|
+
|
|
113
|
+
- One typed map keyed by `<Module>_ResourceType` enum values (the
|
|
114
|
+
`ResourceConfiguration_InitializationFactoryMap` generic enforces it).
|
|
115
|
+
- One entry per resource in the module — including non-user-facing
|
|
116
|
+
resources like `TODOS_RELATIONSHIPS` (junction rows for self-referencing
|
|
117
|
+
M:N) and `TODOS_RECURRING_OCCURRENCES` (variant child).
|
|
118
|
+
- Each entry points at the resource's `*_ResourceConfiguration_InitializationFactory`
|
|
119
|
+
exported from the resource's own `<resource>.resources-config.ts`.
|
|
120
|
+
|
|
121
|
+
If the new resource is not in this map at the end of Step 3, the
|
|
122
|
+
framework will not know it exists at runtime — even if every other file
|
|
123
|
+
is perfect.
|
|
124
|
+
|
|
125
|
+
### Step 4: Add UI behavior when the resource is user-facing
|
|
126
|
+
|
|
127
|
+
If any operation is visible in the product, add `<resource>.ui-behavior.tsx`
|
|
128
|
+
and follow `resource-ui-behavior` — including a resource `icon` and an
|
|
129
|
+
`iconOverride` for every **custom** operation (custom ops have no default
|
|
130
|
+
action-button icon and otherwise render the placeholder).
|
|
131
|
+
|
|
132
|
+
### Step 5: Add specification and labels when the companion pipeline applies
|
|
133
|
+
|
|
134
|
+
When specifications exist for sibling resources, add
|
|
135
|
+
`<resource>.resource.specification.ts` and follow `spec-resource-update`.
|
|
136
|
+
Add labels for user-visible fields and operations.
|
|
137
|
+
|
|
138
|
+
### Step 6: Ship the table, if this application is on PostgreSQL
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
Absent means MongoDB and this step is a no-op — the collection appears on first
|
|
145
|
+
write. `applicationDatabase: { engine: DatabaseEngine.POSTGRESQL }` means the
|
|
146
|
+
new resource has **no table until a migration creates one**, and the backend
|
|
147
|
+
will refuse to start with `postgresql_table_schema_mismatch`. Follow
|
|
148
|
+
`application-database-migrations`; the short form is `wildo db generate --name
|
|
149
|
+
add-<resource>`, then commit the migration folder together with
|
|
150
|
+
`schema-plan.lock.json`.
|
|
151
|
+
|
|
152
|
+
### Step 7: Hand off verification
|
|
153
|
+
|
|
154
|
+
Confirm TypeScript passes in dev watchers, the resource appears in the
|
|
155
|
+
same registry paths as siblings, and the resource is reachable from the
|
|
156
|
+
module barrel (`index.ts`) if siblings re-export theirs.
|
|
157
|
+
|
|
158
|
+
## References
|
|
159
|
+
|
|
160
|
+
- `references/scaffold-surfaces-checklist.md` — surface checklist before "done"
|
|
161
|
+
- `references/framework-new-resource-core-config-api.md` — source-backed core operation / resource type / builder params
|
|
162
|
+
- `resource-config-wiring` → `references/framework-saas-models-resource-config-api.md` — typed config surface when authoring `resources-config`
|
|
163
|
+
- `resource-config-wiring` → `references/framework-personal-data-declaration-api.md` — **read once per new resource**: do its rows describe a person, and the four ways to answer
|
|
164
|
+
|
|
165
|
+
## Verification
|
|
166
|
+
|
|
167
|
+
- [ ] **The personal-data question is ANSWERED** — a `retentionPolicy` (`RETAIN_ONLY` says, checkably, that it holds none of its own), a `dataSubjectPolicy`, a `systemAccessPolicy.exportSubject`, or `.dataCategories()` on the fields that hold it. This is the cheapest moment; later means editing a shipped schema, and until it is answered the application's privacy notice can say nothing about this resource.
|
|
168
|
+
- [ ] New value added to the module's `<Module>_ResourceType` enum
|
|
169
|
+
- [ ] `<resource>.schemas.ts` exists and calls `initZodDecorators(z)` before schema definitions
|
|
170
|
+
- [ ] `<resource>.resources-config.ts` exists and matches the module's registration pattern
|
|
171
|
+
- [ ] **Module factory map (`<module>.resource-configs.ts`) includes a new entry keyed by the new enum value**
|
|
172
|
+
- [ ] All FKs declared on the new schema have matching `createResourcesRelationship(...)` entries in `<module>.relationships.ts`
|
|
173
|
+
- [ ] UI behavior exists if the resource is user-facing
|
|
174
|
+
- [ ] Specification and labels exist if siblings use them
|
|
175
|
+
- [ ] No orphaned files that are not imported from module indexes
|
|
176
|
+
- [ ] **On a PostgreSQL application: a migration creates the new table, and `wildo db diff --check` exits 0**
|
|
177
|
+
|
|
178
|
+
### Grep invariants
|
|
179
|
+
|
|
180
|
+
Run from the app root and substitute `<resource>` (folder name) and
|
|
181
|
+
`<RESOURCE>` (enum member):
|
|
182
|
+
|
|
183
|
+
| Invariant | Command |
|
|
184
|
+
|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
185
|
+
| The new resource type enum value exists | `rg -n "<RESOURCE>\\s*=" shared-lib/src/modules/*/resources/*.resources-types.ts` |
|
|
186
|
+
| The new schema file initializes Zod decorators | `rg -n "initZodDecorators" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
187
|
+
| The new factory is exported from the resource's own config file | `rg -n "<resource>_ResourceConfiguration_InitializationFactory" shared-lib/src/modules/*/resources/<resource>/<resource>.resources-config.ts` |
|
|
188
|
+
| **The module factory map includes the new resource** (this MUST return 1 match) | `rg -n "<RESOURCE>\\]:\\s*<resource>_ResourceConfiguration" shared-lib/src/modules/*/resources/*.resource-configs.ts` |
|
|
189
|
+
| Every FK on the new schema has a relationship declaration | `comm -23 <(rg -oN "isForeignKey\\(\\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \\| sort -u) <(rg -oN "<RESOURCE>" shared-lib/src/modules/*/resources/*.relationships.ts \\| sort -u)` |
|
|
190
|
+
|
|
191
|
+
The fourth grep is the most important invariant: a missing entry in the
|
|
192
|
+
factory map is the most common silent scaffold failure.
|
|
193
|
+
|
|
194
|
+
## Common Rationalizations
|
|
195
|
+
|
|
196
|
+
| Rationalization | Reality |
|
|
197
|
+
|-----------------|---------|
|
|
198
|
+
| "I'll add the spec later" | Underspecified resources drift from day one; mirror sibling resources in the same change set. |
|
|
199
|
+
| "Config can be empty for now" | Empty config often means missing operations; the resource is invisible in the UI. |
|
|
200
|
+
| "I'll copy-paste from another module without checking registries" | Each module has a local registration pattern; verify against siblings before claiming the scaffold is complete. |
|
|
201
|
+
| "Schema + config is enough" | Without the module factory-map entry, the runtime never registers the resource. The fourth grep above MUST return a match. |
|
|
202
|
+
| "I'll add relationships when needed" | FK fields without a matching `createResourcesRelationship(...)` entry mean the framework has no relationship semantics — joins, context hydration, and cascade rules silently fall back to nothing. |
|
|
203
|
+
| "It compiles and the registry sees it, so the resource is done" | On a PostgreSQL application it has no TABLE until a migration builds one, and the backend refuses to boot rather than serve it. On MongoDB this rationalization is true; the engine is what decides. |
|
|
204
|
+
|
|
205
|
+
## Red Flags
|
|
206
|
+
|
|
207
|
+
- Schema and config exist but the module factory map (`*.resource-configs.ts`) was not touched (catch with the **module factory map** grep — must return 1 match).
|
|
208
|
+
- Resource folder created but nothing imports it from the module barrel.
|
|
209
|
+
- New FK fields on the schema with no matching `createResourcesRelationship(...)` (catch with the **Every FK** comm invariant).
|
|
210
|
+
- User-facing resource without `ui-behavior` or specification when siblings have both (manual review).
|
|
211
|
+
- New `<Module>_ResourceType` enum value missing — every other surface is unanchored without it (catch with the **resource type enum** grep).
|
|
212
|
+
- A PostgreSQL application where the scaffold touched no `backend-api/migrations/` folder (catch with `wildo db diff --check`, which exits non-zero).
|
|
213
|
+
|
|
214
|
+
## Related Skills
|
|
215
|
+
|
|
216
|
+
- `resource-schema-authoring` — Step 2 of this scaffold
|
|
217
|
+
- `resource-config-wiring` — Step 2 / Step 3 of this scaffold
|
|
218
|
+
- `resource-ui-behavior` — Step 4 of this scaffold
|
|
219
|
+
- `spec-resource-update` — Step 5 of this scaffold
|
|
220
|
+
- `resource-add-field` — for the (much smaller) "extend an existing resource" workflow
|
|
221
|
+
- `module-registration` — when adding the resource also requires module-level changes
|
|
222
|
+
- `application-database-migrations` — Step 6 of this scaffold, on PostgreSQL-backed applications
|