forjajs 1.1.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 (558) hide show
  1. package/.claude/agents/context-engineer.md +25 -0
  2. package/.claude/agents/governance.md +32 -0
  3. package/.claude/agents/marketing.md +24 -0
  4. package/.claude/agents/orchestrator.md +31 -0
  5. package/.claude/agents/product.md +26 -0
  6. package/.claude/agents/sdd-architect.md +34 -0
  7. package/.claude/settings.json +41 -0
  8. package/.gemini-instructions.md +87 -0
  9. package/.github/copilot-instructions.md +87 -0
  10. package/.memoryrc.json +104 -0
  11. package/.openai-instructions.md +87 -0
  12. package/AGENTS.md +132 -0
  13. package/CHANGELOG.md +106 -0
  14. package/CONTRIBUTING.md +32 -0
  15. package/DOC-MAP.md +65 -0
  16. package/LICENSE +21 -0
  17. package/README.md +260 -0
  18. package/bin/create-memory-nest-kit.js +125 -0
  19. package/bin/forja.mjs +143 -0
  20. package/bin/init-project.js +612 -0
  21. package/boilerplates/01-api-rest/README.md +336 -0
  22. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
  23. package/boilerplates/02-saas-starter/.env.example +25 -0
  24. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
  25. package/boilerplates/02-saas-starter/INFO.md +252 -0
  26. package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
  27. package/boilerplates/02-saas-starter/README.md +305 -0
  28. package/boilerplates/02-saas-starter/START-HERE.md +259 -0
  29. package/boilerplates/02-saas-starter/backend/package.json +87 -0
  30. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
  31. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
  33. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
  34. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
  35. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
  36. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
  42. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
  46. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
  50. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
  54. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
  58. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
  59. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
  60. package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
  61. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
  62. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
  63. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
  64. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
  65. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
  66. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
  67. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
  68. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
  69. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
  70. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
  71. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
  73. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
  75. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
  77. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
  78. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
  79. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
  80. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
  81. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
  82. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
  83. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
  84. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
  85. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
  86. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
  87. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
  88. package/boilerplates/03-ecommerce-starter/README.md +465 -0
  89. package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
  98. package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
  99. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
  113. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
  114. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
  115. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
  116. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
  117. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
  118. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
  123. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
  126. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
  130. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
  134. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
  135. package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
  136. package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
  137. package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
  138. package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
  139. package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
  140. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
  141. package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
  142. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
  143. package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
  144. package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
  145. package/boilerplates/04-microservices-starter/.env.example +43 -0
  146. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
  147. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
  148. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
  149. package/boilerplates/04-microservices-starter/INDEX.md +377 -0
  150. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
  151. package/boilerplates/04-microservices-starter/README.md +466 -0
  152. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
  153. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
  154. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
  155. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
  156. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
  157. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
  158. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
  159. package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
  160. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
  161. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
  162. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
  163. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
  164. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
  165. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
  166. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
  167. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
  168. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
  169. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
  170. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
  171. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
  172. package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
  173. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
  174. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
  175. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
  176. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
  177. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
  178. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
  179. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
  180. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
  181. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
  182. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
  183. package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
  184. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
  185. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
  186. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
  187. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
  188. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
  189. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
  190. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
  191. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
  192. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
  193. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
  194. package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
  195. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
  196. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
  197. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
  198. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
  199. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
  200. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
  201. package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
  202. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
  203. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
  204. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
  205. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
  206. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
  207. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
  208. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
  209. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
  210. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
  211. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
  212. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
  213. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
  214. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
  215. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
  216. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
  217. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
  218. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
  219. package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
  220. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
  221. package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
  222. package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
  223. package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
  224. package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
  225. package/boilerplates/04-microservices-starter/package.json +21 -0
  226. package/boilerplates/05-monorepo-starter/.env.example +1 -0
  227. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
  228. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
  229. package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
  230. package/boilerplates/05-monorepo-starter/README.md +318 -0
  231. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
  232. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
  233. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
  234. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
  235. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
  236. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
  237. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
  238. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
  239. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
  240. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
  241. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
  242. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
  243. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
  244. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
  245. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
  246. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
  247. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
  248. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
  249. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
  250. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
  251. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
  252. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
  253. package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
  254. package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
  255. package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
  256. package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
  257. package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
  258. package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
  259. package/boilerplates/05-monorepo-starter/package.json +30 -0
  260. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
  261. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
  262. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
  263. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
  264. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
  265. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
  266. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
  267. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
  268. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
  269. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
  270. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
  271. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
  272. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
  273. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
  274. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
  275. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
  276. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
  277. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
  278. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
  279. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
  280. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
  281. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
  282. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
  283. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
  284. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
  285. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
  286. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
  287. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
  288. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
  289. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
  290. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
  291. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
  292. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
  293. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
  294. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
  295. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
  296. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
  297. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
  298. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
  299. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
  300. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
  301. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
  302. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
  303. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
  304. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
  305. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
  306. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
  307. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
  308. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
  309. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
  310. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
  311. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
  312. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
  313. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
  314. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
  315. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
  316. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
  317. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
  318. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
  319. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
  320. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
  321. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
  322. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
  323. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
  324. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
  325. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
  326. package/boilerplates/05-monorepo-starter/turbo.json +35 -0
  327. package/boilerplates/README.md +407 -0
  328. package/design-md/BRIEF-TEMPLATE.md +47 -0
  329. package/design-md/INDEX.md +35 -0
  330. package/design-md/MATRIX.md +24 -0
  331. package/design-md/PLAYBOOK.md +35 -0
  332. package/design-md/examples/agent-console-brief.md +48 -0
  333. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
  334. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
  335. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
  336. package/docs/agent-harnesses.md +122 -0
  337. package/docs/archive/CHECKLIST-FINAL.md +295 -0
  338. package/docs/archive/FASE2-SUMMARY.md +263 -0
  339. package/docs/archive/FASE3-PROGRESS.md +355 -0
  340. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
  341. package/docs/archive/INDICE-MASTER.md +282 -0
  342. package/docs/archive/PROJETO-COMPLETO.md +363 -0
  343. package/docs/archive/README-REFINAMENTO.md +293 -0
  344. package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
  345. package/docs/archive/REFINAMENTO-v1.0.md +565 -0
  346. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
  347. package/docs/archive/START-HERE.md +319 -0
  348. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
  349. package/docs/archive/examples/v1/AGENTS.md +10 -0
  350. package/docs/archive/examples/v1/README.md +36 -0
  351. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
  352. package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
  353. package/docs/archive/examples/v1/backend/package.json +42 -0
  354. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
  355. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
  356. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
  357. package/docs/archive/examples/v1/backend/src/main.ts +10 -0
  358. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
  359. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
  360. package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
  361. package/docs/archive/examples/v1/docs/.gitkeep +0 -0
  362. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
  363. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
  364. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
  365. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
  366. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
  367. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
  368. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
  369. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
  370. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
  371. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
  372. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
  373. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
  374. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
  375. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
  376. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
  377. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
  378. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
  379. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
  380. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
  381. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
  382. package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
  383. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
  384. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
  385. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
  386. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
  387. package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
  388. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
  389. package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
  390. package/docs/archive/examples/v2/.memoryrc.json +8 -0
  391. package/docs/archive/examples/v2/AGENTS.md +16 -0
  392. package/docs/archive/examples/v2/README.md +35 -0
  393. package/docs/archive/examples/v2/agents/README.md +3 -0
  394. package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
  395. package/docs/archive/examples/v2/agents/dba.md +4 -0
  396. package/docs/archive/examples/v2/agents/frontend.md +4 -0
  397. package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
  398. package/docs/archive/examples/v2/agents/reviewer.md +6 -0
  399. package/docs/archive/examples/v2/agents/security.md +4 -0
  400. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
  401. package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
  402. package/docs/archive/examples/v2/backend/package.json +42 -0
  403. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
  404. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
  405. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
  406. package/docs/archive/examples/v2/backend/src/main.ts +10 -0
  407. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
  408. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
  409. package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
  410. package/docs/archive/examples/v2/docs/.gitkeep +0 -0
  411. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
  412. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
  413. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
  414. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
  415. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
  416. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
  417. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
  418. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
  419. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
  420. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
  421. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
  422. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
  423. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
  424. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
  425. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
  426. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
  427. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
  428. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
  429. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
  430. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
  431. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
  432. package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
  433. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
  434. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
  435. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
  436. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
  437. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
  438. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
  439. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
  440. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
  441. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
  442. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
  443. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
  444. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
  445. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
  446. package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
  447. package/docs/archive/examples/v2/memory/README.md +8 -0
  448. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
  449. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
  450. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
  451. package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
  452. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
  453. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
  454. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
  455. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
  456. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
  457. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
  458. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
  459. package/docs/capacidades-externas.md +70 -0
  460. package/docs/cli-first-operacao.md +74 -0
  461. package/docs/dashboard.md +102 -0
  462. package/docs/dev-workflow.md +421 -0
  463. package/docs/examples.md +546 -0
  464. package/docs/fluxo.md +103 -0
  465. package/docs/glossary.md +453 -0
  466. package/docs/init-project.md +457 -0
  467. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
  468. package/docs/personas/architect/README.md +333 -0
  469. package/docs/personas/developer/README.md +371 -0
  470. package/docs/personas/executive/README.md +172 -0
  471. package/docs/personas/qa/README.md +350 -0
  472. package/docs/processo-projeto.md +138 -0
  473. package/docs/publishing.md +377 -0
  474. package/docs/quick-reference.md +409 -0
  475. package/docs/structure.md +360 -0
  476. package/docs/token-optimization.md +494 -0
  477. package/lib/context-builder.js +257 -0
  478. package/lib/core/registry.mjs +284 -0
  479. package/lib/generators/memory-generator.js +844 -0
  480. package/lib/generators/nest-generator.js +496 -0
  481. package/lib/generators/readme-generator.js +213 -0
  482. package/lib/templates/harness/code-intel.mjs +119 -0
  483. package/lib/templates/harness/mcp.json +10 -0
  484. package/lib/utils/file-helpers.js +40 -0
  485. package/lib/validators/structure-validator.js +253 -0
  486. package/lib/workspace.mjs +213 -0
  487. package/memory/00-global/mission.md +15 -0
  488. package/memory/00-global/shared-knowledge.md +8 -0
  489. package/memory/00-global/standards.md +47 -0
  490. package/memory/10-product/personas.md +21 -0
  491. package/memory/10-product/vision.md +27 -0
  492. package/memory/30-projects/README.md +15 -0
  493. package/memory/40-delivery/backlog.md +15 -0
  494. package/memory/40-delivery/current-sprint.md +21 -0
  495. package/memory/50-orchestration/gsd-harness.md +55 -0
  496. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
  497. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
  498. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
  499. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
  500. package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
  501. package/memory/90-decisions/0006-docs-por-persona.md +23 -0
  502. package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
  503. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
  504. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
  505. package/memory/90-decisions/0010-banco-postgres.md +30 -0
  506. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
  507. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
  508. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
  509. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
  510. package/memory/90-decisions/0019-workspace-separado.md +45 -0
  511. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
  512. package/memory/90-decisions/_template.md +28 -0
  513. package/package.json +107 -0
  514. package/prompts/context-engineer-agent.md +19 -0
  515. package/prompts/governance-agent.md +15 -0
  516. package/prompts/marketing-agent.md +13 -0
  517. package/prompts/orchestrator-agent.md +18 -0
  518. package/prompts/product-agent.md +13 -0
  519. package/prompts/sdd-architect-agent.md +20 -0
  520. package/scripts/agent-harness.mjs +578 -0
  521. package/scripts/agent-router.mjs +189 -0
  522. package/scripts/build-smart-context.js +87 -0
  523. package/scripts/check-standards.js +98 -0
  524. package/scripts/compress-memory.mjs +198 -0
  525. package/scripts/compress-project-memory.js +58 -0
  526. package/scripts/context-ops.mjs +463 -0
  527. package/scripts/dev.mjs +349 -0
  528. package/scripts/extract-global-knowledge.js +52 -0
  529. package/scripts/generate-dashboard.js +59 -0
  530. package/scripts/hook-session-start.mjs +70 -0
  531. package/scripts/hook-user-prompt.mjs +185 -0
  532. package/scripts/memory-schema.mjs +68 -0
  533. package/scripts/pre-commit.sh +102 -0
  534. package/scripts/query-universal-memory.js +50 -0
  535. package/scripts/spec-cli.mjs +193 -0
  536. package/scripts/sprint-manager.js +200 -0
  537. package/scripts/sync-universal-memory.js +278 -0
  538. package/scripts/token-benchmark.mjs +203 -0
  539. package/scripts/tools-doctor.mjs +77 -0
  540. package/specs/README.md +70 -0
  541. package/specs/_templates/plan.md +43 -0
  542. package/specs/_templates/spec.md +43 -0
  543. package/specs/_templates/tasks.md +32 -0
  544. package/specs/agent-dashboard/plan.md +165 -0
  545. package/specs/agent-dashboard/spec.md +89 -0
  546. package/specs/agent-dashboard/tasks.md +168 -0
  547. package/specs/cli-first-operacao/plan.md +53 -0
  548. package/specs/cli-first-operacao/spec.md +53 -0
  549. package/specs/cli-first-operacao/tasks.md +53 -0
  550. package/specs/dev-token-assets-db/plan.md +71 -0
  551. package/specs/dev-token-assets-db/spec.md +58 -0
  552. package/specs/dev-token-assets-db/tasks.md +58 -0
  553. package/specs/forja-core/spec.md +71 -0
  554. package/specs/harness-codegraph/spec.md +71 -0
  555. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
  556. package/specs/reestruturacao-forja-v2/plan.md +95 -0
  557. package/specs/reestruturacao-forja-v2/spec.md +70 -0
  558. package/specs/reestruturacao-forja-v2/tasks.md +113 -0
@@ -0,0 +1,333 @@
1
+ # 🏗️ Guia para Arquitetos
2
+
3
+ Você design systems. Quer entender decisões, trade-offs, escalabilidade.
4
+
5
+ ---
6
+
7
+ ## ⏱️ Leia em 30 minutos
8
+
9
+ ### Visão da Arquitetura
10
+
11
+ **create-memory-nest-kit** é uma **system generator** que cria projetos com:
12
+
13
+ 1. **Hierarquia de memória** — Contexto estruturado em 10 camadas
14
+ 2. **Orquestração de agentes** — Multi-agent coordination sem deadlock
15
+ 3. **Backend NestJS modular** — Domínios independentes, escaláveis
16
+ 4. **Validação + testes** — Automação desde a geração
17
+
18
+ ### Stack Padrão
19
+
20
+ ```
21
+ Frontend: (Sua escolha - React, Vue, etc)
22
+ ↓
23
+ API Gateway: NestJS (port 3000)
24
+ ├─ GET /api/health
25
+ ├─ GET /ops (dashboard)
26
+ └─ [Seus domínios]
27
+ ↓
28
+ Database: SQLite (contexto) + Seu BD principal
29
+ ↓
30
+ Memory Index: SQLite contexto (.memory/sqlite/context.db)
31
+ ↓
32
+ Agents: Orchestrador + Workers + Reviewer
33
+ ```
34
+
35
+ ---
36
+
37
+ ## 🏛️ Decisões Arquiteturais
38
+
39
+ ### 1. Modularização por Domínio
40
+
41
+ **Problema:** Grandes projetos viram bola de lama
42
+ **Solução:** Bounded contexts (DDD)
43
+
44
+ ```
45
+ memory/30-domains/
46
+ ├─ auth/
47
+ │ ├─ context.md (o que é auth neste sistema?)
48
+ │ ├─ rules.md (as regras)
49
+ │ └─ api.md (endpoints)
50
+ ├─ billing/
51
+ │ ├─ context.md
52
+ │ ├─ rules.md
53
+ │ └─ api.md
54
+ └─ [seu domínio]
55
+ ```
56
+
57
+ Cada agent trabalha **isolado** por domínio = sem conflitos.
58
+
59
+ ### 2. Contexto em Camadas
60
+
61
+ **Problema:** 1M+ tokens precisam ser comprimidos
62
+ **Solução:** Smart context loading
63
+
64
+ ```
65
+ Camada 1 (sempre): mission.md + standards.md (200 tokens)
66
+ Camada 2 (por projeto): vision.md + arquitetura (500 tokens)
67
+ Camada 3 (por domínio): [domínio]/context.md (300 tokens)
68
+ Camada 4 (tarefas): diffs + ADRs recentes (variável)
69
+ = Total compactado: ~1000 tokens vs 10K+ monolítico
70
+ ```
71
+
72
+ ### 3. Handoff Protocol
73
+
74
+ **Problema:** Quando agent A termina, agent B perde contexto
75
+ **Solução:** Handoff formal com 7 campos
76
+
77
+ ```markdown
78
+ # Handoff: Auth Worker → Reviewer
79
+
80
+ ## Contexto
81
+ Implementei validação JWT em GET /api/auth/verify
82
+
83
+ ## Alterações
84
+ - src/auth/guards/jwt.guard.ts (novo)
85
+ - src/auth/services/auth.service.ts (+50 linhas)
86
+
87
+ ## Riscos
88
+ - JWT expiry pode não estar coberto em todos os endpoints
89
+
90
+ ## Pendências
91
+ - E2E test para timeout de token
92
+
93
+ ## Próximo passo
94
+ Reviewer testa segurança e merge
95
+ ```
96
+
97
+ Cada handoff fica registrado em `memory/50-orchestration/handoffs/`
98
+
99
+ ---
100
+
101
+ ## 🔄 Fluxo de Desenvolvimento
102
+
103
+ ```
104
+ ┌─────────────────┐
105
+ │ Orquestrador │
106
+ │ (você, ou agente)
107
+ └────────┬────────┘
108
+ │ "Implementar auth"
109
+ ↓
110
+ ┌─────────────────────────────────────────┐
111
+ │ 1. Decompor em subtarefas │
112
+ │ • Auth module setup (backend-nest) │
113
+ │ • JWT validation (security) │
114
+ │ • E2E tests (backend-nest) │
115
+ │ • DB schema (dba) │
116
+ └──┬──────────────┬──────────────┬────────┘
117
+ │ │ │
118
+ ↓ ↓ ↓
119
+ ┌───────────┐ ┌────────┐ ┌──────────┐
120
+ │ Backend │ │Security│ │ DBA │
121
+ │ Worker │ │ Worker │ │ Worker │
122
+ │ (parallel)│ │(parallel)│(parallel)│
123
+ └──┬───────┘ └───┬────┘ └──┬───────┘
124
+ │ │ │
125
+ └─────┬───────┴────┬────┘
126
+ ↓ ↓
127
+ [Handoffs Registrados]
128
+ │
129
+ ↓
130
+ ┌──────────┐
131
+ │ Reviewer │
132
+ │ Agent │ ✅ Aprovado ou ❌ Bloqueado
133
+ └──┬───────┘
134
+ │
135
+ ↓
136
+ [Merge + Deploy]
137
+ ```
138
+
139
+ ---
140
+
141
+ ## 📊 Padrões de Escalabilidade
142
+
143
+ ### Cenário 1: Projeto Pequeno (1 domain)
144
+
145
+ ```
146
+ Você = Orquestrador + 1 Worker
147
+ Features: 1-2 /sprint
148
+ Memória: ~50KB
149
+ Tokens/sessão: ~2K
150
+ ```
151
+
152
+ ### Cenário 2: Projeto Médio (3-5 domains)
153
+
154
+ ```
155
+ Você = Orquestrador
156
+ Workers: Backend + Frontend + DBA + Security
157
+ Features: 3-5 /sprint
158
+ Memória: ~500KB
159
+ Tokens/sessão: ~5K (compactado via layers)
160
+ ```
161
+
162
+ ### Cenário 3: Projeto Grande (6+ domains, 3+ squads)
163
+
164
+ ```
165
+ Orquestrador-Agent = coordinação automática
166
+ Per-squad: 1 Orchestrator + 3-4 workers + reviewer
167
+ Features: 8-15 /sprint
168
+ Memória: ~2-5MB (distributed por squad)
169
+ Tokens/sessão: ~1000 (smart context)
170
+ Cross-domain: Revisor-gatekeeper valida integrações
171
+ ```
172
+
173
+ ---
174
+
175
+ ## 🔐 Segurança
176
+
177
+ ### Built-in
178
+
179
+ - ✅ **Input validation** — DTO obrigatório
180
+ - ✅ **Rate limiting** — Middleware pronto
181
+ - ✅ **CORS** — Configurável
182
+ - ✅ **Helmet** — Headers de segurança
183
+
184
+ ### Sua responsabilidade
185
+
186
+ - 🔑 **Secrets** — .env (fora do git)
187
+ - 🔐 **DB access** — Connection pooling, encryption at rest
188
+ - 🛡️ **Auth** — JWT + refresh tokens (exemplo em memoria/30-domains/auth)
189
+
190
+ ---
191
+
192
+ ## 🧪 Qualidade Esperada
193
+
194
+ ### Testes
195
+
196
+ ```
197
+ Unit Tests: Controllers + Services (>80% coverage)
198
+ E2E Tests: Happy path + error cases
199
+ Security Tests: OWASP Top 10
200
+ ```
201
+
202
+ ### CI/CD
203
+
204
+ ```
205
+ GitHub Actions (sugestão):
206
+ 1. Lint (ESLint + Prettier)
207
+ 2. Build (tsc)
208
+ 3. Tests (Jest com coverage)
209
+ 4. Security scan (snyk ou dependabot)
210
+ 5. Deploy (your infra)
211
+ ```
212
+
213
+ ---
214
+
215
+ ## 📈 Performance
216
+
217
+ ### Memory DB
218
+
219
+ - **Reads:** <10ms (SQLite in-process)
220
+ - **Writes:** Async batch (não bloqueia API)
221
+ - **Query:** FTS5 para texto livre
222
+
223
+ ### API
224
+
225
+ - **Health check:** <1ms
226
+ - **Ops dashboard:** <50ms (agregação via SQLite)
227
+ - **User endpoints:** Depende de sua lógica
228
+
229
+ ### Scaling
230
+
231
+ ```
232
+ 1 dyno/pod: até 1000 req/s
233
+ Múltiplos: Load balancer + shared DB
234
+ Multi-region: Deploy em N regiões, SQS/Redis para sync
235
+ ```
236
+
237
+ ---
238
+
239
+ ## 🎯 Primeiros Passos
240
+
241
+ ### 1. Gerar e explorar (10 min)
242
+
243
+ ```bash
244
+ npm run workspace:init
245
+ npm run project:new meu-produto
246
+ cd ~/forja-workspace/projects/meu-produto
247
+ cat memory/20-architecture/system-overview.md
248
+ cat memory/30-domains/auth/context.md
249
+ ```
250
+
251
+ ### 2. Entender o projeto (20 min)
252
+
253
+ ```bash
254
+ # Ver o NestJS gerado
255
+ ls -la backend/src/
256
+ cat backend/src/app.module.ts
257
+
258
+ # Entender a topologia
259
+ cat memory/50-orchestration/topology.md
260
+ ```
261
+
262
+ ### 3. Adicionar seu domínio (15 min)
263
+
264
+ ```bash
265
+ # Criar novo domínio
266
+ mkdir -p memory/30-domains/seu-dominio
267
+ cat > memory/30-domains/seu-dominio/context.md << EOF
268
+ # Seu Domínio
269
+
270
+ [Descrição breve do escopo]
271
+ EOF
272
+ ```
273
+
274
+ ### 4. Gerar primeira feature (30 min)
275
+
276
+ Seguir [Guia de Developer](../developer/README.md)
277
+
278
+ ---
279
+
280
+ ## 🚀 Decisões que Você Precisa Tomar
281
+
282
+ ### 1. Qual banco de dados principal?
283
+
284
+ - **PostgreSQL** → Production-grade, recomendado
285
+ - **MySQL** → Alternativa
286
+ - **SQLite** → Dev apenas (single process)
287
+
288
+ ### 2. Qual frontend?
289
+
290
+ - **React** → Recomendado, maior comunidade
291
+ - **Vue** → Alternativa
292
+ - **Sua escolha** → Integrar depois
293
+
294
+ ### 3. Quantos agentes simultâneos?
295
+
296
+ - **1-2** → Você mesmo (para MVP)
297
+ - **3-5** → Squad de dev
298
+ - **6+** → Múltiplas squads + orquestrador-agente
299
+
300
+ ### 4. Qual cloud?
301
+
302
+ - **Vercel** (frontend) + **Heroku/Railway** (backend) → MVP
303
+ - **AWS** (EC2/ECS) + **RDS** → Production
304
+ - **GCP/Azure** → Alternativas
305
+
306
+ ---
307
+
308
+ ## 🔗 Referências Técnicas
309
+
310
+ | Documento | Quando ler |
311
+ |-----------|-----------|
312
+ | [REFINAMENTO-v1.0.md](../../REFINAMENTO-v1.0.md) | Especificação técnica completa |
313
+ | [ESTRUTURA-PROJETO.md](../../ESTRUTURA-PROJETO.md) | Hierarquia de diretórios |
314
+ | [memory/20-architecture/](../../memory/20-architecture/) | Design do seu projeto |
315
+ | [EXEMPLOS-CODIGO.md](../../EXEMPLOS-CODIGO.md) | Padrões prontos |
316
+
317
+ ---
318
+
319
+ ## 📋 Checklist de Onboarding (Arquiteto)
320
+
321
+ - [ ] Li este guia (30 min)
322
+ - [ ] Rodei o generator (5 min)
323
+ - [ ] Explorei memory/20-architecture/ (10 min)
324
+ - [ ] Defini minha topologia de domínios (20 min)
325
+ - [ ] Criei primeiros ADRs em memory/90-decisions/ (15 min)
326
+ - [ ] Passei para [Guia de Developer](../developer/README.md)
327
+
328
+ ---
329
+
330
+ **Tempo total:** ~1.5h até ready
331
+ **ROI:** Arquitetura clara = menos refactoring depois
332
+
333
+ 📞 Próximo: Repasse o [Guia de Developer](../developer/README.md) ao seu squad
@@ -0,0 +1,371 @@
1
+ # 💻 Guia para Developers
2
+
3
+ Você codifica. Quer exemplos, atalhos, padrões.
4
+
5
+ ---
6
+
7
+ ## ⏱️ Leia em 15 minutos
8
+
9
+ ### O que é isso?
10
+
11
+ **create-memory-nest-kit** gera projetos prontos com:
12
+
13
+ - **Backend NestJS** — Já com módulos, DTOs, testes
14
+ - **Memory em Markdown** — Contexto organizado
15
+ - **Agentes** — Você + 2-3 IAs trabalhando em paralelo
16
+
17
+ ### Primeiro comando
18
+
19
+ ```bash
20
+ npm run workspace:init
21
+ npm run project:new meu-projeto
22
+ cd ~/forja-workspace/projects/meu-projeto
23
+ cat START-HERE.md
24
+ ```
25
+
26
+ ---
27
+
28
+ ## 🚀 5 Minutos: Começar a Codificar
29
+
30
+ ### 1. Gerar projeto (1 min)
31
+
32
+ ```bash
33
+ npm run project:new meu-projeto
34
+ cd ~/forja-workspace/projects/meu-projeto
35
+ ```
36
+
37
+ ### 2. Instalar dependências (5 min)
38
+
39
+ ```bash
40
+ cd backend
41
+ npm install
42
+ ```
43
+
44
+ ### 3. Rodar em dev (2 min)
45
+
46
+ ```bash
47
+ npm run start:dev
48
+ # Abra: http://localhost:3000/api/health
49
+ ```
50
+
51
+ ### 4. Ver dashboard de agentes (1 min)
52
+
53
+ ```bash
54
+ # Em outra aba
55
+ curl http://localhost:3000/ops
56
+ # Abra em navegador: http://localhost:3000/ops
57
+ ```
58
+
59
+ **Pronto!** Você está up & running.
60
+
61
+ ---
62
+
63
+ ## 📂 Estrutura Rápida
64
+
65
+ ```
66
+ meu-projeto/
67
+ ├─ backend/ ← Sua API
68
+ │ ├─ src/
69
+ │ │ ├─ modules/ops/ ← Exemplo: operações
70
+ │ │ ├─ app.module.ts ← Registre seus módulos aqui
71
+ │ │ └─ main.ts ← Entry point
72
+ │ ├─ test/
73
+ │ ├─ package.json
74
+ │ └─ tsconfig.json
75
+ ├─ memory/ ← Documentação estruturada
76
+ │ ├─ 00-global/ ← Mission, standards
77
+ │ ├─ 10-product/ ← O que você tá construindo
78
+ │ ├─ 20-architecture/ ← Design
79
+ │ ├─ 30-domains/ ← Seus bounded contexts
80
+ │ └─ 50-orchestration/ ← Handoffs (IAs)
81
+ ├─ agents/ ← Descrição dos papéis
82
+ ├─ skills/ ← Capacidades de agentes
83
+ ├─ prompts/ ← Instruções por contexto
84
+ └─ DOC-MAP.md ← Navegação de docs
85
+ ```
86
+
87
+ ---
88
+
89
+ ## 💡 Padrões de Código
90
+
91
+ ### Padrão 1: Novo Módulo NestJS
92
+
93
+ ```bash
94
+ # Criar módulo
95
+ nest g module features/auth
96
+ nest g controller features/auth
97
+ nest g service features/auth
98
+
99
+ # Estrutura gerada:
100
+ # src/features/auth/
101
+ # ├─ auth.module.ts
102
+ # ├─ auth.controller.ts
103
+ # ├─ auth.service.ts
104
+ # ├─ auth.controller.spec.ts
105
+ # └─ dto/
106
+ # ├─ create-auth.dto.ts
107
+ # └─ login.dto.ts
108
+ ```
109
+
110
+ ### Padrão 2: DTO com Validação
111
+
112
+ ```typescript
113
+ // src/features/auth/dto/login.dto.ts
114
+ import { IsEmail, IsString, MinLength } from 'class-validator';
115
+
116
+ export class LoginDto {
117
+ @IsEmail()
118
+ email: string;
119
+
120
+ @IsString()
121
+ @MinLength(6)
122
+ password: string;
123
+ }
124
+ ```
125
+
126
+ ### Padrão 3: Service + Controller
127
+
128
+ ```typescript
129
+ // src/features/auth/auth.service.ts
130
+ @Injectable()
131
+ export class AuthService {
132
+ login(dto: LoginDto) {
133
+ // Sua lógica
134
+ return { token: '...' };
135
+ }
136
+ }
137
+
138
+ // src/features/auth/auth.controller.ts
139
+ @Controller('auth')
140
+ export class AuthController {
141
+ constructor(private authService: AuthService) {}
142
+
143
+ @Post('login')
144
+ login(@Body() dto: LoginDto) {
145
+ return this.authService.login(dto);
146
+ }
147
+ }
148
+ ```
149
+
150
+ ### Padrão 4: Testes
151
+
152
+ ```typescript
153
+ // src/features/auth/auth.service.spec.ts
154
+ describe('AuthService', () => {
155
+ let service: AuthService;
156
+
157
+ beforeEach(() => {
158
+ service = new AuthService();
159
+ });
160
+
161
+ it('login deve retornar token', () => {
162
+ const result = service.login({ email: 'a@b.com', password: '123456' });
163
+ expect(result.token).toBeDefined();
164
+ });
165
+ });
166
+ ```
167
+
168
+ ---
169
+
170
+ ## 🛠️ Comandos Essenciais
171
+
172
+ | Comando | O quê |
173
+ |---------|-------|
174
+ | `npm run start:dev` | Rodar em dev com hot-reload |
175
+ | `npm run build` | Build para prod |
176
+ | `npm test` | Rodar testes |
177
+ | `npm run test:cov` | Coverage report |
178
+ | `npm run lint` | ESLint |
179
+ | `npm run format` | Prettier auto-fix |
180
+
181
+ ---
182
+
183
+ ## 📝 Memória para Agentes
184
+
185
+ ### Como registrar uma feature
186
+
187
+ ```bash
188
+ # Criar arquivo de contexto
189
+ cat > memory/30-domains/seu-dominio/api.md << EOF
190
+ # API de Seu Domínio
191
+
192
+ ## POST /api/seu-endpoint
193
+
194
+ Request:
195
+ \`\`\`json
196
+ { "campo": "valor" }
197
+ \`\`\`
198
+
199
+ Response:
200
+ \`\`\`json
201
+ { "id": 123, "campo": "valor" }
202
+ \`\`\`
203
+
204
+ Error cases:
205
+ - 400: Validação falhou
206
+ - 401: Não autenticado
207
+ EOF
208
+ ```
209
+
210
+ ### Como pedir ajuda a uma IA
211
+
212
+ 1. **Copie seu contexto**
213
+ ```bash
214
+ node scripts/build-context-pack.mjs
215
+ cat .context/context-pack.md
216
+ ```
217
+
218
+ 2. **Cole num painel de IA**
219
+ - Claude: cole em nova conversation
220
+ - ChatGPT: mesma aba
221
+ - Copilot: abra arquivo + Ctrl+K
222
+
223
+ 3. **Peça a feature**
224
+ ```
225
+ Implementar POST /api/seu-endpoint com validação JWT
226
+ ```
227
+
228
+ 4. **IA trabalha com contexto = menos erros**
229
+
230
+ ---
231
+
232
+ ## 🤝 Handoff Protocol
233
+
234
+ Quando terminar uma feature:
235
+
236
+ ```bash
237
+ # Criar handoff para o revisor
238
+ node ../scripts/append-handoff.mjs seu-nome revisor "Implementei auth"
239
+
240
+ # Abrir arquivo gerado e preencher:
241
+ cat memory/50-orchestration/handoffs/[ARQUIVO].md
242
+ ```
243
+
244
+ Template:
245
+ ```markdown
246
+ # Handoff: seu-nome -> revisor
247
+
248
+ ## Contexto
249
+ Implementei JWT auth com validação
250
+
251
+ ## Alterações
252
+ - src/features/auth/auth.module.ts (novo)
253
+ - src/features/auth/auth.service.ts (novo)
254
+ - src/features/auth/auth.controller.ts (novo)
255
+
256
+ ## Riscos
257
+ - JWT secret está em .env (não em código) ✅
258
+ - Falta refresh token (pendência)
259
+
260
+ ## Pendências
261
+ - E2E test para logout
262
+
263
+ ## Próximo passo
264
+ Revisor valida segurança e testes
265
+ ```
266
+
267
+ ---
268
+
269
+ ## 🧪 Testes Rápidos
270
+
271
+ ### 1. Teste unitário (um serviço)
272
+
273
+ ```bash
274
+ npm test -- auth.service.spec.ts
275
+ ```
276
+
277
+ ### 2. Teste E2E (API completa)
278
+
279
+ ```bash
280
+ npm run test:e2e -- auth.e2e-spec.ts
281
+ ```
282
+
283
+ ### 3. Coverage
284
+
285
+ ```bash
286
+ npm run test:cov
287
+ # Gera coverage/index.html
288
+ open coverage/index.html
289
+ ```
290
+
291
+ ---
292
+
293
+ ## 🔗 Recursos
294
+
295
+ | Recurso | Quando usar |
296
+ |---------|------------|
297
+ | [EXEMPLOS-CODIGO.md](../../EXEMPLOS-CODIGO.md) | "Como faço X?" |
298
+ | [REFERENCIA-RAPIDA.md](../../REFERENCIA-RAPIDA.md) | Atalhos de comandos |
299
+ | [IMPLEMENTACAO-FASE1.md](../../IMPLEMENTACAO-FASE1.md) | Roteiros práticos |
300
+ | [NestJS Docs](https://docs.nestjs.com) | Dúvidas NestJS |
301
+
302
+ ---
303
+
304
+ ## 🎯 Fluxo Recomendado (Primeira Feature)
305
+
306
+ ```
307
+ 1. Ler este guia (15 min)
308
+ ↓
309
+ 2. Rodar o generator (5 min)
310
+ ↓
311
+ 3. npm install + npm run start:dev (10 min)
312
+ ↓
313
+ 4. Criar novo módulo
314
+ nest g resource features/seu-dominio
315
+ ↓
316
+ 5. Preencher DTO com validação
317
+ ✏️ Copie o padrão de login.dto.ts
318
+ ↓
319
+ 6. Implementar lógica no service
320
+ ✏️ Copie padrão do auth.service.ts
321
+ ↓
322
+ 7. Testar
323
+ npm test
324
+ ↓
325
+ 8. Registrar handoff (para revisor validar)
326
+ node ../scripts/append-handoff.mjs
327
+ ↓
328
+ 9. Deploy! 🚀
329
+ ```
330
+
331
+ ---
332
+
333
+ ## 🚨 Armadilhas Comuns
334
+
335
+ | Erro | Solução |
336
+ |------|---------|
337
+ | "Class X undefined" | Registrar em module.ts |
338
+ | "DTO não valida" | Adicionar decoradores @IsEmail etc |
339
+ | "Teste falha" | Mockar dependências |
340
+ | "Port 3000 ocupada" | PORT=3001 npm run start:dev |
341
+
342
+ ---
343
+
344
+ ## 📋 Checklist Primeira Feature
345
+
346
+ - [ ] Generator rodou ✅
347
+ - [ ] Backend instalou ✅
348
+ - [ ] Health check funciona ✅
349
+ - [ ] Criei novo módulo ✅
350
+ - [ ] DTO com validação ✅
351
+ - [ ] Service + Controller ✅
352
+ - [ ] Testes passam ✅
353
+ - [ ] Handoff criado ✅
354
+ - [ ] Revisor aprovou ✅
355
+
356
+ **Tempo total:** ~3 horas (primeira feature)
357
+
358
+ ---
359
+
360
+ ## 🚀 Próximas Features
361
+
362
+ Depois da primeira:
363
+ 1. Velocidade aumenta ~2-3x (padrão já conhecido)
364
+ 2. Copie + ajuste de feature anterior
365
+ 3. Use IAs em paralelo (agents) para ir mais rápido
366
+
367
+ ---
368
+
369
+ **Tempo total onboarding:** ~1h até primeira feature
370
+
371
+ 💪 Pronto? Comece agora!