forjajs 2.0.2 → 2.0.4

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 (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,377 +1,377 @@
1
- # 📑 Microservices Starter Kit - Complete Index
2
-
3
- ## 🚀 START HERE
4
-
5
- **New to this boilerplate?** Start with one of these:
6
- 1. **[GETTING-STARTED.md](./GETTING-STARTED.md)** (5 min) - Quick start guide
7
- 2. **[README.md](./README.md)** (15 min) - Full overview
8
- 3. **docker-compose up** - Run everything
9
-
10
- ---
11
-
12
- ## 📚 Documentation Files (Root)
13
-
14
- | File | Purpose | Read Time |
15
- |------|---------|-----------|
16
- | [GETTING-STARTED.md](./GETTING-STARTED.md) | ⚡ Quick start (30 seconds) | 5 min |
17
- | [README.md](./README.md) | 📖 Project overview & guide | 15 min |
18
- | [ARCHITECTURE.md](./ARCHITECTURE.md) | 🏗️ System design & topology | 20 min |
19
- | [API-EXAMPLES.md](./API-EXAMPLES.md) | 📝 Curl examples for all endpoints | 10 min |
20
- | [SUMMARY.md](./SUMMARY.md) | 📊 What was created | 10 min |
21
- | [MANIFEST.md](./MANIFEST.md) | ✅ Deliverables checklist | 5 min |
22
- | [INDEX.md](./INDEX.md) | 📑 This file | 3 min |
23
-
24
- ---
25
-
26
- ## 🧠 Memory System (Knowledge Base)
27
-
28
- ### Level 00: Global Context (5 files)
29
- The foundation - mission, patterns, policies
30
-
31
- | File | Purpose |
32
- |------|---------|
33
- | [memory/00-global/mission.md](./memory/00-global/mission.md) | 🎯 Vision & objectives |
34
- | [memory/00-global/patterns.md](./memory/00-global/patterns.md) | 🏗️ Architectural patterns |
35
- | [memory/00-global/context-policy.md](./memory/00-global/context-policy.md) | 📋 Request/response standards |
36
- | [memory/00-global/agent-contract.md](./memory/00-global/agent-contract.md) | 📜 Service contracts & SLAs |
37
- | [memory/00-global/index.md](./memory/00-global/index.md) | 🗺️ Navigation guide |
38
-
39
- ### Level 10: Product Context (1 file)
40
- Business vision and roadmap
41
-
42
- | File | Purpose |
43
- |------|---------|
44
- | [memory/10-product/vision.md](./memory/10-product/vision.md) | 👁️ Vision & roadmap |
45
-
46
- ### Level 20: Architecture (1 file)
47
- System design details
48
-
49
- | File | Purpose |
50
- |------|---------|
51
- | [memory/20-architecture/overview.md](./memory/20-architecture/overview.md) | 🏛️ Complete system architecture |
52
-
53
- ### Level 30: Domains (6 files)
54
- Three bounded contexts - Auth, User, Notification
55
-
56
- **Auth Service:**
57
- | File | Purpose |
58
- |------|---------|
59
- | [memory/30-domains/auth-service/context.md](./memory/30-domains/auth-service/context.md) | 🔐 Bounded context |
60
- | [memory/30-domains/auth-service/api.md](./memory/30-domains/auth-service/api.md) | 📡 API specification |
61
-
62
- **User Service:**
63
- | File | Purpose |
64
- |------|---------|
65
- | [memory/30-domains/user-service/context.md](./memory/30-domains/user-service/context.md) | 👤 Bounded context |
66
- | [memory/30-domains/user-service/api.md](./memory/30-domains/user-service/api.md) | 📡 API specification |
67
-
68
- **Notification Service:**
69
- | File | Purpose |
70
- |------|---------|
71
- | [memory/30-domains/notification-service/context.md](./memory/30-domains/notification-service/context.md) | 📧 Bounded context |
72
- | [memory/30-domains/notification-service/api.md](./memory/30-domains/notification-service/api.md) | 📡 API specification |
73
-
74
- ### Level 40-90: Other Levels
75
- Ready for your content
76
-
77
- | Level | Purpose | Status |
78
- |-------|---------|--------|
79
- | 40-delivery | Roadmap & sprints | 📝 Ready for content |
80
- | 50-orchestration | Service topology & routing | ✅ topology.md created |
81
- | 60-runs | Execution logs | 📝 Ready for content |
82
- | 70-summaries | Quick references | 📝 Ready for content |
83
- | 80-data | Database schemas | 📝 Ready for content |
84
- | 90-decisions | Architecture decisions (ADRs) | 📝 Ready for content |
85
-
86
- ---
87
-
88
- ## 🔗 Orchestration
89
-
90
- ### Service Topology
91
- - [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md) - Service discovery, ports, DNS
92
-
93
- ---
94
-
95
- ## 💻 Backend Code
96
-
97
- ### API Gateway (Entry Point, Port 3000)
98
- ```
99
- backend/api-gateway/
100
- ├── package.json
101
- ├── tsconfig.json
102
- ├── Dockerfile
103
- └── src/
104
- ├── main.ts
105
- ├── app.module.ts
106
- ├── gateway.controller.ts
107
- └── gateway.service.ts
108
- ```
109
-
110
- ### Auth Service (OAuth2, JWT, Port 3001)
111
- ```
112
- backend/services/auth-service/
113
- ├── package.json
114
- ├── tsconfig.json
115
- ├── Dockerfile
116
- └── src/
117
- ├── main.ts
118
- ├── app.module.ts
119
- └── modules/auth/
120
- ├── auth.module.ts
121
- ├── auth.service.ts
122
- ├── auth.controller.ts
123
- ├── jwt.strategy.ts
124
- └── local.strategy.ts
125
- ```
126
-
127
- ### User Service (Profiles, Port 3002)
128
- ```
129
- backend/services/user-service/
130
- ├── package.json
131
- ├── tsconfig.json
132
- ├── Dockerfile
133
- └── src/
134
- ├── main.ts
135
- ├── app.module.ts
136
- └── modules/user/
137
- ├── user.module.ts
138
- ├── user.service.ts
139
- └── user.controller.ts
140
- ```
141
-
142
- ### Notification Service (Emails, Push, Port 3003)
143
- ```
144
- backend/services/notification-service/
145
- ├── package.json
146
- ├── tsconfig.json
147
- ├── Dockerfile
148
- └── src/
149
- ├── main.ts
150
- ├── app.module.ts
151
- └── modules/notification/
152
- ├── notification.module.ts
153
- ├── notification.service.ts
154
- └── notification.controller.ts
155
- ```
156
-
157
- ### Shared Package (Types & Utils)
158
- ```
159
- backend/shared/
160
- ├── package.json
161
- ├── tsconfig.json
162
- └── src/
163
- ├── index.ts
164
- ├── interfaces/
165
- ├── constants/
166
- ├── utils/
167
- └── decorators/
168
- ```
169
-
170
- ---
171
-
172
- ## 🐳 Infrastructure
173
-
174
- ### Docker Compose
175
- - [docker-compose.yml](./docker-compose.yml) - Complete orchestration
176
-
177
- **Services Running:**
178
- - api-gateway:3000
179
- - auth-service:3001 + PostgreSQL
180
- - user-service:3002 + PostgreSQL
181
- - notification-service:3003
182
- - RabbitMQ:5672 (Admin:15672)
183
- - Redis:6379
184
-
185
- ### Configuration
186
- - [.env.example](./.env.example) - Environment template
187
-
188
- ---
189
-
190
- ## 📡 API Endpoints
191
-
192
- ### Quick Reference
193
- **[API-EXAMPLES.md](./API-EXAMPLES.md)** has curl examples for all endpoints
194
-
195
- **Summary:**
196
- - Auth Service: 5 endpoints + health
197
- - User Service: 8 endpoints + health
198
- - Notification Service: 5 endpoints + health
199
- - **Total: 20 endpoints**
200
-
201
- ---
202
-
203
- ## 🔍 How to Navigate
204
-
205
- ### By Role
206
-
207
- **Architect/Tech Lead:**
208
- 1. Read [ARCHITECTURE.md](./ARCHITECTURE.md)
209
- 2. Review [memory/00-global/patterns.md](./memory/00-global/patterns.md)
210
- 3. Check [memory/20-architecture/overview.md](./memory/20-architecture/overview.md)
211
- 4. Study [memory/30-domains/](./memory/30-domains/) for service boundaries
212
-
213
- **Backend Developer:**
214
- 1. Start [GETTING-STARTED.md](./GETTING-STARTED.md)
215
- 2. Run `docker-compose up`
216
- 3. Test with [API-EXAMPLES.md](./API-EXAMPLES.md)
217
- 4. Explore service code in `backend/services/`
218
- 5. Check [memory/30-domains/*/api.md](./memory/30-domains/) for specs
219
-
220
- **DevOps/Infrastructure:**
221
- 1. Review [docker-compose.yml](./docker-compose.yml)
222
- 2. Check [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
223
- 3. See `.env.example` for configuration
224
- 4. Review Dockerfiles in `backend/*/`
225
-
226
- **Product Manager:**
227
- 1. Read [memory/10-product/vision.md](./memory/10-product/vision.md)
228
- 2. Check [memory/30-domains/](./memory/30-domains/) for feature specs
229
- 3. Review [ARCHITECTURE.md](./ARCHITECTURE.md) for capabilities
230
-
231
- ### By Task
232
-
233
- **Setting up locally:**
234
- 1. [GETTING-STARTED.md](./GETTING-STARTED.md)
235
- 2. Run `docker-compose up`
236
-
237
- **Learning the API:**
238
- 1. [API-EXAMPLES.md](./API-EXAMPLES.md)
239
- 2. Read [memory/30-domains/*/api.md](./memory/30-domains/)
240
-
241
- **Understanding architecture:**
242
- 1. [ARCHITECTURE.md](./ARCHITECTURE.md)
243
- 2. [memory/20-architecture/overview.md](./memory/20-architecture/overview.md)
244
- 3. [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
245
-
246
- **Extending services:**
247
- 1. [memory/00-global/patterns.md](./memory/00-global/patterns.md)
248
- 2. Look at existing service in `backend/services/`
249
- 3. Check [memory/30-domains/*/context.md](./memory/30-domains/) for DDD patterns
250
-
251
- **Deploying to production:**
252
- 1. [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
253
- 2. Modify docker-compose.yml for your environment
254
- 3. Deploy to Kubernetes (structure is K8s-ready)
255
-
256
- ---
257
-
258
- ## 🎯 Service Descriptions
259
-
260
- ### Auth Service 🔐
261
- - **Purpose:** Authentication & authorization
262
- - **Endpoints:** 5 (register, login, refresh, verify, logout)
263
- - **Database:** PostgreSQL (auth_db)
264
- - **Tech:** Passport.js, JWT, bcrypt
265
- - **File:** [memory/30-domains/auth-service/](./memory/30-domains/auth-service/)
266
-
267
- ### User Service 👤
268
- - **Purpose:** User profiles & settings
269
- - **Endpoints:** 8 (CRUD + settings + verify email + list)
270
- - **Database:** PostgreSQL (users_db)
271
- - **Tech:** NestJS, TypeScript
272
- - **File:** [memory/30-domains/user-service/](./memory/30-domains/user-service/)
273
-
274
- ### Notification Service 📧
275
- - **Purpose:** Multi-channel notifications
276
- - **Endpoints:** 5 (email, push, status, list, templates)
277
- - **Storage:** Redis only (stateless)
278
- - **Tech:** RabbitMQ consumer, templates
279
- - **File:** [memory/30-domains/notification-service/](./memory/30-domains/notification-service/)
280
-
281
- ### API Gateway 🚪
282
- - **Purpose:** Entry point & routing
283
- - **Endpoints:** All above services
284
- - **Features:** CORS, error handling, service discovery
285
- - **Tech:** NestJS, Axios
286
- - **Code:** [backend/api-gateway/](./backend/api-gateway/)
287
-
288
- ---
289
-
290
- ## 📊 Statistics
291
-
292
- | Metric | Count |
293
- |--------|-------|
294
- | Root documentation files | 8 |
295
- | Memory markdown files | 14+ |
296
- | Backend services | 4 |
297
- | API endpoints | 20 |
298
- | TypeScript files | 15+ |
299
- | Configuration files | 20+ |
300
- | Docker files | 5 |
301
- | Total files | 62+ |
302
- | Lines of documentation | 2,675+ |
303
- | Lines of code (TS) | 2,500+ |
304
-
305
- ---
306
-
307
- ## ✅ Quick Checklist
308
-
309
- Getting started:
310
- - [ ] Read [GETTING-STARTED.md](./GETTING-STARTED.md)
311
- - [ ] Run `docker-compose up`
312
- - [ ] Test login with provided credentials
313
- - [ ] Try API examples from [API-EXAMPLES.md](./API-EXAMPLES.md)
314
- - [ ] Read [README.md](./README.md) for overview
315
- - [ ] Explore [ARCHITECTURE.md](./ARCHITECTURE.md)
316
- - [ ] Check service code in `backend/services/`
317
- - [ ] Review memory system for deeper knowledge
318
-
319
- ---
320
-
321
- ## 🎓 Learning Path
322
-
323
- **30 Minutes:**
324
- 1. GETTING-STARTED.md (5 min)
325
- 2. docker-compose up (5 min)
326
- 3. Test API examples (10 min)
327
- 4. Explore endpoints (10 min)
328
-
329
- **2 Hours:**
330
- 1. README.md (15 min)
331
- 2. ARCHITECTURE.md (20 min)
332
- 3. API-EXAMPLES.md (10 min)
333
- 4. Explore code (30 min)
334
- 5. memory/30-domains/ (45 min)
335
-
336
- **4 Hours:**
337
- 1. All above + 2 more hours
338
- 2. memory/00-global/ (30 min)
339
- 3. memory/20-architecture/overview.md (20 min)
340
- 4. memory/50-orchestration/topology.md (20 min)
341
- 5. Review all backend code (30 min)
342
-
343
- ---
344
-
345
- ## 🔗 External Links
346
-
347
- **Technologies:**
348
- - [NestJS Documentation](https://docs.nestjs.com/)
349
- - [Docker Documentation](https://docs.docker.com/)
350
- - [RabbitMQ Documentation](https://www.rabbitmq.com/documentation.html)
351
- - [PostgreSQL Documentation](https://www.postgresql.org/docs/)
352
- - [Redis Documentation](https://redis.io/documentation)
353
-
354
- ---
355
-
356
- ## 📞 Questions?
357
-
358
- Check these files in order:
359
- 1. [README.md](./README.md) - General questions
360
- 2. [ARCHITECTURE.md](./ARCHITECTURE.md) - Design questions
361
- 3. [API-EXAMPLES.md](./API-EXAMPLES.md) - API questions
362
- 4. [memory/](./memory/) - Deep knowledge
363
- 5. Source code comments
364
-
365
- ---
366
-
367
- ## 🎉 You're Ready!
368
-
369
- Everything is here. Pick a starting point above and begin exploring!
370
-
371
- **Recommended first step:** Read [GETTING-STARTED.md](./GETTING-STARTED.md) then run `docker-compose up`
372
-
373
- ---
374
-
375
- **Last Updated:** 2024
376
- **Status:** ✅ Complete & Ready to Use
377
- **Version:** 1.0
1
+ # 📑 Microservices Starter Kit - Complete Index
2
+
3
+ ## 🚀 START HERE
4
+
5
+ **New to this boilerplate?** Start with one of these:
6
+ 1. **[GETTING-STARTED.md](./GETTING-STARTED.md)** (5 min) - Quick start guide
7
+ 2. **[README.md](./README.md)** (15 min) - Full overview
8
+ 3. **docker-compose up** - Run everything
9
+
10
+ ---
11
+
12
+ ## 📚 Documentation Files (Root)
13
+
14
+ | File | Purpose | Read Time |
15
+ |------|---------|-----------|
16
+ | [GETTING-STARTED.md](./GETTING-STARTED.md) | ⚡ Quick start (30 seconds) | 5 min |
17
+ | [README.md](./README.md) | 📖 Project overview & guide | 15 min |
18
+ | [ARCHITECTURE.md](./ARCHITECTURE.md) | 🏗️ System design & topology | 20 min |
19
+ | [API-EXAMPLES.md](./API-EXAMPLES.md) | 📝 Curl examples for all endpoints | 10 min |
20
+ | [SUMMARY.md](./SUMMARY.md) | 📊 What was created | 10 min |
21
+ | [MANIFEST.md](./MANIFEST.md) | ✅ Deliverables checklist | 5 min |
22
+ | [INDEX.md](./INDEX.md) | 📑 This file | 3 min |
23
+
24
+ ---
25
+
26
+ ## 🧠 Memory System (Knowledge Base)
27
+
28
+ ### Level 00: Global Context (5 files)
29
+ The foundation - mission, patterns, policies
30
+
31
+ | File | Purpose |
32
+ |------|---------|
33
+ | [memory/00-global/mission.md](./memory/00-global/mission.md) | 🎯 Vision & objectives |
34
+ | [memory/00-global/patterns.md](./memory/00-global/patterns.md) | 🏗️ Architectural patterns |
35
+ | [memory/00-global/context-policy.md](./memory/00-global/context-policy.md) | 📋 Request/response standards |
36
+ | [memory/00-global/agent-contract.md](./memory/00-global/agent-contract.md) | 📜 Service contracts & SLAs |
37
+ | [memory/00-global/index.md](./memory/00-global/index.md) | 🗺️ Navigation guide |
38
+
39
+ ### Level 10: Product Context (1 file)
40
+ Business vision and roadmap
41
+
42
+ | File | Purpose |
43
+ |------|---------|
44
+ | [memory/10-product/vision.md](./memory/10-product/vision.md) | 👁️ Vision & roadmap |
45
+
46
+ ### Level 20: Architecture (1 file)
47
+ System design details
48
+
49
+ | File | Purpose |
50
+ |------|---------|
51
+ | [memory/20-architecture/overview.md](./memory/20-architecture/overview.md) | 🏛️ Complete system architecture |
52
+
53
+ ### Level 30: Domains (6 files)
54
+ Three bounded contexts - Auth, User, Notification
55
+
56
+ **Auth Service:**
57
+ | File | Purpose |
58
+ |------|---------|
59
+ | [memory/30-domains/auth-service/context.md](./memory/30-domains/auth-service/context.md) | 🔐 Bounded context |
60
+ | [memory/30-domains/auth-service/api.md](./memory/30-domains/auth-service/api.md) | 📡 API specification |
61
+
62
+ **User Service:**
63
+ | File | Purpose |
64
+ |------|---------|
65
+ | [memory/30-domains/user-service/context.md](./memory/30-domains/user-service/context.md) | 👤 Bounded context |
66
+ | [memory/30-domains/user-service/api.md](./memory/30-domains/user-service/api.md) | 📡 API specification |
67
+
68
+ **Notification Service:**
69
+ | File | Purpose |
70
+ |------|---------|
71
+ | [memory/30-domains/notification-service/context.md](./memory/30-domains/notification-service/context.md) | 📧 Bounded context |
72
+ | [memory/30-domains/notification-service/api.md](./memory/30-domains/notification-service/api.md) | 📡 API specification |
73
+
74
+ ### Level 40-90: Other Levels
75
+ Ready for your content
76
+
77
+ | Level | Purpose | Status |
78
+ |-------|---------|--------|
79
+ | 40-delivery | Roadmap & sprints | 📝 Ready for content |
80
+ | 50-orchestration | Service topology & routing | ✅ topology.md created |
81
+ | 60-runs | Execution logs | 📝 Ready for content |
82
+ | 70-summaries | Quick references | 📝 Ready for content |
83
+ | 80-data | Database schemas | 📝 Ready for content |
84
+ | 90-decisions | Architecture decisions (ADRs) | 📝 Ready for content |
85
+
86
+ ---
87
+
88
+ ## 🔗 Orchestration
89
+
90
+ ### Service Topology
91
+ - [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md) - Service discovery, ports, DNS
92
+
93
+ ---
94
+
95
+ ## 💻 Backend Code
96
+
97
+ ### API Gateway (Entry Point, Port 3000)
98
+ ```
99
+ backend/api-gateway/
100
+ ├── package.json
101
+ ├── tsconfig.json
102
+ ├── Dockerfile
103
+ └── src/
104
+ ├── main.ts
105
+ ├── app.module.ts
106
+ ├── gateway.controller.ts
107
+ └── gateway.service.ts
108
+ ```
109
+
110
+ ### Auth Service (OAuth2, JWT, Port 3001)
111
+ ```
112
+ backend/services/auth-service/
113
+ ├── package.json
114
+ ├── tsconfig.json
115
+ ├── Dockerfile
116
+ └── src/
117
+ ├── main.ts
118
+ ├── app.module.ts
119
+ └── modules/auth/
120
+ ├── auth.module.ts
121
+ ├── auth.service.ts
122
+ ├── auth.controller.ts
123
+ ├── jwt.strategy.ts
124
+ └── local.strategy.ts
125
+ ```
126
+
127
+ ### User Service (Profiles, Port 3002)
128
+ ```
129
+ backend/services/user-service/
130
+ ├── package.json
131
+ ├── tsconfig.json
132
+ ├── Dockerfile
133
+ └── src/
134
+ ├── main.ts
135
+ ├── app.module.ts
136
+ └── modules/user/
137
+ ├── user.module.ts
138
+ ├── user.service.ts
139
+ └── user.controller.ts
140
+ ```
141
+
142
+ ### Notification Service (Emails, Push, Port 3003)
143
+ ```
144
+ backend/services/notification-service/
145
+ ├── package.json
146
+ ├── tsconfig.json
147
+ ├── Dockerfile
148
+ └── src/
149
+ ├── main.ts
150
+ ├── app.module.ts
151
+ └── modules/notification/
152
+ ├── notification.module.ts
153
+ ├── notification.service.ts
154
+ └── notification.controller.ts
155
+ ```
156
+
157
+ ### Shared Package (Types & Utils)
158
+ ```
159
+ backend/shared/
160
+ ├── package.json
161
+ ├── tsconfig.json
162
+ └── src/
163
+ ├── index.ts
164
+ ├── interfaces/
165
+ ├── constants/
166
+ ├── utils/
167
+ └── decorators/
168
+ ```
169
+
170
+ ---
171
+
172
+ ## 🐳 Infrastructure
173
+
174
+ ### Docker Compose
175
+ - [docker-compose.yml](./docker-compose.yml) - Complete orchestration
176
+
177
+ **Services Running:**
178
+ - api-gateway:3000
179
+ - auth-service:3001 + PostgreSQL
180
+ - user-service:3002 + PostgreSQL
181
+ - notification-service:3003
182
+ - RabbitMQ:5672 (Admin:15672)
183
+ - Redis:6379
184
+
185
+ ### Configuration
186
+ - [.env.example](./.env.example) - Environment template
187
+
188
+ ---
189
+
190
+ ## 📡 API Endpoints
191
+
192
+ ### Quick Reference
193
+ **[API-EXAMPLES.md](./API-EXAMPLES.md)** has curl examples for all endpoints
194
+
195
+ **Summary:**
196
+ - Auth Service: 5 endpoints + health
197
+ - User Service: 8 endpoints + health
198
+ - Notification Service: 5 endpoints + health
199
+ - **Total: 20 endpoints**
200
+
201
+ ---
202
+
203
+ ## 🔍 How to Navigate
204
+
205
+ ### By Role
206
+
207
+ **Architect/Tech Lead:**
208
+ 1. Read [ARCHITECTURE.md](./ARCHITECTURE.md)
209
+ 2. Review [memory/00-global/patterns.md](./memory/00-global/patterns.md)
210
+ 3. Check [memory/20-architecture/overview.md](./memory/20-architecture/overview.md)
211
+ 4. Study [memory/30-domains/](./memory/30-domains/) for service boundaries
212
+
213
+ **Backend Developer:**
214
+ 1. Start [GETTING-STARTED.md](./GETTING-STARTED.md)
215
+ 2. Run `docker-compose up`
216
+ 3. Test with [API-EXAMPLES.md](./API-EXAMPLES.md)
217
+ 4. Explore service code in `backend/services/`
218
+ 5. Check [memory/30-domains/*/api.md](./memory/30-domains/) for specs
219
+
220
+ **DevOps/Infrastructure:**
221
+ 1. Review [docker-compose.yml](./docker-compose.yml)
222
+ 2. Check [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
223
+ 3. See `.env.example` for configuration
224
+ 4. Review Dockerfiles in `backend/*/`
225
+
226
+ **Product Manager:**
227
+ 1. Read [memory/10-product/vision.md](./memory/10-product/vision.md)
228
+ 2. Check [memory/30-domains/](./memory/30-domains/) for feature specs
229
+ 3. Review [ARCHITECTURE.md](./ARCHITECTURE.md) for capabilities
230
+
231
+ ### By Task
232
+
233
+ **Setting up locally:**
234
+ 1. [GETTING-STARTED.md](./GETTING-STARTED.md)
235
+ 2. Run `docker-compose up`
236
+
237
+ **Learning the API:**
238
+ 1. [API-EXAMPLES.md](./API-EXAMPLES.md)
239
+ 2. Read [memory/30-domains/*/api.md](./memory/30-domains/)
240
+
241
+ **Understanding architecture:**
242
+ 1. [ARCHITECTURE.md](./ARCHITECTURE.md)
243
+ 2. [memory/20-architecture/overview.md](./memory/20-architecture/overview.md)
244
+ 3. [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
245
+
246
+ **Extending services:**
247
+ 1. [memory/00-global/patterns.md](./memory/00-global/patterns.md)
248
+ 2. Look at existing service in `backend/services/`
249
+ 3. Check [memory/30-domains/*/context.md](./memory/30-domains/) for DDD patterns
250
+
251
+ **Deploying to production:**
252
+ 1. [memory/50-orchestration/topology.md](./memory/50-orchestration/topology.md)
253
+ 2. Modify docker-compose.yml for your environment
254
+ 3. Deploy to Kubernetes (structure is K8s-ready)
255
+
256
+ ---
257
+
258
+ ## 🎯 Service Descriptions
259
+
260
+ ### Auth Service 🔐
261
+ - **Purpose:** Authentication & authorization
262
+ - **Endpoints:** 5 (register, login, refresh, verify, logout)
263
+ - **Database:** PostgreSQL (auth_db)
264
+ - **Tech:** Passport.js, JWT, bcrypt
265
+ - **File:** [memory/30-domains/auth-service/](./memory/30-domains/auth-service/)
266
+
267
+ ### User Service 👤
268
+ - **Purpose:** User profiles & settings
269
+ - **Endpoints:** 8 (CRUD + settings + verify email + list)
270
+ - **Database:** PostgreSQL (users_db)
271
+ - **Tech:** NestJS, TypeScript
272
+ - **File:** [memory/30-domains/user-service/](./memory/30-domains/user-service/)
273
+
274
+ ### Notification Service 📧
275
+ - **Purpose:** Multi-channel notifications
276
+ - **Endpoints:** 5 (email, push, status, list, templates)
277
+ - **Storage:** Redis only (stateless)
278
+ - **Tech:** RabbitMQ consumer, templates
279
+ - **File:** [memory/30-domains/notification-service/](./memory/30-domains/notification-service/)
280
+
281
+ ### API Gateway 🚪
282
+ - **Purpose:** Entry point & routing
283
+ - **Endpoints:** All above services
284
+ - **Features:** CORS, error handling, service discovery
285
+ - **Tech:** NestJS, Axios
286
+ - **Code:** [backend/api-gateway/](./backend/api-gateway/)
287
+
288
+ ---
289
+
290
+ ## 📊 Statistics
291
+
292
+ | Metric | Count |
293
+ |--------|-------|
294
+ | Root documentation files | 8 |
295
+ | Memory markdown files | 14+ |
296
+ | Backend services | 4 |
297
+ | API endpoints | 20 |
298
+ | TypeScript files | 15+ |
299
+ | Configuration files | 20+ |
300
+ | Docker files | 5 |
301
+ | Total files | 62+ |
302
+ | Lines of documentation | 2,675+ |
303
+ | Lines of code (TS) | 2,500+ |
304
+
305
+ ---
306
+
307
+ ## ✅ Quick Checklist
308
+
309
+ Getting started:
310
+ - [ ] Read [GETTING-STARTED.md](./GETTING-STARTED.md)
311
+ - [ ] Run `docker-compose up`
312
+ - [ ] Test login with provided credentials
313
+ - [ ] Try API examples from [API-EXAMPLES.md](./API-EXAMPLES.md)
314
+ - [ ] Read [README.md](./README.md) for overview
315
+ - [ ] Explore [ARCHITECTURE.md](./ARCHITECTURE.md)
316
+ - [ ] Check service code in `backend/services/`
317
+ - [ ] Review memory system for deeper knowledge
318
+
319
+ ---
320
+
321
+ ## 🎓 Learning Path
322
+
323
+ **30 Minutes:**
324
+ 1. GETTING-STARTED.md (5 min)
325
+ 2. docker-compose up (5 min)
326
+ 3. Test API examples (10 min)
327
+ 4. Explore endpoints (10 min)
328
+
329
+ **2 Hours:**
330
+ 1. README.md (15 min)
331
+ 2. ARCHITECTURE.md (20 min)
332
+ 3. API-EXAMPLES.md (10 min)
333
+ 4. Explore code (30 min)
334
+ 5. memory/30-domains/ (45 min)
335
+
336
+ **4 Hours:**
337
+ 1. All above + 2 more hours
338
+ 2. memory/00-global/ (30 min)
339
+ 3. memory/20-architecture/overview.md (20 min)
340
+ 4. memory/50-orchestration/topology.md (20 min)
341
+ 5. Review all backend code (30 min)
342
+
343
+ ---
344
+
345
+ ## 🔗 External Links
346
+
347
+ **Technologies:**
348
+ - [NestJS Documentation](https://docs.nestjs.com/)
349
+ - [Docker Documentation](https://docs.docker.com/)
350
+ - [RabbitMQ Documentation](https://www.rabbitmq.com/documentation.html)
351
+ - [PostgreSQL Documentation](https://www.postgresql.org/docs/)
352
+ - [Redis Documentation](https://redis.io/documentation)
353
+
354
+ ---
355
+
356
+ ## 📞 Questions?
357
+
358
+ Check these files in order:
359
+ 1. [README.md](./README.md) - General questions
360
+ 2. [ARCHITECTURE.md](./ARCHITECTURE.md) - Design questions
361
+ 3. [API-EXAMPLES.md](./API-EXAMPLES.md) - API questions
362
+ 4. [memory/](./memory/) - Deep knowledge
363
+ 5. Source code comments
364
+
365
+ ---
366
+
367
+ ## 🎉 You're Ready!
368
+
369
+ Everything is here. Pick a starting point above and begin exploring!
370
+
371
+ **Recommended first step:** Read [GETTING-STARTED.md](./GETTING-STARTED.md) then run `docker-compose up`
372
+
373
+ ---
374
+
375
+ **Last Updated:** 2024
376
+ **Status:** ✅ Complete & Ready to Use
377
+ **Version:** 1.0