@wildo-ai/framework-knowledge 1.1.9 → 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/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- 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 +84 -4
- 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 +1 -1
- 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 +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
- 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 +132 -20
- 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.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 +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 +85 -8
- 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.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 +2 -2
- 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 +10 -4
- 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 +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.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.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.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.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.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.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.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.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
- 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 +149 -11
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -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 +107 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
- 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.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 +2 -1
- 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 +7 -3
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- 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.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 +1 -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.vision-elicitation/method.md +19 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
- 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 +10 -9
- 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/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.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -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.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.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -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.legal.public-document-links.md +76 -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.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 +337 -1
- package/dist/knowledge/registries/playbooks.json +18 -18
- package/dist/knowledge/registries/source-tags.json +1435 -873
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- 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 +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
- 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 +25 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -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 +27 -5
- 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 +18 -4
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- 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 +11 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
- 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-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 +14 -3
- 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-relationships/SKILL.md +31 -4
- 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 +155 -40
- 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 +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- 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-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 +10 -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 +16 -5
- 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-faq/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
- package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
- 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 +1441 -269
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -59,8 +59,11 @@ Derive the coverage → propose → screen → record honestly → hand the choi
|
|
|
59
59
|
|
|
60
60
|
### Step 1: Derive the coverage, never assume it
|
|
61
61
|
|
|
62
|
-
- **Jurisdictions**
|
|
63
|
-
the
|
|
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.
|
|
64
67
|
If any EU member state is targeted, add `EU` (an EU trade mark has effect in every member
|
|
65
68
|
state). International registrations (`WO`) are always in scope.
|
|
66
69
|
- **Nice classes**: 9 and 42 for every software product, 35 for business-management and CRM
|
|
@@ -76,8 +79,15 @@ be identical or close to a competitor or alternative the market names.**
|
|
|
76
79
|
|
|
77
80
|
Search EUIPO (EU marks), TMview (EU and national offices), the WIPO Global Brand Database
|
|
78
81
|
(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).
|
|
80
|
-
|
|
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.
|
|
81
91
|
|
|
82
92
|
### Step 4: Record honestly: a failure is not an answer
|
|
83
93
|
|
|
@@ -85,17 +95,25 @@ A register you could not query or read is **`UNKNOWN`, with a note**, never `CLE
|
|
|
85
95
|
exactly when a live identical or near-identical mark was found, with every such mark listed and
|
|
86
96
|
sourced. Every query carries its source URL and date. There is **no candidate-level verdict to
|
|
87
97
|
write**. `deriveBrandNameTrademarkOutcome` computes it from the queries, so a candidate with an
|
|
88
|
-
unchecked register reads as not cleared.
|
|
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`.
|
|
89
102
|
|
|
90
103
|
### Step 5: Hand the choice over
|
|
91
104
|
|
|
92
105
|
The brand-identity interview offers options computed by `deriveOfferableBrandNameOptions`:
|
|
93
106
|
|
|
94
107
|
- a clear name, as itself;
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
|
|
98
|
-
|
|
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.
|
|
99
117
|
To screen another name of their own, they add it to `top_down.brand-naming`'s interview
|
|
100
118
|
(`names-to-screen`) and re-run it. Stop there: choosing is not this skill's job.
|
|
101
119
|
|
|
@@ -113,6 +131,8 @@ To screen another name of their own, they add it to `top_down.brand-naming`'s in
|
|
|
113
131
|
- [ ] Classes 9 and 42 are searched.
|
|
114
132
|
- [ ] Every query has a `sourceUrl` and a `checkedOn` date.
|
|
115
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.
|
|
116
136
|
- [ ] No proposal collides with a market competitor or alternative.
|
|
117
137
|
- [ ] Nothing says "available", "free to use" or "cleared".
|
|
118
138
|
|
|
@@ -146,6 +166,10 @@ wildo context coherence
|
|
|
146
166
|
- The word "available" or "cleared" in the brand or screening. Catch it with the first grep above.
|
|
147
167
|
- No `EU` jurisdiction while an EU country is targeted. Catch it with the validator's
|
|
148
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.
|
|
149
173
|
|
|
150
174
|
## Related Skills
|
|
151
175
|
|
package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md
CHANGED
|
@@ -112,6 +112,40 @@ export enum BrandNameDomainStatus {
|
|
|
112
112
|
UNKNOWN = 'UNKNOWN',
|
|
113
113
|
}
|
|
114
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
|
+
|
|
115
149
|
/** A candidate's derived trademark standing — see {@link deriveBrandNameTrademarkOutcome}. */
|
|
116
150
|
export enum BrandNameTrademarkOutcome {
|
|
117
151
|
CLEAR = 'CLEAR',
|
|
@@ -195,6 +229,12 @@ export const BrandNameTrademarkQuerySchema = z.object({
|
|
|
195
229
|
niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
|
|
196
230
|
matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
|
|
197
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(),
|
|
198
238
|
/** Every live mark found. Present exactly when the outcome is CONFLICT. */
|
|
199
239
|
conflictingMarks: z.array(BrandNameConflictingMarkSchema).default([]),
|
|
200
240
|
/** The search or results page that was read — what a reader opens to check this row. */
|
|
@@ -214,19 +254,34 @@ export const BrandNameDomainSignalSchema = z.object({
|
|
|
214
254
|
});
|
|
215
255
|
export type BrandNameDomainSignal = z.infer<typeof BrandNameDomainSignalSchema>;
|
|
216
256
|
|
|
217
|
-
/**
|
|
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
|
+
*/
|
|
218
263
|
export const BrandNameSameCategoryUseSchema = z.object({
|
|
219
264
|
name: NonEmptyStringSchema,
|
|
220
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(),
|
|
221
272
|
note: NonEmptyStringSchema.optional(),
|
|
222
273
|
});
|
|
223
274
|
export type BrandNameSameCategoryUse = z.infer<typeof BrandNameSameCategoryUseSchema>;
|
|
224
275
|
|
|
225
|
-
/**
|
|
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
|
+
*/
|
|
226
281
|
export const BrandNameCompetitorCollisionSchema = z.object({
|
|
227
282
|
/** The market snapshot's alternative ref, when the collision is with one of its alternatives. */
|
|
228
283
|
alternativeRef: NonEmptyStringSchema.optional(),
|
|
229
|
-
/** The competitor's name as the market snapshot names it. */
|
|
284
|
+
/** The competitor's name — as the market snapshot names it, or as the product trades when the research found it. */
|
|
230
285
|
competitorName: NonEmptyStringSchema,
|
|
231
286
|
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
232
287
|
});
|
|
@@ -287,10 +342,19 @@ export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
|
|
|
287
342
|
* | candidate | offered as |
|
|
288
343
|
* |---|---|
|
|
289
344
|
* | CLEAR, no competitor collision | `Batisio` |
|
|
290
|
-
* | UNKNOWN
|
|
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]` |
|
|
291
347
|
* | CONFLICT or competitor collision, **creator-supplied** | `Keystone [keep-despite-conflict]` |
|
|
292
348
|
* | CONFLICT or competitor collision, **companion-proposed** | not offered |
|
|
293
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
|
+
*
|
|
294
358
|
* So choosing a conflicting name is an EXPLICIT act — the option the creator picks says "keep despite
|
|
295
359
|
* conflict" — and the creator's answer in the dossier is the durable record of it. A companion-proposed
|
|
296
360
|
* name that conflicts is never offered at all: the companion must not put a conflicting name in front of
|
|
@@ -298,8 +362,10 @@ export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
|
|
|
298
362
|
* `top_down.brand-naming`, never from the origin the screening records — a model wrote that field.
|
|
299
363
|
*/
|
|
300
364
|
export enum BrandNameChoiceQualifier {
|
|
301
|
-
/**
|
|
365
|
+
/** Some registers returned a result, but not every register, class or jurisdiction was read: the name is NOT cleared. */
|
|
302
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',
|
|
303
369
|
/** The creator keeps their own name although a live mark or a named competitor conflicts with it. */
|
|
304
370
|
KEEP_DESPITE_CONFLICT = 'keep-despite-conflict',
|
|
305
371
|
}
|
|
@@ -369,11 +435,17 @@ export function effectiveBrandNameCandidateOrigin(candidate: Pick<BrandNameCandi
|
|
|
369
435
|
: BrandNameCandidateOrigin.COMPANION_PROPOSED;
|
|
370
436
|
}
|
|
371
437
|
|
|
372
|
-
/** One offerable option, with the candidate it stands for. */
|
|
438
|
+
/** One offerable option, with the candidate it stands for and what the creator is shown beside it. */
|
|
373
439
|
export interface OfferableBrandNameOption {
|
|
374
440
|
readonly option: string;
|
|
375
441
|
readonly candidateRef: string;
|
|
376
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;
|
|
377
449
|
}
|
|
378
450
|
|
|
379
451
|
/** The option string for a name and an optional qualifier. */
|
|
@@ -13,8 +13,17 @@ whether a name may be used.
|
|
|
13
13
|
| WIPO Global Brand Database — https://branddb.wipo.int/ | International (Madrid) registrations and many national collections | `WO`, plus each national collection searched |
|
|
14
14
|
| A national office (USPTO, UKIPO, DPMA, INPI, …) | That country only | the country's ISO code — never `EU` or `WO` |
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
16
|
+
## How a register is reached
|
|
17
|
+
|
|
18
|
+
| Access path | What it is | Today |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `MACHINE_INTERFACE` | the register's published search API, returning structured records | EUIPO publishes a Trademark Search API behind OAuth credentials from a registered developer account; usable only when the application's providers give access. TMview and the WIPO Global Brand Database publish none. A national office may: check its own documentation |
|
|
21
|
+
| `WEB_PAGE` | the register's web page, fetched as a document | most registers render results in the browser, sit behind a CAPTCHA or refuse a fetch, so this usually reads nothing |
|
|
22
|
+
|
|
23
|
+
Record the access path of every query. Try each register once: when it returns nothing readable,
|
|
24
|
+
the query is **`UNKNOWN` with a note saying why**, and the screening turns it into a check a person
|
|
25
|
+
can run (`deriveBrandNameManualChecks`; TMview links are pre-filled with the name, the classes and
|
|
26
|
+
the live statuses). Never write that link yourself.
|
|
18
27
|
|
|
19
28
|
## Jurisdictions
|
|
20
29
|
|
|
@@ -22,9 +31,13 @@ Derived, never assumed:
|
|
|
22
31
|
|
|
23
32
|
1. the market snapshot's ICP geographies (resolve `EMEA`, `NAM`, … to the countries they mean
|
|
24
33
|
for this product);
|
|
25
|
-
2. the
|
|
26
|
-
|
|
27
|
-
|
|
34
|
+
2. the jurisdictions the application declares in `wildo.saas.config.ts` (`operatingJurisdictions`; a slug's
|
|
35
|
+
region code is the country, `eu` the European Union);
|
|
36
|
+
3. the vision's compliance detail, and the countries the creator names as where the users are
|
|
37
|
+
(`target-jurisdictions`, shared with the compliance interview) — each one a target, each reached by
|
|
38
|
+
its national office (IT → UIBM, ES → OEPM, DE → DPMA, FR → INPI, …) or by a TMview search listing it;
|
|
39
|
+
4. `EU` whenever any EU member state is targeted;
|
|
40
|
+
5. `WO`, always: an international registration can designate any targeted country.
|
|
28
41
|
|
|
29
42
|
A candidate is covered in a jurisdiction only by a `CLEAR` query that searched **every declared
|
|
30
43
|
class with both match types**. Anything less leaves it uncovered, and the candidate not cleared.
|
|
@@ -51,9 +64,18 @@ Record each with a one-line reason.
|
|
|
51
64
|
## Signals beside the registers (recorded, never blocking)
|
|
52
65
|
|
|
53
66
|
- Exact-match `.com` and the main ccTLDs of the target countries: `REGISTERED`, `AVAILABLE` or `UNKNOWN`.
|
|
54
|
-
- Companies or products already trading under the name
|
|
55
|
-
|
|
56
|
-
|
|
67
|
+
- Companies or products already trading under the name, with their URL and their `categoryRelation`:
|
|
68
|
+
`SAME_JOB` (the same work for the same kind of customer, or the same Nice class), `ADJACENT`, or
|
|
69
|
+
`UNRELATED`.
|
|
70
|
+
- **Competitor collisions**: a name identical or close to a competitor or alternative the market
|
|
71
|
+
snapshot names, OR to a `SAME_JOB` product the evidence found. A collision makes a proposal
|
|
72
|
+
unofferable, like a conflict does; a creator's own colliding name is offered as keep-despite-conflict.
|
|
73
|
+
|
|
74
|
+
## Coverage
|
|
75
|
+
|
|
76
|
+
Beside a candidate's standing, `deriveBrandNameScreeningCoverage` says how much was READ: `FULL`,
|
|
77
|
+
`PARTIAL`, or `NONE` when no register returned anything. A name with coverage `NONE` is offered as
|
|
78
|
+
`[not-screened]`; a screening where every candidate is `NONE` is judged as having screened nothing.
|
|
57
79
|
|
|
58
80
|
## How a result is worded
|
|
59
81
|
|
|
@@ -143,7 +143,8 @@ cannot say what an erasure does to them. Where the facts also report a category
|
|
|
143
143
|
origin, say what IS established alongside it.
|
|
144
144
|
`NEEDS_CONFIGURATION` for every resource that does not.
|
|
145
145
|
|
|
146
|
-
**What closes it** — the application's own authors declaring `retentionPolicy
|
|
146
|
+
**What closes it** — the application's own authors declaring `retentionPolicy`, with the `dataSubjectPolicy` the
|
|
147
|
+
factory requires beside it, on the resource. Name
|
|
147
148
|
the resources individually: the remedy is per-resource, and a count is not actionable.
|
|
148
149
|
|
|
149
150
|
|
|
@@ -49,6 +49,8 @@ them.
|
|
|
49
49
|
`searchResources`)
|
|
50
50
|
- Adding a global command palette entry, hotkey, or quick action
|
|
51
51
|
- Changing sidebar organization (sections, ordering, behavior)
|
|
52
|
+
- Authoring the sidebar, command palette or user menu from the accepted placement plan (a `SHELL_PLACEMENT` build
|
|
53
|
+
task; Step 2b)
|
|
52
54
|
- Updating menubar `hostedComponents` placement
|
|
53
55
|
- Declaring a **scope switcher** (`quickSwitcherFields`) — which resource scopes the
|
|
54
56
|
app, and how its control + dropdown present
|
|
@@ -78,6 +80,22 @@ no implicit defaults. Set a key to `false` to **explicitly disable**
|
|
|
78
80
|
the surface; omit a key only if the framework documents an implicit
|
|
79
81
|
fallback (rare).
|
|
80
82
|
|
|
83
|
+
### Step 2b: From a placement plan (a sidebar, command-palette or user-menu task)
|
|
84
|
+
|
|
85
|
+
The task's brief carries the plan for its surface: `groupsOnThisSurface` (the sidebar sections, each with a `purpose`
|
|
86
|
+
and an `order`), `placedOnThisSurface` (each entry with its `shellIdentity`, its address and, when restricted, its
|
|
87
|
+
`visibleToRoles`), and `declinedEverywhere`.
|
|
88
|
+
|
|
89
|
+
- One sidebar section per group (`ref` = its `groupRef`), ordered by `order`, with each placed entry as a child in its
|
|
90
|
+
own `order`. Its title comes from the labelling pipeline; the `purpose` is what that label is written from.
|
|
91
|
+
- An entry or group with `visibleToRoles` gets `runtimeAvailability: { visibleToRoles: [...] }`, with exactly those
|
|
92
|
+
roles, on that layer only: a group's on its section, an entry's on the entry. Never merge the two lists into one;
|
|
93
|
+
a viewer must pass both, and core roles count through inheritance (an admin passes a members' section).
|
|
94
|
+
- A user-menu task lists the placed settings destinations in `USER_DROPDOWN.settingsEntries`; it has no audience.
|
|
95
|
+
- Nothing declined may remain on any surface.
|
|
96
|
+
- The task lands when `wildo context info app-shell-placement-content` lists every placed identity on the surface,
|
|
97
|
+
shown to the audience the plan decided, and none of the declined ones. Run it before finishing.
|
|
98
|
+
|
|
81
99
|
### Step 3: Command menu — static commands and/or omnibox search
|
|
82
100
|
|
|
83
101
|
If the change touches the Cmd+K palette, decide the palette **policy** on
|
|
@@ -422,6 +440,21 @@ What earns its place:
|
|
|
422
440
|
the user's starred items (a hover star on every sidebar row; persisted
|
|
423
441
|
per machine) and hides the section entirely while it is empty. Declaring
|
|
424
442
|
the section is what enables the star affordance.
|
|
443
|
+
- A section or an entry for one audience only carries
|
|
444
|
+
`runtimeAvailability: { visibleToRoles: [...] }`. It is shown to viewers
|
|
445
|
+
holding a listed role, at the application or in the current organization,
|
|
446
|
+
or a core role that inherits one. A custom role counts only as itself, so
|
|
447
|
+
list every role that should see it. The placement plan's `visibleToRoles`
|
|
448
|
+
on a sidebar group or decision becomes exactly this field. It hides; it
|
|
449
|
+
does not protect. An entry for an operation the viewer cannot perform
|
|
450
|
+
(its `roles`) is hidden already, so use this field only to narrow
|
|
451
|
+
further. See `references/framework-launcher-visibility-api.md`.
|
|
452
|
+
- Every entry's target is a `LauncherItemRef` discriminated on `kind`. A domain
|
|
453
|
+
module's sidebar section replaces, whole, a same-`ref` section in
|
|
454
|
+
`app-shell.config.ts`; to add rows to a section, use the module's
|
|
455
|
+
`sidebarSectionItems` instead. Commands merge by target. Read `references/framework-launcher-items-api.md`
|
|
456
|
+
for the exact fields per `kind` and the merge rules, before reading anything
|
|
457
|
+
compiled.
|
|
425
458
|
- `COMMAND_MENU.policy: CommandBarPolicy.OMNIBOX` — the **command palette
|
|
426
459
|
policy**. Here it is `OMNIBOX`, so `searchResources` also declares which
|
|
427
460
|
resources feed live record search (see the dedicated omnibox worked example
|
|
@@ -693,6 +726,8 @@ What earns its place:
|
|
|
693
726
|
- `references/app-shell-surfaces.md` — author-facing surface list
|
|
694
727
|
- `references/framework-app-shell-api.md` — engine app-level component vocabulary + configuration schema
|
|
695
728
|
- `references/framework-command-menu-omnibox-api.md` — command-menu policy (`CommandBarPolicy`) + omnibox `searchResources` (`CommandMenuSearchResource`) contract
|
|
729
|
+
- `references/framework-launcher-items-api.md` — `LauncherItemRef` (what an entry targets, per `kind`) and the merge rules: a module's sidebar section replaces a same-`ref` one whole, `sidebarSectionItems` adds rows, commands merge by target
|
|
730
|
+
- `references/framework-launcher-visibility-api.md` — `runtimeAvailability`: `requiredCapabilities` and `visibleToRoles`, which decide whether a launcher entry appears at all
|
|
696
731
|
- `references/framework-app-shell-hosted-components-api.md` — menubar/sidebar `hostedComponents` entry shape (`MenubarHostedComponent` / `SidebarHostedComponent`) + per-placement `triggerWidth`
|
|
697
732
|
- `references/framework-quick-switcher-scope-field-api.md` — `quickSwitcherFields` entry shape (`QuickSwitcherScopeField`), the two independent presentation axes (`optionDisplayMode` / `presentation`), and what a scope declaration wires for free
|
|
698
733
|
- `references/framework-public-shell-identity-api.md` — naming the application on its public/auth cards: where the field goes, and what actually renders for each brand state
|
|
@@ -704,6 +739,7 @@ What earns its place:
|
|
|
704
739
|
- [ ] Shell renders without runtime errors
|
|
705
740
|
- [ ] New `hostedComponents` entries route to valid component types
|
|
706
741
|
- [ ] Each `SidebarSection.ref` is unique and stable (used by spec)
|
|
742
|
+
- [ ] Every `visibleToRoles` the placement plan declares is on the matching section or entry, and names roles the application defines
|
|
707
743
|
- [ ] `EnginePageRef.*` references resolve at typecheck time
|
|
708
744
|
- [ ] `openShortcut` strings do not collide with existing hotkeys
|
|
709
745
|
- [ ] No surface key omitted (every `ApplicationLevelComponentType.*` declared)
|
|
@@ -721,20 +757,37 @@ Run from the app root:
|
|
|
721
757
|
|
|
722
758
|
| Invariant | Command |
|
|
723
759
|
|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|
|
724
|
-
| Every key uses the typed enum |
|
|
760
|
+
| Every key uses the typed enum | see the commands below the table |
|
|
725
761
|
| No string-literal placement / breakpoint | `rg -n "placement:\s+'[a-z]" frontend/src/config/app-shell.config.ts` (must return empty) |
|
|
726
762
|
| Each `EnginePageRef` reference is typed | `rg -n "pageRef:\s+EnginePageRef\." frontend/src/config/app-shell.config.ts` |
|
|
727
|
-
| Sidebar section refs are unique |
|
|
763
|
+
| Sidebar section refs are unique | see the commands below the table (must return empty) |
|
|
728
764
|
| Command menu has an `openShortcut` | `rg -n "openShortcut:" frontend/src/config/app-shell.config.ts` |
|
|
729
|
-
| Every `commands: []` entry resolves to a registered `commandId` |
|
|
765
|
+
| Every `commands: []` entry resolves to a registered `commandId` | run the commands below the table, then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
|
|
730
766
|
| `publicShellIdentityMode` is NOT in the shell config | `rg -n "publicShellIdentityMode" frontend/src/config/app-shell.config.ts` (must return empty; it belongs in `frontend/src/modules-registry.frontend.ts`) |
|
|
731
767
|
| `searchResources` implies `policy: OMNIBOX` | `rg -n "searchResources:" frontend/src/config/app-shell.config.ts` — if it matches, `rg -n "CommandBarPolicy.OMNIBOX" frontend/src/config/app-shell.config.ts` must also match |
|
|
732
768
|
| Module command items are typed launcher refs | `rg -n "kind:\s+LauncherItemTargetKind\." frontend/src/modules/*/app-shell.module.frontend.ts` (each `commandMenuItems` entry must be a typed `LauncherItemTargetKind`, never a string) |
|
|
733
|
-
| Hosted-component placement uses the typed enum |
|
|
769
|
+
| Hosted-component placement uses the typed enum | see the commands below the table (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
|
|
734
770
|
| Hosted `triggerWidth` is a number or a literal CSS width | `rg -n "triggerWidth:" frontend/src/config/app-shell.config.ts` (each value is a px number like `240` or a CSS width string like `'100%'`/`'16rem'` — never a bare Tailwind class) |
|
|
735
771
|
| Scope-field resource types are typed | `rg -n "resourceType:\s+'" frontend/src/modules/*/app-shell.module.frontend.ts` (must return empty — every `quickSwitcherFields` entry names a typed `*_ResourceType.*` member) |
|
|
736
772
|
| A declared scope field is actually hosted | `rg -qn "quickSwitcherFields" frontend/src/modules/*/app-shell.module.frontend.ts && rg -n "ApplicationLevelComponentType.QUICK_SWITCHER" frontend/src/config/app-shell.config.ts` (if the first matches, the second must too) |
|
|
737
|
-
| Presentation axes use their typed enums |
|
|
773
|
+
| Presentation axes use their typed enums | see the commands below the table (each value is `ForeignKeyDisplayMode.*` / `QuickSwitcherFieldPresentation.*`, never a quoted string) |
|
|
774
|
+
|
|
775
|
+
```bash
|
|
776
|
+
# Every key uses the typed enum
|
|
777
|
+
rg -oN "\[ApplicationLevelComponentType\.[A-Z_]+\]" frontend/src/config/app-shell.config.ts | sort -u
|
|
778
|
+
|
|
779
|
+
# Sidebar section refs are unique
|
|
780
|
+
rg -P -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts | sort | uniq -d
|
|
781
|
+
|
|
782
|
+
# Every `commands: []` entry resolves to a registered `commandId`
|
|
783
|
+
rg -P -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts | sort -u
|
|
784
|
+
|
|
785
|
+
# Hosted-component placement uses the typed enum
|
|
786
|
+
rg -n "placement:\s+(Horizontal|Vertical)Placement\." frontend/src/config/app-shell.config.ts
|
|
787
|
+
|
|
788
|
+
# Presentation axes use their typed enums
|
|
789
|
+
rg -n "optionDisplayMode:|presentation:" frontend/src/modules/*/app-shell.module.frontend.ts
|
|
790
|
+
```
|
|
738
791
|
|
|
739
792
|
The fourth invariant (unique `ref:`) is the high-signal one — duplicate
|
|
740
793
|
section refs collapse silently in the rendered sidebar and break any
|