@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,223 @@
|
|
|
1
|
+
# assertions.behaviors.wire-contracts
|
|
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
|
+
* Wire contracts for the companion `assertions` introspection
|
|
14
|
+
* behavior family (implementation-spec P-9):
|
|
15
|
+
*
|
|
16
|
+
* - `assertions-list` — authored entries, filtered (scope / lane /
|
|
17
|
+
* kind). Pure projection of the authored snapshot.
|
|
18
|
+
* - `assertions-resolve` — entries PLUS live derivation: the
|
|
19
|
+
* subprocess runs the entries' introspection probes against
|
|
20
|
+
* current reality (S1 layer 2 — derived at query time, never
|
|
21
|
+
* copied). LLM interpretation (S1 layer 3) composes on top in the
|
|
22
|
+
* PARENT process — the subprocess stays pure/deterministic.
|
|
23
|
+
* - `assertions-reconcile` — computes per-entry status
|
|
24
|
+
* (assumed → landed → drifted) by diffing assumptions against
|
|
25
|
+
* introspected reality (S1 held condition (b): reconciliation is a
|
|
26
|
+
* QUERY, not a review ritual).
|
|
27
|
+
*
|
|
28
|
+
* Owning these contracts here (rather than in the dev-companion)
|
|
29
|
+
* follows the market precedent (`market-generation.schemas.ts`,
|
|
30
|
+
* `market-context-block.schemas.ts`): **anything that crosses a
|
|
31
|
+
* process boundary MUST be Zod-policed on at least one side**, and
|
|
32
|
+
* the single source of truth lives in `saas-specifications` so the
|
|
33
|
+
* subprocess IPC boundary, the parent services, and any HTTP/CLI
|
|
34
|
+
* consumer all `parse()` against the same schema. Companion handlers
|
|
35
|
+
* still hand-parse requests defensively — input crosses IPC as
|
|
36
|
+
* untrusted JSON (P-9).
|
|
37
|
+
*
|
|
38
|
+
* The `scope` request field REUSES the application-creation
|
|
39
|
+
* `Journey_ScopeSchema` — journey scoping is a first-class S4
|
|
40
|
+
* concept ("the snapshot, choreographer, and coverage judge reason
|
|
41
|
+
* only over the scoped subset") and these behaviors are exactly that
|
|
42
|
+
* machinery, so the journey lane can pass `journey.scope` through
|
|
43
|
+
* end-to-end with one vocabulary. Rejected alternative: a locally
|
|
44
|
+
* mirrored `{ moduleIds?, resourceTypes? }` shape — hand-duplication
|
|
45
|
+
* is the drift (the P-8 precedent: reuse the schema, never
|
|
46
|
+
* hand-mirror it).
|
|
47
|
+
*/
|
|
48
|
+
|
|
49
|
+
// ── assertions-list ─────────────────────────────────────────────────
|
|
50
|
+
|
|
51
|
+
export const AssertionsListRequestSchema = z.object({
|
|
52
|
+
/**
|
|
53
|
+
* Optional module/resource subset filter (S4 journey scoping).
|
|
54
|
+
* Filtering happens post-`buildSharedSaaSModulesRegistry` in the
|
|
55
|
+
* handler — relationships span modules, so the registry is built
|
|
56
|
+
* whole and projected down.
|
|
57
|
+
*/
|
|
58
|
+
scope: Journey_ScopeSchema.optional(),
|
|
59
|
+
/**
|
|
60
|
+
* Optional lane filter. Consumers that materialize APP-SHIPPED
|
|
61
|
+
* output MUST pass `AssertionLane.APP` — `FRAMEWORK_DEV` entries
|
|
62
|
+
* never compile into shipped app knowledge (S1 held condition (c)).
|
|
63
|
+
*/
|
|
64
|
+
lane: z.enum(AssertionLane).optional(),
|
|
65
|
+
/** Optional kind filter (any-of). Omitted = all kinds. */
|
|
66
|
+
kinds: z.array(z.enum(AssertionKind)).optional(),
|
|
67
|
+
});
|
|
68
|
+
export type AssertionsListRequest = z.infer<typeof AssertionsListRequestSchema>;
|
|
69
|
+
|
|
70
|
+
export const AssertionsListResponseSchema = z.object({
|
|
71
|
+
version: z.enum(AssertionSnapshotVersion),
|
|
72
|
+
/** Filtered authored entries, in authored-map iteration order. */
|
|
73
|
+
entries: z.array(AssertionSpecificationConfigSchema),
|
|
74
|
+
trace: z.object({
|
|
75
|
+
/** Total authored entries before filtering. */
|
|
76
|
+
totalAuthored: z.number().int().nonnegative(),
|
|
77
|
+
/** Entries returned after scope/lane/kind filtering. */
|
|
78
|
+
returned: z.number().int().nonnegative(),
|
|
79
|
+
}),
|
|
80
|
+
});
|
|
81
|
+
export type AssertionsListResponse = z.infer<typeof AssertionsListResponseSchema>;
|
|
82
|
+
|
|
83
|
+
// ── assertions-resolve ──────────────────────────────────────────────
|
|
84
|
+
|
|
85
|
+
export const AssertionsResolveRequestSchema = z.object({
|
|
86
|
+
/** Optional module/resource subset filter — see `AssertionsListRequestSchema.scope`. */
|
|
87
|
+
scope: Journey_ScopeSchema.optional(),
|
|
88
|
+
/**
|
|
89
|
+
* Optional lane filter — same S1 held-condition-(c) contract as
|
|
90
|
+
* `AssertionsListRequestSchema.lane` / `AssertionsReconcileRequestSchema.lane`.
|
|
91
|
+
* A Layer-A (app-delivered) consumer that resolves entries into an app-facing
|
|
92
|
+
* surface MUST pass `AssertionLane.APP` so `FRAMEWORK_DEV` bets never leak into
|
|
93
|
+
* shipped app knowledge — the same latent footgun the reconcile lane filter
|
|
94
|
+
* closes. When omitted, ALL lanes resolve (the framework-dev audit path); the
|
|
95
|
+
* filter is a consumer opt-in.
|
|
96
|
+
*/
|
|
97
|
+
lane: z.enum(AssertionLane).optional(),
|
|
98
|
+
/**
|
|
99
|
+
* Optional narrowing to specific assertion refs. Format-enforced
|
|
100
|
+
* (`AssertionRefSchema`): a typo'd ref would otherwise pass
|
|
101
|
+
* validation and silently narrow to zero entries — the exact
|
|
102
|
+
* "silent hole in the audit surface" the ref contract exists to
|
|
103
|
+
* prevent.
|
|
104
|
+
*/
|
|
105
|
+
refs: z.array(AssertionRefSchema).optional(),
|
|
106
|
+
/**
|
|
107
|
+
* Optional free-text question the PARENT process will interpret
|
|
108
|
+
* against the resolved entries + probe findings (S1 layer 3 —
|
|
109
|
+
* "what can meta-workflow step X assume about Y?"). The subprocess
|
|
110
|
+
* echoes it in the trace; it never does LLM work itself.
|
|
111
|
+
*/
|
|
112
|
+
query: z.string().min(1).optional(),
|
|
113
|
+
});
|
|
114
|
+
export type AssertionsResolveRequest = z.infer<typeof AssertionsResolveRequestSchema>;
|
|
115
|
+
|
|
116
|
+
/** Deterministic outcome of one live probe evaluation. */
|
|
117
|
+
export enum AssertionProbeOutcome {
|
|
118
|
+
/** The probe ran and produced a payload. */
|
|
119
|
+
RESOLVED = 'resolved',
|
|
120
|
+
/** The probe could not run (behavior unknown / target absent) — reported honestly, never guessed. */
|
|
121
|
+
UNAVAILABLE = 'unavailable',
|
|
122
|
+
/** The probe ran and failed (behavior error). */
|
|
123
|
+
ERROR = 'error',
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export const AssertionProbeFindingSchema = z.object({
|
|
127
|
+
/** Assertion the probe belongs to (format-enforced echo of the entry's ref). */
|
|
128
|
+
assertionRef: AssertionRefSchema,
|
|
129
|
+
/** Introspection behavior the probe invoked (echoed from the entry's probe config). */
|
|
130
|
+
behaviorId: z.string().min(1),
|
|
131
|
+
outcome: z.enum(AssertionProbeOutcome),
|
|
132
|
+
/** Short deterministic summary (counts, presence checks) — prose interpretation is the parent's job. */
|
|
133
|
+
summary: z.string().min(1).optional(),
|
|
134
|
+
/**
|
|
135
|
+
* JSON-safe probe payload for the parent's interpretation layer.
|
|
136
|
+
* Deliberately loose: each probed behavior owns its response
|
|
137
|
+
* contract; re-typing them all here would duplicate every behavior
|
|
138
|
+
* contract into this file.
|
|
139
|
+
*/
|
|
140
|
+
payload: z.unknown().optional(),
|
|
141
|
+
});
|
|
142
|
+
export type AssertionProbeFinding = z.infer<typeof AssertionProbeFindingSchema>;
|
|
143
|
+
|
|
144
|
+
export const AssertionsResolveResponseSchema = z.object({
|
|
145
|
+
version: z.enum(AssertionSnapshotVersion),
|
|
146
|
+
/** Resolved authored entries (after scope/refs narrowing). */
|
|
147
|
+
entries: z.array(AssertionSpecificationConfigSchema),
|
|
148
|
+
/** Live probe findings for entries that carry a probe. */
|
|
149
|
+
probeFindings: z.array(AssertionProbeFindingSchema).default([]),
|
|
150
|
+
trace: z.object({
|
|
151
|
+
returned: z.number().int().nonnegative(),
|
|
152
|
+
/** Echo of the request's free-text query, when present. */
|
|
153
|
+
query: z.string().min(1).optional(),
|
|
154
|
+
evaluatedAt: z.iso.datetime(),
|
|
155
|
+
}),
|
|
156
|
+
});
|
|
157
|
+
export type AssertionsResolveResponse = z.infer<typeof AssertionsResolveResponseSchema>;
|
|
158
|
+
|
|
159
|
+
// ── assertions-reconcile ────────────────────────────────────────────
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* Computed reconciliation status of one assertion (S1 held condition
|
|
163
|
+
* (b): `ASSUMED → LANDED → DRIFTED`, computed by diffing assumptions
|
|
164
|
+
* against introspected reality — never hand-maintained).
|
|
165
|
+
*
|
|
166
|
+
* `UNVERIFIABLE` extends the master-plan triple deliberately: a
|
|
167
|
+
* fail-soft reconcile that cannot evaluate an entry (no pins, no
|
|
168
|
+
* probe, or probe target unavailable) must say so honestly rather
|
|
169
|
+
* than report `ASSUMED` — "assumption stands, unverified" and "could
|
|
170
|
+
* not check" are distinct facts, and merging them would hide exactly
|
|
171
|
+
* the audit holes this surface exists to expose.
|
|
172
|
+
*/
|
|
173
|
+
export enum AssertionReconcileStatus {
|
|
174
|
+
ASSUMED = 'assumed',
|
|
175
|
+
LANDED = 'landed',
|
|
176
|
+
DRIFTED = 'drifted',
|
|
177
|
+
UNVERIFIABLE = 'unverifiable',
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
export const AssertionsReconcileEntryResultSchema = z.object({
|
|
181
|
+
/** Format-enforced echo of the reconciled entry's ref. */
|
|
182
|
+
ref: AssertionRefSchema,
|
|
183
|
+
kind: z.enum(AssertionKind),
|
|
184
|
+
status: z.enum(AssertionReconcileStatus),
|
|
185
|
+
/** Deterministic diff evidence for the computed status (what was compared, what disagreed). */
|
|
186
|
+
evidence: z.string().min(1).optional(),
|
|
187
|
+
});
|
|
188
|
+
export type AssertionsReconcileEntryResult = z.infer<typeof AssertionsReconcileEntryResultSchema>;
|
|
189
|
+
|
|
190
|
+
export const AssertionsReconcileRequestSchema = z.object({
|
|
191
|
+
/** Optional module/resource subset filter — see `AssertionsListRequestSchema.scope`. */
|
|
192
|
+
scope: Journey_ScopeSchema.optional(),
|
|
193
|
+
/**
|
|
194
|
+
* Optional lane filter — same S1 held-condition-(c) contract as
|
|
195
|
+
* `AssertionsListRequestSchema.lane`. Consumers that materialize
|
|
196
|
+
* APP-SHIPPED output (the choreographer folds these reconcile results
|
|
197
|
+
* into its ranking prompt) MUST pass `AssertionLane.APP` — reconciling
|
|
198
|
+
* `FRAMEWORK_DEV` entries into an app-facing surface leaks
|
|
199
|
+
* framework-development bets into shipped app knowledge. When omitted,
|
|
200
|
+
* ALL lanes reconcile (the framework-dev audit path); the filter is a
|
|
201
|
+
* consumer opt-in, mirroring `assertions-list`.
|
|
202
|
+
*/
|
|
203
|
+
lane: z.enum(AssertionLane).optional(),
|
|
204
|
+
});
|
|
205
|
+
export type AssertionsReconcileRequest = z.infer<typeof AssertionsReconcileRequestSchema>;
|
|
206
|
+
|
|
207
|
+
export const AssertionsReconcileResponseSchema = z.object({
|
|
208
|
+
version: z.enum(AssertionSnapshotVersion),
|
|
209
|
+
results: z.array(AssertionsReconcileEntryResultSchema),
|
|
210
|
+
trace: z.object({
|
|
211
|
+
/**
|
|
212
|
+
* Total AUTHORED entries (before any `lane` filter) — stable
|
|
213
|
+
* observability of "how many assertions exist". `results.length` is
|
|
214
|
+
* the count actually reconciled after lane filtering; the two differ
|
|
215
|
+
* when a `lane` was passed. Mirrors `AssertionsListResponse.trace`'s
|
|
216
|
+
* `totalAuthored` / `returned` split.
|
|
217
|
+
*/
|
|
218
|
+
totalEntries: z.number().int().nonnegative(),
|
|
219
|
+
evaluatedAt: z.iso.datetime(),
|
|
220
|
+
}),
|
|
221
|
+
});
|
|
222
|
+
export type AssertionsReconcileResponse = z.infer<typeof AssertionsReconcileResponseSchema>;
|
|
223
|
+
```
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# assertions.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 assertion specification family
|
|
14
|
+
* (app-creation meta-workflows, master plan S1 — the dynamic
|
|
15
|
+
* Assertion Surface).
|
|
16
|
+
*
|
|
17
|
+
* The family follows the two reference design rules every
|
|
18
|
+
* specification family in `_core/` obeys:
|
|
19
|
+
*
|
|
20
|
+
* 1. **`ref` is the spec identity.** Every assertion self-identifies
|
|
21
|
+
* via a stable string `ref`. The token `id` is reserved for
|
|
22
|
+
* database persistence and does NOT appear anywhere in this
|
|
23
|
+
* family.
|
|
24
|
+
* 2. **Cross-references are flat strings**, never wrapper objects.
|
|
25
|
+
* The field name carries the referenced entity
|
|
26
|
+
* (`pinRefs: string[]`); compile-time discrimination is provided
|
|
27
|
+
* by the type aliases below without boxing at runtime.
|
|
28
|
+
*
|
|
29
|
+
* Assertion refs follow the kebab-case convention
|
|
30
|
+
* `assertion-<slug>` (e.g. `assertion-companion-dist-distributed`,
|
|
31
|
+
* `assertion-provider-configurations-landmine`). Unlike the market
|
|
32
|
+
* family (which documents its prefixes in prose only), the prefix is
|
|
33
|
+
* ENFORCED by `AssertionRefSchema` — assertions are consumed by
|
|
34
|
+
* automated reconciliation and journey tooling, so a mistyped ref is
|
|
35
|
+
* a silent hole in the audit surface rather than a cosmetic slip.
|
|
36
|
+
* Rejected alternative: a plain non-empty string (market style) —
|
|
37
|
+
* too weak for a family whose whole purpose is machine-checkable
|
|
38
|
+
* audit state.
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Mandatory kebab-case prefix for every assertion ref. Used in error
|
|
43
|
+
* messages and authoring tooling; the machine-checked contract is
|
|
44
|
+
* `ASSERTION_REF_PATTERN` below.
|
|
45
|
+
*/
|
|
46
|
+
export const ASSERTION_REF_PREFIX = 'assertion-';
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* THE ref format contract — the single source of truth shared by
|
|
50
|
+
* `AssertionRefSchema` (parse-time enforcement) and the snapshot
|
|
51
|
+
* validator's defence-in-depth `INVALID_REF_FORMAT` detector
|
|
52
|
+
* (walk-time, for type-asserted fixtures that bypass parsing).
|
|
53
|
+
* Exported precisely so the two checks can never drift apart: a
|
|
54
|
+
* hand-duplicated regex is the exact drift class this family exists
|
|
55
|
+
* to catch.
|
|
56
|
+
*/
|
|
57
|
+
export const ASSERTION_REF_PATTERN = /^assertion-[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Spec-level identity of one assertion (NEVER `id`).
|
|
61
|
+
* Kebab-case, `assertion-` prefixed — see `AssertionRefSchema`.
|
|
62
|
+
*/
|
|
63
|
+
export type AssertionRef = string;
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Cross-family ref to a deterministic pin backing an assertion —
|
|
67
|
+
* a Zod contract + unit-test pair that machine-checks the asserted
|
|
68
|
+
* shape (master plan S1 held condition (a): deterministic pins
|
|
69
|
+
* survive underneath the query surface; LLM interpretation can never
|
|
70
|
+
* soften a failing pin). The ref vocabulary is owned by the pin
|
|
71
|
+
* suites themselves (e.g. a vitest suite name or a
|
|
72
|
+
* `<package-short>:<ExportName>` schema ref per implementation-spec
|
|
73
|
+
* P-33); this family stores it as an opaque flat string.
|
|
74
|
+
*/
|
|
75
|
+
export type AssertionPinRef = string;
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Enforced ref contract: kebab-case, `assertion-` prefix, lowercase
|
|
79
|
+
* alphanumeric segments separated by single dashes.
|
|
80
|
+
*
|
|
81
|
+
* Valid: `assertion-file-journal-deferred`,
|
|
82
|
+
* `assertion-p17-provider-configurations`.
|
|
83
|
+
* Invalid: `file-journal` (no prefix), `assertion-` (empty slug),
|
|
84
|
+
* `assertion-Foo` (uppercase), `assertion--double-dash`.
|
|
85
|
+
*/
|
|
86
|
+
export const AssertionRefSchema = z
|
|
87
|
+
.string()
|
|
88
|
+
.regex(
|
|
89
|
+
ASSERTION_REF_PATTERN,
|
|
90
|
+
`assertion refs must be kebab-case and start with "${ASSERTION_REF_PREFIX}"`,
|
|
91
|
+
);
|
|
92
|
+
```
|
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
# assertions.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
|
|
14
|
+
* `AssertionSpecificationSnapshot`.
|
|
15
|
+
*
|
|
16
|
+
* The function is a **pure**, **typed** graph walker over the
|
|
17
|
+
* snapshot — no Zod introspection, no registry access, no I/O (the
|
|
18
|
+
* `_core` validator convention: registries and live behavior-id sets
|
|
19
|
+
* belong to the companion; callers that HAVE them pass them in via
|
|
20
|
+
* options, and every cross-set check FAILS SOFT when its set is
|
|
21
|
+
* absent — same skip-when-omitted semantics as
|
|
22
|
+
* `validateMarketSnapshot`'s cross-family refs).
|
|
23
|
+
*
|
|
24
|
+
* Rule table — 8 kinds:
|
|
25
|
+
*
|
|
26
|
+
* | Kind | Severity | Trigger |
|
|
27
|
+
* |-------------------------------|----------|------------------------------------------------------------------------------------------------------------|
|
|
28
|
+
* | `ENTRY_KEY_REF_MISMATCH` | ERROR | `entries[key].ref !== key`. Hand-assembled maps only — `buildAssertionSpecificationMap` cannot produce it. |
|
|
29
|
+
* | `INVALID_REF_FORMAT` | ERROR | Ref fails `ASSERTION_REF_PATTERN` (shared with the Zod schema — one source of truth). Defence in depth for type-asserted fixtures. |
|
|
30
|
+
* | `ORPHAN_PIN_REF` | ERROR | A `reconciliation.pinRefs` entry is absent from `options.availablePinRefs`. SKIPPED when no set is passed. |
|
|
31
|
+
* | `DUPLICATE_PIN_REF` | WARN | The same pin ref appears more than once in one entry's `reconciliation.pinRefs` (market `DUPLICATE_EDGE_PER_ENTITY` parity). |
|
|
32
|
+
* | `UNKNOWN_PROBE_BEHAVIOR` | ERROR | `reconciliation.probe.behaviorId` is absent from `options.availableIntrospectionBehaviorIds`. SKIPPED when no set is passed. |
|
|
33
|
+
* | `PINNED_CONTRACT_WITHOUT_PIN` | WARN | `kind: PINNED_CONTRACT` but `reconciliation.pinRefs` is empty — the claimed trust floor does not exist. |
|
|
34
|
+
* | `DERIVED_LIVE_WITHOUT_PROBE` | WARN | `kind: DERIVED_LIVE` but no `reconciliation.probe` — the claim cannot be derived, so it will rot. |
|
|
35
|
+
* | `STALE_AUTHORED` | WARN | `authoredMetadata.lastAuthoredAt + reviewCadence < now`. No check when `reviewCadence` is undefined or `AS_NEEDED`. |
|
|
36
|
+
*
|
|
37
|
+
* The wrapper `version` field is deliberately NOT walker-checked
|
|
38
|
+
* (asymmetry with `INVALID_REF_FORMAT` is intentional): a malformed
|
|
39
|
+
* ref silently splits the audit surface, while a type-asserted
|
|
40
|
+
* unknown version only affects era-branching consumers — the walker
|
|
41
|
+
* stays entry-focused and leaves the closed version enum to Zod.
|
|
42
|
+
*
|
|
43
|
+
* Issue ordering inside `result.issues[]` is detector-order, then
|
|
44
|
+
* snapshot-walk order. It is **not** a stable contract — callers must
|
|
45
|
+
* group/sort by `kind` + `severity` themselves.
|
|
46
|
+
*
|
|
47
|
+
* Severity is a TS enum (project rule: enums over literal unions for
|
|
48
|
+
* fixed vocabularies) — a deliberate correction of the market
|
|
49
|
+
* family's legacy `'ERROR' | 'WARN'` string union.
|
|
50
|
+
*
|
|
51
|
+
* The validator never mutates the snapshot.
|
|
52
|
+
*/
|
|
53
|
+
export enum AssertionSnapshotIssueKind {
|
|
54
|
+
/**
|
|
55
|
+
* `entries[key].ref !== key` — the keyed map and the entry disagree
|
|
56
|
+
* about identity. Downstream consumers index by key while reconcile
|
|
57
|
+
* reports by ref, so a mismatch silently splits one assertion into
|
|
58
|
+
* two half-visible ones. ERROR.
|
|
59
|
+
*/
|
|
60
|
+
ENTRY_KEY_REF_MISMATCH = 'entry_key_ref_mismatch',
|
|
61
|
+
/**
|
|
62
|
+
* Ref violates the kebab-case `assertion-` prefix contract. The
|
|
63
|
+
* Zod schema already rejects this at parse time; the detector
|
|
64
|
+
* remains as defence in depth for callers that bypass parsing
|
|
65
|
+
* (legitimate scenario: tests building snapshots with type-asserted
|
|
66
|
+
* fixtures). ERROR.
|
|
67
|
+
*/
|
|
68
|
+
INVALID_REF_FORMAT = 'invalid_ref_format',
|
|
69
|
+
/**
|
|
70
|
+
* A `reconciliation.pinRefs` entry does not resolve inside the
|
|
71
|
+
* caller-supplied pin-ref set. An orphan pin means the assertion
|
|
72
|
+
* CLAIMS a deterministic trust floor that does not exist — worse
|
|
73
|
+
* than claiming none, because consumers trust the claim. ERROR
|
|
74
|
+
* (only when `availablePinRefs` is passed; fail-soft otherwise).
|
|
75
|
+
*/
|
|
76
|
+
ORPHAN_PIN_REF = 'orphan_pin_ref',
|
|
77
|
+
/**
|
|
78
|
+
* The same pin ref appears more than once in one entry's
|
|
79
|
+
* `reconciliation.pinRefs`. An authoring slip (copy-paste), not a
|
|
80
|
+
* correctness hazard — reconcile evaluates pins as a set — so WARN,
|
|
81
|
+
* mirroring the market family's `DUPLICATE_EDGE_PER_ENTITY` posture.
|
|
82
|
+
*/
|
|
83
|
+
DUPLICATE_PIN_REF = 'duplicate_pin_ref',
|
|
84
|
+
/**
|
|
85
|
+
* `reconciliation.probe.behaviorId` does not resolve inside the
|
|
86
|
+
* caller-supplied introspection behavior-id set — the probe can
|
|
87
|
+
* never run, so reconcile silently degrades to `assumed`. ERROR
|
|
88
|
+
* (only when `availableIntrospectionBehaviorIds` is passed;
|
|
89
|
+
* fail-soft otherwise).
|
|
90
|
+
*/
|
|
91
|
+
UNKNOWN_PROBE_BEHAVIOR = 'unknown_probe_behavior',
|
|
92
|
+
/** `PINNED_CONTRACT` entry with empty `pinRefs` — kind/reconciliation drift (WARN). */
|
|
93
|
+
PINNED_CONTRACT_WITHOUT_PIN = 'pinned_contract_without_pin',
|
|
94
|
+
/** `DERIVED_LIVE` entry with no `probe` — the claim cannot be derived at query time (WARN). */
|
|
95
|
+
DERIVED_LIVE_WITHOUT_PROBE = 'derived_live_without_probe',
|
|
96
|
+
/** `lastAuthoredAt + reviewCadence < now` (WARN — same semantics as the market family). */
|
|
97
|
+
STALE_AUTHORED = 'stale_authored',
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export enum AssertionSnapshotIssueSeverity {
|
|
101
|
+
ERROR = 'error',
|
|
102
|
+
WARN = 'warn',
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export interface AssertionSnapshotIssue {
|
|
106
|
+
kind: AssertionSnapshotIssueKind;
|
|
107
|
+
/** Dotted path inside the snapshot (e.g. `'entries["assertion-x"].reconciliation.pinRefs[0]'`). */
|
|
108
|
+
path: string;
|
|
109
|
+
message: string;
|
|
110
|
+
severity: AssertionSnapshotIssueSeverity;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export interface AssertionSnapshotValidationResult {
|
|
114
|
+
/** `true` iff no issue has severity `ERROR`. */
|
|
115
|
+
ok: boolean;
|
|
116
|
+
issues: AssertionSnapshotIssue[];
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export interface ValidateAssertionSpecificationSnapshotOptions {
|
|
120
|
+
/**
|
|
121
|
+
* Cross-set check for `reconciliation.pinRefs`. Pass the known
|
|
122
|
+
* deterministic-pin ref set; orphans are reported as
|
|
123
|
+
* `ORPHAN_PIN_REF`. When omitted, the check is SKIPPED (fail-soft
|
|
124
|
+
* — the pin registry is companion/tooling-side and not every caller
|
|
125
|
+
* has it).
|
|
126
|
+
*/
|
|
127
|
+
availablePinRefs?: ReadonlySet<AssertionPinRef>;
|
|
128
|
+
/**
|
|
129
|
+
* Cross-set check for `reconciliation.probe.behaviorId`. Pass the
|
|
130
|
+
* live companion introspection behavior-id set; unknowns are
|
|
131
|
+
* reported as `UNKNOWN_PROBE_BEHAVIOR`. Same skip-when-omitted
|
|
132
|
+
* semantics.
|
|
133
|
+
*/
|
|
134
|
+
availableIntrospectionBehaviorIds?: ReadonlySet<string>;
|
|
135
|
+
/** Override "now" for `STALE_AUTHORED` checks (test affordance). Defaults to `new Date()`. */
|
|
136
|
+
now?: Date;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Days-per-cadence mapping, mirrored from the market validator
|
|
141
|
+
* (module-local there too — a shared promotion is part of the
|
|
142
|
+
* deferred authored-metadata generalization, see the P-5 note in
|
|
143
|
+
* `assertion-authored-metadata.schemas.ts`).
|
|
144
|
+
*/
|
|
145
|
+
const REVIEW_CADENCE_TO_DAYS: Record<ReviewCadence, number> = {
|
|
146
|
+
[ReviewCadence.WEEKLY]: 7,
|
|
147
|
+
[ReviewCadence.MONTHLY]: 31,
|
|
148
|
+
[ReviewCadence.QUARTERLY]: 92,
|
|
149
|
+
[ReviewCadence.YEARLY]: 366,
|
|
150
|
+
[ReviewCadence.AS_NEEDED]: Number.POSITIVE_INFINITY,
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
export function validateAssertionSpecificationSnapshot(
|
|
154
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
155
|
+
options?: ValidateAssertionSpecificationSnapshotOptions,
|
|
156
|
+
): AssertionSnapshotValidationResult {
|
|
157
|
+
const issues: AssertionSnapshotIssue[] = [];
|
|
158
|
+
|
|
159
|
+
detectKeyRefMismatches(snapshot, issues);
|
|
160
|
+
detectInvalidRefFormats(snapshot, issues);
|
|
161
|
+
detectOrphanPinRefs(snapshot, options, issues);
|
|
162
|
+
detectDuplicatePinRefs(snapshot, issues);
|
|
163
|
+
detectUnknownProbeBehaviors(snapshot, options, issues);
|
|
164
|
+
detectKindReconciliationDrift(snapshot, issues);
|
|
165
|
+
detectStaleAuthored(snapshot, options?.now ?? new Date(), issues);
|
|
166
|
+
|
|
167
|
+
const ok = issues.every(issue => issue.severity !== AssertionSnapshotIssueSeverity.ERROR);
|
|
168
|
+
return { ok, issues };
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
// ────────────────────────────────────────────────────────────────────
|
|
172
|
+
// Detectors — one per rule, kept small and independently testable.
|
|
173
|
+
// ────────────────────────────────────────────────────────────────────
|
|
174
|
+
|
|
175
|
+
function detectKeyRefMismatches(
|
|
176
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
177
|
+
issues: AssertionSnapshotIssue[],
|
|
178
|
+
): void {
|
|
179
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
180
|
+
if (entry.ref === key) continue;
|
|
181
|
+
issues.push({
|
|
182
|
+
kind: AssertionSnapshotIssueKind.ENTRY_KEY_REF_MISMATCH,
|
|
183
|
+
path: `entries["${key}"].ref`,
|
|
184
|
+
message: `Entry keyed "${key}" carries ref "${entry.ref}". Key and ref must agree — use buildAssertionSpecificationMap() to derive keys from refs.`,
|
|
185
|
+
severity: AssertionSnapshotIssueSeverity.ERROR,
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
function detectInvalidRefFormats(
|
|
191
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
192
|
+
issues: AssertionSnapshotIssue[],
|
|
193
|
+
): void {
|
|
194
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
195
|
+
if (ASSERTION_REF_PATTERN.test(entry.ref)) continue;
|
|
196
|
+
issues.push({
|
|
197
|
+
kind: AssertionSnapshotIssueKind.INVALID_REF_FORMAT,
|
|
198
|
+
path: `entries["${key}"].ref`,
|
|
199
|
+
message: `Assertion ref "${entry.ref}" is not kebab-case with the "assertion-" prefix.`,
|
|
200
|
+
severity: AssertionSnapshotIssueSeverity.ERROR,
|
|
201
|
+
});
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
function detectOrphanPinRefs(
|
|
206
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
207
|
+
options: ValidateAssertionSpecificationSnapshotOptions | undefined,
|
|
208
|
+
issues: AssertionSnapshotIssue[],
|
|
209
|
+
): void {
|
|
210
|
+
if (options?.availablePinRefs === undefined) return;
|
|
211
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
212
|
+
entry.reconciliation.pinRefs.forEach((pinRef, index) => {
|
|
213
|
+
if (options.availablePinRefs!.has(pinRef)) return;
|
|
214
|
+
issues.push({
|
|
215
|
+
kind: AssertionSnapshotIssueKind.ORPHAN_PIN_REF,
|
|
216
|
+
path: `entries["${key}"].reconciliation.pinRefs[${index}]`,
|
|
217
|
+
message: `Pin ref "${pinRef}" on assertion "${entry.ref}" does not resolve in the supplied pin-ref set.`,
|
|
218
|
+
severity: AssertionSnapshotIssueSeverity.ERROR,
|
|
219
|
+
});
|
|
220
|
+
});
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
function detectDuplicatePinRefs(
|
|
225
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
226
|
+
issues: AssertionSnapshotIssue[],
|
|
227
|
+
): void {
|
|
228
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
229
|
+
const seen = new Set<string>();
|
|
230
|
+
entry.reconciliation.pinRefs.forEach((pinRef, index) => {
|
|
231
|
+
if (!seen.has(pinRef)) {
|
|
232
|
+
seen.add(pinRef);
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
issues.push({
|
|
236
|
+
kind: AssertionSnapshotIssueKind.DUPLICATE_PIN_REF,
|
|
237
|
+
path: `entries["${key}"].reconciliation.pinRefs[${index}]`,
|
|
238
|
+
message: `Pin ref "${pinRef}" is listed more than once on assertion "${entry.ref}". Remove the duplicate.`,
|
|
239
|
+
severity: AssertionSnapshotIssueSeverity.WARN,
|
|
240
|
+
});
|
|
241
|
+
});
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
function detectUnknownProbeBehaviors(
|
|
246
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
247
|
+
options: ValidateAssertionSpecificationSnapshotOptions | undefined,
|
|
248
|
+
issues: AssertionSnapshotIssue[],
|
|
249
|
+
): void {
|
|
250
|
+
if (options?.availableIntrospectionBehaviorIds === undefined) return;
|
|
251
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
252
|
+
const probe = entry.reconciliation.probe;
|
|
253
|
+
if (probe === undefined) continue;
|
|
254
|
+
if (options.availableIntrospectionBehaviorIds.has(probe.behaviorId)) continue;
|
|
255
|
+
issues.push({
|
|
256
|
+
kind: AssertionSnapshotIssueKind.UNKNOWN_PROBE_BEHAVIOR,
|
|
257
|
+
path: `entries["${key}"].reconciliation.probe.behaviorId`,
|
|
258
|
+
message: `Probe behavior "${probe.behaviorId}" on assertion "${entry.ref}" is not a known introspection behavior id.`,
|
|
259
|
+
severity: AssertionSnapshotIssueSeverity.ERROR,
|
|
260
|
+
});
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* Kind ↔ reconciliation coherence. WARN, not ERROR: the entry still
|
|
266
|
+
* parses and serves; it just cannot be reconciled the way its kind
|
|
267
|
+
* promises — surfaced so authors either add the missing channel or
|
|
268
|
+
* downgrade the kind to `ASSUMED_FUTURE` (which legitimately carries
|
|
269
|
+
* neither).
|
|
270
|
+
*/
|
|
271
|
+
function detectKindReconciliationDrift(
|
|
272
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
273
|
+
issues: AssertionSnapshotIssue[],
|
|
274
|
+
): void {
|
|
275
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
276
|
+
if (entry.kind === AssertionKind.PINNED_CONTRACT && entry.reconciliation.pinRefs.length === 0) {
|
|
277
|
+
issues.push({
|
|
278
|
+
kind: AssertionSnapshotIssueKind.PINNED_CONTRACT_WITHOUT_PIN,
|
|
279
|
+
path: `entries["${key}"].reconciliation.pinRefs`,
|
|
280
|
+
message: `Assertion "${entry.ref}" is PINNED_CONTRACT but lists no pinRefs. Add the pin refs or downgrade kind to ASSUMED_FUTURE.`,
|
|
281
|
+
severity: AssertionSnapshotIssueSeverity.WARN,
|
|
282
|
+
});
|
|
283
|
+
}
|
|
284
|
+
if (entry.kind === AssertionKind.DERIVED_LIVE && entry.reconciliation.probe === undefined) {
|
|
285
|
+
issues.push({
|
|
286
|
+
kind: AssertionSnapshotIssueKind.DERIVED_LIVE_WITHOUT_PROBE,
|
|
287
|
+
path: `entries["${key}"].reconciliation.probe`,
|
|
288
|
+
message: `Assertion "${entry.ref}" is DERIVED_LIVE but carries no probe. Add a probe or downgrade kind to ASSUMED_FUTURE.`,
|
|
289
|
+
severity: AssertionSnapshotIssueSeverity.WARN,
|
|
290
|
+
});
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
function detectStaleAuthored(
|
|
296
|
+
snapshot: AssertionSpecificationSnapshot,
|
|
297
|
+
now: Date,
|
|
298
|
+
issues: AssertionSnapshotIssue[],
|
|
299
|
+
): void {
|
|
300
|
+
for (const [key, entry] of Object.entries(snapshot.entries)) {
|
|
301
|
+
const authored = entry.authoredMetadata;
|
|
302
|
+
if (authored.reviewCadence === undefined) continue;
|
|
303
|
+
const days = REVIEW_CADENCE_TO_DAYS[authored.reviewCadence];
|
|
304
|
+
if (!Number.isFinite(days)) continue;
|
|
305
|
+
const lastAuthored = new Date(authored.lastAuthoredAt).getTime();
|
|
306
|
+
if (Number.isNaN(lastAuthored)) continue;
|
|
307
|
+
const ageDays = (now.getTime() - lastAuthored) / (24 * 60 * 60 * 1000);
|
|
308
|
+
if (ageDays <= days) continue;
|
|
309
|
+
issues.push({
|
|
310
|
+
kind: AssertionSnapshotIssueKind.STALE_AUTHORED,
|
|
311
|
+
path: `entries["${key}"].authoredMetadata`,
|
|
312
|
+
message: `Assertion "${entry.ref}" is ${Math.floor(ageDays)} days old (cadence ${authored.reviewCadence} ⇒ ${days}d). Re-author or remove the cadence.`,
|
|
313
|
+
severity: AssertionSnapshotIssueSeverity.WARN,
|
|
314
|
+
});
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
```
|