@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,67 @@
1
+ # Cross-seed row references — `referenceDataSeedRow`
2
+
3
+ Read this before a seed writes a foreign key to a row ANOTHER seed creates: a demonstration contact's
4
+ customer, a quote's customer, an invoice's job, a catalog item's category.
5
+
6
+ ## Why a reference, and not a value
7
+
8
+ The engine generates every seeded row's `_id`, so no seed can write another seed's row id as a
9
+ literal. `dependsOn` only ORDERS seeds — it passes no data — and a computed `entry()` receives the
10
+ triggering row and nothing else; it cannot look rows up. A reference is the one way to say "the
11
+ `_id` of THAT row":
12
+
13
+ ```ts
14
+ customerId: referenceDataSeedRow(demoCustomersSeed, { email: 'ana.martin@example.com' })
15
+ ```
16
+
17
+ The first argument is the target seed's DEFINITION (import it from the module that declares it), so
18
+ a typo is a compile error. The second is the target row's business key, as the target resource
19
+ declares it (`isBusinessKey()` / `businessKeySet([...])`). The engine replaces the reference with the
20
+ row's `_id` before the seed writes anything.
21
+
22
+ ## The rules
23
+
24
+ | # | Rule | Enforced by |
25
+ |---|------|-------------|
26
+ | 1 | The referenced seed is listed in the referring seed's `dependsOn`. That edge is what runs it first. | `createDataSeedDefinition` refuses a static entry; a computed `entry()` fails its run with a CONFIGURATION error |
27
+ | 2 | A seed referencing a seed restricted by `allowedApplicationEnvironments` (a demonstration seed) is restricted to environments that seed runs in. Elsewhere the referenced seed is withheld and its rows never exist. | `createDataSeedDefinition` (static) and the engine (computed) |
28
+ | 3 | A seed never references its own entries. References resolve before the seed writes, so its own rows are not there yet. Split the rows into two seeds. | the factory (static) and the engine (computed) |
29
+ | 4 | When both seeds have the same scope kind, leave the scope key out of the reference. The engine fills in the scope being seeded (`organizationId` on an organization `afterCreate`), and only when the target resource's business key contains that field. | the engine |
30
+ | 5 | A reference that names ANOTHER scope's id (`organizationId: 'org-2'` while seeding `org-1`) is refused, and so is a found row that belongs to another scope — which a target keyed without its scope field can return. Either would link one tenant's row to another's. | the engine, as an unresolved reference |
31
+ | 6 | The referenced row must exist. A reference in `data` that resolves to nothing fails THAT entry: it is reported on the run (`DataSeedRun.failureReport`, status PARTIAL) and not written, and the other entries are. A reference in `businessKey` that resolves to nothing fails the WHOLE run before anything is written, because the row's identity is unknown. | the engine |
32
+
33
+ Nothing is ever written with a `null` or a placeholder foreign key.
34
+
35
+ ## Where a reference may sit
36
+
37
+ - In static `entries` and in a computed `entry()`.
38
+ - In `data` and in `businessKey` — a junction row keyed by the two ids it joins puts both
39
+ references in its business key.
40
+ - Directly as a field value, or inside nested objects and arrays (`tagIds: [ref, ref]`).
41
+ - In every mode (`ADDITIVE`, `UPGRADE`, `SYNC`, `LAZY`) and on every trigger level, including manual
42
+ reruns.
43
+
44
+ ## Reading a failure
45
+
46
+ An unresolved reference names everything needed to fix it:
47
+
48
+ ```text
49
+ seed 'crm:demo-contacts' did not write this entry: a reference in its data resolves to no row.
50
+ data.customerId → seed 'crm:demo-customers' row {"email":"ana@example.com"}:
51
+ no 'customers' row has the business key {"email":"ana@example.com","organizationId":"…"}.
52
+ ```
53
+
54
+ Check, in order: that the referenced seed ran for this scope (it is in `dependsOn`, so it ran first
55
+ in the same pass unless it failed — its own run says so), and that one of its entries has exactly
56
+ this business key.
57
+
58
+ ## Not supported
59
+
60
+ - **A seed referencing its own rows** (a category tree in one seed). Split the levels into two seeds.
61
+ - **A reference across scope kinds whose target key holds the target's scope id** — an `ORGANIZATION`
62
+ seed naming an `APPLICATION`-scoped catalog row keyed `(applicationId, code)`. The scope id is filled
63
+ in only when both seeds have the same scope kind, and a static entry cannot write the application's
64
+ id, so such a reference never resolves. Seed the linking rows at the target's scope kind, or key the
65
+ target by fields that do not include its scope.
66
+ - **A reference resolved later**, once the target appears. A reference resolves when the referring
67
+ seed runs, and fails if the row is not there then. Order the seeds with `dependsOn`.
@@ -1,12 +1,14 @@
1
1
  # Data seeding — authoring contract (source)
2
2
 
3
- The two source-anchored surfaces an app developer touches when
3
+ The source-anchored surfaces an app developer touches when
4
4
  authoring a `DataSeedDefinition`:
5
5
 
6
6
  - **`DataSeedMode`** — the four modes (`LAZY` / `ADDITIVE` / `UPGRADE` / `SYNC`); the JSDoc on each variant captures its write semantics, re-run safety, and required-field invariants.
7
7
  - **`DataSeedDefinitionInput`** — the input contract for `createDataSeedDefinition(...)`, with the cross-mode required-vs-optional summary.
8
+ - **`referenceDataSeedRow`** — the value an entry uses for a foreign key to a row ANOTHER seed writes. The engine
9
+ resolves it to that row's `_id` when the seed runs; the referenced seed must be in `dependsOn`.
8
10
 
9
- Both blocks live under the focused
11
+ All three live under the focused
10
12
  `@wildo-ai/saas-backend-lib/data-seeding-models` subpath barrel —
11
13
  import from there in seed files (NOT the package root).
12
14
 
@@ -127,11 +129,23 @@ export enum DataSeedMode {
127
129
  * dispatcher walks `fromVersion` from the persisted row's
128
130
  * `seedVersion` up to `version - 1`, then re-applies
129
131
  * `managedFields` from the declared entries.
130
- * - `dependsOn` — optional cross-seed dependency declarations (DAG
131
- * resolved at dispatch time).
132
+ * - `dependsOn` — seeds that run before this one. It orders and passes no
133
+ * data; to point an entry's foreign key at a row a dependency wrote, put
134
+ * `referenceDataSeedRow(dependencySeed, { …businessKey })` where the value
135
+ * goes, and the engine resolves it to that row's `_id` when this seed runs.
136
+ * Every referenced seed MUST be listed here.
137
+ * - `anchorEntriesToScopeForeignKey` — inject the scope's foreign key
138
+ * (`organizationId`, …) into every entry's business key, so static entries
139
+ * can be written once and seeded per scope row.
132
140
  * - `schedule` — optional cron-driven re-run binding; presence is the
133
141
  * sole opt-in signal for the engine cron batch. FORBIDDEN for
134
142
  * `mode === LAZY`.
143
+ * - `allowedApplicationEnvironments` — optional; omit for reference data the
144
+ * application needs everywhere. DEMONSTRATION data (sample rows that make a
145
+ * fresh application look lived-in) MUST declare it without `production`, e.g.
146
+ * `[RuntimeEnvironment.DEVELOPMENT, RuntimeEnvironment.STAGING]` (import
147
+ * `RuntimeEnvironment` from `@wildo-ai/saas-models`). A restricted seed is never
148
+ * registered elsewhere, and is withheld when the deployment declares no environment.
135
149
  */
136
150
  export interface DataSeedDefinitionInput extends DataSeedDefinitionAuthored, DataSeedDefinitionCallbacks {}
137
151
 
@@ -178,3 +192,139 @@ export interface DataSeedDefinition extends DataSeedDefinitionParsed, DataSeedDe
178
192
  triggers: DataSeedTrigger[];
179
193
  }
180
194
  ```
195
+
196
+ A computed `entry()` receives the triggering row and returns exactly one entry; it cannot skip a row:
197
+
198
+ ## Import Origins
199
+
200
+ - `@wildo-ai/saas-backend-lib`
201
+
202
+ ## Source Excerpts
203
+
204
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
205
+
206
+ ```typescript
207
+ *
208
+ * Function shape of a **computed** seed entry — used by a seed whose payload depends on the row that triggered it
209
+ * (an `afterCreate` seed needs that row's `_id`). Declared as a type rather than in the Zod schema, because Zod cannot
210
+ * validate what a function returns.
211
+ *
212
+ * `triggeringRow` is that row as stored, untyped (`Record<string, unknown>` with its `_id`), or `null` for a
213
+ * lazy-access seed. Narrow the fields you read yourself.
214
+ *
215
+ * The context deliberately offers no way to READ other rows. A foreign key to a
216
+ * row another seed writes is returned as `referenceDataSeedRow(targetSeed, key)`
217
+ * and resolved by the engine (the target seed must be in `dependsOn`).
218
+ *
219
+ * It returns exactly ONE entry, every time it is called: there is no "skip this row" value. A seed that should
220
+ * apply to only some triggering rows is the wrong shape; put the condition in an operation (a postfix that creates
221
+ * the row when the condition holds) instead.
222
+ */
223
+ export type DataSeedComputedEntryFn = (context: {
224
+ /**
225
+ * The resource row whose lifecycle event fired the seed (Level B only).
226
+ * Always present for `triggerKind: 'resourceLifecycle'`. `null` for lazy
227
+ * access seeds where there is no triggering row.
228
+ */
229
+ triggeringRow: { _id: string } & Record<string, unknown> | null;
230
+ /**
231
+ * Who caused the run, for attribution only: the seed itself always runs as an internal request, whoever triggered
232
+ * it. `triggeredByUserId` is recorded in the row's `__seed` metadata and in the `DataSeedRun` ledger.
233
+ */
234
+ executionContext: {
235
+ triggeredByUserId: string | null;
236
+ };
237
+ }) => DataSeedStaticEntry | Promise<DataSeedStaticEntry>;
238
+ ```
239
+
240
+ ## Import Origins
241
+
242
+ - `@wildo-ai/saas-backend-lib`
243
+
244
+ ## Source Excerpts
245
+
246
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
247
+
248
+ ```typescript
249
+ /**
250
+ * What a reference needs to know about the seed whose row it names. A whole `DataSeedDefinition` satisfies it — pass
251
+ * the target seed's definition, imported from the module that declares it.
252
+ */
253
+ export type DataSeedRowReferenceTarget = Pick<DataSeedDefinition, 'seedKey' | 'resourceType' | 'scope' | 'allowedApplicationEnvironments'>;
254
+
255
+ /**
256
+ * A reference to a row another seed writes, placed where a foreign-key VALUE goes in an entry's `businessKey` or
257
+ * `data` (directly, or inside a nested object or array). The engine replaces it with the row's `_id` before writing.
258
+ *
259
+ * Build it with {@link referenceDataSeedRow}; never construct one by hand.
260
+ */
261
+ export class DataSeedRowReference {
262
+ /** Brand read by {@link isDataSeedRowReference}. */
263
+ public readonly [DATA_SEED_ROW_REFERENCE_BRAND]: true = true;
264
+
265
+ /** @internal — use {@link referenceDataSeedRow}. */
266
+ public constructor(
267
+ /** The seed that writes the referenced row. Must be in the referring seed's `dependsOn`. */
268
+ public readonly target: DataSeedRowReferenceTarget,
269
+ /**
270
+ * The referenced row's business key, as the target resource declares it. The scope's own foreign key may be left
271
+ * out when both seeds share a scope kind; the engine fills it in from the scope being seeded.
272
+ */
273
+ public readonly businessKey: Readonly<Record<string, unknown>>,
274
+ ) {
275
+ Object.freeze(this);
276
+ }
277
+
278
+ /** What a log line or a JSON dump shows instead of an empty object (the brand is a symbol, which JSON drops). */
279
+ public toJSON(): string {
280
+ return describeDataSeedRowReference(this);
281
+ }
282
+ }
283
+
284
+ /**
285
+ * Reference the row a `dependsOn` seed writes, by that row's business key.
286
+ *
287
+ * @param target The seed that writes the row — its definition, as returned by `createDataSeedDefinition`.
288
+ * @param businessKey The row's business key. Leave out the scope foreign key (`organizationId`, `userId`, …) when the
289
+ * target seed has the same scope kind as the referring seed: the engine fills it from the scope being seeded.
290
+ * @throws Error when `target` has no `seedKey`, when `businessKey` is not a plain object, or when a business-key value
291
+ * is `undefined` or is itself a reference.
292
+ *
293
+ * @example
294
+ * ```ts
295
+ * import { referenceDataSeedRow } from '@wildo-ai/saas-backend-lib/data-seeding-models';
296
+ * import demoCustomersSeed from './crm.demo-customers.seed';
297
+ *
298
+ * // In a seed declaring dependsOn: [{ seedKey: demoCustomersSeed.seedKey }]
299
+ * data: { customerId: referenceDataSeedRow(demoCustomersSeed, { email: 'ana.martin@example.com' }) }
300
+ * ```
301
+ */
302
+ export function referenceDataSeedRow(
303
+ target: DataSeedRowReferenceTarget,
304
+ businessKey: Record<string, unknown>,
305
+ ): DataSeedRowReference {
306
+ if (target === null || typeof target !== 'object' || typeof target.seedKey !== 'string' || target.seedKey.length === 0) {
307
+ throw new Error('referenceDataSeedRow: `target` must be the referenced seed\'s definition (a value carrying its `seedKey`, `resourceType` and `scope`).');
308
+ }
309
+ if (!isPlainObject(businessKey)) {
310
+ throw new Error(`referenceDataSeedRow: the business key of a reference to seed '${target.seedKey}' must be a plain object.`);
311
+ }
312
+ for (const [field, value] of Object.entries(businessKey)) {
313
+ if (value === undefined) {
314
+ throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is undefined — a business key is identity; use null for a genuinely-nullable field.`);
315
+ }
316
+ if (containsDataSeedRowReference(value)) {
317
+ throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is itself a reference — a reference names its row by literal values.`);
318
+ }
319
+ }
320
+ return new DataSeedRowReference(
321
+ {
322
+ seedKey: target.seedKey,
323
+ resourceType: target.resourceType,
324
+ scope: target.scope,
325
+ ...(target.allowedApplicationEnvironments !== undefined ? { allowedApplicationEnvironments: target.allowedApplicationEnvironments } : {}),
326
+ },
327
+ Object.freeze({ ...businessKey }),
328
+ );
329
+ }
330
+ ```
@@ -0,0 +1,22 @@
1
+ # The `__seed` overlay — field names
2
+
3
+ Read this when a test, a log or a stored row shows a seeded row's `__seed` block. Authors never read
4
+ or write the overlay; the engine owns it.
5
+
6
+ **Note on overlay field names** (audit L1-7, post-Phase-7
7
+ close-out): the `__seed` overlay tracks **`managedSince`**
8
+ (the wall-clock `Date` at which the framework first stamped
9
+ the row — preserved across subsequent passes by
10
+ `buildDataSeedRowMetadataForUpsert`, and only re-set when the
11
+ row is created). It does NOT carry `mode`, `runId`, or
12
+ `seededAt` — earlier drafts
13
+ of this guide and some forum discussions referenced those
14
+ names as if they were persisted on the row. They are NOT:
15
+ `mode` lives on the seed definition (not the row), `runId`
16
+ lives on `DataSeedRun` (one row per pass, not per seeded
17
+ document), and `seededAt` was renamed to `managedSince`
18
+ early in the design to clarify the "first-stamp wall-clock"
19
+ semantic. Authors should never need to read or write any of
20
+ these — the overlay is dispatcher-private — but the naming
21
+ matters for tests and for the `data-seed-row-metadata.shared.schemas.ts`
22
+ source file.
@@ -641,7 +641,13 @@ export function wireDataSeedingDeclarations(
641
641
  * of the collision a reader can act on.
642
642
  */
643
643
  const engineOwned = registersEngineOwnedSeeds ? ENGINE_OWNED_DATA_SEEDS : [];
644
- const seeds = [...engineOwned, ...(dataSeeds ?? [])];
644
+ /*
645
+ * Admitted over the MERGED list (#2234), so a restricted seed is withheld at registration whoever owns it — the
646
+ * promise `allowedApplicationEnvironments` makes. The application's own seeds were already admitted where
647
+ * `start-application` took them (its seeding gates read that set); re-admitting them here is idempotent, and it is
648
+ * what reaches the engine's.
649
+ */
650
+ const seeds = admitDataSeedsForApplicationEnvironment([...engineOwned, ...(dataSeeds ?? [])], readDeclaredApplicationEnvironment(process.env)).admitted;
645
651
  logDebug('🌱 Registering data-seed definitions...', {
646
652
  count: seeds.length,
647
653
  engineOwned: engineOwned.length,
@@ -264,3 +264,46 @@ export enum EngineSettingsDestinationRef {
264
264
  * grant and says so. Neither becomes placeable by widening the operation that is already there.
265
265
  */
266
266
  ```
267
+
268
+ ## Who sees an engine destination
269
+
270
+ The engine decides, through the destination's own `requiredRoles`; your placement cannot widen or narrow it. Three
271
+ tiers, from these two role sets:
272
+
273
+ ## Import Origins
274
+
275
+ - `@wildo-ai/saas-frontend-lib`
276
+
277
+ ## Source Excerpts
278
+
279
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
280
+
281
+ ```typescript
282
+ /** Org-management destinations are visible to organization owners and admins. */
283
+ const ORG_MANAGEMENT_ROLES: string[] = [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN];
284
+
285
+ /**
286
+ * Application-administration destinations are visible to the application's own super-administrator.
287
+ *
288
+ * ONE role, deliberately, and not the wider `APP_ADMIN_*` family: every destination gated with this
289
+ * is a surface whose resource ALSO requires `APP_ADMIN_SUPER_ADMIN` server-side, so admitting
290
+ * `APP_ADMIN_VIEWER` or `APP_ADMIN_BILLING_MANAGER` here would render a rail entry that answers 403
291
+ * on open — worse than absent, because it reads as a permission the operator has and a bug they hit.
292
+ * Widen this only alongside the operation roles it would then have to match.
293
+ */
294
+ const APPLICATION_ADMINISTRATION_ROLES: string[] = [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN];
295
+ ```
296
+
297
+ - **Personal destinations** (`profile`, `security`, `preferences`, `appearance`, your invitations, your own provider
298
+ credentials) have no `requiredRoles`: every signed-in user sees them.
299
+ - **Organization destinations** (general, members, billing, SSO, webhooks, API keys, audit logs, …) are for the
300
+ organization's owners and admins. A few are narrower, owner-only (legal holds, referrals), and one is wider: the
301
+ organization's entitlements, which every member sees.
302
+ - **Application destinations** (`application-*`, and `billing-catalog`) are for the application's super-administrator;
303
+ the application audit and retention-enforcement destinations also admit the audit-evidence reader.
304
+
305
+ The role match is exact: a custom role that inherits `ORG_ADMIN` does not see an organization destination unless it is
306
+ listed itself.
307
+
308
+ So placing an organization destination on a rail that ordinary members open shows them nothing there. That is
309
+ expected, not a misplacement.
@@ -128,8 +128,8 @@ export interface SettingsDestination {
128
128
  ref: string;
129
129
  /** What the destination renders in its content panel. */
130
130
  target: SettingsSectionTarget;
131
- /** Declarative runtime capability gating (same contract as launcher items). */
132
- runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
131
+ /** Declarative runtime capability gating (launcher items' `requiredCapabilities`; roles are `requiredRoles`). */
132
+ runtimeAvailability?: SettingsRuntimeAvailabilityConfig;
133
133
  /** Feature flags required to surface this destination (plan/subscription gating). */
134
134
  requiredFeatures?: RequiredFeaturesConfig;
135
135
  /** RBAC roles required to surface this destination (OR semantics). */
@@ -360,7 +360,12 @@ Run from the repo root, substituting `<spec-export>` and `<slug>`:
360
360
  | Companion exports uses the typed contract | `rg -n "SpecificationsCompanionExports<" specifications/src/companion-exports.ts` |
361
361
  | **No deep package-internal imports** (must be empty) | `rg -n "from\s+'\.\.\/\.\.\/\.\.\/" specifications/src/companion-exports.ts` |
362
362
  | **No hand-built spec maps** (every slot is a single barrel import) | `rg -n "Specifications:\s+\{" specifications/src/companion-exports.ts` (must be 0 — every slot reads from a barrel name, not an inline literal) |
363
- | Each spec family barrel has an `index.ts` | `rg --files specifications/src/modules/<slug>/ \| rg "index\.ts$"` |
363
+ | Each spec family barrel has an `index.ts` | see the commands below the table |
364
+
365
+ ```bash
366
+ # Each spec family barrel has an `index.ts`
367
+ rg --files specifications/src/modules/<slug>/ | rg "index\.ts$"
368
+ ```
364
369
 
365
370
  The high-signal invariant is **"spec is exported from its family
366
371
  barrel AND lands in `companion-exports.ts`"** — a spec that shows up
@@ -121,6 +121,8 @@ export interface SpecificationsCompanionExports<
121
121
  TIntegrationPlan = IntegrationPlan,
122
122
  // Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
123
123
  TApplicationMaturity = ApplicationMaturity,
124
+ // Appended STRICTLY LAST: the screened brand-name candidates the brand-identity interview chooses from.
125
+ TBrandNameScreening = BrandNameScreening,
124
126
  > {
125
127
  resourceSpecifications: TResourceSpecifications;
126
128
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -651,6 +653,14 @@ export interface SpecificationsCompanionExports<
651
653
  * never a gate. Read by the coherence report and the workbench.
652
654
  */
653
655
  applicationMaturity?: TApplicationMaturity;
656
+ /**
657
+ * WHICH NAMES were proposed for the brand and what a minimal trademark screening of each found —
658
+ * registers, classes and jurisdictions searched, per-register results with sources and dates, and the
659
+ * competitor collisions beside them. Produced by `top_down.brand-naming`; the brand-identity interview's
660
+ * `brand-name` CHOICE is computed from it, and the coherence report reads it to say where the chosen
661
+ * brand name stands. A screening, never a legal clearance opinion.
662
+ */
663
+ brandNameScreening?: TBrandNameScreening;
654
664
  /**
655
665
  * Accepted application-declared semantic causality between whole
656
666
  * specification-family states. This is not the registry's physical
@@ -300,10 +300,18 @@ Run from the repo root, substituting `<componentRef>`:
300
300
  | Spec uses the typed factory | `rg -n "frontendComponentSpecification\(" specifications/src/modules/<slug>/frontend-components/` |
301
301
  | `componentRef` uses the typed enum | `rg -n "componentRef:\s+FrontendComponentType\." specifications/src/modules/<slug>/frontend-components/<componentRef>.frontend-component.specification.ts` |
302
302
  | **No string-literal componentRef** (must be empty) | `rg -n "componentRef:\s+'" specifications/src/modules/<slug>/frontend-components/` |
303
- | Every prop has a `valueKind` | `rg -n "propName:\s+'" specifications/src/modules/<slug>/frontend-components/<componentRef>.frontend-component.specification.ts -A 3 \| rg "valueKind:"` |
304
- | Every ENUM prop has an `enumerationSource` | `rg -n "valueKind:\s+FrontendComponentPropValueKind\.ENUM" specifications/src/modules/<slug>/frontend-components/<componentRef>.frontend-component.specification.ts -A 8 \| rg "enumerationSource:"` |
303
+ | Every prop has a `valueKind` | see the commands below the table |
304
+ | Every ENUM prop has an `enumerationSource` | see the commands below the table |
305
305
  | Spec re-exported from companion bundle | `rg -n "<componentRef>FrontendComponentSpecification" specifications/src/companion-exports.ts` |
306
306
 
307
+ ```bash
308
+ # Every prop has a `valueKind`
309
+ rg -n "propName:\s+'" specifications/src/modules/<slug>/frontend-components/<componentRef>.frontend-component.specification.ts -A 3 | rg "valueKind:"
310
+
311
+ # Every ENUM prop has an `enumerationSource`
312
+ rg -n "valueKind:\s+FrontendComponentPropValueKind\.ENUM" specifications/src/modules/<slug>/frontend-components/<componentRef>.frontend-component.specification.ts -A 8 | rg "enumerationSource:"
313
+ ```
314
+
307
315
  The high-signal invariant is **"every ENUM prop has an
308
316
  `enumerationSource`"** — a typed enum reference is what lets
309
317
  companion / codegen follow the prop vocabulary back to its declaration
@@ -248,8 +248,8 @@ Run from the app root, substituting `<slug>` and `<view-ref>`:
248
248
  | Spec uses the typed factory (no raw object) | `rg -n "compositeViewSpecificationFromDefinition\(" specifications/src/modules/<slug>/composite-views/` |
249
249
  | `translationRef` uses the typed builder | `rg -n "translationRef:\s+build\w+CompositeViewTranslationRef\(" specifications/src/modules/<slug>/composite-views/<view-ref>.composite-view.specification.ts` |
250
250
  | **No hand-written translation ref** (must be empty) | `rg -n "translationRef:\s+'" specifications/src/modules/<slug>/composite-views/` |
251
- | `sectionRefs` declared in spec | `rg -oN "sectionRefs:\s+\[\K[^\]]+" specifications/src/modules/<slug>/composite-views/<view-ref>.composite-view.specification.ts` |
252
- | `<Section name>` declared in JSX (must be the same set as `sectionRefs`) | `rg -oN "<Section\s+name=\"\K[^\"]+" frontend/src/modules/<slug>/**/*CompositeView.tsx` |
251
+ | `sectionRefs` declared in spec | `rg -P -oN "sectionRefs:\s+\[\K[^\]]+" specifications/src/modules/<slug>/composite-views/<view-ref>.composite-view.specification.ts` |
252
+ | `<Section name>` declared in JSX (must be the same set as `sectionRefs`) | `rg -P -oN "<Section\s+name=\"\K[^\"]+" frontend/src/modules/<slug>/**/*CompositeView.tsx` |
253
253
  | Spec re-exported from companion bundle | `rg -n "<view-ref>CompositeViewSpecification" specifications/src/companion-exports.ts` |
254
254
 
255
255
  The high-signal invariant is the **`sectionRefs` ↔ `<Section name>` set