@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,333 @@
|
|
|
1
|
+
# requirements.snapshot.validation
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Authoring-consistency validator for an assembled `RequirementsSnapshot`.
|
|
14
|
+
*
|
|
15
|
+
* The function is a **pure**, **typed** graph walker over the snapshot —
|
|
16
|
+
* no Zod introspection, no registry access, no I/O (the `_core`
|
|
17
|
+
* validator convention shared with `validateMarketSnapshot` /
|
|
18
|
+
* `validateVisionSnapshot` / `validateAssertionSpecificationSnapshot`).
|
|
19
|
+
* Zod already enforces structural validity (ref formats at parse time);
|
|
20
|
+
* this walker adds the cross-entity + completeness checks Zod cannot
|
|
21
|
+
* express, the defence-in-depth ref-format check for type-asserted
|
|
22
|
+
* fixtures that bypass parsing, and the fail-soft cross-family ICP/job
|
|
23
|
+
* ref resolution.
|
|
24
|
+
*
|
|
25
|
+
* Rule table — 7 kinds (scaffold depth, Phase J1 — deeper requirement
|
|
26
|
+
* quality / prioritization / dependency analysis is Phase J2):
|
|
27
|
+
*
|
|
28
|
+
* | Kind | Severity | Trigger |
|
|
29
|
+
* |-------------------------------|----------|--------------------------------------------------------------------------------|
|
|
30
|
+
* | `INVALID_REF_FORMAT` | ERROR | A functional / non-functional ref fails its shared pattern (single source of truth with the Zod schema). Defence in depth for type-asserted fixtures. |
|
|
31
|
+
* | `DUPLICATE_REF` | ERROR | Two functional (or two non-functional) requirements share a ref — the collection silently loses one entity to last-wins indexing. |
|
|
32
|
+
* | `DUPLICATE_CROSS_REF` | WARN | The same `icpRefs` (or `jobRefs`) entry is listed more than once on ONE requirement — the repeat is noise the catalog silently dedupes (or double-counts in coverage). Intra-snapshot, so it runs UNCONDITIONALLY (no external set needed) — mirrors the assertions family's `DUPLICATE_PIN_REF`. |
|
|
33
|
+
* | `NO_FUNCTIONAL_REQUIREMENTS` | WARN | `functional` empty — the requirements brief states no capability the product must provide. |
|
|
34
|
+
* | `STALE_AUTHORED` | WARN | Any entity's `authored.lastAuthoredAt + reviewCadence < now`. No check when `reviewCadence` is undefined or `AS_NEEDED`. |
|
|
35
|
+
* | `UNKNOWN_ICP_REF` | ERROR | An `icpRefs` entry does not resolve in `options.availableIcpRefs`. SKIPPED (fail-soft) when no set is passed — the families are decoupled and the catalog resolves refs. |
|
|
36
|
+
* | `UNKNOWN_JOB_REF` | ERROR | A `jobRefs` entry does not resolve in `options.availableJobRefs`. SKIPPED (fail-soft) when no set is passed. |
|
|
37
|
+
*
|
|
38
|
+
* Severity is a TS enum (project rule — enums over literal unions). The
|
|
39
|
+
* validator never mutates the snapshot. Issue ordering is detector-order
|
|
40
|
+
* then walk-order — NOT a stable contract; callers group/sort by `kind` +
|
|
41
|
+
* `severity` themselves.
|
|
42
|
+
*/
|
|
43
|
+
export enum RequirementsSnapshotIssueKind {
|
|
44
|
+
/**
|
|
45
|
+
* A functional / non-functional ref violates its kebab-case prefix
|
|
46
|
+
* contract. The Zod schema rejects this at parse time; the detector
|
|
47
|
+
* remains as defence in depth for callers that bypass parsing (tests
|
|
48
|
+
* building snapshots with type-asserted fixtures). ERROR.
|
|
49
|
+
*/
|
|
50
|
+
INVALID_REF_FORMAT = 'invalid_ref_format',
|
|
51
|
+
/**
|
|
52
|
+
* Two entities in the same collection share a ref. The collection is
|
|
53
|
+
* addressed by ref downstream, so a duplicate silently drops one
|
|
54
|
+
* entity. ERROR.
|
|
55
|
+
*/
|
|
56
|
+
DUPLICATE_REF = 'duplicate_ref',
|
|
57
|
+
/**
|
|
58
|
+
* The same ICP / job ref appears more than once on ONE requirement's
|
|
59
|
+
* cross-ref list. The repeat carries no meaning — the catalog dedupes
|
|
60
|
+
* it (or double-counts it in coverage). WARN, not ERROR: the
|
|
61
|
+
* requirement is still valid, the authoring is just untidy. Runs
|
|
62
|
+
* unconditionally (intra-snapshot, needs no external set) — mirrors
|
|
63
|
+
* the assertions family's `DUPLICATE_PIN_REF`.
|
|
64
|
+
*/
|
|
65
|
+
DUPLICATE_CROSS_REF = 'duplicate_cross_ref',
|
|
66
|
+
/** `functional` empty — the brief states no required capability (WARN). */
|
|
67
|
+
NO_FUNCTIONAL_REQUIREMENTS = 'no_functional_requirements',
|
|
68
|
+
/** `lastAuthoredAt + reviewCadence < now` (WARN — market/vision parity). */
|
|
69
|
+
STALE_AUTHORED = 'stale_authored',
|
|
70
|
+
/**
|
|
71
|
+
* An `icpRefs` entry does not resolve against the supplied ICP-ref set
|
|
72
|
+
* — a dangling cross-family reference. ERROR when a set is supplied;
|
|
73
|
+
* the whole check is SKIPPED (fail-soft) when it is not.
|
|
74
|
+
*/
|
|
75
|
+
UNKNOWN_ICP_REF = 'unknown_icp_ref',
|
|
76
|
+
/**
|
|
77
|
+
* A `jobRefs` entry does not resolve against the supplied job-ref set.
|
|
78
|
+
* ERROR when a set is supplied; SKIPPED (fail-soft) when it is not.
|
|
79
|
+
*/
|
|
80
|
+
UNKNOWN_JOB_REF = 'unknown_job_ref',
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export enum RequirementsSnapshotIssueSeverity {
|
|
84
|
+
ERROR = 'error',
|
|
85
|
+
WARN = 'warn',
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
export interface RequirementsSnapshotIssue {
|
|
89
|
+
kind: RequirementsSnapshotIssueKind;
|
|
90
|
+
/** Dotted path inside the snapshot (e.g. `'nonFunctional[2].ref'`). */
|
|
91
|
+
path: string;
|
|
92
|
+
message: string;
|
|
93
|
+
severity: RequirementsSnapshotIssueSeverity;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export interface RequirementsSnapshotValidationResult {
|
|
97
|
+
/** `true` iff no issue has severity `ERROR`. */
|
|
98
|
+
ok: boolean;
|
|
99
|
+
issues: RequirementsSnapshotIssue[];
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
export interface ValidateRequirementsSnapshotOptions {
|
|
103
|
+
/** Override "now" for `STALE_AUTHORED` checks (test affordance). Defaults to `new Date()`. */
|
|
104
|
+
now?: Date;
|
|
105
|
+
/**
|
|
106
|
+
* Resolvable market ICP refs. When supplied, every `icpRefs` entry not
|
|
107
|
+
* in the set is reported as `UNKNOWN_ICP_REF`. When omitted, the check
|
|
108
|
+
* is skipped entirely (fail-soft — the requirements family is
|
|
109
|
+
* decoupled from the market family; the catalog owns resolution).
|
|
110
|
+
*/
|
|
111
|
+
availableIcpRefs?: ReadonlySet<string>;
|
|
112
|
+
/**
|
|
113
|
+
* Resolvable market job refs. Same skip-when-omitted semantics as
|
|
114
|
+
* `availableIcpRefs`, reported as `UNKNOWN_JOB_REF`.
|
|
115
|
+
*/
|
|
116
|
+
availableJobRefs?: ReadonlySet<string>;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Days-per-cadence mapping, mirrored from the market / vision / assertions
|
|
121
|
+
* validators (module-local there too — a shared promotion is part of the
|
|
122
|
+
* deferred authored-metadata generalization).
|
|
123
|
+
*/
|
|
124
|
+
const REVIEW_CADENCE_TO_DAYS: Record<ReviewCadence, number> = {
|
|
125
|
+
[ReviewCadence.WEEKLY]: 7,
|
|
126
|
+
[ReviewCadence.MONTHLY]: 31,
|
|
127
|
+
[ReviewCadence.QUARTERLY]: 92,
|
|
128
|
+
[ReviewCadence.YEARLY]: 366,
|
|
129
|
+
[ReviewCadence.AS_NEEDED]: Number.POSITIVE_INFINITY,
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
export function validateRequirementsSnapshot(
|
|
133
|
+
snapshot: RequirementsSnapshot,
|
|
134
|
+
options?: ValidateRequirementsSnapshotOptions,
|
|
135
|
+
): RequirementsSnapshotValidationResult {
|
|
136
|
+
const issues: RequirementsSnapshotIssue[] = [];
|
|
137
|
+
|
|
138
|
+
detectInvalidRefFormats(snapshot, issues);
|
|
139
|
+
detectDuplicateRefs(snapshot, issues);
|
|
140
|
+
detectDuplicateCrossRefs(snapshot, issues);
|
|
141
|
+
detectIncompleteness(snapshot, issues);
|
|
142
|
+
detectStaleAuthored(snapshot, options?.now ?? new Date(), issues);
|
|
143
|
+
detectUnknownCrossRefs(snapshot, options, issues);
|
|
144
|
+
|
|
145
|
+
const ok = issues.every(
|
|
146
|
+
issue => issue.severity !== RequirementsSnapshotIssueSeverity.ERROR,
|
|
147
|
+
);
|
|
148
|
+
return { ok, issues };
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
// ────────────────────────────────────────────────────────────────────
|
|
152
|
+
// Detectors — one per rule, kept small and independently testable.
|
|
153
|
+
// ────────────────────────────────────────────────────────────────────
|
|
154
|
+
|
|
155
|
+
function detectInvalidRefFormats(
|
|
156
|
+
snapshot: RequirementsSnapshot,
|
|
157
|
+
issues: RequirementsSnapshotIssue[],
|
|
158
|
+
): void {
|
|
159
|
+
snapshot.functional.forEach((entry, index) => {
|
|
160
|
+
if (FUNCTIONAL_REQUIREMENT_REF_PATTERN.test(entry.ref)) return;
|
|
161
|
+
issues.push({
|
|
162
|
+
kind: RequirementsSnapshotIssueKind.INVALID_REF_FORMAT,
|
|
163
|
+
path: `functional[${index}].ref`,
|
|
164
|
+
message: `Functional-requirement ref "${entry.ref}" is not kebab-case with the "functional-requirement-" prefix.`,
|
|
165
|
+
severity: RequirementsSnapshotIssueSeverity.ERROR,
|
|
166
|
+
});
|
|
167
|
+
});
|
|
168
|
+
snapshot.nonFunctional.forEach((entry, index) => {
|
|
169
|
+
if (NON_FUNCTIONAL_REQUIREMENT_REF_PATTERN.test(entry.ref)) return;
|
|
170
|
+
issues.push({
|
|
171
|
+
kind: RequirementsSnapshotIssueKind.INVALID_REF_FORMAT,
|
|
172
|
+
path: `nonFunctional[${index}].ref`,
|
|
173
|
+
message: `Non-functional-requirement ref "${entry.ref}" is not kebab-case with the "nfr-" prefix.`,
|
|
174
|
+
severity: RequirementsSnapshotIssueSeverity.ERROR,
|
|
175
|
+
});
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
function detectDuplicateRefs(
|
|
180
|
+
snapshot: RequirementsSnapshot,
|
|
181
|
+
issues: RequirementsSnapshotIssue[],
|
|
182
|
+
): void {
|
|
183
|
+
reportDuplicates(
|
|
184
|
+
snapshot.functional.map(entry => entry.ref),
|
|
185
|
+
'functional',
|
|
186
|
+
issues,
|
|
187
|
+
);
|
|
188
|
+
reportDuplicates(
|
|
189
|
+
snapshot.nonFunctional.map(entry => entry.ref),
|
|
190
|
+
'nonFunctional',
|
|
191
|
+
issues,
|
|
192
|
+
);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
function reportDuplicates(
|
|
196
|
+
refs: string[],
|
|
197
|
+
collection: string,
|
|
198
|
+
issues: RequirementsSnapshotIssue[],
|
|
199
|
+
): void {
|
|
200
|
+
const seen = new Set<string>();
|
|
201
|
+
refs.forEach((ref, index) => {
|
|
202
|
+
if (!seen.has(ref)) {
|
|
203
|
+
seen.add(ref);
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
issues.push({
|
|
207
|
+
kind: RequirementsSnapshotIssueKind.DUPLICATE_REF,
|
|
208
|
+
path: `${collection}[${index}].ref`,
|
|
209
|
+
message: `Duplicate ref "${ref}" in ${collection} — refs must be unique; the collection is addressed by ref downstream.`,
|
|
210
|
+
severity: RequirementsSnapshotIssueSeverity.ERROR,
|
|
211
|
+
});
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
function detectDuplicateCrossRefs(
|
|
216
|
+
snapshot: RequirementsSnapshot,
|
|
217
|
+
issues: RequirementsSnapshotIssue[],
|
|
218
|
+
): void {
|
|
219
|
+
const checkList = (
|
|
220
|
+
refs: readonly string[] | undefined,
|
|
221
|
+
entity: FunctionalRequirementConfig | NonFunctionalRequirementConfig,
|
|
222
|
+
path: string,
|
|
223
|
+
): void => {
|
|
224
|
+
if (refs === undefined) return;
|
|
225
|
+
const seen = new Set<string>();
|
|
226
|
+
refs.forEach((ref, refIndex) => {
|
|
227
|
+
if (!seen.has(ref)) {
|
|
228
|
+
seen.add(ref);
|
|
229
|
+
return;
|
|
230
|
+
}
|
|
231
|
+
issues.push({
|
|
232
|
+
kind: RequirementsSnapshotIssueKind.DUPLICATE_CROSS_REF,
|
|
233
|
+
path: `${path}[${refIndex}]`,
|
|
234
|
+
message: `Cross-ref "${ref}" is listed more than once on requirement "${entity.ref}" (${path}). Remove the duplicate.`,
|
|
235
|
+
severity: RequirementsSnapshotIssueSeverity.WARN,
|
|
236
|
+
});
|
|
237
|
+
});
|
|
238
|
+
};
|
|
239
|
+
|
|
240
|
+
const checkEntity = (
|
|
241
|
+
entry: FunctionalRequirementConfig | NonFunctionalRequirementConfig,
|
|
242
|
+
collection: string,
|
|
243
|
+
index: number,
|
|
244
|
+
): void => {
|
|
245
|
+
checkList(entry.icpRefs, entry, `${collection}[${index}].icpRefs`);
|
|
246
|
+
checkList(entry.jobRefs, entry, `${collection}[${index}].jobRefs`);
|
|
247
|
+
};
|
|
248
|
+
|
|
249
|
+
snapshot.functional.forEach((entry, index) => checkEntity(entry, 'functional', index));
|
|
250
|
+
snapshot.nonFunctional.forEach((entry, index) => checkEntity(entry, 'nonFunctional', index));
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
function detectIncompleteness(
|
|
254
|
+
snapshot: RequirementsSnapshot,
|
|
255
|
+
issues: RequirementsSnapshotIssue[],
|
|
256
|
+
): void {
|
|
257
|
+
if (snapshot.functional.length === 0) {
|
|
258
|
+
issues.push({
|
|
259
|
+
kind: RequirementsSnapshotIssueKind.NO_FUNCTIONAL_REQUIREMENTS,
|
|
260
|
+
path: 'functional',
|
|
261
|
+
message: 'Requirements brief states no functional requirements — it describes no capability the product must provide.',
|
|
262
|
+
severity: RequirementsSnapshotIssueSeverity.WARN,
|
|
263
|
+
});
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
function detectStaleAuthored(
|
|
268
|
+
snapshot: RequirementsSnapshot,
|
|
269
|
+
now: Date,
|
|
270
|
+
issues: RequirementsSnapshotIssue[],
|
|
271
|
+
): void {
|
|
272
|
+
const checkOne = (authored: RequirementsAuthoredMetadata | undefined, path: string): void => {
|
|
273
|
+
if (authored?.reviewCadence === undefined) return;
|
|
274
|
+
const days = REVIEW_CADENCE_TO_DAYS[authored.reviewCadence];
|
|
275
|
+
if (!Number.isFinite(days)) return;
|
|
276
|
+
const lastAuthored = new Date(authored.lastAuthoredAt).getTime();
|
|
277
|
+
if (Number.isNaN(lastAuthored)) return;
|
|
278
|
+
const ageDays = (now.getTime() - lastAuthored) / (24 * 60 * 60 * 1000);
|
|
279
|
+
if (ageDays <= days) return;
|
|
280
|
+
issues.push({
|
|
281
|
+
kind: RequirementsSnapshotIssueKind.STALE_AUTHORED,
|
|
282
|
+
path,
|
|
283
|
+
message: `Requirements entity at "${path}" is ${Math.floor(ageDays)} days old (cadence ${authored.reviewCadence} ⇒ ${days}d). Re-author or remove the cadence.`,
|
|
284
|
+
severity: RequirementsSnapshotIssueSeverity.WARN,
|
|
285
|
+
});
|
|
286
|
+
};
|
|
287
|
+
|
|
288
|
+
snapshot.functional.forEach((entry, index) =>
|
|
289
|
+
checkOne(entry.authored, `functional[${index}].authored`),
|
|
290
|
+
);
|
|
291
|
+
snapshot.nonFunctional.forEach((entry, index) =>
|
|
292
|
+
checkOne(entry.authored, `nonFunctional[${index}].authored`),
|
|
293
|
+
);
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
function detectUnknownCrossRefs(
|
|
297
|
+
snapshot: RequirementsSnapshot,
|
|
298
|
+
options: ValidateRequirementsSnapshotOptions | undefined,
|
|
299
|
+
issues: RequirementsSnapshotIssue[],
|
|
300
|
+
): void {
|
|
301
|
+
const checkEntity = (
|
|
302
|
+
entry: FunctionalRequirementConfig | NonFunctionalRequirementConfig,
|
|
303
|
+
collection: string,
|
|
304
|
+
index: number,
|
|
305
|
+
): void => {
|
|
306
|
+
if (options?.availableIcpRefs !== undefined) {
|
|
307
|
+
entry.icpRefs?.forEach((icpRef, refIndex) => {
|
|
308
|
+
if (options.availableIcpRefs!.has(icpRef)) return;
|
|
309
|
+
issues.push({
|
|
310
|
+
kind: RequirementsSnapshotIssueKind.UNKNOWN_ICP_REF,
|
|
311
|
+
path: `${collection}[${index}].icpRefs[${refIndex}]`,
|
|
312
|
+
message: `ICP ref "${icpRef}" on requirement "${entry.ref}" does not resolve in the supplied ICP-ref set.`,
|
|
313
|
+
severity: RequirementsSnapshotIssueSeverity.ERROR,
|
|
314
|
+
});
|
|
315
|
+
});
|
|
316
|
+
}
|
|
317
|
+
if (options?.availableJobRefs !== undefined) {
|
|
318
|
+
entry.jobRefs?.forEach((jobRef, refIndex) => {
|
|
319
|
+
if (options.availableJobRefs!.has(jobRef)) return;
|
|
320
|
+
issues.push({
|
|
321
|
+
kind: RequirementsSnapshotIssueKind.UNKNOWN_JOB_REF,
|
|
322
|
+
path: `${collection}[${index}].jobRefs[${refIndex}]`,
|
|
323
|
+
message: `Job ref "${jobRef}" on requirement "${entry.ref}" does not resolve in the supplied job-ref set.`,
|
|
324
|
+
severity: RequirementsSnapshotIssueSeverity.ERROR,
|
|
325
|
+
});
|
|
326
|
+
});
|
|
327
|
+
}
|
|
328
|
+
};
|
|
329
|
+
|
|
330
|
+
snapshot.functional.forEach((entry, index) => checkEntity(entry, 'functional', index));
|
|
331
|
+
snapshot.nonFunctional.forEach((entry, index) => checkEntity(entry, 'nonFunctional', index));
|
|
332
|
+
}
|
|
333
|
+
```
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# roadmap.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 roadmap entity
|
|
14
|
+
* (a roadmap phase) — the roadmap family's counterpart to
|
|
15
|
+
* `MarketAuthoredMetadataSchema` / `VisionAuthoredMetadataSchema` /
|
|
16
|
+
* `RequirementsAuthoredMetadataSchema`.
|
|
17
|
+
*
|
|
18
|
+
* Design decision (mirrors the vision / requirements 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` reshape
|
|
21
|
+
* with the full blast-radius checklist across every market consumer —
|
|
22
|
+
* explicitly deferred. The market enums are already family-agnostic in
|
|
23
|
+
* name and meaning, so they are IMPORTED rather than duplicated
|
|
24
|
+
* (`AuthoredConfidence`, `ReviewCadence`): re-declaring either would
|
|
25
|
+
* silently drop it from the package-root barrel (ambiguous `export *`
|
|
26
|
+
* 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 plan, validate" when
|
|
32
|
+
* surfacing the entity to a model so it does not parrot a speculative
|
|
33
|
+
* delivery date as a committed one. Kept OPTIONAL provenance here
|
|
34
|
+
* (market / vision / requirements posture), NOT a required top-level
|
|
35
|
+
* audit field (assertions posture): a roadmap is authored by a product
|
|
36
|
+
* owner progressively, not audited by reconcile.
|
|
37
|
+
* - **Recency** — `lastAuthoredAt` ISO datetime + optional `reviewCadence`.
|
|
38
|
+
* The snapshot validator only flags `STALE_AUTHORED` when both are set
|
|
39
|
+
* (no cadence ⇒ no staleness check).
|
|
40
|
+
* - **Trace** — `reviewer` + `notes` carry the human accountability trail
|
|
41
|
+
* without leaking internal processes into the spec.
|
|
42
|
+
*
|
|
43
|
+
* Entirely optional: omit the block when authoring is so fresh and trivial
|
|
44
|
+
* that provenance adds noise.
|
|
45
|
+
*/
|
|
46
|
+
export const RoadmapAuthoredMetadataSchema = 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 semantics
|
|
55
|
+
* as the market / vision / requirements / 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 RoadmapAuthoredMetadata = z.infer<typeof RoadmapAuthoredMetadataSchema>;
|
|
64
|
+
```
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
# roadmap.phase.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
|
+
* One **roadmap phase** — a single release / stage in a product's delivery
|
|
14
|
+
* plan ("MVP launch", "Beta with billing", "GA + growth features"). A
|
|
15
|
+
* ref-addressable collection entity on `RoadmapSnapshot`
|
|
16
|
+
* (`roadmap-phase-<slug>`), so the top-down scope/roadmap catalog (U9) can
|
|
17
|
+
* address an individual phase and later refinement can reconcile against
|
|
18
|
+
* it.
|
|
19
|
+
*
|
|
20
|
+
* A roadmap phase is a **planning-artifact** concept and is deliberately
|
|
21
|
+
* distinct from `MilestoneSpecification` (a dated registry-overlay concept
|
|
22
|
+
* that decorates a runtime milestone) — the two are NOT merged (framework
|
|
23
|
+
* mindset: each carries its own semantic weight). A phase groups WHAT gets
|
|
24
|
+
* delivered WHEN at planning time; a milestone is a registry entry the
|
|
25
|
+
* running app surfaces.
|
|
26
|
+
*
|
|
27
|
+
* What earns its place here (scaffold depth, Phase J1):
|
|
28
|
+
* - **`sequence`** — the authoritative ordering key. Phases MAY be authored
|
|
29
|
+
* in any array order; consumers sort by `sequence` (ascending). An
|
|
30
|
+
* explicit integer is chosen over relying on array position so that
|
|
31
|
+
* re-ordering the authored array can never silently change the roadmap,
|
|
32
|
+
* and so the validator can flag an ambiguous ordering
|
|
33
|
+
* (`DUPLICATE_SEQUENCE`). Non-contiguous values are allowed (author with
|
|
34
|
+
* gaps — 10, 20, 30 — to insert later without renumbering).
|
|
35
|
+
* - **`title`** — a short human name for the phase (required).
|
|
36
|
+
* - **`theme`** — the narrative theme / headline of the phase. Optional.
|
|
37
|
+
* - **`objective`** — what the phase aims to achieve, in prose. Optional.
|
|
38
|
+
* - **`targetWindow`** — WHEN the phase is expected to land, as FREE PROSE
|
|
39
|
+
* ("Q3 2026", "first 3 months post-launch"). Optional. A typed date /
|
|
40
|
+
* schedule model (start/end, dependencies, capacity) is deliberately a
|
|
41
|
+
* Phase-J2 concern — see the family note below.
|
|
42
|
+
* - **`horizon`** — coarse NOW/NEXT/LATER bucket. Optional.
|
|
43
|
+
* - **`kind`** — coarse lifecycle classification (DISCOVERY … GROWTH).
|
|
44
|
+
* Optional.
|
|
45
|
+
* - **`deliversRequirementRefs`** / **`deliversSuccessCriterionRefs`** —
|
|
46
|
+
* OPTIONAL flat cross-references into the requirements family
|
|
47
|
+
* (functional-requirement refs this phase delivers) and the vision
|
|
48
|
+
* family (success-criterion refs this phase is expected to satisfy).
|
|
49
|
+
* Opaque strings by the `_core` reference convention — the requirements
|
|
50
|
+
* / vision schemas are NOT imported (families stay decoupled; the
|
|
51
|
+
* catalog resolves the refs, and the snapshot validator can cross-check
|
|
52
|
+
* them against a supplied set, fail-soft).
|
|
53
|
+
*
|
|
54
|
+
* Deliberately NOT modelled here (scaffold depth, Phase J1): typed
|
|
55
|
+
* timeline / gantt scheduling (start/end dates, date math), inter-phase
|
|
56
|
+
* DEPENDENCY edges (a DAG), capacity / velocity / estimation, and
|
|
57
|
+
* prioritization frameworks (RICE / WSJF). Those are a Phase-J2 concern —
|
|
58
|
+
* a phase here is an ordered, themed bucket of what-gets-delivered, not a
|
|
59
|
+
* scheduled, dependency-ordered plan (framework mindset: breadth before
|
|
60
|
+
* depth, no premature taxonomy).
|
|
61
|
+
*/
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Coarse delivery-horizon bucket a roadmap phase sits in — the classic
|
|
65
|
+
* NOW / NEXT / LATER lens. Fixed vocabulary (enum, per project rule —
|
|
66
|
+
* enums over literal unions). Orthogonal to `sequence` (which gives the
|
|
67
|
+
* precise order) and to `kind` (which classifies the phase's lifecycle
|
|
68
|
+
* stage): `horizon` answers "how soon", coarsely, for at-a-glance roadmap
|
|
69
|
+
* grouping. Optional on a phase.
|
|
70
|
+
*/
|
|
71
|
+
export enum RoadmapPhaseHorizon {
|
|
72
|
+
/** In active delivery now / imminently. */
|
|
73
|
+
NOW = 'now',
|
|
74
|
+
/** Queued directly after the current horizon. */
|
|
75
|
+
NEXT = 'next',
|
|
76
|
+
/** Further-out intent — directionally committed, not yet scheduled. */
|
|
77
|
+
LATER = 'later',
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Coarse lifecycle classification of a roadmap phase. Fixed vocabulary
|
|
82
|
+
* (enum, per project rule — enums over literal unions), covering the
|
|
83
|
+
* standard product-delivery stages at scaffold depth. Deliberately NOT
|
|
84
|
+
* exhaustive of any formal release-management taxonomy; `OTHER` catches
|
|
85
|
+
* stages the fixed buckets miss. Optional on a phase.
|
|
86
|
+
*/
|
|
87
|
+
export enum RoadmapPhaseKind {
|
|
88
|
+
/** Problem / solution discovery, prototyping, validation before build. */
|
|
89
|
+
DISCOVERY = 'discovery',
|
|
90
|
+
/** Minimum viable product — the first shippable slice. */
|
|
91
|
+
MVP = 'mvp',
|
|
92
|
+
/** Limited / gated release for early feedback. */
|
|
93
|
+
BETA = 'beta',
|
|
94
|
+
/** General availability — broadly released and supported. */
|
|
95
|
+
GA = 'ga',
|
|
96
|
+
/** Post-GA expansion — scaling, growth features, optimisation. */
|
|
97
|
+
GROWTH = 'growth',
|
|
98
|
+
/** Anything the fixed stages above do not capture. */
|
|
99
|
+
OTHER = 'other',
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
export const RoadmapPhaseConfigSchema = z.object({
|
|
103
|
+
/** Spec identity — kebab-case, `roadmap-phase-` prefixed (never `id`). */
|
|
104
|
+
ref: RoadmapPhaseRefSchema,
|
|
105
|
+
/**
|
|
106
|
+
* Authoritative ordering key (ascending). Phases may be authored in any
|
|
107
|
+
* array order; consumers sort by `sequence`. Integer; non-contiguous
|
|
108
|
+
* values allowed.
|
|
109
|
+
*/
|
|
110
|
+
sequence: z.number().int(),
|
|
111
|
+
/** Short human label for the phase (e.g. "MVP launch"). Required. */
|
|
112
|
+
title: NonEmptyStringSchema,
|
|
113
|
+
/**
|
|
114
|
+
* The phase's strategic headline — the narrative angle that frames what
|
|
115
|
+
* it contains ("Trust & safety", "Onboarding excellence"). Distinct from
|
|
116
|
+
* `title` (the short label) and `objective` (the concrete outcome).
|
|
117
|
+
*/
|
|
118
|
+
theme: NonEmptyStringSchema.optional(),
|
|
119
|
+
/**
|
|
120
|
+
* The concrete outcome the phase targets, in prose ("cut time-to-first-
|
|
121
|
+
* value below 5 minutes"). Distinct from `theme` (the narrative angle).
|
|
122
|
+
*/
|
|
123
|
+
objective: NonEmptyStringSchema.optional(),
|
|
124
|
+
/**
|
|
125
|
+
* When the phase is expected to land — FREE PROSE at scaffold depth
|
|
126
|
+
* ("Q3 2026", "first 3 months"). A typed schedule model is Phase-J2.
|
|
127
|
+
*/
|
|
128
|
+
targetWindow: NonEmptyStringSchema.optional(),
|
|
129
|
+
/** Coarse NOW / NEXT / LATER delivery-horizon bucket. */
|
|
130
|
+
horizon: z.enum(RoadmapPhaseHorizon).optional(),
|
|
131
|
+
/** Coarse lifecycle classification — see `RoadmapPhaseKind`. */
|
|
132
|
+
kind: z.enum(RoadmapPhaseKind).optional(),
|
|
133
|
+
/**
|
|
134
|
+
* Optional cross-references to functional requirements this phase
|
|
135
|
+
* delivers. Flat opaque strings (the catalog resolves them against the
|
|
136
|
+
* requirements snapshot; the requirements schemas are not imported here).
|
|
137
|
+
*/
|
|
138
|
+
deliversRequirementRefs: z.array(NonEmptyStringSchema).optional(),
|
|
139
|
+
/**
|
|
140
|
+
* Optional cross-references to vision success criteria this phase is
|
|
141
|
+
* expected to satisfy. Flat opaque strings (see
|
|
142
|
+
* `deliversRequirementRefs`).
|
|
143
|
+
*/
|
|
144
|
+
deliversSuccessCriterionRefs: z.array(NonEmptyStringSchema).optional(),
|
|
145
|
+
/** Optional per-entity authoring provenance. */
|
|
146
|
+
authored: RoadmapAuthoredMetadataSchema.optional(),
|
|
147
|
+
});
|
|
148
|
+
export type RoadmapPhaseConfig = z.infer<typeof RoadmapPhaseConfigSchema>;
|
|
149
|
+
```
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# roadmap.references.conventions
|
|
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
|
+
* Reference primitives for the **roadmap specification family**
|
|
14
|
+
* (app-creation meta-workflows, C-4 definition families — the delivery-
|
|
15
|
+
* roadmap layer the top-down scope/roadmap catalog reads/writes: a
|
|
16
|
+
* product's delivery plan as an ordered sequence of releases/phases, each
|
|
17
|
+
* optionally cross-referencing what it DELIVERS — functional requirements
|
|
18
|
+
* and vision success criteria).
|
|
19
|
+
*
|
|
20
|
+
* The family follows the two reference design rules every specification
|
|
21
|
+
* family in `_core/` obeys:
|
|
22
|
+
*
|
|
23
|
+
* 1. **`ref` is the spec identity.** Every ref-addressable roadmap entity
|
|
24
|
+
* self-identifies via a stable string `ref`. The token `id` is
|
|
25
|
+
* reserved for database persistence and does NOT appear anywhere in
|
|
26
|
+
* this family.
|
|
27
|
+
* 2. **Cross-references are flat strings**, never wrapper objects. The
|
|
28
|
+
* field name carries the referenced entity; compile-time
|
|
29
|
+
* discrimination is provided by the type alias below without boxing at
|
|
30
|
+
* runtime. This holds for BOTH the intra-family ref shape (a phase) AND
|
|
31
|
+
* the cross-family `deliversRequirementRefs` / `deliversSuccessCriterionRefs`
|
|
32
|
+
* that point into the requirements / vision families — those are opaque
|
|
33
|
+
* strings here (the catalog, not this family, resolves them, so the
|
|
34
|
+
* requirements FunctionalRequirement / vision SuccessCriterion schemas
|
|
35
|
+
* are deliberately NOT imported — the families stay decoupled).
|
|
36
|
+
*
|
|
37
|
+
* The single COLLECTION entity is ref-addressable — a roadmap phase
|
|
38
|
+
* (`roadmap-phase-<slug>`). The prefix is ENFORCED (vision / requirements
|
|
39
|
+
* posture, not the market family's prose-only convention): roadmap
|
|
40
|
+
* entities are consumed by the automated top-down catalog and journey
|
|
41
|
+
* tooling, so a mistyped ref is a silent hole in the audit surface rather
|
|
42
|
+
* than a cosmetic slip.
|
|
43
|
+
*
|
|
44
|
+
* `NonEmptyStringSchema` (the shared trim+non-empty prose contract),
|
|
45
|
+
* `AuthoredConfidence`, and `ReviewCadence` are IMPORTED DIRECTLY from the
|
|
46
|
+
* market family by each roadmap file that needs them — the same reuse edge
|
|
47
|
+
* the vision + requirements families use. They are deliberately NOT
|
|
48
|
+
* re-exported through this file: `export *`-ing a name the market family
|
|
49
|
+
* already exports would make it ambiguous at the package-root barrel and
|
|
50
|
+
* silently drop it (ambiguous `export *` names are excluded). A shared
|
|
51
|
+
* `_core/authored-metadata` / `_core/references` promotion is a `_core`
|
|
52
|
+
* reshape with the full blast-radius checklist across every market
|
|
53
|
+
* consumer and is explicitly deferred; hand-duplicating the vocabularies
|
|
54
|
+
* here would drift.
|
|
55
|
+
*/
|
|
56
|
+
|
|
57
|
+
/** Mandatory kebab-case prefix for every roadmap-phase ref. */
|
|
58
|
+
export const ROADMAP_PHASE_REF_PREFIX = 'roadmap-phase-';
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* THE roadmap-phase ref-format contract — single source of truth shared
|
|
62
|
+
* by `RoadmapPhaseRefSchema` (parse-time enforcement) and the snapshot
|
|
63
|
+
* validator's defence-in-depth `INVALID_REF_FORMAT` detector (walk-time,
|
|
64
|
+
* for type-asserted fixtures that bypass parsing). Exported precisely so
|
|
65
|
+
* the two checks can never drift apart.
|
|
66
|
+
*/
|
|
67
|
+
export const ROADMAP_PHASE_REF_PATTERN = /^roadmap-phase-[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Spec-level identity of one roadmap phase (NEVER `id`). Kebab-case,
|
|
71
|
+
* `roadmap-phase-` prefixed.
|
|
72
|
+
*/
|
|
73
|
+
export type RoadmapPhaseRef = string;
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Enforced roadmap-phase ref contract: kebab-case, `roadmap-phase-`
|
|
77
|
+
* prefix, lowercase alphanumeric segments separated by single dashes.
|
|
78
|
+
*
|
|
79
|
+
* Valid: `roadmap-phase-mvp-launch`.
|
|
80
|
+
* Invalid: `mvp-launch` (no prefix), `roadmap-phase-` (empty slug),
|
|
81
|
+
* `roadmap-phase-MVP` (uppercase).
|
|
82
|
+
*/
|
|
83
|
+
export const RoadmapPhaseRefSchema = z
|
|
84
|
+
.string()
|
|
85
|
+
.regex(
|
|
86
|
+
ROADMAP_PHASE_REF_PATTERN,
|
|
87
|
+
`roadmap-phase refs must be kebab-case and start with "${ROADMAP_PHASE_REF_PREFIX}"`,
|
|
88
|
+
);
|
|
89
|
+
```
|