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