@wildo-ai/framework-knowledge 1.1.9 → 1.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (376) 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/expert-personas-and-deliberations.md +26 -7
  5. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  6. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  8. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  9. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.definitions.js +84 -4
  11. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  12. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  13. package/dist/esm/index.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +132 -20
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  25. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  27. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  29. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +85 -8
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  33. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  35. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  37. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  41. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  43. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  45. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  52. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  56. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +10 -4
  58. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  60. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  62. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  64. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  66. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  68. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  70. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  72. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  80. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  81. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  82. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  83. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  88. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  93. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  95. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  97. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  99. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
  103. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  104. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  105. package/dist/knowledge/manifest.json +7 -7
  106. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
  107. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  108. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  109. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +149 -11
  110. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
  111. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
  113. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +107 -11
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
  118. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  119. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  122. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  123. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  124. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
  125. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  126. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  127. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  128. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  129. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  130. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  131. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  132. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +7 -3
  133. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  135. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  136. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  137. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  138. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  139. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  140. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  141. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  142. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  143. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  144. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  145. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  150. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  152. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  153. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  154. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  157. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +19 -0
  158. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
  159. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  160. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  161. package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
  162. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  163. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  164. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  165. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  166. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  167. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  168. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  169. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  170. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  171. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  172. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  173. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  174. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  175. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  176. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  177. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  178. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  179. package/dist/knowledge/references/experience-plan.config.md +60 -7
  180. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  181. package/dist/knowledge/references/placement-plan.config.md +43 -0
  182. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  183. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  184. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  185. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  186. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  187. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  188. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  189. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  190. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  191. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  192. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  193. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  194. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  195. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  196. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  197. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  198. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  199. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  200. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  201. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  202. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  203. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  204. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  205. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  206. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  207. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  208. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  209. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  210. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  211. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  212. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  213. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  214. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  215. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  216. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  217. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  218. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  219. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  220. package/dist/knowledge/references/website-plan.config.md +26 -0
  221. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  222. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  223. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  224. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  225. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  226. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  227. package/dist/knowledge/references/zod.factories.code.md +1 -0
  228. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  229. package/dist/knowledge/references/zod.factories.money.md +1 -0
  230. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  231. package/dist/knowledge/registries/framework-topics.json +337 -1
  232. package/dist/knowledge/registries/playbooks.json +18 -18
  233. package/dist/knowledge/registries/source-tags.json +1435 -873
  234. package/dist/knowledge/rules/live-context-door.md +1 -1
  235. package/dist/knowledge/skills/INDEX.md +3 -1
  236. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  237. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  238. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  239. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  240. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  241. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  242. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  243. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  244. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  245. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  246. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  247. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  248. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  249. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
  250. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  251. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  252. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  253. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  254. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  255. package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
  256. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
  257. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  258. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  259. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  260. package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
  261. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  262. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  263. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  264. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  265. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  266. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  267. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  268. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  269. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  270. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  271. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
  272. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  273. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  274. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  275. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  276. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  277. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  278. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  279. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  280. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +11 -3
  281. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
  282. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  283. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  284. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  285. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  286. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  287. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  288. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  289. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  290. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  291. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  292. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  293. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  294. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  295. package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
  296. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  297. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  298. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  299. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  300. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  301. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  302. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  303. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  304. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  305. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  306. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  307. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  308. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  309. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  310. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  311. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  312. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  313. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  314. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  315. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  316. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  317. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  318. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  319. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  320. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  321. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  322. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  323. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  324. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  325. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  326. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  327. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  328. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  329. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  330. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  331. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  332. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  333. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  334. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  335. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  336. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  337. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  338. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  339. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  340. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  341. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  342. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  343. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  344. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  345. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  346. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  347. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  348. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  349. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  350. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  351. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  352. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  353. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  354. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  355. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
  356. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  357. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  358. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  359. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  360. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  361. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  362. package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
  363. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  364. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  365. package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
  366. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
  367. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
  368. package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
  369. package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
  370. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
  371. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
  372. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  373. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  374. package/dist/knowledge/topic-index.json +1441 -269
  375. package/dist/tsconfig.build.tsbuildinfo +1 -1
  376. package/package.json +4 -4
@@ -59,8 +59,11 @@ Derive the coverage → propose → screen → record honestly → hand the choi
59
59
 
60
60
  ### Step 1: Derive the coverage, never assume it
61
61
 
62
- - **Jurisdictions** come from the market's ICP geographies, the vision's compliance detail and
63
- the operating jurisdictions the application declares. Resolve a region tag to countries.
62
+ - **Jurisdictions** are the union of the market's ICP geographies, the vision's compliance detail,
63
+ the application's declared `operatingJurisdictions` and the countries the creator names as where the users are (`top_down.brand-naming`'s
64
+ `target-jurisdictions`, one decision with the compliance interview's `jurisdictions`). Resolve a
65
+ region tag to countries. Every named country is reached by its national office or by a TMview
66
+ search that lists it. Where the data is hosted is not a trademark jurisdiction.
64
67
  If any EU member state is targeted, add `EU` (an EU trade mark has effect in every member
65
68
  state). International registrations (`WO`) are always in scope.
66
69
  - **Nice classes**: 9 and 42 for every software product, 35 for business-management and CRM
@@ -76,8 +79,15 @@ be identical or close to a competitor or alternative the market names.**
76
79
 
77
80
  Search EUIPO (EU marks), TMview (EU and national offices), the WIPO Global Brand Database
78
81
  (international marks), and any targeted national office not already covered. Search identical
79
- and near-identical marks, and record live marks only (registered or pending). See
80
- `references/screening-procedure.md` for the register list and the match rules.
82
+ and near-identical marks, and record live marks only (registered or pending). **Reach a register
83
+ through its machine interface when one is open to you, and record the `accessPath` of every
84
+ query**: a register's web page usually renders its results in the browser and reads as nothing.
85
+ See `references/screening-procedure.md` for the register list, the access paths and the match rules.
86
+
87
+ Record every product already trading under the name with its `categoryRelation`. **A `SAME_JOB`
88
+ product with an identical or near-identical name is a competitor collision**, wherever the
89
+ evidence found it: the choice computation treats it as one even when it was filed only as a
90
+ same-category use, but say so in `competitorCollisions` too.
81
91
 
82
92
  ### Step 4: Record honestly: a failure is not an answer
83
93
 
@@ -85,17 +95,25 @@ A register you could not query or read is **`UNKNOWN`, with a note**, never `CLE
85
95
  exactly when a live identical or near-identical mark was found, with every such mark listed and
86
96
  sourced. Every query carries its source URL and date. There is **no candidate-level verdict to
87
97
  write**. `deriveBrandNameTrademarkOutcome` computes it from the queries, so a candidate with an
88
- unchecked register reads as not cleared. Field contracts: `references/framework-brand-name-screening-api.md`.
98
+ unchecked register reads as not cleared. Coverage is a second derived axis
99
+ (`deriveBrandNameScreeningCoverage`): FULL, PARTIAL, or NONE when no register returned anything. Each
100
+ unread query becomes a check a person can run (`deriveBrandNameManualChecks`, TMview pre-filled); never
101
+ write that link yourself. Field contracts: `references/framework-brand-name-screening-api.md`.
89
102
 
90
103
  ### Step 5: Hand the choice over
91
104
 
92
105
  The brand-identity interview offers options computed by `deriveOfferableBrandNameOptions`:
93
106
 
94
107
  - a clear name, as itself;
95
- - an incomplete one, as `Name [screening-incomplete]`;
96
- - a creator-supplied name that conflicts, as `Name [keep-despite-conflict]`.
97
-
98
- A conflicting proposal is never offered. The creator's answer is the record of their decision.
108
+ - a partly read one, as `Name [screening-incomplete]`;
109
+ - one no register was read for, as `Name [not-screened]`;
110
+ - a creator-supplied name that conflicts (a live mark, a market competitor, or a same-job product
111
+ using the name), as `Name [keep-despite-conflict]`.
112
+
113
+ A conflicting proposal is never offered. Each option is shown with a line saying what its qualifier
114
+ summarizes (the product using the name, the registers nobody read), and the creator's answer records
115
+ that line with the choice. Until the screening clears the chosen name, `wildo context launch-blockers`
116
+ lists it as not cleared.
99
117
  To screen another name of their own, they add it to `top_down.brand-naming`'s interview
100
118
  (`names-to-screen`) and re-run it. Stop there: choosing is not this skill's job.
101
119
 
@@ -113,6 +131,8 @@ To screen another name of their own, they add it to `top_down.brand-naming`'s in
113
131
  - [ ] Classes 9 and 42 are searched.
114
132
  - [ ] Every query has a `sourceUrl` and a `checkedOn` date.
115
133
  - [ ] No query the research could not run is recorded as `CLEAR`.
134
+ - [ ] Every query states its `accessPath`, and every same-category use its `categoryRelation`.
135
+ - [ ] Every country the creator named as a target is a declared jurisdiction.
116
136
  - [ ] No proposal collides with a market competitor or alternative.
117
137
  - [ ] Nothing says "available", "free to use" or "cleared".
118
138
 
@@ -146,6 +166,10 @@ wildo context coherence
146
166
  - The word "available" or "cleared" in the brand or screening. Catch it with the first grep above.
147
167
  - No `EU` jurisdiction while an EU country is targeted. Catch it with the validator's
148
168
  `EU_TRADE_MARK_NOT_DECLARED` finding.
169
+ - Every query `UNKNOWN` and nothing said about it. Catch it with `wildo context coherence`
170
+ (`brand-name-screening-read-nothing`) and the validator's `NO_REGISTER_READ` finding.
171
+ - A same-job product with the candidate's name filed with no `categoryRelation`. Catch it with the
172
+ "every same-category use states its relation" check above.
149
173
 
150
174
  ## Related Skills
151
175
 
@@ -112,6 +112,40 @@ export enum BrandNameDomainStatus {
112
112
  UNKNOWN = 'UNKNOWN',
113
113
  }
114
114
 
115
+ /**
116
+ * HOW a register was reached for one query (#2333). Recorded per query so a reader can tell a register that
117
+ * answered through its published interface from one whose web page was fetched — the two fail differently.
118
+ *
119
+ * Measured on app-creation-test-005 (2026-10-03): every register reached as a WEB_PAGE returned nothing a
120
+ * fetch could read (client-rendered results, an empty page, a CAPTCHA, an HTTP 403, a form that never ran),
121
+ * so 30 of 30 queries were UNKNOWN. A register's web page is built for a person; its machine interface, where
122
+ * one exists, is what a program can read.
123
+ */
124
+ export enum BrandNameRegisterAccessPath {
125
+ /** The register's published machine interface (a search API returning structured records). */
126
+ MACHINE_INTERFACE = 'MACHINE_INTERFACE',
127
+ /** The register's web page, fetched as a document. Usually unreadable: most registers render their results in the browser. */
128
+ WEB_PAGE = 'WEB_PAGE',
129
+ }
130
+
131
+ /**
132
+ * How a product already trading under a candidate's name relates to THIS product's category (#2336).
133
+ *
134
+ * Typed rather than left in a free-text note so the collision check can DECIDE it: a same-job product with
135
+ * the same name is a competitor collision whether or not the market snapshot happened to list it. Measured on
136
+ * app-creation-test-005: "Groundwork — Estimating & Job Suite" (the same customer → quote → job → invoice flow
137
+ * for tradespeople) was recorded only as a same-category use, so the creator's "Groundwork" was never offered
138
+ * as a conflicting name, and a companion proposal colliding with a French building-software product was offered.
139
+ */
140
+ export enum BrandNameCategoryRelation {
141
+ /** The same job for the same kind of customer, or the same Nice class of goods and services: a collision when the names match. */
142
+ SAME_JOB = 'SAME_JOB',
143
+ /** A neighbouring category (building software for another audience, CRM for another trade): recorded, never a collision on its own. */
144
+ ADJACENT = 'ADJACENT',
145
+ /** Unrelated trade (a sports-team payments tool for a builders' CRM): recorded for completeness. */
146
+ UNRELATED = 'UNRELATED',
147
+ }
148
+
115
149
  /** A candidate's derived trademark standing — see {@link deriveBrandNameTrademarkOutcome}. */
116
150
  export enum BrandNameTrademarkOutcome {
117
151
  CLEAR = 'CLEAR',
@@ -195,6 +229,12 @@ export const BrandNameTrademarkQuerySchema = z.object({
195
229
  niceClassesSearched: z.array(NiceClassNumberSchema).min(1),
196
230
  matchTypesSearched: z.array(z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType')).min(1),
197
231
  outcome: z.enum(BrandNameTrademarkQueryOutcome).systemEnum('BrandNameTrademarkQueryOutcome'),
232
+ /**
233
+ * How the register was reached (#2333). Optional in the STORED record only because screenings landed before
234
+ * the field existed carry none; read it through {@link resolveBrandNameQueryAccessPath}, never directly. A
235
+ * producer must always state it — the generation schema requires it.
236
+ */
237
+ accessPath: z.enum(BrandNameRegisterAccessPath).systemEnum('BrandNameRegisterAccessPath').optional(),
198
238
  /** Every live mark found. Present exactly when the outcome is CONFLICT. */
199
239
  conflictingMarks: z.array(BrandNameConflictingMarkSchema).default([]),
200
240
  /** The search or results page that was read — what a reader opens to check this row. */
@@ -214,19 +254,34 @@ export const BrandNameDomainSignalSchema = z.object({
214
254
  });
215
255
  export type BrandNameDomainSignal = z.infer<typeof BrandNameDomainSignalSchema>;
216
256
 
217
- /** A company or product already trading under (or close to) the name in the same category. */
257
+ /**
258
+ * A company or product already trading under (or close to) the name. Despite the field's name, not every
259
+ * entry is in THIS product's category — `categoryRelation` says how close it is, and a SAME_JOB use whose
260
+ * name matches the candidate is a competitor collision ({@link brandNameCandidateCollisions} in the choice
261
+ * module decides it, so a producer that files it here rather than in `competitorCollisions` is still caught).
262
+ */
218
263
  export const BrandNameSameCategoryUseSchema = z.object({
219
264
  name: NonEmptyStringSchema,
220
265
  sourceUrl: z.url(),
266
+ /**
267
+ * How the use relates to this product's category (#2336). Optional in the STORED record only because
268
+ * screenings landed before the field existed carry none — such a use decides no collision, because nothing
269
+ * says it is the same job. The generation schema requires it.
270
+ */
271
+ categoryRelation: z.enum(BrandNameCategoryRelation).systemEnum('BrandNameCategoryRelation').optional(),
221
272
  note: NonEmptyStringSchema.optional(),
222
273
  });
223
274
  export type BrandNameSameCategoryUse = z.infer<typeof BrandNameSameCategoryUseSchema>;
224
275
 
225
- /** A competitor or alternative named in the market snapshot that the candidate is identical or confusingly close to. */
276
+ /**
277
+ * A product the candidate is identical or confusingly close to: a competitor or alternative the market snapshot
278
+ * names, or a product the research found doing the SAME job under the name (#2336) — which the market snapshot
279
+ * may never have listed.
280
+ */
226
281
  export const BrandNameCompetitorCollisionSchema = z.object({
227
282
  /** The market snapshot's alternative ref, when the collision is with one of its alternatives. */
228
283
  alternativeRef: NonEmptyStringSchema.optional(),
229
- /** The competitor's name as the market snapshot names it. */
284
+ /** The competitor's name — as the market snapshot names it, or as the product trades when the research found it. */
230
285
  competitorName: NonEmptyStringSchema,
231
286
  matchType: z.enum(BrandNameMatchType).systemEnum('BrandNameMatchType'),
232
287
  });
@@ -287,10 +342,19 @@ export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
287
342
  * | candidate | offered as |
288
343
  * |---|---|
289
344
  * | CLEAR, no competitor collision | `Batisio` |
290
- * | UNKNOWN (a register could not be read, or coverage is incomplete), no collision | `Batisio [screening-incomplete]` |
345
+ * | UNKNOWN, at least one register READ (coverage partial), no collision | `Batisio [screening-incomplete]` |
346
+ * | UNKNOWN, NO register read (coverage none), no collision | `Batisio [not-screened]` |
291
347
  * | CONFLICT or competitor collision, **creator-supplied** | `Keystone [keep-despite-conflict]` |
292
348
  * | CONFLICT or competitor collision, **companion-proposed** | not offered |
293
349
  *
350
+ * A competitor collision is any name the screening RECORDED as one, any named product in the market snapshot,
351
+ * and any same-job product the screening found trading under the name (`sameCategoryUses` with a `SAME_JOB`
352
+ * relation) — see {@link brandNameCandidateCollisions}. The last is what app-creation-test-005 missed (#2336).
353
+ *
354
+ * Every option also carries its DERIVED coverage and collisions and a one-line `detail`, which the question
355
+ * shows beside the option (#2337): the qualifier is a summary, and nobody can acknowledge a conflict they were
356
+ * never shown. The qualifier records HOW the creator chose; it is never part of the brand name.
357
+ *
294
358
  * So choosing a conflicting name is an EXPLICIT act — the option the creator picks says "keep despite
295
359
  * conflict" — and the creator's answer in the dossier is the durable record of it. A companion-proposed
296
360
  * name that conflicts is never offered at all: the companion must not put a conflicting name in front of
@@ -298,8 +362,10 @@ export type BrandNameScreening = z.infer<typeof BrandNameScreeningSchema>;
298
362
  * `top_down.brand-naming`, never from the origin the screening records — a model wrote that field.
299
363
  */
300
364
  export enum BrandNameChoiceQualifier {
301
- /** The screening could not reach every register, class or jurisdiction: the name is NOT cleared. */
365
+ /** Some registers returned a result, but not every register, class or jurisdiction was read: the name is NOT cleared. */
302
366
  SCREENING_INCOMPLETE = 'screening-incomplete',
367
+ /** No register returned anything for this name (#2334): it was not screened at all, whatever the record lists. */
368
+ NOT_SCREENED = 'not-screened',
303
369
  /** The creator keeps their own name although a live mark or a named competitor conflicts with it. */
304
370
  KEEP_DESPITE_CONFLICT = 'keep-despite-conflict',
305
371
  }
@@ -369,11 +435,17 @@ export function effectiveBrandNameCandidateOrigin(candidate: Pick<BrandNameCandi
369
435
  : BrandNameCandidateOrigin.COMPANION_PROPOSED;
370
436
  }
371
437
 
372
- /** One offerable option, with the candidate it stands for. */
438
+ /** One offerable option, with the candidate it stands for and what the creator is shown beside it. */
373
439
  export interface OfferableBrandNameOption {
374
440
  readonly option: string;
375
441
  readonly candidateRef: string;
376
442
  readonly qualifier: BrandNameChoiceQualifier | null;
443
+ /** DERIVED: how much of this candidate's screening was read (#2334). */
444
+ readonly coverage: BrandNameScreeningCoverage;
445
+ /** DERIVED: every product the name collides with (#2336) — {@link brandNameCandidateCollisions}. */
446
+ readonly collisions: readonly BrandNameCollision[];
447
+ /** The line shown beside the option (#2337) — {@link describeBrandNameOption}. */
448
+ readonly detail: string;
377
449
  }
378
450
 
379
451
  /** The option string for a name and an optional qualifier. */
@@ -13,8 +13,17 @@ whether a name may be used.
13
13
  | WIPO Global Brand Database — https://branddb.wipo.int/ | International (Madrid) registrations and many national collections | `WO`, plus each national collection searched |
14
14
  | A national office (USPTO, UKIPO, DPMA, INPI, …) | That country only | the country's ISO code — never `EU` or `WO` |
15
15
 
16
- Several of these render in the browser or sit behind a CAPTCHA (TMview, WIPO). When a search
17
- cannot be run or its result cannot be read, the query is **`UNKNOWN` with a note saying why**.
16
+ ## How a register is reached
17
+
18
+ | Access path | What it is | Today |
19
+ |---|---|---|
20
+ | `MACHINE_INTERFACE` | the register's published search API, returning structured records | EUIPO publishes a Trademark Search API behind OAuth credentials from a registered developer account; usable only when the application's providers give access. TMview and the WIPO Global Brand Database publish none. A national office may: check its own documentation |
21
+ | `WEB_PAGE` | the register's web page, fetched as a document | most registers render results in the browser, sit behind a CAPTCHA or refuse a fetch, so this usually reads nothing |
22
+
23
+ Record the access path of every query. Try each register once: when it returns nothing readable,
24
+ the query is **`UNKNOWN` with a note saying why**, and the screening turns it into a check a person
25
+ can run (`deriveBrandNameManualChecks`; TMview links are pre-filled with the name, the classes and
26
+ the live statuses). Never write that link yourself.
18
27
 
19
28
  ## Jurisdictions
20
29
 
@@ -22,9 +31,13 @@ Derived, never assumed:
22
31
 
23
32
  1. the market snapshot's ICP geographies (resolve `EMEA`, `NAM`, … to the countries they mean
24
33
  for this product);
25
- 2. the vision's compliance detail and the application's declared operating jurisdictions;
26
- 3. `EU` whenever any EU member state is targeted;
27
- 4. `WO`, always: an international registration can designate any targeted country.
34
+ 2. the jurisdictions the application declares in `wildo.saas.config.ts` (`operatingJurisdictions`; a slug's
35
+ region code is the country, `eu` the European Union);
36
+ 3. the vision's compliance detail, and the countries the creator names as where the users are
37
+ (`target-jurisdictions`, shared with the compliance interview) — each one a target, each reached by
38
+ its national office (IT → UIBM, ES → OEPM, DE → DPMA, FR → INPI, …) or by a TMview search listing it;
39
+ 4. `EU` whenever any EU member state is targeted;
40
+ 5. `WO`, always: an international registration can designate any targeted country.
28
41
 
29
42
  A candidate is covered in a jurisdiction only by a `CLEAR` query that searched **every declared
30
43
  class with both match types**. Anything less leaves it uncovered, and the candidate not cleared.
@@ -51,9 +64,18 @@ Record each with a one-line reason.
51
64
  ## Signals beside the registers (recorded, never blocking)
52
65
 
53
66
  - Exact-match `.com` and the main ccTLDs of the target countries: `REGISTERED`, `AVAILABLE` or `UNKNOWN`.
54
- - Companies or products already trading under the name in the same category, with their URL.
55
- - **Competitor collisions**: a name identical or close to a competitor or alternative the
56
- market snapshot names. A collision makes a proposal unofferable, like a conflict does.
67
+ - Companies or products already trading under the name, with their URL and their `categoryRelation`:
68
+ `SAME_JOB` (the same work for the same kind of customer, or the same Nice class), `ADJACENT`, or
69
+ `UNRELATED`.
70
+ - **Competitor collisions**: a name identical or close to a competitor or alternative the market
71
+ snapshot names, OR to a `SAME_JOB` product the evidence found. A collision makes a proposal
72
+ unofferable, like a conflict does; a creator's own colliding name is offered as keep-despite-conflict.
73
+
74
+ ## Coverage
75
+
76
+ Beside a candidate's standing, `deriveBrandNameScreeningCoverage` says how much was READ: `FULL`,
77
+ `PARTIAL`, or `NONE` when no register returned anything. A name with coverage `NONE` is offered as
78
+ `[not-screened]`; a screening where every candidate is `NONE` is judged as having screened nothing.
57
79
 
58
80
  ## How a result is worded
59
81
 
@@ -143,7 +143,8 @@ cannot say what an erasure does to them. Where the facts also report a category
143
143
  origin, say what IS established alongside it.
144
144
  `NEEDS_CONFIGURATION` for every resource that does not.
145
145
 
146
- **What closes it** — the application's own authors declaring `retentionPolicy` on the resource. Name
146
+ **What closes it** — the application's own authors declaring `retentionPolicy`, with the `dataSubjectPolicy` the
147
+ factory requires beside it, on the resource. Name
147
148
  the resources individually: the remedy is per-resource, and a count is not actionable.
148
149
 
149
150
 
@@ -49,6 +49,8 @@ them.
49
49
  `searchResources`)
50
50
  - Adding a global command palette entry, hotkey, or quick action
51
51
  - Changing sidebar organization (sections, ordering, behavior)
52
+ - Authoring the sidebar, command palette or user menu from the accepted placement plan (a `SHELL_PLACEMENT` build
53
+ task; Step 2b)
52
54
  - Updating menubar `hostedComponents` placement
53
55
  - Declaring a **scope switcher** (`quickSwitcherFields`) — which resource scopes the
54
56
  app, and how its control + dropdown present
@@ -78,6 +80,22 @@ no implicit defaults. Set a key to `false` to **explicitly disable**
78
80
  the surface; omit a key only if the framework documents an implicit
79
81
  fallback (rare).
80
82
 
83
+ ### Step 2b: From a placement plan (a sidebar, command-palette or user-menu task)
84
+
85
+ The task's brief carries the plan for its surface: `groupsOnThisSurface` (the sidebar sections, each with a `purpose`
86
+ and an `order`), `placedOnThisSurface` (each entry with its `shellIdentity`, its address and, when restricted, its
87
+ `visibleToRoles`), and `declinedEverywhere`.
88
+
89
+ - One sidebar section per group (`ref` = its `groupRef`), ordered by `order`, with each placed entry as a child in its
90
+ own `order`. Its title comes from the labelling pipeline; the `purpose` is what that label is written from.
91
+ - An entry or group with `visibleToRoles` gets `runtimeAvailability: { visibleToRoles: [...] }`, with exactly those
92
+ roles, on that layer only: a group's on its section, an entry's on the entry. Never merge the two lists into one;
93
+ a viewer must pass both, and core roles count through inheritance (an admin passes a members' section).
94
+ - A user-menu task lists the placed settings destinations in `USER_DROPDOWN.settingsEntries`; it has no audience.
95
+ - Nothing declined may remain on any surface.
96
+ - The task lands when `wildo context info app-shell-placement-content` lists every placed identity on the surface,
97
+ shown to the audience the plan decided, and none of the declined ones. Run it before finishing.
98
+
81
99
  ### Step 3: Command menu — static commands and/or omnibox search
82
100
 
83
101
  If the change touches the Cmd+K palette, decide the palette **policy** on
@@ -422,6 +440,21 @@ What earns its place:
422
440
  the user's starred items (a hover star on every sidebar row; persisted
423
441
  per machine) and hides the section entirely while it is empty. Declaring
424
442
  the section is what enables the star affordance.
443
+ - A section or an entry for one audience only carries
444
+ `runtimeAvailability: { visibleToRoles: [...] }`. It is shown to viewers
445
+ holding a listed role, at the application or in the current organization,
446
+ or a core role that inherits one. A custom role counts only as itself, so
447
+ list every role that should see it. The placement plan's `visibleToRoles`
448
+ on a sidebar group or decision becomes exactly this field. It hides; it
449
+ does not protect. An entry for an operation the viewer cannot perform
450
+ (its `roles`) is hidden already, so use this field only to narrow
451
+ further. See `references/framework-launcher-visibility-api.md`.
452
+ - Every entry's target is a `LauncherItemRef` discriminated on `kind`. A domain
453
+ module's sidebar section replaces, whole, a same-`ref` section in
454
+ `app-shell.config.ts`; to add rows to a section, use the module's
455
+ `sidebarSectionItems` instead. Commands merge by target. Read `references/framework-launcher-items-api.md`
456
+ for the exact fields per `kind` and the merge rules, before reading anything
457
+ compiled.
425
458
  - `COMMAND_MENU.policy: CommandBarPolicy.OMNIBOX` — the **command palette
426
459
  policy**. Here it is `OMNIBOX`, so `searchResources` also declares which
427
460
  resources feed live record search (see the dedicated omnibox worked example
@@ -693,6 +726,8 @@ What earns its place:
693
726
  - `references/app-shell-surfaces.md` — author-facing surface list
694
727
  - `references/framework-app-shell-api.md` — engine app-level component vocabulary + configuration schema
695
728
  - `references/framework-command-menu-omnibox-api.md` — command-menu policy (`CommandBarPolicy`) + omnibox `searchResources` (`CommandMenuSearchResource`) contract
729
+ - `references/framework-launcher-items-api.md` — `LauncherItemRef` (what an entry targets, per `kind`) and the merge rules: a module's sidebar section replaces a same-`ref` one whole, `sidebarSectionItems` adds rows, commands merge by target
730
+ - `references/framework-launcher-visibility-api.md` — `runtimeAvailability`: `requiredCapabilities` and `visibleToRoles`, which decide whether a launcher entry appears at all
696
731
  - `references/framework-app-shell-hosted-components-api.md` — menubar/sidebar `hostedComponents` entry shape (`MenubarHostedComponent` / `SidebarHostedComponent`) + per-placement `triggerWidth`
697
732
  - `references/framework-quick-switcher-scope-field-api.md` — `quickSwitcherFields` entry shape (`QuickSwitcherScopeField`), the two independent presentation axes (`optionDisplayMode` / `presentation`), and what a scope declaration wires for free
698
733
  - `references/framework-public-shell-identity-api.md` — naming the application on its public/auth cards: where the field goes, and what actually renders for each brand state
@@ -704,6 +739,7 @@ What earns its place:
704
739
  - [ ] Shell renders without runtime errors
705
740
  - [ ] New `hostedComponents` entries route to valid component types
706
741
  - [ ] Each `SidebarSection.ref` is unique and stable (used by spec)
742
+ - [ ] Every `visibleToRoles` the placement plan declares is on the matching section or entry, and names roles the application defines
707
743
  - [ ] `EnginePageRef.*` references resolve at typecheck time
708
744
  - [ ] `openShortcut` strings do not collide with existing hotkeys
709
745
  - [ ] No surface key omitted (every `ApplicationLevelComponentType.*` declared)
@@ -721,20 +757,37 @@ Run from the app root:
721
757
 
722
758
  | Invariant | Command |
723
759
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
724
- | Every key uses the typed enum | `rg -oN "\[ApplicationLevelComponentType\.[A-Z_]+\]" frontend/src/config/app-shell.config.ts \| sort -u` |
760
+ | Every key uses the typed enum | see the commands below the table |
725
761
  | No string-literal placement / breakpoint | `rg -n "placement:\s+'[a-z]" frontend/src/config/app-shell.config.ts` (must return empty) |
726
762
  | Each `EnginePageRef` reference is typed | `rg -n "pageRef:\s+EnginePageRef\." frontend/src/config/app-shell.config.ts` |
727
- | Sidebar section refs are unique | `rg -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts \| sort \| uniq -d` (must return empty) |
763
+ | Sidebar section refs are unique | see the commands below the table (must return empty) |
728
764
  | Command menu has an `openShortcut` | `rg -n "openShortcut:" frontend/src/config/app-shell.config.ts` |
729
- | Every `commands: []` entry resolves to a registered `commandId` | `rg -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts \| sort -u` then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
765
+ | Every `commands: []` entry resolves to a registered `commandId` | run the commands below the table, then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
730
766
  | `publicShellIdentityMode` is NOT in the shell config | `rg -n "publicShellIdentityMode" frontend/src/config/app-shell.config.ts` (must return empty; it belongs in `frontend/src/modules-registry.frontend.ts`) |
731
767
  | `searchResources` implies `policy: OMNIBOX` | `rg -n "searchResources:" frontend/src/config/app-shell.config.ts` — if it matches, `rg -n "CommandBarPolicy.OMNIBOX" frontend/src/config/app-shell.config.ts` must also match |
732
768
  | Module command items are typed launcher refs | `rg -n "kind:\s+LauncherItemTargetKind\." frontend/src/modules/*/app-shell.module.frontend.ts` (each `commandMenuItems` entry must be a typed `LauncherItemTargetKind`, never a string) |
733
- | Hosted-component placement uses the typed enum | `rg -n "placement:\s+(Horizontal\|Vertical)Placement\." frontend/src/config/app-shell.config.ts` (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
769
+ | Hosted-component placement uses the typed enum | see the commands below the table (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
734
770
  | Hosted `triggerWidth` is a number or a literal CSS width | `rg -n "triggerWidth:" frontend/src/config/app-shell.config.ts` (each value is a px number like `240` or a CSS width string like `'100%'`/`'16rem'` — never a bare Tailwind class) |
735
771
  | Scope-field resource types are typed | `rg -n "resourceType:\s+'" frontend/src/modules/*/app-shell.module.frontend.ts` (must return empty — every `quickSwitcherFields` entry names a typed `*_ResourceType.*` member) |
736
772
  | A declared scope field is actually hosted | `rg -qn "quickSwitcherFields" frontend/src/modules/*/app-shell.module.frontend.ts && rg -n "ApplicationLevelComponentType.QUICK_SWITCHER" frontend/src/config/app-shell.config.ts` (if the first matches, the second must too) |
737
- | Presentation axes use their typed enums | `rg -n "optionDisplayMode:\|presentation:" frontend/src/modules/*/app-shell.module.frontend.ts` (each value is `ForeignKeyDisplayMode.*` / `QuickSwitcherFieldPresentation.*`, never a quoted string) |
773
+ | Presentation axes use their typed enums | see the commands below the table (each value is `ForeignKeyDisplayMode.*` / `QuickSwitcherFieldPresentation.*`, never a quoted string) |
774
+
775
+ ```bash
776
+ # Every key uses the typed enum
777
+ rg -oN "\[ApplicationLevelComponentType\.[A-Z_]+\]" frontend/src/config/app-shell.config.ts | sort -u
778
+
779
+ # Sidebar section refs are unique
780
+ rg -P -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts | sort | uniq -d
781
+
782
+ # Every `commands: []` entry resolves to a registered `commandId`
783
+ rg -P -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts | sort -u
784
+
785
+ # Hosted-component placement uses the typed enum
786
+ rg -n "placement:\s+(Horizontal|Vertical)Placement\." frontend/src/config/app-shell.config.ts
787
+
788
+ # Presentation axes use their typed enums
789
+ rg -n "optionDisplayMode:|presentation:" frontend/src/modules/*/app-shell.module.frontend.ts
790
+ ```
738
791
 
739
792
  The fourth invariant (unique `ref:`) is the high-signal one — duplicate
740
793
  section refs collapse silently in the rendered sidebar and break any