@tailor-platform/erp-kit 0.2.1 → 0.3.0

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 (633) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +154 -80
  3. package/dist/cli.mjs +1742 -0
  4. package/package.json +16 -14
  5. package/schemas/app-compose/story.yml +12 -0
  6. package/schemas/module/command.yml +9 -0
  7. package/schemas/module/module.yml +4 -0
  8. package/schemas/module/query.yml +9 -0
  9. package/skills/erp-kit-app-1-requirements/SKILL.md +22 -11
  10. package/skills/erp-kit-app-2-requirements-review/SKILL.md +103 -0
  11. package/skills/erp-kit-app-2-requirements-review/references/best-practices-check.md +71 -0
  12. package/skills/erp-kit-app-2-requirements-review/references/boundary-consistency-check.md +74 -0
  13. package/skills/erp-kit-app-2-requirements-review/references/requirements-report-format.md +25 -0
  14. package/skills/erp-kit-app-3-plan/SKILL.md +154 -0
  15. package/skills/erp-kit-app-3-plan/references/resolver-extraction.md +89 -0
  16. package/skills/erp-kit-app-3-plan/references/screen-extraction.md +74 -0
  17. package/skills/erp-kit-app-3-plan/references/story-extraction.md +86 -0
  18. package/skills/erp-kit-app-4-plan-review/SKILL.md +168 -0
  19. package/skills/erp-kit-app-4-plan-review/references/actor-flow-parity.md +73 -0
  20. package/skills/erp-kit-app-4-plan-review/references/business-flow-story-parity.md +86 -0
  21. package/skills/erp-kit-app-4-plan-review/references/orphan-detection.md +69 -0
  22. package/skills/erp-kit-app-4-plan-review/references/parity-report-format.md +52 -0
  23. package/skills/erp-kit-app-4-plan-review/references/story-resolver-parity.md +83 -0
  24. package/skills/erp-kit-app-4-plan-review/references/story-screen-parity.md +73 -0
  25. package/skills/erp-kit-app-5-impl-backend/SKILL.md +98 -0
  26. package/skills/erp-kit-app-5-impl-backend/references/app-config.md +38 -0
  27. package/skills/erp-kit-app-5-impl-backend/references/module-wiring.md +48 -0
  28. package/skills/erp-kit-app-5-impl-backend/references/resolver-patterns.md +68 -0
  29. package/skills/erp-kit-app-6-impl-frontend/SKILL.md +74 -0
  30. package/skills/{erp-kit-app-5-implementation/references/frontend.md → erp-kit-app-6-impl-frontend/references/pages.md} +8 -90
  31. package/skills/erp-kit-app-7-impl-review/SKILL.md +176 -0
  32. package/skills/erp-kit-app-7-impl-review/references/impl-parity-report-format.md +52 -0
  33. package/skills/erp-kit-app-7-impl-review/references/module-wiring-parity.md +84 -0
  34. package/skills/erp-kit-app-7-impl-review/references/resolver-doc-code-parity.md +86 -0
  35. package/skills/erp-kit-app-7-impl-review/references/screen-doc-code-parity.md +86 -0
  36. package/skills/erp-kit-app-shared/SKILL.md +15 -0
  37. package/skills/erp-kit-app-shared/references/link-format-reference.md +13 -0
  38. package/skills/erp-kit-app-shared/references/naming-conventions.md +21 -0
  39. package/skills/erp-kit-app-shared/references/resolver-classification.md +23 -0
  40. package/skills/erp-kit-app-shared/references/schema-constraints.md +25 -0
  41. package/skills/erp-kit-module-1-requirements/SKILL.md +126 -0
  42. package/skills/erp-kit-module-1-requirements/references/boundary-analysis.md +51 -0
  43. package/skills/erp-kit-module-1-requirements/references/erp-research.md +57 -0
  44. package/skills/erp-kit-module-1-requirements/references/feature-doc.md +61 -0
  45. package/skills/erp-kit-module-2-requirements-review/SKILL.md +112 -0
  46. package/skills/erp-kit-module-2-requirements-review/references/best-practices-check.md +79 -0
  47. package/skills/erp-kit-module-2-requirements-review/references/boundary-consistency-check.md +70 -0
  48. package/skills/erp-kit-module-2-requirements-review/references/requirements-report-format.md +25 -0
  49. package/skills/erp-kit-module-3-plan/SKILL.md +107 -0
  50. package/skills/erp-kit-module-3-plan/references/command-extraction.md +87 -0
  51. package/skills/erp-kit-module-3-plan/references/model-extraction.md +72 -0
  52. package/skills/{erp-kit-module-2-feature-breakdown → erp-kit-module-3-plan}/references/naming.md +15 -1
  53. package/skills/erp-kit-module-3-plan/references/query-extraction.md +59 -0
  54. package/skills/erp-kit-module-4-plan-review/SKILL.md +158 -0
  55. package/skills/erp-kit-module-4-plan-review/references/command-model-consistency.md +46 -0
  56. package/skills/erp-kit-module-4-plan-review/references/feature-command-parity.md +97 -0
  57. package/skills/erp-kit-module-4-plan-review/references/feature-model-parity.md +47 -0
  58. package/skills/erp-kit-module-4-plan-review/references/feature-query-parity.md +70 -0
  59. package/skills/erp-kit-module-4-plan-review/references/parity-report-format.md +52 -0
  60. package/skills/erp-kit-module-5-impl/SKILL.md +120 -0
  61. package/skills/erp-kit-module-5-impl/references/command-impl.md +68 -0
  62. package/skills/erp-kit-module-5-impl/references/exports.md +10 -0
  63. package/skills/{erp-kit-module-4-tdd → erp-kit-module-5-impl}/references/generated-code.md +2 -2
  64. package/skills/erp-kit-module-5-impl/references/model-impl.md +45 -0
  65. package/skills/erp-kit-module-5-impl/references/query-impl.md +53 -0
  66. package/skills/erp-kit-module-6-impl-review/SKILL.md +187 -0
  67. package/skills/erp-kit-module-6-impl-review/references/command-doc-code-parity.md +92 -0
  68. package/skills/erp-kit-module-6-impl-review/references/command-doc-test-parity.md +93 -0
  69. package/skills/erp-kit-module-6-impl-review/references/error-implementation-parity.md +95 -0
  70. package/skills/{erp-kit-module-5-impl-review → erp-kit-module-6-impl-review}/references/errors.md +2 -2
  71. package/skills/erp-kit-module-6-impl-review/references/impl-parity-report-format.md +52 -0
  72. package/skills/erp-kit-module-6-impl-review/references/model-doc-code-parity.md +80 -0
  73. package/skills/erp-kit-module-shared/SKILL.md +1 -1
  74. package/skills/erp-kit-module-shared/references/commands.md +1 -1
  75. package/skills/erp-kit-module-shared/references/errors.md +13 -10
  76. package/skills/erp-kit-module-shared/references/queries.md +110 -37
  77. package/skills/erp-kit-module-shared/references/structure.md +1 -1
  78. package/skills/erp-kit-module-shared/references/testing.md +10 -0
  79. package/skills/erp-kit-update/SKILL.md +4 -4
  80. package/src/app.ts +1 -1
  81. package/src/commands/app/index.ts +57 -24
  82. package/src/commands/check.ts +1 -1
  83. package/src/commands/generate-doc.test.ts +63 -0
  84. package/src/commands/generate-doc.ts +98 -0
  85. package/src/commands/index.ts +16 -5
  86. package/src/commands/init-module.test.ts +43 -0
  87. package/src/commands/init-module.ts +74 -0
  88. package/src/commands/init.test.ts +22 -69
  89. package/src/commands/init.ts +28 -115
  90. package/src/commands/lib/distribute.test.ts +126 -0
  91. package/src/commands/lib/distribute.ts +129 -0
  92. package/src/commands/module/generate.ts +33 -13
  93. package/src/commands/module/index.ts +18 -28
  94. package/src/commands/parse-doc-test-cases.ts +55 -0
  95. package/src/commands/sync-check.test.ts +173 -0
  96. package/src/commands/sync-check.ts +103 -2
  97. package/src/commands/update.test.ts +87 -0
  98. package/src/commands/update.ts +41 -0
  99. package/src/generator/generate-code-boilerplate.test.ts +142 -0
  100. package/src/generator/generate-code.test.ts +47 -12
  101. package/src/generator/generate-code.ts +123 -20
  102. package/src/integration.test.ts +3 -3
  103. package/src/module.ts +14 -97
  104. package/src/modules/item-management/README.md +8 -0
  105. package/src/modules/item-management/command/activateItem.generated.ts +1 -1
  106. package/src/modules/item-management/command/activateItem.test.ts +12 -18
  107. package/src/modules/item-management/command/activateItem.ts +9 -5
  108. package/src/modules/item-management/command/assignItemToTaxonomy.generated.ts +1 -1
  109. package/src/modules/item-management/command/assignItemToTaxonomy.test.ts +10 -24
  110. package/src/modules/item-management/command/assignItemToTaxonomy.ts +19 -16
  111. package/src/modules/item-management/command/createItem.generated.ts +1 -1
  112. package/src/modules/item-management/command/createItem.test.ts +11 -11
  113. package/src/modules/item-management/command/createItem.ts +16 -7
  114. package/src/modules/item-management/command/createTaxonomyNode.generated.ts +1 -1
  115. package/src/modules/item-management/command/createTaxonomyNode.test.ts +9 -9
  116. package/src/modules/item-management/command/createTaxonomyNode.ts +33 -14
  117. package/src/modules/item-management/command/deactivateItem.generated.ts +1 -1
  118. package/src/modules/item-management/command/deactivateItem.test.ts +12 -18
  119. package/src/modules/item-management/command/deactivateItem.ts +9 -5
  120. package/src/modules/item-management/command/deleteItem.generated.ts +1 -1
  121. package/src/modules/item-management/command/deleteItem.test.ts +10 -16
  122. package/src/modules/item-management/command/deleteItem.ts +9 -5
  123. package/src/modules/item-management/command/deleteTaxonomyNode.generated.ts +1 -1
  124. package/src/modules/item-management/command/deleteTaxonomyNode.test.ts +10 -16
  125. package/src/modules/item-management/command/deleteTaxonomyNode.ts +22 -12
  126. package/src/modules/item-management/command/moveTaxonomyNode.generated.ts +1 -1
  127. package/src/modules/item-management/command/moveTaxonomyNode.test.ts +10 -10
  128. package/src/modules/item-management/command/moveTaxonomyNode.ts +63 -19
  129. package/src/modules/item-management/command/reactivateItem.generated.ts +1 -1
  130. package/src/modules/item-management/command/reactivateItem.test.ts +12 -18
  131. package/src/modules/item-management/command/reactivateItem.ts +9 -5
  132. package/src/modules/item-management/command/removeItemFromTaxonomy.generated.ts +1 -1
  133. package/src/modules/item-management/command/removeItemFromTaxonomy.test.ts +9 -16
  134. package/src/modules/item-management/command/removeItemFromTaxonomy.ts +11 -6
  135. package/src/modules/item-management/command/updateItem.generated.ts +1 -1
  136. package/src/modules/item-management/command/updateItem.test.ts +16 -16
  137. package/src/modules/item-management/command/updateItem.ts +11 -6
  138. package/src/modules/item-management/command/updateTaxonomyNode.generated.ts +1 -1
  139. package/src/modules/item-management/command/updateTaxonomyNode.test.ts +14 -20
  140. package/src/modules/item-management/command/updateTaxonomyNode.ts +9 -6
  141. package/src/modules/item-management/docs/commands/ActivateItem.md +8 -0
  142. package/src/modules/item-management/docs/commands/AssignItemToTaxonomy.md +7 -0
  143. package/src/modules/item-management/docs/commands/CreateItem.md +10 -0
  144. package/src/modules/item-management/docs/commands/CreateTaxonomyNode.md +9 -0
  145. package/src/modules/item-management/docs/commands/DeactivateItem.md +8 -0
  146. package/src/modules/item-management/docs/commands/DeleteItem.md +7 -0
  147. package/src/modules/item-management/docs/commands/DeleteTaxonomyNode.md +7 -0
  148. package/src/modules/item-management/docs/commands/MoveTaxonomyNode.md +10 -0
  149. package/src/modules/item-management/docs/commands/ReactivateItem.md +8 -0
  150. package/src/modules/item-management/docs/commands/RemoveItemFromTaxonomy.md +5 -0
  151. package/src/modules/item-management/docs/commands/UpdateItem.md +15 -0
  152. package/src/modules/item-management/docs/commands/UpdateTaxonomyNode.md +9 -0
  153. package/src/modules/item-management/docs/queries/CalculateNodeDepth.md +8 -0
  154. package/src/modules/item-management/docs/queries/CalculateSubtreeDepth.md +7 -0
  155. package/src/modules/item-management/docs/queries/DetectCircularReference.md +9 -0
  156. package/src/modules/item-management/docs/queries/GetItem.md +9 -0
  157. package/src/modules/item-management/docs/queries/GetItemTaxonomyAssignment.md +5 -0
  158. package/src/modules/item-management/docs/queries/GetTaxonomyNode.md +7 -0
  159. package/src/modules/item-management/docs/queries/GetTaxonomyNodeAssignments.md +5 -0
  160. package/src/modules/item-management/docs/queries/GetTaxonomyNodeChildren.md +6 -0
  161. package/src/modules/item-management/index.ts +0 -51
  162. package/src/modules/item-management/lib/errors.generated.ts +24 -24
  163. package/src/modules/item-management/lib/permissions.generated.ts +1 -1
  164. package/src/modules/item-management/lib/types.ts +1 -1
  165. package/src/modules/item-management/module.ts +1 -1
  166. package/src/modules/item-management/query/calculateNodeDepth.generated.ts +1 -1
  167. package/src/modules/item-management/query/calculateNodeDepth.test.ts +21 -6
  168. package/src/modules/item-management/query/calculateNodeDepth.ts +2 -2
  169. package/src/modules/item-management/query/calculateSubtreeDepth.generated.ts +1 -1
  170. package/src/modules/item-management/query/calculateSubtreeDepth.test.ts +17 -5
  171. package/src/modules/item-management/query/calculateSubtreeDepth.ts +2 -2
  172. package/src/modules/item-management/query/detectCircularReference.generated.ts +1 -1
  173. package/src/modules/item-management/query/detectCircularReference.test.ts +25 -7
  174. package/src/modules/item-management/query/detectCircularReference.ts +4 -4
  175. package/src/modules/item-management/query/getItem.generated.ts +1 -1
  176. package/src/modules/item-management/query/getItem.test.ts +25 -7
  177. package/src/modules/item-management/query/getItem.ts +2 -2
  178. package/src/modules/item-management/query/getItemTaxonomyAssignment.generated.ts +1 -1
  179. package/src/modules/item-management/query/getItemTaxonomyAssignment.test.ts +9 -3
  180. package/src/modules/item-management/query/getItemTaxonomyAssignment.ts +2 -2
  181. package/src/modules/item-management/query/getTaxonomyNode.generated.ts +1 -1
  182. package/src/modules/item-management/query/getTaxonomyNode.test.ts +17 -5
  183. package/src/modules/item-management/query/getTaxonomyNode.ts +2 -2
  184. package/src/modules/item-management/query/getTaxonomyNodeAssignments.generated.ts +1 -1
  185. package/src/modules/item-management/query/getTaxonomyNodeAssignments.test.ts +9 -3
  186. package/src/modules/item-management/query/getTaxonomyNodeAssignments.ts +2 -2
  187. package/src/modules/item-management/query/getTaxonomyNodeChildren.generated.ts +1 -1
  188. package/src/modules/item-management/query/getTaxonomyNodeChildren.test.ts +13 -4
  189. package/src/modules/item-management/query/getTaxonomyNodeChildren.ts +2 -2
  190. package/src/modules/item-management/tailor.config.ts +6 -4
  191. package/src/modules/item-management/tailor.d.ts +13 -0
  192. package/src/modules/primitives/README.md +8 -0
  193. package/src/modules/primitives/command/activateCategory.generated.ts +1 -1
  194. package/src/modules/primitives/command/activateCategory.test.ts +8 -18
  195. package/src/modules/primitives/command/activateCategory.ts +9 -5
  196. package/src/modules/primitives/command/activateCurrency.generated.ts +1 -1
  197. package/src/modules/primitives/command/activateCurrency.test.ts +8 -18
  198. package/src/modules/primitives/command/activateCurrency.ts +9 -5
  199. package/src/modules/primitives/command/activateUnit.generated.ts +1 -1
  200. package/src/modules/primitives/command/activateUnit.test.ts +8 -15
  201. package/src/modules/primitives/command/activateUnit.ts +9 -5
  202. package/src/modules/primitives/command/createCategory.generated.ts +1 -1
  203. package/src/modules/primitives/command/createCategory.test.ts +29 -44
  204. package/src/modules/primitives/command/createCategory.ts +9 -5
  205. package/src/modules/primitives/command/createCurrency.generated.ts +1 -1
  206. package/src/modules/primitives/command/createCurrency.test.ts +53 -78
  207. package/src/modules/primitives/command/createCurrency.ts +9 -6
  208. package/src/modules/primitives/command/createExchangeRate.generated.ts +1 -1
  209. package/src/modules/primitives/command/createExchangeRate.test.ts +59 -97
  210. package/src/modules/primitives/command/createExchangeRate.ts +13 -7
  211. package/src/modules/primitives/command/createUnit.generated.ts +1 -1
  212. package/src/modules/primitives/command/createUnit.test.ts +59 -90
  213. package/src/modules/primitives/command/createUnit.ts +9 -6
  214. package/src/modules/primitives/command/deactivateCategory.generated.ts +1 -1
  215. package/src/modules/primitives/command/deactivateCategory.test.ts +15 -33
  216. package/src/modules/primitives/command/deactivateCategory.ts +9 -5
  217. package/src/modules/primitives/command/deactivateCurrency.generated.ts +1 -1
  218. package/src/modules/primitives/command/deactivateCurrency.test.ts +12 -26
  219. package/src/modules/primitives/command/deactivateCurrency.ts +9 -5
  220. package/src/modules/primitives/command/deactivateUnit.generated.ts +1 -1
  221. package/src/modules/primitives/command/deactivateUnit.test.ts +15 -30
  222. package/src/modules/primitives/command/deactivateUnit.ts +14 -7
  223. package/src/modules/primitives/command/setBaseCurrency.generated.ts +1 -1
  224. package/src/modules/primitives/command/setBaseCurrency.test.ts +18 -40
  225. package/src/modules/primitives/command/setBaseCurrency.ts +15 -7
  226. package/src/modules/primitives/command/setReferenceUnit.generated.ts +1 -1
  227. package/src/modules/primitives/command/setReferenceUnit.test.ts +22 -44
  228. package/src/modules/primitives/command/setReferenceUnit.ts +21 -9
  229. package/src/modules/primitives/docs/commands/ActivateCategory.md +6 -0
  230. package/src/modules/primitives/docs/commands/ActivateCurrency.md +6 -0
  231. package/src/modules/primitives/docs/commands/ActivateUnit.md +6 -0
  232. package/src/modules/primitives/docs/commands/CreateCategory.md +6 -0
  233. package/src/modules/primitives/docs/commands/CreateCurrency.md +10 -0
  234. package/src/modules/primitives/docs/commands/CreateExchangeRate.md +11 -0
  235. package/src/modules/primitives/docs/commands/CreateUnit.md +10 -0
  236. package/src/modules/primitives/docs/commands/DeactivateCategory.md +7 -0
  237. package/src/modules/primitives/docs/commands/DeactivateCurrency.md +7 -0
  238. package/src/modules/primitives/docs/commands/DeactivateUnit.md +7 -0
  239. package/src/modules/primitives/docs/commands/SetBaseCurrency.md +7 -0
  240. package/src/modules/primitives/docs/commands/SetReferenceUnit.md +7 -0
  241. package/src/modules/primitives/docs/queries/ConvertAmount.md +14 -0
  242. package/src/modules/primitives/docs/queries/ConvertQuantity.md +13 -0
  243. package/src/modules/primitives/docs/queries/GetBaseCurrency.md +5 -0
  244. package/src/modules/primitives/docs/queries/GetCurrency.md +7 -0
  245. package/src/modules/primitives/docs/queries/GetUnit.md +7 -0
  246. package/src/modules/primitives/docs/queries/GetUoMCategory.md +7 -0
  247. package/src/modules/primitives/docs/queries/ListUnitsByCategory.md +15 -5
  248. package/src/modules/primitives/index.ts +0 -49
  249. package/src/modules/primitives/lib/errors.generated.ts +23 -23
  250. package/src/modules/primitives/lib/permissions.generated.ts +1 -1
  251. package/src/modules/primitives/lib/types.ts +1 -1
  252. package/src/modules/primitives/module.ts +1 -1
  253. package/src/modules/primitives/query/convertAmount.generated.ts +1 -1
  254. package/src/modules/primitives/query/convertAmount.test.ts +110 -77
  255. package/src/modules/primitives/query/convertAmount.ts +61 -47
  256. package/src/modules/primitives/query/convertQuantity.generated.ts +1 -1
  257. package/src/modules/primitives/query/convertQuantity.test.ts +99 -69
  258. package/src/modules/primitives/query/convertQuantity.ts +12 -10
  259. package/src/modules/primitives/query/getBaseCurrency.generated.ts +1 -1
  260. package/src/modules/primitives/query/getBaseCurrency.test.ts +10 -4
  261. package/src/modules/primitives/query/getBaseCurrency.ts +2 -2
  262. package/src/modules/primitives/query/getCurrency.generated.ts +1 -1
  263. package/src/modules/primitives/query/getCurrency.test.ts +17 -5
  264. package/src/modules/primitives/query/getCurrency.ts +2 -2
  265. package/src/modules/primitives/query/getUnit.generated.ts +1 -1
  266. package/src/modules/primitives/query/getUnit.test.ts +17 -5
  267. package/src/modules/primitives/query/getUnit.ts +2 -2
  268. package/src/modules/primitives/query/getUoMCategory.generated.ts +1 -1
  269. package/src/modules/primitives/query/getUoMCategory.test.ts +17 -5
  270. package/src/modules/primitives/query/getUoMCategory.ts +2 -2
  271. package/src/modules/primitives/query/listUnitsByCategory.generated.ts +1 -1
  272. package/src/modules/primitives/query/listUnitsByCategory.test.ts +80 -0
  273. package/src/modules/primitives/query/listUnitsByCategory.ts +19 -3
  274. package/src/modules/primitives/tailor.config.ts +6 -4
  275. package/src/modules/primitives/tailor.d.ts +13 -0
  276. package/src/modules/product-management/README.md +52 -0
  277. package/src/modules/product-management/command/activateProduct.generated.ts +6 -0
  278. package/src/modules/product-management/command/activateProduct.test.ts +40 -0
  279. package/src/modules/product-management/command/activateProduct.ts +42 -0
  280. package/src/modules/product-management/command/assignProductToCategory.generated.ts +6 -0
  281. package/src/modules/product-management/command/assignProductToCategory.test.ts +90 -0
  282. package/src/modules/product-management/command/assignProductToCategory.ts +62 -0
  283. package/src/modules/product-management/command/createProduct.generated.ts +6 -0
  284. package/src/modules/product-management/command/createProduct.test.ts +149 -0
  285. package/src/modules/product-management/command/createProduct.ts +73 -0
  286. package/src/modules/product-management/command/createProductAttribute.generated.ts +6 -0
  287. package/src/modules/product-management/command/createProductAttribute.test.ts +70 -0
  288. package/src/modules/product-management/command/createProductAttribute.ts +53 -0
  289. package/src/modules/product-management/command/createProductAttributeValue.generated.ts +6 -0
  290. package/src/modules/product-management/command/createProductAttributeValue.test.ts +68 -0
  291. package/src/modules/product-management/command/createProductAttributeValue.ts +63 -0
  292. package/src/modules/product-management/command/createProductCategory.generated.ts +6 -0
  293. package/src/modules/product-management/command/createProductCategory.test.ts +135 -0
  294. package/src/modules/product-management/command/createProductCategory.ts +82 -0
  295. package/src/modules/product-management/command/deactivateProduct.generated.ts +6 -0
  296. package/src/modules/product-management/command/deactivateProduct.test.ts +40 -0
  297. package/src/modules/product-management/command/deactivateProduct.ts +42 -0
  298. package/src/modules/product-management/command/deleteProduct.generated.ts +6 -0
  299. package/src/modules/product-management/command/deleteProduct.test.ts +42 -0
  300. package/src/modules/product-management/command/deleteProduct.ts +42 -0
  301. package/src/modules/product-management/command/deleteProductAttribute.generated.ts +6 -0
  302. package/src/modules/product-management/command/deleteProductAttribute.test.ts +49 -0
  303. package/src/modules/product-management/command/deleteProductAttribute.ts +45 -0
  304. package/src/modules/product-management/command/deleteProductAttributeValue.generated.ts +6 -0
  305. package/src/modules/product-management/command/deleteProductAttributeValue.test.ts +71 -0
  306. package/src/modules/product-management/command/deleteProductAttributeValue.ts +68 -0
  307. package/src/modules/product-management/command/deleteProductCategory.generated.ts +6 -0
  308. package/src/modules/product-management/command/deleteProductCategory.test.ts +74 -0
  309. package/src/modules/product-management/command/deleteProductCategory.ts +53 -0
  310. package/src/modules/product-management/command/generateVariants.generated.ts +6 -0
  311. package/src/modules/product-management/command/generateVariants.test.ts +365 -0
  312. package/src/modules/product-management/command/generateVariants.ts +168 -0
  313. package/src/modules/product-management/command/moveProductCategory.generated.ts +6 -0
  314. package/src/modules/product-management/command/moveProductCategory.test.ts +170 -0
  315. package/src/modules/product-management/command/moveProductCategory.ts +124 -0
  316. package/src/modules/product-management/command/reactivateProduct.generated.ts +6 -0
  317. package/src/modules/product-management/command/reactivateProduct.test.ts +40 -0
  318. package/src/modules/product-management/command/reactivateProduct.ts +42 -0
  319. package/src/modules/product-management/command/removeProductFromCategory.generated.ts +6 -0
  320. package/src/modules/product-management/command/removeProductFromCategory.test.ts +42 -0
  321. package/src/modules/product-management/command/removeProductFromCategory.ts +32 -0
  322. package/src/modules/product-management/command/setProductAttributeAssignment.generated.ts +6 -0
  323. package/src/modules/product-management/command/setProductAttributeAssignment.test.ts +206 -0
  324. package/src/modules/product-management/command/setProductAttributeAssignment.ts +102 -0
  325. package/src/modules/product-management/command/updateProduct.generated.ts +6 -0
  326. package/src/modules/product-management/command/updateProduct.test.ts +168 -0
  327. package/src/modules/product-management/command/updateProduct.ts +95 -0
  328. package/src/modules/product-management/command/updateProductAttribute.generated.ts +6 -0
  329. package/src/modules/product-management/command/updateProductAttribute.test.ts +101 -0
  330. package/src/modules/product-management/command/updateProductAttribute.ts +68 -0
  331. package/src/modules/product-management/command/updateProductAttributeValue.generated.ts +6 -0
  332. package/src/modules/product-management/command/updateProductAttributeValue.test.ts +80 -0
  333. package/src/modules/product-management/command/updateProductAttributeValue.ts +58 -0
  334. package/src/modules/product-management/command/updateProductCategory.generated.ts +6 -0
  335. package/src/modules/product-management/command/updateProductCategory.test.ts +80 -0
  336. package/src/modules/product-management/command/updateProductCategory.ts +66 -0
  337. package/src/modules/product-management/db/product.ts +47 -0
  338. package/src/modules/product-management/db/productAttribute.ts +26 -0
  339. package/src/modules/product-management/db/productAttributeAssignment.ts +58 -0
  340. package/src/modules/product-management/db/productAttributeValue.ts +39 -0
  341. package/src/modules/product-management/db/productCategory.ts +34 -0
  342. package/src/modules/product-management/db/productCategoryAssignment.ts +49 -0
  343. package/src/modules/product-management/db/productVariant.ts +52 -0
  344. package/src/modules/product-management/docs/commands/ActivateProduct.md +39 -0
  345. package/src/modules/product-management/docs/commands/AssignProductToCategory.md +43 -0
  346. package/src/modules/product-management/docs/commands/CreateProduct.md +48 -0
  347. package/src/modules/product-management/docs/commands/CreateProductAttribute.md +39 -0
  348. package/src/modules/product-management/docs/commands/CreateProductAttributeValue.md +42 -0
  349. package/src/modules/product-management/docs/commands/CreateProductCategory.md +54 -0
  350. package/src/modules/product-management/docs/commands/DeactivateProduct.md +39 -0
  351. package/src/modules/product-management/docs/commands/DeleteProduct.md +42 -0
  352. package/src/modules/product-management/docs/commands/DeleteProductAttribute.md +39 -0
  353. package/src/modules/product-management/docs/commands/DeleteProductAttributeValue.md +42 -0
  354. package/src/modules/product-management/docs/commands/DeleteProductCategory.md +43 -0
  355. package/src/modules/product-management/docs/commands/GenerateVariants.md +68 -0
  356. package/src/modules/product-management/docs/commands/MoveProductCategory.md +54 -0
  357. package/src/modules/product-management/docs/commands/ReactivateProduct.md +38 -0
  358. package/src/modules/product-management/docs/commands/RemoveProductFromCategory.md +34 -0
  359. package/src/modules/product-management/docs/commands/SetProductAttributeAssignment.md +62 -0
  360. package/src/modules/product-management/docs/commands/UpdateProduct.md +61 -0
  361. package/src/modules/product-management/docs/commands/UpdateProductAttribute.md +46 -0
  362. package/src/modules/product-management/docs/commands/UpdateProductAttributeValue.md +47 -0
  363. package/src/modules/product-management/docs/commands/UpdateProductCategory.md +46 -0
  364. package/src/modules/product-management/docs/features/attribute-management.md +48 -0
  365. package/src/modules/product-management/docs/features/product-category.md +71 -0
  366. package/src/modules/product-management/docs/features/product-lifecycle.md +66 -0
  367. package/src/modules/product-management/docs/features/variant-generation.md +77 -0
  368. package/src/modules/product-management/docs/models/Product.md +58 -0
  369. package/src/modules/product-management/docs/models/ProductAttribute.md +37 -0
  370. package/src/modules/product-management/docs/models/ProductAttributeAssignment.md +41 -0
  371. package/src/modules/product-management/docs/models/ProductAttributeValue.md +40 -0
  372. package/src/modules/product-management/docs/models/ProductCategory.md +46 -0
  373. package/src/modules/product-management/docs/models/ProductCategoryAssignment.md +37 -0
  374. package/src/modules/product-management/docs/models/ProductVariant.md +41 -0
  375. package/src/modules/product-management/docs/queries/CalculateCategoryDepth.md +47 -0
  376. package/src/modules/product-management/docs/queries/DetectCategoryCircularReference.md +51 -0
  377. package/src/modules/product-management/docs/queries/GetProduct.md +42 -0
  378. package/src/modules/product-management/docs/queries/GetProductAttribute.md +42 -0
  379. package/src/modules/product-management/docs/queries/GetProductAttributeAssignment.md +34 -0
  380. package/src/modules/product-management/docs/queries/GetProductAttributeValue.md +40 -0
  381. package/src/modules/product-management/docs/queries/GetProductCategory.md +42 -0
  382. package/src/modules/product-management/docs/queries/GetProductCategoryAssignment.md +34 -0
  383. package/src/modules/product-management/docs/queries/GetProductVariant.md +41 -0
  384. package/src/modules/product-management/docs/queries/ListAttributeAssignmentsByAttribute.md +34 -0
  385. package/src/modules/product-management/docs/queries/ListCategoryAssignmentsByProduct.md +35 -0
  386. package/src/modules/product-management/docs/queries/ListProductAttributeAssignments.md +34 -0
  387. package/src/modules/product-management/docs/queries/ListProductAttributeValues.md +36 -0
  388. package/src/modules/product-management/docs/queries/ListProductCategoryAssignments.md +34 -0
  389. package/src/modules/product-management/docs/queries/ListProductCategoryChildren.md +34 -0
  390. package/src/modules/product-management/docs/queries/ListProductVariants.md +34 -0
  391. package/src/modules/product-management/generated/enums.ts +9 -0
  392. package/src/modules/product-management/generated/kysely-tailordb.ts +100 -0
  393. package/src/modules/product-management/index.ts +2 -0
  394. package/src/modules/product-management/lib/_db_deps.ts +17 -0
  395. package/src/modules/product-management/lib/errors.generated.ts +152 -0
  396. package/src/modules/product-management/lib/permissions.generated.ts +25 -0
  397. package/src/modules/product-management/lib/types.ts +51 -0
  398. package/src/modules/product-management/module.ts +201 -0
  399. package/src/modules/product-management/query/calculateCategoryDepth.generated.ts +5 -0
  400. package/src/modules/product-management/query/calculateCategoryDepth.test.ts +72 -0
  401. package/src/modules/product-management/query/calculateCategoryDepth.ts +37 -0
  402. package/src/modules/product-management/query/detectCategoryCircularReference.generated.ts +5 -0
  403. package/src/modules/product-management/query/detectCategoryCircularReference.test.ts +72 -0
  404. package/src/modules/product-management/query/detectCategoryCircularReference.ts +44 -0
  405. package/src/modules/product-management/query/getProduct.generated.ts +5 -0
  406. package/src/modules/product-management/query/getProduct.test.ts +59 -0
  407. package/src/modules/product-management/query/getProduct.ts +18 -0
  408. package/src/modules/product-management/query/getProductAttribute.generated.ts +5 -0
  409. package/src/modules/product-management/query/getProductAttribute.test.ts +59 -0
  410. package/src/modules/product-management/query/getProductAttribute.ts +18 -0
  411. package/src/modules/product-management/query/getProductAttributeAssignment.generated.ts +5 -0
  412. package/src/modules/product-management/query/getProductAttributeAssignment.test.ts +37 -0
  413. package/src/modules/product-management/query/getProductAttributeAssignment.ts +18 -0
  414. package/src/modules/product-management/query/getProductAttributeValue.generated.ts +5 -0
  415. package/src/modules/product-management/query/getProductAttributeValue.test.ts +31 -0
  416. package/src/modules/product-management/query/getProductAttributeValue.ts +16 -0
  417. package/src/modules/product-management/query/getProductCategory.generated.ts +5 -0
  418. package/src/modules/product-management/query/getProductCategory.test.ts +59 -0
  419. package/src/modules/product-management/query/getProductCategory.ts +18 -0
  420. package/src/modules/product-management/query/getProductCategoryAssignment.generated.ts +5 -0
  421. package/src/modules/product-management/query/getProductCategoryAssignment.test.ts +37 -0
  422. package/src/modules/product-management/query/getProductCategoryAssignment.ts +18 -0
  423. package/src/modules/product-management/query/getProductVariant.generated.ts +5 -0
  424. package/src/modules/product-management/query/getProductVariant.test.ts +43 -0
  425. package/src/modules/product-management/query/getProductVariant.ts +20 -0
  426. package/src/modules/product-management/query/listAttributeAssignmentsByAttribute.generated.ts +5 -0
  427. package/src/modules/product-management/query/listAttributeAssignmentsByAttribute.test.ts +31 -0
  428. package/src/modules/product-management/query/listAttributeAssignmentsByAttribute.ts +16 -0
  429. package/src/modules/product-management/query/listCategoryAssignmentsByProduct.generated.ts +5 -0
  430. package/src/modules/product-management/query/listCategoryAssignmentsByProduct.test.ts +31 -0
  431. package/src/modules/product-management/query/listCategoryAssignmentsByProduct.ts +16 -0
  432. package/src/modules/product-management/query/listProductAttributeAssignments.generated.ts +5 -0
  433. package/src/modules/product-management/query/listProductAttributeAssignments.test.ts +31 -0
  434. package/src/modules/product-management/query/listProductAttributeAssignments.ts +16 -0
  435. package/src/modules/product-management/query/listProductAttributeValues.generated.ts +5 -0
  436. package/src/modules/product-management/query/listProductAttributeValues.test.ts +31 -0
  437. package/src/modules/product-management/query/listProductAttributeValues.ts +17 -0
  438. package/src/modules/product-management/query/listProductCategoryAssignments.generated.ts +5 -0
  439. package/src/modules/product-management/query/listProductCategoryAssignments.test.ts +31 -0
  440. package/src/modules/product-management/query/listProductCategoryAssignments.ts +16 -0
  441. package/src/modules/product-management/query/listProductCategoryChildren.generated.ts +5 -0
  442. package/src/modules/product-management/query/listProductCategoryChildren.test.ts +31 -0
  443. package/src/modules/product-management/query/listProductCategoryChildren.ts +16 -0
  444. package/src/modules/product-management/query/listProductVariants.generated.ts +5 -0
  445. package/src/modules/product-management/query/listProductVariants.test.ts +31 -0
  446. package/src/modules/product-management/query/listProductVariants.ts +16 -0
  447. package/src/modules/product-management/tailor.config.ts +13 -0
  448. package/src/modules/product-management/tailor.d.ts +13 -0
  449. package/src/modules/product-management/testing/fixtures.ts +151 -0
  450. package/src/modules/user-management/README.md +9 -3
  451. package/src/modules/user-management/command/activateUser.generated.ts +1 -1
  452. package/src/modules/user-management/command/activateUser.test.ts +12 -65
  453. package/src/modules/user-management/command/activateUser.ts +5 -20
  454. package/src/modules/user-management/command/assignPermissionToRole.generated.ts +1 -1
  455. package/src/modules/user-management/command/assignPermissionToRole.test.ts +25 -60
  456. package/src/modules/user-management/command/assignPermissionToRole.ts +5 -24
  457. package/src/modules/user-management/command/assignRoleToUser.generated.ts +1 -1
  458. package/src/modules/user-management/command/assignRoleToUser.test.ts +35 -87
  459. package/src/modules/user-management/command/assignRoleToUser.ts +5 -24
  460. package/src/modules/user-management/command/createPermission.generated.ts +1 -1
  461. package/src/modules/user-management/command/createPermission.test.ts +23 -33
  462. package/src/modules/user-management/command/createPermission.ts +4 -5
  463. package/src/modules/user-management/command/createRole.generated.ts +1 -1
  464. package/src/modules/user-management/command/createRole.test.ts +17 -27
  465. package/src/modules/user-management/command/createRole.ts +4 -5
  466. package/src/modules/user-management/command/createUser.generated.ts +1 -1
  467. package/src/modules/user-management/command/createUser.test.ts +31 -118
  468. package/src/modules/user-management/command/createUser.ts +7 -25
  469. package/src/modules/user-management/command/deactivateUser.generated.ts +1 -1
  470. package/src/modules/user-management/command/deactivateUser.test.ts +12 -65
  471. package/src/modules/user-management/command/deactivateUser.ts +6 -21
  472. package/src/modules/user-management/command/reactivateUser.generated.ts +1 -1
  473. package/src/modules/user-management/command/reactivateUser.test.ts +13 -66
  474. package/src/modules/user-management/command/reactivateUser.ts +5 -20
  475. package/src/modules/user-management/command/revokePermissionFromRole.generated.ts +1 -1
  476. package/src/modules/user-management/command/revokePermissionFromRole.test.ts +24 -62
  477. package/src/modules/user-management/command/revokePermissionFromRole.ts +5 -24
  478. package/src/modules/user-management/command/revokeRoleFromUser.generated.ts +1 -1
  479. package/src/modules/user-management/command/revokeRoleFromUser.test.ts +24 -60
  480. package/src/modules/user-management/command/revokeRoleFromUser.ts +5 -24
  481. package/src/modules/user-management/docs/commands/ActivateUser.md +7 -0
  482. package/src/modules/user-management/docs/commands/AssignPermissionToRole.md +7 -0
  483. package/src/modules/user-management/docs/commands/AssignRoleToUser.md +9 -0
  484. package/src/modules/user-management/docs/commands/CreatePermission.md +12 -0
  485. package/src/modules/user-management/docs/commands/CreateRole.md +9 -0
  486. package/src/modules/user-management/docs/commands/CreateUser.md +11 -0
  487. package/src/modules/user-management/docs/commands/DeactivateUser.md +7 -0
  488. package/src/modules/user-management/docs/commands/ReactivateUser.md +7 -0
  489. package/src/modules/user-management/docs/commands/RevokePermissionFromRole.md +7 -0
  490. package/src/modules/user-management/docs/commands/RevokeRoleFromUser.md +7 -0
  491. package/src/modules/user-management/index.ts +0 -30
  492. package/src/modules/user-management/lib/errors.generated.ts +14 -14
  493. package/src/modules/user-management/lib/permissions.generated.ts +1 -2
  494. package/src/modules/user-management/lib/recomputeUserPermissions.ts +4 -3
  495. package/src/modules/user-management/lib/types.ts +1 -1
  496. package/src/modules/user-management/module.ts +2 -7
  497. package/src/modules/user-management/tailor.config.ts +6 -4
  498. package/src/modules/user-management/tailor.d.ts +13 -0
  499. package/src/modules/user-management/testing/fixtures.ts +1 -20
  500. package/src/schemas.ts +1 -1
  501. package/src/{modules/shared → shared}/defineCommand.test.ts +23 -7
  502. package/src/{modules/shared → shared}/defineCommand.ts +19 -10
  503. package/src/{modules/shared/internal.ts → shared/index.ts} +9 -1
  504. package/src/shared/pagination.test.ts +43 -0
  505. package/src/shared/pagination.ts +22 -0
  506. package/src/{modules/shared → shared}/types.ts +13 -0
  507. package/src/{modules/testing → testing}/index.ts +14 -7
  508. package/src/testing.ts +1 -1
  509. package/src/util.ts +8 -0
  510. package/templates/config/license.config.json +4 -0
  511. package/templates/scaffold/app/backend/.env.example +1 -0
  512. package/templates/scaffold/app/backend/__dot__gitignore +4 -0
  513. package/templates/scaffold/app/backend/eslint.config.js +32 -0
  514. package/templates/scaffold/app/backend/package.json +31 -0
  515. package/templates/scaffold/app/backend/seed/data/AuditEvent.jsonl +0 -0
  516. package/templates/scaffold/app/backend/seed/data/Permission.jsonl +0 -0
  517. package/templates/scaffold/app/backend/seed/data/Permission.schema.ts +20 -0
  518. package/templates/scaffold/app/backend/seed/data/Role.jsonl +0 -0
  519. package/templates/scaffold/app/backend/seed/data/Role.schema.ts +20 -0
  520. package/templates/scaffold/app/backend/seed/data/RolePermission.jsonl +0 -0
  521. package/templates/scaffold/app/backend/seed/data/RolePermission.schema.ts +24 -0
  522. package/templates/scaffold/app/backend/seed/data/User.jsonl +1 -0
  523. package/templates/scaffold/app/backend/seed/data/User.schema.ts +20 -0
  524. package/templates/scaffold/app/backend/seed/data/UserRole.jsonl +0 -0
  525. package/templates/scaffold/app/backend/seed/data/UserRole.schema.ts +24 -0
  526. package/templates/scaffold/app/backend/seed/data/_User.jsonl +1 -0
  527. package/templates/scaffold/app/backend/seed/data/_User.schema.ts +30 -0
  528. package/templates/scaffold/app/backend/seed/exec.mjs +659 -0
  529. package/templates/scaffold/app/backend/src/executors/permissionCreated.ts +3 -0
  530. package/templates/scaffold/app/backend/src/executors/permissionDeleted.ts +3 -0
  531. package/templates/scaffold/app/backend/src/generated/kysely-tailordb.ts +83 -0
  532. package/templates/scaffold/app/backend/src/modules.ts +9 -0
  533. package/templates/scaffold/app/backend/src/resolvers/createUser.ts +46 -0
  534. package/templates/scaffold/app/backend/tailor.config.ts +68 -0
  535. package/templates/scaffold/app/backend/tailor.d.ts +15 -0
  536. package/templates/scaffold/app/backend/tsconfig.json +19 -0
  537. package/templates/scaffold/app/docs/actors/.gitkeep +0 -0
  538. package/templates/scaffold/app/docs/business-flow/.gitkeep +0 -0
  539. package/templates/scaffold/app/docs/resolver/.gitkeep +0 -0
  540. package/templates/scaffold/app/docs/screen/.gitkeep +0 -0
  541. package/templates/scaffold/app/frontend/.env.example +2 -0
  542. package/templates/scaffold/app/frontend/__dot__gitignore +3 -0
  543. package/templates/scaffold/app/frontend/components.json +23 -0
  544. package/templates/scaffold/app/frontend/eslint.config.js +48 -0
  545. package/templates/scaffold/app/frontend/index.html +13 -0
  546. package/templates/scaffold/app/frontend/package.json +53 -0
  547. package/templates/scaffold/app/frontend/scripts/generate-graphql.mjs +6 -0
  548. package/templates/scaffold/app/frontend/src/App.tsx +58 -0
  549. package/templates/scaffold/app/frontend/src/components/composed/empty-state.tsx +26 -0
  550. package/templates/scaffold/app/frontend/src/components/composed/error-fallback.tsx +28 -0
  551. package/templates/scaffold/app/frontend/src/components/composed/loading.tsx +13 -0
  552. package/templates/scaffold/app/frontend/src/components/ui/badge.tsx +39 -0
  553. package/templates/scaffold/app/frontend/src/components/ui/button.tsx +60 -0
  554. package/templates/scaffold/app/frontend/src/components/ui/card.tsx +75 -0
  555. package/templates/scaffold/app/frontend/src/components/ui/form.tsx +152 -0
  556. package/templates/scaffold/app/frontend/src/components/ui/input.tsx +21 -0
  557. package/templates/scaffold/app/frontend/src/components/ui/label.tsx +21 -0
  558. package/templates/scaffold/app/frontend/src/components/ui/spinner.tsx +16 -0
  559. package/templates/scaffold/app/frontend/src/components/ui/table.tsx +90 -0
  560. package/templates/scaffold/app/frontend/src/graphql/generated/graphql-env.d.ts +103 -0
  561. package/templates/scaffold/app/frontend/src/graphql/generated/schema.graphql +1235 -0
  562. package/templates/scaffold/app/frontend/src/graphql/index.ts +15 -0
  563. package/templates/scaffold/app/frontend/src/index.css +5 -0
  564. package/templates/scaffold/app/frontend/src/lib/auth-client.ts +17 -0
  565. package/templates/scaffold/app/frontend/src/lib/utils.ts +6 -0
  566. package/templates/scaffold/app/frontend/src/main.tsx +10 -0
  567. package/templates/scaffold/app/frontend/src/pages/page.tsx +20 -0
  568. package/templates/scaffold/app/frontend/src/pages/user-management/page.tsx +19 -0
  569. package/templates/scaffold/app/frontend/src/pages/user-management/profile/page.tsx +97 -0
  570. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/components/user-detail.tsx +58 -0
  571. package/templates/scaffold/app/frontend/src/pages/user-management/user/[id]/page.tsx +51 -0
  572. package/templates/scaffold/app/frontend/src/pages/user-management/user/components/users-table.tsx +101 -0
  573. package/templates/scaffold/app/frontend/src/pages/user-management/user/create/components/create-user-form.tsx +99 -0
  574. package/templates/scaffold/app/frontend/src/pages/user-management/user/create/page.tsx +19 -0
  575. package/templates/scaffold/app/frontend/src/pages/user-management/user/page.tsx +61 -0
  576. package/templates/scaffold/app/frontend/src/providers/graphql-provider.tsx +21 -0
  577. package/templates/scaffold/app/frontend/tsconfig.app.json +35 -0
  578. package/templates/scaffold/app/frontend/tsconfig.json +16 -0
  579. package/templates/scaffold/app/frontend/tsconfig.node.json +23 -0
  580. package/templates/scaffold/app/frontend/vite.config.ts +23 -0
  581. package/templates/scaffold/module/command/.gitkeep +0 -0
  582. package/templates/scaffold/module/db/.gitkeep +0 -0
  583. package/templates/scaffold/module/executor/.gitkeep +0 -0
  584. package/templates/scaffold/module/generated/.gitkeep +0 -0
  585. package/templates/scaffold/module/index.ts +2 -0
  586. package/templates/scaffold/module/lib/errors.ts +1 -0
  587. package/templates/scaffold/module/lib/types.ts +4 -0
  588. package/templates/scaffold/module/module.ts +7 -0
  589. package/templates/scaffold/module/permissions.ts +3 -0
  590. package/templates/scaffold/module/query/.gitkeep +0 -0
  591. package/templates/scaffold/module/tailor.config.ts +13 -0
  592. package/templates/scaffold/module/testing/fixtures.ts +1 -0
  593. package/templates/workflows/erp-kit-check.yml +37 -0
  594. package/dist/cli.js +0 -1654
  595. package/skills/erp-kit-app-2-breakdown/SKILL.md +0 -88
  596. package/skills/erp-kit-app-3-doc-review/SKILL.md +0 -112
  597. package/skills/erp-kit-app-4-impl-spec/SKILL.md +0 -116
  598. package/skills/erp-kit-app-5-implementation/SKILL.md +0 -149
  599. package/skills/erp-kit-app-5-implementation/references/backend.md +0 -232
  600. package/skills/erp-kit-module-1-docs/SKILL.md +0 -111
  601. package/skills/erp-kit-module-2-feature-breakdown/SKILL.md +0 -76
  602. package/skills/erp-kit-module-3-doc-review/SKILL.md +0 -294
  603. package/skills/erp-kit-module-4-tdd/SKILL.md +0 -94
  604. package/skills/erp-kit-module-4-tdd/references/exports.md +0 -8
  605. package/skills/erp-kit-module-5-impl-review/SKILL.md +0 -410
  606. package/src/commands/scaffold-templates.ts +0 -65
  607. package/src/commands/scaffold.test.ts +0 -171
  608. package/src/commands/scaffold.ts +0 -140
  609. package/src/modules/shared/index.ts +0 -1
  610. package/src/modules/user-management/command/logAuditEvent.generated.ts +0 -6
  611. package/src/modules/user-management/command/logAuditEvent.test.ts +0 -187
  612. package/src/modules/user-management/command/logAuditEvent.ts +0 -56
  613. package/src/modules/user-management/db/auditEvent.ts +0 -47
  614. package/src/modules/user-management/docs/commands/LogAuditEvent.md +0 -37
  615. package/src/modules/user-management/docs/features/audit-trail.md +0 -80
  616. package/src/modules/user-management/docs/models/AuditEvent.md +0 -36
  617. /package/skills/{erp-kit-module-4-tdd → erp-kit-module-5-impl}/references/cross-module-dependency.md +0 -0
  618. /package/skills/{erp-kit-module-4-tdd → erp-kit-module-5-impl}/references/db-relations.md +0 -0
  619. /package/skills/{erp-kit-module-4-tdd → erp-kit-module-5-impl}/references/models.md +0 -0
  620. /package/skills/{erp-kit-module-5-impl-review → erp-kit-module-6-impl-review}/references/commands.md +0 -0
  621. /package/skills/{erp-kit-module-5-impl-review → erp-kit-module-6-impl-review}/references/testing.md +0 -0
  622. /package/src/modules/{product-management → audit}/.gitkeep +0 -0
  623. /package/src/{modules/shared → shared}/createContext.test.ts +0 -0
  624. /package/src/{modules/shared → shared}/createContext.ts +0 -0
  625. /package/src/{modules/shared → shared}/definePermissions.test.ts +0 -0
  626. /package/src/{modules/shared → shared}/definePermissions.ts +0 -0
  627. /package/src/{modules/shared → shared}/defineQuery.test.ts +0 -0
  628. /package/src/{modules/shared → shared}/defineQuery.ts +0 -0
  629. /package/src/{modules/shared → shared}/entityTypes.ts +0 -0
  630. /package/src/{modules/shared → shared}/errors.ts +0 -0
  631. /package/src/{modules/shared → shared}/requirePermission.test.ts +0 -0
  632. /package/src/{modules/shared → shared}/requirePermission.ts +0 -0
  633. /package/src/{modules/shared → shared}/result.ts +0 -0
@@ -0,0 +1,142 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { describe, it, expect, afterEach } from "vitest";
5
+ import { copyTemplateDir, scaffoldModuleBoilerplate } from "./generate-code";
6
+
7
+ describe("scaffoldModuleBoilerplate", () => {
8
+ let tmpDir: string;
9
+
10
+ afterEach(() => {
11
+ if (tmpDir) {
12
+ fs.rmSync(tmpDir, { recursive: true, force: true });
13
+ }
14
+ });
15
+
16
+ it("creates expected directories and files", () => {
17
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "scaffold-test-"));
18
+ const moduleDir = path.join(tmpDir, "test-module");
19
+ fs.mkdirSync(moduleDir, { recursive: true });
20
+
21
+ scaffoldModuleBoilerplate(moduleDir, "test-module");
22
+
23
+ for (const dir of ["db", "command", "executor", "generated", "lib", "query", "testing"]) {
24
+ expect(fs.existsSync(path.join(moduleDir, dir))).toBe(true);
25
+ }
26
+
27
+ for (const dir of ["db", "command", "executor", "generated", "query"]) {
28
+ expect(fs.existsSync(path.join(moduleDir, dir, ".gitkeep"))).toBe(true);
29
+ }
30
+
31
+ const expectedFiles = [
32
+ "module.ts",
33
+ "index.ts",
34
+ "permissions.ts",
35
+ "tailor.config.ts",
36
+ "lib/errors.ts",
37
+ "lib/types.ts",
38
+ "testing/fixtures.ts",
39
+ ];
40
+ for (const file of expectedFiles) {
41
+ expect(fs.existsSync(path.join(moduleDir, file))).toBe(true);
42
+ }
43
+
44
+ const permissions = fs.readFileSync(path.join(moduleDir, "permissions.ts"), "utf-8");
45
+ expect(permissions).toContain('definePermissions("test-module"');
46
+
47
+ const config = fs.readFileSync(path.join(moduleDir, "tailor.config.ts"), "utf-8");
48
+ expect(config).toContain('name: "test-module"');
49
+
50
+ const moduleFile = fs.readFileSync(path.join(moduleDir, "module.ts"), "utf-8");
51
+ expect(moduleFile).toContain("defineModule");
52
+ expect(moduleFile).toContain("commands");
53
+ expect(moduleFile).toContain("queries");
54
+ });
55
+ });
56
+
57
+ describe("copyTemplateDir", () => {
58
+ let tmpDir: string;
59
+
60
+ afterEach(() => {
61
+ if (tmpDir) {
62
+ fs.rmSync(tmpDir, { recursive: true, force: true });
63
+ }
64
+ });
65
+
66
+ it("copies files recursively with placeholder replacement", () => {
67
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "copy-template-test-"));
68
+ const srcDir = path.join(tmpDir, "src");
69
+ const destDir = path.join(tmpDir, "dest");
70
+
71
+ fs.mkdirSync(path.join(srcDir, "backend"), { recursive: true });
72
+ fs.mkdirSync(path.join(srcDir, "frontend/src"), { recursive: true });
73
+ fs.writeFileSync(
74
+ path.join(srcDir, "backend/package.json"),
75
+ '{ "name": "template-app-backend", "dependencies": { "@tailor-platform/erp-kit": "workspace:*" } }\n',
76
+ );
77
+ fs.writeFileSync(
78
+ path.join(srcDir, "frontend/package.json"),
79
+ '{ "name": "template-app-frontend" }\n',
80
+ );
81
+ fs.writeFileSync(path.join(srcDir, "frontend/index.html"), "<title>template-app</title>\n");
82
+ fs.writeFileSync(path.join(srcDir, "frontend/src/main.tsx"), "// app\n");
83
+
84
+ const replacements = {
85
+ "template-app-frontend": "my-app-frontend",
86
+ "template-app-backend": "my-app",
87
+ "template-app": "my-app",
88
+ '"workspace:*"': '"1.0.0"',
89
+ };
90
+ const placeholderFiles = new Set(["package.json", "index.html"]);
91
+ copyTemplateDir(srcDir, destDir, replacements, placeholderFiles);
92
+
93
+ expect(fs.existsSync(path.join(destDir, "backend/package.json"))).toBe(true);
94
+ expect(fs.existsSync(path.join(destDir, "frontend/package.json"))).toBe(true);
95
+ expect(fs.existsSync(path.join(destDir, "frontend/index.html"))).toBe(true);
96
+ expect(fs.existsSync(path.join(destDir, "frontend/src/main.tsx"))).toBe(true);
97
+
98
+ const backendPkg = fs.readFileSync(path.join(destDir, "backend/package.json"), "utf-8");
99
+ expect(backendPkg).toContain('"name": "my-app"');
100
+ expect(backendPkg).not.toContain("template-app-backend");
101
+ expect(backendPkg).toContain('"1.0.0"');
102
+ expect(backendPkg).not.toContain("workspace:*");
103
+
104
+ const frontendPkg = fs.readFileSync(path.join(destDir, "frontend/package.json"), "utf-8");
105
+ expect(frontendPkg).toContain('"name": "my-app-frontend"');
106
+ expect(frontendPkg).not.toContain("template-app-frontend");
107
+
108
+ const indexHtml = fs.readFileSync(path.join(destDir, "frontend/index.html"), "utf-8");
109
+ expect(indexHtml).toContain("<title>my-app</title>");
110
+ expect(indexHtml).not.toContain("template-app");
111
+ });
112
+
113
+ it("renames __dot__gitignore to .gitignore", () => {
114
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "copy-template-test-"));
115
+ const srcDir = path.join(tmpDir, "src");
116
+ const destDir = path.join(tmpDir, "dest");
117
+
118
+ fs.mkdirSync(srcDir, { recursive: true });
119
+ fs.writeFileSync(path.join(srcDir, "__dot__gitignore"), "node_modules\n");
120
+
121
+ copyTemplateDir(srcDir, destDir, {}, new Set());
122
+
123
+ expect(fs.existsSync(path.join(destDir, ".gitignore"))).toBe(true);
124
+ expect(fs.existsSync(path.join(destDir, "__dot__gitignore"))).toBe(false);
125
+ });
126
+
127
+ it("does not overwrite existing files", () => {
128
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "copy-template-test-"));
129
+ const srcDir = path.join(tmpDir, "src");
130
+ const destDir = path.join(tmpDir, "dest");
131
+
132
+ fs.mkdirSync(srcDir, { recursive: true });
133
+ fs.mkdirSync(destDir, { recursive: true });
134
+ fs.writeFileSync(path.join(srcDir, "file.txt"), "template content");
135
+ fs.writeFileSync(path.join(destDir, "file.txt"), "existing content");
136
+
137
+ copyTemplateDir(srcDir, destDir, {}, new Set());
138
+
139
+ const content = fs.readFileSync(path.join(destDir, "file.txt"), "utf-8");
140
+ expect(content).toBe("existing content");
141
+ });
142
+ });
@@ -6,11 +6,22 @@ import {
6
6
  generateQueryShell,
7
7
  generateQueryStub,
8
8
  generateQueryTestStub,
9
+ generateDbStub,
10
+ moduleNameToPrefix,
9
11
  } from "./generate-code";
10
12
  import type { ParsedCommandDoc } from "./parse-command-doc";
11
13
 
14
+ describe("moduleNameToPrefix", () => {
15
+ it("converts module name to UPPER_SNAKE_CASE prefix", () => {
16
+ expect(moduleNameToPrefix("item-management")).toBe("ITEM_MANAGEMENT");
17
+ expect(moduleNameToPrefix("primitives")).toBe("PRIMITIVES");
18
+ expect(moduleNameToPrefix("user-management")).toBe("USER_MANAGEMENT");
19
+ expect(moduleNameToPrefix("product-management")).toBe("PRODUCT_MANAGEMENT");
20
+ });
21
+ });
22
+
12
23
  describe("generateErrors", () => {
13
- it("generates error classes from parsed command docs", () => {
24
+ it("generates error classes with module-prefixed codes", () => {
14
25
  const docs: ParsedCommandDoc[] = [
15
26
  {
16
27
  commandName: "createItem",
@@ -30,13 +41,14 @@ describe("generateErrors", () => {
30
41
  },
31
42
  ];
32
43
 
33
- const result = generateErrors(docs);
44
+ const result = generateErrors("item-management", docs);
34
45
 
35
46
  expect(result).toContain("// @generated — do not edit");
36
- expect(result).toContain('import { createDomainError } from "../../shared/internal";');
47
+ expect(result).toContain('import { createDomainError } from "../../../shared";');
37
48
  expect(result).toContain("export const DuplicateSkuError = createDomainError(");
38
- expect(result).toContain('"DuplicateSkuError", "DUPLICATE_SKU"');
49
+ expect(result).toContain('"DuplicateSkuError", "ITEM_MANAGEMENT_DUPLICATE_SKU"');
39
50
  expect(result).toContain("export const UnitNotFoundError = createDomainError(");
51
+ expect(result).toContain('"UnitNotFoundError", "ITEM_MANAGEMENT_UNIT_NOT_FOUND"');
40
52
  expect(result).toContain("export const ItemNotFoundError = createDomainError(");
41
53
  expect(result).toContain("export const InvalidStateTransitionError = createDomainError(");
42
54
  });
@@ -55,7 +67,7 @@ describe("generateErrors", () => {
55
67
  },
56
68
  ];
57
69
 
58
- const result = generateErrors(docs);
70
+ const result = generateErrors("item-management", docs);
59
71
 
60
72
  const matches = result.match(/ItemNotFoundError/g);
61
73
  // Class name appears exactly twice: export declaration + first arg to createDomainError
@@ -67,7 +79,7 @@ describe("generateErrors", () => {
67
79
  { commandName: "noop", errors: [], externalDependencies: [] },
68
80
  ];
69
81
 
70
- const result = generateErrors(docs);
82
+ const result = generateErrors("item-management", docs);
71
83
 
72
84
  expect(result).toBe("");
73
85
  });
@@ -80,7 +92,7 @@ describe("generatePermissions", () => {
80
92
  const result = generatePermissions("item-management", commandNames);
81
93
 
82
94
  expect(result).toContain("// @generated — do not edit");
83
- expect(result).toContain('import { definePermissions } from "../../shared/internal";');
95
+ expect(result).toContain('import { definePermissions } from "../../../shared";');
84
96
  expect(result).toContain('"item-management"');
85
97
  expect(result).toContain('"createItem"');
86
98
  expect(result).toContain('"updateItem"');
@@ -116,7 +128,7 @@ describe("generateCommandShell", () => {
116
128
  const result = generateCommandShell(doc);
117
129
 
118
130
  expect(result).toContain("// @generated — do not edit");
119
- expect(result).toContain('import { defineCommand } from "../../shared/internal";');
131
+ expect(result).toContain('import { defineCommand } from "../../../shared";');
120
132
  expect(result).toContain('import { permissions } from "../lib/permissions.generated";');
121
133
  expect(result).toContain('import { run } from "./activateItem";');
122
134
  expect(result).toContain(
@@ -133,7 +145,7 @@ describe("generateCommandShell", () => {
133
145
 
134
146
  const result = generateCommandShell(doc);
135
147
 
136
- expect(result).toContain('import { defineCommand } from "../../shared/internal";');
148
+ expect(result).toContain('import { defineCommand } from "../../../shared";');
137
149
  expect(result).toContain('import { run } from "./createItem";');
138
150
  expect(result).toContain(
139
151
  "export const createItem = defineCommand(permissions.createItem, run);",
@@ -152,7 +164,7 @@ describe("generateQueryShell", () => {
152
164
  const result = generateQueryShell(doc);
153
165
 
154
166
  expect(result).toContain("// @generated — do not edit");
155
- expect(result).toContain('import { defineQuery } from "../../shared/internal";');
167
+ expect(result).toContain('import { defineQuery } from "../../../shared";');
156
168
  expect(result).toContain('import { run } from "./getTaxonomyNode";');
157
169
  expect(result).toContain("export const getTaxonomyNode = defineQuery(run);");
158
170
  });
@@ -168,7 +180,7 @@ describe("generateQueryStub", () => {
168
180
 
169
181
  const result = generateQueryStub(doc);
170
182
 
171
- expect(result).toContain('import type { ReadonlyDB } from "../../shared/internal";');
183
+ expect(result).toContain('import type { ReadonlyDB } from "../../../shared";');
172
184
  expect(result).toContain('import type { DB } from "../generated/kysely-tailordb";');
173
185
  expect(result).toContain("export interface GetTaxonomyNodeInput {");
174
186
  expect(result).toContain(
@@ -178,6 +190,29 @@ describe("generateQueryStub", () => {
178
190
  });
179
191
  });
180
192
 
193
+ describe("generateDbStub", () => {
194
+ it("generates an empty db type definition with TODO", () => {
195
+ const result = generateDbStub("item");
196
+
197
+ expect(result).toContain(
198
+ "import { db, unsafeAllowAllGqlPermission, unsafeAllowAllTypePermission }",
199
+ );
200
+ expect(result).toContain("export const item = db");
201
+ expect(result).toContain('.type("Item"');
202
+ expect(result).toContain("// TODO: define fields");
203
+ expect(result).toContain("...db.fields.timestamps()");
204
+ expect(result).toContain(".permission(unsafeAllowAllTypePermission)");
205
+ expect(result).toContain(".gqlPermission(unsafeAllowAllGqlPermission)");
206
+ });
207
+
208
+ it("handles camelCase model names", () => {
209
+ const result = generateDbStub("taxonomyNode");
210
+
211
+ expect(result).toContain("export const taxonomyNode = db");
212
+ expect(result).toContain('.type("TaxonomyNode"');
213
+ });
214
+ });
215
+
181
216
  describe("generateQueryTestStub", () => {
182
217
  it("generates a test stub with createMockDb and run import", () => {
183
218
  const doc: ParsedCommandDoc = {
@@ -189,7 +224,7 @@ describe("generateQueryTestStub", () => {
189
224
  const result = generateQueryTestStub(doc);
190
225
 
191
226
  expect(result).toContain('import { describe, expect, it } from "vitest";');
192
- expect(result).toContain('import { createMockDb } from "../../testing/index";');
227
+ expect(result).toContain('import { createMockDb } from "../../../testing/index";');
193
228
  expect(result).toContain('import type { DB } from "../generated/kysely-tailordb";');
194
229
  expect(result).toContain('import { run, type GetTaxonomyNodeInput } from "./getTaxonomyNode";');
195
230
  expect(result).toContain('describe("getTaxonomyNode"');
@@ -1,10 +1,16 @@
1
1
  import fs from "node:fs";
2
2
  import path from "node:path";
3
+ import { PACKAGE_ROOT, readErpKitVersion } from "../util";
3
4
  import { parseCommandDoc, errorCodeToClassName, type ParsedCommandDoc } from "./parse-command-doc";
4
5
 
5
- export function generateErrors(docs: ParsedCommandDoc[]): string {
6
+ export function moduleNameToPrefix(moduleName: string): string {
7
+ return moduleName.toUpperCase().replace(/-/g, "_");
8
+ }
9
+
10
+ export function generateErrors(moduleName: string, docs: ParsedCommandDoc[]): string {
6
11
  const seen = new Set<string>();
7
12
  const lines: string[] = [];
13
+ const prefix = moduleNameToPrefix(moduleName);
8
14
 
9
15
  for (const doc of docs) {
10
16
  for (const error of doc.errors) {
@@ -12,8 +18,9 @@ export function generateErrors(docs: ParsedCommandDoc[]): string {
12
18
  seen.add(error.code);
13
19
 
14
20
  const className = errorCodeToClassName(error.code);
21
+ const prefixedCode = `${prefix}_${error.code}`;
15
22
  lines.push(`export const ${className} = createDomainError(`);
16
- lines.push(` "${className}", "${error.code}",`);
23
+ lines.push(` "${className}", "${prefixedCode}",`);
17
24
  const escapedDesc = error.description.replace(/`/g, "'");
18
25
  lines.push(` (identifier: string) => \`${escapedDesc}: \${identifier}\`,`);
19
26
  lines.push(`);`);
@@ -24,7 +31,7 @@ export function generateErrors(docs: ParsedCommandDoc[]): string {
24
31
  if (lines.length === 0) return "";
25
32
 
26
33
  return `// @generated — do not edit
27
- import { createDomainError } from "../../shared/internal";
34
+ import { createDomainError } from "../../../shared";
28
35
 
29
36
  ${lines.join("\n")}`;
30
37
  }
@@ -33,14 +40,14 @@ export function generateCommandStub(doc: ParsedCommandDoc): string {
33
40
  const pascal = doc.commandName.charAt(0).toUpperCase() + doc.commandName.slice(1);
34
41
  const inputType = `${pascal}Input`;
35
42
 
36
- return `import { ok, type CommandContext } from "../../shared/internal";
37
- import type { DB } from "../generated/kysely-tailordb";
43
+ return `import { ok, type CommandContext } from "../../../shared";
44
+ import type { Transaction } from "../generated/kysely-tailordb";
38
45
 
39
46
  export interface ${inputType} {
40
47
  // TODO: define input fields
41
48
  }
42
49
 
43
- export async function run(db: DB, input: ${inputType}, ctx: CommandContext) {
50
+ export async function run(db: Transaction, input: ${inputType}, ctx: CommandContext) {
44
51
  // TODO: implement
45
52
  return ok({});
46
53
  }
@@ -51,9 +58,9 @@ export function generateTestStub(doc: ParsedCommandDoc): string {
51
58
  const pascal = doc.commandName.charAt(0).toUpperCase() + doc.commandName.slice(1);
52
59
 
53
60
  return `import { describe, expect, it } from "vitest";
54
- import { createMockDb } from "../../testing/index";
55
- import type { CommandContext } from "../../shared/internal";
56
- import type { DB } from "../generated/kysely-tailordb";
61
+ import { createMockDb } from "../../../testing/index";
62
+ import type { CommandContext } from "../../../shared";
63
+ import type { Transaction } from "../generated/kysely-tailordb";
57
64
  import { run, ${pascal}Input } from "./${doc.commandName}";
58
65
 
59
66
  describe("${doc.commandName} - test scenario", () => {
@@ -63,7 +70,7 @@ describe("${doc.commandName} - test scenario", () => {
63
70
  };
64
71
 
65
72
  it("should be implemented", async () => {
66
- const { db } = createMockDb<DB>();
73
+ const { db } = createMockDb<Transaction>();
67
74
  const result = await run(db, {} as ${pascal}Input, ctx);
68
75
  expect(result.ok).toBe(true);
69
76
  });
@@ -74,7 +81,7 @@ describe("${doc.commandName} - test scenario", () => {
74
81
  export function generateCommandShell(doc: ParsedCommandDoc): string {
75
82
  const lines: string[] = [
76
83
  `// @generated — do not edit`,
77
- `import { defineCommand } from "../../shared/internal";`,
84
+ `import { defineCommand } from "../../../shared";`,
78
85
  `import { permissions } from "../lib/permissions.generated";`,
79
86
  `import { run } from "./${doc.commandName}";`,
80
87
  ``,
@@ -88,7 +95,7 @@ export function generateCommandShell(doc: ParsedCommandDoc): string {
88
95
  export function generateQueryShell(doc: ParsedCommandDoc): string {
89
96
  const lines: string[] = [
90
97
  `// @generated — do not edit`,
91
- `import { defineQuery } from "../../shared/internal";`,
98
+ `import { defineQuery } from "../../../shared";`,
92
99
  `import { run } from "./${doc.commandName}";`,
93
100
  ``,
94
101
  `export const ${doc.commandName} = defineQuery(run);`,
@@ -102,7 +109,7 @@ export function generateQueryStub(doc: ParsedCommandDoc): string {
102
109
  const pascal = doc.commandName.charAt(0).toUpperCase() + doc.commandName.slice(1);
103
110
  const inputType = `${pascal}Input`;
104
111
 
105
- return `import type { ReadonlyDB } from "../../shared/internal";
112
+ return `import type { ReadonlyDB } from "../../../shared";
106
113
  import type { DB } from "../generated/kysely-tailordb";
107
114
 
108
115
  export interface ${inputType} {
@@ -121,7 +128,7 @@ export function generateQueryTestStub(doc: ParsedCommandDoc): string {
121
128
  const inputType = `${pascal}Input`;
122
129
 
123
130
  return `import { describe, expect, it } from "vitest";
124
- import { createMockDb } from "../../testing/index";
131
+ import { createMockDb } from "../../../testing/index";
125
132
  import type { DB } from "../generated/kysely-tailordb";
126
133
  import { run, type ${inputType} } from "./${doc.commandName}";
127
134
 
@@ -135,12 +142,25 @@ describe("${doc.commandName}", () => {
135
142
  `;
136
143
  }
137
144
 
145
+ export function generateDbStub(modelName: string): string {
146
+ return `import { db, unsafeAllowAllGqlPermission, unsafeAllowAllTypePermission } from "@tailor-platform/sdk";
147
+
148
+ export const ${modelName} = db
149
+ .type("${modelName.charAt(0).toUpperCase() + modelName.slice(1)}", {
150
+ // TODO: define fields
151
+ ...db.fields.timestamps(),
152
+ })
153
+ .permission(unsafeAllowAllTypePermission)
154
+ .gqlPermission(unsafeAllowAllGqlPermission);
155
+ `;
156
+ }
157
+
138
158
  export function generatePermissions(moduleName: string, commandNames: string[]): string {
139
159
  const sorted = [...commandNames].sort();
140
160
  const entries = sorted.map((name) => ` "${name}",`).join("\n");
141
161
 
142
162
  return `// @generated — do not edit
143
- import { definePermissions } from "../../shared/internal";
163
+ import { definePermissions } from "../../../shared";
144
164
 
145
165
  export const { permissions, own, all } = definePermissions("${moduleName}", [
146
166
  ${entries}
@@ -148,20 +168,83 @@ ${entries}
148
168
  `;
149
169
  }
150
170
 
171
+ // npm renames .gitignore during pack (npm/cli#5756).
172
+ // prepack copies .gitignore to __dot__gitignore to preserve it.
173
+ export function copyTemplateDir(
174
+ srcDir: string,
175
+ destDir: string,
176
+ replacements: Record<string, string>,
177
+ placeholderFiles: Set<string>,
178
+ ): void {
179
+ for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
180
+ const srcPath = path.join(srcDir, entry.name);
181
+ const destName = entry.name === "__dot__gitignore" ? ".gitignore" : entry.name;
182
+ const destPath = path.join(destDir, destName);
183
+
184
+ if (entry.isDirectory()) {
185
+ fs.mkdirSync(destPath, { recursive: true });
186
+ copyTemplateDir(srcPath, destPath, replacements, placeholderFiles);
187
+ } else {
188
+ if (fs.existsSync(destPath)) continue;
189
+ fs.mkdirSync(path.dirname(destPath), { recursive: true });
190
+ if (placeholderFiles.has(entry.name)) {
191
+ let content = fs.readFileSync(srcPath, "utf-8");
192
+ for (const [from, to] of Object.entries(replacements)) {
193
+ content = content.replaceAll(from, to);
194
+ }
195
+ fs.writeFileSync(destPath, content);
196
+ } else {
197
+ fs.copyFileSync(srcPath, destPath);
198
+ }
199
+ }
200
+ }
201
+ }
202
+
203
+ export function scaffoldModuleBoilerplate(moduleDir: string, moduleName: string): void {
204
+ const templateDir = path.join(PACKAGE_ROOT, "templates", "scaffold", "module");
205
+ const replacements = { "template-module": moduleName };
206
+ const placeholderFiles = new Set(["permissions.ts", "tailor.config.ts"]);
207
+ copyTemplateDir(templateDir, moduleDir, replacements, placeholderFiles);
208
+ }
209
+
210
+ export function scaffoldAppBoilerplate(appDir: string, appName: string): void {
211
+ const templateDir = path.join(PACKAGE_ROOT, "templates", "scaffold", "app");
212
+ const erpKitVersion = readErpKitVersion();
213
+ const replacements = {
214
+ "template-app-frontend": `${appName}-frontend`,
215
+ "template-app-backend": appName,
216
+ "template-app": appName,
217
+ '"workspace:*"': `"${erpKitVersion}"`,
218
+ };
219
+ const placeholderFiles = new Set(["package.json", "tailor.config.ts", "index.html"]);
220
+ copyTemplateDir(templateDir, appDir, replacements, placeholderFiles);
221
+ }
222
+
223
+ export function runGenerateAppCode(appPath: string): number {
224
+ const appName = path.basename(appPath);
225
+ scaffoldAppBoilerplate(appPath, appName);
226
+ console.log(`Generated boilerplate for ${appName}`);
227
+ return 0;
228
+ }
229
+
151
230
  export function runGenerateCode(modulePath: string, moduleName: string): number {
231
+ scaffoldModuleBoilerplate(modulePath, moduleName);
232
+
152
233
  const docsDir = path.join(modulePath, "docs", "commands");
153
234
  const libDir = path.join(modulePath, "lib");
154
235
  const commandDir = path.join(modulePath, "command");
155
236
 
156
237
  if (!fs.existsSync(docsDir)) {
157
- console.error(`No docs/commands/ directory found at ${docsDir}`);
158
- return 1;
238
+ console.log(`No docs/commands/ directory found skipping code generation`);
239
+ console.log(`Generated boilerplate for ${moduleName}`);
240
+ return 0;
159
241
  }
160
242
 
161
243
  const mdFiles = fs.readdirSync(docsDir).filter((f) => f.endsWith(".md"));
162
244
  if (mdFiles.length === 0) {
163
- console.error(`No command docs found in ${docsDir}`);
164
- return 1;
245
+ console.log(`No command docs found skipping code generation`);
246
+ console.log(`Generated boilerplate for ${moduleName}`);
247
+ return 0;
165
248
  }
166
249
 
167
250
  const parsedDocs: ParsedCommandDoc[] = [];
@@ -186,7 +269,7 @@ export function runGenerateCode(modulePath: string, moduleName: string): number
186
269
 
187
270
  let generated = 0;
188
271
 
189
- const errorsContent = generateErrors(allDocsForErrors);
272
+ const errorsContent = generateErrors(moduleName, allDocsForErrors);
190
273
  if (errorsContent) {
191
274
  fs.mkdirSync(libDir, { recursive: true });
192
275
  const errorsFile = path.join(libDir, "errors.generated.ts");
@@ -255,6 +338,26 @@ export function runGenerateCode(modulePath: string, moduleName: string): number
255
338
  }
256
339
  }
257
340
 
341
+ // Generate db stubs from docs/models/*.md
342
+ const modelDocsDir = path.join(modulePath, "docs", "models");
343
+ if (fs.existsSync(modelDocsDir)) {
344
+ const modelFiles = fs.readdirSync(modelDocsDir).filter((f) => f.endsWith(".md"));
345
+ if (modelFiles.length > 0) {
346
+ const dbDir = path.join(modulePath, "db");
347
+ fs.mkdirSync(dbDir, { recursive: true });
348
+
349
+ for (const file of modelFiles) {
350
+ const modelName = path.basename(file, ".md");
351
+ const camelName = modelName.charAt(0).toLowerCase() + modelName.slice(1);
352
+ const dbFile = path.join(dbDir, `${camelName}.ts`);
353
+ if (!fs.existsSync(dbFile)) {
354
+ fs.writeFileSync(dbFile, generateDbStub(camelName));
355
+ console.log(` scaffolded ${path.relative(modulePath, dbFile)}`);
356
+ }
357
+ }
358
+ }
359
+ }
360
+
258
361
  console.log(`Generated ${generated} file(s) for ${moduleName}`);
259
362
  return 0;
260
363
  }
@@ -5,7 +5,7 @@ import path from "node:path";
5
5
  import { describe, it, expect } from "vitest";
6
6
 
7
7
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
8
- const CLI_PATH = path.resolve(__dirname, "..", "dist", "cli.js");
8
+ const CLI_PATH = path.resolve(__dirname, "..", "dist", "cli.mjs");
9
9
  const REPO_ROOT = path.resolve(__dirname, "..", "..", "..");
10
10
 
11
11
  const skipReason = fs.existsSync(CLI_PATH) ? undefined : "Run `pnpm build` first";
@@ -15,7 +15,7 @@ describe.skipIf(skipReason)("integration", () => {
15
15
  try {
16
16
  const result = execFileSync(
17
17
  "node",
18
- [CLI_PATH, "module", "check", "--root", "packages/erp-kit/src/modules"],
18
+ [CLI_PATH, "module", "check", "--path", "packages/erp-kit/src/modules"],
19
19
  {
20
20
  cwd: REPO_ROOT,
21
21
  encoding: "utf-8",
@@ -35,7 +35,7 @@ describe.skipIf(skipReason)("integration", () => {
35
35
  try {
36
36
  const result = execFileSync(
37
37
  "node",
38
- [CLI_PATH, "module", "sync-check", "--root", "packages/erp-kit/src/modules"],
38
+ [CLI_PATH, "module", "sync-check", "--path", "packages/erp-kit/src/modules"],
39
39
  {
40
40
  cwd: REPO_ROOT,
41
41
  encoding: "utf-8",