@wildo-ai/framework-knowledge 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,534 @@
|
|
|
1
|
+
# presets.models.surface-policy
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/presets-components-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Application-facing Surface Policy contract.
|
|
14
|
+
*
|
|
15
|
+
* Import policy types and `SurfaceVariant` from `@wildo-ai/presets-components-models`.
|
|
16
|
+
* Use `DeepPartialSurfacePolicy` for app-level `designSystemConfig.surfacePolicies`
|
|
17
|
+
* overrides and for local `<Surface policyOverride={...}>` overrides. A policy is
|
|
18
|
+
* grouped by families (`containment`, `nesting`, `a11y`, etc.) so app code can
|
|
19
|
+
* override one slot without replacing sibling behavior.
|
|
20
|
+
*
|
|
21
|
+
* `reset` means "return this slot to the framework default for the current
|
|
22
|
+
* `SurfaceVariant`". `inherit` is only available on selected slots whose
|
|
23
|
+
* behavior can safely walk up from a parent surface.
|
|
24
|
+
*/
|
|
25
|
+
/** Generic policy escape hatch for reset-capable slots. */
|
|
26
|
+
export type PolicyReset = 'reset';
|
|
27
|
+
|
|
28
|
+
// --- Family A: Containment ---------------------------------------------------
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Semantic padding tier mapping to `--sp-*` tokens.
|
|
32
|
+
*
|
|
33
|
+
* `'none'` → no padding (recipe / consumer owns it)
|
|
34
|
+
* `'field'`, `'card-sm'`, `'card'`, `'container'` → corresponding `--sp-*` token
|
|
35
|
+
*/
|
|
36
|
+
export type ContainmentPaddingTier = 'none' | 'field' | 'card-sm' | 'card' | 'container';
|
|
37
|
+
|
|
38
|
+
export type OverflowStrategy = 'visible' | 'clip' | 'auto' | 'scroll';
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Semantic gap tier — applies to flex/grid container of `Surface.Body`'s direct
|
|
42
|
+
* children. Maps to `--sp-*` tokens.
|
|
43
|
+
*/
|
|
44
|
+
export type GapTier = 'none' | 'item' | 'field' | 'section' | 'lane';
|
|
45
|
+
|
|
46
|
+
type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
|
|
47
|
+
type NonZeroDigit = Exclude<Digit, '0'>;
|
|
48
|
+
type CssLengthUnit =
|
|
49
|
+
| 'px'
|
|
50
|
+
| 'rem'
|
|
51
|
+
| 'em'
|
|
52
|
+
| 'ch'
|
|
53
|
+
| 'ex'
|
|
54
|
+
| 'lh'
|
|
55
|
+
| 'rlh'
|
|
56
|
+
| 'vw'
|
|
57
|
+
| 'vh'
|
|
58
|
+
| 'vmin'
|
|
59
|
+
| 'vmax'
|
|
60
|
+
| 'svw'
|
|
61
|
+
| 'svh'
|
|
62
|
+
| 'lvw'
|
|
63
|
+
| 'lvh'
|
|
64
|
+
| 'dvw'
|
|
65
|
+
| 'dvh'
|
|
66
|
+
| '%'
|
|
67
|
+
| 'cqw'
|
|
68
|
+
| 'cqh'
|
|
69
|
+
| 'cqi'
|
|
70
|
+
| 'cqb'
|
|
71
|
+
| 'cqmin'
|
|
72
|
+
| 'cqmax';
|
|
73
|
+
type CssMaxHeightKeyword =
|
|
74
|
+
| 'inherit'
|
|
75
|
+
| 'initial'
|
|
76
|
+
| 'revert'
|
|
77
|
+
| 'revert-layer'
|
|
78
|
+
| 'unset'
|
|
79
|
+
| 'min-content'
|
|
80
|
+
| 'max-content'
|
|
81
|
+
| 'fit-content';
|
|
82
|
+
type CssSizingFunction = 'var' | 'calc' | 'clamp' | 'min' | 'max' | 'fit-content';
|
|
83
|
+
type CssNonNegativeNumber = `${Digit}${string}` | `.${Digit}${string}`;
|
|
84
|
+
export type CssMaxHeightValue =
|
|
85
|
+
| 'none'
|
|
86
|
+
| CssMaxHeightKeyword
|
|
87
|
+
| '0'
|
|
88
|
+
| `${CssNonNegativeNumber}${CssLengthUnit}`
|
|
89
|
+
| `${CssSizingFunction}(${string})`;
|
|
90
|
+
type PositiveLineClamp =
|
|
91
|
+
| `${NonZeroDigit}`
|
|
92
|
+
| `${NonZeroDigit}${Digit}`
|
|
93
|
+
| `${NonZeroDigit}${Digit}${Digit}`
|
|
94
|
+
| `${NonZeroDigit}${Digit}${Digit}${Digit}`;
|
|
95
|
+
|
|
96
|
+
export interface ContainmentPolicy {
|
|
97
|
+
/** Inner Y-axis padding tier (semantic, maps to `--sp-*`). */
|
|
98
|
+
paddingBlock?: ContainmentPaddingTier | PolicyReset;
|
|
99
|
+
/**
|
|
100
|
+
* Inner X-axis padding tier — separate from Y because `Card` today uses
|
|
101
|
+
* `py-card` (Y) on root + `px-card` per slot, and `Surface.Header/Body/Footer`
|
|
102
|
+
* often need different inline padding from their parent.
|
|
103
|
+
*/
|
|
104
|
+
paddingInline?: ContainmentPaddingTier | PolicyReset;
|
|
105
|
+
/** Overflow strategy on the surface root. */
|
|
106
|
+
overflow?: OverflowStrategy | PolicyReset;
|
|
107
|
+
/** Max-height as a validated CSS sizing value (e.g. `'90vh'`, `'60vh'`) or `'none'`. */
|
|
108
|
+
maxHeight?: CssMaxHeightValue | PolicyReset;
|
|
109
|
+
/** Gap when surface body is a flex/stack container. */
|
|
110
|
+
gap?: GapTier | PolicyReset;
|
|
111
|
+
/**
|
|
112
|
+
* Per-slot override of `gap` for `Surface.Header` / `Surface.Body` /
|
|
113
|
+
* `Surface.Footer` (Dialog needs `gap-element` in Header but `gap-field` in
|
|
114
|
+
* root, etc.).
|
|
115
|
+
*/
|
|
116
|
+
slotGap?: Partial<{ header: GapTier | PolicyReset; body: GapTier | PolicyReset; footer: GapTier | PolicyReset }>;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
// --- Family B: Nesting -------------------------------------------------------
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Whether this surface should render its visual frame (border/shadow).
|
|
123
|
+
*
|
|
124
|
+
* `'always'`: always render the frame.
|
|
125
|
+
* `'when-orphan'`: render the frame only when no ancestor surface is itself
|
|
126
|
+
* framed — replaces `last:border-b-0` patches and double-border bugs.
|
|
127
|
+
* Resolved from derived frame ancestry state.
|
|
128
|
+
* `'never'`: never render the frame (chromaless surfaces — SHELL, TAB_PANEL).
|
|
129
|
+
*/
|
|
130
|
+
export type FramingMode = 'always' | 'when-orphan' | 'never';
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* How nested surface corners scale relative to their parent's radius.
|
|
134
|
+
*
|
|
135
|
+
* `'inherit'`: child uses parent's resolved radius value.
|
|
136
|
+
* `'one-tier-tighter'`: child auto-shrinks one step on the radius scale (matches
|
|
137
|
+
* most material/shadcn conventions; concentric corners).
|
|
138
|
+
* `'fixed'`: child uses its own variant's radius regardless of parent
|
|
139
|
+
* (Brutalist/Trading where radius is constant or 0).
|
|
140
|
+
*/
|
|
141
|
+
export type NestedRadiusStrategy = 'inherit' | 'one-tier-tighter' | 'fixed';
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* When this surface sits at its parent's edge, drop the duplicate edge.
|
|
145
|
+
*
|
|
146
|
+
* `'collapse'`: remove the duplicate edge (e.g. child's top border collapses
|
|
147
|
+
* into parent's top border).
|
|
148
|
+
* `'preserve'`: keep both edges (gap/separator handles the visual).
|
|
149
|
+
*/
|
|
150
|
+
export type FirstChildEdgeStrategy = 'collapse' | 'preserve';
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* How repeated children of this surface visually separate themselves.
|
|
154
|
+
* Replaces ad-hoc `last:border-b-0` / `[&_tr:last-child]:border-0` patches.
|
|
155
|
+
*/
|
|
156
|
+
export type DividerStrategy = 'border' | 'gap' | 'rule' | 'none';
|
|
157
|
+
|
|
158
|
+
export interface NestingPolicy {
|
|
159
|
+
framingMode?: FramingMode | PolicyReset;
|
|
160
|
+
nestedRadiusStrategy?: NestedRadiusStrategy | PolicyReset;
|
|
161
|
+
firstChildEdgeStrategy?: FirstChildEdgeStrategy | PolicyReset;
|
|
162
|
+
dividerStrategy?: DividerStrategy | PolicyReset;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// --- Family C: Content -------------------------------------------------------
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* How long text inside this surface should clip.
|
|
169
|
+
*
|
|
170
|
+
* `'ellipsis-multiline:N'` is parameterized — pick a positive integer from
|
|
171
|
+
* 1 through 9999 (e.g. `'ellipsis-multiline:2'` for 2-line truncate). The
|
|
172
|
+
* generated CSS / `<Text>` consumer maps the parameter to
|
|
173
|
+
* `-webkit-line-clamp: N`.
|
|
174
|
+
*/
|
|
175
|
+
export type TextTruncationStrategy =
|
|
176
|
+
| 'none'
|
|
177
|
+
| 'ellipsis-line'
|
|
178
|
+
| `ellipsis-multiline:${PositiveLineClamp}`
|
|
179
|
+
| 'fade'
|
|
180
|
+
| 'inherit';
|
|
181
|
+
|
|
182
|
+
/** CSS `text-wrap` strategy. */
|
|
183
|
+
export type WrapStrategy = 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'inherit';
|
|
184
|
+
|
|
185
|
+
/** `font-variant-numeric` — for tables/dashboards of numbers. */
|
|
186
|
+
export type NumericAlignment = 'inherit' | 'tabular' | 'lining';
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* Behavior when an INDIVIDUAL TOKEN (a single word, URL, file path, hex
|
|
190
|
+
* hash, dev-time i18n key, …) is wider than the surface it lives in.
|
|
191
|
+
*
|
|
192
|
+
* This is a DIFFERENT problem from `textTruncation` / `wrapStrategy`:
|
|
193
|
+
*
|
|
194
|
+
* - `wrapStrategy: 'wrap'` (CSS `text-wrap: wrap`) breaks text ONLY at
|
|
195
|
+
* natural word boundaries (spaces, hyphens). An unbreakable token has
|
|
196
|
+
* no boundary, so the browser lets it overflow the container.
|
|
197
|
+
* - `textTruncation: 'ellipsis-line'` / `'ellipsis-multiline:N'` clip
|
|
198
|
+
* text that exceeds N lines — but they require `overflow: hidden` on
|
|
199
|
+
* the container and assume the line itself FITS. A token wider than
|
|
200
|
+
* the container can't even produce one valid line to truncate.
|
|
201
|
+
* - `overlongTokenStrategy` covers the residual case: what to do when
|
|
202
|
+
* a SINGLE TOKEN can't fit. Three real options:
|
|
203
|
+
* - `'break-word'` — CSS `overflow-wrap: break-word`. Lets the
|
|
204
|
+
* browser break at character boundaries ONLY when a token would
|
|
205
|
+
* otherwise overflow, exactly like `'break-anywhere'` at render
|
|
206
|
+
* time — but soft-wrap opportunities are NOT considered when
|
|
207
|
+
* computing intrinsic (min-content) sizes. This is the framework
|
|
208
|
+
* default: it protects against URLs, dev-time i18n keys, file
|
|
209
|
+
* paths and hex strings WITHOUT shrinking a flex/grid item's
|
|
210
|
+
* min-content width to a single character.
|
|
211
|
+
* - `'break-anywhere'` — CSS `overflow-wrap: anywhere`. Same
|
|
212
|
+
* emergency character-boundary breaking, but the break
|
|
213
|
+
* opportunities ALSO feed min-content sizing: any surface under
|
|
214
|
+
* this value reports a one-character min-content width, so
|
|
215
|
+
* intrinsically-sized layouts (stat tiles, grid `auto` tracks,
|
|
216
|
+
* `min-width: min-content` flex items) collapse and render one
|
|
217
|
+
* letter per line. An earlier revision made this the default on
|
|
218
|
+
* the reasoning that "normal text is unaffected" — true for
|
|
219
|
+
* OVERFLOW behavior, false for INTRINSIC SIZING, which is why
|
|
220
|
+
* the default moved to `'break-word'`. Opt in per-surface only
|
|
221
|
+
* when unbroken user-generated strings must never dictate the
|
|
222
|
+
* measured width of an intrinsically-sized container.
|
|
223
|
+
* - `'overflow'` — CSS `overflow-wrap: normal`. The browser-default
|
|
224
|
+
* behavior: long tokens visibly overflow the container. Useful
|
|
225
|
+
* when the surface intentionally allows horizontal overflow
|
|
226
|
+
* (e.g., a code block that scrolls) or when the design
|
|
227
|
+
* specifically calls for the overflow to be visible.
|
|
228
|
+
*
|
|
229
|
+
* Default is `'break-word'` for every variant — same wrapping outcome
|
|
230
|
+
* as `'break-anywhere'` where a token genuinely overflows, with no
|
|
231
|
+
* min-content collapse. Surfaces opt into the other behaviors
|
|
232
|
+
* explicitly via `policyOverride={{ content: { overlongTokenStrategy:
|
|
233
|
+
* 'break-anywhere' | 'overflow' } }}`.
|
|
234
|
+
*/
|
|
235
|
+
/**
|
|
236
|
+
* The named runtime source for the overlong-token vocabulary (see the JSDoc above for the full
|
|
237
|
+
* per-member semantics and the min-content-collapse history that fixed the default).
|
|
238
|
+
*
|
|
239
|
+
* A const object rather than a TypeScript enum, deliberately: surface authoring writes these as
|
|
240
|
+
* plain string literals throughout the preset layer (`policyOverride={{ content: {
|
|
241
|
+
* overlongTokenStrategy: 'break-anywhere' } }}`), and a nominal enum would refuse every one of
|
|
242
|
+
* those call sites. The derived type below keeps the union structural while this object gives the
|
|
243
|
+
* vocabulary one named home.
|
|
244
|
+
*/
|
|
245
|
+
export const OverlongTokenStrategy = {
|
|
246
|
+
/** CSS `overflow-wrap: break-word` — emergency breaking without min-content collapse. The default. */
|
|
247
|
+
BREAK_WORD: 'break-word',
|
|
248
|
+
/** CSS `overflow-wrap: anywhere` — also feeds min-content sizing; opt-in per surface only. */
|
|
249
|
+
BREAK_ANYWHERE: 'break-anywhere',
|
|
250
|
+
/** CSS `overflow-wrap: normal` — long tokens visibly overflow (scrolling code blocks etc.). */
|
|
251
|
+
OVERFLOW: 'overflow',
|
|
252
|
+
/** Inherit the surrounding surface's strategy. */
|
|
253
|
+
INHERIT: 'inherit',
|
|
254
|
+
} as const;
|
|
255
|
+
|
|
256
|
+
export type OverlongTokenStrategy = (typeof OverlongTokenStrategy)[keyof typeof OverlongTokenStrategy];
|
|
257
|
+
|
|
258
|
+
export interface ContentPolicy {
|
|
259
|
+
textTruncation?: TextTruncationStrategy | PolicyReset;
|
|
260
|
+
wrapStrategy?: WrapStrategy | PolicyReset;
|
|
261
|
+
numericAlignment?: NumericAlignment | PolicyReset;
|
|
262
|
+
/** Auto-wire `TruncatedText` semantics so truncated text shows full value on hover. */
|
|
263
|
+
tooltipOnTruncate?: boolean | PolicyReset;
|
|
264
|
+
/**
|
|
265
|
+
* Safety net for unbreakable tokens wider than the surface (URLs,
|
|
266
|
+
* dev-time i18n keys, file paths, hex strings). Default
|
|
267
|
+
* `'break-word'` (emergency breaking without min-content collapse).
|
|
268
|
+
* See `OverlongTokenStrategy` JSDoc for the relationship with
|
|
269
|
+
* `wrapStrategy` and `textTruncation`, and for when
|
|
270
|
+
* `'break-anywhere'` is the right opt-in.
|
|
271
|
+
*/
|
|
272
|
+
overlongTokenStrategy?: OverlongTokenStrategy | PolicyReset;
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
// --- Family D: Auto-render ---------------------------------------------------
|
|
276
|
+
|
|
277
|
+
export type AutoFieldChromeMode = 'stacked' | 'inline' | 'compact' | 'inherit';
|
|
278
|
+
/**
|
|
279
|
+
* Field label placement. `start` is logical inline-start and follows document
|
|
280
|
+
* direction.
|
|
281
|
+
*/
|
|
282
|
+
export type AutoLabelPlacement = 'top' | 'start' | 'inline' | 'hidden';
|
|
283
|
+
export type AutoEmptyValue = 'em-dash' | 'placeholder' | 'hidden' | 'skeleton';
|
|
284
|
+
/**
|
|
285
|
+
* How a `ContentSectionContainer` frames each authored section.
|
|
286
|
+
* - `grouped` (modern default): eyebrow-labelled groups inside ONE surface,
|
|
287
|
+
* separated by `divide-y` — no bordered card per section. Applies to the
|
|
288
|
+
* stacked (inline / single-section) composition; other container modes
|
|
289
|
+
* (grid / tabs / …) treat it as `card-each`.
|
|
290
|
+
* - `card-each`: a bordered card per section.
|
|
291
|
+
* - `flat`: bare sections, no frame.
|
|
292
|
+
* - `separator-only`: bare sections with a bottom divider between them.
|
|
293
|
+
*/
|
|
294
|
+
export type AutoSectionWrap = 'grouped' | 'card-each' | 'flat' | 'separator-only';
|
|
295
|
+
export type AutoFieldDensity = 'sm' | 'md' | 'inherit';
|
|
296
|
+
/** Where field validation errors render. */
|
|
297
|
+
export type AutoErrorPlacement =
|
|
298
|
+
| 'inline'
|
|
299
|
+
| 'summary-at-surface-top'
|
|
300
|
+
| 'inherit';
|
|
301
|
+
|
|
302
|
+
export interface AutoRenderPolicy {
|
|
303
|
+
autoFieldChrome?: AutoFieldChromeMode | PolicyReset;
|
|
304
|
+
autoLabelPlacement?: AutoLabelPlacement | PolicyReset;
|
|
305
|
+
autoEmptyValue?: AutoEmptyValue | PolicyReset;
|
|
306
|
+
autoSectionWrap?: AutoSectionWrap | PolicyReset;
|
|
307
|
+
autoFieldDensity?: AutoFieldDensity | PolicyReset;
|
|
308
|
+
autoErrorPlacement?: AutoErrorPlacement | PolicyReset;
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
// --- Family E: Interactive state --------------------------------------------
|
|
312
|
+
|
|
313
|
+
export type SelectableSemantics = 'wrap-children' | 'self-selectable' | 'forbidden';
|
|
314
|
+
export type GestureOptIn = 'self' | 'children' | 'none';
|
|
315
|
+
export type LoadingDisplayMode = 'overlay' | 'skeleton-children' | 'spinner-only' | 'inherit';
|
|
316
|
+
export type EmptyDisplayMode = 'collapse' | 'placeholder' | 'hide' | 'render-children';
|
|
317
|
+
export type ErrorBoundaryMode = 'self' | 'inherit';
|
|
318
|
+
|
|
319
|
+
export interface InteractiveStatePolicy {
|
|
320
|
+
selectableSemantics?: SelectableSemantics | PolicyReset;
|
|
321
|
+
gestureOptIn?: GestureOptIn | PolicyReset;
|
|
322
|
+
loadingDisplay?: LoadingDisplayMode | PolicyReset;
|
|
323
|
+
emptyDisplay?: EmptyDisplayMode | PolicyReset;
|
|
324
|
+
errorBoundary?: ErrorBoundaryMode | PolicyReset;
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
// --- Family F: A11y ----------------------------------------------------------
|
|
328
|
+
|
|
329
|
+
export type LandmarkRole =
|
|
330
|
+
| 'region'
|
|
331
|
+
| 'complementary'
|
|
332
|
+
| 'navigation'
|
|
333
|
+
| 'main'
|
|
334
|
+
| 'dialog'
|
|
335
|
+
| 'alertdialog'
|
|
336
|
+
| 'status'
|
|
337
|
+
| 'none';
|
|
338
|
+
|
|
339
|
+
export type LabelStrategy = 'from-header' | 'aria-label' | 'none';
|
|
340
|
+
export type FocusTrapMode = 'on-mount' | 'never' | 'when-modal';
|
|
341
|
+
export type ScrollContainmentMode = 'lock-body' | 'none';
|
|
342
|
+
|
|
343
|
+
export interface A11yPolicy {
|
|
344
|
+
/**
|
|
345
|
+
* Auto-applied `role` if no `role` prop supplied.
|
|
346
|
+
*
|
|
347
|
+
* `SurfaceVariant.SHELL` defaults to `'none'` so framework upgrades do not
|
|
348
|
+
* create duplicate page landmarks. Apps that want the shell to own the page
|
|
349
|
+
* landmark opt in with `surfacePolicies[SurfaceVariant.SHELL].a11y.landmarkRole = 'main'`.
|
|
350
|
+
*/
|
|
351
|
+
landmarkRole?: LandmarkRole | PolicyReset;
|
|
352
|
+
/**
|
|
353
|
+
* Surface auto-derives `aria-labelledby` from `<Surface.Header>` slot.
|
|
354
|
+
* Fallback when `'from-header'` and no Header is present: → use explicit
|
|
355
|
+
* `aria-label` prop if provided → no labelling at all + development warning.
|
|
356
|
+
*/
|
|
357
|
+
labelStrategy?: LabelStrategy | PolicyReset;
|
|
358
|
+
focusTrap?: FocusTrapMode | PolicyReset;
|
|
359
|
+
scrollContainment?: ScrollContainmentMode | PolicyReset;
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
// --- Family G: Geometry / responsive -----------------------------------------
|
|
363
|
+
|
|
364
|
+
/**
|
|
365
|
+
* Maximum inline-size a surface may occupy on viewports ≥ 640px (below that,
|
|
366
|
+
* surfaces are always full-width). Component-scale tiers (`sm`–`xl`) suit
|
|
367
|
+
* dialogs and forms; `centered-readable` (72ch) suits prose columns; `content`
|
|
368
|
+
* is the page-content cap for primary content areas (defaults to 80rem ≈ 1280px;
|
|
369
|
+
* retune by setting the `--content-max-width` CSS variable, or `full`/`none` to
|
|
370
|
+
* disable). When a finite tier is set the surface is also centered in its
|
|
371
|
+
* container (`margin-inline: auto`).
|
|
372
|
+
*/
|
|
373
|
+
export type ResponsiveMaxWidth =
|
|
374
|
+
| 'full'
|
|
375
|
+
| 'sm'
|
|
376
|
+
| 'md'
|
|
377
|
+
| 'lg'
|
|
378
|
+
| 'xl'
|
|
379
|
+
// Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
|
|
380
|
+
// so detail/settings forms stop stretching edge-to-edge inside a wide content
|
|
381
|
+
// zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
|
|
382
|
+
// than `content`/`centered-readable`. Retune via `--measure-max-width`.
|
|
383
|
+
| 'measure'
|
|
384
|
+
| 'centered-readable'
|
|
385
|
+
| 'content'
|
|
386
|
+
| 'none';
|
|
387
|
+
|
|
388
|
+
export type MobileShape = 'inline' | 'drawer' | 'sheet';
|
|
389
|
+
|
|
390
|
+
export type ActionAlignment = 'row' | 'column-reverse-on-mobile' | 'stack' | 'inherit';
|
|
391
|
+
|
|
392
|
+
export interface GeometryPolicy {
|
|
393
|
+
responsiveMaxWidth?: ResponsiveMaxWidth | PolicyReset;
|
|
394
|
+
mobileShape?: MobileShape | PolicyReset;
|
|
395
|
+
/** Apply iOS safe-area / Android nav-bar padding to fixed-edge surfaces. */
|
|
396
|
+
safeAreaPadding?: boolean | PolicyReset;
|
|
397
|
+
actionAlignment?: ActionAlignment | PolicyReset;
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
// --- Family H: Stacking / portal ---------------------------------------------
|
|
401
|
+
|
|
402
|
+
/**
|
|
403
|
+
* Maps to the public `--z-*` token ladder.
|
|
404
|
+
* Replaces `z-50` literals + `z-[10000]` magic numbers.
|
|
405
|
+
*
|
|
406
|
+
* `'content'` → `--z-content` (alias of `--z-base`)
|
|
407
|
+
* `'overlay'` → `--z-overlay`
|
|
408
|
+
* `'transient'` → `--z-transient` (alias of `--z-toast`)
|
|
409
|
+
* `'guidance'` → `--z-guidance` (sits above transient and below critical)
|
|
410
|
+
* `'critical'` → `--z-critical` (alias of `--z-tooltip`)
|
|
411
|
+
*
|
|
412
|
+
* Token ladder ordering: content < overlay < transient < guidance < critical.
|
|
413
|
+
*/
|
|
414
|
+
export type StackingTier = 'content' | 'overlay' | 'transient' | 'guidance' | 'critical';
|
|
415
|
+
|
|
416
|
+
/**
|
|
417
|
+
* Named portal target consumed by framework overlay primitives.
|
|
418
|
+
*
|
|
419
|
+
* `'inline'`: render in place (no portal).
|
|
420
|
+
* `'app-portal'`: the app's default portal target.
|
|
421
|
+
* `custom-id`: a lowercase kebab-case custom portal id that starts with a
|
|
422
|
+
* letter, such as `resource-overlay-root`. The runtime validator enforces the
|
|
423
|
+
* full `/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/` shape.
|
|
424
|
+
*/
|
|
425
|
+
type LowercaseAsciiLetter =
|
|
426
|
+
| 'a'
|
|
427
|
+
| 'b'
|
|
428
|
+
| 'c'
|
|
429
|
+
| 'd'
|
|
430
|
+
| 'e'
|
|
431
|
+
| 'f'
|
|
432
|
+
| 'g'
|
|
433
|
+
| 'h'
|
|
434
|
+
| 'i'
|
|
435
|
+
| 'j'
|
|
436
|
+
| 'k'
|
|
437
|
+
| 'l'
|
|
438
|
+
| 'm'
|
|
439
|
+
| 'n'
|
|
440
|
+
| 'o'
|
|
441
|
+
| 'p'
|
|
442
|
+
| 'q'
|
|
443
|
+
| 'r'
|
|
444
|
+
| 's'
|
|
445
|
+
| 't'
|
|
446
|
+
| 'u'
|
|
447
|
+
| 'v'
|
|
448
|
+
| 'w'
|
|
449
|
+
| 'x'
|
|
450
|
+
| 'y'
|
|
451
|
+
| 'z';
|
|
452
|
+
// Keep the authoring type intentionally light: full kebab-case validation lives
|
|
453
|
+
// in `isPortalTargetValue`, where parsed app configs are checked at runtime.
|
|
454
|
+
export type CustomPortalTarget = `${LowercaseAsciiLetter}${string}-${string}`;
|
|
455
|
+
export type PortalTarget = 'inline' | 'app-portal' | CustomPortalTarget;
|
|
456
|
+
|
|
457
|
+
export interface StackingPolicy {
|
|
458
|
+
stackingTier?: StackingTier | PolicyReset;
|
|
459
|
+
portalTarget?: PortalTarget | PolicyReset;
|
|
460
|
+
}
|
|
461
|
+
|
|
462
|
+
// --- Family I: Skeleton / loading shape -------------------------------------
|
|
463
|
+
|
|
464
|
+
export type SkeletonTemplate = 'list' | 'detail' | 'table' | 'card' | 'inherit' | 'none';
|
|
465
|
+
export type SkeletonDensity = 'sm' | 'md' | 'lg' | 'inherit';
|
|
466
|
+
|
|
467
|
+
export interface SkeletonPolicy {
|
|
468
|
+
skeletonTemplate?: SkeletonTemplate | PolicyReset;
|
|
469
|
+
/** Skeleton row size — can inherit from the nearest parent surface. */
|
|
470
|
+
skeletonDensity?: SkeletonDensity | PolicyReset;
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
// --- Family J: Composition awareness -----------------------------------------
|
|
474
|
+
|
|
475
|
+
export type EmbeddedTablePadding = 'strip' | 'preserve';
|
|
476
|
+
|
|
477
|
+
export interface CompositionPolicy {
|
|
478
|
+
/** Surface auto-tightens spacing when it contains a Table or DataGrid. */
|
|
479
|
+
childAdaptiveDensity?: boolean | PolicyReset;
|
|
480
|
+
/**
|
|
481
|
+
* Card-with-Table drops its own padding-inline so table can go edge-to-edge.
|
|
482
|
+
*
|
|
483
|
+
* `'strip'`: drop the inline padding.
|
|
484
|
+
* `'preserve'`: keep the inline padding (table sits inside the card box).
|
|
485
|
+
*/
|
|
486
|
+
embeddedTablePadding?: EmbeddedTablePadding | PolicyReset;
|
|
487
|
+
/**
|
|
488
|
+
* Apply `[&:has([role=checkbox])]:pe-0` style behavior to first cell —
|
|
489
|
+
* declarative replacement for the `:has()` Tailwind utility currently
|
|
490
|
+
* used in `field.tsx`/`table.tsx`.
|
|
491
|
+
*
|
|
492
|
+
* `'inherit'`: nested tables share the "first cell is checkbox" assumption.
|
|
493
|
+
*/
|
|
494
|
+
selectionColumnAware?: boolean | 'inherit' | PolicyReset;
|
|
495
|
+
}
|
|
496
|
+
|
|
497
|
+
// =============================================================================
|
|
498
|
+
// SurfacePolicy + DeepPartial
|
|
499
|
+
// =============================================================================
|
|
500
|
+
|
|
501
|
+
/**
|
|
502
|
+
* Container-level policy for a `SurfaceVariant`. Ten sparse sub-objects
|
|
503
|
+
* ("families") separate concerns so an app can override one slot of one family
|
|
504
|
+
* without touching siblings.
|
|
505
|
+
*/
|
|
506
|
+
export interface SurfacePolicy {
|
|
507
|
+
containment?: ContainmentPolicy;
|
|
508
|
+
nesting?: NestingPolicy;
|
|
509
|
+
content?: ContentPolicy;
|
|
510
|
+
autoRender?: AutoRenderPolicy;
|
|
511
|
+
interactiveState?: InteractiveStatePolicy;
|
|
512
|
+
a11y?: A11yPolicy;
|
|
513
|
+
geometry?: GeometryPolicy;
|
|
514
|
+
stacking?: StackingPolicy;
|
|
515
|
+
skeleton?: SkeletonPolicy;
|
|
516
|
+
composition?: CompositionPolicy;
|
|
517
|
+
}
|
|
518
|
+
|
|
519
|
+
/**
|
|
520
|
+
* Per-family partial used for `designSystemConfig.surfacePolicies` overrides
|
|
521
|
+
* and for `<Surface policyOverride>`.
|
|
522
|
+
*
|
|
523
|
+
* Each policy family object is itself partial. Omitted families and omitted
|
|
524
|
+
* slots leave lower-precedence values in place. If a slot key is present with
|
|
525
|
+
* `undefined`, merge helpers treat that as an explicit clear for that leaf.
|
|
526
|
+
*/
|
|
527
|
+
export type DeepPartialSurfacePolicy = {
|
|
528
|
+
[K in keyof SurfacePolicy]?: SurfacePolicy[K] extends infer Sub
|
|
529
|
+
? Sub extends object
|
|
530
|
+
? { [P in keyof Sub]?: Sub[P] }
|
|
531
|
+
: Sub
|
|
532
|
+
: never;
|
|
533
|
+
};
|
|
534
|
+
```
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# presets.models.surface-variant
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/presets-components-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Semantic variants for SURFACE behavior.
|
|
14
|
+
*
|
|
15
|
+
* Import `SurfaceVariant` from `@wildo-ai/presets-components-models`.
|
|
16
|
+
* Use these enum values as keys for `theme.surface` recipe maps and
|
|
17
|
+
* `designSystemConfig.surfacePolicies`. Do not confuse this with `SurfaceLayer`,
|
|
18
|
+
* which is only the semantic background-color token family.
|
|
19
|
+
*
|
|
20
|
+
* Each variant maps to (a) a recipe of visual chrome classes (`theme.surface[variant]`)
|
|
21
|
+
* AND (b) a `SurfacePolicy` defining container-level behavior such as padding,
|
|
22
|
+
* overflow, frame ownership, landmark role, stacking, and overlay geometry.
|
|
23
|
+
*
|
|
24
|
+
* Every `ComponentStyleTheme.surface` map is strict: provide a recipe for each
|
|
25
|
+
* variant, even when the recipe is intentionally chromeless.
|
|
26
|
+
*/
|
|
27
|
+
export enum SurfaceVariant {
|
|
28
|
+
/** Default card-like surface */
|
|
29
|
+
BASE = 'base',
|
|
30
|
+
/**
|
|
31
|
+
* Content card — an explicitly-authored content grouping that ALWAYS paints
|
|
32
|
+
* its own elevated fill + border (distinct from the page background), so it
|
|
33
|
+
* reads as a card in every context, including inside a dialog or page. Unlike
|
|
34
|
+
* `BASE`/`RAISED`, a `CARD` does NOT de-duplicate its frame when nested in an
|
|
35
|
+
* already-framed ancestor: the author chose a card, so it stays a card. The
|
|
36
|
+
* fill comes from the theme's CARD recipe (the elevated `surface-raised`
|
|
37
|
+
* token by default). Material is an independent design-system axis: choosing
|
|
38
|
+
* the CARD semantic role must never implicitly force a glass material.
|
|
39
|
+
*/
|
|
40
|
+
CARD = 'card',
|
|
41
|
+
/** Higher elevation — popovers, dropdowns */
|
|
42
|
+
RAISED = 'raised',
|
|
43
|
+
/** Modal/dialog surfaces */
|
|
44
|
+
OVERLAY = 'overlay',
|
|
45
|
+
/** Recessed areas — input wells */
|
|
46
|
+
INSET = 'inset',
|
|
47
|
+
/** Navigation panels, sidebars */
|
|
48
|
+
SUNKEN = 'sunken',
|
|
49
|
+
/** Panel under a tab strip — joins seamlessly to the strip above (no top edge). */
|
|
50
|
+
TAB_PANEL = 'tab-panel',
|
|
51
|
+
/** Page content area / app surface — chromeless background; may own `<main>` semantics after app opt-in. */
|
|
52
|
+
SHELL = 'shell',
|
|
53
|
+
/** Toast, snackbar, ephemeral floating notification. */
|
|
54
|
+
TRANSIENT = 'transient',
|
|
55
|
+
}
|
|
56
|
+
```
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# requirements.authored-metadata.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Optional per-entity authoring provenance attached to any requirements
|
|
14
|
+
* entity (a functional requirement, a non-functional requirement) — the
|
|
15
|
+
* requirements family's counterpart to `MarketAuthoredMetadataSchema` /
|
|
16
|
+
* `VisionAuthoredMetadataSchema`.
|
|
17
|
+
*
|
|
18
|
+
* Design decision (mirrors the vision / assertions families): this is a
|
|
19
|
+
* SIBLING schema, NOT a reshape of `market-authored-metadata.schemas.ts`.
|
|
20
|
+
* Promoting a shared `_core/authored-metadata` module is a `_core`
|
|
21
|
+
* reshape with the full blast-radius checklist across every market
|
|
22
|
+
* consumer — explicitly deferred. The market enums are already
|
|
23
|
+
* family-agnostic in name and meaning, so they are IMPORTED rather than
|
|
24
|
+
* duplicated (`AuthoredConfidence`, `ReviewCadence`): re-declaring either
|
|
25
|
+
* would silently drop it from the package-root barrel (ambiguous
|
|
26
|
+
* `export *` names are excluded), and hand-duplicated vocabularies drift.
|
|
27
|
+
*
|
|
28
|
+
* Three concerns are bundled here so consumers see them in one place:
|
|
29
|
+
*
|
|
30
|
+
* - **Confidence** — `LOW | MEDIUM | HIGH`. Drives prompt enrichment:
|
|
31
|
+
* AI surfaces emit "confidence LOW — early hypothesis, validate" when
|
|
32
|
+
* surfacing the entity to a model so it does not parrot speculative
|
|
33
|
+
* framing as fact. Kept OPTIONAL provenance here (market / vision
|
|
34
|
+
* posture), NOT a required top-level audit field (assertions posture):
|
|
35
|
+
* a requirements brief is authored by a product owner progressively,
|
|
36
|
+
* not audited by reconcile.
|
|
37
|
+
* - **Recency** — `lastAuthoredAt` ISO datetime + optional
|
|
38
|
+
* `reviewCadence`. The snapshot validator only flags `STALE_AUTHORED`
|
|
39
|
+
* when both are set (no cadence ⇒ no staleness check).
|
|
40
|
+
* - **Trace** — `reviewer` + `notes` carry the human accountability
|
|
41
|
+
* trail without leaking internal processes into the spec.
|
|
42
|
+
*
|
|
43
|
+
* Entirely optional: omit the block when authoring is so fresh and
|
|
44
|
+
* trivial that provenance adds noise.
|
|
45
|
+
*/
|
|
46
|
+
export const RequirementsAuthoredMetadataSchema = z.object({
|
|
47
|
+
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
48
|
+
lastAuthoredAt: z.iso.datetime(),
|
|
49
|
+
/** Author's self-assessed confidence in the current content. */
|
|
50
|
+
confidence: z.enum(AuthoredConfidence),
|
|
51
|
+
/**
|
|
52
|
+
* Cadence at which the entity should be re-reviewed. When set, the
|
|
53
|
+
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
54
|
+
* cadence < now`. When omitted, no staleness check runs (same
|
|
55
|
+
* semantics as the market / vision / assertions families).
|
|
56
|
+
*/
|
|
57
|
+
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
58
|
+
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
59
|
+
reviewer: NonEmptyStringSchema.optional(),
|
|
60
|
+
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
61
|
+
notes: NonEmptyStringSchema.optional(),
|
|
62
|
+
});
|
|
63
|
+
export type RequirementsAuthoredMetadata = z.infer<typeof RequirementsAuthoredMetadataSchema>;
|
|
64
|
+
```
|