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,45 @@
1
+ // API constants
2
+ export const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL || 'http://localhost:3001/api';
3
+
4
+ // Order status constants
5
+ export const ORDER_STATUSES = {
6
+ PENDING: 'pending',
7
+ PROCESSING: 'processing',
8
+ SHIPPED: 'shipped',
9
+ DELIVERED: 'delivered',
10
+ } as const;
11
+
12
+ // User roles
13
+ export const USER_ROLES = {
14
+ USER: 'user',
15
+ ADMIN: 'admin',
16
+ } as const;
17
+
18
+ // Pagination
19
+ export const DEFAULT_PAGE_SIZE = 20;
20
+ export const MAX_PAGE_SIZE = 100;
21
+
22
+ // Cache TTLs (in seconds)
23
+ export const CACHE_TTL = {
24
+ SHORT: 60,
25
+ MEDIUM: 300,
26
+ LONG: 3600,
27
+ } as const;
28
+
29
+ // Error codes
30
+ export const ERROR_CODES = {
31
+ VALIDATION_ERROR: 'VALIDATION_ERROR',
32
+ NOT_FOUND: 'NOT_FOUND',
33
+ UNAUTHORIZED: 'UNAUTHORIZED',
34
+ FORBIDDEN: 'FORBIDDEN',
35
+ CONFLICT: 'CONFLICT',
36
+ INTERNAL_ERROR: 'INTERNAL_ERROR',
37
+ } as const;
38
+
39
+ // Regex patterns
40
+ export const PATTERNS = {
41
+ EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
42
+ SKU: /^[A-Z0-9\-]{3,}$/,
43
+ PHONE: /^\+?[1-9]\d{1,14}$/,
44
+ SLUG: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
45
+ } as const;
@@ -0,0 +1,4 @@
1
+ // Main index file
2
+ export * from './validators';
3
+ export * from './constants';
4
+ export * from './utils';
@@ -0,0 +1,3 @@
1
+ // Export all utilities
2
+ export * from './string';
3
+ export * from './math';
@@ -0,0 +1,30 @@
1
+ // Math utilities
2
+ export function roundToTwoDecimals(num: number): number {
3
+ return Math.round(num * 100) / 100;
4
+ }
5
+
6
+ // Calculate total
7
+ export function calculateTotal(items: Array<{ price: number; quantity: number }>): number {
8
+ return roundToTwoDecimals(items.reduce((sum, item) => sum + item.price * item.quantity, 0));
9
+ }
10
+
11
+ // Calculate discount
12
+ export function calculateDiscount(original: number, discountPercent: number): number {
13
+ return roundToTwoDecimals(original * (discountPercent / 100));
14
+ }
15
+
16
+ // Calculate tax
17
+ export function calculateTax(amount: number, taxPercent: number): number {
18
+ return roundToTwoDecimals(amount * (taxPercent / 100));
19
+ }
20
+
21
+ // Clamp number between min and max
22
+ export function clamp(value: number, min: number, max: number): number {
23
+ return Math.min(Math.max(value, min), max);
24
+ }
25
+
26
+ // Generate random ID
27
+ export function generateId(prefix = ''): string {
28
+ const id = Math.random().toString(36).substring(2, 11);
29
+ return prefix ? `${prefix}_${id}` : id;
30
+ }
@@ -0,0 +1,48 @@
1
+ // String utilities
2
+ export function slugify(str: string): string {
3
+ return str
4
+ .toLowerCase()
5
+ .trim()
6
+ .replace(/[^\w\s-]/g, '')
7
+ .replace(/[\s_]+/g, '-')
8
+ .replace(/^-+|-+$/g, '');
9
+ }
10
+
11
+ // Format price for display
12
+ export function formatPrice(price: number, currency = 'USD'): string {
13
+ const formatter = new Intl.NumberFormat('en-US', {
14
+ style: 'currency',
15
+ currency,
16
+ });
17
+ return formatter.format(price);
18
+ }
19
+
20
+ // Parse price string to number
21
+ export function parsePrice(priceStr: string): number {
22
+ const cleaned = priceStr.replace(/[^\d.]/g, '');
23
+ return parseFloat(cleaned) || 0;
24
+ }
25
+
26
+ // Truncate string
27
+ export function truncate(str: string, length: number, suffix = '...'): string {
28
+ if (str.length <= length) return str;
29
+ return str.slice(0, length - suffix.length) + suffix;
30
+ }
31
+
32
+ // Capitalize string
33
+ export function capitalize(str: string): string {
34
+ if (!str) return '';
35
+ return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
36
+ }
37
+
38
+ // Format date
39
+ export function formatDate(date: Date | string, locale = 'en-US'): string {
40
+ const d = typeof date === 'string' ? new Date(date) : date;
41
+ return d.toLocaleDateString(locale);
42
+ }
43
+
44
+ // Format date and time
45
+ export function formatDateTime(date: Date | string, locale = 'en-US'): string {
46
+ const d = typeof date === 'string' ? new Date(date) : date;
47
+ return d.toLocaleString(locale);
48
+ }
@@ -0,0 +1,44 @@
1
+ // Email validation
2
+ export function validateEmail(email: string): boolean {
3
+ const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
4
+ return re.test(email);
5
+ }
6
+
7
+ // Password validation
8
+ export function validatePassword(password: string): { valid: boolean; errors: string[] } {
9
+ const errors: string[] = [];
10
+
11
+ if (password.length < 8) {
12
+ errors.push('Password must be at least 8 characters');
13
+ }
14
+ if (!/[A-Z]/.test(password)) {
15
+ errors.push('Password must contain uppercase letter');
16
+ }
17
+ if (!/[a-z]/.test(password)) {
18
+ errors.push('Password must contain lowercase letter');
19
+ }
20
+ if (!/[0-9]/.test(password)) {
21
+ errors.push('Password must contain number');
22
+ }
23
+
24
+ return {
25
+ valid: errors.length === 0,
26
+ errors,
27
+ };
28
+ }
29
+
30
+ // UUID validation
31
+ export function validateUUID(uuid: string): boolean {
32
+ const re = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
33
+ return re.test(uuid);
34
+ }
35
+
36
+ // Quantity validation
37
+ export function validateQuantity(quantity: number): boolean {
38
+ return Number.isInteger(quantity) && quantity > 0;
39
+ }
40
+
41
+ // Price validation
42
+ export function validatePrice(price: number): boolean {
43
+ return price > 0 && Number.isFinite(price);
44
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "extends": "../../tsconfig.json",
3
+ "compilerOptions": {
4
+ "outDir": "./dist",
5
+ "rootDir": "./src"
6
+ },
7
+ "include": ["src"]
8
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2020",
4
+ "module": "ESNext",
5
+ "lib": ["ES2020"],
6
+ "moduleResolution": "bundler",
7
+ "resolveJsonModule": true,
8
+ "strict": true,
9
+ "esModuleInterop": true,
10
+ "skipLibCheck": true,
11
+ "forceConsistentCasingInFileNames": true,
12
+ "declaration": true,
13
+ "declarationMap": true,
14
+ "sourceMap": true,
15
+ "baseUrl": ".",
16
+ "paths": {
17
+ "@monorepo/*": ["packages/*"],
18
+ "@/*": ["packages/packages/*"]
19
+ }
20
+ },
21
+ "include": [],
22
+ "exclude": ["node_modules"]
23
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "version": 1,
3
+ "tasks": {
4
+ "dev": {
5
+ "cache": false,
6
+ "persistent": true
7
+ },
8
+ "build": {
9
+ "outputs": ["dist/**", "build/**", ".next/**"],
10
+ "cache": true,
11
+ "dependsOn": ["^build"]
12
+ },
13
+ "test": {
14
+ "outputs": ["coverage/**"],
15
+ "cache": true,
16
+ "dependsOn": ["^build"]
17
+ },
18
+ "test:watch": {
19
+ "cache": false,
20
+ "persistent": true
21
+ },
22
+ "lint": {
23
+ "cache": false,
24
+ "outputs": []
25
+ },
26
+ "type-check": {
27
+ "cache": true,
28
+ "outputs": []
29
+ },
30
+ "clean": {
31
+ "cache": false
32
+ }
33
+ },
34
+ "globalDependencies": ["**/.env.local", "**/.env"]
35
+ }
@@ -0,0 +1,407 @@
1
+ # 🏗️ Boilerplates - Casos de Uso Profissionais
2
+
3
+ Exemplos prontos para produção usando **create-memory-nest-kit**.
4
+
5
+ Cada boilerplate é um projeto completo com:
6
+ - ✅ Estrutura hierárquica de memória
7
+ - ✅ Backend NestJS funcional
8
+ - ✅ Autenticação e segurança
9
+ - ✅ Testes E2E
10
+ - ✅ Documentação completa
11
+ - ✅ Docker & deployment
12
+
13
+ ---
14
+
15
+ ## 📦 Templates Disponíveis
16
+
17
+ ### 🔌 1. API REST
18
+ **Para**: APIs RESTful simples, microserviços, backends genéricos
19
+
20
+ ```bash
21
+ node ../bin/init-project.js meu-projeto --template api-rest
22
+ ```
23
+
24
+ **Inclui**:
25
+ - CRUD de produtos
26
+ - Autenticação JWT
27
+ - Rate limiting
28
+ - Paginação e filtros
29
+ - Testes E2E
30
+ - Documentação com exemplos curl
31
+
32
+ **Use quando**: Precisar de uma API limpa, bem estruturada
33
+
34
+ [Abrir 📂](./01-api-rest)
35
+
36
+ ---
37
+
38
+ ### 💼 2. SaaS
39
+ **Para**: Aplicações multi-tenant, subscriptions, billing
40
+
41
+ ```bash
42
+ node ../bin/init-project.js meu-projeto --template saas
43
+ ```
44
+
45
+ **Inclui**:
46
+ - Autenticação com planos
47
+ - Subscription management
48
+ - Billing mock
49
+ - Organização multi-tenant
50
+ - Role-based access control
51
+ - Testes
52
+
53
+ **Use quando**: Construir SaaS com múltiplos clientes, subscriptions
54
+
55
+ [Abrir 📂](./02-saas)
56
+
57
+ ---
58
+
59
+ ### 🛍️ 3. E-Commerce
60
+ **Para**: Lojas online, marketplaces, checkout
61
+
62
+ ```bash
63
+ node ../bin/init-project.js meu-projeto --template ecommerce
64
+ ```
65
+
66
+ **Inclui**:
67
+ - Catálogo de produtos
68
+ - Carrinho de compras
69
+ - Checkout
70
+ - Gerenciamento de pedidos
71
+ - Inventário
72
+ - Cupons e descontos
73
+
74
+ **Use quando**: Montar e-commerce, marketplace
75
+
76
+ [Abrir 📂](./03-ecommerce)
77
+
78
+ ---
79
+
80
+ ### 🔀 4. Microserviços
81
+ **Para**: Arquiteturas distribuídas, orquestração
82
+
83
+ ```bash
84
+ node ../bin/init-project.js meu-projeto --template microservices
85
+ ```
86
+
87
+ **Inclui**:
88
+ - Auth service
89
+ - User service
90
+ - Message queue (RabbitMQ)
91
+ - Service discovery
92
+ - Fault tolerance
93
+ - Distributed tracing
94
+
95
+ **Use quando**: Escalar para microserviços, arquitetura distribuída
96
+
97
+ [Abrir 📂](./04-microservices)
98
+
99
+ ---
100
+
101
+ ### 📦 5. Monorepo
102
+ **Para**: Monorepositórios, full-stack em um só lugar
103
+
104
+ ```bash
105
+ node ../bin/init-project.js meu-projeto --template monorepo
106
+ ```
107
+
108
+ **Inclui**:
109
+ - Backend (NestJS)
110
+ - Frontend (React/Next.js)
111
+ - Shared libraries
112
+ - Turborepo setup
113
+ - Build pipeline
114
+ - Shared types
115
+
116
+ **Use quando**: Full-stack em um repositório
117
+
118
+ [Abrir 📂](./05-monorepo)
119
+
120
+ ---
121
+
122
+ ### 📊 6. Dashboard Admin
123
+ **Para**: Painel administrativo, gestão interna
124
+
125
+ ```bash
126
+ node ../bin/init-project.js meu-projeto --template dashboard-admin
127
+ ```
128
+
129
+ **Inclui**:
130
+ - RBAC avançado
131
+ - Dashboard com gráficos
132
+ - Gestão de usuários
133
+ - Auditoria e logs
134
+ - Relatórios
135
+ - Dark mode
136
+
137
+ **Use quando**: Construir admin interno, painel gerencial
138
+
139
+ [Abrir 📂](./06-dashboard-admin)
140
+
141
+ ---
142
+
143
+ ## 🚀 Quick Start
144
+
145
+ ### 1. Escolher Template
146
+ ```bash
147
+ # Listar templates disponíveis
148
+ node ../bin/init-project.js --list-templates
149
+
150
+ # Escolha um:
151
+ node ../bin/init-project.js meu-api --template api-rest
152
+ ```
153
+
154
+ ### 2. Setup
155
+ ```bash
156
+ cd meu-api
157
+ npm install
158
+ npm run start:dev
159
+ ```
160
+
161
+ ### 3. Explorar
162
+ ```bash
163
+ # Ver estrutura
164
+ ls -la
165
+
166
+ # Ler documentação
167
+ cat README.md
168
+
169
+ # Ver exemplos
170
+ cat backend/test/
171
+ ```
172
+
173
+ ### 4. Customizar
174
+ ```bash
175
+ # Estrutura de memória
176
+ cd memory/30-domains/
177
+ # Adicionar novo domínio, regras, etc
178
+
179
+ # Implementação
180
+ cd ../backend/src/modules/
181
+ # Adicionar novos módulos
182
+ ```
183
+
184
+ ---
185
+
186
+ ## 📚 Estrutura Comum
187
+
188
+ Cada boilerplate segue este padrão:
189
+
190
+ ```
191
+ template/
192
+ ├── memory/ ← Conhecimento hierárquico
193
+ │ ├── 00-global/ ← Context compartilhado
194
+ │ ├── 10-product/ ← Visão do produto
195
+ │ ├── 20-architecture/ ← Arquitetura
196
+ │ ├── 30-domains/ ← Domínios de negócio
197
+ │ ├── 40-delivery/ ← Roadmap
198
+ │ ├── 50-orchestration/ ← Orquestração
199
+ │ ├── 60-runs/ ← Logs de execução
200
+ │ ├── 70-summaries/ ← Resumos
201
+ │ ├── 80-data/ ← Documentação BD
202
+ │ └── 90-decisions/ ← ADRs
203
+ │
204
+ ├── backend/ ← NestJS API
205
+ │ ├── src/
206
+ │ │ ├── modules/ ← Feature modules
207
+ │ │ ├── config/ ← Configuration
208
+ │ │ ├── middleware/ ← Middleware
209
+ │ │ ├── filters/ ← Exception filters
210
+ │ │ └── app.module.ts
211
+ │ ├── test/ ← E2E tests
212
+ │ ├── scripts/ ← Automação
213
+ │ └── docker-compose.yml ← Infrastructure
214
+ │
215
+ ├── .ia-instructions/ ← Instruções para IAs
216
+ │ ├── copilot.md
217
+ │ ├── claude.md
218
+ │ ├── gemini.md
219
+ │ └── codex.md
220
+ │
221
+ ├── README.md ← Documentação
222
+ ├── .env.example ← Exemplo de config
223
+ └── setup.sh ← Script de setup
224
+ ```
225
+
226
+ ---
227
+
228
+ ## 🔧 Customização
229
+
230
+ ### Adicionar Novo Domínio
231
+
232
+ ```bash
233
+ mkdir -p memory/30-domains/novo-dominio
234
+ cat > memory/30-domains/novo-dominio/context.md << EOF
235
+ # Contexto de Novo Domínio
236
+
237
+ ## Responsabilidades
238
+ - ...
239
+
240
+ ## Entidades
241
+ - ...
242
+ EOF
243
+ ```
244
+
245
+ ### Adicionar Novo Endpoint
246
+
247
+ ```bash
248
+ # Criar módulo
249
+ nest generate module modules/novo-endpoint
250
+
251
+ # Ver exemplos
252
+ cat backend/src/modules/products/
253
+ ```
254
+
255
+ ---
256
+
257
+ ## 📊 Comparação de Templates
258
+
259
+ | Feature | API REST | SaaS | E-commerce | Microserviços | Monorepo | Dashboard |
260
+ |---------|----------|------|------------|---------------|----------|-----------|
261
+ | **Autenticação** | JWT | JWT + Planos | JWT | Service | JWT | RBAC |
262
+ | **BD Exemplar** | Produtos | Subscriptions | Pedidos | Múltiplas | Shared | Logs |
263
+ | **Frontend** | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
264
+ | **Pagamentos** | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
265
+ | **Multi-tenant** | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
266
+ | **Message Queue** | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
267
+ | **Complexidade** | 🟢 | 🟡 | 🟡 | 🔴 | 🔴 | 🟡 |
268
+ | **Tempo Setup** | 5 min | 5 min | 5 min | 10 min | 10 min | 10 min |
269
+
270
+ ---
271
+
272
+ ## 🤖 Usar com IAs
273
+
274
+ Cada boilerplate inclui instruções para Copilot, Claude, Gemini e Codex:
275
+
276
+ ```bash
277
+ cd meu-projeto
278
+ cat .ia-instructions/copilot.md # Para Copilot
279
+ cat .ia-instructions/claude.md # Para Claude
280
+ cat .ia-instructions/gemini.md # Para Gemini
281
+ cat .ia-instructions/codex.md # Para Codex
282
+ ```
283
+
284
+ ---
285
+
286
+ ## 📝 Desenvolvimento
287
+
288
+ ### Adicionar Feature
289
+
290
+ ```bash
291
+ # 1. Criar issue no memory
292
+ echo "## Nova Feature" >> memory/40-delivery/sprint-atual.md
293
+
294
+ # 2. Gerar módulo
295
+ nest generate module modules/feature
296
+
297
+ # 3. Implementar
298
+ # ... código ...
299
+
300
+ # 4. Testar
301
+ npm run test:e2e
302
+
303
+ # 5. Documentar
304
+ # ... atualizar README.md ...
305
+ ```
306
+
307
+ ### Rodar Testes
308
+
309
+ ```bash
310
+ # Testes unitários
311
+ npm run test
312
+
313
+ # E2E
314
+ npm run test:e2e
315
+
316
+ # Coverage
317
+ npm run test:cov
318
+ ```
319
+
320
+ ---
321
+
322
+ ## 🐳 Docker
323
+
324
+ Cada boilerplate tem `docker-compose.yml`:
325
+
326
+ ```bash
327
+ docker-compose up -d
328
+
329
+ # Acessar
330
+ curl http://localhost:3000/api/health
331
+ ```
332
+
333
+ ---
334
+
335
+ ## 📤 Deploy
336
+
337
+ ### Heroku
338
+ ```bash
339
+ git push heroku main
340
+ ```
341
+
342
+ ### AWS
343
+ ```bash
344
+ # Build
345
+ npm run build
346
+
347
+ # Deploy image
348
+ docker build -t app .
349
+ ```
350
+
351
+ ### Docker
352
+ ```bash
353
+ docker build -t my-app .
354
+ docker run -p 3000:3000 my-app
355
+ ```
356
+
357
+ ---
358
+
359
+ ## 🆘 Troubleshooting
360
+
361
+ **Erro: "PORT already in use"**
362
+ ```bash
363
+ # Mudar porta
364
+ PORT=3001 npm run start:dev
365
+ ```
366
+
367
+ **Erro: "Cannot find module"**
368
+ ```bash
369
+ rm -rf node_modules package-lock.json
370
+ npm install
371
+ ```
372
+
373
+ **BD não conecta**
374
+ ```bash
375
+ # Verificar docker-compose
376
+ docker-compose ps
377
+
378
+ # Resetar
379
+ docker-compose down -v
380
+ docker-compose up -d
381
+ ```
382
+
383
+ ---
384
+
385
+ ## 📚 Recursos Adicionais
386
+
387
+ - [create-memory-nest-kit README](../README.md)
388
+ - [Documentação Completa](../INDICE-MASTER.md)
389
+ - [Exemplos de Código](../EXEMPLOS-CODIGO.md)
390
+ - [Guia de Implementação](../IMPLEMENTACAO-FASE1.md)
391
+
392
+ ---
393
+
394
+ ## 🎯 Próximas Etapas
395
+
396
+ 1. ✅ Escolher template
397
+ 2. ✅ Rodar `npm install` e `npm run start:dev`
398
+ 3. ✅ Explorar código
399
+ 4. ✅ Ler documentação por template
400
+ 5. ✅ Customizar conforme necessário
401
+ 6. ✅ Deploy!
402
+
403
+ ---
404
+
405
+ **Versão**: 0.3.1+
406
+ **Status**: 🟢 Production-Ready
407
+ **Templates**: 6 disponíveis
@@ -0,0 +1,47 @@
1
+ # Design Brief
2
+
3
+ - **Feature/superficie**: <ex: dashboard operacional, agent console, docs>
4
+ - **Persona principal**: <quem usa e em que contexto>
5
+ - **Objetivo da UI**: <decisao/acao que a tela precisa facilitar>
6
+ - **Referencia primaria**: <marca/pasta em design-md + motivo>
7
+ - **Referencias secundarias**: <opcional>
8
+ - **Densidade**: baixa | media | alta
9
+ - **Tom visual**: utilitario | premium | editorial | tecnico | colaborativo
10
+
11
+ ## Principios aplicados
12
+
13
+ - <principio 1 vindo da referencia>
14
+ - <principio 2>
15
+ - <principio 3>
16
+
17
+ ## Tokens visuais
18
+
19
+ - **Cores**: <paleta funcional, nao apenas estetica>
20
+ - **Tipografia**: <escala, peso, uso em headings/body/labels>
21
+ - **Espacamento**: <ritmo e grid>
22
+ - **Raios/bordas/sombras**: <restricoes>
23
+ - **Iconografia**: <familia e regras de uso>
24
+
25
+ ## Componentes esperados
26
+
27
+ - <componente 1>
28
+ - <componente 2>
29
+ - <componente 3>
30
+
31
+ ## Estados obrigatorios
32
+
33
+ - [ ] Carregando
34
+ - [ ] Vazio
35
+ - [ ] Erro
36
+ - [ ] Sucesso
37
+ - [ ] Permissao/sem acesso, se aplicavel
38
+ - [ ] Responsivo mobile, se aplicavel
39
+
40
+ ## Criterios de aceite visual
41
+
42
+ - [ ] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
43
+ - [ ] Texto nao quebra nem sobrepoe em mobile e desktop.
44
+ - [ ] A hierarquia deixa clara a proxima acao do usuario.
45
+ - [ ] Estados obrigatorios existem e sao coerentes.
46
+ - [ ] A UI pode ser validada por screenshot ou checklist objetivo.
47
+