@wildo-ai/framework-knowledge 1.1.8 → 1.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +9 -2
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +95 -5
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +41 -3
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +175 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -2
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +90 -13
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +8 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +91 -43
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +27 -18
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +11 -11
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +3 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +71 -2
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +9 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +3 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +41 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +22 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
- package/dist/knowledge/references/brand.name-choice.config.md +144 -0
- package/dist/knowledge/references/brand.name-screening.config.md +308 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
- package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
- package/dist/knowledge/references/capability-composition.config.md +67 -4
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
- package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +374 -1
- package/dist/knowledge/registries/playbooks.json +76 -28
- package/dist/knowledge/registries/source-tags.json +1513 -898
- package/dist/knowledge/rules/live-context-door.md +5 -2
- package/dist/knowledge/skills/INDEX.md +5 -2
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1590 -292
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
# brand.name-screening.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The **brand-name screening** — the candidate names the companion PROPOSED (and any the creator asked
|
|
14
|
+
* to have screened), each checked against the public trademark registers of the jurisdictions the
|
|
15
|
+
* application targets. Artifact family `brand-name-screening`, produced by the `top_down.brand-naming`
|
|
16
|
+
* step; the `top_down.brand-identity` interview offers the creator a CHOICE computed from it.
|
|
17
|
+
*
|
|
18
|
+
* ## What this is, and what it is not
|
|
19
|
+
*
|
|
20
|
+
* A **minimal trademark screening — not a legal clearance opinion.** It records which registers were
|
|
21
|
+
* searched, for which classes, with which match types, on which day, and what each returned, so a
|
|
22
|
+
* reader can see exactly how far the check went. It never says a name is "available" or "cleared":
|
|
23
|
+
* consult an IP professional before filing or launching under any name recorded here.
|
|
24
|
+
*
|
|
25
|
+
* ## Why it exists
|
|
26
|
+
*
|
|
27
|
+
* On a first real run the brand name was a required pre-run free-text question. The creator expected
|
|
28
|
+
* proposals, a coding assistant improvised four names in chat with no check at all, and one of them was
|
|
29
|
+
* almost certainly a registered software mark. The name is printed on every surface and rendered into
|
|
30
|
+
* the logo, so the cheapest moment to catch a conflict is before anyone chooses.
|
|
31
|
+
*
|
|
32
|
+
* ## The outcome is DERIVED, never authored
|
|
33
|
+
*
|
|
34
|
+
* There is no `outcome` field on a candidate. {@link deriveBrandNameTrademarkOutcome} computes it from
|
|
35
|
+
* the register queries — a conflict on any query is a CONFLICT; a jurisdiction, class or match type no
|
|
36
|
+
* clear query covered, or any query that could not be completed, is UNKNOWN; only full coverage with
|
|
37
|
+
* every query clear is CLEAR. So a model cannot label a half-checked name clear: an unchecked register
|
|
38
|
+
* is simply an uncovered jurisdiction, and the derivation reads it as UNKNOWN.
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
/** The payload-format version of a brand-name screening. */
|
|
42
|
+
export enum BrandNameScreeningVersion {
|
|
43
|
+
V1 = 'v1',
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** Who put a candidate on the list. The companion proposes; the creator may ask for their own names to be screened. */
|
|
47
|
+
export enum BrandNameCandidateOrigin {
|
|
48
|
+
/** Proposed by the companion from the vision and the market snapshot. */
|
|
49
|
+
COMPANION_PROPOSED = 'COMPANION_PROPOSED',
|
|
50
|
+
/** A name the creator supplied, screened exactly like a proposed one. */
|
|
51
|
+
CREATOR_SUPPLIED = 'CREATOR_SUPPLIED',
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* The public register a query was run against.
|
|
56
|
+
*
|
|
57
|
+
* `NATIONAL_OFFICE` covers any national IP office (DPMA, INPI, UKIPO, USPTO, …); which country it is
|
|
58
|
+
* lives in the query's `jurisdictionsCovered`, so the vocabulary does not hard-code one market.
|
|
59
|
+
*/
|
|
60
|
+
export enum BrandNameTrademarkRegister {
|
|
61
|
+
/** EUIPO's EU trade mark register (eSearch plus) — EU-wide marks. */
|
|
62
|
+
EUIPO_EUTM = 'EUIPO_EUTM',
|
|
63
|
+
/** TMview — the EUIPO-hosted aggregator over the EU office and participating national offices. */
|
|
64
|
+
TMVIEW = 'TMVIEW',
|
|
65
|
+
/** WIPO Global Brand Database — international (Madrid) registrations and many national collections. */
|
|
66
|
+
WIPO_GLOBAL_BRAND_DATABASE = 'WIPO_GLOBAL_BRAND_DATABASE',
|
|
67
|
+
/** A national IP office's own register. */
|
|
68
|
+
NATIONAL_OFFICE = 'NATIONAL_OFFICE',
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** How close a register hit had to be to count. A screening searches both. */
|
|
72
|
+
export enum BrandNameMatchType {
|
|
73
|
+
/** The same mark, ignoring case and spacing. */
|
|
74
|
+
IDENTICAL = 'IDENTICAL',
|
|
75
|
+
/** Plurals, hyphenation, transposed or substituted letters, and common phonetic variants. */
|
|
76
|
+
NEAR_IDENTICAL = 'NEAR_IDENTICAL',
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** What one register query returned. `UNKNOWN` is a query that could not be completed — never a clear one. */
|
|
80
|
+
export enum BrandNameTrademarkQueryOutcome {
|
|
81
|
+
/** Searched, at full coverage, and no live identical or near-identical mark found. */
|
|
82
|
+
CLEAR = 'CLEAR',
|
|
83
|
+
/** At least one live identical or near-identical mark in a searched class. */
|
|
84
|
+
CONFLICT = 'CONFLICT',
|
|
85
|
+
/** The register was unreachable, the search could not be run, or its result could not be read. */
|
|
86
|
+
UNKNOWN = 'UNKNOWN',
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** The status of a conflicting mark. Only LIVE marks are recorded: an expired or withdrawn mark is not a conflict. */
|
|
90
|
+
export enum BrandNameConflictingMarkStatus {
|
|
91
|
+
REGISTERED = 'REGISTERED',
|
|
92
|
+
/** Filed and not yet registered, including under opposition. */
|
|
93
|
+
PENDING = 'PENDING',
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** What a domain check found. Recorded as a signal beside the registers, never a blocker. */
|
|
97
|
+
export enum BrandNameDomainStatus {
|
|
98
|
+
REGISTERED = 'REGISTERED',
|
|
99
|
+
AVAILABLE = 'AVAILABLE',
|
|
100
|
+
UNKNOWN = 'UNKNOWN',
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* HOW a register was reached for one query (#2333). Recorded per query so a reader can tell a register that
|
|
105
|
+
* answered through its published interface from one whose web page was fetched — the two fail differently.
|
|
106
|
+
*
|
|
107
|
+
* Measured on app-creation-test-005 (2026-10-03): every register reached as a WEB_PAGE returned nothing a
|
|
108
|
+
* fetch could read (client-rendered results, an empty page, a CAPTCHA, an HTTP 403, a form that never ran),
|
|
109
|
+
* so 30 of 30 queries were UNKNOWN. A register's web page is built for a person; its machine interface, where
|
|
110
|
+
* one exists, is what a program can read.
|
|
111
|
+
*/
|
|
112
|
+
export enum BrandNameRegisterAccessPath {
|
|
113
|
+
/** The register's published machine interface (a search API returning structured records). */
|
|
114
|
+
MACHINE_INTERFACE = 'MACHINE_INTERFACE',
|
|
115
|
+
/** The register's web page, fetched as a document. Usually unreadable: most registers render their results in the browser. */
|
|
116
|
+
WEB_PAGE = 'WEB_PAGE',
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* How a product already trading under a candidate's name relates to THIS product's category (#2336).
|
|
121
|
+
*
|
|
122
|
+
* Typed rather than left in a free-text note so the collision check can DECIDE it: a same-job product with
|
|
123
|
+
* the same name is a competitor collision whether or not the market snapshot happened to list it. Measured on
|
|
124
|
+
* app-creation-test-005: "Groundwork — Estimating & Job Suite" (the same customer → quote → job → invoice flow
|
|
125
|
+
* for tradespeople) was recorded only as a same-category use, so the creator's "Groundwork" was never offered
|
|
126
|
+
* as a conflicting name, and a companion proposal colliding with a French building-software product was offered.
|
|
127
|
+
*/
|
|
128
|
+
export enum BrandNameCategoryRelation {
|
|
129
|
+
/** The same job for the same kind of customer, or the same Nice class of goods and services: a collision when the names match. */
|
|
130
|
+
SAME_JOB = 'SAME_JOB',
|
|
131
|
+
/** A neighbouring category (building software for another audience, CRM for another trade): recorded, never a collision on its own. */
|
|
132
|
+
ADJACENT = 'ADJACENT',
|
|
133
|
+
/** Unrelated trade (a sports-team payments tool for a builders' CRM): recorded for completeness. */
|
|
134
|
+
UNRELATED = 'UNRELATED',
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** A candidate's derived trademark standing — see {@link deriveBrandNameTrademarkOutcome}. */
|
|
138
|
+
export enum BrandNameTrademarkOutcome {
|
|
139
|
+
CLEAR = 'CLEAR',
|
|
140
|
+
CONFLICT = 'CONFLICT',
|
|
141
|
+
UNKNOWN = 'UNKNOWN',
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** The pseudo-jurisdiction an EU trade mark covers. */
|
|
145
|
+
export const EU_TRADE_MARK_JURISDICTION = 'EU';
|
|
146
|
+
/** The pseudo-jurisdiction an international (Madrid, via WIPO) registration covers. */
|
|
147
|
+
export const INTERNATIONAL_REGISTRATION_JURISDICTION = 'WO';
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* The EU member states (ISO 3166-1 alpha-2) — a target in any of them makes an EU trade mark relevant,
|
|
151
|
+
* because an EUTM has effect in every member state.
|
|
152
|
+
*/
|
|
153
|
+
export const EU_MEMBER_STATE_CODES: readonly string[] = [
|
|
154
|
+
'AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE',
|
|
155
|
+
'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE',
|
|
156
|
+
];
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* A jurisdiction code: an ISO 3166-1 alpha-2 country, `EU` (an EU trade mark) or `WO` (an international
|
|
160
|
+
* registration). Stated as a description too, because a JSON schema shown to a generating model drops
|
|
161
|
+
* the refinement.
|
|
162
|
+
*/
|
|
163
|
+
export const BrandNameJurisdictionCodeSchema = z
|
|
164
|
+
.string()
|
|
165
|
+
.trim()
|
|
166
|
+
.regex(/^[A-Z]{2}$/)
|
|
167
|
+
.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.');
|
|
168
|
+
|
|
169
|
+
/** The first Nice class number. */
|
|
170
|
+
export const NICE_CLASS_MIN = 1;
|
|
171
|
+
/** The last Nice class number (the Nice Classification has 45 classes: 1–34 goods, 35–45 services). */
|
|
172
|
+
export const NICE_CLASS_MAX = 45;
|
|
173
|
+
|
|
174
|
+
/** The Nice classes every software product lives in: 9 (downloadable software) and 42 (SaaS). */
|
|
175
|
+
export const SOFTWARE_NICE_CLASSES: readonly number[] = [9, 42];
|
|
176
|
+
|
|
177
|
+
const NiceClassNumberSchema = z.number().int().min(NICE_CLASS_MIN).max(NICE_CLASS_MAX);
|
|
178
|
+
/** An ISO calendar date (`YYYY-MM-DD`): the day a check was made. */
|
|
179
|
+
const IsoDateSchema = z.iso.date();
|
|
180
|
+
|
|
181
|
+
/** One jurisdiction the screening covers, and where that target came from. */
|
|
182
|
+
export const BrandNameScreeningJurisdictionSchema = z.object({
|
|
183
|
+
code: BrandNameJurisdictionCodeSchema,
|
|
184
|
+
/** What declared this target — an ICP geography, a vision compliance detail, the application's configured jurisdictions. */
|
|
185
|
+
derivedFrom: NonEmptyStringSchema,
|
|
186
|
+
});
|
|
187
|
+
export type BrandNameScreeningJurisdiction = z.infer<typeof BrandNameScreeningJurisdictionSchema>;
|
|
188
|
+
|
|
189
|
+
/** One Nice class searched, and why this product lives in it. */
|
|
190
|
+
export const BrandNameScreeningNiceClassSchema = z.object({
|
|
191
|
+
classNumber: NiceClassNumberSchema,
|
|
192
|
+
rationale: NonEmptyStringSchema,
|
|
193
|
+
});
|
|
194
|
+
export type BrandNameScreeningNiceClass = z.infer<typeof BrandNameScreeningNiceClassSchema>;
|
|
195
|
+
|
|
196
|
+
/** A live mark a query found, with the record it was read from. */
|
|
197
|
+
export const BrandNameConflictingMarkSchema = z.object({
|
|
198
|
+
/** The mark as registered. */
|
|
199
|
+
mark: NonEmptyStringSchema,
|
|
200
|
+
owner: NonEmptyStringSchema.optional(),
|
|
201
|
+
/** The application or registration number on the register. */
|
|
202
|
+
registrationNumber: NonEmptyStringSchema.optional(),
|
|
203
|
+
/** The Nice classes the mark is registered or filed in. */
|
|
204
|
+
niceClasses: z.array(NiceClassNumberSchema).min(1),
|
|
205
|
+
status: z.enum(BrandNameConflictingMarkStatus).systemEnum('BrandNameConflictingMarkStatus'),
|
|
206
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
207
|
+
/** The register record that was read. */
|
|
208
|
+
sourceUrl: z.url(),
|
|
209
|
+
});
|
|
210
|
+
export type BrandNameConflictingMark = z.infer<typeof BrandNameConflictingMarkSchema>;
|
|
211
|
+
|
|
212
|
+
/** One search of one register for one candidate. */
|
|
213
|
+
export const BrandNameTrademarkQuerySchema = z.object({
|
|
214
|
+
register: z.enum(BrandNameTrademarkRegister).systemEnum('BrandNameTrademarkRegister'),
|
|
215
|
+
/** The jurisdictions this search covers (`EU` for an EUTM search, `WO` for international registrations, country codes otherwise). */
|
|
216
|
+
jurisdictionsCovered: z.array(BrandNameJurisdictionCodeSchema).min(1),
|
|
217
|
+
niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
|
|
218
|
+
matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
|
|
219
|
+
outcome: z.enum(BrandNameTrademarkQueryOutcome).systemEnum('BrandNameTrademarkQueryOutcome'),
|
|
220
|
+
/**
|
|
221
|
+
* How the register was reached (#2333). Optional in the STORED record only because screenings landed before
|
|
222
|
+
* the field existed carry none; read it through {@link resolveBrandNameQueryAccessPath}, never directly. A
|
|
223
|
+
* producer must always state it — the generation schema requires it.
|
|
224
|
+
*/
|
|
225
|
+
accessPath: z.enum(BrandNameRegisterAccessPath).systemEnum('BrandNameRegisterAccessPath').optional(),
|
|
226
|
+
/** Every live mark found. Present exactly when the outcome is CONFLICT. */
|
|
227
|
+
conflictingMarks: z.array(BrandNameConflictingMarkSchema).default([]),
|
|
228
|
+
/** The search or results page that was read — what a reader opens to check this row. */
|
|
229
|
+
sourceUrl: z.url(),
|
|
230
|
+
checkedOn: IsoDateSchema,
|
|
231
|
+
/** Why an UNKNOWN query is unknown, or anything a reader needs to interpret the result. */
|
|
232
|
+
note: NonEmptyStringSchema.optional(),
|
|
233
|
+
});
|
|
234
|
+
export type BrandNameTrademarkQuery = z.infer<typeof BrandNameTrademarkQuerySchema>;
|
|
235
|
+
|
|
236
|
+
/** A domain checked for a candidate — exact match on `.com` and the main ccTLDs of the target countries. */
|
|
237
|
+
export const BrandNameDomainSignalSchema = z.object({
|
|
238
|
+
domain: NonEmptyStringSchema,
|
|
239
|
+
status: z.enum(BrandNameDomainStatus).systemEnum('BrandNameDomainStatus'),
|
|
240
|
+
checkedOn: IsoDateSchema,
|
|
241
|
+
sourceUrl: z.url().optional(),
|
|
242
|
+
});
|
|
243
|
+
export type BrandNameDomainSignal = z.infer<typeof BrandNameDomainSignalSchema>;
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* A company or product already trading under (or close to) the name. Despite the field's name, not every
|
|
247
|
+
* entry is in THIS product's category — `categoryRelation` says how close it is, and a SAME_JOB use whose
|
|
248
|
+
* name matches the candidate is a competitor collision ({@link brandNameCandidateCollisions} in the choice
|
|
249
|
+
* module decides it, so a producer that files it here rather than in `competitorCollisions` is still caught).
|
|
250
|
+
*/
|
|
251
|
+
export const BrandNameSameCategoryUseSchema = z.object({
|
|
252
|
+
name: NonEmptyStringSchema,
|
|
253
|
+
sourceUrl: z.url(),
|
|
254
|
+
/**
|
|
255
|
+
* How the use relates to this product's category (#2336). Optional in the STORED record only because
|
|
256
|
+
* screenings landed before the field existed carry none — such a use decides no collision, because nothing
|
|
257
|
+
* says it is the same job. The generation schema requires it.
|
|
258
|
+
*/
|
|
259
|
+
categoryRelation: z.enum(BrandNameCategoryRelation).systemEnum('BrandNameCategoryRelation').optional(),
|
|
260
|
+
note: NonEmptyStringSchema.optional(),
|
|
261
|
+
});
|
|
262
|
+
export type BrandNameSameCategoryUse = z.infer<typeof BrandNameSameCategoryUseSchema>;
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* A product the candidate is identical or confusingly close to: a competitor or alternative the market snapshot
|
|
266
|
+
* names, or a product the research found doing the SAME job under the name (#2336) — which the market snapshot
|
|
267
|
+
* may never have listed.
|
|
268
|
+
*/
|
|
269
|
+
export const BrandNameCompetitorCollisionSchema = z.object({
|
|
270
|
+
/** The market snapshot's alternative ref, when the collision is with one of its alternatives. */
|
|
271
|
+
alternativeRef: NonEmptyStringSchema.optional(),
|
|
272
|
+
/** The competitor's name — as the market snapshot names it, or as the product trades when the research found it. */
|
|
273
|
+
competitorName: NonEmptyStringSchema,
|
|
274
|
+
matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
|
|
275
|
+
});
|
|
276
|
+
export type BrandNameCompetitorCollision = z.infer<typeof BrandNameCompetitorCollisionSchema>;
|
|
277
|
+
|
|
278
|
+
/** One candidate name and everything its screening found. */
|
|
279
|
+
export const BrandNameCandidateSchema = z.object({
|
|
280
|
+
/** Stable ref (`name-<slug>`), stamped by the runtime. */
|
|
281
|
+
ref: z.string().regex(/^name-[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
282
|
+
/** The exact, case-sensitive name. */
|
|
283
|
+
name: NonEmptyStringSchema,
|
|
284
|
+
origin: z.enum(BrandNameCandidateOrigin).systemEnum('BrandNameCandidateOrigin'),
|
|
285
|
+
/** Why this name fits: what in the vision and the market's category language and voice it answers. Empty for a creator-supplied name. */
|
|
286
|
+
rationale: NonEmptyStringSchema.optional(),
|
|
287
|
+
trademarkQueries: z.array(BrandNameTrademarkQuerySchema).default([]),
|
|
288
|
+
competitorCollisions: z.array(BrandNameCompetitorCollisionSchema).default([]),
|
|
289
|
+
domainSignals: z.array(BrandNameDomainSignalSchema).default([]),
|
|
290
|
+
sameCategoryUses: z.array(BrandNameSameCategoryUseSchema).default([]),
|
|
291
|
+
});
|
|
292
|
+
export type BrandNameCandidate = z.infer<typeof BrandNameCandidateSchema>;
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* THE brand-name screening payload — one per application. `jurisdictions` and `niceClasses` are the
|
|
296
|
+
* coverage every candidate is measured against: a candidate whose queries do not reach all of them is
|
|
297
|
+
* UNKNOWN, whatever its queries say.
|
|
298
|
+
*/
|
|
299
|
+
export const BrandNameScreeningSchema = z.object({
|
|
300
|
+
version: z.enum(BrandNameScreeningVersion).default(BrandNameScreeningVersion.V1),
|
|
301
|
+
/** The day the screening was run. */
|
|
302
|
+
screenedOn: IsoDateSchema,
|
|
303
|
+
jurisdictions: z.array(BrandNameScreeningJurisdictionSchema).min(1),
|
|
304
|
+
niceClasses: z.array(BrandNameScreeningNiceClassSchema).min(1),
|
|
305
|
+
candidates: z.array(BrandNameCandidateSchema).min(1),
|
|
306
|
+
});
|
|
307
|
+
export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
|
|
308
|
+
```
|
|
@@ -118,6 +118,17 @@ export enum BuildPlanTaskTargetKind {
|
|
|
118
118
|
* catalogue, so the website re-typed the business model's prices by hand.
|
|
119
119
|
*/
|
|
120
120
|
BILLING_CATALOG = 'BILLING_CATALOG',
|
|
121
|
+
/**
|
|
122
|
+
* The application's own ROLES — `CUSTOM_ROLES_CONFIGURATION` in `shared-lib/src/engine/roles.ts`, the
|
|
123
|
+
* organization types that offer them (`availableOrgRoles` in `wildo.saas.config.ts`), their
|
|
124
|
+
* specifications, and the `roles` of the operations they unlock (#2490).
|
|
125
|
+
*
|
|
126
|
+
* Its own kind because none of the others reaches it: the role table is application-wide and lives in
|
|
127
|
+
* the shared library's ENGINE module. Before it existed a requirement naming user groups ("office and
|
|
128
|
+
* field users see different things") had no task able to declare a role, so app-creation-test-005
|
|
129
|
+
* modelled roles as an access-role RESOURCE that nothing reads.
|
|
130
|
+
*/
|
|
131
|
+
APPLICATION_ROLES = 'APPLICATION_ROLES',
|
|
121
132
|
}
|
|
122
133
|
|
|
123
134
|
/**
|
|
@@ -364,6 +375,16 @@ export enum BuildPlanTaskProductKind {
|
|
|
364
375
|
* money and the pricing-surface facts (recommended, price disclosure, availability) the plan implies.
|
|
365
376
|
*/
|
|
366
377
|
APPLICATION_BILLING_PRODUCT = 'APPLICATION_BILLING_PRODUCT',
|
|
378
|
+
/**
|
|
379
|
+
* One data seed a module declares — rows the application creates for itself, named by the seed's
|
|
380
|
+
* `seedKey` (`crm:demo-customers`).
|
|
381
|
+
*
|
|
382
|
+
* The seed is its own file, `backend-api/src/modules/<module>/seeds/<seedKey with ':' as '.'>.seed.ts`,
|
|
383
|
+
* and it lands only once the module registers it — a seed file nothing imports never runs. Its
|
|
384
|
+
* {@link BuildPlanDataSeedContent} says whether it is REFERENCE data the application needs everywhere
|
|
385
|
+
* or DEMONSTRATION data that must never reach production.
|
|
386
|
+
*/
|
|
387
|
+
APPLICATION_DATA_SEED = 'APPLICATION_DATA_SEED',
|
|
367
388
|
/** One website page, registered in the website root config by its manifest. */
|
|
368
389
|
WEBSITE_PAGE = 'WEBSITE_PAGE',
|
|
369
390
|
/** One section of one website page, declared in that page's sections file. */
|
|
@@ -380,8 +401,43 @@ export enum BuildPlanTaskProductKind {
|
|
|
380
401
|
* registered. Produced once per channel the integration plan declares (`inboundChannels`).
|
|
381
402
|
*/
|
|
382
403
|
INBOUND_CHANNEL_HANDLER = 'INBOUND_CHANNEL_HANDLER',
|
|
404
|
+
/**
|
|
405
|
+
* One role the application declares, named by its role name (`FIELD_TECHNICIAN`), which is its key in
|
|
406
|
+
* `CUSTOM_ROLES_CONFIGURATION`. The NAME, not the file: `wildo init` writes `roles.ts` with an empty
|
|
407
|
+
* table, so the file proves nothing (#2490).
|
|
408
|
+
*/
|
|
409
|
+
APPLICATION_ROLE = 'APPLICATION_ROLE',
|
|
383
410
|
}
|
|
384
411
|
|
|
412
|
+
|
|
413
|
+
/**
|
|
414
|
+
* What a data seed's rows ARE, which decides where they may exist.
|
|
415
|
+
*
|
|
416
|
+
* - `REFERENCE` — rows the application needs to work wherever it runs: a closed list, a default
|
|
417
|
+
* record, a system template. Every environment, production included.
|
|
418
|
+
* - `DEMONSTRATION` — sample rows that make a freshly created application look lived-in (customers,
|
|
419
|
+
* projects, a few records per list). They must never sit beside real rows, so the seed declares
|
|
420
|
+
* `allowedApplicationEnvironments` without `production`, and the task lands only once it does.
|
|
421
|
+
*/
|
|
422
|
+
export enum BuildPlanDataSeedContent {
|
|
423
|
+
REFERENCE = 'REFERENCE',
|
|
424
|
+
DEMONSTRATION = 'DEMONSTRATION',
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
/**
|
|
428
|
+
* A data seed's key: kebab-case segments joined by `:` (`crm:demo-customers`), the convention a
|
|
429
|
+
* `DataSeedDefinition` documents. Constrained here because the seed's FILE is derived from it.
|
|
430
|
+
*/
|
|
431
|
+
/**
|
|
432
|
+
* An application role's name, as `CUSTOM_ROLES_CONFIGURATION` keys it: upper snake case (`FIELD_TECHNICIAN`).
|
|
433
|
+
* A core role (`ORG_MEMBER`, `APP_ADMIN_SUPER_ADMIN`) is not something an application declares, so the
|
|
434
|
+
* product refuses one: a plan naming it would claim to create a role the engine already owns.
|
|
435
|
+
*/
|
|
436
|
+
export const APPLICATION_ROLE_NAME_PATTERN: RegExp = /^[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*$/;
|
|
437
|
+
const CORE_ROLE_NAMES: ReadonlySet<string> = new Set<string>([...Object.values(CORE_APP_ROLES), ...Object.values(CORE_ORG_ROLES)]);
|
|
438
|
+
|
|
439
|
+
export const DATA_SEED_KEY_PATTERN: RegExp = /^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*)*$/;
|
|
440
|
+
|
|
385
441
|
/**
|
|
386
442
|
* One artifact a task is accountable for. Closed by construction: a product the
|
|
387
443
|
* host cannot ask a question about is a product that can never be shown to have
|
|
@@ -451,6 +507,19 @@ export const BuildPlanTaskProductSchema = z.discriminatedUnion('kind', [
|
|
|
451
507
|
scope: z.enum(ProviderBindingScope).systemEnum('ProviderBindingScope'),
|
|
452
508
|
}),
|
|
453
509
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT).systemEnum('BuildPlanTaskProductKind'), productKey: SlugSchema }),
|
|
510
|
+
z.strictObject({
|
|
511
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_ROLE).systemEnum('BuildPlanTaskProductKind'),
|
|
512
|
+
roleRef: z.string().regex(APPLICATION_ROLE_NAME_PATTERN).refine((roleRef) => !CORE_ROLE_NAMES.has(roleRef), {
|
|
513
|
+
message: 'A core role is the engine\'s; an application role needs a name of its own.',
|
|
514
|
+
}),
|
|
515
|
+
}),
|
|
516
|
+
z.strictObject({
|
|
517
|
+
kind: z.literal(BuildPlanTaskProductKind.APPLICATION_DATA_SEED).systemEnum('BuildPlanTaskProductKind'),
|
|
518
|
+
seedKey: z.string().regex(DATA_SEED_KEY_PATTERN),
|
|
519
|
+
/** The resource whose rows the seed writes — the `resourceType` it declares. */
|
|
520
|
+
resourceRef: SlugSchema,
|
|
521
|
+
content: z.enum(BuildPlanDataSeedContent).systemEnum('BuildPlanDataSeedContent'),
|
|
522
|
+
}),
|
|
454
523
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_PAGE).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema }),
|
|
455
524
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_SECTION).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema, sectionRef: SlugSchema }),
|
|
456
525
|
z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER).systemEnum('BuildPlanTaskProductKind'), chapterRef: SlugSchema }),
|
|
@@ -533,6 +602,11 @@ export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): r
|
|
|
533
602
|
return [`${product.kind}:${product.scope}:${product.providerRef}`];
|
|
534
603
|
case BuildPlanTaskProductKind.APPLICATION_BILLING_PRODUCT:
|
|
535
604
|
return [`${product.kind}:${product.productKey}`];
|
|
605
|
+
case BuildPlanTaskProductKind.APPLICATION_ROLE:
|
|
606
|
+
return [`${product.kind}:${product.roleRef}`];
|
|
607
|
+
// The key alone: two seeds may write one resource, and the key is what the seed run ledger tracks.
|
|
608
|
+
case BuildPlanTaskProductKind.APPLICATION_DATA_SEED:
|
|
609
|
+
return [`${product.kind}:${product.seedKey}`];
|
|
536
610
|
case BuildPlanTaskProductKind.WEBSITE_PAGE:
|
|
537
611
|
return [`${product.kind}:${product.pageRef}`];
|
|
538
612
|
case BuildPlanTaskProductKind.WEBSITE_SECTION:
|
|
@@ -556,6 +630,34 @@ export function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): r
|
|
|
556
630
|
*/
|
|
557
631
|
export const BILLING_CATALOG_SKILL_REF = 'configure-billing';
|
|
558
632
|
|
|
633
|
+
/**
|
|
634
|
+
* The skill every application-roles task is authored with (#2490): the role table, the organization
|
|
635
|
+
* types that offer a role, and the operation roles that make it matter. The dispatch derives it from an
|
|
636
|
+
* `APPLICATION_ROLE` product whatever the decomposer wrote.
|
|
637
|
+
*/
|
|
638
|
+
export const APPLICATION_ROLES_SKILL_REF = 'application-roles-authoring';
|
|
639
|
+
|
|
640
|
+
/**
|
|
641
|
+
* The skill every data-seed task is authored with (#2234): levels, modes, business keys, and the
|
|
642
|
+
* environment restriction that keeps demonstration rows out of production. The dispatch derives it from
|
|
643
|
+
* an `APPLICATION_DATA_SEED` product whatever the decomposer wrote.
|
|
644
|
+
*/
|
|
645
|
+
export const DATA_SEED_SKILL_REF = 'seeding-authoring';
|
|
646
|
+
|
|
647
|
+
/**
|
|
648
|
+
* The skill every PDF-template task is authored with (#2495): the template contract, the file field it fills, and
|
|
649
|
+
* where the generated file is stored. The dispatch derives it from a `PDF_TEMPLATE` product whatever the decomposer
|
|
650
|
+
* wrote.
|
|
651
|
+
*/
|
|
652
|
+
export const PDF_TEMPLATE_SKILL_REF = 'pdf-template-authoring';
|
|
653
|
+
|
|
654
|
+
/**
|
|
655
|
+
* The skill a resource CONFIG task carries when the resource DECLARES personal data (#2495): its retention binding
|
|
656
|
+
* lives in that configuration file, and storage limitation is a duty about personal data. The dispatch reads the
|
|
657
|
+
* declaration from the resource's schema (the engine's personal-data markers), whatever the decomposer wrote.
|
|
658
|
+
*/
|
|
659
|
+
export const RESOURCE_RETENTION_SKILL_REF = 'resource-retention-binding';
|
|
660
|
+
|
|
559
661
|
export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
560
662
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef: ModuleRefSchema }),
|
|
561
663
|
z.strictObject({
|
|
@@ -613,6 +715,7 @@ export const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [
|
|
|
613
715
|
}),
|
|
614
716
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.PROVIDER_BINDING), providerRef: SlugSchema }),
|
|
615
717
|
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.BILLING_CATALOG) }),
|
|
718
|
+
z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.APPLICATION_ROLES) }),
|
|
616
719
|
]);
|
|
617
720
|
export type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;
|
|
618
721
|
|
|
@@ -683,15 +786,18 @@ export const BuildPlanTaskSchema = z.strictObject({
|
|
|
683
786
|
/**
|
|
684
787
|
* What this task is accountable to — traceability only, NEVER scope authority.
|
|
685
788
|
*
|
|
686
|
-
* The vocabulary is the
|
|
687
|
-
* and non-functional requirements, roadmap phases,
|
|
688
|
-
* constraints
|
|
689
|
-
*
|
|
690
|
-
*
|
|
789
|
+
* The vocabulary is the target aspects `BUILD_PLAN_FAMILY_ASPECTS` declares for this edge:
|
|
790
|
+
* functional and non-functional requirements, roadmap phases, the vision's success criteria and
|
|
791
|
+
* constraints, drafted features, pricing plans, and the brand's name, logo direction and visual
|
|
792
|
+
* tone. Each target after the first three was added because a producer had already been writing
|
|
793
|
+
* it (#629, #1433, #1835, #2221). A companion generation step serves what it consumes: the `logo`
|
|
794
|
+
* step serves the brand's logo direction and name.
|
|
691
795
|
*
|
|
692
|
-
*
|
|
693
|
-
*
|
|
694
|
-
*
|
|
796
|
+
* This schema accepts any non-empty string. Generation does not: the edge is DECLARED, so a key
|
|
797
|
+
* that resolves to no element of a target family (when that family has landed) is a dangling
|
|
798
|
+
* reference. The model is told so on retry, and the landing refuses it. That is why widening the
|
|
799
|
+
* vocabulary to what producers genuinely mean matters: a true link the vocabulary does not name
|
|
800
|
+
* fails generation. The workbench renders a key outside the vocabulary as visibly unresolved.
|
|
695
801
|
*/
|
|
696
802
|
servesRefs: z.array(NonEmptyStringSchema).default([]),
|
|
697
803
|
/**
|
|
@@ -715,9 +821,11 @@ export type BuildPlanTask = z.infer<typeof BuildPlanTaskSchema>;
|
|
|
715
821
|
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
716
822
|
* 'build-plan'` (the `family` vocabulary stays an open string owned by the
|
|
717
823
|
* selector surface; this note is the single place tying the SHAPE to the
|
|
718
|
-
* NAME). Produced by the build-decompose playbook, consumed
|
|
719
|
-
*
|
|
720
|
-
*
|
|
824
|
+
* NAME). Produced by the build-decompose playbook, consumed by
|
|
825
|
+
* build-dispatch (and build-scale, which runs the same branch): ready tasks
|
|
826
|
+
* are dispatched in parallel waves of up to the application's build
|
|
827
|
+
* parallelism (`wildo workbench parallelism`, 5 by default; 1 = one at a
|
|
828
|
+
* time).
|
|
721
829
|
*
|
|
722
830
|
* Invariants enforced here: unique task refs; every prerequisite names a task
|
|
723
831
|
* in this graph; no self-prerequisite. Cycle detection and ordering
|
|
@@ -40,6 +40,8 @@
|
|
|
40
40
|
* - **`targetSummary`** — who the plan is for, in prose ("mid-market teams
|
|
41
41
|
* of 10-50"). Optional. A human summary, distinct from the typed
|
|
42
42
|
* `targetIcpRefs` cross-reference.
|
|
43
|
+
* - **`proposalBasis`** — on a PROPOSED plan only: what the proposal was
|
|
44
|
+
* derived from (see `PricingTiersStatus` on the snapshot). Optional prose.
|
|
43
45
|
* - **`targetIcpRefs`** / **`includesRequirementRefs`** — OPTIONAL flat
|
|
44
46
|
* cross-references into the market family (ICP segments this plan targets)
|
|
45
47
|
* and the requirements family (functional requirements this plan
|
|
@@ -115,6 +117,20 @@ export const PricingPlanConfigSchema = z.object({
|
|
|
115
117
|
* Flat opaque strings (see `targetIcpRefs`).
|
|
116
118
|
*/
|
|
117
119
|
includesRequirementRefs: z.array(NonEmptyStringSchema).optional(),
|
|
120
|
+
/**
|
|
121
|
+
* WHY this tier exists, present only on a PROPOSED plan — the snapshot's
|
|
122
|
+
* `pricingTiers` is `PricingTiersStatus.PROPOSED`, i.e. the creator asked for
|
|
123
|
+
* the tiers to be proposed rather than naming them. Prose naming what the
|
|
124
|
+
* proposal was derived from: the ICP segment it serves and the requirements
|
|
125
|
+
* that separate it from the tier beside it ("serves icp-indie-maker; holds
|
|
126
|
+
* back the team-planning requirements the Team tier unlocks").
|
|
127
|
+
*
|
|
128
|
+
* Required on every plan of a proposed sketch and forbidden on every plan of
|
|
129
|
+
* a stated one (`validateBusinessModelLiteSnapshot` reports both). A basis on
|
|
130
|
+
* a creator-stated plan would claim a proposal nobody made; a proposal with no
|
|
131
|
+
* basis is a tier nobody can check.
|
|
132
|
+
*/
|
|
133
|
+
proposalBasis: NonEmptyStringSchema.optional(),
|
|
118
134
|
/** Optional per-entity authoring provenance. */
|
|
119
135
|
authored: BusinessModelAuthoredMetadataSchema.optional(),
|
|
120
136
|
});
|
|
@@ -54,6 +54,44 @@ export enum RevenueModelKind {
|
|
|
54
54
|
OTHER = 'other',
|
|
55
55
|
}
|
|
56
56
|
|
|
57
|
+
/**
|
|
58
|
+
* Where the snapshot's pricing TIERS came from — the creator's answer to "what
|
|
59
|
+
* tiers do you plan to sell?", recorded as a fact rather than inferred from the
|
|
60
|
+
* shape of `plans`.
|
|
61
|
+
*
|
|
62
|
+
* ## Why this is a field and not "plans is empty"
|
|
63
|
+
*
|
|
64
|
+
* An empty `plans` used to carry two meanings that send a reader to opposite
|
|
65
|
+
* places: "nobody has sketched pricing yet" (work owed) and "the creator has
|
|
66
|
+
* considered it and not decided" (a real answer, nothing owed). And a non-empty
|
|
67
|
+
* `plans` could not say whether its tiers were the creator's or a proposal the
|
|
68
|
+
* creator asked for. The generated contract (`BusinessModelLiteSnapshotGenerationSchema`)
|
|
69
|
+
* therefore requires this status, so an empty sketch is always a STATEMENT and
|
|
70
|
+
* never a vacuous `{}`.
|
|
71
|
+
*/
|
|
72
|
+
export enum PricingTiersStatus {
|
|
73
|
+
/** `plans` are the tiers the creator named. At least one plan. */
|
|
74
|
+
CREATOR_STATED = 'creator_stated',
|
|
75
|
+
/**
|
|
76
|
+
* The creator asked for tiers to be PROPOSED (typically "derive them from the
|
|
77
|
+
* market research"), so `plans` were derived rather than named. Each carries a
|
|
78
|
+
* `proposalBasis`, and none carries a price or scaling axis the creator did
|
|
79
|
+
* not state. At least one plan.
|
|
80
|
+
*
|
|
81
|
+
* This records ORIGIN, not a pending state: it stays `proposed` after the
|
|
82
|
+
* creator accepts the plans, because acceptance is the commit that lands the
|
|
83
|
+
* artifact, not a value of this field.
|
|
84
|
+
*/
|
|
85
|
+
PROPOSED = 'proposed',
|
|
86
|
+
/**
|
|
87
|
+
* The creator has not decided the tiers and did not ask for a proposal.
|
|
88
|
+
* `plans` is empty, and that emptiness is an answer, not a gap: nothing
|
|
89
|
+
* downstream may read it as "free" or as "no billing", because
|
|
90
|
+
* `revenueModel` still says how the product makes money.
|
|
91
|
+
*/
|
|
92
|
+
UNDECIDED = 'undecided',
|
|
93
|
+
}
|
|
94
|
+
|
|
57
95
|
/**
|
|
58
96
|
* THE business-model-lite-snapshot payload — a **single aggregate per
|
|
59
97
|
* product** (market / vision / requirements / roadmap style), NOT a keyed
|
|
@@ -100,6 +138,12 @@ export enum RevenueModelKind {
|
|
|
100
138
|
* surfaced as a WARN by `validateBusinessModelLiteSnapshot`, never a parse
|
|
101
139
|
* failure. Plans are NOT inherently ordered (unlike roadmap phases), so no
|
|
102
140
|
* `sequence` ordering key is modelled.
|
|
141
|
+
* - **`pricingTiers`** — where the plans came from (`PricingTiersStatus`):
|
|
142
|
+
* stated by the creator, proposed at the creator's request, or undecided
|
|
143
|
+
* (then `plans` is empty BY ANSWER). Optional on a hand-authored file; read
|
|
144
|
+
* it through `resolvePricingTiersStatus`, never directly, so the meaning of
|
|
145
|
+
* an absent value lives in one place. Its agreement with `plans` is checked
|
|
146
|
+
* by `validateBusinessModelLiteSnapshot`.
|
|
103
147
|
*
|
|
104
148
|
* Authored entirely in English (like the vision / market / requirements /
|
|
105
149
|
* roadmap families). Authoring-consistency (duplicate refs, ref format,
|
|
@@ -116,6 +160,26 @@ export const BusinessModelLiteSnapshotSchema = z.object({
|
|
|
116
160
|
revenueModel: z.enum(RevenueModelKind).optional(),
|
|
117
161
|
/** The pricing tiers / packages of the pricing sketch. Ref-addressable. */
|
|
118
162
|
plans: z.array(PricingPlanConfigSchema).default([]),
|
|
163
|
+
/** Where the plans came from. Optional — read through `resolvePricingTiersStatus`. */
|
|
164
|
+
pricingTiers: z.enum(PricingTiersStatus).optional(),
|
|
119
165
|
});
|
|
120
166
|
export type BusinessModelLiteSnapshot = z.infer<typeof BusinessModelLiteSnapshotSchema>;
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* The ONE place an absent `pricingTiers` is interpreted. Every reader that asks
|
|
170
|
+
* "are these tiers decided?" goes through here rather than re-deriving it.
|
|
171
|
+
*
|
|
172
|
+
* - declared → that value;
|
|
173
|
+
* - absent with plans → `CREATOR_STATED`. Exact rather than a fallback: the
|
|
174
|
+
* generated contract always declares the status, so an absent one can only
|
|
175
|
+
* come from a hand-authored file, and a person who wrote plans into the
|
|
176
|
+
* family file stated them;
|
|
177
|
+
* - absent and empty → `undefined`: NOT `UNDECIDED`. Nobody has answered, which
|
|
178
|
+
* is the "not sketched yet" state the validator reports as `NO_PLANS`.
|
|
179
|
+
* Conflating it with a considered "not decided" would silence that warning.
|
|
180
|
+
*/
|
|
181
|
+
export function resolvePricingTiersStatus(snapshot: Pick<BusinessModelLiteSnapshot, 'plans' | 'pricingTiers'>): PricingTiersStatus | undefined {
|
|
182
|
+
if (snapshot.pricingTiers !== undefined) return snapshot.pricingTiers;
|
|
183
|
+
return snapshot.plans.length > 0 ? PricingTiersStatus.CREATOR_STATED : undefined;
|
|
184
|
+
}
|
|
121
185
|
```
|