forjajs 2.0.4 → 3.0.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 (798) 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 +50 -50
  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 +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  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/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
@@ -10,346 +10,360 @@ import { writeFileSafe, ensureDir, maybeGitkeep } from "../utils/file-helpers.js
10
10
  */
11
11
  function createNestTemplates(projectName) {
12
12
  return {
13
- 'backend/package.json': `{
14
- "name": "${projectName}-api",
15
- "version": "0.1.0",
16
- "private": true,
17
- "scripts": {
18
- "build": "nest build",
19
- "start": "nest start",
20
- "start:dev": "nest start --watch",
21
- "start:prod": "node dist/main",
22
- "lint": "eslint \\"src/**/*.ts\\" --max-warnings=0",
23
- "format": "prettier --write \\"src/**/*.ts\\" \\"test/**/*.ts\\"",
24
- "test": "jest",
25
- "test:watch": "jest --watch",
26
- "test:cov": "jest --coverage",
27
- "memory:db:init": "node scripts/memory-db-init.mjs",
28
- "memory:db:sync": "node scripts/memory-db-sync.mjs",
29
- "memory:db:query": "node scripts/memory-db-query.mjs",
30
- "memory:watch": "node ../scripts/memory-watcher.mjs"
31
- },
32
- "jest": {
33
- "moduleFileExtensions": ["js", "json", "ts"],
34
- "rootDir": "src",
35
- "testRegex": ".*\\\\.spec\\\\.ts$",
36
- "transform": {
37
- "^.+\\\\.(t|j)s$": "ts-jest"
38
- },
39
- "collectCoverageFrom": ["**/*.(t|j)s"],
40
- "coverageDirectory": "../coverage",
41
- "testEnvironment": "node"
42
- },
43
- "dependencies": {
44
- "@nestjs/common": "^11.0.0",
45
- "@nestjs/core": "^11.0.0",
46
- "@nestjs/platform-express": "^11.0.0",
47
- "better-sqlite3": "^12.11.1",
48
- "reflect-metadata": "^0.2.2",
49
- "rxjs": "^7.8.1"
50
- },
51
- "devDependencies": {
52
- "@nestjs/cli": "^11.0.0",
53
- "@nestjs/schematics": "^11.0.0",
54
- "@nestjs/testing": "^11.0.0",
55
- "@types/express": "^5.0.1",
56
- "@types/better-sqlite3": "^7.6.13",
57
- "@types/jest": "^29.5.14",
58
- "@types/node": "^22.10.2",
59
- "@types/supertest": "^6.0.2",
60
- "eslint": "^9.16.0",
61
- "eslint-config-prettier": "^9.1.0",
62
- "jest": "^29.7.0",
63
- "prettier": "^3.4.2",
64
- "supertest": "^7.0.0",
65
- "ts-jest": "^29.2.5",
66
- "ts-loader": "^9.5.1",
67
- "ts-node": "^10.9.2",
68
- "tsconfig-paths": "^4.2.0",
69
- "typescript": "^5.7.2"
70
- }
71
- }
13
+ 'backend/package.json': `{
14
+ "name": "${projectName}-api",
15
+ "version": "0.1.0",
16
+ "private": true,
17
+ "scripts": {
18
+ "build": "nest build",
19
+ "start": "nest start",
20
+ "start:dev": "nest start --watch",
21
+ "start:prod": "node dist/main",
22
+ "lint": "eslint \\"src/**/*.ts\\" --max-warnings=0",
23
+ "format": "prettier --write \\"src/**/*.ts\\" \\"test/**/*.ts\\"",
24
+ "test": "jest",
25
+ "test:watch": "jest --watch",
26
+ "test:cov": "jest --coverage",
27
+ "memory:db:init": "node scripts/memory-db-init.mjs",
28
+ "memory:db:sync": "node scripts/memory-db-sync.mjs",
29
+ "memory:db:query": "node scripts/memory-db-query.mjs",
30
+ "memory:watch": "node ../scripts/memory-watcher.mjs"
31
+ },
32
+ "jest": {
33
+ "moduleFileExtensions": ["js", "json", "ts"],
34
+ "rootDir": "src",
35
+ "testRegex": ".*\\\\.spec\\\\.ts$",
36
+ "transform": {
37
+ "^.+\\\\.(t|j)s$": "ts-jest"
38
+ },
39
+ "collectCoverageFrom": ["**/*.(t|j)s"],
40
+ "coverageDirectory": "../coverage",
41
+ "testEnvironment": "node"
42
+ },
43
+ "dependencies": {
44
+ "@nestjs/common": "^11.0.0",
45
+ "@nestjs/core": "^11.0.0",
46
+ "@nestjs/platform-express": "^11.0.0",
47
+ "better-sqlite3": "^12.11.1",
48
+ "reflect-metadata": "^0.2.2",
49
+ "rxjs": "^7.8.1"
50
+ },
51
+ "devDependencies": {
52
+ "@nestjs/cli": "^11.0.0",
53
+ "@nestjs/schematics": "^11.0.0",
54
+ "@nestjs/testing": "^11.0.0",
55
+ "@types/express": "^5.0.1",
56
+ "@types/better-sqlite3": "^7.6.13",
57
+ "@types/jest": "^29.5.14",
58
+ "@types/node": "^22.10.2",
59
+ "@types/supertest": "^6.0.2",
60
+ "eslint": "^9.16.0",
61
+ "eslint-config-prettier": "^9.1.0",
62
+ "jest": "^29.7.0",
63
+ "prettier": "^3.4.2",
64
+ "supertest": "^7.0.0",
65
+ "ts-jest": "^29.2.5",
66
+ "ts-loader": "^9.5.1",
67
+ "ts-node": "^10.9.2",
68
+ "tsconfig-paths": "^4.2.0",
69
+ "typescript": "^5.7.2"
70
+ }
71
+ }
72
72
  `,
73
- 'backend/nest-cli.json': `{
74
- "collection": "@nestjs/schematics",
75
- "sourceRoot": "src"
76
- }
73
+ 'backend/nest-cli.json': `{
74
+ "collection": "@nestjs/schematics",
75
+ "sourceRoot": "src"
76
+ }
77
77
  `,
78
- 'backend/tsconfig.json': `{
79
- "compilerOptions": {
80
- "module": "commonjs",
81
- "declaration": true,
82
- "removeComments": true,
83
- "emitDecoratorMetadata": true,
84
- "experimentalDecorators": true,
85
- "allowSyntheticDefaultImports": true,
86
- "target": "es2021",
87
- "sourceMap": true,
88
- "outDir": "./dist",
89
- "baseUrl": "./",
90
- "incremental": true,
91
- "strict": true,
92
- "skipLibCheck": true
93
- }
94
- }
78
+ 'backend/tsconfig.json': `{
79
+ "compilerOptions": {
80
+ "module": "commonjs",
81
+ "declaration": true,
82
+ "removeComments": true,
83
+ "emitDecoratorMetadata": true,
84
+ "experimentalDecorators": true,
85
+ "allowSyntheticDefaultImports": true,
86
+ "target": "es2021",
87
+ "sourceMap": true,
88
+ "outDir": "./dist",
89
+ "baseUrl": "./",
90
+ "incremental": true,
91
+ "strict": true,
92
+ "skipLibCheck": true
93
+ }
94
+ }
95
95
  `,
96
- 'backend/tsconfig.build.json': `{
97
- "extends": "./tsconfig.json",
98
- "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
99
- }
96
+ 'backend/tsconfig.build.json': `{
97
+ "extends": "./tsconfig.json",
98
+ "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
99
+ }
100
100
  `,
101
- 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
102
- import { AppModule } from './app.module';
103
-
104
- async function bootstrap(): Promise<void> {
105
- const app = await NestFactory.create(AppModule);
106
- app.setGlobalPrefix('api');
107
- await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
108
- }
109
-
110
- void bootstrap();
101
+ 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
102
+ import { AppModule } from './app.module';
103
+
104
+ async function bootstrap(): Promise<void> {
105
+ const app = await NestFactory.create(AppModule);
106
+ app.setGlobalPrefix('api');
107
+ // Lets Nest call each provider's onModuleDestroy (e.g. OpsService closing its sqlite handle)
108
+ // on SIGINT/SIGTERM instead of the process exiting with the database handle left open.
109
+ app.enableShutdownHooks();
110
+ await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
111
+ }
112
+
113
+ void bootstrap();
111
114
  `,
112
- 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
113
- import { AppController } from "./app.controller";
114
- import { AppService } from "./app.service";
115
- import { OpsModule } from "./modules/ops/ops.module";
116
-
117
- @Module({
118
- imports: [OpsModule],
119
- controllers: [AppController],
120
- providers: [AppService]
121
- })
122
- export class AppModule {}
115
+ 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
116
+ import { AppController } from "./app.controller";
117
+ import { AppService } from "./app.service";
118
+ import { OpsModule } from "./modules/ops/ops.module";
119
+
120
+ @Module({
121
+ imports: [OpsModule],
122
+ controllers: [AppController],
123
+ providers: [AppService]
124
+ })
125
+ export class AppModule {}
123
126
  `,
124
- 'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
125
- import { AppService } from './app.service';
126
-
127
- @Controller()
128
- export class AppController {
129
- constructor(private readonly appService: AppService) {}
130
-
131
- @Get('health')
132
- health(): { status: string } {
133
- return this.appService.health();
134
- }
135
- }
127
+ 'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
128
+ import { AppService } from './app.service';
129
+
130
+ @Controller()
131
+ export class AppController {
132
+ constructor(private readonly appService: AppService) {}
133
+
134
+ @Get('health')
135
+ health(): { status: string } {
136
+ return this.appService.health();
137
+ }
138
+ }
136
139
  `,
137
- 'backend/src/app.service.ts': `import { Injectable } from '@nestjs/common';
138
-
139
- @Injectable()
140
- export class AppService {
141
- health(): { status: string } {
142
- return { status: 'ok' };
143
- }
144
- }
140
+ 'backend/src/app.service.ts': `import { Injectable } from '@nestjs/common';
141
+
142
+ @Injectable()
143
+ export class AppService {
144
+ health(): { status: string } {
145
+ return { status: 'ok' };
146
+ }
147
+ }
145
148
  `,
146
- 'backend/src/modules/ops/ops.service.ts': `import { Injectable } from '@nestjs/common';
147
- import * as Database from 'better-sqlite3';
148
- import * as path from 'node:path';
149
-
150
- @Injectable()
151
- export class OpsService {
152
- private db: any;
153
-
154
- constructor() {
155
- const dbPath = path.resolve(process.cwd(), '..', '.memory', 'sqlite', 'context.db');
156
- this.db = new (Database as any)(dbPath, { readonly: true });
157
- }
158
-
159
- getStats() {
160
- const agents = this.db.prepare('SELECT agent_name, status, current_task FROM agent_sessions').all();
161
- const tasks = this.db.prepare('SELECT status, COUNT(*) as count FROM tasks GROUP BY status').all();
162
- const handoffs = this.db.prepare('SELECT from_agent, to_agent, title, created_at FROM handoffs ORDER BY created_at DESC LIMIT 5').all();
163
-
164
- return { agents, tasks, handoffs };
165
- }
166
- }
149
+ 'backend/src/modules/ops/ops.service.ts': `import { Injectable, OnModuleDestroy } from '@nestjs/common';
150
+ import * as Database from 'better-sqlite3';
151
+ import * as path from 'node:path';
152
+
153
+ @Injectable()
154
+ export class OpsService implements OnModuleDestroy {
155
+ private db: any;
156
+
157
+ constructor() {
158
+ const dbPath = path.resolve(process.cwd(), '..', '.memory', 'sqlite', 'context.db');
159
+ this.db = new (Database as any)(dbPath, { readonly: true });
160
+ }
161
+
162
+ getStats() {
163
+ const agents = this.db.prepare('SELECT agent_name, status, current_task FROM agent_sessions').all();
164
+ const tasks = this.db.prepare('SELECT status, COUNT(*) as count FROM tasks GROUP BY status').all();
165
+ const handoffs = this.db.prepare('SELECT from_agent, to_agent, title, created_at FROM handoffs ORDER BY created_at DESC LIMIT 5').all();
166
+
167
+ return { agents, tasks, handoffs };
168
+ }
169
+
170
+ // Closes the sqlite handle on SIGINT/SIGTERM (via app.enableShutdownHooks() in main.ts),
171
+ // rather than leaving it open for the process to exit around.
172
+ onModuleDestroy() {
173
+ this.db.close();
174
+ }
175
+ }
167
176
  `,
168
- 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
169
- import { OpsService } from './ops.service';
170
-
171
- @Controller('ops')
172
- export class OpsController {
173
- constructor(private readonly opsService: OpsService) {}
174
-
175
- @Get('stats')
176
- getStats() {
177
- return this.opsService.getStats();
178
- }
179
-
180
- @Get()
181
- renderDashboard() {
182
- const stats = this.opsService.getStats();
183
-
184
- return \`
185
- <!DOCTYPE html>
186
- <html lang="pt-BR">
187
- <head>
188
- <meta charset="UTF-8">
189
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
190
- <title>Agentes Ops Dashboard</title>
191
- <script src="https://cdn.tailwindcss.com"><\/script>
192
- <meta http-equiv="refresh" content="30">
193
- </head>
194
- <body class="bg-gray-900 text-gray-100 font-sans p-8">
195
- <div class="max-w-6xl mx-auto">
196
- <header class="flex justify-between items-center mb-12">
197
- <h1 class="text-3xl font-bold text-blue-400">🚀 Agentes Operacionais</h1>
198
- <div class="text-sm text-gray-400">Sincronizado via SQLite</div>
199
- </header>
200
-
201
- <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
202
- <!-- Agentes -->
203
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
204
- <h2 class="text-xl font-semibold mb-4 flex items-center">
205
- <span class="mr-2">🤖</span> Status dos Agentes
206
- </h2>
207
- <div class="space-y-4">
208
- \${stats.agents.map((a: any) => \`
209
- <div class="p-3 bg-gray-900 rounded-lg border-l-4 \${a.status === 'IDLE' ? 'border-green-500' : 'border-yellow-500'}">
210
- <div class="font-bold">\${a.agent_name}</div>
211
- <div class="text-xs text-gray-400">\${a.status} \${a.current_task ? ' - ' + a.current_task : ''}</div>
212
- </div>
213
- \`).join('')}
214
- </div>
215
- </section>
216
-
217
- <!-- Tarefas -->
218
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
219
- <h2 class="text-xl font-semibold mb-4 flex items-center">
220
- <span class="mr-2">📊</span> Backlog & Progresso
221
- </h2>
222
- <div class="space-y-4">
223
- \${stats.tasks.map((t: any) => \`
224
- <div class="flex justify-between items-center">
225
- <span class="capitalize">\${t.status}</span>
226
- <span class="bg-blue-600 px-2 py-1 rounded text-xs">\${t.count}</span>
227
- </div>
228
- \`).join('')}
229
- </div>
230
- </section>
231
-
232
- <!-- Handoffs -->
233
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
234
- <h2 class="text-xl font-semibold mb-4 flex items-center">
235
- <span class="mr-2">🤝</span> Últimos Handoffs
236
- </h2>
237
- <div class="space-y-3">
238
- \${stats.handoffs.map((h: any) => \`
239
- <div class="text-xs border-b border-gray-700 pb-2">
240
- <div class="text-blue-300 font-medium">\${h.from_agent} → \${h.to_agent}</div>
241
- <div class="text-gray-400 truncate">\${h.title}</div>
242
- </div>
243
- \`).join('')}
244
- </div>
245
- </section>
246
- </div>
247
-
248
- <footer class="mt-12 text-center text-gray-500 text-xs">
249
- Atualizado em: \${new Date().toLocaleString('pt-BR')} | create-memory-nest-kit v0.5.0
250
- </footer>
251
- </div>
252
- </body>
253
- </html>
254
- \`;
255
- }
256
- }
177
+ 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
178
+ import { OpsService } from './ops.service';
179
+
180
+ /** Escapa HTML para evitar XSS refletido/armazenado via agent_name/current_task/status/title etc. (dados livres vindos do SQLite). */
181
+ function esc(value: unknown): string {
182
+ return String(value).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' } as Record<string, string>)[c]);
183
+ }
184
+
185
+ @Controller('ops')
186
+ export class OpsController {
187
+ constructor(private readonly opsService: OpsService) {}
188
+
189
+ @Get('stats')
190
+ getStats() {
191
+ return this.opsService.getStats();
192
+ }
193
+
194
+ @Get()
195
+ renderDashboard() {
196
+ const stats = this.opsService.getStats();
197
+
198
+ return \`
199
+ <!DOCTYPE html>
200
+ <html lang="pt-BR">
201
+ <head>
202
+ <meta charset="UTF-8">
203
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
204
+ <title>Agentes Ops Dashboard</title>
205
+ <script src="https://cdn.tailwindcss.com"><\/script>
206
+ <meta http-equiv="refresh" content="30">
207
+ </head>
208
+ <body class="bg-gray-900 text-gray-100 font-sans p-8">
209
+ <div class="max-w-6xl mx-auto">
210
+ <header class="flex justify-between items-center mb-12">
211
+ <h1 class="text-3xl font-bold text-blue-400">🚀 Agentes Operacionais</h1>
212
+ <div class="text-sm text-gray-400">Sincronizado via SQLite</div>
213
+ </header>
214
+
215
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
216
+ <!-- Agentes -->
217
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
218
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
219
+ <span class="mr-2">🤖</span> Status dos Agentes
220
+ </h2>
221
+ <div class="space-y-4">
222
+ \${stats.agents.map((a: any) => \`
223
+ <div class="p-3 bg-gray-900 rounded-lg border-l-4 \${a.status === 'IDLE' ? 'border-green-500' : 'border-yellow-500'}">
224
+ <div class="font-bold">\${esc(a.agent_name)}</div>
225
+ <div class="text-xs text-gray-400">\${esc(a.status)} \${a.current_task ? ' - ' + esc(a.current_task) : ''}</div>
226
+ </div>
227
+ \`).join('')}
228
+ </div>
229
+ </section>
230
+
231
+ <!-- Tarefas -->
232
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
233
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
234
+ <span class="mr-2">📊</span> Backlog & Progresso
235
+ </h2>
236
+ <div class="space-y-4">
237
+ \${stats.tasks.map((t: any) => \`
238
+ <div class="flex justify-between items-center">
239
+ <span class="capitalize">\${esc(t.status)}</span>
240
+ <span class="bg-blue-600 px-2 py-1 rounded text-xs">\${esc(t.count)}</span>
241
+ </div>
242
+ \`).join('')}
243
+ </div>
244
+ </section>
245
+
246
+ <!-- Handoffs -->
247
+ <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
248
+ <h2 class="text-xl font-semibold mb-4 flex items-center">
249
+ <span class="mr-2">🤝</span> Últimos Handoffs
250
+ </h2>
251
+ <div class="space-y-3">
252
+ \${stats.handoffs.map((h: any) => \`
253
+ <div class="text-xs border-b border-gray-700 pb-2">
254
+ <div class="text-blue-300 font-medium">\${esc(h.from_agent)} → \${esc(h.to_agent)}</div>
255
+ <div class="text-gray-400 truncate">\${esc(h.title)}</div>
256
+ </div>
257
+ \`).join('')}
258
+ </div>
259
+ </section>
260
+ </div>
261
+
262
+ <footer class="mt-12 text-center text-gray-500 text-xs">
263
+ Atualizado em: \${new Date().toLocaleString('pt-BR')} | create-memory-nest-kit v0.5.0
264
+ </footer>
265
+ </div>
266
+ </body>
267
+ </html>
268
+ \`;
269
+ }
270
+ }
257
271
  `,
258
- 'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
259
- import { OpsController } from './ops.controller';
260
- import { OpsService } from './ops.service';
261
-
262
- @Module({
263
- controllers: [OpsController],
264
- providers: [OpsService]
265
- })
266
- export class OpsModule {}
272
+ 'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
273
+ import { OpsController } from './ops.controller';
274
+ import { OpsService } from './ops.service';
275
+
276
+ @Module({
277
+ controllers: [OpsController],
278
+ providers: [OpsService]
279
+ })
280
+ export class OpsModule {}
267
281
  `,
268
- 'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
269
- import { AppController } from './app.controller';
270
- import { AppService } from './app.service';
271
-
272
- describe('AppController', () => {
273
- let controller: AppController;
274
-
275
- beforeEach(async () => {
276
- const module: TestingModule = await Test.createTestingModule({
277
- controllers: [AppController],
278
- providers: [AppService]
279
- }).compile();
280
-
281
- controller = module.get<AppController>(AppController);
282
- });
283
-
284
- it('health() deve retornar status ok', () => {
285
- expect(controller.health()).toEqual({ status: 'ok' });
286
- });
287
- });
282
+ 'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
283
+ import { AppController } from './app.controller';
284
+ import { AppService } from './app.service';
285
+
286
+ describe('AppController', () => {
287
+ let controller: AppController;
288
+
289
+ beforeEach(async () => {
290
+ const module: TestingModule = await Test.createTestingModule({
291
+ controllers: [AppController],
292
+ providers: [AppService]
293
+ }).compile();
294
+
295
+ controller = module.get<AppController>(AppController);
296
+ });
297
+
298
+ it('health() deve retornar status ok', () => {
299
+ expect(controller.health()).toEqual({ status: 'ok' });
300
+ });
301
+ });
288
302
  `,
289
- 'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
290
- import { INestApplication } from '@nestjs/common';
291
- import request from 'supertest';
292
- import { AppModule } from '../src/app.module';
293
-
294
- describe('AppController (e2e)', () => {
295
- let app: INestApplication;
296
-
297
- beforeEach(async () => {
298
- const moduleFixture: TestingModule = await Test.createTestingModule({
299
- imports: [AppModule]
300
- }).compile();
301
-
302
- app = moduleFixture.createNestApplication();
303
- await app.init();
304
- });
305
-
306
- it('/api/health (GET)', async () => {
307
- await request(app.getHttpServer())
308
- .get('/api/health')
309
- .expect(200)
310
- .expect({ status: 'ok' });
311
- });
312
- });
303
+ 'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
304
+ import { INestApplication } from '@nestjs/common';
305
+ import request from 'supertest';
306
+ import { AppModule } from '../src/app.module';
307
+
308
+ describe('AppController (e2e)', () => {
309
+ let app: INestApplication;
310
+
311
+ beforeEach(async () => {
312
+ const moduleFixture: TestingModule = await Test.createTestingModule({
313
+ imports: [AppModule]
314
+ }).compile();
315
+
316
+ app = moduleFixture.createNestApplication();
317
+ await app.init();
318
+ });
319
+
320
+ it('/api/health (GET)', async () => {
321
+ await request(app.getHttpServer())
322
+ .get('/api/health')
323
+ .expect(200)
324
+ .expect({ status: 'ok' });
325
+ });
326
+ });
313
327
  `,
314
- 'backend/jest-e2e.json': `{
315
- "moduleFileExtensions": ["js", "json", "ts"],
316
- "rootDir": ".",
317
- "testEnvironment": "node",
318
- "testRegex": ".e2e-spec.ts$",
319
- "transform": {
320
- "^.+\\\\.(t|j)s$": "ts-jest"
321
- }
322
- }
328
+ 'backend/jest-e2e.json': `{
329
+ "moduleFileExtensions": ["js", "json", "ts"],
330
+ "rootDir": ".",
331
+ "testEnvironment": "node",
332
+ "testRegex": ".e2e-spec.ts$",
333
+ "transform": {
334
+ "^.+\\\\.(t|j)s$": "ts-jest"
335
+ }
336
+ }
323
337
  `,
324
- 'backend/.eslintrc.json': `{
325
- "parser": "@typescript-eslint/parser",
326
- "parserOptions": {
327
- "project": "tsconfig.json",
328
- "sourceType": "module"
329
- },
330
- "plugins": ["@typescript-eslint/eslint-plugin"],
331
- "extends": ["plugin:@typescript-eslint/recommended", "prettier"],
332
- "root": true,
333
- "env": {
334
- "node": true,
335
- "jest": true
336
- },
337
- "ignorePatterns": [".eslintrc.js"],
338
- "rules": {
339
- "@typescript-eslint/interface-name-prefix": "off",
340
- "@typescript-eslint/explicit-function-return-type": "off",
341
- "@typescript-eslint/explicit-module-boundary-types": "off",
342
- "@typescript-eslint/no-explicit-any": "off"
343
- }
344
- }
338
+ 'backend/.eslintrc.json': `{
339
+ "parser": "@typescript-eslint/parser",
340
+ "parserOptions": {
341
+ "project": "tsconfig.json",
342
+ "sourceType": "module"
343
+ },
344
+ "plugins": ["@typescript-eslint/eslint-plugin"],
345
+ "extends": ["plugin:@typescript-eslint/recommended", "prettier"],
346
+ "root": true,
347
+ "env": {
348
+ "node": true,
349
+ "jest": true
350
+ },
351
+ "ignorePatterns": [".eslintrc.js"],
352
+ "rules": {
353
+ "@typescript-eslint/interface-name-prefix": "off",
354
+ "@typescript-eslint/explicit-function-return-type": "off",
355
+ "@typescript-eslint/explicit-module-boundary-types": "off",
356
+ "@typescript-eslint/no-explicit-any": "off"
357
+ }
358
+ }
345
359
  `,
346
- 'backend/.prettierrc': `{
347
- "singleQuote": true,
348
- "trailingComma": "all",
349
- "semi": true,
350
- "printWidth": 100,
351
- "arrowParens": "always"
352
- }
360
+ 'backend/.prettierrc': `{
361
+ "singleQuote": true,
362
+ "trailingComma": "all",
363
+ "semi": true,
364
+ "printWidth": 100,
365
+ "arrowParens": "always"
366
+ }
353
367
  `,
354
368
  };
355
369
  }
@@ -357,79 +371,79 @@ describe('AppController (e2e)', () => {
357
371
  * Templates dos scripts de banco de dados (estáticos)
358
372
  */
359
373
  const databaseScriptTemplates = {
360
- 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
361
- PRAGMA foreign_keys = ON;
362
-
363
- CREATE TABLE IF NOT EXISTS documents (
364
- id INTEGER PRIMARY KEY AUTOINCREMENT,
365
- path TEXT NOT NULL UNIQUE,
366
- kind TEXT NOT NULL,
367
- title TEXT,
368
- content_hash TEXT NOT NULL,
369
- content TEXT NOT NULL,
370
- updated_at TEXT NOT NULL
371
- );
372
-
373
- CREATE TABLE IF NOT EXISTS document_chunks (
374
- id INTEGER PRIMARY KEY AUTOINCREMENT,
375
- document_id INTEGER NOT NULL,
376
- chunk_index INTEGER NOT NULL,
377
- content TEXT NOT NULL,
378
- token_estimate INTEGER NOT NULL DEFAULT 0,
379
- FOREIGN KEY(document_id) REFERENCES documents(id) ON DELETE CASCADE
380
- );
381
-
382
- CREATE UNIQUE INDEX IF NOT EXISTS idx_document_chunks_unique
383
- ON document_chunks (document_id, chunk_index);
384
-
385
- CREATE TABLE IF NOT EXISTS handoffs (
386
- id INTEGER PRIMARY KEY AUTOINCREMENT,
387
- file_path TEXT NOT NULL UNIQUE,
388
- from_agent TEXT,
389
- to_agent TEXT,
390
- title TEXT,
391
- created_at TEXT NOT NULL,
392
- status TEXT NOT NULL DEFAULT 'open'
393
- );
394
-
395
- CREATE TABLE IF NOT EXISTS adrs (
396
- id INTEGER PRIMARY KEY AUTOINCREMENT,
397
- adr_code TEXT NOT NULL UNIQUE,
398
- title TEXT NOT NULL,
399
- file_path TEXT NOT NULL UNIQUE,
400
- status TEXT NOT NULL DEFAULT 'accepted',
401
- updated_at TEXT NOT NULL
402
- );
403
-
404
- CREATE TABLE IF NOT EXISTS summaries (
405
- id INTEGER PRIMARY KEY AUTOINCREMENT,
406
- scope TEXT NOT NULL,
407
- scope_key TEXT NOT NULL,
408
- file_path TEXT NOT NULL UNIQUE,
409
- summary TEXT NOT NULL,
410
- updated_at TEXT NOT NULL
411
- );
412
-
413
- CREATE UNIQUE INDEX IF NOT EXISTS idx_summaries_scope
414
- ON summaries (scope, scope_key);
415
-
416
- CREATE TABLE IF NOT EXISTS tasks (
417
- id INTEGER PRIMARY KEY AUTOINCREMENT,
418
- task_key TEXT NOT NULL UNIQUE,
419
- title TEXT NOT NULL,
420
- status TEXT NOT NULL DEFAULT 'open',
421
- owner_agent TEXT,
422
- source_file TEXT NOT NULL,
423
- updated_at TEXT NOT NULL
424
- );
425
-
426
- CREATE TABLE IF NOT EXISTS agent_sessions (
427
- id INTEGER PRIMARY KEY AUTOINCREMENT,
428
- agent_name TEXT NOT NULL UNIQUE,
429
- status TEXT NOT NULL DEFAULT 'IDLE',
430
- current_task TEXT,
431
- updated_at TEXT NOT NULL
432
- );
374
+ 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
375
+ PRAGMA foreign_keys = ON;
376
+
377
+ CREATE TABLE IF NOT EXISTS documents (
378
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
379
+ path TEXT NOT NULL UNIQUE,
380
+ kind TEXT NOT NULL,
381
+ title TEXT,
382
+ content_hash TEXT NOT NULL,
383
+ content TEXT NOT NULL,
384
+ updated_at TEXT NOT NULL
385
+ );
386
+
387
+ CREATE TABLE IF NOT EXISTS document_chunks (
388
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
389
+ document_id INTEGER NOT NULL,
390
+ chunk_index INTEGER NOT NULL,
391
+ content TEXT NOT NULL,
392
+ token_estimate INTEGER NOT NULL DEFAULT 0,
393
+ FOREIGN KEY(document_id) REFERENCES documents(id) ON DELETE CASCADE
394
+ );
395
+
396
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_document_chunks_unique
397
+ ON document_chunks (document_id, chunk_index);
398
+
399
+ CREATE TABLE IF NOT EXISTS handoffs (
400
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
401
+ file_path TEXT NOT NULL UNIQUE,
402
+ from_agent TEXT,
403
+ to_agent TEXT,
404
+ title TEXT,
405
+ created_at TEXT NOT NULL,
406
+ status TEXT NOT NULL DEFAULT 'open'
407
+ );
408
+
409
+ CREATE TABLE IF NOT EXISTS adrs (
410
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
411
+ adr_code TEXT NOT NULL UNIQUE,
412
+ title TEXT NOT NULL,
413
+ file_path TEXT NOT NULL UNIQUE,
414
+ status TEXT NOT NULL DEFAULT 'accepted',
415
+ updated_at TEXT NOT NULL
416
+ );
417
+
418
+ CREATE TABLE IF NOT EXISTS summaries (
419
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
420
+ scope TEXT NOT NULL,
421
+ scope_key TEXT NOT NULL,
422
+ file_path TEXT NOT NULL UNIQUE,
423
+ summary TEXT NOT NULL,
424
+ updated_at TEXT NOT NULL
425
+ );
426
+
427
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_summaries_scope
428
+ ON summaries (scope, scope_key);
429
+
430
+ CREATE TABLE IF NOT EXISTS tasks (
431
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
432
+ task_key TEXT NOT NULL UNIQUE,
433
+ title TEXT NOT NULL,
434
+ status TEXT NOT NULL DEFAULT 'open',
435
+ owner_agent TEXT,
436
+ source_file TEXT NOT NULL,
437
+ updated_at TEXT NOT NULL
438
+ );
439
+
440
+ CREATE TABLE IF NOT EXISTS agent_sessions (
441
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
442
+ agent_name TEXT NOT NULL UNIQUE,
443
+ status TEXT NOT NULL DEFAULT 'IDLE',
444
+ current_task TEXT,
445
+ updated_at TEXT NOT NULL
446
+ );
433
447
  `,
434
448
  };
435
449
  /**