@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,122 @@
1
+ # Derived artifacts and their currency
2
+
3
+ Read this when:
4
+
5
+ - a dev server, the backend, a worker, a minion or the dev companion refuses to start and its error
6
+ names a generated file, or tells you to "regenerate" or to run `wildo config sync`;
7
+ - something behaves as if an earlier version of your configuration were still in force;
8
+ - you just ran `wildo update`, or changed `providers` / `services` in `wildo.saas.config.ts`;
9
+ - you need to know whether a file under `.wildo-saas/` or a `src/generated/` folder is safe to
10
+ delete, safe to edit (never), or must be committed.
11
+
12
+ ### Derived artifacts: where they live, how to tell they are current, what regenerates them
13
+
14
+ Much of what your application runs is **derived**: written by a `wildo` command or a dev watcher from
15
+ something you authored. A derived file never fails at the moment it goes stale. It fails later, far
16
+ from its cause, when a process that reads it refuses it — and by then the error reads like a bug in
17
+ your code or in the framework. It almost never is.
18
+
19
+ Four facts govern every row below:
20
+
21
+ - **A derived file is never edited by hand.** Fix the authored source, then regenerate. A hand edit is
22
+ overwritten by the next regeneration and leaves no trace of why it reverted.
23
+ - **Most derived files are regenerated by a COMMAND, not by a watcher.** `wildo local dev` rebuilds
24
+ your packages as you edit them, and when it STARTS it regenerates the provider runtime artifacts if a
25
+ generated module is missing or a reader would refuse one of the JSON artifacts — but it never refreshes the CSP file, the labels or the docs,
26
+ and it does not watch the provider artifacts once running. A framework update can change what a
27
+ reader requires of those files while their inputs stay the same, so they go stale without anything
28
+ you did.
29
+ - **When a reader refuses a derived file, its message names the command that regenerates it.** That
30
+ is the fix. Run it; do not "repair" the reader, the provider, or the authored config to make the
31
+ refusal go away.
32
+ - **Regenerating is safe.** `wildo config sync` never rotates a secret unless you pass
33
+ `--rotate-secrets`; it only adds framework-managed secrets that are missing. Apart from that, the
34
+ one authored file it can change is a backend `package.json` (and the root `pnpm.overrides`), when
35
+ `systemsOfRecord` is declared and the library it needs is not: run `pnpm install` after that.
36
+ Regenerating a current file changes nothing.
37
+
38
+ #### When a running process refuses a generated file
39
+
40
+ 1. **Read the refusal for a command.** The messages in the table below each name one.
41
+ 2. **Date the artifact.** Provider runtime artifacts carry a `generatedAt` field; for anything else use
42
+ the file's modification time. Older than the last change to your `@wildo-ai/*` versions
43
+ (`pnpm-lock.yaml`), to `wildo.saas.config.ts`, or to `wildo.infra.<env>.config.ts`? It is stale.
44
+ 3. **Run the command it names**, from the application root. For the provider runtime artifacts that
45
+ is `wildo -y config sync --local` (add `--env <env>` for one environment). `-y` keeps it from
46
+ stopping at the env-file prompt: it then leaves existing `.env` files alone, which is what you want
47
+ here, and still writes every provider runtime artifact.
48
+ 4. **Let the refused process restart.** Under `wildo local dev` each process is supervised and
49
+ restarts on its own within seconds; otherwise restart that one process. Do not restart the stack.
50
+ 5. **Confirm**: the process logs that it started, and the artifact's `generatedAt` is now.
51
+
52
+ | The refusal says (abbreviated) | Stale artifact | Regenerate with |
53
+ |---|---|---|
54
+ | `refused to serve frontend provider configuration it was handed … declares no publicConfigSchema whose keys can be read … generated before this check existed` | the frontend provider bootstrap: `.wildo-saas/generated/providers/frontend-services.runtime-providers.generated.json` when a website or docs build refuses, `backend-api/src/generated/wildo-provider-runtime.generated.ts` when the backend's `/application-config` refuses | `wildo -y config sync --local` |
55
+ | `generated provider runtime artifact at … does not satisfy the current contract` | a `.wildo-saas/generated/providers/*.runtime-providers.generated.json` file | `wildo -y config sync --local` |
56
+ | `generated before the contract changed. Regenerate it … and restart` · `The artifact is stale for this package` | `backend-api/src/generated/wildo-provider-runtime.generated.ts` | `wildo -y config sync --local` |
57
+ | `runtime artifact lists no facet modules` | the same module, generated before systems of record existed | `wildo -y config sync --local --domain env-files` |
58
+ | `Missing generated provider runtime module` (printed by your backend's own `src/index.ts`) | the same module, absent | `wildo -y config sync --local` |
59
+ | `Missing or invalid companion provider runtime artifact` | `.wildo-saas/generated/providers/companion.runtime-providers.generated.json` | `wildo -y config sync --local` |
60
+ | `detected stale provider topology` · `does not contain a scope for worker/minion` | a minion's or worker's `.wildo-providers.env` or generated module | `wildo -y config sync --local` |
61
+ | browser console: `bundle carries no code for it … regenerate frontend-providers.generated.ts` (a provider silently missing) | `<frontend service>/src/generated/frontend-providers.generated.ts` | `wildo -y config sync --local`, then commit it |
62
+ | `Lockfile drift detected` | `.wildo-saas/wildo-saas.lock.json` | `wildo -y config sync --local`, then commit it |
63
+ | `postgresql_table_schema_mismatch` | the database schema behind your resources | `wildo db generate --name <label>` (see the database-migrations skill) |
64
+ | `Run wildo dev sync-csp and commit the result` | `<frontend service>/src/generated/csp.generated.json` | `wildo dev sync-csp` |
65
+ | `Run wildo config <data-retention · service-consent · subject-data-recipients · document-releases> and commit` | the matching `backend-api/src/*.generated.ts` compliance module | the command it names |
66
+ | `No generated config … Run wildo config sync --domain config` | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json` | `wildo config sync --local --domain config` |
67
+
68
+ #### Every derived artifact, and how to check it
69
+
70
+ | Artifact | Lives at | Regenerated by | How to tell it is current | In git? |
71
+ |---|---|---|---|---|
72
+ | Provider runtime artifacts | `.wildo-saas/generated/providers/*.runtime-providers.generated.json`; `backend-api/src/generated/wildo-provider-runtime.generated.ts` and the same file in each minion and Node worker; `minions/*/.wildo-providers.env`, `workers/*/.wildo-providers.env` | `wildo -y config sync --local` (no prompt); `wildo local dev` regenerates a missing or refused one when it starts | `wildo local doctor` — the **generated provider-runtime artifact content** line checks the frontend-services, backend and companion JSON files with what their readers apply, and names every one a reader would refuse. It does not read the minion and worker JSON files, the `.ts` modules or the `.wildo-providers.env` files | No — always safe to regenerate |
73
+ | Frontend provider modules | `<frontend service>/src/generated/frontend-providers.generated.ts`, `frontend-provider-service.generated.json` | `wildo -y config sync --local` | Nothing. A stale one drops a provider with a browser-console warning instead of failing | Yes — commit after regenerating |
74
+ | Provider catalogue types | `.wildo-saas/generated/provider-catalog.types.ts` | `wildo -y config sync --local` | Nothing; stale only means stale autocomplete | Yes |
75
+ | Application lockfile | `.wildo-saas/wildo-saas.lock.json` | `wildo -y config sync --local` (providers, infra); module and label commands write their own sections | `wildo lock check` — checks the providers and infra sections only | Yes |
76
+ | Content security policy | `<frontend service>/src/generated/csp.generated.json` | `wildo dev sync-csp` (also `wildo dev start`) — **not** `wildo config sync` | `wildo dev sync-csp --check` (it refreshes the provider artifacts before comparing) | Yes |
77
+ | Environment config and local stack | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `…/docker-compose/docker-compose.wildo-platform.yml`, `…/docker-compose/.env.wildo-platform` | `wildo -y config sync --local`. `wildo local up` only recreates a MISSING one, never a stale one | `wildo config validate --domain config` checks coherence with your secrets, not currency | No |
78
+ | Per-package `.env` files | `backend-api/.env`, `frontend/.env`, `website/.env`, `technical-doc/.env`, each minion and worker, `.wildo-saas/wildo-dev-companion/.env` | `wildo -y config sync --local --domain env-files` — needs the local platform running (when it is down this phase fails, but the provider artifacts are still written). It asks before overwriting; `-y` SKIPS existing files, `--force` rewrites them | Nothing | No |
79
+ | Application identity | `.wildo-saas/infrastructure/environments/<env>/generated/config/application-runtime-identity.json` | **Not derived** — assigned when the application registered (`wildo local init`) | — | No, and **do not delete it**: only re-registration restores it |
80
+ | Compliance modules | `backend-api/src/{data-retention,service-consent-requirement,subject-data-recipients,governed-document-releases}.generated.ts` | `wildo config data-retention` · `service-consent` · `subject-data-recipients` · `document-releases` | The same command with `--check`, or `wildo config validate --domain <same name>` | Yes |
81
+ | Database migrations | `backend-api/migrations/`, `backend-api/migrations/schema-plan.lock.json` | `wildo db generate --name <label>` | `wildo db diff --check`. It refuses to answer while `backend-api/dist` is older than its sources — let the build catch up first | Yes — **never delete** |
82
+ | Labels and translations | `backend-api/src/engine/i18n/**` | `wildo generate labels`, then `wildo generate translate` (the dev companion must be running) | No command reports it; the lockfile records each unit's status | Yes |
83
+ | Technical documentation | `technical-doc/src/generated/api-reference/**`, `technical-doc/src/generated/consumer-documentation/**` | `wildo docs publish` (the dev companion must be running) | Nothing short of republishing and reading the diff | Yes |
84
+ | Package builds | each package's `dist/` | the dev watchers `wildo local dev` starts | Nothing direct; `wildo db diff` refuses on a stale `backend-api/dist` | No |
85
+ | Config loader cache | `.wildo-saas/dist/config-loader/` | rebuilt on demand | Nothing; delete it when `wildo.saas.config.ts` edits seem ignored | No — always safe to delete |
86
+ | Delivered framework | `.claude/skills/` and the rules delivered beside them under `.claude/`, `.wildo-saas/templates/`, `.wildo-saas/wildo-dev-companion/` | `wildo assets sync` (`wildo update` runs it) | Nothing records which release delivered them; re-run `wildo assets sync` when in doubt | Skills and rules yes; templates and the companion build no |
87
+
88
+ Files your application-creation runs produced — brand assets, personas, charters, specifications —
89
+ are **committed decisions**, not caches. They are never regenerated to fix a refusal.
90
+
91
+ #### What `wildo local doctor` can and cannot tell you
92
+
93
+ - It **fails** when a generated provider runtime module is missing, and names `wildo config sync`.
94
+ - It **fails** when a present provider runtime artifact would be refused by the process that reads
95
+ it (*generated provider-runtime artifact content*), with the reason that reader gives — for the
96
+ frontend-services and backend files, the reader's own refusal message. It applies what the readers
97
+ apply rather than comparing dates, so it catches a file a framework update made stale while every
98
+ input stayed the same. It covers the frontend-services, backend and companion JSON files only.
99
+ - It does not check the other derived artifacts in the table above; use the command in their row.
100
+ - Its **derived-artifact currency** line reads `not probed` in an application installed from
101
+ published packages. That is not a pass: it compares builds against a framework source checkout,
102
+ which your application does not have.
103
+
104
+ #### Regenerate before you debug, after any of these
105
+
106
+ - **A framework update.** `wildo update` ends by regenerating the provider runtime artifacts and the
107
+ CSP files (`wildo dev sync-csp`, for the active environment), after declaring and installing the
108
+ systems-of-record library when `systemsOfRecord` needs it. If the release you moved to predates that
109
+ step, run `wildo -y config sync --local` yourself. If the step fails, its message says why:
110
+ - `Config file not found: …/wildo.infra.<env>.config.ts` — only the CSP half failed: the provider
111
+ runtime artifacts were already regenerated. The active environment has no authored infra config;
112
+ set it up with `wildo setup` (or select an environment that has one), then run `wildo dev sync-csp`.
113
+ - `Cannot produce the frontend provider configuration … its secrets … cannot be read` — nothing was
114
+ produced, and `config sync` stops on the same check. Restore that environment's `secrets.json`:
115
+ the provider configuration is screened against it and is never produced without it.
116
+ - **A change to `providers` or `services` in `wildo.saas.config.ts`**, or adding a frontend service:
117
+ `wildo -y config sync --local`, then `wildo dev sync-csp`.
118
+ - **A change to `wildo.infra.<env>.config.ts`**: `wildo -y config sync --local`, then
119
+ `wildo config sync --local --domain manifest`.
120
+
121
+ Commit the tracked files a regeneration changed in their own commit, so the next reader can tell a
122
+ regeneration from an authored change.
@@ -21,6 +21,17 @@ It moves the two homes of a release, in this order:
21
21
  It restarts nothing. Afterwards `wildo local up` puts the platform on the release's image, and
22
22
  restarting `wildo local dev` runs the application and its companion on the new packages.
23
23
 
24
+ Its last step is `wildo dev sync-csp`, which regenerates the provider runtime artifacts and the CSP
25
+ files built from them for the active environment. Just before it, an application whose `systemsOfRecord`
26
+ needs the systems-of-record library gets that dependency declared on its backend manifests and
27
+ installed, so the regeneration never meets an uninstalled package. A release can change what the backend, the website or the companion requires
28
+ of those files without any input changing, and a file the previous release wrote is then refused at
29
+ start-up (`…generated before this check existed — regenerate it with wildo config sync`). If the
30
+ release you moved to predates that step, run `wildo -y config sync --local` before restarting
31
+ `wildo local dev`. If the step reports a failure, read its message first: a missing infra config fails only
32
+ the CSP half (the provider artifacts were regenerated), while an unreadable `secrets.json` stops the
33
+ provider artifacts and `config sync` alike. `derived-artifact-currency.md` gives the fix for each.
34
+
24
35
  ## When the release asks for something this application does not declare
25
36
 
26
37
  A release can make a declaration REQUIRED that older applications do not have. `wildo update` then
@@ -361,6 +361,13 @@ timestamps and exactly what to delete, and it does not act. Read it before you
361
361
  debug logic: a stale artifact answers confidently about a version of the
362
362
  application that no longer exists.
363
363
 
364
+ That sweep compares builds against a framework SOURCE checkout. In an
365
+ application installed from published packages it reports `not probed`, which
366
+ is not a pass. The provider runtime artifacts have their own line, in every
367
+ mode: *generated provider-runtime artifact content* runs their readers' checks
368
+ and names each file they would refuse. See `derived-artifact-currency.md` for
369
+ what each derived artifact can and cannot be checked by.
370
+
364
371
  It reports orphaned compiler watchers and never kills them; reaping is
365
372
  `wildo dev force-stop`.
366
373
 
@@ -478,13 +485,13 @@ their values in logs or documentation.
478
485
  |---------------------------------------------------------|--------------------------------------------------------------------------------------|
479
486
  | `./infrastructure/<env>/wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts` (added/changed a backing service, runtime, `publicDomain`, …) | `wildo -y config sync --local` for config/env outputs; then run `wildo -y config sync --local --domain manifest` separately for the local workload render. An explicit domain filter replaces the defaults. Ordinary non-CI sync reconciles authored state first |
480
487
  | `./wildo.saas.config.ts` (modules, engine capabilities, provider scopes) | `wildo -y config sync --local --domain config` then restart the affected runtime process (`wildo dev start` if the app dev script owns it) |
481
- | Provider API keys (OpenAI, Anthropic, …) — typed in by hand | `wildo secrets set <ENV_VAR_NAME>` (add `--env <env>` for a remote environment): it writes `secrets.json` → `providerEnv`, regenerates the env files and restarts only the runtimes that read the key (this is the rotation path you DO want) |
488
+ | Provider API keys (OpenAI, Anthropic, …) — typed in by hand | `wildo secrets set <ENV_VAR_NAME>` (add `--env <env>` for a remote environment): it writes `secrets.json` → `providerEnv`, regenerates the env files, has a running dev companion load the key in place (no restart, no run interrupted) and restarts the other supervised runtimes that read it; the output says which, and names any runtime you still have to restart yourself (this is the rotation path you DO want) |
482
489
  | The authored secrets path (`./infrastructure/<env>/secrets/`) — moved or split | `wildo -y setup` and answer the path question with the new layout |
483
490
  | Nothing — just want to bounce the stack | `wildo -y local up --restart` |
484
491
  | `./wildo.saas.config.ts` — a service port, a session storage mode, a capability flag, or removing a provider from a scope | `wildo config mutate` (idempotent, dry-runnable, names the segment it cannot resolve) then `wildo -y config sync --local` |
485
492
  | Anything at all, and you want to CHECK before writing | `wildo config validate` — writes nothing |
486
493
  | The declaration, on an application that is already running | `wildo config reapply-declaration` (leaves credentials, database, infra and the seeded administrator alone) |
487
- | Nothing — but something is behaving impossibly | `wildo local doctor` FIRST. Its currency sweep tells you whether what is running is even current |
494
+ | Nothing — but something is behaving impossibly | `wildo local doctor` FIRST, then `derived-artifact-currency.md`: a process refusing a generated file names the command that regenerates it |
488
495
  | Nothing — you want a newer framework release | `wildo update` (or `--to <version>`). It moves the CLI, then this application's pins, dependencies, companion, skills and deploy manifests. See `framework-upgrade-and-dependency-alignment.md` |
489
496
  | The `@wildo-ai/*` versions in `pnpm.overrides`, by hand | `pnpm install` → `wildo align-deps --write` → `pnpm install` again, then `wildo assets sync`. Prefer `wildo update`, which does all of it and moves the CLI to match |
490
497
  | Nothing — the application was just scaffolded and installed for the first time | `wildo align-deps --write` once, then `pnpm install`. Expected, not a defect: scaffolding pins from the framework checkout while pinning the framework to the published release |
@@ -428,11 +428,19 @@ export const aiAssistantWeeklyDigestBenefit: FeatureBenefitConfig = {
428
428
  | Invariant | Command |
429
429
  |-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
430
430
  | Every benefit file uses the typed `FeatureBenefitConfig` | `rg -n ":\s+FeatureBenefitConfig" specifications/src/market/value-proposition/` |
431
- | Every benefit declares a non-empty `deliveredBy` | `rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ \| rg "deliveredBy:\s*\["` |
431
+ | Every benefit declares a non-empty `deliveredBy` | see the commands below the table |
432
432
  | `THRESHOLD` benefits are intentional (find them all) | `rg -n "BenefitKanoCategory.THRESHOLD" specifications/src/market/` |
433
- | `REVERSE` benefits live with `ANTI_TARGET` ICPs | `rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ \| rg "ANTI_TARGET\|icp-anti-"` |
433
+ | `REVERSE` benefits live with `ANTI_TARGET` ICPs | see the commands below the table |
434
434
  | No `LocalizedString` shapes inside benefits | `rg -n "LocalizedString" specifications/src/market/value-proposition/` |
435
435
 
436
+ ```bash
437
+ # Every benefit declares a non-empty `deliveredBy`
438
+ rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ | rg "deliveredBy:\s*\["
439
+
440
+ # `REVERSE` benefits live with `ANTI_TARGET` ICPs
441
+ rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ | rg "ANTI_TARGET|icp-anti-"
442
+ ```
443
+
436
444
  ## Common Rationalizations
437
445
 
438
446
  | Rationalization | Reality |
@@ -507,10 +507,18 @@ export const inHouseNotionAlternative: MarketAlternativeConfig = {
507
507
  | Invariant | Command |
508
508
  |-----------|---------|
509
509
  | Every alternative file uses the typed `MarketAlternativeConfig` | `rg -n ":\s+MarketAlternativeConfig" specifications/src/market/` |
510
- | Every alternative declares both `whenChosen` and `whenWeBeat` | `rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ \| rg "whenChosen\|whenWeBeat"` |
511
- | `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | `rg -n "STATUS_QUO\|ADJACENT_PROXY\|IN_HOUSE_BUILD" -A 6 specifications/src/market/ \| rg -v "url"` |
510
+ | Every alternative declares both `whenChosen` and `whenWeBeat` | see the commands below the table |
511
+ | `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | see the commands below the table |
512
512
  | At least one positioning references each alternative | `rg -n "alt-" specifications/src/market/positioning.ts` |
513
513
 
514
+ ```bash
515
+ # Every alternative declares both `whenChosen` and `whenWeBeat`
516
+ rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ | rg "whenChosen|whenWeBeat"
517
+
518
+ # `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url`
519
+ rg -n "STATUS_QUO|ADJACENT_PROXY|IN_HOUSE_BUILD" -A 6 specifications/src/market/ | rg -v "url"
520
+ ```
521
+
514
522
  ## Common Rationalizations
515
523
 
516
524
  | Rationalization | Reality |
@@ -296,9 +296,17 @@ What earns its place:
296
296
  |----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
297
297
  | Snapshot uses the typed `MarketSnapshot` contract | `rg -n ":\s+MarketSnapshot" specifications/src/market/index.ts` |
298
298
  | Snapshot version is V2 (Phase-3 surface) | `rg -n "version:\s+MarketSnapshotVersion\.V2" specifications/src/market/index.ts` |
299
- | No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | `rg -n "LocalizedString\|MarketLocaleConfig" specifications/src/market/` |
299
+ | No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | see the commands below the table |
300
300
  | Geographies use ISO 3166-1 alpha-2 codes or recognized region tags | `rg -n "geographies:" specifications/src/market/` (visually verify each value is `[A-Z]{2}` or one of `EMEA / NAM / APAC / LATAM / MENA / GLOBAL`; the validator enforces this at boot) |
301
- | Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | `rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ \| rg "adoption:\s*0,\s*revenue:\s*0"` |
301
+ | Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | see the commands below the table |
302
+
303
+ ```bash
304
+ # No `LocalizedString` / `MarketLocaleConfig` references inside `market/`
305
+ rg -n "LocalizedString|MarketLocaleConfig" specifications/src/market/
306
+
307
+ # Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }`
308
+ rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
309
+ ```
302
310
 
303
311
  ## Common Rationalizations
304
312
 
@@ -65,6 +65,17 @@ Locate the surfaces that may need editing using these app-relative globs:
65
65
 
66
66
  ### Step 1 — Pick the category name
67
67
 
68
+ Start from what the creator said the product IS: their one-liner, the
69
+ workflow they named and what they left out. The category keeps every
70
+ stage of that workflow and puts nothing they excluded at its centre: a
71
+ category under which a stated stage disappears is the wrong category,
72
+ not a sharper one. Better market words for the creator's own kind of
73
+ product are fine. When your name is a different kind of product from
74
+ the one the creator named, add a `notes[]` entry starting `Reframe:`
75
+ that quotes their framing, names yours and says why, so they can
76
+ overturn it. Never list the creator's own framing among
77
+ `rejectedCategories`.
78
+
68
79
  The name is the words you want a buyer to repeat back. It should
69
80
  be:
70
81
 
@@ -80,14 +91,14 @@ explaining it to a smart friend who has never seen the product.
80
91
 
81
92
  ### Step 3 — Author 2–5 `rejectedCategories`
82
93
 
83
- For each: `name`, `whyRejected`. These are the neighbouring
94
+ For each: `name`, `rationale`. These are the neighbouring
84
95
  categories buyers might think we are — and which we explicitly
85
- turn down. The `whyRejected` line is the verbatim AI / landing-copy
96
+ turn down. The `rationale` line is the verbatim AI / landing-copy
86
97
  ammunition for the comparison.
87
98
 
88
99
  ### Step 4 — Author 2–4 `differentiationDimensions`
89
100
 
90
- For each: `name`, `whatWeOptimizeFor`. These are the axes where
101
+ For each: `name`, `description`. These are the axes where
91
102
  we are deliberately better than the average competitor in our
92
103
  category. They are what AI prompts pull when asked to argue our
93
104
  position.
@@ -166,8 +177,8 @@ export type MarketCategoryConfig = z.infer<typeof MarketCategoryConfigSchema>;
166
177
 
167
178
  A complete, schema-shaped `MarketCategoryConfig` from the
168
179
  reference application — a productized category with
169
- explicit `rejectedCategories` (with `whyRejected`) and
170
- `differentiationDimensions` (with `whatWeOptimizeFor`):
180
+ explicit `rejectedCategories` (with `rationale`) and
181
+ `differentiationDimensions` (with `description`):
171
182
 
172
183
 
173
184
  ## Usage Example
@@ -251,9 +262,12 @@ quartet is what the snapshot validator audits.
251
262
  defensive, none looks unfocused)
252
263
  - [ ] At least 2 `differentiationDimensions` (no-axis category is
253
264
  unactionable)
254
- - [ ] Every `rejectedCategory` carries a `whyRejected`
265
+ - [ ] Every `rejectedCategory` carries a `rationale`
255
266
  - [ ] Every `differentiationDimension` carries a
256
- `whatWeOptimizeFor`
267
+ `description`
268
+ - [ ] The category keeps every workflow stage the creator named,
269
+ and a name of a different kind of product from theirs carries a
270
+ `Reframe:` note
257
271
 
258
272
  ### Grep invariants
259
273
 
@@ -326,9 +326,14 @@ export const communityIndieHackersChannel: MarketChannelConfig = {
326
326
  | Invariant | Command |
327
327
  |-----------|---------|
328
328
  | Every channel file uses the typed `MarketChannelConfig` | `rg -n ":\s+MarketChannelConfig" specifications/src/market/` |
329
- | Every channel declares non-empty `buyingJourneyStages` | `rg -n "MarketChannelConfig" -A 8 specifications/src/market/ \| rg "buyingJourneyStages:\s*\["` |
329
+ | Every channel declares non-empty `buyingJourneyStages` | see the commands below the table |
330
330
  | No `LocalizedString` shapes in channel files | `rg -n "LocalizedString" specifications/src/market/channels.ts` |
331
331
 
332
+ ```bash
333
+ # Every channel declares non-empty `buyingJourneyStages`
334
+ rg -n "MarketChannelConfig" -A 8 specifications/src/market/ | rg "buyingJourneyStages:\s*\["
335
+ ```
336
+
332
337
  ## Common Rationalizations
333
338
 
334
339
  | Rationalization | Reality |
@@ -651,7 +651,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
651
651
  const trimmed = value.trim();
652
652
  if (trimmed.length === 0) return undefined;
653
653
  if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
654
- throw new Error(
654
+ throw new IntrospectionInputValidationError(
655
655
  `buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
656
656
  + `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
657
657
  + `not a sentence — translation prose belongs in the LLM output, not the tag.`,
@@ -922,6 +922,8 @@ export interface SpecificationsCompanionExports<
922
922
  TIntegrationPlan = IntegrationPlan,
923
923
  // Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
924
924
  TApplicationMaturity = ApplicationMaturity,
925
+ // Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
926
+ TBrandNameScreening = BrandNameScreening,
925
927
  > {
926
928
  resourceSpecifications: TResourceSpecifications;
927
929
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -1452,6 +1454,14 @@ export interface SpecificationsCompanionExports<
1452
1454
  * never a gate. Read by the coherence report and the workbench.
1453
1455
  */
1454
1456
  applicationMaturity?: TApplicationMaturity;
1457
+ /**
1458
+ * WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
1459
+ * registers, classes and jurisdictions searched, per-register results with sources and dates, and the
1460
+ * competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
1461
+ * `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
1462
+ * brand name stands. A screening, never a legal clearance opinion.
1463
+ */
1464
+ brandNameScreening?: TBrandNameScreening;
1455
1465
  /**
1456
1466
  * Accepted application-declared semantic causality between whole
1457
1467
  * specification-family states. This is not the registry's physical
@@ -2332,7 +2342,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
2332
2342
  const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
2333
2343
 
2334
2344
  for (const [iIdx, icp] of snapshot.icps.entries()) {
2335
- if (icp.priority !== ICPPriority.CORE && icp.priority !== ICPPriority.EXPANSION) continue;
2345
+ if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
2336
2346
  if (positionedIcpRefs.has(icp.ref)) continue;
2337
2347
 
2338
2348
  issues.push({
@@ -2883,9 +2893,17 @@ function detectMessageTemplatePlaceholderMismatch(
2883
2893
 
2884
2894
  | Invariant | Command |
2885
2895
  |--------------------------------------------------------------------|--------------------------------------------------------------------------|
2886
- | Behavior IDs registered in the companion model | `rg -n "market-context-for-(feature\|icp)" --type ts` |
2896
+ | Behavior IDs registered in the companion model | see the commands below the table |
2887
2897
  | Handlers wired into the builtin handler map | `rg -n "buildMarketContextBlock\(" --type ts` |
2888
- | Specifications companion exports `marketSpecification` | `rg -n "marketSpecification" --type ts \| rg "companion-exports"` |
2898
+ | Specifications companion exports `marketSpecification` | see the commands below the table |
2899
+
2900
+ ```bash
2901
+ # Behavior IDs registered in the companion model
2902
+ rg -n "market-context-for-(feature|icp)" --type ts
2903
+
2904
+ # Specifications companion exports `marketSpecification`
2905
+ rg -n "marketSpecification" --type ts | rg "companion-exports"
2906
+ ```
2889
2907
 
2890
2908
  ## Common Rationalizations
2891
2909
 
@@ -541,7 +541,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
541
541
  const trimmed = value.trim();
542
542
  if (trimmed.length === 0) return undefined;
543
543
  if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
544
- throw new Error(
544
+ throw new IntrospectionInputValidationError(
545
545
  `buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
546
546
  + `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
547
547
  + `not a sentence — translation prose belongs in the LLM output, not the tag.`,
@@ -827,6 +827,8 @@ export interface SpecificationsCompanionExports<
827
827
  TIntegrationPlan = IntegrationPlan,
828
828
  // Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
829
829
  TApplicationMaturity = ApplicationMaturity,
830
+ // Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
831
+ TBrandNameScreening = BrandNameScreening,
830
832
  > {
831
833
  resourceSpecifications: TResourceSpecifications;
832
834
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -1357,6 +1359,14 @@ export interface SpecificationsCompanionExports<
1357
1359
  * never a gate. Read by the coherence report and the workbench.
1358
1360
  */
1359
1361
  applicationMaturity?: TApplicationMaturity;
1362
+ /**
1363
+ * WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
1364
+ * registers, classes and jurisdictions searched, per-register results with sources and dates, and the
1365
+ * competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
1366
+ * `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
1367
+ * brand name stands. A screening, never a legal clearance opinion.
1368
+ */
1369
+ brandNameScreening?: TBrandNameScreening;
1360
1370
  /**
1361
1371
  * Accepted application-declared semantic causality between whole
1362
1372
  * specification-family states. This is not the registry's physical
@@ -2060,7 +2070,7 @@ function detectMissingPositioningForIcp(snapshot: MarketSnapshot, issues: Market
2060
2070
  const positionedIcpRefs = new Set(snapshot.positionings.map(p => p.icpRef));
2061
2071
 
2062
2072
  for (const [iIdx, icp] of snapshot.icps.entries()) {
2063
- if (icp.priority !== ICPPriority.CORE && icp.priority !== ICPPriority.EXPANSION) continue;
2073
+ if (!TARGETED_ICP_PRIORITIES.has(icp.priority)) continue;
2064
2074
  if (positionedIcpRefs.has(icp.ref)) continue;
2065
2075
 
2066
2076
  issues.push({
@@ -134,10 +134,10 @@ intent picker (feature-scoped vs ICP-scoped sections). It is
134
134
  **never** consumed for placeholder substitution and is not gated by
135
135
  `requiredInputs[]`.
136
136
 
137
- If a required flag is missing, the renderer (subprocess) returns a
138
- typed `MarketPromptMissingRequiredInputError` with the exact missing
139
- input name — surfaces precisely on the CLI as `Market generation
140
- failed: …`. There is no "guess based on the snapshot"
137
+ If a required flag is missing, the request is refused as a bad
138
+ request naming the exact missing input — it surfaces precisely on
139
+ the CLI as `Market generation failed: …`. An unknown ref or template
140
+ name is refused the same way, with the refs the snapshot does hold. There is no "guess based on the snapshot"
141
141
  fallback by design (D17 / framework-mindset).
142
142
 
143
143
  ### Step 3 — Pick the output language
@@ -707,19 +707,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
707
707
  }
708
708
  }
709
709
 
710
- export class MarketPromptMissingRequiredInputError extends Error {
710
+ /*
711
+ * The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
712
+ * named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
713
+ * its name across the subprocess boundary: the controller answers 400 with the message instead of a
714
+ * sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
715
+ * `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
716
+ * the AUTHORED template, which no change to the request can fix.
717
+ */
718
+ export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
711
719
  public readonly missing: MarketMessageRequiredInput[];
712
720
  constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
713
721
  super(
714
722
  `Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
715
723
  + `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
716
724
  );
717
- this.name = 'MarketPromptMissingRequiredInputError';
718
725
  this.missing = missing;
719
726
  }
720
727
  }
721
728
 
722
- export class MarketPromptUnknownRefError extends Error {
729
+ export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
723
730
  public readonly entityKind: string;
724
731
  public readonly providedRef: string;
725
732
  constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
@@ -727,19 +734,17 @@ export class MarketPromptUnknownRefError extends Error {
727
734
  `No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
728
735
  + `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
729
736
  );
730
- this.name = 'MarketPromptUnknownRefError';
731
737
  this.entityKind = entityKind;
732
738
  this.providedRef = providedRef;
733
739
  }
734
740
  }
735
741
 
736
- export class MarketPromptTemplateNotFoundError extends Error {
742
+ export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
737
743
  constructor(templateRef: string, knownRefs: string[]) {
738
744
  super(
739
745
  `No MarketMessageTemplate found with ref \`${templateRef}\`. `
740
746
  + `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
741
747
  );
742
- this.name = 'MarketPromptTemplateNotFoundError';
743
748
  }
744
749
  }
745
750
 
@@ -1491,7 +1496,12 @@ above is derived from this shape).
1491
1496
  | The CLI command class is registered in the `Market` category | `rg -n "category:\\s*CommandCategory\\.Market" --type ts` |
1492
1497
  | The companion HTTP route the CLI POSTs to | `rg -n "/api/companion/market/generate" --type ts` |
1493
1498
  | The default timeout constant has not drifted | `rg -n "MARKET_COMPANION_DEFAULT_TIMEOUT_MS\\s*=\\s*90_000" --type ts` |
1494
- | The renderer's typed errors surface to the CLI | `rg -n "MarketPrompt(MissingRequiredInput\|UnknownRef\|UnknownPlaceholder\|TemplateNotFound)Error" --type ts` |
1499
+ | The renderer's typed errors surface to the CLI | see the commands below the table |
1500
+
1501
+ ```bash
1502
+ # The renderer's typed errors surface to the CLI
1503
+ rg -n "MarketPrompt(MissingRequiredInput|UnknownRef|UnknownPlaceholder|TemplateNotFound)Error" --type ts
1504
+ ```
1495
1505
 
1496
1506
  ## Common Rationalizations
1497
1507
 
@@ -529,19 +529,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
529
529
  }
530
530
  }
531
531
 
532
- export class MarketPromptMissingRequiredInputError extends Error {
532
+ /*
533
+ * The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
534
+ * named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
535
+ * its name across the subprocess boundary: the controller answers 400 with the message instead of a
536
+ * sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
537
+ * `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
538
+ * the AUTHORED template, which no change to the request can fix.
539
+ */
540
+ export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
533
541
  public readonly missing: MarketMessageRequiredInput[];
534
542
  constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
535
543
  super(
536
544
  `Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
537
545
  + `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
538
546
  );
539
- this.name = 'MarketPromptMissingRequiredInputError';
540
547
  this.missing = missing;
541
548
  }
542
549
  }
543
550
 
544
- export class MarketPromptUnknownRefError extends Error {
551
+ export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
545
552
  public readonly entityKind: string;
546
553
  public readonly providedRef: string;
547
554
  constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
@@ -549,19 +556,17 @@ export class MarketPromptUnknownRefError extends Error {
549
556
  `No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
550
557
  + `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
551
558
  );
552
- this.name = 'MarketPromptUnknownRefError';
553
559
  this.entityKind = entityKind;
554
560
  this.providedRef = providedRef;
555
561
  }
556
562
  }
557
563
 
558
- export class MarketPromptTemplateNotFoundError extends Error {
564
+ export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
559
565
  constructor(templateRef: string, knownRefs: string[]) {
560
566
  super(
561
567
  `No MarketMessageTemplate found with ref \`${templateRef}\`. `
562
568
  + `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
563
569
  );
564
- this.name = 'MarketPromptTemplateNotFoundError';
565
570
  }
566
571
  }
567
572
 
@@ -592,10 +592,18 @@ export const enterpriseProcurementAntiTargetIcp = marketIcpConfig({
592
592
  | Invariant | Command |
593
593
  |--------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
594
594
  | Every ICP file uses the typed `MarketICPConfig` contract | `rg -n ":\s+MarketICPConfig" specifications/src/market/customer-profile/icps.ts` |
595
- | Anti-target ICPs zero out `purposeMix` | `rg -n "ANTI_TARGET" -A 5 specifications/src/market/ \| rg "adoption:\s*0,\s*revenue:\s*0"` |
596
- | Geographies look like ISO codes | `rg -n "geographies:\s*\[" -A 1 specifications/src/market/ \| rg -v "'[A-Z]{2,5}'"` |
595
+ | Anti-target ICPs zero out `purposeMix` | see the commands below the table |
596
+ | Geographies look like ISO codes | see the commands below the table |
597
597
  | No localized-string shapes inside ICPs | `rg -n "LocalizedString" specifications/src/market/customer-profile/` |
598
598
 
599
+ ```bash
600
+ # Anti-target ICPs zero out `purposeMix`
601
+ rg -n "ANTI_TARGET" -A 5 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
602
+
603
+ # Geographies look like ISO codes
604
+ rg -n "geographies:\s*\[" -A 1 specifications/src/market/ | rg -v "'[A-Z]{2,5}'"
605
+ ```
606
+
599
607
  ## Common Rationalizations
600
608
 
601
609
  | Rationalization | Reality |
@@ -320,7 +320,12 @@ export const contextSwitchingCostPain: MarketPainConfig = {
320
320
  | Pains use the typed `MarketPainConfig` contract | `rg -n ":\s+MarketPainConfig" specifications/src/market/value-proposition/pains.ts` |
321
321
  | Gains use the typed `MarketGainConfig` contract | `rg -n ":\s+MarketGainConfig" specifications/src/market/value-proposition/gains.ts` |
322
322
  | Jobs use the typed `MarketJobConfig` contract | `rg -n ":\s+MarketJobConfig" specifications/src/market/customer-profile/jobs.ts` |
323
- | `weight` values stay within 1–10 | `rg -n "weight:\s*([0-9]+)" specifications/src/market/ \| rg -v "weight:\s*([1-9]\|10)\b"` |
323
+ | `weight` values stay within 1–10 | see the commands below the table |
324
+
325
+ ```bash
326
+ # `weight` values stay within 1–10
327
+ rg -n "weight:\s*([0-9]+)" specifications/src/market/ | rg -v "weight:\s*([1-9]|10)\b"
328
+ ```
324
329
 
325
330
  ## Common Rationalizations
326
331
 
@@ -367,7 +367,12 @@ export const applicationMessageTemplates: MarketMessageTemplateConfig[] = [
367
367
  |--------------------------------------------------------------------|--------------------------------------------------------------------------|
368
368
  | Templates declared on the snapshot | `rg -n "messageTemplates:" --type ts` |
369
369
  | `requiredInputs` references the enum (not raw strings) | `rg -n "MarketMessageRequiredInput\." --type ts` |
370
- | `{{output_language}}` is present in every template body | `rg -n "promptTemplate:" -A 5 --type ts \| rg "output_language"` |
370
+ | `{{output_language}}` is present in every template body | see the commands below the table |
371
+
372
+ ```bash
373
+ # `{{output_language}}` is present in every template body
374
+ rg -n "promptTemplate:" -A 5 --type ts | rg "output_language"
375
+ ```
371
376
 
372
377
  ## Common Rationalizations
373
378