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,844 @@
1
+ /**
2
+ * Memory Generator - Gera estrutura completa de memória hierárquica
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
+ * Template de arquivos da estrutura de memória
11
+ * Organizado por categorias para facilitar manutenção
12
+ */
13
+ const memoryTemplates = {
14
+ // === GLOBAL (00-global) ===
15
+ 'memory/README.md': `# Memoria do Projeto
16
+
17
+ Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
18
+
19
+ ## Principio
20
+ - Nao depender de um unico contexto gigante.
21
+ - Trabalhar com memoria em camadas + handoff incremental.
22
+ - Registrar decisoes, resumos e execucoes para continuidade.
23
+ `,
24
+
25
+ 'memory/00-global/mission.md': `# Missao do Projeto
26
+
27
+ Construir software com clareza arquitetural, seguranca by-default e entrega continua.
28
+
29
+ ## Principios
30
+ - Simplicidade primeiro
31
+ - Decisoes explicitas em ADR
32
+ - Qualidade e seguranca desde o inicio
33
+ - Documentacao viva
34
+ `,
35
+
36
+ 'memory/00-global/standards.md': `# Padroes Globais
37
+
38
+ ## Idioma
39
+ - Toda comunicacao e documentacao em **pt-BR**.
40
+
41
+ ## Backend
42
+ - API criada em **NestJS** por padrao.
43
+ - Arquitetura modular por dominio.
44
+
45
+ ## Qualidade
46
+ - Cada mudanca deve registrar impacto, risco e rollback.
47
+ - Priorizar padroes reutilizaveis.
48
+ `,
49
+
50
+ 'memory/00-global/context-policy.md': `# Politica de Contexto Longo
51
+
52
+ ## Objetivo
53
+ Permitir trabalho em larga escala sem depender de janela unica gigantesca.
54
+
55
+ ## Regras
56
+ - Usar contexto em camadas: global -> dominio -> tarefa -> diff.
57
+ - Antes de cada tarefa: carregar apenas arquivos necessarios.
58
+ - A cada entrega: gerar resumo curto em memory/70-summaries.
59
+ - Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
60
+
61
+ ## 🔄 Protocolo de Recuperacao (Engine Switch)
62
+ Se houver esgotamento de cota ou necessidade de mudar de IA:
63
+ 1. Localize o arquivo \`.ia-instructions/models.json\`.
64
+ 2. Identifique o proximo motor na \`fallback_chain\`.
65
+ 3. Carregue as instrucoes do novo motor.
66
+ 4. Forneca o conteúdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
67
+ 5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
68
+
69
+ ## Nota importante
70
+ Esta estrutura **nao aumenta** limite nativo do modelo.
71
+ Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
72
+ `,
73
+
74
+ 'memory/00-global/agent-contract.md': `# Contrato de Agentes
75
+
76
+ ## Orquestrador
77
+ - Decompõe trabalho em subtarefas independentes.
78
+ - Define dono por escopo de arquivo.
79
+ - Consolida handoffs e conflitos.
80
+
81
+ ## Workers
82
+ - Implementam subtarefas com escopo claro.
83
+ - Nao alteram areas de outros agentes sem alinhamento.
84
+ - Entregam: alteracoes, riscos, testes e pendencias.
85
+
86
+ ## Reviewer
87
+ - Verifica regressao, seguranca e cobertura de testes.
88
+ - Bloqueia merge se encontrar risco critico.
89
+ `,
90
+
91
+ 'memory/00-global/context-index.md': `# Indice de Contexto
92
+
93
+ ## Ordem de Leitura
94
+ 1. memory/00-global/mission.md
95
+ 2. memory/00-global/standards.md
96
+ 3. memory/00-global/context-policy.md
97
+ 4. memory/10-product/*
98
+ 5. memory/20-architecture/*
99
+ 6. memory/30-domains/<dominio>/*
100
+ 7. memory/40-delivery/current-sprint.md
101
+ 8. memory/90-decisions/ADR-*.md
102
+ 9. memory/70-summaries/*
103
+ `,
104
+
105
+ // === PRODUCT (10-product) ===
106
+ 'memory/10-product/vision.md': `# Visao de Produto
107
+
108
+ Descreva objetivo, publico-alvo, problema e proposta de valor.
109
+ `,
110
+
111
+ 'memory/10-product/personas.md': `# Personas
112
+
113
+ Liste personas e dores principais.
114
+ `,
115
+
116
+ 'memory/10-product/business-rules.md': `# Regras de Negocio
117
+
118
+ Documente regras imutaveis e validacoes criticas.
119
+ `,
120
+
121
+ 'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
122
+
123
+ - Performance
124
+ - Seguranca
125
+ - Observabilidade
126
+ - Escalabilidade
127
+ `,
128
+
129
+ // === ARCHITECTURE (20-architecture) ===
130
+ 'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
131
+
132
+ Descreva contexto, fronteiras e integracoes principais.
133
+ `,
134
+
135
+ 'memory/20-architecture/frontend.md': `# Frontend
136
+
137
+ Defina padroes de componentizacao, acessibilidade e performance.
138
+ `,
139
+
140
+ 'memory/20-architecture/backend.md': `# Backend
141
+
142
+ ## Diretriz principal
143
+ - Backend em **NestJS** por padrao.
144
+
145
+ ## Estrutura sugerida
146
+ - Modulos por dominio
147
+ - DTO + validacao
148
+ - Servicos com regras de negocio
149
+ - Repositorios/integradores isolados
150
+ `,
151
+
152
+ 'memory/20-architecture/data.md': `# Dados
153
+
154
+ Descreva entidades, relacionamentos e politicas de retencao.
155
+ `,
156
+
157
+ 'memory/20-architecture/security.md': `# Seguranca
158
+
159
+ - Principio do menor privilegio
160
+ - Segredos fora do codigo
161
+ - Validacao de entrada em todas as rotas
162
+ - Logs sem dados sensiveis
163
+ `,
164
+
165
+ 'memory/20-architecture/observability.md': `# Observabilidade
166
+
167
+ - Logs estruturados
168
+ - Metricas e tracing
169
+ - Alertas por SLO
170
+ `,
171
+
172
+ // === DOMAINS (30-domains) ===
173
+ 'memory/30-domains/auth/context.md': `# Contexto de Auth
174
+
175
+ Defina escopo funcional de autenticacao/autorizacao.
176
+ `,
177
+
178
+ 'memory/30-domains/auth/rules.md': `# Regras de Auth
179
+
180
+ Liste regras e restricoes de seguranca.
181
+ `,
182
+
183
+ 'memory/30-domains/auth/api.md': `# API de Auth
184
+
185
+ Documente endpoints, payloads e erros.
186
+ `,
187
+
188
+ 'memory/30-domains/billing/context.md': `# Contexto de Billing
189
+
190
+ Defina cobranca, ciclo e integracoes.
191
+ `,
192
+
193
+ 'memory/30-domains/billing/rules.md': `# Regras de Billing
194
+
195
+ Descreva calculos, status e excecoes.
196
+ `,
197
+
198
+ 'memory/30-domains/billing/api.md': `# API de Billing
199
+
200
+ Documente endpoints e regras de idempotencia.
201
+ `,
202
+
203
+ // === DELIVERY (40-delivery) ===
204
+ 'memory/40-delivery/roadmap.md': `# Roadmap
205
+
206
+ Mapeie entregas por trimestre/sprint.
207
+ `,
208
+
209
+ 'memory/40-delivery/current-sprint.md': `# Sprint Atual
210
+
211
+ ## Objetivos
212
+ -
213
+
214
+ ## Itens
215
+ -
216
+
217
+ ## Riscos
218
+ -
219
+ `,
220
+
221
+ 'memory/40-delivery/backlog.md': `# Backlog
222
+
223
+ Liste itens priorizados com contexto minimo.
224
+ `,
225
+
226
+ // === ORCHESTRATION (50-orchestration) ===
227
+ 'memory/50-orchestration/topology.md': `# Topologia Multiagente
228
+
229
+ ## Papeis
230
+ - Orquestrador
231
+ - Worker Backend (NestJS)
232
+ - Worker Frontend
233
+ - Worker DBA
234
+ - Worker Security
235
+ - Reviewer
236
+
237
+ ## Fluxo
238
+ 1. Orquestrador cria plano e fatia trabalho.
239
+ 2. Workers executam em paralelo com escopo isolado.
240
+ 3. Handoffs sao registrados.
241
+ 4. Reviewer valida e aprova.
242
+ `,
243
+
244
+ 'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
245
+
246
+ ## Regras de roteamento
247
+ - API e dominio server-side -> backend-nest
248
+ - Schema/migracao/query -> dba
249
+ - Auth, hardening, segredos -> security
250
+ - UX/componentes -> frontend
251
+
252
+ ## Critico
253
+ Subtarefas devem ter dono unico por arquivo para evitar conflito.
254
+ `,
255
+
256
+ 'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
257
+
258
+ Cada handoff deve conter:
259
+ - contexto minimo
260
+ - alteracoes realizadas
261
+ - arquivos tocados
262
+ - riscos e pontos abertos
263
+ - proximos passos objetivos
264
+ `,
265
+
266
+ 'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
267
+
268
+ ## Quando paralelizar
269
+ - Subtarefas independentes por dominio.
270
+ - Escopo de escrita sem sobreposicao.
271
+
272
+ ## Quando nao paralelizar
273
+ - Mudanca bloqueante para a proxima etapa.
274
+ - Refactor altamente acoplado no mesmo modulo.
275
+ `,
276
+
277
+ 'memory/50-orchestration/handoffs/README.md': `# Handoffs
278
+
279
+ Registre cada transicao em arquivos markdown com timestamp.
280
+ Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
281
+ `,
282
+
283
+ // === RUNS (60-runs) ===
284
+ 'memory/60-runs/README.md': `# Runs
285
+
286
+ Log de execucao por ciclo/sprint.
287
+ `,
288
+
289
+ // === SUMMARIES (70-summaries) ===
290
+ 'memory/70-summaries/global-summary.md': `# Resumo Global
291
+
292
+ Atualize a cada marco importante com:
293
+ - estado atual
294
+ - decisoes novas
295
+ - riscos ativos
296
+ `,
297
+
298
+ 'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
299
+
300
+ Mantenha resumos curtos por dominio para carregamento rapido de contexto.
301
+ `,
302
+
303
+ // === DATA (80-data) ===
304
+ 'memory/80-data/memory-db.md': `# Memory DB (SQLite)
305
+
306
+ ## Objetivo
307
+ Armazenar indice operacional da documentacao para busca e continuidade de contexto.
308
+
309
+ ## Fonte da verdade
310
+ - Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
311
+
312
+ ## Banco
313
+ - SQLite em .memory/sqlite/context.db
314
+
315
+ ## Fluxo
316
+ 1. Atualizar markdown
317
+ 2. Rodar sincronizacao
318
+ 3. Consultar contexto por texto ou tipo
319
+ `,
320
+
321
+ // === DECISIONS (90-decisions) ===
322
+ 'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
323
+
324
+ ## Contexto
325
+
326
+ ## Decisao
327
+
328
+ ## Consequencias
329
+
330
+ ## Alternativas consideradas
331
+ `,
332
+ };
333
+
334
+ /**
335
+ * Gera estrutura de agentes
336
+ */
337
+ const agentTemplates = {
338
+ 'agents/README.md': `# Agents
339
+
340
+ Agentes especializados para dividir trabalho em paralelo.
341
+ `,
342
+
343
+ 'agents/orchestrator.md': `# Agent: Orchestrator
344
+
345
+ ## Responsabilidade
346
+ Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
347
+
348
+ ## Entrega minima
349
+ - plano objetivo
350
+ - distribuicao por agentes
351
+ - consolidacao de handoffs
352
+ `,
353
+
354
+ 'agents/backend-nest.md': `# Agent: Backend NestJS
355
+
356
+ ## Escopo
357
+ - modulos, controllers, services, dto, guard, pipe
358
+ - testes unitarios e e2e da API
359
+
360
+ ## Padrao
361
+ - NestJS por padrao
362
+ - validacao de entrada obrigatoria
363
+ `,
364
+
365
+ 'agents/frontend.md': `# Agent: Frontend
366
+
367
+ ## Escopo
368
+ - componentes, acessibilidade, performance, UX
369
+ `,
370
+
371
+ 'agents/dba.md': `# Agent: DBA
372
+
373
+ ## Escopo
374
+ - modelagem, indices, migracoes, tuning de query
375
+ `,
376
+
377
+ 'agents/security.md': `# Agent: Security
378
+
379
+ ## Escopo
380
+ - threat modeling, hardening, authz/authn, secrets, auditoria
381
+ `,
382
+
383
+ 'agents/reviewer.md': `# Agent: Reviewer
384
+
385
+ ## Escopo
386
+ - regressao funcional
387
+ - riscos de seguranca
388
+ - cobertura de testes
389
+ `,
390
+ };
391
+
392
+ /**
393
+ * Gera estrutura de skills
394
+ */
395
+ const skillTemplates = {
396
+ 'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
397
+
398
+ ## Objetivo
399
+ Classificar demanda em: rapido, medio, complexo.
400
+
401
+ ## Saida
402
+ - resumo
403
+ - risco
404
+ - owner sugerido
405
+ - fatias de execucao
406
+ `,
407
+
408
+ 'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
409
+
410
+ ## Objetivo
411
+ Gerar resumo operacional sem perder decisoes chave.
412
+
413
+ ## Regras
414
+ - manter fatos verificaveis
415
+ - remover redundancia
416
+ - preservar links para fontes internas
417
+ `,
418
+
419
+ 'skills/handoff/SKILL.md': `# Skill: Handoff
420
+
421
+ ## Template
422
+ - contexto
423
+ - alteracoes
424
+ - riscos
425
+ - pendencias
426
+ - proximo agente
427
+ `,
428
+
429
+ 'skills/nest-api/SKILL.md': `# Skill: Nest API
430
+
431
+ ## Checklist
432
+ - modulo criado
433
+ - dto com validacao
434
+ - controller + service
435
+ - testes
436
+ `,
437
+
438
+ 'skills/self-healing/SKILL.md': `# Skill: Auto-Diagnóstico (Self-Healing)
439
+
440
+ ## Objetivo
441
+ Resolver falhas de build, testes ou tipos sem intervenção humana.
442
+
443
+ ## Fluxo
444
+ 1. Analisar a stack trace completa do erro.
445
+ 2. Identificar se é: erro de sintaxe, falta de dependência, erro de tipo ou lógica.
446
+ 3. Consultar documentação interna ou padrões do projeto.
447
+ 4. Propor correção mínima e rodar validação novamente.
448
+ `,
449
+
450
+ 'skills/validate-handoff/SKILL.md': `# Skill: Validação e Review de Segurança (Gatekeeper)
451
+
452
+ ## Objetivo
453
+ Atuar como Gatekeeper final para garantir que nenhum código inseguro ou incompleto entre no pipeline.
454
+
455
+ ## Protocolo de Review (Obrigatório)
456
+ Antes de aceitar um handoff, o Reviewer deve validar:
457
+
458
+ 1. **Compliance de Raciocínio**: O Worker preencheu o bloco \`## Raciocínio Estruturado\`? (Se não, rejeite imediatamente).
459
+ 2. **Scan de Segurança**:
460
+ - Há logs sensíveis (PII, tokens) sendo impressos?
461
+ - As validações de input estão no DTO?
462
+ 3. **Verificação de Handoff**:
463
+ - Os arquivos listados no handoff condizem com o diff real?
464
+ - Existem pendências (riscos) não documentadas?
465
+
466
+ ## Saída do Reviewer
467
+ - [ ] Aprovado (Status: \`done\` no DB)
468
+ - [ ] Rejeitado (Status: \`blocked\` + pendências listadas)
469
+ `,
470
+
471
+ 'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
472
+
473
+ ## Objetivo
474
+ Garantir que a UI segue padrões de elite.
475
+
476
+ ## Instrução
477
+ 1. Consultar a biblioteca \`design-md/\` para inspiração de marca/padrão.
478
+ 2. Comparar o código gerado com os padrões de espaçamento, tipografia e cores da referência.
479
+ 3. Ajustar CSS/Componentes para atingir qualidade visual de nível mundial.
480
+ `,
481
+
482
+ 'skills/reasoning-protocol/SKILL.md': `# Skill: Raciocínio Estruturado (Chain-of-Thought)
483
+
484
+ ## Objetivo
485
+ Reduzir erros de implementação através de análise lógica explícita.
486
+
487
+ ## Protocolo Obrigatório
488
+ Antes de qualquer código ou plano de ação, preencha o bloco \`## Raciocínio Estruturado\`:
489
+
490
+ 1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
491
+ 2. **Restrições**: Quais arquivos NÃO posso tocar? Quais padrões devo seguir?
492
+ 3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
493
+ 4. **Plano de Ataque**: Passo-a-passo lógico da implementação.
494
+ `,
495
+
496
+ 'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
497
+
498
+ ## Objetivo
499
+ Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor.
500
+
501
+ ## Quando usar
502
+ - O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
503
+ - Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
504
+ - Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
505
+
506
+ ## Regras
507
+ - Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
508
+ - Usar \`manual\` quando o provider nao tiver CLI local confiavel.
509
+ - Registrar \`provider\`, \`model\`, \`command\`, \`taskTypes\` e \`notes\` em \`.memory/agent-llm-routing.json\`.
510
+ - Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
511
+ - Nao colocar API keys em memoria, specs, handoffs ou logs.
512
+
513
+ ## Checklist
514
+ 1. Identificar papel e tipo de tarefa.
515
+ 2. Escolher provider e modelo no dashboard ou via API \`/api/llm-routing/:role\`.
516
+ 3. Preencher \`command\` com a CLI real ou wrapper local.
517
+ 4. Rodar um teste pequeno antes de delegar sprint inteira.
518
+ 5. Registrar handoff Hermes quando a troca impactar entrega.
519
+ `,
520
+
521
+ 'skills/MANIFEST.json': `{
522
+ "version": "0.5.0",
523
+ "skills": [
524
+ { "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "Classificação de tarefas" },
525
+ { "id": "compaction", "path": "skills/context-compaction/SKILL.md", "description": "Compactação de memória" },
526
+ { "id": "handoff", "path": "skills/handoff/SKILL.md", "description": "Protocolo de transição" },
527
+ { "id": "nest-api", "path": "skills/nest-api/SKILL.md", "description": "Geração de endpoints NestJS" },
528
+ { "id": "self-healing", "path": "skills/self-healing/SKILL.md", "description": "Resolução autônoma de erros" },
529
+ { "id": "validate-handoff", "path": "skills/validate-handoff/SKILL.md", "description": "Checklist de qualidade de handoff" },
530
+ { "id": "ui-fidelity", "path": "skills/ui-fidelity/SKILL.md", "description": "Auditoria estética de UI" },
531
+ { "id": "reasoning", "path": "skills/reasoning-protocol/SKILL.md", "description": "Protocolo de raciocínio lógico" },
532
+ { "id": "llm-provider-routing", "path": "skills/llm-provider-routing/SKILL.md", "description": "Roteamento multi-LLM por papel" }
533
+ ]
534
+ }
535
+ `,
536
+ };
537
+
538
+ /**
539
+ * Gera estrutura de prompts
540
+ */
541
+ const promptTemplates = {
542
+ 'prompts/project-prompt-base.md': `# Prompt Base do Projeto
543
+
544
+ Voce e um agente de engenharia sênior neste repositorio.
545
+
546
+ Prioridade de contexto:
547
+ 1. memory/00-global/mission.md
548
+ 2. memory/00-global/standards.md
549
+ 3. memory/00-global/context-policy.md
550
+ 4. memory/10-product/*
551
+ 5. memory/20-architecture/*
552
+ 6. memory/30-domains/<dominio>/*
553
+ 7. memory/40-delivery/current-sprint.md
554
+ 8. memory/90-decisions/ADR-*.md
555
+ 9. memory/70-summaries/*
556
+
557
+ Regras:
558
+ - comunicacao em pt-BR
559
+ - API em NestJS por padrao
560
+ - nao contradizer ADR sem sinalizar
561
+ - explicitar suposicoes
562
+ - **OBRIGATÓRIO**: Usar a skill \`reasoning\` e preencher o bloco \`## Raciocínio Estruturado\` antes de cada resposta técnica.
563
+ - entregar: raciocínio, entendimento, plano, implementacao, validacao e proximos passos
564
+ `,
565
+
566
+ 'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
567
+
568
+ Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
569
+
570
+ Para cada subtarefa, entregue:
571
+ - objetivo
572
+ - escopo de escrita
573
+ - criterio de pronto
574
+ - risco principal
575
+ - agente dono
576
+
577
+ No final, consolide os handoffs em ordem cronologica.
578
+ `,
579
+
580
+ 'prompts/worker-task-template.md': `# Prompt Worker
581
+
582
+ Voce recebeu uma subtarefa.
583
+
584
+ Responda com:
585
+ 1. **Raciocínio Estruturado** (Uso obrigatório da skill \`reasoning\`)
586
+ 2. Entendimento
587
+ 3. Implementacao realizada
588
+ 4. Arquivos alterados
589
+ 5. Validacao/testes
590
+ 6. Riscos e pendencias
591
+ `,
592
+ };
593
+
594
+ /**
595
+ * Gera arquivos de configuração globais
596
+ */
597
+ const configTemplates = {
598
+ 'AGENTS.md': `# AGENTS
599
+
600
+ ## Linguagem
601
+ - Sempre responder e documentar em **pt-BR**.
602
+
603
+ ## Stack
604
+ - API padrao do projeto: **NestJS**.
605
+
606
+ ## Modo multiagente
607
+ - Orquestrador decompõe tarefas
608
+ - Workers executam em paralelo por ownership
609
+ - Reviewer valida riscos
610
+
611
+ ## Memoria
612
+ - Seguir hierarchy em /memory
613
+ - Registrar handoff e resumo ao fim de cada entrega relevante
614
+ `,
615
+
616
+ '.memoryrc.json': `{
617
+ "strategy": "hierarchical",
618
+ "maxContextHint": "1M+ por segmentacao e resumo incremental",
619
+ "handoffDir": "memory/50-orchestration/handoffs",
620
+ "summaryDir": "memory/70-summaries",
621
+ "sqlitePath": ".memory/sqlite/context.db",
622
+ "language": "pt-BR",
623
+ "backendDefault": "nestjs"
624
+ }
625
+ `,
626
+
627
+ '.gitignore': `node_modules
628
+ dist
629
+ .env
630
+ .DS_Store
631
+ coverage
632
+ .context
633
+ `,
634
+ };
635
+
636
+ /**
637
+ * Gera scripts utilitários
638
+ */
639
+ const scriptTemplates = {
640
+ 'scripts/build-context-pack.mjs': `import fs from 'node:fs';
641
+ import path from 'node:path';
642
+ import { fileURLToPath } from 'node:url';
643
+
644
+ const __filename = fileURLToPath(import.meta.url);
645
+ const __dirname = path.dirname(__filename);
646
+ const root = path.resolve(__dirname, '..');
647
+ const outputDir = path.join(root, '.context');
648
+ const outFile = path.join(outputDir, 'context-pack.md');
649
+
650
+ const priorityFiles = [
651
+ 'memory/00-global/mission.md',
652
+ 'memory/00-global/standards.md',
653
+ 'memory/00-global/context-policy.md',
654
+ 'memory/20-architecture/backend.md',
655
+ 'memory/40-delivery/current-sprint.md',
656
+ 'memory/70-summaries/global-summary.md'
657
+ ];
658
+
659
+ fs.mkdirSync(outputDir, { recursive: true });
660
+ let content = '# Context Pack\\n\\n';
661
+
662
+ for (const rel of priorityFiles) {
663
+ const abs = path.join(root, rel);
664
+ if (!fs.existsSync(abs)) continue;
665
+ const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
666
+ content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
667
+ }
668
+
669
+ fs.writeFileSync(outFile, content, 'utf8');
670
+ console.log('Context pack gerado em: ' + outFile);
671
+ `,
672
+
673
+ 'scripts/append-handoff.mjs': `import fs from 'node:fs';
674
+ import path from 'node:path';
675
+ import { fileURLToPath } from 'node:url';
676
+
677
+ const __filename = fileURLToPath(import.meta.url);
678
+ const __dirname = path.dirname(__filename);
679
+ const root = path.resolve(__dirname, '..');
680
+
681
+ const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
682
+ const dir = path.join(root, 'memory/50-orchestration/handoffs');
683
+ fs.mkdirSync(dir, { recursive: true });
684
+
685
+ const stamp = new Date().toISOString().replace(/[:]/g, '-');
686
+ const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
687
+
688
+ const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
689
+ + '## Titulo\\n' + title + '\\n\\n'
690
+ + '## Contexto\\n-\\n\\n'
691
+ + '## Alteracoes\\n-\\n\\n'
692
+ + '## Riscos\\n-\\n\\n'
693
+ + '## Pendencias\\n-\\n\\n'
694
+ + '## Proximo passo\\n-\\n';
695
+
696
+ fs.writeFileSync(file, template, 'utf8');
697
+ console.log('Handoff criado: ' + file);
698
+ `,
699
+
700
+ 'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
701
+ import path from 'node:path';
702
+ import { fileURLToPath } from 'node:url';
703
+
704
+ const __filename = fileURLToPath(import.meta.url);
705
+ const __dirname = path.dirname(__filename);
706
+ const root = path.resolve(__dirname, '..', '..');
707
+
708
+ export function loadSkills() {
709
+ const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
710
+ if (!fs.existsSync(manifestPath)) return [];
711
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
712
+ return manifest.skills;
713
+ }
714
+
715
+ export function getSkill(id) {
716
+ const skills = loadSkills();
717
+ return skills.find(s => s.id === id);
718
+ }
719
+ `,
720
+
721
+ 'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
722
+ import path from 'node:path';
723
+ import { fileURLToPath } from 'node:url';
724
+
725
+ const __filename = fileURLToPath(import.meta.url);
726
+ const __dirname = path.dirname(__filename);
727
+ const root = path.resolve(__dirname, '..');
728
+ const runsDir = path.join(root, 'memory/60-runs');
729
+ const archiveDir = path.join(runsDir, 'archive');
730
+
731
+ const TTL_DAYS = 30;
732
+ const now = Date.now();
733
+
734
+ if (!fs.existsSync(runsDir)) process.exit(0);
735
+ if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
736
+
737
+ const entries = fs.readdirSync(runsDir, { withFileTypes: true });
738
+
739
+ let archived = 0;
740
+ for (const entry of entries) {
741
+ if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
742
+
743
+ const abs = path.join(runsDir, entry.name);
744
+ const stats = fs.statSync(abs);
745
+ const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
746
+
747
+ if (ageDays > TTL_DAYS) {
748
+ const dest = path.join(archiveDir, entry.name);
749
+ fs.renameSync(abs, dest);
750
+ archived++;
751
+ }
752
+ }
753
+
754
+ if (archived > 0) {
755
+ console.log('Vacuum: ' + archived + ' runs movidas para archive/');
756
+ }
757
+ `,
758
+
759
+ 'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
760
+ import { exec } from 'node:child_process';
761
+ import path from 'node:path';
762
+ import { fileURLToPath } from 'node:url';
763
+
764
+ const __filename = fileURLToPath(import.meta.url);
765
+ const __dirname = path.dirname(__filename);
766
+ const root = path.resolve(__dirname, '..');
767
+
768
+ const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
769
+ let timeout = null;
770
+
771
+ console.log('👀 Memory Watcher iniciado...');
772
+
773
+ watchDirs.forEach(dir => {
774
+ const absDir = path.join(root, dir);
775
+ watch(absDir, { recursive: true }, (eventType, filename) => {
776
+ if (filename && filename.endsWith('.md')) {
777
+ if (timeout) clearTimeout(timeout);
778
+ timeout = setTimeout(() => {
779
+ console.log('🔄 Mudança detectada em: ' + filename + '. Sincronizando SQLite...');
780
+ exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
781
+ if (err) console.error('❌ Erro no sync: ' + err.message);
782
+ else console.log('✅ SQLite sincronizado.');
783
+ });
784
+ }, 1000);
785
+ }
786
+ });
787
+ });
788
+ `,
789
+ };
790
+
791
+ /**
792
+ * Retorna todos os templates combinados
793
+ */
794
+ export function getAllMemoryTemplates() {
795
+ return {
796
+ ...memoryTemplates,
797
+ ...agentTemplates,
798
+ ...skillTemplates,
799
+ ...promptTemplates,
800
+ ...configTemplates,
801
+ ...scriptTemplates,
802
+ };
803
+ }
804
+
805
+ /**
806
+ * Escreve a estrutura completa de memória
807
+ * @param {string} baseDir - Diretório base para geração
808
+ * @param {Object} options - Opções (force, noGitkeep)
809
+ */
810
+ export function generateMemoryStructure(baseDir, options = {}) {
811
+ const allTemplates = getAllMemoryTemplates();
812
+
813
+ // Escrever todos os arquivos
814
+ for (const [relativePath, content] of Object.entries(allTemplates)) {
815
+ writeFileSafe(path.join(baseDir, relativePath), content, options);
816
+ }
817
+
818
+ // Criar diretórios vazios
819
+ const emptyDirs = [
820
+ 'memory/30-domains/shared',
821
+ 'memory/90-decisions/archive',
822
+ 'docs',
823
+ 'scripts/lib',
824
+ '.memory/sqlite',
825
+ '.context',
826
+ ];
827
+
828
+ for (const relDir of emptyDirs) {
829
+ const abs = path.join(baseDir, relDir);
830
+ ensureDir(abs);
831
+ maybeGitkeep(abs, options);
832
+ }
833
+
834
+ return {
835
+ success: true,
836
+ filesWritten: Object.keys(allTemplates).length,
837
+ emptyDirsCreated: emptyDirs.length,
838
+ };
839
+ }
840
+
841
+ export default {
842
+ generateMemoryStructure,
843
+ getAllMemoryTemplates,
844
+ };