@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,544 @@
|
|
|
1
|
+
# market.context-block.builder
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/dev-companion`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/dev-companion`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Pure builder that renders an English "market context" prose block
|
|
14
|
+
* from a validated `MarketSnapshot`. The block is consumed by:
|
|
15
|
+
*
|
|
16
|
+
* - the dev-companion subprocess behaviors `market-context-for-feature`
|
|
17
|
+
* and `market-context-for-icp` (Phase 4.1);
|
|
18
|
+
* - the market generation CLI (`wildo market generate`) which
|
|
19
|
+
* concatenates the block with a `MarketMessageTemplate.promptTemplate`
|
|
20
|
+
* before sending to the LLM (Phase 4.2).
|
|
21
|
+
*
|
|
22
|
+
* **Pure function — no I/O, no DI, no runtime registry access, no
|
|
23
|
+
* mutation of the input snapshot.** The same `(snapshot, intent)`
|
|
24
|
+
* input always renders the same output (deterministic section order,
|
|
25
|
+
* deterministic ICP / benefit ordering by ref). This keeps the block
|
|
26
|
+
* trivial to snapshot-test and trivial to diff between snapshot
|
|
27
|
+
* versions.
|
|
28
|
+
*
|
|
29
|
+
* **English-only by contract (D15 / §12).** When `outputLanguage` is
|
|
30
|
+
* provided, the builder appends an "Output language" instruction line
|
|
31
|
+
* for the LLM, but does NOT translate any of the content above it.
|
|
32
|
+
* Translation happens at LLM-output time, never inside the spec.
|
|
33
|
+
*
|
|
34
|
+
* **Intent kinds:**
|
|
35
|
+
* - `{ kind: 'feature', featureRef }` — answers "I'm editing this
|
|
36
|
+
* feature, what is its market context?". Surfaces every benefit
|
|
37
|
+
* whose `deliveredByFeatureRefs[]` contains `featureRef`, the
|
|
38
|
+
* ICPs those benefits matter to, and the anti-target ICPs that
|
|
39
|
+
* would be repelled by them.
|
|
40
|
+
* - `{ kind: 'icp', icpRef }` — answers "I'm writing copy for this
|
|
41
|
+
* ICP, what's their world?". Surfaces the ICP's pains/gains/jobs,
|
|
42
|
+
* the benefits whose `importanceByICP[]` weights them at >= 5,
|
|
43
|
+
* and their preferred voice.
|
|
44
|
+
*
|
|
45
|
+
* **Section order (load-bearing — consumers may rely on it):**
|
|
46
|
+
* 1. `## Market context` header (with intent line)
|
|
47
|
+
* 2. `### Category`
|
|
48
|
+
* 3. `### Benefits in scope`
|
|
49
|
+
* 4. `### Most-affected ICPs`
|
|
50
|
+
* 5. `### Anti-target ICPs (do not pitch)`
|
|
51
|
+
* 6. `### Tone of voice`
|
|
52
|
+
* 7. `### Open questions / low-confidence entries` (skipped if empty)
|
|
53
|
+
* 8. `### Output language` (only when `outputLanguage` is set)
|
|
54
|
+
*
|
|
55
|
+
* Empty sections are kept (with an explicit `_(none)_` line) for
|
|
56
|
+
* sections 2–6 so the LLM sees the absence rather than silently
|
|
57
|
+
* inferring it. Section 7 is the lone exception — empty
|
|
58
|
+
* "low-confidence" lists carry no signal and are dropped.
|
|
59
|
+
*/
|
|
60
|
+
export interface MarketContextBlockInput {
|
|
61
|
+
/** Validated `MarketSnapshot`. Caller is responsible for running
|
|
62
|
+
* `validateMarketSnapshot` first; this builder trusts the input. */
|
|
63
|
+
snapshot: MarketSnapshot;
|
|
64
|
+
intent:
|
|
65
|
+
| { kind: 'feature'; featureRef: string }
|
|
66
|
+
| { kind: 'icp'; icpRef: string };
|
|
67
|
+
/** Optional BCP-47 tag (e.g. `'fr'`, `'pt-BR'`). When set, the
|
|
68
|
+
* builder appends an "Output language" instruction; never
|
|
69
|
+
* translates the body. */
|
|
70
|
+
outputLanguage?: string;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Trace of the entities the builder considered. Useful for the CLI's
|
|
75
|
+
* `--explain` mode and for unit tests that assert "the builder
|
|
76
|
+
* picked the right ICP" without parsing prose.
|
|
77
|
+
*
|
|
78
|
+
* **Schema contract.** This interface is intentionally kept
|
|
79
|
+
* structurally compatible with the public `MarketContextBlockTraceSchema`
|
|
80
|
+
* contract exported by `@wildo-ai/saas-specifications`
|
|
81
|
+
* — the Phase-4.2 market generation CLI parses the companion HTTP
|
|
82
|
+
* response against that Zod schema. Any drift between this
|
|
83
|
+
* interface and that schema must be reflected on **both** sides
|
|
84
|
+
* (the schema is the cross-process contract; this interface is the
|
|
85
|
+
* local renderer typing).
|
|
86
|
+
*/
|
|
87
|
+
export interface MarketContextBlockTrace {
|
|
88
|
+
/** Refs of every ICP whose section was rendered. Order matches
|
|
89
|
+
* the rendered output: feature intent → score-desc / priority /
|
|
90
|
+
* ref; icp intent → single requested ref or empty. */
|
|
91
|
+
icpsConsidered: string[];
|
|
92
|
+
/** Ordered (by ref) refs of every benefit whose section was rendered. */
|
|
93
|
+
benefitsConsidered: string[];
|
|
94
|
+
/** Ref of the tone of voice whose do/don't were rendered, or `null`. */
|
|
95
|
+
voiceUsed: string | null;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export interface MarketContextBlockResult {
|
|
99
|
+
/** English markdown prose, ready to concatenate with a template. */
|
|
100
|
+
block: string;
|
|
101
|
+
trace: MarketContextBlockTrace;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
const ICP_PRIORITY_RANK: Record<ICPPriority, number> = {
|
|
105
|
+
[ICPPriority.CORE]: 0,
|
|
106
|
+
[ICPPriority.EXPANSION]: 1,
|
|
107
|
+
[ICPPriority.EXPLORATORY]: 2,
|
|
108
|
+
[ICPPriority.DEFERRED]: 3,
|
|
109
|
+
[ICPPriority.ANTI_TARGET]: 4,
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
/** Per-ICP fitness threshold for the `icp` intent's "Benefits in scope"
|
|
113
|
+
* section. Benefits with `importanceByICP[icp].weight >= 5` are
|
|
114
|
+
* considered relevant; below 5 the benefit is "noise" for that ICP. */
|
|
115
|
+
const ICP_BENEFIT_RELEVANCE_THRESHOLD = 5;
|
|
116
|
+
|
|
117
|
+
/** Maximum number of "Most-affected ICPs" lines rendered for the
|
|
118
|
+
* `feature` intent. Plan §10.2 caps at 3: the prompt should
|
|
119
|
+
* surface the *primary* audiences for a feature edit, not enumerate
|
|
120
|
+
* every ICP that mentioned it. The cap also keeps prompts short for
|
|
121
|
+
* snapshots with dozens of ICPs. */
|
|
122
|
+
const MAX_AFFECTED_ICPS_RENDERED = 3;
|
|
123
|
+
|
|
124
|
+
/** Defensive cap on the `outputLanguage` value rendered into the
|
|
125
|
+
* prompt. BCP-47 language tags are short by spec (the longest
|
|
126
|
+
* registered tag is well under 35 chars); a value longer than this
|
|
127
|
+
* is a misuse — most likely a caller pasted a paragraph instead of
|
|
128
|
+
* a tag. We refuse rather than silently embed garbage in the LLM
|
|
129
|
+
* prompt. The companion handlers also validate at the request
|
|
130
|
+
* boundary; this is a defense-in-depth guard for direct callers. */
|
|
131
|
+
const MAX_OUTPUT_LANGUAGE_LENGTH = 64;
|
|
132
|
+
|
|
133
|
+
export function buildMarketContextBlock(
|
|
134
|
+
input: MarketContextBlockInput,
|
|
135
|
+
): MarketContextBlockResult {
|
|
136
|
+
const { snapshot, intent, outputLanguage } = input;
|
|
137
|
+
|
|
138
|
+
const icpsByRef = new Map(snapshot.icps.map(icp => [icp.ref, icp] as const));
|
|
139
|
+
const benefitsByRef = new Map(snapshot.benefits.map(b => [b.ref, b] as const));
|
|
140
|
+
const voicesByRef = new Map(snapshot.tonesOfVoice.map(v => [v.ref, v] as const));
|
|
141
|
+
|
|
142
|
+
const benefitsInScope = collectBenefitsInScope(snapshot, intent);
|
|
143
|
+
const affectedIcps = collectAffectedIcps(intent, benefitsInScope, icpsByRef);
|
|
144
|
+
const antiTargetIcps = snapshot.icps
|
|
145
|
+
.filter(icp => icp.priority === ICPPriority.ANTI_TARGET)
|
|
146
|
+
.slice()
|
|
147
|
+
.sort(compareByRef);
|
|
148
|
+
|
|
149
|
+
const voice = pickPreferredVoice({
|
|
150
|
+
intent,
|
|
151
|
+
icpsByRef,
|
|
152
|
+
affectedIcps,
|
|
153
|
+
voicesByRef,
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
const lowConfidenceEntries = collectLowConfidenceEntries({
|
|
157
|
+
intent,
|
|
158
|
+
snapshot,
|
|
159
|
+
benefitsInScope,
|
|
160
|
+
affectedIcps,
|
|
161
|
+
});
|
|
162
|
+
|
|
163
|
+
const lines: string[] = [];
|
|
164
|
+
|
|
165
|
+
lines.push(renderHeader(intent));
|
|
166
|
+
lines.push('');
|
|
167
|
+
lines.push(renderCategorySection(snapshot));
|
|
168
|
+
lines.push('');
|
|
169
|
+
lines.push(renderBenefitsSection(benefitsInScope));
|
|
170
|
+
lines.push('');
|
|
171
|
+
lines.push(renderAffectedIcpsSection(affectedIcps, intent, benefitsInScope));
|
|
172
|
+
lines.push('');
|
|
173
|
+
lines.push(renderAntiTargetSection(antiTargetIcps));
|
|
174
|
+
lines.push('');
|
|
175
|
+
lines.push(renderVoiceSection(voice));
|
|
176
|
+
|
|
177
|
+
if (lowConfidenceEntries.length > 0) {
|
|
178
|
+
lines.push('');
|
|
179
|
+
lines.push(renderLowConfidenceSection(lowConfidenceEntries));
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
const normalizedOutputLanguage = normalizeOutputLanguage(outputLanguage);
|
|
183
|
+
if (normalizedOutputLanguage) {
|
|
184
|
+
lines.push('');
|
|
185
|
+
lines.push(renderOutputLanguageSection(normalizedOutputLanguage));
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
return {
|
|
189
|
+
block: lines.join('\n'),
|
|
190
|
+
trace: {
|
|
191
|
+
icpsConsidered: affectedIcps.map(icp => icp.ref),
|
|
192
|
+
benefitsConsidered: benefitsInScope.map(b => b.ref),
|
|
193
|
+
voiceUsed: voice?.ref ?? null,
|
|
194
|
+
},
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
// ---------------------------------------------------------------------------
|
|
199
|
+
// Collection helpers
|
|
200
|
+
// ---------------------------------------------------------------------------
|
|
201
|
+
|
|
202
|
+
function collectBenefitsInScope(
|
|
203
|
+
snapshot: MarketSnapshot,
|
|
204
|
+
intent: MarketContextBlockInput['intent'],
|
|
205
|
+
): FeatureBenefitConfig[] {
|
|
206
|
+
if (intent.kind === 'feature') {
|
|
207
|
+
return snapshot.benefits
|
|
208
|
+
.filter(b => b.deliveredByFeatureRefs.includes(intent.featureRef))
|
|
209
|
+
.slice()
|
|
210
|
+
.sort(compareByRef);
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
return snapshot.benefits
|
|
214
|
+
.filter(b =>
|
|
215
|
+
b.importanceByICP.some(
|
|
216
|
+
imp =>
|
|
217
|
+
imp.icpRef === intent.icpRef &&
|
|
218
|
+
imp.weight >= ICP_BENEFIT_RELEVANCE_THRESHOLD,
|
|
219
|
+
),
|
|
220
|
+
)
|
|
221
|
+
.slice()
|
|
222
|
+
.sort(compareByRef);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* Per-ICP score for the `feature` intent's `### Most-affected ICPs`
|
|
227
|
+
* ranking. Plan §10.2 calls for `weight × pain/gain degree`. Concretely:
|
|
228
|
+
*
|
|
229
|
+
* score(icp) = max over benefits-in-scope of (
|
|
230
|
+
* importanceByICP[icp].weight × max(degree across that benefit's
|
|
231
|
+
* relieves[] / creates[] / advances[] edges)
|
|
232
|
+
* )
|
|
233
|
+
*
|
|
234
|
+
* **Why max-of-max instead of a sum.** A benefit's degree edges are
|
|
235
|
+
* authored as "this benefit relieves pain X to degree 9" — they
|
|
236
|
+
* describe the **strength of one outcome**, not a list of outcomes
|
|
237
|
+
* to add up. Summing across edges would over-weight benefits with
|
|
238
|
+
* many shallow edges; summing across benefits would over-weight ICPs
|
|
239
|
+
* that appear on lots of mid-importance benefits. The signal we want
|
|
240
|
+
* for "most-affected ICPs" is "what is the strongest claim this
|
|
241
|
+
* feature lets us make for this ICP", which is a max-of-max.
|
|
242
|
+
*
|
|
243
|
+
* **Tie-breaks are deterministic** (rank → ref) so the rendered
|
|
244
|
+
* output is snapshot-stable.
|
|
245
|
+
*/
|
|
246
|
+
function scoreIcpForFeatureIntent(
|
|
247
|
+
icpRef: string,
|
|
248
|
+
benefitsInScope: FeatureBenefitConfig[],
|
|
249
|
+
): number {
|
|
250
|
+
let best = 0;
|
|
251
|
+
for (const benefit of benefitsInScope) {
|
|
252
|
+
const weight = benefit.importanceByICP.find(imp => imp.icpRef === icpRef)?.weight;
|
|
253
|
+
if (weight === undefined || weight <= 0) continue;
|
|
254
|
+
let bestDegree = 0;
|
|
255
|
+
for (const edge of benefit.relieves) bestDegree = Math.max(bestDegree, edge.degree);
|
|
256
|
+
for (const edge of benefit.creates) bestDegree = Math.max(bestDegree, edge.degree);
|
|
257
|
+
for (const edge of benefit.advances) bestDegree = Math.max(bestDegree, edge.degree);
|
|
258
|
+
// Benefits with no degree edges still carry weight signal — use 1
|
|
259
|
+
// as a neutral multiplier so a weight-only ranking still differentiates.
|
|
260
|
+
const benefitScore = weight * (bestDegree > 0 ? bestDegree : 1);
|
|
261
|
+
if (benefitScore > best) best = benefitScore;
|
|
262
|
+
}
|
|
263
|
+
return best;
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
function collectAffectedIcps(
|
|
267
|
+
intent: MarketContextBlockInput['intent'],
|
|
268
|
+
benefitsInScope: FeatureBenefitConfig[],
|
|
269
|
+
icpsByRef: Map<string, MarketICPConfig>,
|
|
270
|
+
): MarketICPConfig[] {
|
|
271
|
+
if (intent.kind === 'icp') {
|
|
272
|
+
const icp = icpsByRef.get(intent.icpRef);
|
|
273
|
+
return icp ? [icp] : [];
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
const refs = new Set<string>();
|
|
277
|
+
for (const benefit of benefitsInScope) {
|
|
278
|
+
for (const imp of benefit.importanceByICP) {
|
|
279
|
+
refs.add(imp.icpRef);
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
type ScoredIcp = { icp: MarketICPConfig; score: number };
|
|
284
|
+
const scored: ScoredIcp[] = [];
|
|
285
|
+
for (const ref of refs) {
|
|
286
|
+
const icp = icpsByRef.get(ref);
|
|
287
|
+
if (!icp || icp.priority === ICPPriority.ANTI_TARGET) continue;
|
|
288
|
+
scored.push({ icp, score: scoreIcpForFeatureIntent(ref, benefitsInScope) });
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
// Primary sort: weighted score (descending). Ties: priority rank
|
|
292
|
+
// (CORE before EXPANSION before lower priorities). Final tie-break:
|
|
293
|
+
// ref (alphabetical) for snapshot-stable output.
|
|
294
|
+
scored.sort((a, b) => {
|
|
295
|
+
if (a.score !== b.score) return b.score - a.score;
|
|
296
|
+
const rankDelta = ICP_PRIORITY_RANK[a.icp.priority] - ICP_PRIORITY_RANK[b.icp.priority];
|
|
297
|
+
if (rankDelta !== 0) return rankDelta;
|
|
298
|
+
return compareByRef(a.icp, b.icp);
|
|
299
|
+
});
|
|
300
|
+
|
|
301
|
+
return scored.slice(0, MAX_AFFECTED_ICPS_RENDERED).map(entry => entry.icp);
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
function pickPreferredVoice(params: {
|
|
305
|
+
intent: MarketContextBlockInput['intent'];
|
|
306
|
+
icpsByRef: Map<string, MarketICPConfig>;
|
|
307
|
+
affectedIcps: MarketICPConfig[];
|
|
308
|
+
voicesByRef: Map<string, ToneOfVoiceConfig>;
|
|
309
|
+
}): ToneOfVoiceConfig | null {
|
|
310
|
+
const { intent, icpsByRef, affectedIcps, voicesByRef } = params;
|
|
311
|
+
|
|
312
|
+
if (intent.kind === 'icp') {
|
|
313
|
+
const icp = icpsByRef.get(intent.icpRef);
|
|
314
|
+
if (icp?.preferredVoiceRef) {
|
|
315
|
+
const voice = voicesByRef.get(icp.preferredVoiceRef);
|
|
316
|
+
if (voice) return voice;
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
for (const icp of affectedIcps) {
|
|
321
|
+
if (icp.preferredVoiceRef) {
|
|
322
|
+
const voice = voicesByRef.get(icp.preferredVoiceRef);
|
|
323
|
+
if (voice) return voice;
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
return null;
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
interface LowConfidenceEntry {
|
|
331
|
+
/** Dotted path inside the snapshot. */
|
|
332
|
+
path: string;
|
|
333
|
+
/** Display name of the entity (best-effort: `name` if present, else `ref`). */
|
|
334
|
+
label: string;
|
|
335
|
+
notes?: string;
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
function collectLowConfidenceEntries(params: {
|
|
339
|
+
intent: MarketContextBlockInput['intent'];
|
|
340
|
+
snapshot: MarketSnapshot;
|
|
341
|
+
benefitsInScope: FeatureBenefitConfig[];
|
|
342
|
+
affectedIcps: MarketICPConfig[];
|
|
343
|
+
}): LowConfidenceEntry[] {
|
|
344
|
+
const { intent, snapshot, benefitsInScope, affectedIcps } = params;
|
|
345
|
+
const entries: LowConfidenceEntry[] = [];
|
|
346
|
+
|
|
347
|
+
if (isLowConfidence(snapshot.category.authored)) {
|
|
348
|
+
entries.push({
|
|
349
|
+
path: 'category',
|
|
350
|
+
label: snapshot.category.name,
|
|
351
|
+
notes: snapshot.category.authored?.notes,
|
|
352
|
+
});
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
for (const icp of affectedIcps) {
|
|
356
|
+
if (isLowConfidence(icp.authored)) {
|
|
357
|
+
entries.push({
|
|
358
|
+
path: `icps[${snapshot.icps.indexOf(icp)}]`,
|
|
359
|
+
label: icp.name,
|
|
360
|
+
notes: icp.authored?.notes,
|
|
361
|
+
});
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
for (const benefit of benefitsInScope) {
|
|
366
|
+
if (isLowConfidence(benefit.authored)) {
|
|
367
|
+
entries.push({
|
|
368
|
+
path: `benefits[${snapshot.benefits.indexOf(benefit)}]`,
|
|
369
|
+
label: benefit.claim,
|
|
370
|
+
notes: benefit.authored?.notes,
|
|
371
|
+
});
|
|
372
|
+
}
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
// Personas: surface LOW-confidence personas whose `belongsToIcpRefs[]`
|
|
376
|
+
// intersects the **affected ICPs** for either intent kind. Under
|
|
377
|
+
// `icp` intent this is the requested ICP itself; under `feature`
|
|
378
|
+
// intent it's any ICP that the renderer surfaced under
|
|
379
|
+
// "Most-affected ICPs". Restricting to affected ICPs keeps the
|
|
380
|
+
// section signal-dense — we don't dump every LOW persona in the
|
|
381
|
+
// snapshot, only the ones the LLM is about to write copy for.
|
|
382
|
+
const affectedIcpRefs = new Set(affectedIcps.map(i => i.ref));
|
|
383
|
+
if (affectedIcpRefs.size > 0) {
|
|
384
|
+
for (const persona of snapshot.personas) {
|
|
385
|
+
if (!isLowConfidence(persona.authored)) continue;
|
|
386
|
+
if (!persona.belongsToIcpRefs.some(ref => affectedIcpRefs.has(ref))) continue;
|
|
387
|
+
entries.push({
|
|
388
|
+
path: `personas[${snapshot.personas.indexOf(persona)}]`,
|
|
389
|
+
label: persona.name,
|
|
390
|
+
notes: persona.authored?.notes,
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
return entries;
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
function isLowConfidence(authored: MarketAuthoredMetadata | undefined): boolean {
|
|
399
|
+
return authored?.confidence === AuthoredConfidence.LOW;
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
function compareByRef<T extends { ref: string }>(a: T, b: T): number {
|
|
403
|
+
return a.ref.localeCompare(b.ref);
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
// ---------------------------------------------------------------------------
|
|
407
|
+
// Render helpers
|
|
408
|
+
// ---------------------------------------------------------------------------
|
|
409
|
+
|
|
410
|
+
function renderHeader(intent: MarketContextBlockInput['intent']): string {
|
|
411
|
+
const intentLine =
|
|
412
|
+
intent.kind === 'feature'
|
|
413
|
+
? `(intent: feature \`${intent.featureRef}\`)`
|
|
414
|
+
: `(intent: icp \`${intent.icpRef}\`)`;
|
|
415
|
+
return `## Market context ${intentLine}`;
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
function renderCategorySection(snapshot: MarketSnapshot): string {
|
|
419
|
+
const { name, definition } = snapshot.category;
|
|
420
|
+
return [
|
|
421
|
+
'### Category',
|
|
422
|
+
`- **Name:** ${name}`,
|
|
423
|
+
`- **Definition:** ${definition}`,
|
|
424
|
+
].join('\n');
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
function renderBenefitsSection(benefits: FeatureBenefitConfig[]): string {
|
|
428
|
+
const lines = ['### Benefits in scope'];
|
|
429
|
+
if (benefits.length === 0) {
|
|
430
|
+
lines.push('_(none)_');
|
|
431
|
+
return lines.join('\n');
|
|
432
|
+
}
|
|
433
|
+
for (const benefit of benefits) {
|
|
434
|
+
const edges: string[] = [];
|
|
435
|
+
for (const e of benefit.relieves) {
|
|
436
|
+
edges.push(`relieves \`${e.painRef}\` (degree ${e.degree})`);
|
|
437
|
+
}
|
|
438
|
+
for (const e of benefit.creates) {
|
|
439
|
+
edges.push(`creates \`${e.gainRef}\` (degree ${e.degree})`);
|
|
440
|
+
}
|
|
441
|
+
for (const e of benefit.advances) {
|
|
442
|
+
edges.push(`advances \`${e.jobRef}\` (degree ${e.degree})`);
|
|
443
|
+
}
|
|
444
|
+
const edgeSummary = edges.length > 0 ? ` — ${edges.join('; ')}` : '';
|
|
445
|
+
lines.push(`- **${benefit.claim}** (\`${benefit.ref}\`, role ${benefit.role})${edgeSummary}`);
|
|
446
|
+
}
|
|
447
|
+
return lines.join('\n');
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
function renderAffectedIcpsSection(
|
|
451
|
+
icps: MarketICPConfig[],
|
|
452
|
+
intent: MarketContextBlockInput['intent'],
|
|
453
|
+
benefitsInScope: FeatureBenefitConfig[],
|
|
454
|
+
): string {
|
|
455
|
+
const heading =
|
|
456
|
+
intent.kind === 'feature'
|
|
457
|
+
? '### Most-affected ICPs'
|
|
458
|
+
: '### ICP profile';
|
|
459
|
+
const lines = [heading];
|
|
460
|
+
if (icps.length === 0) {
|
|
461
|
+
lines.push('_(none)_');
|
|
462
|
+
return lines.join('\n');
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
for (const icp of icps) {
|
|
466
|
+
const relevantImportance = benefitsInScope
|
|
467
|
+
.flatMap(b => b.importanceByICP)
|
|
468
|
+
.filter(imp => imp.icpRef === icp.ref);
|
|
469
|
+
const kanoSummary =
|
|
470
|
+
relevantImportance.length > 0
|
|
471
|
+
? ` — kano: ${relevantImportance
|
|
472
|
+
.map(i => `${i.kanoCategory}@${i.weight}`)
|
|
473
|
+
.join(', ')}`
|
|
474
|
+
: '';
|
|
475
|
+
lines.push(
|
|
476
|
+
`- **${icp.name}** (\`${icp.ref}\`, priority ${icp.priority}, archetype ${icp.archetype})${kanoSummary}`,
|
|
477
|
+
);
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
return lines.join('\n');
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
function renderAntiTargetSection(icps: MarketICPConfig[]): string {
|
|
484
|
+
const lines = ['### Anti-target ICPs (do not pitch)'];
|
|
485
|
+
if (icps.length === 0) {
|
|
486
|
+
lines.push('_(none)_');
|
|
487
|
+
return lines.join('\n');
|
|
488
|
+
}
|
|
489
|
+
for (const icp of icps) {
|
|
490
|
+
lines.push(`- **${icp.name}** (\`${icp.ref}\`, archetype ${icp.archetype})`);
|
|
491
|
+
}
|
|
492
|
+
return lines.join('\n');
|
|
493
|
+
}
|
|
494
|
+
|
|
495
|
+
function renderVoiceSection(voice: ToneOfVoiceConfig | null): string {
|
|
496
|
+
const lines = ['### Tone of voice'];
|
|
497
|
+
if (!voice) {
|
|
498
|
+
lines.push('_(none — fall back to neutral)_');
|
|
499
|
+
return lines.join('\n');
|
|
500
|
+
}
|
|
501
|
+
lines.push(`- **${voice.name}** (\`${voice.ref}\`) — ${voice.description}`);
|
|
502
|
+
lines.push(`- **address:** ${voice.address}`);
|
|
503
|
+
lines.push(`- **do:** ${voice.doExamples.map(s => `"${s}"`).join('; ')}`);
|
|
504
|
+
lines.push(`- **don't:** ${voice.dontExamples.map(s => `"${s}"`).join('; ')}`);
|
|
505
|
+
return lines.join('\n');
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
function renderLowConfidenceSection(entries: LowConfidenceEntry[]): string {
|
|
509
|
+
const lines = ['### Open questions / low-confidence entries'];
|
|
510
|
+
for (const entry of entries) {
|
|
511
|
+
const noteSuffix = entry.notes ? ` — ${entry.notes}` : '';
|
|
512
|
+
lines.push(`- \`${entry.path}\` **${entry.label}**${noteSuffix}`);
|
|
513
|
+
}
|
|
514
|
+
return lines.join('\n');
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
/**
|
|
518
|
+
* Trim and validate an `outputLanguage` value before it lands inside
|
|
519
|
+
* the prompt. Returns `undefined` for missing / empty / whitespace-only
|
|
520
|
+
* inputs (so the section is skipped entirely). Throws for values
|
|
521
|
+
* longer than {@link MAX_OUTPUT_LANGUAGE_LENGTH} — that's a caller
|
|
522
|
+
* misuse (e.g. pasting a paragraph instead of a tag).
|
|
523
|
+
*/
|
|
524
|
+
function normalizeOutputLanguage(value: string | undefined): string | undefined {
|
|
525
|
+
if (value === undefined) return undefined;
|
|
526
|
+
const trimmed = value.trim();
|
|
527
|
+
if (trimmed.length === 0) return undefined;
|
|
528
|
+
if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
|
|
529
|
+
throw new Error(
|
|
530
|
+
`buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
|
|
531
|
+
+ `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
|
|
532
|
+
+ `not a sentence — translation prose belongs in the LLM output, not the tag.`,
|
|
533
|
+
);
|
|
534
|
+
}
|
|
535
|
+
return trimmed;
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
function renderOutputLanguageSection(outputLanguage: string): string {
|
|
539
|
+
return [
|
|
540
|
+
'### Output language',
|
|
541
|
+
`Produce the final output in \`${outputLanguage}\`. The market context above is English on purpose — do not translate it; translate at output time only.`,
|
|
542
|
+
].join('\n');
|
|
543
|
+
}
|
|
544
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# market.context-block.response
|
|
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
|
+
* Phase-4 contract surface for the result returned by
|
|
14
|
+
* `buildMarketContextBlock(...)` (the pure renderer that lives in
|
|
15
|
+
* the dev-companion subprocess) and surfaced over the companion
|
|
16
|
+
* HTTP/RPC by the `market-context-for-feature` and
|
|
17
|
+
* `market-context-for-icp` behaviors.
|
|
18
|
+
*
|
|
19
|
+
* The schema lives in `saas-specifications` (not the dev-companion
|
|
20
|
+
* package) for two reasons:
|
|
21
|
+
*
|
|
22
|
+
* 1. The market generation CLI shipped in Phase 4.2 (`wildo market
|
|
23
|
+
* generate`) consumes this exact shape over HTTP. Owning the
|
|
24
|
+
* contract on the spec side gives the CLI a typed,
|
|
25
|
+
* refactor-safe parser without forcing the CLI to import
|
|
26
|
+
* dev-companion internals.
|
|
27
|
+
* 2. Anything that crosses a process boundary (parent ↔ child
|
|
28
|
+
* companion process, CLI ↔ companion HTTP) MUST be Zod-policed
|
|
29
|
+
* on at least one side — otherwise the consumer accepts
|
|
30
|
+
* `unknown` and silently drifts when the producer changes
|
|
31
|
+
* shape.
|
|
32
|
+
*
|
|
33
|
+
* The dev-companion's `MarketContextBlockResult` interface is
|
|
34
|
+
* structurally compatible with this schema (verified by a
|
|
35
|
+
* `satisfies` check at the builder return statement).
|
|
36
|
+
*
|
|
37
|
+
* **Trace shape:** `icpsConsidered` and `benefitsConsidered` are
|
|
38
|
+
* the refs of the entities the renderer actually surfaced (after
|
|
39
|
+
* filtering, capping, and deterministic ordering). `voiceUsed`
|
|
40
|
+
* is `null` when no voice was resolved (the rendered prose then
|
|
41
|
+
* falls back to a "neutral" instruction).
|
|
42
|
+
*/
|
|
43
|
+
export const MarketContextBlockTraceSchema = z.object({
|
|
44
|
+
icpsConsidered: z.array(z.string().min(1)),
|
|
45
|
+
benefitsConsidered: z.array(z.string().min(1)),
|
|
46
|
+
voiceUsed: z.string().min(1).nullable(),
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
export type MarketContextBlockTrace = z.infer<typeof MarketContextBlockTraceSchema>;
|
|
50
|
+
|
|
51
|
+
export const MarketContextBlockResultSchema = z.object({
|
|
52
|
+
block: z.string(),
|
|
53
|
+
trace: MarketContextBlockTraceSchema,
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
export type MarketContextBlockResult = z.infer<typeof MarketContextBlockResultSchema>;
|
|
57
|
+
```
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# market.feature-benefit.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The marketing-truth claim a feature delivers, expressed in customer
|
|
14
|
+
* outcome language (Strategyzer "Pain Reliever" / "Gain Creator"
|
|
15
|
+
* column).
|
|
16
|
+
*
|
|
17
|
+
* Authoring contract:
|
|
18
|
+
* - `deliveredByFeatureRefs: FeatureRef[]` is required and non-empty —
|
|
19
|
+
* a benefit MUST be deliverable. Orphan refs are flagged by
|
|
20
|
+
* `validateMarketSnapshot` as `ORPHAN_REF` (ERROR) when the caller
|
|
21
|
+
* passes `availableFeatureRefs`. Empty arrays slip past Zod
|
|
22
|
+
* `.min(1)` only via `parseAsync` defaults; the validator catches
|
|
23
|
+
* the residual case as `EMPTY_BENEFIT_DELIVERED_BY` (ERROR).
|
|
24
|
+
* - `role` picks the Strategyzer column. Drives prompt framing.
|
|
25
|
+
* - `relieves` / `creates` / `advances` are weighted edges (`degree`
|
|
26
|
+
* 1..10) into the corresponding Pain / Gain / Job. The FIT scorer
|
|
27
|
+
* (`market-scoring.ts`) multiplies `degree × ICP edge weight`.
|
|
28
|
+
* - `importanceByICP` carries per-ICP weight + Kano category. At
|
|
29
|
+
* most ONE THRESHOLD per (icp, job) is allowed
|
|
30
|
+
* (`MULTIPLE_THRESHOLDS_PER_ICP_JOB`, ERROR). Each (benefit, icp)
|
|
31
|
+
* pair is unique (`DUPLICATE_EDGE_PER_ENTITY`, WARN).
|
|
32
|
+
* - The runtime "is this benefit currently deliverable?" check lives
|
|
33
|
+
* in `is-benefit-available.ts` (kept out of the snapshot to keep it
|
|
34
|
+
* runtime-pure).
|
|
35
|
+
*
|
|
36
|
+
* Authoring rule: prefer outcome language ("ship the week without
|
|
37
|
+
* status meetings") over feature language ("Auto-Standup module").
|
|
38
|
+
*/
|
|
39
|
+
export const FeatureBenefitConfigSchema = z.object({
|
|
40
|
+
/** Stable kebab-case ref (e.g. `'benefit-ai-suggests-priority'`). */
|
|
41
|
+
ref: NonEmptyStringSchema,
|
|
42
|
+
/** One-sentence marketing claim in the brand voice. */
|
|
43
|
+
claim: NonEmptyStringSchema,
|
|
44
|
+
/** Optional supporting evidence (metrics, customer quotes, demo URL). */
|
|
45
|
+
evidence: NonEmptyStringSchema.optional(),
|
|
46
|
+
role: z.enum(BenefitRole),
|
|
47
|
+
/**
|
|
48
|
+
* `FeatureRef[]` — cross-family refs into the application's
|
|
49
|
+
* `FeatureSpecification` registry. Required + non-empty: a benefit
|
|
50
|
+
* must be deliverable. Orphan refs are flagged as `ORPHAN_REF`
|
|
51
|
+
* (ERROR) against the caller-supplied `availableFeatureRefs`.
|
|
52
|
+
*/
|
|
53
|
+
deliveredByFeatureRefs: z
|
|
54
|
+
.array(NonEmptyStringSchema)
|
|
55
|
+
.min(1)
|
|
56
|
+
// Factual only — see the note on `AxisSchema` in market-tone-of-voice.schemas.ts for why this must not
|
|
57
|
+
// be phrased as an instruction.
|
|
58
|
+
// Names no sibling collection ON PURPOSE. An earlier wording said the refs come from "this snapshot's
|
|
59
|
+
// features", and this payload has no `features` key -- the model duly invented one and the whole
|
|
60
|
+
// snapshot failed `unrecognized_keys` against the strict root. Describe the VALUE, never the shape of
|
|
61
|
+
// the document around it.
|
|
62
|
+
.describe('Non-empty array of feature ref strings.'),
|
|
63
|
+
/** Optional one-sentence "why we win on this vs alternatives". */
|
|
64
|
+
differentiation: NonEmptyStringSchema.optional(),
|
|
65
|
+
relieves: z.array(BenefitRelievesPainSchema).default([]),
|
|
66
|
+
creates: z.array(BenefitCreatesGainSchema).default([]),
|
|
67
|
+
advances: z.array(BenefitAdvancesJobSchema).default([]),
|
|
68
|
+
importanceByICP: z.array(BenefitImportanceForICPSchema).default([]),
|
|
69
|
+
/**
|
|
70
|
+
* `MarketProofRef[]` — proofs that back this benefit. Resolved
|
|
71
|
+
* against `snapshot.proofs[]`; orphans flagged as `ORPHAN_REF`
|
|
72
|
+
* (ERROR) by `validateMarketSnapshot`.
|
|
73
|
+
*/
|
|
74
|
+
proofRefs: z.array(NonEmptyStringSchema).default([]),
|
|
75
|
+
/**
|
|
76
|
+
* `MarketObjectionRef[]` — objections this benefit specifically
|
|
77
|
+
* answers. Resolved against `snapshot.objections[]`; orphans
|
|
78
|
+
* flagged as `ORPHAN_REF` (ERROR) by `validateMarketSnapshot`.
|
|
79
|
+
*/
|
|
80
|
+
addressesObjectionRefs: z.array(NonEmptyStringSchema).default([]),
|
|
81
|
+
authored: MarketAuthoredMetadataSchema.optional(),
|
|
82
|
+
});
|
|
83
|
+
export type FeatureBenefitConfig = z.infer<typeof FeatureBenefitConfigSchema>;
|
|
84
|
+
```
|