@wildo-ai/framework-knowledge 1.1.7 → 1.1.9
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/plugins/wildo/.claude-plugin/plugin.json +1 -1
- 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/runs-judges-and-questions.md +29 -5
- 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 +11 -1
- 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 +11 -1
- package/dist/esm/framework-knowledge.definitions.js.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.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 +3 -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 +59 -10
- 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.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.js +1 -1
- 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 +2 -1
- 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 +5 -5
- package/dist/esm/playbooks/bottom_up.domain-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/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 +85 -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 +40 -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 +41 -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 +199 -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 +201 -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 +67 -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 +76 -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.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-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.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.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 +36 -2
- package/dist/esm/playbooks/top_down.phase-gate/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.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 +30 -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 +117 -28
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +133 -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 +2 -2
- 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 +22 -6
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/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 +71 -37
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +105 -0
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +55 -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 +78 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +63 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +65 -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.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.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.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 +10 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +40 -17
- package/dist/knowledge/references/brand.name-choice.config.md +127 -0
- package/dist/knowledge/references/brand.name-screening.config.md +253 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +64 -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/example.data-seeding.minimal.md +29 -1
- package/dist/knowledge/references/market.snapshot.validation.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +6 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +9 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +4 -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.sections.definition-schema.md +11 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +38 -1
- package/dist/knowledge/registries/playbooks.json +68 -20
- package/dist/knowledge/registries/source-tags.json +748 -695
- package/dist/knowledge/rules/live-context-door.md +5 -2
- package/dist/knowledge/skills/INDEX.md +2 -1
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -1
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +154 -0
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +394 -0
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +65 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +5 -2
- package/dist/knowledge/skills/config-saas/SKILL.md +31 -4
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +14 -1
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +11 -1
- 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-companion-prompt-enrichment/SKILL.md +11 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +11 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -1
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +6 -4
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +51 -3
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +6 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +84 -3
- 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 +15 -0
- 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 +15 -0
- 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 +15 -0
- 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 +27 -9
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +15 -0
- 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 +15 -0
- 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 +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
- package/dist/knowledge/topic-index.json +169 -43
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -25,6 +25,7 @@ empty or fails.
|
|
|
25
25
|
| `wildo context workspace map\|get\|related` | the application's own code, by resource — its fields, operations and relationships — instead of the whole registry |
|
|
26
26
|
| `wildo context journey` | where the application's creation stands: what is eligible, what is unmet, and what each run took and spent — per round and per child for a composite, with the rounds that began from a state an earlier round had already begun from |
|
|
27
27
|
| `wildo context coherence` | what disagrees across the landed specification families |
|
|
28
|
+
| `wildo context launch-blockers` | what still stands between the application and a real user — each open compliance decision (an undeclared part of `operatorComplianceIdentity`, an unanswered governance question, an undeclared retention class, undeclared subject-data recipients, sign-up acceptance), where it is decided and what settles it. It marks and never blocks; a settled item is gone on the next read |
|
|
28
29
|
| `wildo context health` | whether the companion is answering at all |
|
|
29
30
|
|
|
30
31
|
## Commands that ask the running application backend
|
|
@@ -83,8 +84,10 @@ prompt, and from a background monitor); the detail is always read with these ver
|
|
|
83
84
|
|---|---|
|
|
84
85
|
| `wildo creation feed` | what happened (a run completed or was refused, a dispatch settled), what is asked of you, what could come next |
|
|
85
86
|
| `wildo creation feed --follow --exit-on-change` | waits, and returns at the first new event — the loop to run after starting work |
|
|
86
|
-
| `wildo creation questions` | every question waiting on an answer, each with the exact command that answers it |
|
|
87
|
-
| `wildo creation answer <id> --revision <r> …` | answers, declines or cancels one of them. Every answer records who gave it: `--person` for the person's, `--derived <ref>=<value> --derived-by agent:<name>` for one the application's own files settle — the verb refuses an unattributed answer from inside an agent session |
|
|
87
|
+
| `wildo creation questions` | every question waiting on an answer, each with the exact command that answers it — and, apart and not counted, the assumed answers the person may revisit |
|
|
88
|
+
| `wildo creation answer <id> --revision <r> …` | answers, declines or cancels one of them. Every answer records who gave it: `--person` for the person's, `--derived <ref>=<value> --derived-by agent:<name>` for one the application's own files settle, `--assumed "<value>" --rationale "<why>"` for a proposal the person kept because they did not know — the verb refuses an unattributed answer from inside an agent session |
|
|
89
|
+
| `wildo creation propose <playbookRef> [--question <ref>]` | proposes answers to interview questions the person does not know; writes nothing |
|
|
90
|
+
| `wildo creation depth [simple\|detailed]` | reads or records how detailed this application's interviews are |
|
|
88
91
|
|
|
89
92
|
Check `wildo creation questions` whenever work you started through the companion seems not to move:
|
|
90
93
|
a run waiting on an answer looks exactly like a slow one. The `/wildo:run` and `/wildo:build` commands carry the loop.
|
|
@@ -225,6 +225,7 @@ design-system color TOKENS (`config-design-system`).
|
|
|
225
225
|
| Skill | Trigger phrases |
|
|
226
226
|
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
227
227
|
| **`brand-logo-authoring`** — author the `BrandSnapshot` brief (brand name, logo direction, visual tone) that drives logo + brand-image generation | "give the app a logo", "design our logo", "author the brand identity", "set the logo direction", "we need a brand mark", "generate the app logo", "what should our logo look like", "define the visual identity / visual tone" |
|
|
228
|
+
| **`brand-name-screening`** — propose brand names and run a minimal trademark screening of each (registers, Nice classes, jurisdictions, competitor collisions) into the `BrandNameScreening` the creator chooses the name from | "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", "the name conflicts with a trademark" |
|
|
228
229
|
|
|
229
230
|
### Backend — DI, controllers, custom operations
|
|
230
231
|
|
|
@@ -292,7 +293,7 @@ surprises you.
|
|
|
292
293
|
| Skill | Trigger phrases |
|
|
293
294
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
294
295
|
| **`infra-environment-config`** — edit infra/environment configuration (URLs, secret refs, endpoints) | "change local environment config", "add deployed environment target", "wire secret reference in infra", "update dev stack URLs" |
|
|
295
|
-
| **`local-environment-bootstrap`** — drive `wildo setup` / `wildo local init/reinit/dev/up/down/reset` / `wildo config sync` to initialize, repair, verify, start, and reset the complete local project generation | "initialize my project", "repair broken platform or Mongo state", "my Mongo volume was reset", "reinitialize from empty data", "set up my local stack", "regenerate runtime env files", "reset my local data" |
|
|
296
|
+
| **`local-environment-bootstrap`** — drive `wildo setup` / `wildo local init/reinit/dev/up/down/reset` / `wildo config sync` to initialize, repair, verify, start, and reset the complete local project generation | "initialize my project", "repair broken platform or Mongo state", "my Mongo volume was reset", "reinitialize from empty data", "set up my local stack", "regenerate runtime env files", "reset my local data", "a dev server says a generated file must be regenerated", "is this generated file stale" |
|
|
296
297
|
| **`frontend-cdn-publish`** — configure the OPT-IN `cdn?[serviceKey]` block + `wildo frontend publish` to serve a frontend from object storage + a CDN (Cloudflare live adapter or GENERIC) instead of its nginx pod | "put the website on a CDN", "serve docs from a CDN instead of nginx", "configure CDN publishing", "set up Cloudflare for the app", "wildo frontend publish", "upload the frontend dist to S3 + CDN", "re-home CSP to the edge" |
|
|
297
298
|
| **`application-database-migrations`** — generate, review and apply PostgreSQL migrations so the database matches the resource model (PostgreSQL-backed applications only) | "I added a resource and the backend won't start", "table does not exist", "postgresql_table_schema_mismatch", "generate a migration", "wildo db generate", "the schema plan is out of sync", "do I need a migration for this field", "my migration was refused" |
|
|
298
299
|
|
|
@@ -195,7 +195,7 @@ narrow, and both limits are worth knowing:
|
|
|
195
195
|
| The plan and the model agree (exits 0) | `wildo db diff --check` |
|
|
196
196
|
| A lockfile exists at all — without one, no migration has ever been accepted | `ls backend-api/migrations/schema-plan.lock.json` |
|
|
197
197
|
| Every migration folder actually contains SQL (an empty folder applies nothing) | `comm -23 <(ls -d backend-api/migrations/*/ \| xargs -n1 basename \| sort) <(rg -l --no-messages "" backend-api/migrations/*/migration.sql \| xargs -n1 dirname \| xargs -n1 basename \| sort)` |
|
|
198
|
-
| No destructive statement is missing its acknowledgement | `rg -l "^drop table\|drop column" backend-api/migrations/*/migration.sql \| xargs -r rg -
|
|
198
|
+
| No destructive statement is missing its acknowledgement | `rg -l "^drop table\|drop column" backend-api/migrations/*/migration.sql \| xargs -r rg --files-without-match "wildo:acknowledge-destructive"` |
|
|
199
199
|
| The lockfile moved in the same commit as a new migration | `git show --name-only HEAD \| rg "schema-plan.lock.json"` |
|
|
200
200
|
|
|
201
201
|
## Common Rationalizations
|
|
@@ -0,0 +1,154 @@
|
|
|
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** come from the market's ICP geographies, the vision's compliance detail and
|
|
63
|
+
the operating jurisdictions the application declares. Resolve a region tag to countries.
|
|
64
|
+
If any EU member state is targeted, add `EU` (an EU trade mark has effect in every member
|
|
65
|
+
state). International registrations (`WO`) are always in scope.
|
|
66
|
+
- **Nice classes**: 9 and 42 for every software product, 35 for business-management and CRM
|
|
67
|
+
tools, plus any class the category implies, each with a reason.
|
|
68
|
+
|
|
69
|
+
### Step 2: Propose (at least five)
|
|
70
|
+
|
|
71
|
+
Ground each in the vision's idea and mission and the market's category language and tone of
|
|
72
|
+
voice. Prefer distinctive names; a purely descriptive one is weak as a mark. **No proposal may
|
|
73
|
+
be identical or close to a competitor or alternative the market names.**
|
|
74
|
+
|
|
75
|
+
### Step 3: Screen every candidate, proposed or the creator's
|
|
76
|
+
|
|
77
|
+
Search EUIPO (EU marks), TMview (EU and national offices), the WIPO Global Brand Database
|
|
78
|
+
(international marks), and any targeted national office not already covered. Search identical
|
|
79
|
+
and near-identical marks, and record live marks only (registered or pending). See
|
|
80
|
+
`references/screening-procedure.md` for the register list and the match rules.
|
|
81
|
+
|
|
82
|
+
### Step 4: Record honestly: a failure is not an answer
|
|
83
|
+
|
|
84
|
+
A register you could not query or read is **`UNKNOWN`, with a note**, never `CLEAR`. `CONFLICT`
|
|
85
|
+
exactly when a live identical or near-identical mark was found, with every such mark listed and
|
|
86
|
+
sourced. Every query carries its source URL and date. There is **no candidate-level verdict to
|
|
87
|
+
write**. `deriveBrandNameTrademarkOutcome` computes it from the queries, so a candidate with an
|
|
88
|
+
unchecked register reads as not cleared. Field contracts: `references/framework-brand-name-screening-api.md`.
|
|
89
|
+
|
|
90
|
+
### Step 5: Hand the choice over
|
|
91
|
+
|
|
92
|
+
The brand-identity interview offers options computed by `deriveOfferableBrandNameOptions`:
|
|
93
|
+
|
|
94
|
+
- a clear name, as itself;
|
|
95
|
+
- an incomplete one, as `Name [screening-incomplete]`;
|
|
96
|
+
- a creator-supplied name that conflicts, as `Name [keep-despite-conflict]`.
|
|
97
|
+
|
|
98
|
+
A conflicting proposal is never offered. The creator's answer is the record of their decision.
|
|
99
|
+
To screen another name of their own, they add it to `top_down.brand-naming`'s interview
|
|
100
|
+
(`names-to-screen`) and re-run it. Stop there: choosing is not this skill's job.
|
|
101
|
+
|
|
102
|
+
## References
|
|
103
|
+
|
|
104
|
+
- `references/framework-brand-name-screening-api.md` — source-backed: the `BrandNameScreening`
|
|
105
|
+
shape, the derived outcome, and the choice vocabulary.
|
|
106
|
+
- `references/screening-procedure.md` — authored: registers, classes, match types, status rules,
|
|
107
|
+
and how to word a result.
|
|
108
|
+
|
|
109
|
+
## Verification
|
|
110
|
+
|
|
111
|
+
- [ ] Every declared jurisdiction follows from the product, and `EU` is present when an EU member
|
|
112
|
+
state is targeted.
|
|
113
|
+
- [ ] Classes 9 and 42 are searched.
|
|
114
|
+
- [ ] Every query has a `sourceUrl` and a `checkedOn` date.
|
|
115
|
+
- [ ] No query the research could not run is recorded as `CLEAR`.
|
|
116
|
+
- [ ] No proposal collides with a market competitor or alternative.
|
|
117
|
+
- [ ] Nothing says "available", "free to use" or "cleared".
|
|
118
|
+
|
|
119
|
+
### Grep invariants
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
# no clearance language anywhere in the landed screening or the brand
|
|
123
|
+
rg -n -i "\b(available|cleared|free to use|clearance granted)\b" specifications/src/brand-name-screening specifications/src/brand
|
|
124
|
+
# the slot is wired
|
|
125
|
+
rg -n "brandNameScreening" specifications/src/companion-exports.ts
|
|
126
|
+
# the deterministic validator and the coherence report
|
|
127
|
+
wildo context coherence
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## Common Rationalizations
|
|
131
|
+
|
|
132
|
+
| Rationalization | Reality |
|
|
133
|
+
|---|---|
|
|
134
|
+
| "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. |
|
|
135
|
+
| "A quick web search found nothing, so it is clear." | Search engines do not index trademark registers. Only the register's own result counts. |
|
|
136
|
+
| "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. |
|
|
137
|
+
| "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. |
|
|
138
|
+
| "Say the name is available; that is what the creator wants to hear." | A screening is not a legal clearance opinion. Never claim availability. |
|
|
139
|
+
|
|
140
|
+
## Red Flags
|
|
141
|
+
|
|
142
|
+
- A query with outcome `CLEAR` for TMview or WIPO with no source URL. Catch it with the "every
|
|
143
|
+
query has a sourceUrl" check above.
|
|
144
|
+
- A proposal sharing a stem with a named competitor. Catch it with `wildo context coherence` (the
|
|
145
|
+
options computation drops it, and the judge reports it).
|
|
146
|
+
- The word "available" or "cleared" in the brand or screening. Catch it with the first grep above.
|
|
147
|
+
- No `EU` jurisdiction while an EU country is targeted. Catch it with the validator's
|
|
148
|
+
`EU_TRADE_MARK_NOT_DECLARED` finding.
|
|
149
|
+
|
|
150
|
+
## Related Skills
|
|
151
|
+
|
|
152
|
+
- `brand-logo-authoring` — the brand brief that carries the chosen name, and its logo direction.
|
|
153
|
+
- `market-alternatives` — the competitors and alternatives a name must stay distinct from.
|
|
154
|
+
- `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,394 @@
|
|
|
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
|
+
/** A candidate's derived trademark standing — see {@link deriveBrandNameTrademarkOutcome}. */
|
|
116
|
+
export enum BrandNameTrademarkOutcome {
|
|
117
|
+
CLEAR = 'CLEAR',
|
|
118
|
+
CONFLICT = 'CONFLICT',
|
|
119
|
+
UNKNOWN = 'UNKNOWN',
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** The pseudo-jurisdiction an EU trade mark covers. */
|
|
123
|
+
export const EU_TRADE_MARK_JURISDICTION = 'EU';
|
|
124
|
+
/** The pseudo-jurisdiction an international (Madrid, via WIPO) registration covers. */
|
|
125
|
+
export const INTERNATIONAL_REGISTRATION_JURISDICTION = 'WO';
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* The EU member states (ISO 3166-1 alpha-2) — a target in any of them makes an EU trade mark relevant,
|
|
129
|
+
* because an EUTM has effect in every member state.
|
|
130
|
+
*/
|
|
131
|
+
export const EU_MEMBER_STATE_CODES: readonly string[] = [
|
|
132
|
+
'AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE',
|
|
133
|
+
'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE',
|
|
134
|
+
];
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* A jurisdiction code: an ISO 3166-1 alpha-2 country, `EU` (an EU trade mark) or `WO` (an international
|
|
138
|
+
* registration). Stated as a description too, because a JSON schema shown to a generating model drops
|
|
139
|
+
* the refinement.
|
|
140
|
+
*/
|
|
141
|
+
export const BrandNameJurisdictionCodeSchema = z
|
|
142
|
+
.string()
|
|
143
|
+
.trim()
|
|
144
|
+
.regex(/^[A-Z]{2}$/)
|
|
145
|
+
.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.');
|
|
146
|
+
|
|
147
|
+
/** The first Nice class number. */
|
|
148
|
+
export const NICE_CLASS_MIN = 1;
|
|
149
|
+
/** The last Nice class number (the Nice Classification has 45 classes: 1–34 goods, 35–45 services). */
|
|
150
|
+
export const NICE_CLASS_MAX = 45;
|
|
151
|
+
|
|
152
|
+
/** The Nice classes every software product lives in: 9 (downloadable software) and 42 (SaaS). */
|
|
153
|
+
export const SOFTWARE_NICE_CLASSES: readonly number[] = [9, 42];
|
|
154
|
+
|
|
155
|
+
const NiceClassNumberSchema = z.number().int().min(NICE_CLASS_MIN).max(NICE_CLASS_MAX);
|
|
156
|
+
/** An ISO calendar date (`YYYY-MM-DD`): the day a check was made. */
|
|
157
|
+
const IsoDateSchema = z.iso.date();
|
|
158
|
+
|
|
159
|
+
/** One jurisdiction the screening covers, and where that target came from. */
|
|
160
|
+
export const BrandNameScreeningJurisdictionSchema = z.object({
|
|
161
|
+
code: BrandNameJurisdictionCodeSchema,
|
|
162
|
+
/** What declared this target — an ICP geography, a vision compliance detail, the application's configured jurisdictions. */
|
|
163
|
+
derivedFrom: NonEmptyStringSchema,
|
|
164
|
+
});
|
|
165
|
+
export type BrandNameScreeningJurisdiction = z.infer<typeof BrandNameScreeningJurisdictionSchema>;
|
|
166
|
+
|
|
167
|
+
/** One Nice class searched, and why this product lives in it. */
|
|
168
|
+
export const BrandNameScreeningNiceClassSchema = z.object({
|
|
169
|
+
classNumber: NiceClassNumberSchema,
|
|
170
|
+
rationale: NonEmptyStringSchema,
|
|
171
|
+
});
|
|
172
|
+
export type BrandNameScreeningNiceClass = z.infer<typeof BrandNameScreeningNiceClassSchema>;
|
|
173
|
+
|
|
174
|
+
/** A live mark a query found, with the record it was read from. */
|
|
175
|
+
export const BrandNameConflictingMarkSchema = z.object({
|
|
176
|
+
/** The mark as registered. */
|
|
177
|
+
mark: NonEmptyStringSchema,
|
|
178
|
+
owner: NonEmptyStringSchema.optional(),
|
|
179
|
+
/** The application or registration number on the register. */
|
|
180
|
+
registrationNumber: NonEmptyStringSchema.optional(),
|
|
181
|
+
/** The Nice classes the mark is registered or filed in. */
|
|
182
|
+
niceClasses: z.array(NiceClassNumberSchema).min(1),
|
|
183
|
+
status: z.enum(BrandNameConflictingMarkStatus).systemEnum('BrandNameConflictingMarkStatus'),
|
|
184
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
185
|
+
/** The register record that was read. */
|
|
186
|
+
sourceUrl: z.url(),
|
|
187
|
+
});
|
|
188
|
+
export type BrandNameConflictingMark = z.infer<typeof BrandNameConflictingMarkSchema>;
|
|
189
|
+
|
|
190
|
+
/** One search of one register for one candidate. */
|
|
191
|
+
export const BrandNameTrademarkQuerySchema = z.object({
|
|
192
|
+
register: z.enum(BrandNameTrademarkRegister).systemEnum('BrandNameTrademarkRegister'),
|
|
193
|
+
/** The jurisdictions this search covers (`EU` for an EUTM search, `WO` for international registrations, country codes otherwise). */
|
|
194
|
+
jurisdictionsCovered: z.array(BrandNameJurisdictionCodeSchema).min(1),
|
|
195
|
+
niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
|
|
196
|
+
matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
|
|
197
|
+
outcome: z.enum(BrandNameTrademarkQueryOutcome).systemEnum('BrandNameTrademarkQueryOutcome'),
|
|
198
|
+
/** Every live mark found. Present exactly when the outcome is CONFLICT. */
|
|
199
|
+
conflictingMarks: z.array(BrandNameConflictingMarkSchema).default([]),
|
|
200
|
+
/** The search or results page that was read — what a reader opens to check this row. */
|
|
201
|
+
sourceUrl: z.url(),
|
|
202
|
+
checkedOn: IsoDateSchema,
|
|
203
|
+
/** Why an UNKNOWN query is unknown, or anything a reader needs to interpret the result. */
|
|
204
|
+
note: NonEmptyStringSchema.optional(),
|
|
205
|
+
});
|
|
206
|
+
export type BrandNameTrademarkQuery = z.infer<typeof BrandNameTrademarkQuerySchema>;
|
|
207
|
+
|
|
208
|
+
/** A domain checked for a candidate — exact match on `.com` and the main ccTLDs of the target countries. */
|
|
209
|
+
export const BrandNameDomainSignalSchema = z.object({
|
|
210
|
+
domain: NonEmptyStringSchema,
|
|
211
|
+
status: z.enum(BrandNameDomainStatus).systemEnum('BrandNameDomainStatus'),
|
|
212
|
+
checkedOn: IsoDateSchema,
|
|
213
|
+
sourceUrl: z.url().optional(),
|
|
214
|
+
});
|
|
215
|
+
export type BrandNameDomainSignal = z.infer<typeof BrandNameDomainSignalSchema>;
|
|
216
|
+
|
|
217
|
+
/** A company or product already trading under (or close to) the name in the same category. */
|
|
218
|
+
export const BrandNameSameCategoryUseSchema = z.object({
|
|
219
|
+
name: NonEmptyStringSchema,
|
|
220
|
+
sourceUrl: z.url(),
|
|
221
|
+
note: NonEmptyStringSchema.optional(),
|
|
222
|
+
});
|
|
223
|
+
export type BrandNameSameCategoryUse = z.infer<typeof BrandNameSameCategoryUseSchema>;
|
|
224
|
+
|
|
225
|
+
/** A competitor or alternative named in the market snapshot that the candidate is identical or confusingly close to. */
|
|
226
|
+
export const BrandNameCompetitorCollisionSchema = z.object({
|
|
227
|
+
/** The market snapshot's alternative ref, when the collision is with one of its alternatives. */
|
|
228
|
+
alternativeRef: NonEmptyStringSchema.optional(),
|
|
229
|
+
/** The competitor's name as the market snapshot names it. */
|
|
230
|
+
competitorName: NonEmptyStringSchema,
|
|
231
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
232
|
+
});
|
|
233
|
+
export type BrandNameCompetitorCollision = z.infer<typeof BrandNameCompetitorCollisionSchema>;
|
|
234
|
+
|
|
235
|
+
/** One candidate name and everything its screening found. */
|
|
236
|
+
export const BrandNameCandidateSchema = z.object({
|
|
237
|
+
/** Stable ref (`name-<slug>`), stamped by the runtime. */
|
|
238
|
+
ref: z.string().regex(/^name-[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
239
|
+
/** The exact, case-sensitive name. */
|
|
240
|
+
name: NonEmptyStringSchema,
|
|
241
|
+
origin: z.enum(BrandNameCandidateOrigin).systemEnum('BrandNameCandidateOrigin'),
|
|
242
|
+
/** Why this name fits: what in the vision and the market's category language and voice it answers. Empty for a creator-supplied name. */
|
|
243
|
+
rationale: NonEmptyStringSchema.optional(),
|
|
244
|
+
trademarkQueries: z.array(BrandNameTrademarkQuerySchema).default([]),
|
|
245
|
+
competitorCollisions: z.array(BrandNameCompetitorCollisionSchema).default([]),
|
|
246
|
+
domainSignals: z.array(BrandNameDomainSignalSchema).default([]),
|
|
247
|
+
sameCategoryUses: z.array(BrandNameSameCategoryUseSchema).default([]),
|
|
248
|
+
});
|
|
249
|
+
export type BrandNameCandidate = z.infer<typeof BrandNameCandidateSchema>;
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* THE brand-name screening payload — one per application. `jurisdictions` and `niceClasses` are the
|
|
253
|
+
* coverage every candidate is measured against: a candidate whose queries do not reach all of them is
|
|
254
|
+
* UNKNOWN, whatever its queries say.
|
|
255
|
+
*/
|
|
256
|
+
export const BrandNameScreeningSchema = z.object({
|
|
257
|
+
version: z.enum(BrandNameScreeningVersion).default(BrandNameScreeningVersion.V1),
|
|
258
|
+
/** The day the screening was run. */
|
|
259
|
+
screenedOn: IsoDateSchema,
|
|
260
|
+
jurisdictions: z.array(BrandNameScreeningJurisdictionSchema).min(1),
|
|
261
|
+
niceClasses: z.array(BrandNameScreeningNiceClassSchema).min(1),
|
|
262
|
+
candidates: z.array(BrandNameCandidateSchema).min(1),
|
|
263
|
+
});
|
|
264
|
+
export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
- The **choice vocabulary** (which candidates are offered, and the bracketed qualifiers that
|
|
268
|
+
record an incomplete screening or an explicit keep-despite-conflict):
|
|
269
|
+
|
|
270
|
+
## Import Origins
|
|
271
|
+
|
|
272
|
+
- `@wildo-ai/saas-specifications`
|
|
273
|
+
|
|
274
|
+
## Source Excerpts
|
|
275
|
+
|
|
276
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
277
|
+
|
|
278
|
+
```typescript
|
|
279
|
+
*
|
|
280
|
+
* Which screened names the creator is OFFERED, and how a choice records what the creator accepted.
|
|
281
|
+
*
|
|
282
|
+
* The `top_down.brand-identity` interview asks `brand-name` as a CHOICE whose options are computed from
|
|
283
|
+
* the landed `brand-name-screening` by {@link deriveOfferableBrandNameOptions} — never written by a model.
|
|
284
|
+
* An option is the exact name, optionally followed by ONE bracketed qualifier from
|
|
285
|
+
* {@link BrandNameChoiceQualifier}:
|
|
286
|
+
*
|
|
287
|
+
* | candidate | offered as |
|
|
288
|
+
* |---|---|
|
|
289
|
+
* | CLEAR, no competitor collision | `Batisio` |
|
|
290
|
+
* | UNKNOWN (a register could not be read, or coverage is incomplete), no collision | `Batisio [screening-incomplete]` |
|
|
291
|
+
* | CONFLICT or competitor collision, **creator-supplied** | `Keystone [keep-despite-conflict]` |
|
|
292
|
+
* | CONFLICT or competitor collision, **companion-proposed** | not offered |
|
|
293
|
+
*
|
|
294
|
+
* So choosing a conflicting name is an EXPLICIT act — the option the creator picks says "keep despite
|
|
295
|
+
* conflict" — and the creator's answer in the dossier is the durable record of it. A companion-proposed
|
|
296
|
+
* name that conflicts is never offered at all: the companion must not put a conflicting name in front of
|
|
297
|
+
* anyone as a suggestion. Which names are the creator's is read from their own `names-to-screen` answer to
|
|
298
|
+
* `top_down.brand-naming`, never from the origin the screening records — a model wrote that field.
|
|
299
|
+
*/
|
|
300
|
+
export enum BrandNameChoiceQualifier {
|
|
301
|
+
/** The screening could not reach every register, class or jurisdiction: the name is NOT cleared. */
|
|
302
|
+
SCREENING_INCOMPLETE = 'screening-incomplete',
|
|
303
|
+
/** The creator keeps their own name although a live mark or a named competitor conflicts with it. */
|
|
304
|
+
KEEP_DESPITE_CONFLICT = 'keep-despite-conflict',
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/**
|
|
308
|
+
* Where the creator lists the names THEY want screened: one free-text question of the naming step,
|
|
309
|
+
* answerable with "none". The ONLY source of a candidate's creator-supplied origin — see
|
|
310
|
+
* {@link effectiveBrandNameCandidateOrigin}.
|
|
311
|
+
*/
|
|
312
|
+
export const BRAND_NAMING_NAMES_TO_SCREEN_QUESTION: { readonly playbookRef: string; readonly questionRef: string } = {
|
|
313
|
+
playbookRef: 'top_down.brand-naming',
|
|
314
|
+
questionRef: 'names-to-screen',
|
|
315
|
+
};
|
|
316
|
+
|
|
317
|
+
/** Where the creator records the brand name they CHOSE — the brand identity's computed `brand-name` CHOICE. */
|
|
318
|
+
export const BRAND_IDENTITY_BRAND_NAME_QUESTION: { readonly playbookRef: string; readonly questionRef: string } = {
|
|
319
|
+
playbookRef: 'top_down.brand-identity',
|
|
320
|
+
questionRef: 'brand-name',
|
|
321
|
+
};
|
|
322
|
+
|
|
323
|
+
/**
|
|
324
|
+
* What the creator DECIDED about the brand name, from the dossier: the names they asked to have screened, and the
|
|
325
|
+
* option they chose. The one reader of both, so the choice, the coherence report and the risk signal cannot disagree.
|
|
326
|
+
*
|
|
327
|
+
* Only DECIDED answers count. Both questions are declared ask-never-propose, and this is the second guard: an
|
|
328
|
+
* 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
|
|
329
|
+
* model's choice read as the creator's decision to keep a conflicting name.
|
|
330
|
+
*/
|
|
331
|
+
export function readCreatorBrandNameDecisions(creatorInputs: ApplicationCreatorInputs | undefined): {
|
|
332
|
+
readonly creatorSuppliedNames: readonly string[];
|
|
333
|
+
readonly chosenBrandNameAnswer: string | undefined;
|
|
334
|
+
} {
|
|
335
|
+
const decided = (question: { readonly playbookRef: string; readonly questionRef: string }): string | undefined =>
|
|
336
|
+
readCreatorInputAnswersForPlaybook(creatorInputs, question.playbookRef)
|
|
337
|
+
.find((answer) => answer.questionRef === question.questionRef && answer.standing !== ApplicationCreatorInputAnswerStanding.ASSUMED)?.answer;
|
|
338
|
+
return {
|
|
339
|
+
creatorSuppliedNames: parseNamesToScreenAnswer(decided(BRAND_NAMING_NAMES_TO_SCREEN_QUESTION)),
|
|
340
|
+
chosenBrandNameAnswer: decided(BRAND_IDENTITY_BRAND_NAME_QUESTION),
|
|
341
|
+
};
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* The names a `names-to-screen` answer lists: split on commas, semicolons and line breaks, trimmed, with
|
|
346
|
+
* surrounding quotes removed. "none" (in any case, alone) lists nothing, and so does an absent answer.
|
|
347
|
+
*/
|
|
348
|
+
export function parseNamesToScreenAnswer(answer: string | undefined): readonly string[] {
|
|
349
|
+
if (answer === undefined) return [];
|
|
350
|
+
const names = answer
|
|
351
|
+
.split(/[,;\n]+/u)
|
|
352
|
+
.map((entry) => entry.trim().replace(/^["'“”‘’]+|["'“”‘’]+$/gu, '').trim())
|
|
353
|
+
.filter((entry) => entry.length > 0);
|
|
354
|
+
return names.length === 1 && names[0]!.toLowerCase().replace(/[.!]+$/u, '') === 'none' ? [] : names;
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
/**
|
|
358
|
+
* A candidate's origin as the CREATOR'S ANSWER decides it — never as the producing model labelled it.
|
|
359
|
+
*
|
|
360
|
+
* The origin decides what may be offered (a conflicting companion proposal is never offered; a conflicting
|
|
361
|
+
* name of the creator's own is offered as an explicit keep-despite-conflict), so it must not rest on a field
|
|
362
|
+
* a model wrote. A candidate is the creator's exactly when its name is one they listed in `names-to-screen`;
|
|
363
|
+
* everything else is the companion's proposal, whatever the screening records.
|
|
364
|
+
*/
|
|
365
|
+
export function effectiveBrandNameCandidateOrigin(candidate: Pick<BrandNameCandidate, 'name'>, creatorSuppliedNames: readonly string[]): BrandNameCandidateOrigin {
|
|
366
|
+
const key = normalizeBrandNameForComparison(candidate.name);
|
|
367
|
+
return creatorSuppliedNames.some((name) => normalizeBrandNameForComparison(name) === key)
|
|
368
|
+
? BrandNameCandidateOrigin.CREATOR_SUPPLIED
|
|
369
|
+
: BrandNameCandidateOrigin.COMPANION_PROPOSED;
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
/** One offerable option, with the candidate it stands for. */
|
|
373
|
+
export interface OfferableBrandNameOption {
|
|
374
|
+
readonly option: string;
|
|
375
|
+
readonly candidateRef: string;
|
|
376
|
+
readonly qualifier: BrandNameChoiceQualifier | null;
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/** The option string for a name and an optional qualifier. */
|
|
380
|
+
export function formatBrandNameChoiceOption(name: string, qualifier: BrandNameChoiceQualifier | null): string {
|
|
381
|
+
return qualifier === null ? name : `${name} [${qualifier}]`;
|
|
382
|
+
}
|
|
383
|
+
|
|
384
|
+
/**
|
|
385
|
+
* The name and qualifier an option string carries — the inverse of {@link formatBrandNameChoiceOption}.
|
|
386
|
+
* A trailing bracket that is not a known qualifier is part of the name.
|
|
387
|
+
*/
|
|
388
|
+
export function parseBrandNameChoiceOption(option: string): { readonly name: string; readonly qualifier: BrandNameChoiceQualifier | null } {
|
|
389
|
+
const trimmed = option.trim();
|
|
390
|
+
const match = /^(.*\S)\s+\[([a-z-]+)\]$/.exec(trimmed);
|
|
391
|
+
const qualifier = match ? Object.values(BrandNameChoiceQualifier).find((candidate) => candidate === match[2]) : undefined;
|
|
392
|
+
return match && qualifier !== undefined ? { name: match[1]!, qualifier } : { name: trimmed, qualifier: null };
|
|
393
|
+
}
|
|
394
|
+
```
|