forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,457 +1,457 @@
1
- # 🚀 Init Project - Guia de Uso
2
-
3
- Comando universal para iniciar novo projeto com agentes orquestrados e configuração automática de IAs.
4
-
5
- > **Atenção**: projetos de produto vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora do repo do framework. Veja ADR-0019.
6
-
7
- ---
8
-
9
- ## Quick Start (2 minutos)
10
-
11
- ```bash
12
- # 1. Ir para repo root do framework Forja
13
- cd /home/apk/Documentos/GitHub/Projetos/2-Projeto-Agents/projects/forja
14
-
15
- # 2. Inicializar o workspace (canto fixo dos projetos)
16
- npm run workspace:init
17
-
18
- # 3. Criar novo projeto (setup automático completo)
19
- npm run project:new meu-projeto
20
-
21
- # 4. Entrar no projeto
22
- cd ~/forja-workspace/projects/meu-projeto
23
-
24
- # 5. Ver estrutura
25
- ls -la
26
- tree memory/ | head -30
27
-
28
- # 6. Carregar instruções para sua IA favorita
29
- cat .ia-instructions/copilot.md
30
- cat .ia-instructions/claude.md
31
- cat .ia-instructions/gemini.md
32
- ```
33
-
34
- **Resultado**: Projeto totalmente setup com:
35
- - ✅ Estrutura de memória hierárquica
36
- - ✅ Backend NestJS pronto
37
- - ✅ Instruções para 3 IAs (Copilot, Claude, Gemini)
38
- - ✅ SQLite inicializado
39
- - ✅ Context pack construído
40
- - ✅ Git configurado
41
-
42
- ---
43
-
44
- ## Sintaxe Completa
45
-
46
- ```bash
47
- # Via harness (recomendado — resolve workspace automaticamente)
48
- npm run project:new <project-name> [opções]
49
-
50
- # Via binário direto (ainda válido, mas sempre cria no workspace)
51
- node bin/init-project.js <project-name> [opções]
52
- ```
53
-
54
- ### Opções
55
-
56
- | Flag | Padrão | O quê |
57
- |------|--------|-------|
58
- | `--ai <list>` | copilot,claude,gemini,codex | IAs para configurar (comma-separated) |
59
- | `--skip-backend` | false | Pula geração do backend NestJS |
60
- | `--skip-db` | false | Pula inicialização do SQLite |
61
- | `--skip-git` | false | Pula inicialização do Git |
62
- | `--skip-design` | false | Pula cópia da biblioteca design-md |
63
- | `--interactive` | false | Modo interativo (perguntas) |
64
- | `--verbose` | false | Output detalhado |
65
-
66
- ### Workspace
67
-
68
- O caminho do workspace é resolvido por prioridade:
69
-
70
- 1. Variável de ambiente `FORJA_WORKSPACE`
71
- 2. Campo `workspaceRoot` em `~/.forjarc.json`
72
- 3. Padrão: `~/forja-workspace`
73
-
74
- ---
75
-
76
- ## Exemplos de Uso
77
-
78
- ### 1. Setup Completo (Recomendado)
79
- ```bash
80
- npm run project:new meu-projeto
81
- ```
82
- Resultado:
83
- - Projeto em `~/forja-workspace/projects/meu-projeto/`
84
- - Estrutura memória + backend NestJS
85
- - IAs: Copilot, Claude, Gemini, Codex
86
- - Git inicializado
87
- - DB setup
88
-
89
- ### 2. Só com Copilot e Claude
90
- ```bash
91
- npm run project:new meu-projeto -- --ai copilot,claude
92
- ```
93
- Resultado:
94
- - Instruções apenas para Copilot e Claude
95
- - Resto completo
96
-
97
- ### 3. Só Memória (Sem Backend)
98
- ```bash
99
- npm run project:new meu-projeto -- --skip-backend
100
- ```
101
- Resultado:
102
- - Estrutura memória + agentes + skills
103
- - SEM backend NestJS
104
- - SEM npm install
105
- - Útil para projetos frontend-only
106
-
107
- ### 4. Backend sem DB
108
- ```bash
109
- npm run project:new meu-projeto -- --skip-db
110
- ```
111
- Resultado:
112
- - Projeto completo
113
- - SQLite NÃO inicializado
114
- - Útil se quer setupar BD depois
115
-
116
- ### 5. Setup Verbose (Debug)
117
- ```bash
118
- npm run project:new meu-projeto -- --verbose
119
- ```
120
- Resultado:
121
- - Mostra todos os comandos executados
122
- - Útil para troubleshooting
123
-
124
- ### 6. Modo Interativo (Perguntas)
125
- ```bash
126
- npm run project:new -- --interactive
127
- ```
128
- Resultado:
129
- - Pergunta nome do projeto
130
- - Pergunta quais IAs configurar
131
- - Pergunta se quer backend
132
- - Etc
133
-
134
- ---
135
-
136
- ## O que o Comando Faz (Step-by-Step)
137
-
138
- ### 1️⃣ Git Init
139
- - Cria `.git` se não existir
140
- - Cria `.gitignore` básico
141
-
142
- ### 2️⃣ Generate Structure
143
- - Roda `bin/create-memory-nest-kit.js`
144
- - Cria `memory/`, `agents/`, `skills/`, `prompts/`
145
- - Cria `backend/` (se não --skip-backend)
146
- - Cria scripts úteis
147
-
148
- ### 3️⃣ Copy Instructions
149
- - Copia `.github/copilot-instructions.md`
150
- - Copia `CLAUDE.md`
151
- - Copia `.gemini-instructions.md`
152
- - Coloca em `.ia-instructions/README.md`
153
-
154
- ### 4️⃣ Install Backend
155
- - Roda `npm install` no backend
156
- - Instala: NestJS, Jest, Prettier, ESLint, etc
157
- - Toma alguns minutos na primeira vez
158
-
159
- ### 5️⃣ Init Memory DB
160
- - Roda `npm run memory:db:init`
161
- - Cria `.memory/sqlite/context.db`
162
- - Setup schema SQLite
163
-
164
- ### 6️⃣ Build Context Pack
165
- - Roda `node scripts/build-context-pack.mjs`
166
- - Cria `.context/context-pack.md`
167
- - Resumo compacto para IA ler
168
-
169
- ### 7️⃣ Show Next Steps
170
- - Exibe checklist de próximos passos
171
- - Mostra comandos importantes
172
-
173
- ---
174
-
175
- ## Estrutura Criada
176
-
177
- Após `npm run project:new meu-projeto`, o projeto é criado em `~/forja-workspace/projects/meu-projeto/`:
178
-
179
- ```
180
- ~/forja-workspace/projects/meu-projeto/
181
- ├─ .git/ # Git repository
182
- ├─ .gitignore
183
- ├─ .ia-instructions/ # Instruções por IA
184
- │ ├─ README.md
185
- │ ├─ copilot.md
186
- │ ├─ claude.md
187
- │ └─ gemini.md
188
- ├─ .context/
189
- │ └─ context-pack.md # Resumo compacto
190
- ├─ .memory/
191
- │ └─ sqlite/
192
- │ └─ context.db # SQLite DB
193
- ├─ memory/ # Estrutura hierárquica
194
- │ ├─ 00-global/
195
- │ ├─ 10-product/
196
- │ ├─ 20-architecture/
197
- │ ├─ 30-domains/
198
- │ ├─ 40-delivery/
199
- │ ├─ 50-orchestration/
200
- │ ├─ 60-runs/
201
- │ ├─ 70-summaries/
202
- │ ├─ 80-data/
203
- │ └─ 90-decisions/
204
- ├─ agents/ # Especificação de agentes
205
- │ ├─ orchestrator.md
206
- │ ├─ backend-nest.md
207
- │ ├─ frontend.md
208
- │ ├─ dba.md
209
- │ ├─ security.md
210
- │ ├─ reviewer.md
211
- │ └─ README.md
212
- ├─ skills/ # Skills operacionais
213
- │ ├─ triage-task/
214
- │ ├─ context-compaction/
215
- │ ├─ handoff/
216
- │ └─ nest-api/
217
- ├─ prompts/ # Templates de prompts
218
- │ ├─ project-prompt-base.md
219
- │ ├─ multi-agent-orchestrator.md
220
- │ └─ worker-task-template.md
221
- ├─ scripts/
222
- │ ├─ build-context-pack.mjs # Compactar contexto
223
- │ └─ append-handoff.mjs # Criar handoff
224
- ├─ docs/ # Documentação adicional
225
- ├─ backend/ # NestJS (se não --skip-backend)
226
- │ ├─ src/
227
- │ ├─ test/
228
- │ ├─ scripts/
229
- │ │ ├─ memory-db-init.mjs
230
- │ │ ├─ memory-db-sync.mjs
231
- │ │ ├─ memory-db-query.mjs
232
- │ │ └─ memory-db-schema.sql
233
- │ ├─ package.json
234
- │ ├─ tsconfig.json
235
- │ └─ nest-cli.json
236
- ├─ README.md
237
- └─ AGENTS.md
238
- ```
239
-
240
- ---
241
-
242
- ## Workflow Após Init
243
-
244
- ### Copilot / Claude / Gemini Setup
245
-
246
- ```bash
247
- # 1. Ver instruções
248
- cat ~/forja-workspace/projects/meu-projeto/.ia-instructions/copilot.md
249
-
250
- # 2. Copiar para IA assistant
251
- # - Abra seu editor com Copilot/Claude
252
- # - New chat
253
- # - Paste conteúdo do arquivo
254
- # - Pronto! IA entende seu projeto
255
-
256
- # 3. Pedir para IA:
257
- # "Implemente endpoint GET /users/:id com validação de UUID"
258
- # "Crie teste para criar novo usuário"
259
- # etc
260
- ```
261
-
262
- ### Desenvolvimento Local
263
-
264
- ```bash
265
- cd ~/forja-workspace/projects/meu-projeto
266
-
267
- # Ver estrutura de memória
268
- tree memory/ -L 2
269
-
270
- # Carregar contexto para IA
271
- cat .context/context-pack.md | head -100
272
-
273
- # Iniciar backend em dev
274
- cd backend && npm run start:dev
275
-
276
- # Rodar testes
277
- cd backend && npm test
278
-
279
- # Sincronizar BD (após mudanças grandes)
280
- cd backend && npm run memory:db:sync
281
-
282
- # Consultar contexto
283
- cd backend && npm run memory:db:query -- "search" "auth" 10
284
- ```
285
-
286
- ### Registrar Handoff (Quando Passar para Outro Agente)
287
-
288
- ```bash
289
- cd meu-projeto
290
-
291
- # Criar handoff estruturado
292
- node scripts/append-handoff.mjs orchestrator backend-nest "Implementar módulo de autenticação com JWT"
293
-
294
- # Resultado: novo arquivo em memory/50-orchestration/handoffs/
295
- ```
296
-
297
- ### Atualizar Documentação
298
-
299
- ```bash
300
- # Após mudanças importantes
301
- vim memory/20-architecture/backend.md
302
- vim memory/30-domains/auth/rules.md
303
-
304
- # Sincronizar DB
305
- cd backend && npm run memory:db:sync
306
- ```
307
-
308
- ---
309
-
310
- ## Troubleshooting
311
-
312
- ### "Node not found"
313
- ```bash
314
- # Instalar Node.js >= 18
315
- curl -fsSL https://fnm.io/install | bash
316
- fnm install 18
317
- fnm use 18
318
- node --version
319
- ```
320
-
321
- ### "npm install falha"
322
- ```bash
323
- # Limpar cache
324
- npm cache clean --force
325
-
326
- # Atualizar npm
327
- npm install -g npm@latest
328
-
329
- # Tentar novamente
330
- node bin/init-project.js meu-projeto --verbose
331
- ```
332
-
333
- ### "Git conflicts"
334
- ```bash
335
- # Se projeto já existe com Git
336
- node bin/init-project.js meu-projeto --force --skip-git
337
- ```
338
-
339
- ### "BD não inicializa"
340
- ```bash
341
- # Manual
342
- cd meu-projeto/backend
343
- npm run memory:db:init
344
- npm run memory:db:sync
345
- ```
346
-
347
- ### "Backend não compila"
348
- ```bash
349
- # Debug detalhado
350
- cd meu-projeto/backend
351
- npm run build -- --verbose
352
- npm run lint
353
- npm test
354
- ```
355
-
356
- ---
357
-
358
- ## Integração com CI/CD
359
-
360
- ### GitHub Actions
361
-
362
- ```yaml
363
- # .github/workflows/init-new-project.yml
364
- name: Create New Project
365
- on:
366
- workflow_dispatch:
367
- inputs:
368
- project_name:
369
- description: "Nome do projeto"
370
- required: true
371
-
372
- jobs:
373
- init:
374
- runs-on: ubuntu-latest
375
- steps:
376
- - uses: actions/checkout@v3
377
- - uses: actions/setup-node@v3
378
- with:
379
- node-version: "18"
380
-
381
- - name: Init project
382
- run: |
383
- node bin/init-project.js ${{ github.event.inputs.project_name }} \
384
- --ai copilot,claude,gemini
385
-
386
- - name: Commit and push
387
- run: |
388
- git config user.email "bot@example.com"
389
- git config user.name "Bot"
390
- git add .
391
- git commit -m "feat: init project ${{ github.event.inputs.project_name }}"
392
- git push
393
- ```
394
-
395
- ---
396
-
397
- ## Próximas Features Planejadas
398
-
399
- - [ ] --ai-config: arquivo YAML com config por IA
400
- - [ ] --template: escolher template (web, api, fullstack)
401
- - [ ] --preset: preset de IAs (solo, team, enterprise)
402
- - [ ] --github-org: criar repo automático
403
- - [ ] --docker: Dockerfile pronto
404
- - [ ] --k8s: deployment manifests
405
-
406
- ---
407
-
408
- ## Sumário de Comandos Frequentes
409
-
410
- ```bash
411
- # Inicializar workspace (uma vez)
412
- npm run workspace:init
413
-
414
- # Criar novo projeto (tudo automático)
415
- npm run project:new meu-projeto
416
-
417
- # Variantes
418
- npm run project:new meu-projeto -- --skip-backend
419
- npm run project:new meu-projeto -- --ai claude,copilot
420
- npm run project:new meu-projeto -- --verbose
421
-
422
- # Dentro do projeto
423
- cd ~/forja-workspace/projects/meu-projeto
424
-
425
- # Ver instruções para IA
426
- cat .ia-instructions/copilot.md
427
-
428
- # Ver contexto resumido
429
- cat .context/context-pack.md | head -50
430
-
431
- # Rodar backend
432
- cd backend && npm run start:dev
433
-
434
- # Sincronizar memória
435
- cd backend && npm run memory:db:sync
436
-
437
- # Criar handoff
438
- node scripts/append-handoff.mjs orchestrator backend-nest "tarefa"
439
-
440
- # Query contexto
441
- cd backend && npm run memory:db:query -- "search" "auth" 10
442
- ```
443
-
444
- ---
445
-
446
- ## Help Rápido
447
-
448
- ```bash
449
- node bin/init-project.js --help
450
- ```
451
-
452
- ---
453
-
454
- **Criado**: 2026-04-21
455
- **Status**: 🟢 Pronto para Uso
456
- **Próximo**: Implementar em `bin/init-project.js` (já feito!)
457
-
1
+ # 🚀 Init Project - Guia de Uso
2
+
3
+ Comando universal para iniciar novo projeto com agentes orquestrados e configuração automática de IAs.
4
+
5
+ > **Atenção**: projetos de produto vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora do repo do framework. Veja ADR-0019.
6
+
7
+ ---
8
+
9
+ ## Quick Start (2 minutos)
10
+
11
+ ```bash
12
+ # 1. Ir para repo root do framework Forja
13
+ cd /home/apk/Documentos/GitHub/Projetos/2-Projeto-Agents/projects/forja
14
+
15
+ # 2. Inicializar o workspace (canto fixo dos projetos)
16
+ npm run workspace:init
17
+
18
+ # 3. Criar novo projeto (setup automático completo)
19
+ npm run project:new meu-projeto
20
+
21
+ # 4. Entrar no projeto
22
+ cd ~/forja-workspace/projects/meu-projeto
23
+
24
+ # 5. Ver estrutura
25
+ ls -la
26
+ tree memory/ | head -30
27
+
28
+ # 6. Carregar instruções para sua IA favorita
29
+ cat .ia-instructions/copilot.md
30
+ cat .ia-instructions/claude.md
31
+ cat .ia-instructions/gemini.md
32
+ ```
33
+
34
+ **Resultado**: Projeto totalmente setup com:
35
+ - ✅ Estrutura de memória hierárquica
36
+ - ✅ Backend NestJS pronto
37
+ - ✅ Instruções para 3 IAs (Copilot, Claude, Gemini)
38
+ - ✅ SQLite inicializado
39
+ - ✅ Context pack construído
40
+ - ✅ Git configurado
41
+
42
+ ---
43
+
44
+ ## Sintaxe Completa
45
+
46
+ ```bash
47
+ # Via harness (recomendado — resolve workspace automaticamente)
48
+ npm run project:new <project-name> [opções]
49
+
50
+ # Via binário direto (ainda válido, mas sempre cria no workspace)
51
+ node bin/init-project.js <project-name> [opções]
52
+ ```
53
+
54
+ ### Opções
55
+
56
+ | Flag | Padrão | O quê |
57
+ |------|--------|-------|
58
+ | `--ai <list>` | copilot,claude,gemini,codex | IAs para configurar (comma-separated) |
59
+ | `--skip-backend` | false | Pula geração do backend NestJS |
60
+ | `--skip-db` | false | Pula inicialização do SQLite |
61
+ | `--skip-git` | false | Pula inicialização do Git |
62
+ | `--skip-design` | false | Pula cópia da biblioteca design-md |
63
+ | `--interactive` | false | Modo interativo (perguntas) |
64
+ | `--verbose` | false | Output detalhado |
65
+
66
+ ### Workspace
67
+
68
+ O caminho do workspace é resolvido por prioridade:
69
+
70
+ 1. Variável de ambiente `FORJA_WORKSPACE`
71
+ 2. Campo `workspaceRoot` em `~/.forjarc.json`
72
+ 3. Padrão: `~/forja-workspace`
73
+
74
+ ---
75
+
76
+ ## Exemplos de Uso
77
+
78
+ ### 1. Setup Completo (Recomendado)
79
+ ```bash
80
+ npm run project:new meu-projeto
81
+ ```
82
+ Resultado:
83
+ - Projeto em `~/forja-workspace/projects/meu-projeto/`
84
+ - Estrutura memória + backend NestJS
85
+ - IAs: Copilot, Claude, Gemini, Codex
86
+ - Git inicializado
87
+ - DB setup
88
+
89
+ ### 2. Só com Copilot e Claude
90
+ ```bash
91
+ npm run project:new meu-projeto -- --ai copilot,claude
92
+ ```
93
+ Resultado:
94
+ - Instruções apenas para Copilot e Claude
95
+ - Resto completo
96
+
97
+ ### 3. Só Memória (Sem Backend)
98
+ ```bash
99
+ npm run project:new meu-projeto -- --skip-backend
100
+ ```
101
+ Resultado:
102
+ - Estrutura memória + agentes + skills
103
+ - SEM backend NestJS
104
+ - SEM npm install
105
+ - Útil para projetos frontend-only
106
+
107
+ ### 4. Backend sem DB
108
+ ```bash
109
+ npm run project:new meu-projeto -- --skip-db
110
+ ```
111
+ Resultado:
112
+ - Projeto completo
113
+ - SQLite NÃO inicializado
114
+ - Útil se quer setupar BD depois
115
+
116
+ ### 5. Setup Verbose (Debug)
117
+ ```bash
118
+ npm run project:new meu-projeto -- --verbose
119
+ ```
120
+ Resultado:
121
+ - Mostra todos os comandos executados
122
+ - Útil para troubleshooting
123
+
124
+ ### 6. Modo Interativo (Perguntas)
125
+ ```bash
126
+ npm run project:new -- --interactive
127
+ ```
128
+ Resultado:
129
+ - Pergunta nome do projeto
130
+ - Pergunta quais IAs configurar
131
+ - Pergunta se quer backend
132
+ - Etc
133
+
134
+ ---
135
+
136
+ ## O que o Comando Faz (Step-by-Step)
137
+
138
+ ### 1️⃣ Git Init
139
+ - Cria `.git` se não existir
140
+ - Cria `.gitignore` básico
141
+
142
+ ### 2️⃣ Generate Structure
143
+ - Roda `bin/create-memory-nest-kit.js`
144
+ - Cria `memory/`, `agents/`, `skills/`, `prompts/`
145
+ - Cria `backend/` (se não --skip-backend)
146
+ - Cria scripts úteis
147
+
148
+ ### 3️⃣ Copy Instructions
149
+ - Copia `.github/copilot-instructions.md`
150
+ - Copia `CLAUDE.md`
151
+ - Copia `.gemini-instructions.md`
152
+ - Coloca em `.ia-instructions/README.md`
153
+
154
+ ### 4️⃣ Install Backend
155
+ - Roda `npm install` no backend
156
+ - Instala: NestJS, Jest, Prettier, ESLint, etc
157
+ - Toma alguns minutos na primeira vez
158
+
159
+ ### 5️⃣ Init Memory DB
160
+ - Roda `npm run memory:db:init`
161
+ - Cria `.memory/sqlite/context.db`
162
+ - Setup schema SQLite
163
+
164
+ ### 6️⃣ Build Context Pack
165
+ - Roda `node scripts/build-context-pack.mjs`
166
+ - Cria `.context/context-pack.md`
167
+ - Resumo compacto para IA ler
168
+
169
+ ### 7️⃣ Show Next Steps
170
+ - Exibe checklist de próximos passos
171
+ - Mostra comandos importantes
172
+
173
+ ---
174
+
175
+ ## Estrutura Criada
176
+
177
+ Após `npm run project:new meu-projeto`, o projeto é criado em `~/forja-workspace/projects/meu-projeto/`:
178
+
179
+ ```
180
+ ~/forja-workspace/projects/meu-projeto/
181
+ ├─ .git/ # Git repository
182
+ ├─ .gitignore
183
+ ├─ .ia-instructions/ # Instruções por IA
184
+ │ ├─ README.md
185
+ │ ├─ copilot.md
186
+ │ ├─ claude.md
187
+ │ └─ gemini.md
188
+ ├─ .context/
189
+ │ └─ context-pack.md # Resumo compacto
190
+ ├─ .memory/
191
+ │ └─ sqlite/
192
+ │ └─ context.db # SQLite DB
193
+ ├─ memory/ # Estrutura hierárquica
194
+ │ ├─ 00-global/
195
+ │ ├─ 10-product/
196
+ │ ├─ 20-architecture/
197
+ │ ├─ 30-domains/
198
+ │ ├─ 40-delivery/
199
+ │ ├─ 50-orchestration/
200
+ │ ├─ 60-runs/
201
+ │ ├─ 70-summaries/
202
+ │ ├─ 80-data/
203
+ │ └─ 90-decisions/
204
+ ├─ agents/ # Especificação de agentes
205
+ │ ├─ orchestrator.md
206
+ │ ├─ backend-nest.md
207
+ │ ├─ frontend.md
208
+ │ ├─ dba.md
209
+ │ ├─ security.md
210
+ │ ├─ reviewer.md
211
+ │ └─ README.md
212
+ ├─ skills/ # Skills operacionais
213
+ │ ├─ triage-task/
214
+ │ ├─ context-compaction/
215
+ │ ├─ handoff/
216
+ │ └─ nest-api/
217
+ ├─ prompts/ # Templates de prompts
218
+ │ ├─ project-prompt-base.md
219
+ │ ├─ multi-agent-orchestrator.md
220
+ │ └─ worker-task-template.md
221
+ ├─ scripts/
222
+ │ ├─ build-context-pack.mjs # Compactar contexto
223
+ │ └─ append-handoff.mjs # Criar handoff
224
+ ├─ docs/ # Documentação adicional
225
+ ├─ backend/ # NestJS (se não --skip-backend)
226
+ │ ├─ src/
227
+ │ ├─ test/
228
+ │ ├─ scripts/
229
+ │ │ ├─ memory-db-init.mjs
230
+ │ │ ├─ memory-db-sync.mjs
231
+ │ │ ├─ memory-db-query.mjs
232
+ │ │ └─ memory-db-schema.sql
233
+ │ ├─ package.json
234
+ │ ├─ tsconfig.json
235
+ │ └─ nest-cli.json
236
+ ├─ README.md
237
+ └─ AGENTS.md
238
+ ```
239
+
240
+ ---
241
+
242
+ ## Workflow Após Init
243
+
244
+ ### Copilot / Claude / Gemini Setup
245
+
246
+ ```bash
247
+ # 1. Ver instruções
248
+ cat ~/forja-workspace/projects/meu-projeto/.ia-instructions/copilot.md
249
+
250
+ # 2. Copiar para IA assistant
251
+ # - Abra seu editor com Copilot/Claude
252
+ # - New chat
253
+ # - Paste conteúdo do arquivo
254
+ # - Pronto! IA entende seu projeto
255
+
256
+ # 3. Pedir para IA:
257
+ # "Implemente endpoint GET /users/:id com validação de UUID"
258
+ # "Crie teste para criar novo usuário"
259
+ # etc
260
+ ```
261
+
262
+ ### Desenvolvimento Local
263
+
264
+ ```bash
265
+ cd ~/forja-workspace/projects/meu-projeto
266
+
267
+ # Ver estrutura de memória
268
+ tree memory/ -L 2
269
+
270
+ # Carregar contexto para IA
271
+ cat .context/context-pack.md | head -100
272
+
273
+ # Iniciar backend em dev
274
+ cd backend && npm run start:dev
275
+
276
+ # Rodar testes
277
+ cd backend && npm test
278
+
279
+ # Sincronizar BD (após mudanças grandes)
280
+ cd backend && npm run memory:db:sync
281
+
282
+ # Consultar contexto
283
+ cd backend && npm run memory:db:query -- "search" "auth" 10
284
+ ```
285
+
286
+ ### Registrar Handoff (Quando Passar para Outro Agente)
287
+
288
+ ```bash
289
+ cd meu-projeto
290
+
291
+ # Criar handoff estruturado
292
+ node scripts/append-handoff.mjs orchestrator backend-nest "Implementar módulo de autenticação com JWT"
293
+
294
+ # Resultado: novo arquivo em memory/50-orchestration/handoffs/
295
+ ```
296
+
297
+ ### Atualizar Documentação
298
+
299
+ ```bash
300
+ # Após mudanças importantes
301
+ vim memory/20-architecture/backend.md
302
+ vim memory/30-domains/auth/rules.md
303
+
304
+ # Sincronizar DB
305
+ cd backend && npm run memory:db:sync
306
+ ```
307
+
308
+ ---
309
+
310
+ ## Troubleshooting
311
+
312
+ ### "Node not found"
313
+ ```bash
314
+ # Instalar Node.js >= 18
315
+ curl -fsSL https://fnm.io/install | bash
316
+ fnm install 18
317
+ fnm use 18
318
+ node --version
319
+ ```
320
+
321
+ ### "npm install falha"
322
+ ```bash
323
+ # Limpar cache
324
+ npm cache clean --force
325
+
326
+ # Atualizar npm
327
+ npm install -g npm@latest
328
+
329
+ # Tentar novamente
330
+ node bin/init-project.js meu-projeto --verbose
331
+ ```
332
+
333
+ ### "Git conflicts"
334
+ ```bash
335
+ # Se projeto já existe com Git
336
+ node bin/init-project.js meu-projeto --force --skip-git
337
+ ```
338
+
339
+ ### "BD não inicializa"
340
+ ```bash
341
+ # Manual
342
+ cd meu-projeto/backend
343
+ npm run memory:db:init
344
+ npm run memory:db:sync
345
+ ```
346
+
347
+ ### "Backend não compila"
348
+ ```bash
349
+ # Debug detalhado
350
+ cd meu-projeto/backend
351
+ npm run build -- --verbose
352
+ npm run lint
353
+ npm test
354
+ ```
355
+
356
+ ---
357
+
358
+ ## Integração com CI/CD
359
+
360
+ ### GitHub Actions
361
+
362
+ ```yaml
363
+ # .github/workflows/init-new-project.yml
364
+ name: Create New Project
365
+ on:
366
+ workflow_dispatch:
367
+ inputs:
368
+ project_name:
369
+ description: "Nome do projeto"
370
+ required: true
371
+
372
+ jobs:
373
+ init:
374
+ runs-on: ubuntu-latest
375
+ steps:
376
+ - uses: actions/checkout@v3
377
+ - uses: actions/setup-node@v3
378
+ with:
379
+ node-version: "18"
380
+
381
+ - name: Init project
382
+ run: |
383
+ node bin/init-project.js ${{ github.event.inputs.project_name }} \
384
+ --ai copilot,claude,gemini
385
+
386
+ - name: Commit and push
387
+ run: |
388
+ git config user.email "bot@example.com"
389
+ git config user.name "Bot"
390
+ git add .
391
+ git commit -m "feat: init project ${{ github.event.inputs.project_name }}"
392
+ git push
393
+ ```
394
+
395
+ ---
396
+
397
+ ## Próximas Features Planejadas
398
+
399
+ - [ ] --ai-config: arquivo YAML com config por IA
400
+ - [ ] --template: escolher template (web, api, fullstack)
401
+ - [ ] --preset: preset de IAs (solo, team, enterprise)
402
+ - [ ] --github-org: criar repo automático
403
+ - [ ] --docker: Dockerfile pronto
404
+ - [ ] --k8s: deployment manifests
405
+
406
+ ---
407
+
408
+ ## Sumário de Comandos Frequentes
409
+
410
+ ```bash
411
+ # Inicializar workspace (uma vez)
412
+ npm run workspace:init
413
+
414
+ # Criar novo projeto (tudo automático)
415
+ npm run project:new meu-projeto
416
+
417
+ # Variantes
418
+ npm run project:new meu-projeto -- --skip-backend
419
+ npm run project:new meu-projeto -- --ai claude,copilot
420
+ npm run project:new meu-projeto -- --verbose
421
+
422
+ # Dentro do projeto
423
+ cd ~/forja-workspace/projects/meu-projeto
424
+
425
+ # Ver instruções para IA
426
+ cat .ia-instructions/copilot.md
427
+
428
+ # Ver contexto resumido
429
+ cat .context/context-pack.md | head -50
430
+
431
+ # Rodar backend
432
+ cd backend && npm run start:dev
433
+
434
+ # Sincronizar memória
435
+ cd backend && npm run memory:db:sync
436
+
437
+ # Criar handoff
438
+ node scripts/append-handoff.mjs orchestrator backend-nest "tarefa"
439
+
440
+ # Query contexto
441
+ cd backend && npm run memory:db:query -- "search" "auth" 10
442
+ ```
443
+
444
+ ---
445
+
446
+ ## Help Rápido
447
+
448
+ ```bash
449
+ node bin/init-project.js --help
450
+ ```
451
+
452
+ ---
453
+
454
+ **Criado**: 2026-04-21
455
+ **Status**: 🟢 Pronto para Uso
456
+ **Próximo**: Implementar em `bin/init-project.js` (já feito!)
457
+