@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
package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md
ADDED
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
# Rate-Limit Policy API (source)
|
|
2
|
+
|
|
3
|
+
The two source-anchored surfaces an author touches when declaring or
|
|
4
|
+
enforcing per-endpoint rate limits.
|
|
5
|
+
|
|
6
|
+
## Policy shape — what to declare
|
|
7
|
+
|
|
8
|
+
`RateLimitConfiguration` is the canonical declarative shape consumed
|
|
9
|
+
by both surfaces (resource-operation `rateLimit?` field + custom-
|
|
10
|
+
controller `checkPolicy` call). All windows are optional and AND
|
|
11
|
+
together; multi-window collapse into a single declaration is the PR 8b
|
|
12
|
+
convention.
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-models`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
*
|
|
24
|
+
* Canonical rate-limit declaration shape.
|
|
25
|
+
*
|
|
26
|
+
* Authoring semantics:
|
|
27
|
+
*
|
|
28
|
+
* - Every window is **optional**. `undefined` means "no limit on this window".
|
|
29
|
+
* Authors typically declare one or two windows (e.g. `{ requestsPerMinute: 5,
|
|
30
|
+
* requestsPerHour: 30 }` for a public anonymous endpoint).
|
|
31
|
+
* - Multiple declared windows are **AND-ed**: a request is allowed only when
|
|
32
|
+
* it passes every declared window. On 429 the response reports two
|
|
33
|
+
* potentially DIFFERENT windows:
|
|
34
|
+
* - `X-RateLimit-Limit` / `…-Remaining` / `…-Reset` — from the **tightest
|
|
35
|
+
* active window** (the one with the fewest remaining slots), so the
|
|
36
|
+
* client sees the binding quota.
|
|
37
|
+
* - `Retry-After` and `retryAfterSeconds` (in the error body) — from the
|
|
38
|
+
* **latest tripped window**, because a retry cannot succeed until every
|
|
39
|
+
* exceeded window has reset.
|
|
40
|
+
* - `customWindows` is the **escape hatch** for the rare endpoint whose
|
|
41
|
+
* business semantics genuinely do not fit a 60s / 3600s / 86400s grid. The
|
|
42
|
+
* canonical example is the SMS phone-verify
|
|
43
|
+
* family, which mandates a 5-minute (300s) per-phone-number throttle
|
|
44
|
+
* tied to the OTP TTL — neither minute nor hour is correct, and rounding
|
|
45
|
+
* would either let attackers through (round up) or DoS legitimate users
|
|
46
|
+
* (round down). Authors should reach for `requestsPerMinute / Hour / Day`
|
|
47
|
+
* first; `customWindows` exists for the cases where those would be
|
|
48
|
+
* semantically wrong, NOT as a convenience for arbitrary tuning.
|
|
49
|
+
*
|
|
50
|
+
* Two consumption surfaces use this shape today:
|
|
51
|
+
* 1. **Resource operations** — `ResourceConfiguration_Operation_ApiCall.rateLimit?`
|
|
52
|
+
* on `API_CALL` / `API_CALL_WITH_CALLBACK` variants. Pre-flight enforced
|
|
53
|
+
* BEFORE execution-context creation, validation, and authorization. The
|
|
54
|
+
* bucket is always IP-keyed at this seam (authenticated identity is
|
|
55
|
+
* unknown by construction).
|
|
56
|
+
* 2. **Custom controllers** — `RateLimitBackendService.checkPolicy(req, res,
|
|
57
|
+
* policy, scopeKey, organizationId?, clientIdOverride?)` for hand-wired
|
|
58
|
+
* routes (auth, SCIM, marketing public endpoints). The bucket defaults
|
|
59
|
+
* to IP-keyed; pass `clientIdOverride` (resolved subject identifier:
|
|
60
|
+
* `token._id`, `userId`, normalized email, normalized phone) when the
|
|
61
|
+
* caller has a stronger identity than IP — IP rotation must not let a
|
|
62
|
+
* bad actor sidestep a per-subject quota.
|
|
63
|
+
*
|
|
64
|
+
* The global HTTP per-IP limiter (`RuntimeConfig.httpServerConfiguration.rateLimiting`)
|
|
65
|
+
* remains the safety net for endpoints that declare no policy.
|
|
66
|
+
*
|
|
67
|
+
* @remarks Import from `@wildo-ai/saas-models`.
|
|
68
|
+
*/
|
|
69
|
+
export const RateLimitConfigurationSchema = z.object({
|
|
70
|
+
requestsPerMinute: z.number().int().positive('Requests per minute must be a positive integer').optional(),
|
|
71
|
+
requestsPerHour: z.number().int().positive('Requests per hour must be a positive integer').optional(),
|
|
72
|
+
requestsPerDay: z.number().int().positive('Requests per day must be a positive integer').optional(),
|
|
73
|
+
customWindows: z.array(z.object({
|
|
74
|
+
requestsPerWindow: z.number().int().positive('Requests per window must be a positive integer'),
|
|
75
|
+
windowSeconds: z.number().int().positive('Window seconds must be a positive integer')
|
|
76
|
+
})).optional()
|
|
77
|
+
});
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Custom-controller enforcement — how to call it
|
|
81
|
+
|
|
82
|
+
`RateLimitBackendService.checkPolicy(req, res, policy, scopeKey,
|
|
83
|
+
organizationId?, clientIdOverride?)` is the declarative consumer for
|
|
84
|
+
hand-wired controllers (auth, SCIM, marketing public endpoints) that
|
|
85
|
+
cannot rely on the resource-controller pre-flight seam. The JSDoc
|
|
86
|
+
documents every parameter — including the bucket-key strategy that
|
|
87
|
+
makes `clientIdOverride` the difference between an
|
|
88
|
+
IP-rotation-bypassable cap and a per-subject security boundary.
|
|
89
|
+
|
|
90
|
+
## Import Origins
|
|
91
|
+
|
|
92
|
+
- `@wildo-ai/saas-backend-lib`
|
|
93
|
+
|
|
94
|
+
## Source Excerpts
|
|
95
|
+
|
|
96
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
97
|
+
|
|
98
|
+
```typescript
|
|
99
|
+
*
|
|
100
|
+
* Declarative multi-window policy enforcement.
|
|
101
|
+
*
|
|
102
|
+
* Increments one Redis counter per declared window (so window accounting
|
|
103
|
+
* stays consistent — a request that trips the per-minute window still
|
|
104
|
+
* counts against the per-hour quota), then:
|
|
105
|
+
*
|
|
106
|
+
* - Writes `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`
|
|
107
|
+
* headers from the **tightest active window** (the one with the fewest
|
|
108
|
+
* `remaining` slots). Matches the existing system-1 header contract (K-6).
|
|
109
|
+
* - On 429, throws `ErrorType.RATE_LIMIT` with `retryAfterSeconds` from
|
|
110
|
+
* the **latest tripped window**. Declared windows are AND-ed, so a retry
|
|
111
|
+
* cannot succeed until every tripped counter has reset.
|
|
112
|
+
*
|
|
113
|
+
* Client identifier (the per-bucket key suffix, what makes one client's
|
|
114
|
+
* counter independent from another's) defaults to `getClientIpFromRequest(req)`
|
|
115
|
+
* — the canonical pre-auth identity at the controller seam, consistent
|
|
116
|
+
* with the global HTTP limiter (system 1) which also keys on raw IP by
|
|
117
|
+
* construction. Custom controllers that have already resolved a more
|
|
118
|
+
* appropriate identity can pass `clientIdOverride` to bypass IP
|
|
119
|
+
* derivation entirely:
|
|
120
|
+
* - SCIM controller — `clientIdOverride: token._id` (per-token quota,
|
|
121
|
+
* independent of which IP the IdP is calling from today).
|
|
122
|
+
* - Authenticated user actions — `clientIdOverride: userId` (one user,
|
|
123
|
+
* one bucket across all their devices/IPs — credential-stuffing-style
|
|
124
|
+
* IP rotation can't bypass the per-user cap).
|
|
125
|
+
* - Email-keyed flows (password reset, magic link) — `clientIdOverride:
|
|
126
|
+
* email` (one email address, one bucket across all originating IPs).
|
|
127
|
+
* The default IP-keyed mode is correct for pre-auth flows where no
|
|
128
|
+
* better identity exists yet (the resource-controller pre-flight seam
|
|
129
|
+
* via `checkPolicyForVariant`, anonymous-session init, etc.).
|
|
130
|
+
*
|
|
131
|
+
* `requestsPerMinute` / `requestsPerHour` / `requestsPerDay` AND any
|
|
132
|
+
* entries in `customWindows` (D-3, Option A — for the rare endpoint
|
|
133
|
+
* whose business semantics genuinely don't fit a minute / hour / day
|
|
134
|
+
* grid, e.g. the SMS phone-verify family on a 5-minute window tied to
|
|
135
|
+
* the OTP TTL) are all honored at this seam.
|
|
136
|
+
*
|
|
137
|
+
* @param req — express request. Used for IP extraction when
|
|
138
|
+
* `clientIdOverride` is omitted; not read otherwise. Always required
|
|
139
|
+
* so future enhancements (e.g. surfacing the IP in error context for
|
|
140
|
+
* audit) don't need a signature change.
|
|
141
|
+
* @param res — express response (headers written as side-effect)
|
|
142
|
+
* @param policy — the declarative policy. A policy with no enforced
|
|
143
|
+
* windows (all of `requestsPerMinute / Hour / Day` undefined and
|
|
144
|
+
* `customWindows` either undefined or empty) is a no-op (no-policy
|
|
145
|
+
* fast path; zero Redis traffic).
|
|
146
|
+
* @param scopeKey — author-supplied namespace (e.g. `auth:password_change`,
|
|
147
|
+
* `resource:INBOUND_CONTACTS:CREATE`, `scim:token`). Composed with the
|
|
148
|
+
* client identifier to form the Redis key:
|
|
149
|
+
* `${scopeKey}:${clientId}:${windowName}`.
|
|
150
|
+
* @param organizationId — optional tenant scope. Forwarded to the underlying
|
|
151
|
+
* `RedisService.incrementRateLimit` so per-tenant quotas don't collide
|
|
152
|
+
* across orgs. Omit for single-tenant or pre-auth policies (the resource
|
|
153
|
+
* pre-flight seam can't resolve a tenant yet by construction — C-5).
|
|
154
|
+
* @param clientIdOverride — optional explicit client identifier. When
|
|
155
|
+
* provided, replaces `getClientIpFromRequest(req)` as the per-bucket
|
|
156
|
+
* key suffix. Use whenever the caller has resolved an authenticated
|
|
157
|
+
* subject identifier (token id, user id, email) so the bucket can't
|
|
158
|
+
* be bypassed by IP rotation.
|
|
159
|
+
*
|
|
160
|
+
* @remarks Import from `@wildo-ai/saas-backend-lib`.
|
|
161
|
+
*/
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## Notes for authors
|
|
165
|
+
|
|
166
|
+
- The resource-operation surface (`rateLimit?` field on
|
|
167
|
+
`API_CALL` / `API_CALL_WITH_CALLBACK` variants in the resource
|
|
168
|
+
configuration) does NOT have its own anchor — it is a single
|
|
169
|
+
field of type `RateLimitConfiguration` on the operation-api-call
|
|
170
|
+
type already covered by `saas.models.resource-config.operation-api-call`.
|
|
171
|
+
Read THAT anchor (via the resource-config skills) to see how the
|
|
172
|
+
field sits inside the variant declaration.
|
|
173
|
+
- `RateLimitBackendService` exposes a third method
|
|
174
|
+
(`checkPolicyForVariant`) used internally by
|
|
175
|
+
`ControllerResourceBackendService.doOperation` — authors do NOT
|
|
176
|
+
call it directly; declaring `rateLimit?` on the variant is the
|
|
177
|
+
authoring surface, the framework wires the rest.
|
|
178
|
+
- `RateLimitBackendService.checkRateLimit` (the imperative low-level
|
|
179
|
+
primitive) is the K-3 escape hatch — see the SKILL "When
|
|
180
|
+
`checkPolicy` is NOT the right answer" section for the criteria.
|
|
181
|
+
No source anchor for it on purpose: not a recommended authoring
|
|
182
|
+
surface.
|
package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# Scope-Key & Bucket Conventions (Cheat Sheet)
|
|
2
|
+
|
|
3
|
+
Dense reference for code review. Each row names a durable call-site invariant,
|
|
4
|
+
the shape it requires and the trap it prevents. The labels are local mnemonic
|
|
5
|
+
names, not links to private project history.
|
|
6
|
+
|
|
7
|
+
## At-a-glance
|
|
8
|
+
|
|
9
|
+
| Convention | Field / API | Required shape | Trap if violated |
|
|
10
|
+
|---|---|---|---|
|
|
11
|
+
| **F-7** Unknown-IP closure | `getClientIpFromRequest(req)` | NO `if (ipAddress)` guard at HTTP-derived sites; co-bucket via `'unknown'` sentinel | Attacker behind IP-stripping proxy gets unlimited free traffic |
|
|
12
|
+
| **F-14** Phone normalization | `phoneRateLimitBucketKey(phone)` | ALWAYS strip `+` / `00` international prefixes via the helper | `+33...` / `0033...` / `33...` get three distinct buckets for the same phone |
|
|
13
|
+
| **F-15** `:by-<dim>` scope-key suffix | `scopeKey: 'auth:identify:by-email'` / `:by-ip` / `:by-token` / `:by-user-source` | When ONE endpoint declares MULTIPLE buckets with different `clientIdOverride` values, suffix each scope key with its dimension | Two `checkPolicy` calls collide on the same Redis namespace; one cap silently consumes the other's quota |
|
|
14
|
+
| **F-20** Victim-protective ordering | order of `checkPolicy` calls | Identity-keyed (per-email / per-user / per-phone) FIRST, then per-IP | Reverse order lets IP-rotation drain the per-email cap silently while the victim is locked out of their own account |
|
|
15
|
+
| **F-22** Fail-fast ordering | placement of `checkPolicy` in the controller method | BEFORE EC creation, JWT extraction, DB lookups, external API calls | Rate-limited requests still pay the cost the cap was meant to deflect |
|
|
16
|
+
| **D-3** `customWindows` is the escape hatch | `customWindows?: Array<{ requestsPerWindow, windowSeconds }>` | Use ONLY when business semantics genuinely don't fit a 60s / 3600s / 86400s grid (canonical: 5-min phone-verify tied to OTP TTL) | Treated as a convenience knob, the four canonical windows lose meaning and arbitrary tuning fragments operator dashboards |
|
|
17
|
+
| **D-4** Email normalization baseline | `email.toLowerCase()` at every email-keyed bucket key seam | Apply at the call site EVEN when the upstream schema already lowercases (intent-revealing invariant) | A future schema change silently re-buckets every previously-bucketed user |
|
|
18
|
+
| **D-5** Composite `clientIdOverride` separator | `clientIdOverride: \`${userId}:${source}\`` | When two dimensions matter equally, join with `:`; document composition order at the call site | A future reader can't tell which dimension is the prefix; bucket key changes if the order ever flips |
|
|
19
|
+
|
|
20
|
+
## Quick recipes
|
|
21
|
+
|
|
22
|
+
### Pre-auth public endpoint (per-IP only)
|
|
23
|
+
|
|
24
|
+
```ts
|
|
25
|
+
// Resource-operation surface (preferred)
|
|
26
|
+
rateLimit: { requestsPerMinute: 5, requestsPerHour: 30 }
|
|
27
|
+
|
|
28
|
+
// Custom-controller surface
|
|
29
|
+
await this.rateLimitService.checkPolicy(
|
|
30
|
+
req, res,
|
|
31
|
+
{ requestsPerMinute: 5, requestsPerHour: 30 },
|
|
32
|
+
'auth:identify:by-ip', // F-15
|
|
33
|
+
);
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Identity-keyed flow (per-email)
|
|
37
|
+
|
|
38
|
+
```ts
|
|
39
|
+
await this.rateLimitService.checkPolicy(
|
|
40
|
+
req, res,
|
|
41
|
+
{ requestsPerMinute: 5, requestsPerHour: 30 },
|
|
42
|
+
'auth:password-reset:by-email', // F-15
|
|
43
|
+
undefined,
|
|
44
|
+
email.toLowerCase(), // D-4
|
|
45
|
+
);
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Dual-bucket (per-email + per-IP, F-20 ordered)
|
|
49
|
+
|
|
50
|
+
```ts
|
|
51
|
+
// F-20: per-identity FIRST
|
|
52
|
+
await this.rateLimitService.checkPolicy(
|
|
53
|
+
req, res,
|
|
54
|
+
{ requestsPerMinute: 5, requestsPerHour: 30 },
|
|
55
|
+
'auth:register:by-email',
|
|
56
|
+
undefined,
|
|
57
|
+
email.toLowerCase(),
|
|
58
|
+
);
|
|
59
|
+
// Per-IP SECOND
|
|
60
|
+
await this.rateLimitService.checkPolicy(
|
|
61
|
+
req, res,
|
|
62
|
+
{ requestsPerMinute: 10, requestsPerHour: 100 },
|
|
63
|
+
'auth:register:by-ip',
|
|
64
|
+
);
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Phone-keyed flow with custom window (D-3 canonical)
|
|
68
|
+
|
|
69
|
+
```ts
|
|
70
|
+
await this.rateLimitService.checkPolicy(
|
|
71
|
+
req, res,
|
|
72
|
+
{
|
|
73
|
+
requestsPerHour: 10, // canonical hourly cap
|
|
74
|
+
customWindows: [
|
|
75
|
+
{ requestsPerWindow: 1, windowSeconds: 300 }, // D-3: 5-min OTP TTL
|
|
76
|
+
],
|
|
77
|
+
},
|
|
78
|
+
'auth:phone-verify:send:by-phone',
|
|
79
|
+
undefined,
|
|
80
|
+
phoneRateLimitBucketKey(phone), // F-14
|
|
81
|
+
);
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Authenticated SCIM endpoint (per-token)
|
|
85
|
+
|
|
86
|
+
```ts
|
|
87
|
+
await this.rateLimitService.checkPolicy(
|
|
88
|
+
req, res,
|
|
89
|
+
{ requestsPerMinute: 60 },
|
|
90
|
+
'scim:tokens:by-token', // F-15
|
|
91
|
+
organizationId, // tenant scoping (C-5)
|
|
92
|
+
token._id, // per-token bucket
|
|
93
|
+
);
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Anti-patterns (auto-reject in review)
|
|
97
|
+
|
|
98
|
+
```ts
|
|
99
|
+
// F-7 violation — unknown IPs bypass the cap
|
|
100
|
+
if (req.ip) {
|
|
101
|
+
await this.rateLimitService.checkPolicy(req, res, policy, 'foo:by-ip');
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// F-14 violation — same phone, three buckets
|
|
105
|
+
await this.rateLimitService.checkPolicy(
|
|
106
|
+
req, res, policy, 'foo:by-phone',
|
|
107
|
+
undefined,
|
|
108
|
+
phone, // raw, not normalized
|
|
109
|
+
);
|
|
110
|
+
|
|
111
|
+
// F-15 violation — two buckets collide on the same scope key
|
|
112
|
+
await this.rateLimitService.checkPolicy(req, res, policy, 'auth:register', undefined, email);
|
|
113
|
+
await this.rateLimitService.checkPolicy(req, res, policy, 'auth:register'); // SAME scope!
|
|
114
|
+
|
|
115
|
+
// F-20 violation — per-IP fires first
|
|
116
|
+
await this.rateLimitService.checkPolicy(req, res, ipPolicy, 'auth:register:by-ip');
|
|
117
|
+
await this.rateLimitService.checkPolicy(req, res, emailPolicy, 'auth:register:by-email', undefined, email);
|
|
118
|
+
|
|
119
|
+
// F-22 violation — JWT extraction before the rate-limit check
|
|
120
|
+
const userId = await this.jwtService.extractUserId(req);
|
|
121
|
+
await this.rateLimitService.checkPolicy(req, res, policy, 'foo:by-user', undefined, userId);
|
|
122
|
+
|
|
123
|
+
// D-3 misuse — customWindows for a value that fits the canonical grid
|
|
124
|
+
customWindows: [{ requestsPerWindow: 100, windowSeconds: 60 }] // Use requestsPerMinute: 100
|
|
125
|
+
|
|
126
|
+
// D-4 violation — bucket key drifts when schema casing changes
|
|
127
|
+
clientIdOverride: email // missing .toLowerCase()
|
|
128
|
+
|
|
129
|
+
// PR 8b violation — multi-window NOT collapsed
|
|
130
|
+
await this.rateLimitService.checkPolicy(req, res, { requestsPerMinute: 5 }, 'foo:by-email', undefined, email.toLowerCase());
|
|
131
|
+
await this.rateLimitService.checkPolicy(req, res, { requestsPerHour: 30 }, 'foo:by-email', undefined, email.toLowerCase());
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
Each anti-pattern above maps 1:1 to a finding fixed during the
|
|
135
|
+
PR 7-D-3 → PR 8e migration audit. The audit findings are durable
|
|
136
|
+
because the framework cannot mechanically prevent them — they are
|
|
137
|
+
authoring conventions enforced by review.
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resource-add-field
|
|
3
|
+
description: Add a new field to an existing resource end-to-end across shared schema, frontend UI behavior, specification, resources-config, and i18n labels. Use when the user says "add a field to <resource>", "give <resource> a <type> field", "add an enum/status/priority field", "add a foreign key to <other resource>", or "extend <resource> with <field>" — i.e. when the intent is a real resource capability change, not just a one-file schema edit.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Resource Add Field — 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 owns the **end-to-end workflow** for adding a field to an existing
|
|
23
|
+
resource. Its job is to decide which surfaces must change, make the shared
|
|
24
|
+
schema change first, and then drive the required follow-up work instead of
|
|
25
|
+
stopping after the first file.
|
|
26
|
+
|
|
27
|
+
Use this skill when the user means "the resource should now have this field"
|
|
28
|
+
rather than "edit one shared schema file."
|
|
29
|
+
|
|
30
|
+
## App Paths
|
|
31
|
+
|
|
32
|
+
Locate the surfaces that may need editing using these app-relative globs:
|
|
33
|
+
|
|
34
|
+
| Surface | Glob (relative to app root) |
|
|
35
|
+
|----------------------|------------------------------------------------------------------------------------------|
|
|
36
|
+
| Shared schema | `shared-lib/src/modules/*/resources/*/*.schemas.ts` |
|
|
37
|
+
| Resources config | `shared-lib/src/modules/*/resources/*/*.resources-config.ts` |
|
|
38
|
+
| Frontend UI behavior | `frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
|
|
39
|
+
| Specification | `specifications/src/modules/*/resources/*.resource.specification.ts` |
|
|
40
|
+
| Backend (rare) | `backend-api/src/modules/*/resources/*/*.resource-handlers.ts` |
|
|
41
|
+
| i18n labels | `frontend/src/i18n/**/*.json` (or whatever `wildo context` writes for the project) |
|
|
42
|
+
|
|
43
|
+
If the project diverges from this layout, find the resource by grepping
|
|
44
|
+
for the `R.<RESOURCE>` enum value or for the existing field's
|
|
45
|
+
declaration.
|
|
46
|
+
|
|
47
|
+
## When to Use
|
|
48
|
+
|
|
49
|
+
- Adding a user-facing field to an existing resource
|
|
50
|
+
- Adding an enum field with frontend rendering and labels
|
|
51
|
+
- Adding a new FK/reference field
|
|
52
|
+
- Adding a technical field that may affect config, specs, or runtime behavior
|
|
53
|
+
- Extending a resource with new persisted capability
|
|
54
|
+
|
|
55
|
+
## When NOT to Use
|
|
56
|
+
|
|
57
|
+
- Editing only one shared schema file with no broader workflow requested -> use `resource-schema-authoring`
|
|
58
|
+
- Reworking layout without changing the persisted field contract -> use `resource-ui-behavior`
|
|
59
|
+
- Changing only business semantics/spec prose -> use `spec-update-after-change`
|
|
60
|
+
- Rewiring only relationships/operations/config without adding a field -> use `resource-config-wiring`
|
|
61
|
+
|
|
62
|
+
## Workflow
|
|
63
|
+
|
|
64
|
+
### Step 1: Classify the field and write down impacted surfaces
|
|
65
|
+
|
|
66
|
+
Before editing, decide which follow-up surfaces are required:
|
|
67
|
+
|
|
68
|
+
| Field type | Shared schema | Config review | Frontend behavior | Specification | Labels |
|
|
69
|
+
|------------|---------------|---------------|-------------------|---------------|--------|
|
|
70
|
+
| Backend-only technical field | Required | Maybe | Usually no | Maybe | Usually no |
|
|
71
|
+
| User-facing primitive field | Required | Maybe | Required | Required | Required |
|
|
72
|
+
| Enum field | Required | Maybe | Required with explicit enum UI | Required with enum semantics | Required for field + values |
|
|
73
|
+
| FK/reference field | Required | Required | Required if user-facing | Required if meaningful to companion | Required if user-facing |
|
|
74
|
+
| Discriminator / variant field | Required | Required | Often required | Required | Usually required |
|
|
75
|
+
|
|
76
|
+
Do not continue until you know which columns are "yes" for this field.
|
|
77
|
+
|
|
78
|
+
### Step 2: Make the shared-layer schema change first
|
|
79
|
+
|
|
80
|
+
**File:** `./shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts`
|
|
81
|
+
|
|
82
|
+
Apply `resource-schema-authoring` for the shared-layer change. At minimum:
|
|
83
|
+
|
|
84
|
+
- choose the truthful field shape
|
|
85
|
+
- add structural decorators only
|
|
86
|
+
- define a named TypeScript enum when the field is enum-backed
|
|
87
|
+
- use a special `z_*` factory when the field is a framework domain type
|
|
88
|
+
|
|
89
|
+
If engine source is unavailable, load `resource-schema-authoring` and use its
|
|
90
|
+
source-backed references for the actual framework decorator, factory, and
|
|
91
|
+
schema-family APIs before editing.
|
|
92
|
+
|
|
93
|
+
Worked example:
|
|
94
|
+
- `examples/add-priority-field-to-todos.example.md`
|
|
95
|
+
|
|
96
|
+
Do not move to later phases until the shared-layer contract is correct.
|
|
97
|
+
|
|
98
|
+
### Step 3: Review config when the field changes relationships, variants, or operations
|
|
99
|
+
|
|
100
|
+
Review config if any of these are true:
|
|
101
|
+
|
|
102
|
+
- the new field is a foreign key
|
|
103
|
+
- the field affects discriminator/variant handling
|
|
104
|
+
- operation availability, roles, or relationships depend on the new field
|
|
105
|
+
|
|
106
|
+
**Typical file:** `./shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts`
|
|
107
|
+
|
|
108
|
+
If `resource-config-wiring` exists and is mature, load it. If not, still do the
|
|
109
|
+
minimal review now rather than pretending config is unaffected.
|
|
110
|
+
|
|
111
|
+
### Step 4: Add frontend behavior for every user-facing field
|
|
112
|
+
|
|
113
|
+
**Typical file:** `./frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
114
|
+
|
|
115
|
+
If users can see or edit the field, configure the frontend behavior explicitly.
|
|
116
|
+
|
|
117
|
+
Minimal fallback contract:
|
|
118
|
+
|
|
119
|
+
- primitive field -> choose display mode and edit mode
|
|
120
|
+
- enum field -> configure per-value visuals plus display/edit modes
|
|
121
|
+
- FK field -> make sure the field renders/edits truthfully for the UI flow
|
|
122
|
+
|
|
123
|
+
For enum UI shapes and mode enums, load `resource-ui-behavior` and its
|
|
124
|
+
source-backed references (`references/framework-enum-frontend-handling-api.md`,
|
|
125
|
+
`references/framework-display-edit-modes-api.md`).
|
|
126
|
+
|
|
127
|
+
### Step 5: Update the specification when the field changes application meaning
|
|
128
|
+
|
|
129
|
+
**Typical file:** `./specifications/src/modules/<module>/resources/<resource>.resource.specification.ts`
|
|
130
|
+
|
|
131
|
+
Add the field semantics whenever the field is visible to users, meaningful to
|
|
132
|
+
the companion, or part of the resource's business contract.
|
|
133
|
+
|
|
134
|
+
Minimal fallback contract:
|
|
135
|
+
|
|
136
|
+
- primitive field -> `stringSpec()`, `numberSpec()`, etc. with meaning/importance
|
|
137
|
+
- enum field -> include enum value semantics, not just the field name
|
|
138
|
+
- FK field -> explain the relationship meaning, not only the raw id
|
|
139
|
+
|
|
140
|
+
Use the specification-maintenance partial included below as a reminder that
|
|
141
|
+
shared/resource/frontend changes and specs must stay aligned.
|
|
142
|
+
|
|
143
|
+
### Keep Resource Specifications In Sync With Schemas
|
|
144
|
+
|
|
145
|
+
Resource schemas live in `shared-lib/` (typically `*.schemas.ts`). The semantic
|
|
146
|
+
explanation of those schemas lives in the paired resource specification under
|
|
147
|
+
`specifications/src/modules/<module>/resources/`.
|
|
148
|
+
|
|
149
|
+
When you add, remove, rename, or retype a field in a resource schema, update the
|
|
150
|
+
paired resource specification in the same session.
|
|
151
|
+
|
|
152
|
+
- Sync the authored `fields` map so every field present in the runtime schema
|
|
153
|
+
has a truthful semantic entry in the spec.
|
|
154
|
+
- Refresh `additionalFieldSpecs` when inherited or variant-only fields change
|
|
155
|
+
discriminator provenance, move between variants, appear, or disappear.
|
|
156
|
+
- Update enum declarations, enum values, array `elementType`, foreign-key
|
|
157
|
+
targets, temporal roles, and other code-handling metadata when the schema
|
|
158
|
+
source changes the import surface.
|
|
159
|
+
- If the main schema export is moved or renamed in `shared-lib/`, update
|
|
160
|
+
`codeHandling.mainSchema` so an AI generating code from the spec still
|
|
161
|
+
imports the right symbol from the right package.
|
|
162
|
+
- Remove stale field names, variant paths, and prose immediately; never leave
|
|
163
|
+
the specification describing a schema shape that no longer exists.
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
### Step 6: Update labels for every user-facing addition
|
|
167
|
+
|
|
168
|
+
If the field is user-facing, labels are part of the change, not a later cleanup.
|
|
169
|
+
|
|
170
|
+
Minimum label impact:
|
|
171
|
+
|
|
172
|
+
- `<resource>.<fieldName>.label`
|
|
173
|
+
- `<resource>.<fieldName>.<enumValue>` for each enum value
|
|
174
|
+
|
|
175
|
+
Use the existing project placement pattern or the future `wildo context` i18n
|
|
176
|
+
commands when they are available.
|
|
177
|
+
|
|
178
|
+
### Re-run Translation When Text Changes
|
|
179
|
+
|
|
180
|
+
If this work changes user-facing text, labels, descriptions, or enum-facing copy,
|
|
181
|
+
re-run the translation workflow before considering the task complete.
|
|
182
|
+
|
|
183
|
+
Use the project translation command/path that applies to the current app/module,
|
|
184
|
+
then verify that generated translation artifacts are updated consistently with
|
|
185
|
+
the source-language change.
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
### Step 7: Ship the column, if this application is on PostgreSQL
|
|
189
|
+
|
|
190
|
+
A new field is a new COLUMN, and on PostgreSQL nothing creates it implicitly —
|
|
191
|
+
the first write fails on a bare driver error, or the backend refuses to boot.
|
|
192
|
+
Check with `rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts`;
|
|
193
|
+
absent means MongoDB and there is nothing to do. Otherwise run
|
|
194
|
+
`wildo db generate --name add-<field>` and commit the migration folder together
|
|
195
|
+
with `schema-plan.lock.json` — see `application-database-migrations`.
|
|
196
|
+
|
|
197
|
+
Watch for the two field shapes whose physical half is easy to miss: a
|
|
198
|
+
`.default()` reaches the column as a `DEFAULT` that applies to NEW rows only
|
|
199
|
+
(existing rows keep their NULLs), and an `.isUnique()` becomes a unique index
|
|
200
|
+
that will REFUSE to apply over existing duplicates.
|
|
201
|
+
|
|
202
|
+
### Step 8: Verify the whole chain before declaring the work done
|
|
203
|
+
|
|
204
|
+
Confirm the field is now truthful across every surface you marked in Step 1.
|
|
205
|
+
An "add field" task is not done when only the schema compiles.
|
|
206
|
+
|
|
207
|
+
## References
|
|
208
|
+
|
|
209
|
+
- `examples/add-priority-field-to-todos.example.md` — worked end-to-end example
|
|
210
|
+
- `references/framework-field-cross-layer-api.md` — source-backed structural params + operation frontend config
|
|
211
|
+
|
|
212
|
+
For shared-layer API excerpts, load the `resource-schema-authoring` skill. For
|
|
213
|
+
frontend enum/display API excerpts, load the `resource-ui-behavior` skill.
|
|
214
|
+
|
|
215
|
+
## Verification
|
|
216
|
+
|
|
217
|
+
- [ ] The impacted surfaces were decided explicitly before editing
|
|
218
|
+
- [ ] Shared schema change is complete and structurally correct
|
|
219
|
+
- [ ] Config was reviewed when the field changes relationships, variants, or operation behavior
|
|
220
|
+
- [ ] User-facing fields have explicit frontend behavior
|
|
221
|
+
- [ ] Specification semantics were added when the field changes the business contract
|
|
222
|
+
- [ ] User-facing labels were added for the field and enum values when needed
|
|
223
|
+
- [ ] The task did not stop after the first file just because the schema compiled
|
|
224
|
+
|
|
225
|
+
### Grep invariants
|
|
226
|
+
|
|
227
|
+
These greps make the verification mechanical. Run from the app root and
|
|
228
|
+
substitute the new field name (`<field>`) and resource path:
|
|
229
|
+
|
|
230
|
+
| Invariant | Command |
|
|
231
|
+
|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
232
|
+
| The new field exists in the shared schema | `rg -n "^\s*<field>:\s" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
233
|
+
| User-facing field has explicit UI configuration (no silent defaults) | `rg -n "<field>:\s*sh\.<field>\." frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
234
|
+
| Enum field has per-value chrome (not a default rendering) | `rg -n "values:\s*\{" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx -A2` |
|
|
235
|
+
| Specification has matching field block | `rg -n "^\s*<field>:\s*schemaShape\.<field>\." specifications/src/modules/*/resources/<resource>.resource.specification.ts` |
|
|
236
|
+
| FK field has corresponding `isForeignKey()` decorator | `rg -n "<field>.*isForeignKey\(\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
|
|
237
|
+
| FK field has a registered relationship edge (the decorator marks, it does not resolve) | `rg -n "foreignKeyField: '<field>'" shared-lib/src/modules/*/resources/*.relationships.ts` |
|
|
238
|
+
| Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable | `rg -n "<field>" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \| rg "exclude(From|FromCreate\|FromUpdate)"` |
|
|
239
|
+
| Label keys exist in the primary locale | `rg -n "\"<resource>\.<field>\.(label\|<enumValue>)\"" frontend/src/i18n` |
|
|
240
|
+
|
|
241
|
+
If a user-facing field passes none of the UI / spec / label greps, the
|
|
242
|
+
work stopped after the schema and the task is **not done**.
|
|
243
|
+
|
|
244
|
+
## Common Rationalizations
|
|
245
|
+
|
|
246
|
+
| Rationalization | Reality |
|
|
247
|
+
|-----------------|---------|
|
|
248
|
+
| "The schema change is enough for now" | A real field addition changes the resource contract, not only one file. Stopping early creates drift. |
|
|
249
|
+
| "Defaults are fine for UI" | Default rendering may compile, but it usually does not express the intended product behavior. |
|
|
250
|
+
| "This FK field is just an id string" | FK fields often change config, relationship behavior, specs, and user-facing flows. |
|
|
251
|
+
| "`.isForeignKey()` is set, the FK work is done" | The decorator marks the field; resolution needs a `createResourcesRelationship` edge with `foreignKeyField: '<field>'` in the module's `*.relationships.ts` (see the `module-relationships` skill). Without it the app's FRONTEND registry refuses to initialize (`frontend_fk_resolution_failed`) while typecheck and the backend both stay green. |
|
|
252
|
+
| "I can skip labels until later" | Missing labels are visible product defects, not invisible cleanup work. |
|
|
253
|
+
| "This technical field means no follow-up at all" | Technical fields may still affect config, specs, or server-managed lifecycle rules. |
|
|
254
|
+
|
|
255
|
+
## Red Flags
|
|
256
|
+
|
|
257
|
+
- The field exists in `*.schemas.ts` but nowhere else despite being user-facing
|
|
258
|
+
- An enum field was added without explicit enum UI and enum labels
|
|
259
|
+
- A FK field was added without config review
|
|
260
|
+
- A FK field was added with `.isForeignKey()` but no relationship edge (catch with the **registered relationship edge** grep above — the failure is runtime-only: `frontend_fk_resolution_failed` at first page load)
|
|
261
|
+
- The task is called "add field" but no specification review happened
|
|
262
|
+
- The work was declared done because TypeScript passed in one package
|
|
263
|
+
|
|
264
|
+
## Related Skills
|
|
265
|
+
|
|
266
|
+
- `application-database-migrations` — Step 7, on PostgreSQL-backed applications
|
|
267
|
+
|
|
268
|
+
- `resource-schema-authoring` — shared-layer schema work
|
|
269
|
+
- `resource-config-wiring` — relationship/operation/config follow-up
|
|
270
|
+
- `resource-ui-behavior` — display/edit behavior
|
|
271
|
+
- `spec-update-after-change` — specification follow-up
|
|
272
|
+
- `i18n-rerun-pipeline` — translation and label workflow
|