@wildo-ai/framework-knowledge 1.1.8 → 1.1.10
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/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +9 -2
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +95 -5
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +41 -3
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +175 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -2
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +90 -13
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +8 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +91 -43
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +27 -18
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +11 -11
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +71 -2
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +9 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +3 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +41 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +22 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
- package/dist/knowledge/references/brand.name-choice.config.md +144 -0
- package/dist/knowledge/references/brand.name-screening.config.md +308 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
- package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
- package/dist/knowledge/references/capability-composition.config.md +67 -4
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
- package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +374 -1
- package/dist/knowledge/registries/playbooks.json +76 -28
- package/dist/knowledge/registries/source-tags.json +1513 -898
- package/dist/knowledge/rules/live-context-door.md +5 -2
- package/dist/knowledge/skills/INDEX.md +5 -2
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1590 -292
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: brand-name-screening
|
|
3
|
+
description: Propose brand names for the application and run a minimal trademark screening of each — public registers of the target jurisdictions, the Nice classes the product lives in, identical and near-identical live marks, competitor collisions, domain signals — recorded as the BrandNameScreening the creator chooses the brand name from. Use when the user says "suggest names for the app", "propose a brand name", "is this name trademarked", "check the name against EUIPO", "screen our name", "can we use the name X", or "the name conflicts with a trademark". NOT a legal clearance opinion, and NOT for the logo or visual identity (brand-logo-authoring).
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Brand-Name Screening
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
The brand name is printed on every surface and rendered into the logo, so the cheapest
|
|
24
|
+
moment to find a conflicting trademark is **before anyone chooses**. This skill covers the
|
|
25
|
+
`BrandNameScreening`, the `brand-name-screening` family: candidate names, each with a
|
|
26
|
+
**minimal trademark screening**. It records which registers were searched, for which classes
|
|
27
|
+
and jurisdictions, with which match types, on which day, and what each returned, with its source.
|
|
28
|
+
|
|
29
|
+
The boundary it keeps: **the companion proposes and screens; the creator chooses.** The
|
|
30
|
+
brand-identity interview's `brand-name` question is a CHOICE computed from this screening.
|
|
31
|
+
And **a screening is not a legal clearance opinion.** Nothing here may say a name is
|
|
32
|
+
"available" or "cleared". The creator should consult an IP professional before filing or launching.
|
|
33
|
+
|
|
34
|
+
## App Paths
|
|
35
|
+
|
|
36
|
+
| Surface | Glob (relative to app root) |
|
|
37
|
+
|---|---|
|
|
38
|
+
| The screening (landed by `top_down.brand-naming`) | `specifications/src/brand-name-screening/index.ts` |
|
|
39
|
+
| Companion wiring (the slot) | `specifications/src/companion-exports.ts` (the `brandNameScreening` slot) |
|
|
40
|
+
| The brand that carries the chosen name (separate skill) | `specifications/src/brand/index.ts` |
|
|
41
|
+
| Competitors a name must stay distinct from (read only) | `specifications/src/market/**` (`alternatives`) |
|
|
42
|
+
|
|
43
|
+
## When to Use
|
|
44
|
+
|
|
45
|
+
- The application needs a name, or the creator wants proposals.
|
|
46
|
+
- The creator has a name and wants to know whether it conflicts with a registered mark.
|
|
47
|
+
- Reading a landed screening: why a name is offered as "screening incomplete", or not offered.
|
|
48
|
+
|
|
49
|
+
## When NOT to Use
|
|
50
|
+
|
|
51
|
+
- The logo, mark direction or visual tone → `brand-logo-authoring`.
|
|
52
|
+
- How the product *writes* (its verbal voice) → `market-tone-of-voice`.
|
|
53
|
+
- A legal opinion on registrability or infringement. That belongs to an IP professional,
|
|
54
|
+
never to this screening.
|
|
55
|
+
|
|
56
|
+
## Workflow
|
|
57
|
+
|
|
58
|
+
Derive the coverage → propose → screen → record honestly → hand the choice to the creator.
|
|
59
|
+
|
|
60
|
+
### Step 1: Derive the coverage, never assume it
|
|
61
|
+
|
|
62
|
+
- **Jurisdictions** are the union of the market's ICP geographies, the vision's compliance detail,
|
|
63
|
+
the application's declared `operatingJurisdictions` and the countries the creator names as where the users are (`top_down.brand-naming`'s
|
|
64
|
+
`target-jurisdictions`, one decision with the compliance interview's `jurisdictions`). Resolve a
|
|
65
|
+
region tag to countries. Every named country is reached by its national office or by a TMview
|
|
66
|
+
search that lists it. Where the data is hosted is not a trademark jurisdiction.
|
|
67
|
+
If any EU member state is targeted, add `EU` (an EU trade mark has effect in every member
|
|
68
|
+
state). International registrations (`WO`) are always in scope.
|
|
69
|
+
- **Nice classes**: 9 and 42 for every software product, 35 for business-management and CRM
|
|
70
|
+
tools, plus any class the category implies, each with a reason.
|
|
71
|
+
|
|
72
|
+
### Step 2: Propose (at least five)
|
|
73
|
+
|
|
74
|
+
Ground each in the vision's idea and mission and the market's category language and tone of
|
|
75
|
+
voice. Prefer distinctive names; a purely descriptive one is weak as a mark. **No proposal may
|
|
76
|
+
be identical or close to a competitor or alternative the market names.**
|
|
77
|
+
|
|
78
|
+
### Step 3: Screen every candidate, proposed or the creator's
|
|
79
|
+
|
|
80
|
+
Search EUIPO (EU marks), TMview (EU and national offices), the WIPO Global Brand Database
|
|
81
|
+
(international marks), and any targeted national office not already covered. Search identical
|
|
82
|
+
and near-identical marks, and record live marks only (registered or pending). **Reach a register
|
|
83
|
+
through its machine interface when one is open to you, and record the `accessPath` of every
|
|
84
|
+
query**: a register's web page usually renders its results in the browser and reads as nothing.
|
|
85
|
+
See `references/screening-procedure.md` for the register list, the access paths and the match rules.
|
|
86
|
+
|
|
87
|
+
Record every product already trading under the name with its `categoryRelation`. **A `SAME_JOB`
|
|
88
|
+
product with an identical or near-identical name is a competitor collision**, wherever the
|
|
89
|
+
evidence found it: the choice computation treats it as one even when it was filed only as a
|
|
90
|
+
same-category use, but say so in `competitorCollisions` too.
|
|
91
|
+
|
|
92
|
+
### Step 4: Record honestly: a failure is not an answer
|
|
93
|
+
|
|
94
|
+
A register you could not query or read is **`UNKNOWN`, with a note**, never `CLEAR`. `CONFLICT`
|
|
95
|
+
exactly when a live identical or near-identical mark was found, with every such mark listed and
|
|
96
|
+
sourced. Every query carries its source URL and date. There is **no candidate-level verdict to
|
|
97
|
+
write**. `deriveBrandNameTrademarkOutcome` computes it from the queries, so a candidate with an
|
|
98
|
+
unchecked register reads as not cleared. Coverage is a second derived axis
|
|
99
|
+
(`deriveBrandNameScreeningCoverage`): FULL, PARTIAL, or NONE when no register returned anything. Each
|
|
100
|
+
unread query becomes a check a person can run (`deriveBrandNameManualChecks`, TMview pre-filled); never
|
|
101
|
+
write that link yourself. Field contracts: `references/framework-brand-name-screening-api.md`.
|
|
102
|
+
|
|
103
|
+
### Step 5: Hand the choice over
|
|
104
|
+
|
|
105
|
+
The brand-identity interview offers options computed by `deriveOfferableBrandNameOptions`:
|
|
106
|
+
|
|
107
|
+
- a clear name, as itself;
|
|
108
|
+
- a partly read one, as `Name [screening-incomplete]`;
|
|
109
|
+
- one no register was read for, as `Name [not-screened]`;
|
|
110
|
+
- a creator-supplied name that conflicts (a live mark, a market competitor, or a same-job product
|
|
111
|
+
using the name), as `Name [keep-despite-conflict]`.
|
|
112
|
+
|
|
113
|
+
A conflicting proposal is never offered. Each option is shown with a line saying what its qualifier
|
|
114
|
+
summarizes (the product using the name, the registers nobody read), and the creator's answer records
|
|
115
|
+
that line with the choice. Until the screening clears the chosen name, `wildo context launch-blockers`
|
|
116
|
+
lists it as not cleared.
|
|
117
|
+
To screen another name of their own, they add it to `top_down.brand-naming`'s interview
|
|
118
|
+
(`names-to-screen`) and re-run it. Stop there: choosing is not this skill's job.
|
|
119
|
+
|
|
120
|
+
## References
|
|
121
|
+
|
|
122
|
+
- `references/framework-brand-name-screening-api.md` — source-backed: the `BrandNameScreening`
|
|
123
|
+
shape, the derived outcome, and the choice vocabulary.
|
|
124
|
+
- `references/screening-procedure.md` — authored: registers, classes, match types, status rules,
|
|
125
|
+
and how to word a result.
|
|
126
|
+
|
|
127
|
+
## Verification
|
|
128
|
+
|
|
129
|
+
- [ ] Every declared jurisdiction follows from the product, and `EU` is present when an EU member
|
|
130
|
+
state is targeted.
|
|
131
|
+
- [ ] Classes 9 and 42 are searched.
|
|
132
|
+
- [ ] Every query has a `sourceUrl` and a `checkedOn` date.
|
|
133
|
+
- [ ] No query the research could not run is recorded as `CLEAR`.
|
|
134
|
+
- [ ] Every query states its `accessPath`, and every same-category use its `categoryRelation`.
|
|
135
|
+
- [ ] Every country the creator named as a target is a declared jurisdiction.
|
|
136
|
+
- [ ] No proposal collides with a market competitor or alternative.
|
|
137
|
+
- [ ] Nothing says "available", "free to use" or "cleared".
|
|
138
|
+
|
|
139
|
+
### Grep invariants
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# no clearance language anywhere in the landed screening or the brand
|
|
143
|
+
rg -n -i "\b(available|cleared|free to use|clearance granted)\b" specifications/src/brand-name-screening specifications/src/brand
|
|
144
|
+
# the slot is wired
|
|
145
|
+
rg -n "brandNameScreening" specifications/src/companion-exports.ts
|
|
146
|
+
# the deterministic validator and the coherence report
|
|
147
|
+
wildo context coherence
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
## Common Rationalizations
|
|
151
|
+
|
|
152
|
+
| Rationalization | Reality |
|
|
153
|
+
|---|---|
|
|
154
|
+
| "The register would not load, so it is probably fine." | A register that could not be read is `UNKNOWN`. Silence is not a search result. |
|
|
155
|
+
| "A quick web search found nothing, so it is clear." | Search engines do not index trademark registers. Only the register's own result counts. |
|
|
156
|
+
| "The creator likes the name, so skip screening it." | A creator-supplied name is screened exactly like a proposal. Choosing it despite a conflict is their explicit act, not a skipped check. |
|
|
157
|
+
| "Mark the candidate clear to save the creator a worry." | There is no clear field: the outcome is derived from the queries. Inventing a query result is the one thing the validator cannot catch. |
|
|
158
|
+
| "Say the name is available; that is what the creator wants to hear." | A screening is not a legal clearance opinion. Never claim availability. |
|
|
159
|
+
|
|
160
|
+
## Red Flags
|
|
161
|
+
|
|
162
|
+
- A query with outcome `CLEAR` for TMview or WIPO with no source URL. Catch it with the "every
|
|
163
|
+
query has a sourceUrl" check above.
|
|
164
|
+
- A proposal sharing a stem with a named competitor. Catch it with `wildo context coherence` (the
|
|
165
|
+
options computation drops it, and the judge reports it).
|
|
166
|
+
- The word "available" or "cleared" in the brand or screening. Catch it with the first grep above.
|
|
167
|
+
- No `EU` jurisdiction while an EU country is targeted. Catch it with the validator's
|
|
168
|
+
`EU_TRADE_MARK_NOT_DECLARED` finding.
|
|
169
|
+
- Every query `UNKNOWN` and nothing said about it. Catch it with `wildo context coherence`
|
|
170
|
+
(`brand-name-screening-read-nothing`) and the validator's `NO_REGISTER_READ` finding.
|
|
171
|
+
- A same-job product with the candidate's name filed with no `categoryRelation`. Catch it with the
|
|
172
|
+
"every same-category use states its relation" check above.
|
|
173
|
+
|
|
174
|
+
## Related Skills
|
|
175
|
+
|
|
176
|
+
- `brand-logo-authoring` — the brand brief that carries the chosen name, and its logo direction.
|
|
177
|
+
- `market-alternatives` — the competitors and alternatives a name must stay distinct from.
|
|
178
|
+
- `market-tone-of-voice` — the verbal voice a proposed name should fit.
|
package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md
ADDED
|
@@ -0,0 +1,466 @@
|
|
|
1
|
+
# Framework — Brand-Name Screening API (source-backed)
|
|
2
|
+
|
|
3
|
+
The `BrandNameScreening` shape and the choice vocabulary computed from it. Imported from
|
|
4
|
+
`@wildo-ai/saas-specifications`.
|
|
5
|
+
|
|
6
|
+
Read this when you need:
|
|
7
|
+
|
|
8
|
+
- the exact fields of a candidate, a register query, a conflicting mark or a signal;
|
|
9
|
+
- how a candidate's standing is DERIVED (there is no outcome field to author);
|
|
10
|
+
- how the `brand-name` interview options are formatted, and what each qualifier means.
|
|
11
|
+
|
|
12
|
+
- The **screening** (jurisdictions and classes searched, the candidates, every register
|
|
13
|
+
query with its source and date):
|
|
14
|
+
|
|
15
|
+
## Import Origins
|
|
16
|
+
|
|
17
|
+
- `@wildo-ai/saas-specifications`
|
|
18
|
+
|
|
19
|
+
## Source Excerpts
|
|
20
|
+
|
|
21
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
*
|
|
25
|
+
* The **brand-name screening** — the candidate names the companion PROPOSED (and any the creator asked
|
|
26
|
+
* to have screened), each checked against the public trademark registers of the jurisdictions the
|
|
27
|
+
* application targets. Artifact family `brand-name-screening`, produced by the `top_down.brand-naming`
|
|
28
|
+
* step; the `top_down.brand-identity` interview offers the creator a CHOICE computed from it.
|
|
29
|
+
*
|
|
30
|
+
* ## What this is, and what it is not
|
|
31
|
+
*
|
|
32
|
+
* A **minimal trademark screening — not a legal clearance opinion.** It records which registers were
|
|
33
|
+
* searched, for which classes, with which match types, on which day, and what each returned, so a
|
|
34
|
+
* reader can see exactly how far the check went. It never says a name is "available" or "cleared":
|
|
35
|
+
* consult an IP professional before filing or launching under any name recorded here.
|
|
36
|
+
*
|
|
37
|
+
* ## Why it exists
|
|
38
|
+
*
|
|
39
|
+
* On a first real run the brand name was a required pre-run free-text question. The creator expected
|
|
40
|
+
* proposals, a coding assistant improvised four names in chat with no check at all, and one of them was
|
|
41
|
+
* almost certainly a registered software mark. The name is printed on every surface and rendered into
|
|
42
|
+
* the logo, so the cheapest moment to catch a conflict is before anyone chooses.
|
|
43
|
+
*
|
|
44
|
+
* ## The outcome is DERIVED, never authored
|
|
45
|
+
*
|
|
46
|
+
* There is no `outcome` field on a candidate. {@link deriveBrandNameTrademarkOutcome} computes it from
|
|
47
|
+
* the register queries — a conflict on any query is a CONFLICT; a jurisdiction, class or match type no
|
|
48
|
+
* clear query covered, or any query that could not be completed, is UNKNOWN; only full coverage with
|
|
49
|
+
* every query clear is CLEAR. So a model cannot label a half-checked name clear: an unchecked register
|
|
50
|
+
* is simply an uncovered jurisdiction, and the derivation reads it as UNKNOWN.
|
|
51
|
+
*/
|
|
52
|
+
|
|
53
|
+
/** The payload-format version of a brand-name screening. */
|
|
54
|
+
export enum BrandNameScreeningVersion {
|
|
55
|
+
V1 = 'v1',
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Who put a candidate on the list. The companion proposes; the creator may ask for their own names to be screened. */
|
|
59
|
+
export enum BrandNameCandidateOrigin {
|
|
60
|
+
/** Proposed by the companion from the vision and the market snapshot. */
|
|
61
|
+
COMPANION_PROPOSED = 'COMPANION_PROPOSED',
|
|
62
|
+
/** A name the creator supplied, screened exactly like a proposed one. */
|
|
63
|
+
CREATOR_SUPPLIED = 'CREATOR_SUPPLIED',
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* The public register a query was run against.
|
|
68
|
+
*
|
|
69
|
+
* `NATIONAL_OFFICE` covers any national IP office (DPMA, INPI, UKIPO, USPTO, …); which country it is
|
|
70
|
+
* lives in the query's `jurisdictionsCovered`, so the vocabulary does not hard-code one market.
|
|
71
|
+
*/
|
|
72
|
+
export enum BrandNameTrademarkRegister {
|
|
73
|
+
/** EUIPO's EU trade mark register (eSearch plus) — EU-wide marks. */
|
|
74
|
+
EUIPO_EUTM = 'EUIPO_EUTM',
|
|
75
|
+
/** TMview — the EUIPO-hosted aggregator over the EU office and participating national offices. */
|
|
76
|
+
TMVIEW = 'TMVIEW',
|
|
77
|
+
/** WIPO Global Brand Database — international (Madrid) registrations and many national collections. */
|
|
78
|
+
WIPO_GLOBAL_BRAND_DATABASE = 'WIPO_GLOBAL_BRAND_DATABASE',
|
|
79
|
+
/** A national IP office's own register. */
|
|
80
|
+
NATIONAL_OFFICE = 'NATIONAL_OFFICE',
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** How close a register hit had to be to count. A screening searches both. */
|
|
84
|
+
export enum BrandNameMatchType {
|
|
85
|
+
/** The same mark, ignoring case and spacing. */
|
|
86
|
+
IDENTICAL = 'IDENTICAL',
|
|
87
|
+
/** Plurals, hyphenation, transposed or substituted letters, and common phonetic variants. */
|
|
88
|
+
NEAR_IDENTICAL = 'NEAR_IDENTICAL',
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** What one register query returned. `UNKNOWN` is a query that could not be completed — never a clear one. */
|
|
92
|
+
export enum BrandNameTrademarkQueryOutcome {
|
|
93
|
+
/** Searched, at full coverage, and no live identical or near-identical mark found. */
|
|
94
|
+
CLEAR = 'CLEAR',
|
|
95
|
+
/** At least one live identical or near-identical mark in a searched class. */
|
|
96
|
+
CONFLICT = 'CONFLICT',
|
|
97
|
+
/** The register was unreachable, the search could not be run, or its result could not be read. */
|
|
98
|
+
UNKNOWN = 'UNKNOWN',
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** The status of a conflicting mark. Only LIVE marks are recorded: an expired or withdrawn mark is not a conflict. */
|
|
102
|
+
export enum BrandNameConflictingMarkStatus {
|
|
103
|
+
REGISTERED = 'REGISTERED',
|
|
104
|
+
/** Filed and not yet registered, including under opposition. */
|
|
105
|
+
PENDING = 'PENDING',
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/** What a domain check found. Recorded as a signal beside the registers, never a blocker. */
|
|
109
|
+
export enum BrandNameDomainStatus {
|
|
110
|
+
REGISTERED = 'REGISTERED',
|
|
111
|
+
AVAILABLE = 'AVAILABLE',
|
|
112
|
+
UNKNOWN = 'UNKNOWN',
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* HOW a register was reached for one query (#2333). Recorded per query so a reader can tell a register that
|
|
117
|
+
* answered through its published interface from one whose web page was fetched — the two fail differently.
|
|
118
|
+
*
|
|
119
|
+
* Measured on app-creation-test-005 (2026-10-03): every register reached as a WEB_PAGE returned nothing a
|
|
120
|
+
* fetch could read (client-rendered results, an empty page, a CAPTCHA, an HTTP 403, a form that never ran),
|
|
121
|
+
* so 30 of 30 queries were UNKNOWN. A register's web page is built for a person; its machine interface, where
|
|
122
|
+
* one exists, is what a program can read.
|
|
123
|
+
*/
|
|
124
|
+
export enum BrandNameRegisterAccessPath {
|
|
125
|
+
/** The register's published machine interface (a search API returning structured records). */
|
|
126
|
+
MACHINE_INTERFACE = 'MACHINE_INTERFACE',
|
|
127
|
+
/** The register's web page, fetched as a document. Usually unreadable: most registers render their results in the browser. */
|
|
128
|
+
WEB_PAGE = 'WEB_PAGE',
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* How a product already trading under a candidate's name relates to THIS product's category (#2336).
|
|
133
|
+
*
|
|
134
|
+
* Typed rather than left in a free-text note so the collision check can DECIDE it: a same-job product with
|
|
135
|
+
* the same name is a competitor collision whether or not the market snapshot happened to list it. Measured on
|
|
136
|
+
* app-creation-test-005: "Groundwork — Estimating & Job Suite" (the same customer → quote → job → invoice flow
|
|
137
|
+
* for tradespeople) was recorded only as a same-category use, so the creator's "Groundwork" was never offered
|
|
138
|
+
* as a conflicting name, and a companion proposal colliding with a French building-software product was offered.
|
|
139
|
+
*/
|
|
140
|
+
export enum BrandNameCategoryRelation {
|
|
141
|
+
/** The same job for the same kind of customer, or the same Nice class of goods and services: a collision when the names match. */
|
|
142
|
+
SAME_JOB = 'SAME_JOB',
|
|
143
|
+
/** A neighbouring category (building software for another audience, CRM for another trade): recorded, never a collision on its own. */
|
|
144
|
+
ADJACENT = 'ADJACENT',
|
|
145
|
+
/** Unrelated trade (a sports-team payments tool for a builders' CRM): recorded for completeness. */
|
|
146
|
+
UNRELATED = 'UNRELATED',
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
/** A candidate's derived trademark standing — see {@link deriveBrandNameTrademarkOutcome}. */
|
|
150
|
+
export enum BrandNameTrademarkOutcome {
|
|
151
|
+
CLEAR = 'CLEAR',
|
|
152
|
+
CONFLICT = 'CONFLICT',
|
|
153
|
+
UNKNOWN = 'UNKNOWN',
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** The pseudo-jurisdiction an EU trade mark covers. */
|
|
157
|
+
export const EU_TRADE_MARK_JURISDICTION = 'EU';
|
|
158
|
+
/** The pseudo-jurisdiction an international (Madrid, via WIPO) registration covers. */
|
|
159
|
+
export const INTERNATIONAL_REGISTRATION_JURISDICTION = 'WO';
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* The EU member states (ISO 3166-1 alpha-2) — a target in any of them makes an EU trade mark relevant,
|
|
163
|
+
* because an EUTM has effect in every member state.
|
|
164
|
+
*/
|
|
165
|
+
export const EU_MEMBER_STATE_CODES: readonly string[] = [
|
|
166
|
+
'AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE',
|
|
167
|
+
'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE',
|
|
168
|
+
];
|
|
169
|
+
|
|
170
|
+
/**
|
|
171
|
+
* A jurisdiction code: an ISO 3166-1 alpha-2 country, `EU` (an EU trade mark) or `WO` (an international
|
|
172
|
+
* registration). Stated as a description too, because a JSON schema shown to a generating model drops
|
|
173
|
+
* the refinement.
|
|
174
|
+
*/
|
|
175
|
+
export const BrandNameJurisdictionCodeSchema = z
|
|
176
|
+
.string()
|
|
177
|
+
.trim()
|
|
178
|
+
.regex(/^[A-Z]{2}$/)
|
|
179
|
+
.describe('ISO 3166-1 alpha-2 country code (e.g. "DE", "FR"), or "EU" for the EU trade mark, or "WO" for an international registration. Never a name.');
|
|
180
|
+
|
|
181
|
+
/** The first Nice class number. */
|
|
182
|
+
export const NICE_CLASS_MIN = 1;
|
|
183
|
+
/** The last Nice class number (the Nice Classification has 45 classes: 1–34 goods, 35–45 services). */
|
|
184
|
+
export const NICE_CLASS_MAX = 45;
|
|
185
|
+
|
|
186
|
+
/** The Nice classes every software product lives in: 9 (downloadable software) and 42 (SaaS). */
|
|
187
|
+
export const SOFTWARE_NICE_CLASSES: readonly number[] = [9, 42];
|
|
188
|
+
|
|
189
|
+
const NiceClassNumberSchema = z.number().int().min(NICE_CLASS_MIN).max(NICE_CLASS_MAX);
|
|
190
|
+
/** An ISO calendar date (`YYYY-MM-DD`): the day a check was made. */
|
|
191
|
+
const IsoDateSchema = z.iso.date();
|
|
192
|
+
|
|
193
|
+
/** One jurisdiction the screening covers, and where that target came from. */
|
|
194
|
+
export const BrandNameScreeningJurisdictionSchema = z.object({
|
|
195
|
+
code: BrandNameJurisdictionCodeSchema,
|
|
196
|
+
/** What declared this target — an ICP geography, a vision compliance detail, the application's configured jurisdictions. */
|
|
197
|
+
derivedFrom: NonEmptyStringSchema,
|
|
198
|
+
});
|
|
199
|
+
export type BrandNameScreeningJurisdiction = z.infer<typeof BrandNameScreeningJurisdictionSchema>;
|
|
200
|
+
|
|
201
|
+
/** One Nice class searched, and why this product lives in it. */
|
|
202
|
+
export const BrandNameScreeningNiceClassSchema = z.object({
|
|
203
|
+
classNumber: NiceClassNumberSchema,
|
|
204
|
+
rationale: NonEmptyStringSchema,
|
|
205
|
+
});
|
|
206
|
+
export type BrandNameScreeningNiceClass = z.infer<typeof BrandNameScreeningNiceClassSchema>;
|
|
207
|
+
|
|
208
|
+
/** A live mark a query found, with the record it was read from. */
|
|
209
|
+
export const BrandNameConflictingMarkSchema = z.object({
|
|
210
|
+
/** The mark as registered. */
|
|
211
|
+
mark: NonEmptyStringSchema,
|
|
212
|
+
owner: NonEmptyStringSchema.optional(),
|
|
213
|
+
/** The application or registration number on the register. */
|
|
214
|
+
registrationNumber: NonEmptyStringSchema.optional(),
|
|
215
|
+
/** The Nice classes the mark is registered or filed in. */
|
|
216
|
+
niceClasses: z.array(NiceClassNumberSchema).min(1),
|
|
217
|
+
status: z.enum(BrandNameConflictingMarkStatus).systemEnum('BrandNameConflictingMarkStatus'),
|
|
218
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
219
|
+
/** The register record that was read. */
|
|
220
|
+
sourceUrl: z.url(),
|
|
221
|
+
});
|
|
222
|
+
export type BrandNameConflictingMark = z.infer<typeof BrandNameConflictingMarkSchema>;
|
|
223
|
+
|
|
224
|
+
/** One search of one register for one candidate. */
|
|
225
|
+
export const BrandNameTrademarkQuerySchema = z.object({
|
|
226
|
+
register: z.enum(BrandNameTrademarkRegister).systemEnum('BrandNameTrademarkRegister'),
|
|
227
|
+
/** The jurisdictions this search covers (`EU` for an EUTM search, `WO` for international registrations, country codes otherwise). */
|
|
228
|
+
jurisdictionsCovered: z.array(BrandNameJurisdictionCodeSchema).min(1),
|
|
229
|
+
niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
|
|
230
|
+
matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
|
|
231
|
+
outcome: z.enum(BrandNameTrademarkQueryOutcome).systemEnum('BrandNameTrademarkQueryOutcome'),
|
|
232
|
+
/**
|
|
233
|
+
* How the register was reached (#2333). Optional in the STORED record only because screenings landed before
|
|
234
|
+
* the field existed carry none; read it through {@link resolveBrandNameQueryAccessPath}, never directly. A
|
|
235
|
+
* producer must always state it — the generation schema requires it.
|
|
236
|
+
*/
|
|
237
|
+
accessPath: z.enum(BrandNameRegisterAccessPath).systemEnum('BrandNameRegisterAccessPath').optional(),
|
|
238
|
+
/** Every live mark found. Present exactly when the outcome is CONFLICT. */
|
|
239
|
+
conflictingMarks: z.array(BrandNameConflictingMarkSchema).default([]),
|
|
240
|
+
/** The search or results page that was read — what a reader opens to check this row. */
|
|
241
|
+
sourceUrl: z.url(),
|
|
242
|
+
checkedOn: IsoDateSchema,
|
|
243
|
+
/** Why an UNKNOWN query is unknown, or anything a reader needs to interpret the result. */
|
|
244
|
+
note: NonEmptyStringSchema.optional(),
|
|
245
|
+
});
|
|
246
|
+
export type BrandNameTrademarkQuery = z.infer<typeof BrandNameTrademarkQuerySchema>;
|
|
247
|
+
|
|
248
|
+
/** A domain checked for a candidate — exact match on `.com` and the main ccTLDs of the target countries. */
|
|
249
|
+
export const BrandNameDomainSignalSchema = z.object({
|
|
250
|
+
domain: NonEmptyStringSchema,
|
|
251
|
+
status: z.enum(BrandNameDomainStatus).systemEnum('BrandNameDomainStatus'),
|
|
252
|
+
checkedOn: IsoDateSchema,
|
|
253
|
+
sourceUrl: z.url().optional(),
|
|
254
|
+
});
|
|
255
|
+
export type BrandNameDomainSignal = z.infer<typeof BrandNameDomainSignalSchema>;
|
|
256
|
+
|
|
257
|
+
/**
|
|
258
|
+
* A company or product already trading under (or close to) the name. Despite the field's name, not every
|
|
259
|
+
* entry is in THIS product's category — `categoryRelation` says how close it is, and a SAME_JOB use whose
|
|
260
|
+
* name matches the candidate is a competitor collision ({@link brandNameCandidateCollisions} in the choice
|
|
261
|
+
* module decides it, so a producer that files it here rather than in `competitorCollisions` is still caught).
|
|
262
|
+
*/
|
|
263
|
+
export const BrandNameSameCategoryUseSchema = z.object({
|
|
264
|
+
name: NonEmptyStringSchema,
|
|
265
|
+
sourceUrl: z.url(),
|
|
266
|
+
/**
|
|
267
|
+
* How the use relates to this product's category (#2336). Optional in the STORED record only because
|
|
268
|
+
* screenings landed before the field existed carry none — such a use decides no collision, because nothing
|
|
269
|
+
* says it is the same job. The generation schema requires it.
|
|
270
|
+
*/
|
|
271
|
+
categoryRelation: z.enum(BrandNameCategoryRelation).systemEnum('BrandNameCategoryRelation').optional(),
|
|
272
|
+
note: NonEmptyStringSchema.optional(),
|
|
273
|
+
});
|
|
274
|
+
export type BrandNameSameCategoryUse = z.infer<typeof BrandNameSameCategoryUseSchema>;
|
|
275
|
+
|
|
276
|
+
/**
|
|
277
|
+
* A product the candidate is identical or confusingly close to: a competitor or alternative the market snapshot
|
|
278
|
+
* names, or a product the research found doing the SAME job under the name (#2336) — which the market snapshot
|
|
279
|
+
* may never have listed.
|
|
280
|
+
*/
|
|
281
|
+
export const BrandNameCompetitorCollisionSchema = z.object({
|
|
282
|
+
/** The market snapshot's alternative ref, when the collision is with one of its alternatives. */
|
|
283
|
+
alternativeRef: NonEmptyStringSchema.optional(),
|
|
284
|
+
/** The competitor's name — as the market snapshot names it, or as the product trades when the research found it. */
|
|
285
|
+
competitorName: NonEmptyStringSchema,
|
|
286
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
287
|
+
});
|
|
288
|
+
export type BrandNameCompetitorCollision = z.infer<typeof BrandNameCompetitorCollisionSchema>;
|
|
289
|
+
|
|
290
|
+
/** One candidate name and everything its screening found. */
|
|
291
|
+
export const BrandNameCandidateSchema = z.object({
|
|
292
|
+
/** Stable ref (`name-<slug>`), stamped by the runtime. */
|
|
293
|
+
ref: z.string().regex(/^name-[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
294
|
+
/** The exact, case-sensitive name. */
|
|
295
|
+
name: NonEmptyStringSchema,
|
|
296
|
+
origin: z.enum(BrandNameCandidateOrigin).systemEnum('BrandNameCandidateOrigin'),
|
|
297
|
+
/** Why this name fits: what in the vision and the market's category language and voice it answers. Empty for a creator-supplied name. */
|
|
298
|
+
rationale: NonEmptyStringSchema.optional(),
|
|
299
|
+
trademarkQueries: z.array(BrandNameTrademarkQuerySchema).default([]),
|
|
300
|
+
competitorCollisions: z.array(BrandNameCompetitorCollisionSchema).default([]),
|
|
301
|
+
domainSignals: z.array(BrandNameDomainSignalSchema).default([]),
|
|
302
|
+
sameCategoryUses: z.array(BrandNameSameCategoryUseSchema).default([]),
|
|
303
|
+
});
|
|
304
|
+
export type BrandNameCandidate = z.infer<typeof BrandNameCandidateSchema>;
|
|
305
|
+
|
|
306
|
+
/**
|
|
307
|
+
* THE brand-name screening payload — one per application. `jurisdictions` and `niceClasses` are the
|
|
308
|
+
* coverage every candidate is measured against: a candidate whose queries do not reach all of them is
|
|
309
|
+
* UNKNOWN, whatever its queries say.
|
|
310
|
+
*/
|
|
311
|
+
export const BrandNameScreeningSchema = z.object({
|
|
312
|
+
version: z.enum(BrandNameScreeningVersion).default(BrandNameScreeningVersion.V1),
|
|
313
|
+
/** The day the screening was run. */
|
|
314
|
+
screenedOn: IsoDateSchema,
|
|
315
|
+
jurisdictions: z.array(BrandNameScreeningJurisdictionSchema).min(1),
|
|
316
|
+
niceClasses: z.array(BrandNameScreeningNiceClassSchema).min(1),
|
|
317
|
+
candidates: z.array(BrandNameCandidateSchema).min(1),
|
|
318
|
+
});
|
|
319
|
+
export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
- The **choice vocabulary** (which candidates are offered, and the bracketed qualifiers that
|
|
323
|
+
record an incomplete screening or an explicit keep-despite-conflict):
|
|
324
|
+
|
|
325
|
+
## Import Origins
|
|
326
|
+
|
|
327
|
+
- `@wildo-ai/saas-specifications`
|
|
328
|
+
|
|
329
|
+
## Source Excerpts
|
|
330
|
+
|
|
331
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
332
|
+
|
|
333
|
+
```typescript
|
|
334
|
+
*
|
|
335
|
+
* Which screened names the creator is OFFERED, and how a choice records what the creator accepted.
|
|
336
|
+
*
|
|
337
|
+
* The `top_down.brand-identity` interview asks `brand-name` as a CHOICE whose options are computed from
|
|
338
|
+
* the landed `brand-name-screening` by {@link deriveOfferableBrandNameOptions} — never written by a model.
|
|
339
|
+
* An option is the exact name, optionally followed by ONE bracketed qualifier from
|
|
340
|
+
* {@link BrandNameChoiceQualifier}:
|
|
341
|
+
*
|
|
342
|
+
* | candidate | offered as |
|
|
343
|
+
* |---|---|
|
|
344
|
+
* | CLEAR, no competitor collision | `Batisio` |
|
|
345
|
+
* | UNKNOWN, at least one register READ (coverage partial), no collision | `Batisio [screening-incomplete]` |
|
|
346
|
+
* | UNKNOWN, NO register read (coverage none), no collision | `Batisio [not-screened]` |
|
|
347
|
+
* | CONFLICT or competitor collision, **creator-supplied** | `Keystone [keep-despite-conflict]` |
|
|
348
|
+
* | CONFLICT or competitor collision, **companion-proposed** | not offered |
|
|
349
|
+
*
|
|
350
|
+
* A competitor collision is any name the screening RECORDED as one, any named product in the market snapshot,
|
|
351
|
+
* and any same-job product the screening found trading under the name (`sameCategoryUses` with a `SAME_JOB`
|
|
352
|
+
* relation) — see {@link brandNameCandidateCollisions}. The last is what app-creation-test-005 missed (#2336).
|
|
353
|
+
*
|
|
354
|
+
* Every option also carries its DERIVED coverage and collisions and a one-line `detail`, which the question
|
|
355
|
+
* shows beside the option (#2337): the qualifier is a summary, and nobody can acknowledge a conflict they were
|
|
356
|
+
* never shown. The qualifier records HOW the creator chose; it is never part of the brand name.
|
|
357
|
+
*
|
|
358
|
+
* So choosing a conflicting name is an EXPLICIT act — the option the creator picks says "keep despite
|
|
359
|
+
* conflict" — and the creator's answer in the dossier is the durable record of it. A companion-proposed
|
|
360
|
+
* name that conflicts is never offered at all: the companion must not put a conflicting name in front of
|
|
361
|
+
* anyone as a suggestion. Which names are the creator's is read from their own `names-to-screen` answer to
|
|
362
|
+
* `top_down.brand-naming`, never from the origin the screening records — a model wrote that field.
|
|
363
|
+
*/
|
|
364
|
+
export enum BrandNameChoiceQualifier {
|
|
365
|
+
/** Some registers returned a result, but not every register, class or jurisdiction was read: the name is NOT cleared. */
|
|
366
|
+
SCREENING_INCOMPLETE = 'screening-incomplete',
|
|
367
|
+
/** No register returned anything for this name (#2334): it was not screened at all, whatever the record lists. */
|
|
368
|
+
NOT_SCREENED = 'not-screened',
|
|
369
|
+
/** The creator keeps their own name although a live mark or a named competitor conflicts with it. */
|
|
370
|
+
KEEP_DESPITE_CONFLICT = 'keep-despite-conflict',
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
/**
|
|
374
|
+
* Where the creator lists the names THEY want screened: one free-text question of the naming step,
|
|
375
|
+
* answerable with "none". The ONLY source of a candidate's creator-supplied origin — see
|
|
376
|
+
* {@link effectiveBrandNameCandidateOrigin}.
|
|
377
|
+
*/
|
|
378
|
+
export const BRAND_NAMING_NAMES_TO_SCREEN_QUESTION: { readonly playbookRef: string; readonly questionRef: string } = {
|
|
379
|
+
playbookRef: 'top_down.brand-naming',
|
|
380
|
+
questionRef: 'names-to-screen',
|
|
381
|
+
};
|
|
382
|
+
|
|
383
|
+
/** Where the creator records the brand name they CHOSE — the brand identity's computed `brand-name` CHOICE. */
|
|
384
|
+
export const BRAND_IDENTITY_BRAND_NAME_QUESTION: { readonly playbookRef: string; readonly questionRef: string } = {
|
|
385
|
+
playbookRef: 'top_down.brand-identity',
|
|
386
|
+
questionRef: 'brand-name',
|
|
387
|
+
};
|
|
388
|
+
|
|
389
|
+
/**
|
|
390
|
+
* What the creator DECIDED about the brand name, from the dossier: the names they asked to have screened, and the
|
|
391
|
+
* option they chose. The one reader of both, so the choice, the coherence report and the risk signal cannot disagree.
|
|
392
|
+
*
|
|
393
|
+
* Only DECIDED answers count. Both questions are declared ask-never-propose, and this is the second guard: an
|
|
394
|
+
* ASSUMED answer is a model's proposal, and letting it in would make a model's names read as the creator's own and a
|
|
395
|
+
* model's choice read as the creator's decision to keep a conflicting name.
|
|
396
|
+
*/
|
|
397
|
+
export function readCreatorBrandNameDecisions(creatorInputs: ApplicationCreatorInputs | undefined): {
|
|
398
|
+
readonly creatorSuppliedNames: readonly string[];
|
|
399
|
+
readonly chosenBrandNameAnswer: string | undefined;
|
|
400
|
+
} {
|
|
401
|
+
const decided = (question: { readonly playbookRef: string; readonly questionRef: string }): string | undefined =>
|
|
402
|
+
readCreatorInputAnswersForPlaybook(creatorInputs, question.playbookRef)
|
|
403
|
+
.find((answer) => answer.questionRef === question.questionRef && answer.standing !== ApplicationCreatorInputAnswerStanding.ASSUMED)?.answer;
|
|
404
|
+
return {
|
|
405
|
+
creatorSuppliedNames: parseNamesToScreenAnswer(decided(BRAND_NAMING_NAMES_TO_SCREEN_QUESTION)),
|
|
406
|
+
chosenBrandNameAnswer: decided(BRAND_IDENTITY_BRAND_NAME_QUESTION),
|
|
407
|
+
};
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
/**
|
|
411
|
+
* The names a `names-to-screen` answer lists: split on commas, semicolons and line breaks, trimmed, with
|
|
412
|
+
* surrounding quotes removed. "none" (in any case, alone) lists nothing, and so does an absent answer.
|
|
413
|
+
*/
|
|
414
|
+
export function parseNamesToScreenAnswer(answer: string | undefined): readonly string[] {
|
|
415
|
+
if (answer === undefined) return [];
|
|
416
|
+
const names = answer
|
|
417
|
+
.split(/[,;\n]+/u)
|
|
418
|
+
.map((entry) => entry.trim().replace(/^["'“”‘’]+|["'“”‘’]+$/gu, '').trim())
|
|
419
|
+
.filter((entry) => entry.length > 0);
|
|
420
|
+
return names.length === 1 && names[0]!.toLowerCase().replace(/[.!]+$/u, '') === 'none' ? [] : names;
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
/**
|
|
424
|
+
* A candidate's origin as the CREATOR'S ANSWER decides it — never as the producing model labelled it.
|
|
425
|
+
*
|
|
426
|
+
* The origin decides what may be offered (a conflicting companion proposal is never offered; a conflicting
|
|
427
|
+
* name of the creator's own is offered as an explicit keep-despite-conflict), so it must not rest on a field
|
|
428
|
+
* a model wrote. A candidate is the creator's exactly when its name is one they listed in `names-to-screen`;
|
|
429
|
+
* everything else is the companion's proposal, whatever the screening records.
|
|
430
|
+
*/
|
|
431
|
+
export function effectiveBrandNameCandidateOrigin(candidate: Pick<BrandNameCandidate, 'name'>, creatorSuppliedNames: readonly string[]): BrandNameCandidateOrigin {
|
|
432
|
+
const key = normalizeBrandNameForComparison(candidate.name);
|
|
433
|
+
return creatorSuppliedNames.some((name) => normalizeBrandNameForComparison(name) === key)
|
|
434
|
+
? BrandNameCandidateOrigin.CREATOR_SUPPLIED
|
|
435
|
+
: BrandNameCandidateOrigin.COMPANION_PROPOSED;
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
/** One offerable option, with the candidate it stands for and what the creator is shown beside it. */
|
|
439
|
+
export interface OfferableBrandNameOption {
|
|
440
|
+
readonly option: string;
|
|
441
|
+
readonly candidateRef: string;
|
|
442
|
+
readonly qualifier: BrandNameChoiceQualifier | null;
|
|
443
|
+
/** DERIVED: how much of this candidate's screening was read (#2334). */
|
|
444
|
+
readonly coverage: BrandNameScreeningCoverage;
|
|
445
|
+
/** DERIVED: every product the name collides with (#2336) — {@link brandNameCandidateCollisions}. */
|
|
446
|
+
readonly collisions: readonly BrandNameCollision[];
|
|
447
|
+
/** The line shown beside the option (#2337) — {@link describeBrandNameOption}. */
|
|
448
|
+
readonly detail: string;
|
|
449
|
+
}
|
|
450
|
+
|
|
451
|
+
/** The option string for a name and an optional qualifier. */
|
|
452
|
+
export function formatBrandNameChoiceOption(name: string, qualifier: BrandNameChoiceQualifier | null): string {
|
|
453
|
+
return qualifier === null ? name : `${name} [${qualifier}]`;
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
/**
|
|
457
|
+
* The name and qualifier an option string carries — the inverse of {@link formatBrandNameChoiceOption}.
|
|
458
|
+
* A trailing bracket that is not a known qualifier is part of the name.
|
|
459
|
+
*/
|
|
460
|
+
export function parseBrandNameChoiceOption(option: string): { readonly name: string; readonly qualifier: BrandNameChoiceQualifier | null } {
|
|
461
|
+
const trimmed = option.trim();
|
|
462
|
+
const match = /^(.*\S)\s+\[([a-z-]+)\]$/.exec(trimmed);
|
|
463
|
+
const qualifier = match ? Object.values(BrandNameChoiceQualifier).find((candidate) => candidate === match[2]) : undefined;
|
|
464
|
+
return match && qualifier !== undefined ? { name: match[1]!, qualifier } : { name: trimmed, qualifier: null };
|
|
465
|
+
}
|
|
466
|
+
```
|