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,496 @@
1
+ /**
2
+ * Nest Generator - Gera estrutura completa NestJS
3
+ * Extraído de create-memory-nest-kit.js para modularização
4
+ */
5
+
6
+ import path from 'node:path';
7
+ import { writeFileSafe, ensureDir, maybeGitkeep } from '../utils/file-helpers.js';
8
+
9
+ /**
10
+ * Factory de templates NestJS dinâmicos
11
+ * Recebe projectName para interpolar em package.json
12
+ */
13
+ function createNestTemplates(projectName) {
14
+ return {
15
+ 'backend/package.json': `{
16
+ "name": "${projectName}-api",
17
+ "version": "0.1.0",
18
+ "private": true,
19
+ "scripts": {
20
+ "build": "nest build",
21
+ "start": "nest start",
22
+ "start:dev": "nest start --watch",
23
+ "start:prod": "node dist/main",
24
+ "lint": "eslint \\"src/**/*.ts\\" --max-warnings=0",
25
+ "format": "prettier --write \\"src/**/*.ts\\" \\"test/**/*.ts\\"",
26
+ "test": "jest",
27
+ "test:watch": "jest --watch",
28
+ "test:cov": "jest --coverage",
29
+ "memory:db:init": "node scripts/memory-db-init.mjs",
30
+ "memory:db:sync": "node scripts/memory-db-sync.mjs",
31
+ "memory:db:query": "node scripts/memory-db-query.mjs",
32
+ "memory:watch": "node ../scripts/memory-watcher.mjs"
33
+ },
34
+ "jest": {
35
+ "moduleFileExtensions": ["js", "json", "ts"],
36
+ "rootDir": "src",
37
+ "testRegex": ".*\\\\.spec\\\\.ts$",
38
+ "transform": {
39
+ "^.+\\\\.(t|j)s$": "ts-jest"
40
+ },
41
+ "collectCoverageFrom": ["**/*.(t|j)s"],
42
+ "coverageDirectory": "../coverage",
43
+ "testEnvironment": "node"
44
+ },
45
+ "dependencies": {
46
+ "@nestjs/common": "^11.0.0",
47
+ "@nestjs/core": "^11.0.0",
48
+ "@nestjs/platform-express": "^11.0.0",
49
+ "better-sqlite3": "^11.8.1",
50
+ "reflect-metadata": "^0.2.2",
51
+ "rxjs": "^7.8.1"
52
+ },
53
+ "devDependencies": {
54
+ "@nestjs/cli": "^11.0.0",
55
+ "@nestjs/schematics": "^11.0.0",
56
+ "@nestjs/testing": "^11.0.0",
57
+ "@types/express": "^5.0.1",
58
+ "@types/better-sqlite3": "^7.6.13",
59
+ "@types/jest": "^29.5.14",
60
+ "@types/node": "^22.10.2",
61
+ "@types/supertest": "^6.0.2",
62
+ "eslint": "^9.16.0",
63
+ "eslint-config-prettier": "^9.1.0",
64
+ "jest": "^29.7.0",
65
+ "prettier": "^3.4.2",
66
+ "supertest": "^7.0.0",
67
+ "ts-jest": "^29.2.5",
68
+ "ts-loader": "^9.5.1",
69
+ "ts-node": "^10.9.2",
70
+ "tsconfig-paths": "^4.2.0",
71
+ "typescript": "^5.7.2"
72
+ }
73
+ }
74
+ `,
75
+
76
+ 'backend/nest-cli.json': `{
77
+ "collection": "@nestjs/schematics",
78
+ "sourceRoot": "src"
79
+ }
80
+ `,
81
+
82
+ 'backend/tsconfig.json': `{
83
+ "compilerOptions": {
84
+ "module": "commonjs",
85
+ "declaration": true,
86
+ "removeComments": true,
87
+ "emitDecoratorMetadata": true,
88
+ "experimentalDecorators": true,
89
+ "allowSyntheticDefaultImports": true,
90
+ "target": "es2021",
91
+ "sourceMap": true,
92
+ "outDir": "./dist",
93
+ "baseUrl": "./",
94
+ "incremental": true,
95
+ "strict": true,
96
+ "skipLibCheck": true
97
+ }
98
+ }
99
+ `,
100
+
101
+ 'backend/tsconfig.build.json': `{
102
+ "extends": "./tsconfig.json",
103
+ "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
104
+ }
105
+ `,
106
+
107
+ 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
108
+ import { AppModule } from './app.module';
109
+
110
+ async function bootstrap(): Promise<void> {
111
+ const app = await NestFactory.create(AppModule);
112
+ app.setGlobalPrefix('api');
113
+ await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
114
+ }
115
+
116
+ void bootstrap();
117
+ `,
118
+
119
+ 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
120
+ import { AppController } from "./app.controller";
121
+ import { AppService } from "./app.service";
122
+ import { OpsModule } from "./modules/ops/ops.module";
123
+
124
+ @Module({
125
+ imports: [OpsModule],
126
+ controllers: [AppController],
127
+ providers: [AppService]
128
+ })
129
+ export class AppModule {}
130
+ `,
131
+
132
+ 'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
133
+ import { AppService } from './app.service';
134
+
135
+ @Controller()
136
+ export class AppController {
137
+ constructor(private readonly appService: AppService) {}
138
+
139
+ @Get('health')
140
+ health(): { status: string } {
141
+ return this.appService.health();
142
+ }
143
+ }
144
+ `,
145
+
146
+ 'backend/src/app.service.ts': `import { Injectable } from '@nestjs/common';
147
+
148
+ @Injectable()
149
+ export class AppService {
150
+ health(): { status: string } {
151
+ return { status: 'ok' };
152
+ }
153
+ }
154
+ `,
155
+
156
+ 'backend/src/modules/ops/ops.service.ts': `import { Injectable } from '@nestjs/common';
157
+ import * as Database from 'better-sqlite3';
158
+ import * as path from 'node:path';
159
+
160
+ @Injectable()
161
+ export class OpsService {
162
+ private db: any;
163
+
164
+ constructor() {
165
+ const dbPath = path.resolve(process.cwd(), '..', '.memory', 'sqlite', 'context.db');
166
+ this.db = new (Database as any)(dbPath, { readonly: true });
167
+ }
168
+
169
+ getStats() {
170
+ const agents = this.db.prepare('SELECT agent_name, status, current_task FROM agent_sessions').all();
171
+ const tasks = this.db.prepare('SELECT status, COUNT(*) as count FROM tasks GROUP BY status').all();
172
+ const handoffs = this.db.prepare('SELECT from_agent, to_agent, title, created_at FROM handoffs ORDER BY created_at DESC LIMIT 5').all();
173
+
174
+ return { agents, tasks, handoffs };
175
+ }
176
+ }
177
+ `,
178
+
179
+ 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
180
+ import { OpsService } from './ops.service';
181
+
182
+ @Controller('ops')
183
+ export class OpsController {
184
+ constructor(private readonly opsService: OpsService) {}
185
+
186
+ @Get('stats')
187
+ getStats() {
188
+ return this.opsService.getStats();
189
+ }
190
+
191
+ @Get()
192
+ renderDashboard() {
193
+ const stats = this.opsService.getStats();
194
+
195
+ return \`
196
+ <!DOCTYPE html>
197
+ <html lang="pt-BR">
198
+ <head>
199
+ <meta charset="UTF-8">
200
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
201
+ <title>Agentes Ops Dashboard</title>
202
+ <script src="https://cdn.tailwindcss.com"><\/script>
203
+ <meta http-equiv="refresh" content="30">
204
+ </head>
205
+ <body class="bg-gray-900 text-gray-100 font-sans p-8">
206
+ <div class="max-w-6xl mx-auto">
207
+ <header class="flex justify-between items-center mb-12">
208
+ <h1 class="text-3xl font-bold text-blue-400">🚀 Agentes Operacionais</h1>
209
+ <div class="text-sm text-gray-400">Sincronizado via SQLite</div>
210
+ </header>
211
+
212
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
213
+ <!-- Agentes -->
214
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
215
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
216
+ <span class="mr-2">🤖</span> Status dos Agentes
217
+ </h2>
218
+ <div class="space-y-4">
219
+ \${stats.agents.map((a: any) => \`
220
+ <div class="p-3 bg-gray-900 rounded-lg border-l-4 \${a.status === 'IDLE' ? 'border-green-500' : 'border-yellow-500'}">
221
+ <div class="font-bold">\${a.agent_name}</div>
222
+ <div class="text-xs text-gray-400">\${a.status} \${a.current_task ? ' - ' + a.current_task : ''}</div>
223
+ </div>
224
+ \`).join('')}
225
+ </div>
226
+ </section>
227
+
228
+ <!-- Tarefas -->
229
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
230
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
231
+ <span class="mr-2">📊</span> Backlog & Progresso
232
+ </h2>
233
+ <div class="space-y-4">
234
+ \${stats.tasks.map((t: any) => \`
235
+ <div class="flex justify-between items-center">
236
+ <span class="capitalize">\${t.status}</span>
237
+ <span class="bg-blue-600 px-2 py-1 rounded text-xs">\${t.count}</span>
238
+ </div>
239
+ \`).join('')}
240
+ </div>
241
+ </section>
242
+
243
+ <!-- Handoffs -->
244
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
245
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
246
+ <span class="mr-2">🤝</span> Últimos Handoffs
247
+ </h2>
248
+ <div class="space-y-3">
249
+ \${stats.handoffs.map((h: any) => \`
250
+ <div class="text-xs border-b border-gray-700 pb-2">
251
+ <div class="text-blue-300 font-medium">\${h.from_agent} → \${h.to_agent}</div>
252
+ <div class="text-gray-400 truncate">\${h.title}</div>
253
+ </div>
254
+ \`).join('')}
255
+ </div>
256
+ </section>
257
+ </div>
258
+
259
+ <footer class="mt-12 text-center text-gray-500 text-xs">
260
+ Atualizado em: \${new Date().toLocaleString('pt-BR')} | create-memory-nest-kit v0.5.0
261
+ </footer>
262
+ </div>
263
+ </body>
264
+ </html>
265
+ \`;
266
+ }
267
+ }
268
+ `,
269
+
270
+ 'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
271
+ import { OpsController } from './ops.controller';
272
+ import { OpsService } from './ops.service';
273
+
274
+ @Module({
275
+ controllers: [OpsController],
276
+ providers: [OpsService]
277
+ })
278
+ export class OpsModule {}
279
+ `,
280
+
281
+ 'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
282
+ import { AppController } from './app.controller';
283
+ import { AppService } from './app.service';
284
+
285
+ describe('AppController', () => {
286
+ let controller: AppController;
287
+
288
+ beforeEach(async () => {
289
+ const module: TestingModule = await Test.createTestingModule({
290
+ controllers: [AppController],
291
+ providers: [AppService]
292
+ }).compile();
293
+
294
+ controller = module.get<AppController>(AppController);
295
+ });
296
+
297
+ it('health() deve retornar status ok', () => {
298
+ expect(controller.health()).toEqual({ status: 'ok' });
299
+ });
300
+ });
301
+ `,
302
+
303
+ 'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
304
+ import { INestApplication } from '@nestjs/common';
305
+ import request from 'supertest';
306
+ import { AppModule } from '../src/app.module';
307
+
308
+ describe('AppController (e2e)', () => {
309
+ let app: INestApplication;
310
+
311
+ beforeEach(async () => {
312
+ const moduleFixture: TestingModule = await Test.createTestingModule({
313
+ imports: [AppModule]
314
+ }).compile();
315
+
316
+ app = moduleFixture.createNestApplication();
317
+ await app.init();
318
+ });
319
+
320
+ it('/api/health (GET)', async () => {
321
+ await request(app.getHttpServer())
322
+ .get('/api/health')
323
+ .expect(200)
324
+ .expect({ status: 'ok' });
325
+ });
326
+ });
327
+ `,
328
+
329
+ 'backend/jest-e2e.json': `{
330
+ "moduleFileExtensions": ["js", "json", "ts"],
331
+ "rootDir": ".",
332
+ "testEnvironment": "node",
333
+ "testRegex": ".e2e-spec.ts$",
334
+ "transform": {
335
+ "^.+\\\\.(t|j)s$": "ts-jest"
336
+ }
337
+ }
338
+ `,
339
+
340
+ 'backend/.eslintrc.json': `{
341
+ "parser": "@typescript-eslint/parser",
342
+ "parserOptions": {
343
+ "project": "tsconfig.json",
344
+ "sourceType": "module"
345
+ },
346
+ "plugins": ["@typescript-eslint/eslint-plugin"],
347
+ "extends": ["plugin:@typescript-eslint/recommended", "prettier"],
348
+ "root": true,
349
+ "env": {
350
+ "node": true,
351
+ "jest": true
352
+ },
353
+ "ignorePatterns": [".eslintrc.js"],
354
+ "rules": {
355
+ "@typescript-eslint/interface-name-prefix": "off",
356
+ "@typescript-eslint/explicit-function-return-type": "off",
357
+ "@typescript-eslint/explicit-module-boundary-types": "off",
358
+ "@typescript-eslint/no-explicit-any": "off"
359
+ }
360
+ }
361
+ `,
362
+
363
+ 'backend/.prettierrc': `{
364
+ "singleQuote": true,
365
+ "trailingComma": "all",
366
+ "semi": true,
367
+ "printWidth": 100,
368
+ "arrowParens": "always"
369
+ }
370
+ `,
371
+ };
372
+ }
373
+
374
+ /**
375
+ * Templates dos scripts de banco de dados (estáticos)
376
+ */
377
+ const databaseScriptTemplates = {
378
+ 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
379
+ PRAGMA foreign_keys = ON;
380
+
381
+ CREATE TABLE IF NOT EXISTS documents (
382
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
383
+ path TEXT NOT NULL UNIQUE,
384
+ kind TEXT NOT NULL,
385
+ title TEXT,
386
+ content_hash TEXT NOT NULL,
387
+ content TEXT NOT NULL,
388
+ updated_at TEXT NOT NULL
389
+ );
390
+
391
+ CREATE TABLE IF NOT EXISTS document_chunks (
392
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
393
+ document_id INTEGER NOT NULL,
394
+ chunk_index INTEGER NOT NULL,
395
+ content TEXT NOT NULL,
396
+ token_estimate INTEGER NOT NULL DEFAULT 0,
397
+ FOREIGN KEY(document_id) REFERENCES documents(id) ON DELETE CASCADE
398
+ );
399
+
400
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_document_chunks_unique
401
+ ON document_chunks (document_id, chunk_index);
402
+
403
+ CREATE TABLE IF NOT EXISTS handoffs (
404
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
405
+ file_path TEXT NOT NULL UNIQUE,
406
+ from_agent TEXT,
407
+ to_agent TEXT,
408
+ title TEXT,
409
+ created_at TEXT NOT NULL,
410
+ status TEXT NOT NULL DEFAULT 'open'
411
+ );
412
+
413
+ CREATE TABLE IF NOT EXISTS adrs (
414
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
415
+ adr_code TEXT NOT NULL UNIQUE,
416
+ title TEXT NOT NULL,
417
+ file_path TEXT NOT NULL UNIQUE,
418
+ status TEXT NOT NULL DEFAULT 'accepted',
419
+ updated_at TEXT NOT NULL
420
+ );
421
+
422
+ CREATE TABLE IF NOT EXISTS summaries (
423
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
424
+ scope TEXT NOT NULL,
425
+ scope_key TEXT NOT NULL,
426
+ file_path TEXT NOT NULL UNIQUE,
427
+ summary TEXT NOT NULL,
428
+ updated_at TEXT NOT NULL
429
+ );
430
+
431
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_summaries_scope
432
+ ON summaries (scope, scope_key);
433
+
434
+ CREATE TABLE IF NOT EXISTS tasks (
435
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
436
+ task_key TEXT NOT NULL UNIQUE,
437
+ title TEXT NOT NULL,
438
+ status TEXT NOT NULL DEFAULT 'open',
439
+ owner_agent TEXT,
440
+ source_file TEXT NOT NULL,
441
+ updated_at TEXT NOT NULL
442
+ );
443
+
444
+ CREATE TABLE IF NOT EXISTS agent_sessions (
445
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
446
+ agent_name TEXT NOT NULL UNIQUE,
447
+ status TEXT NOT NULL DEFAULT 'IDLE',
448
+ current_task TEXT,
449
+ updated_at TEXT NOT NULL
450
+ );
451
+ `,
452
+ };
453
+
454
+ /**
455
+ * Gera estrutura completa do NestJS backend
456
+ * @param {string} baseDir - Diretório base
457
+ * @param {string} projectName - Nome do projeto
458
+ * @param {Object} options - Opções (force, noGitkeep)
459
+ */
460
+ export function generateNestStructure(baseDir, projectName, options = {}) {
461
+ const dynamicTemplates = createNestTemplates(projectName);
462
+ const allTemplates = { ...dynamicTemplates, ...databaseScriptTemplates };
463
+
464
+ // Escrever todos os arquivos
465
+ for (const [relativePath, content] of Object.entries(allTemplates)) {
466
+ writeFileSafe(path.join(baseDir, relativePath), content, options);
467
+ }
468
+
469
+ // Criar diretórios vazios estruturados
470
+ const emptyDirs = [
471
+ 'backend/src/common',
472
+ 'backend/src/common/decorators',
473
+ 'backend/src/common/filters',
474
+ 'backend/src/common/guards',
475
+ 'backend/src/common/interceptors',
476
+ 'backend/src/common/pipes',
477
+ 'backend/src/database',
478
+ 'backend/test/fixtures',
479
+ ];
480
+
481
+ for (const relDir of emptyDirs) {
482
+ const abs = path.join(baseDir, relDir);
483
+ ensureDir(abs);
484
+ maybeGitkeep(abs, options);
485
+ }
486
+
487
+ return {
488
+ success: true,
489
+ filesWritten: Object.keys(allTemplates).length,
490
+ emptyDirsCreated: emptyDirs.length,
491
+ };
492
+ }
493
+
494
+ export default {
495
+ generateNestStructure,
496
+ };
@@ -0,0 +1,213 @@
1
+ /**
2
+ * README Generator - Gera README.md para novo projeto
3
+ */
4
+
5
+ import path from 'node:path';
6
+ import { writeFileSafe } from '../utils/file-helpers.js';
7
+
8
+ /**
9
+ * Factory para README dinâmico
10
+ */
11
+ function createReadmeContent(projectName) {
12
+ return `# ${projectName}
13
+
14
+ Scaffold gerado por **create-memory-nest-kit v0.5.0**
15
+
16
+ ## 🎯 Estrutura
17
+
18
+ Este projeto segue uma arquitetura modular com:
19
+
20
+ - **memory/** — Hierarquia de documentação centralizada
21
+ - 00-global/ — Missão, padrões, contexto
22
+ - 10-product/ — Visão, personas, regras
23
+ - 20-architecture/ — Design do sistema
24
+ - 30-domains/ — Bounded contexts (auth, billing, etc)
25
+ - 40-delivery/ — Roadmap e sprints
26
+ - 50-orchestration/ — Topologia de agentes, handoffs
27
+ - 60-runs/ — Log de execução
28
+ - 70-summaries/ — Resumos compactados
29
+ - 80-data/ — Schema e queries
30
+ - 90-decisions/ — ADRs
31
+
32
+ - **agents/** — Definição de agentes especializados
33
+ - **skills/** — Capacidades reutilizáveis
34
+ - **prompts/** — Instruções por contexto
35
+ - **backend/** — API NestJS (se gerado)
36
+
37
+ ## 🚀 Quick Start
38
+
39
+ ### 1. Explorar a Memória
40
+
41
+ \`\`\`bash
42
+ # Ler a missão do projeto
43
+ cat memory/00-global/mission.md
44
+
45
+ # Ler padrões globais
46
+ cat memory/00-global/standards.md
47
+
48
+ # Ler arquitetura
49
+ cat memory/20-architecture/system-overview.md
50
+ \`\`\`
51
+
52
+ ### 2. Construir Contexto
53
+
54
+ \`\`\`bash
55
+ # Gerar um context pack com os arquivos prioritários
56
+ node scripts/build-context-pack.mjs
57
+
58
+ # Arquivo gerado em .context/context-pack.md
59
+ \`\`\`
60
+
61
+ ### 3. Executar Backend (opcional)
62
+
63
+ \`\`\`bash
64
+ cd backend
65
+
66
+ # Instalar dependências
67
+ npm install
68
+
69
+ # Rodar em desenvolvimento
70
+ npm run start:dev
71
+
72
+ # Executar testes
73
+ npm test
74
+
75
+ # Verificar saúde da API
76
+ curl http://localhost:3000/api/health
77
+ \`\`\`
78
+
79
+ ## 📝 Fluxo de Trabalho Multiagente
80
+
81
+ ### Orquestrador
82
+ - Recebe tarefa
83
+ - Decompõe em subtarefas independentes
84
+ - Atribui ownership por arquivo
85
+
86
+ ### Workers
87
+ - Executam subtarefas isoladas
88
+ - Entregam: alterações, testes, riscos
89
+ - Registram handoff em memory/50-orchestration/handoffs/
90
+
91
+ ### Reviewer
92
+ - Valida qualidade, segurança, cobertura
93
+ - Aprova ou rejeita
94
+
95
+ ### Consolidação
96
+ - Integrar handoffs
97
+ - Atualizar resumos em memory/70-summaries/
98
+
99
+ ## 🔄 Protocolo de Handoff
100
+
101
+ Cada handoff deve incluir:
102
+
103
+ - **Contexto**: O que foi feito e por quê?
104
+ - **Alterações**: Lista de arquivos modificados
105
+ - **Riscos**: Potenciais problemas ou edge cases
106
+ - **Pendências**: O que não foi concluído
107
+ - **Próximo Passo**: Quem assume e o quê fazer
108
+
109
+ Exemplo:
110
+ \`\`\`bash
111
+ node ../scripts/append-handoff.mjs agente-a agente-b "Título da entrega"
112
+ \`\`\`
113
+
114
+ ## 🗄️ Banco de Dados (SQLite)
115
+
116
+ A estrutura de memória é indexada em SQLite para busca rápida:
117
+
118
+ \`\`\`bash
119
+ # Inicializar banco
120
+ cd backend && npm run memory:db:init
121
+
122
+ # Sincronizar com markdown
123
+ npm run memory:db:sync
124
+
125
+ # Consultar por termo
126
+ npm run memory:db:query -- "auth"
127
+ \`\`\`
128
+
129
+ ## 📊 Dashboard Operacional
130
+
131
+ Após iniciar o backend:
132
+
133
+ \`\`\`bash
134
+ # Abrir em navegador
135
+ open http://localhost:3000/ops
136
+ \`\`\`
137
+
138
+ Mostra:
139
+ - Status dos agentes
140
+ - Progresso de tarefas
141
+ - Últimos handoffs
142
+
143
+ ## 🛠️ Scripts Utilitários
144
+
145
+ | Script | O que faz |
146
+ |--------|-----------|
147
+ | \`build-context-pack.mjs\` | Monta pack de contexto prioritário |
148
+ | \`append-handoff.mjs\` | Cria novo arquivo de handoff |
149
+ | \`memory-vacuum.mjs\` | Arquiva logs > 30 dias |
150
+ | \`memory-watcher.mjs\` | Auto-sync de markdown → SQLite |
151
+
152
+ ## 📚 Documentação Importante
153
+
154
+ - **memory/00-global/context-policy.md** — Política de janelas de contexto
155
+ - **memory/00-global/agent-contract.md** — Contrato entre agentes
156
+ - **memory/50-orchestration/handoff-protocol.md** — Protocolo formal de handoff
157
+ - **prompts/project-prompt-base.md** — Instruções base para agentes
158
+ - **AGENTS.md** — Definição de papéis e responsabilidades
159
+
160
+ ## 🎯 Próximos Passos
161
+
162
+ 1. ✅ Preencher memory/10-product/vision.md
163
+ 2. ✅ Preencher memory/20-architecture/* com detalhes do seu sistema
164
+ 3. ✅ Criar ADRs em memory/90-decisions/
165
+ 4. ✅ Adicionar domínios em memory/30-domains/
166
+ 5. ✅ Kickoff do primeiro sprint
167
+ 6. ✅ Registrar primeiros handoffs
168
+
169
+ ## 🤝 Contribuindo
170
+
171
+ ### Padrões
172
+ - Documentação em **pt-BR**
173
+ - Decisões explícitas em ADR
174
+ - Toda mudança registra impacto e rollback
175
+
176
+ ### Validação
177
+ \`\`\`bash
178
+ # Verificar integridade de estrutura
179
+ npm run project:check
180
+
181
+ # Gerar dashboard de progresso
182
+ npm run project:dashboard
183
+ \`\`\`
184
+
185
+ ---
186
+
187
+ **Gerado em**: ${new Date().toISOString()}
188
+
189
+ **Versão**: v0.5.0
190
+
191
+ `;
192
+ }
193
+
194
+ /**
195
+ * Escreve README.md para o projeto
196
+ * @param {string} baseDir - Diretório base
197
+ * @param {string} projectName - Nome do projeto
198
+ * @param {Object} options - Opções (force)
199
+ */
200
+ export function generateReadme(baseDir, projectName, options = {}) {
201
+ const content = createReadmeContent(projectName);
202
+ writeFileSafe(path.join(baseDir, 'README.md'), content, options);
203
+
204
+ return {
205
+ success: true,
206
+ path: path.join(baseDir, 'README.md'),
207
+ size: content.length,
208
+ };
209
+ }
210
+
211
+ export default {
212
+ generateReadme,
213
+ };