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