forjajs 2.0.3 → 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 (701) 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 -339
  21. package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,38 +1,38 @@
1
- # ADR-0001: Memória hierárquica em 9 camadas (00-90)
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-04-21
5
- - **Tags**: memory, structure
6
-
7
- ## Contexto
8
- Agentes precisam de contexto durável entre sessões, mas carregar todo o histórico estoura janela de tokens. Memórias planas (single file) ficam ingovernáveis acima de ~5k linhas; pastas sem semântica viram dump.
9
-
10
- ## Decisão
11
- Adotar hierarquia fixa de 9 prefixos numerados em `memory/`:
12
-
13
- | Prefixo | Conteúdo |
14
- |---|---|
15
- | `00-global` | Missão, padrões, política de contexto, contrato de agentes |
16
- | `10-product` | Visão, personas, regras de negócio, NFRs |
17
- | `20-architecture` | Frontend, backend, dados, segurança, observabilidade |
18
- | `30-domains` | Um subdiretório por bounded-context (auth, billing, …) |
19
- | `40-delivery` | Roadmap, sprint atual, backlog |
20
- | `50-orchestration` | Topologia, roteamento, handoff protocol, playbook |
21
- | `60-runs` | Log cronológico de execuções (arquivado após 30d) |
22
- | `70-summaries` | Resumos global e por domínio (gerados por compress-memory) |
23
- | `80-data` | Documentação do SQLite e schemas |
24
- | `90-decisions` | ADRs |
25
-
26
- ## Alternativas consideradas
27
- - **Memória plana em 1 arquivo** — rejeitada: ingovernável acima de 5k linhas
28
- - **Pastas por feature sem prefixo** — rejeitada: ordem alfabética não reflete relevância
29
- - **Banco vetorial puro** — rejeitada: perde estrutura humana-legível e versionamento git
30
-
31
- ## Consequências
32
- **Positivas**: navegação previsível, prefixos ordenam por relevância de contexto, fácil arquivamento por nível.
33
- **Negativas**: rigidez — adicionar uma camada nova exige decisão coletiva.
34
-
35
- ## Rastreamento
36
- - `bin/create-memory-nest-kit.js` (writeMemoryAndOps)
37
- - `lib/generators/memory-generator.js`
38
- - `memory/00-global/` (este repositório)
1
+ # ADR-0001: Memória hierárquica em 9 camadas (00-90)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: memory, structure
6
+
7
+ ## Contexto
8
+ Agentes precisam de contexto durável entre sessões, mas carregar todo o histórico estoura janela de tokens. Memórias planas (single file) ficam ingovernáveis acima de ~5k linhas; pastas sem semântica viram dump.
9
+
10
+ ## Decisão
11
+ Adotar hierarquia fixa de 9 prefixos numerados em `memory/`:
12
+
13
+ | Prefixo | Conteúdo |
14
+ |---|---|
15
+ | `00-global` | Missão, padrões, política de contexto, contrato de agentes |
16
+ | `10-product` | Visão, personas, regras de negócio, NFRs |
17
+ | `20-architecture` | Frontend, backend, dados, segurança, observabilidade |
18
+ | `30-domains` | Um subdiretório por bounded-context (auth, billing, …) |
19
+ | `40-delivery` | Roadmap, sprint atual, backlog |
20
+ | `50-orchestration` | Topologia, roteamento, handoff protocol, playbook |
21
+ | `60-runs` | Log cronológico de execuções (arquivado após 30d) |
22
+ | `70-summaries` | Resumos global e por domínio (gerados por compress-memory) |
23
+ | `80-data` | Documentação do SQLite e schemas |
24
+ | `90-decisions` | ADRs |
25
+
26
+ ## Alternativas consideradas
27
+ - **Memória plana em 1 arquivo** — rejeitada: ingovernável acima de 5k linhas
28
+ - **Pastas por feature sem prefixo** — rejeitada: ordem alfabética não reflete relevância
29
+ - **Banco vetorial puro** — rejeitada: perde estrutura humana-legível e versionamento git
30
+
31
+ ## Consequências
32
+ **Positivas**: navegação previsível, prefixos ordenam por relevância de contexto, fácil arquivamento por nível.
33
+ **Negativas**: rigidez — adicionar uma camada nova exige decisão coletiva.
34
+
35
+ ## Rastreamento
36
+ - `bin/create-memory-nest-kit.js` (writeMemoryAndOps)
37
+ - `lib/generators/memory-generator.js`
38
+ - `memory/00-global/` (este repositório)
@@ -1,25 +1,25 @@
1
- # ADR-0002: SQLite + FTS5 como camada de busca de memória
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-04-21
5
- - **Tags**: memory, search, performance
6
-
7
- ## Contexto
8
- Memória cresce com o projeto. Grep linear em `memory/**/*.md` é O(n) sobre disco e ignora ranking. Indexação externa (Elastic, Meili) adiciona infra. Embeddings adicionam custo e dependência de modelo.
9
-
10
- ## Decisão
11
- Usar SQLite com extensão FTS5 como índice de busca local. Banco em `.memory/sqlite/universal.db`, sincronizado pelo `scripts/sync-universal-memory.js`. Consultas via `scripts/query-universal-memory.js` e `lib/context-builder.js`.
12
-
13
- ## Alternativas consideradas
14
- - **Grep direto** — rejeitada: sem ranking, sem stemming, lento em repos grandes
15
- - **Embeddings (Chroma/Qdrant)** — rejeitada nesta fase: custo de embedding em cada sync e dependência de modelo externo. Mantida como evolução futura
16
- - **Elasticsearch/Meilisearch** — rejeitada: infra externa, sem ganho para repos <10k arquivos
17
-
18
- ## Consequências
19
- **Positivas**: zero infra externa, FTS5 nativo, banco versionável (ou ignorável), reconstrução determinística do índice.
20
- **Negativas**: BM25 só (sem semântica), sync manual (não há watcher), banco pode crescer — mitigado por `compress-memory`.
21
-
22
- ## Rastreamento
23
- - `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`
24
- - `lib/context-builder.js`
25
- - `.memoryrc.json` (chave `compression`)
1
+ # ADR-0002: SQLite + FTS5 como camada de busca de memória
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: memory, search, performance
6
+
7
+ ## Contexto
8
+ Memória cresce com o projeto. Grep linear em `memory/**/*.md` é O(n) sobre disco e ignora ranking. Indexação externa (Elastic, Meili) adiciona infra. Embeddings adicionam custo e dependência de modelo.
9
+
10
+ ## Decisão
11
+ Usar SQLite com extensão FTS5 como índice de busca local. Banco em `.memory/sqlite/universal.db`, sincronizado pelo `scripts/sync-universal-memory.js`. Consultas via `scripts/query-universal-memory.js` e `lib/context-builder.js`.
12
+
13
+ ## Alternativas consideradas
14
+ - **Grep direto** — rejeitada: sem ranking, sem stemming, lento em repos grandes
15
+ - **Embeddings (Chroma/Qdrant)** — rejeitada nesta fase: custo de embedding em cada sync e dependência de modelo externo. Mantida como evolução futura
16
+ - **Elasticsearch/Meilisearch** — rejeitada: infra externa, sem ganho para repos <10k arquivos
17
+
18
+ ## Consequências
19
+ **Positivas**: zero infra externa, FTS5 nativo, banco versionável (ou ignorável), reconstrução determinística do índice.
20
+ **Negativas**: BM25 só (sem semântica), sync manual (não há watcher), banco pode crescer — mitigado por `compress-memory`.
21
+
22
+ ## Rastreamento
23
+ - `scripts/sync-universal-memory.js`, `scripts/query-universal-memory.js`
24
+ - `lib/context-builder.js`
25
+ - `.memoryrc.json` (chave `compression`)
@@ -1,31 +1,31 @@
1
- # ADR-0003: Smart Context com 3 modos (global/domain/task)
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-05-02
5
- - **Tags**: tokens, context, performance
6
-
7
- ## Contexto
8
- Mandar `memory/**` inteiro para o modelo gasta tokens e dilui relevância. Por outro lado, contexto vazio força o agente a perguntar tudo. Precisamos de níveis intermediários.
9
-
10
- ## Decisão
11
- `lib/context-builder.js` expõe 3 modos:
12
-
13
- - **`global`**: arquivos de `00-global`, `10-product/vision.md`, `20-architecture/overview.md`. Para onboarding de agentes novos.
14
- - **`domain`**: tudo de `30-domains/<dominio>/` + summaries relacionados. Para trabalho focado em um bounded-context.
15
- - **`task`**: busca FTS5 dirigida por query + top-N arquivos rankeados. Para sprints/tasks específicas.
16
-
17
- Cada modo tem cap de bytes em `.memoryrc.json` e cache LRU.
18
-
19
- ## Alternativas consideradas
20
- - **1 só modo (everything-or-nothing)** — rejeitada: sem granularidade
21
- - **Modo dinâmico baseado em prompt** — rejeitada nesta versão: latência de classificação, comportamento difícil de explicar. Pode evoluir para isso
22
-
23
- ## Consequências
24
- **Positivas**: redução medida de 40-60% em tokens (`scripts/token-benchmark.mjs`), comportamento determinístico.
25
- **Negativas**: agente precisa escolher o modo — mitigado por defaults sensatos (smart-context escolhe pelo contexto da invocação).
26
-
27
- ## Rastreamento
28
- - `lib/context-builder.js`
29
- - `scripts/build-smart-context.js`
30
- - `scripts/token-benchmark.mjs`
31
- - `.memoryrc.json` (chave `context.modes`)
1
+ # ADR-0003: Smart Context com 3 modos (global/domain/task)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-02
5
+ - **Tags**: tokens, context, performance
6
+
7
+ ## Contexto
8
+ Mandar `memory/**` inteiro para o modelo gasta tokens e dilui relevância. Por outro lado, contexto vazio força o agente a perguntar tudo. Precisamos de níveis intermediários.
9
+
10
+ ## Decisão
11
+ `lib/context-builder.js` expõe 3 modos:
12
+
13
+ - **`global`**: arquivos de `00-global`, `10-product/vision.md`, `20-architecture/overview.md`. Para onboarding de agentes novos.
14
+ - **`domain`**: tudo de `30-domains/<dominio>/` + summaries relacionados. Para trabalho focado em um bounded-context.
15
+ - **`task`**: busca FTS5 dirigida por query + top-N arquivos rankeados. Para sprints/tasks específicas.
16
+
17
+ Cada modo tem cap de bytes em `.memoryrc.json` e cache LRU.
18
+
19
+ ## Alternativas consideradas
20
+ - **1 só modo (everything-or-nothing)** — rejeitada: sem granularidade
21
+ - **Modo dinâmico baseado em prompt** — rejeitada nesta versão: latência de classificação, comportamento difícil de explicar. Pode evoluir para isso
22
+
23
+ ## Consequências
24
+ **Positivas**: redução medida de 40-60% em tokens (`scripts/token-benchmark.mjs`), comportamento determinístico.
25
+ **Negativas**: agente precisa escolher o modo — mitigado por defaults sensatos (smart-context escolhe pelo contexto da invocação).
26
+
27
+ ## Rastreamento
28
+ - `lib/context-builder.js`
29
+ - `scripts/build-smart-context.js`
30
+ - `scripts/token-benchmark.mjs`
31
+ - `.memoryrc.json` (chave `context.modes`)
@@ -1,27 +1,27 @@
1
- # ADR-0004: Validação e segurança obrigatórias no scaffold NestJS
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-04-21
5
- - **Tags**: security, scaffold
6
-
7
- ## Contexto
8
- Versão inicial do scaffold gerava controllers sem DTO, sem rate-limit, sem sanitização. Projetos derivados herdaram débito de segurança. Custo de "consertar depois" é alto.
9
-
10
- ## Decisão
11
- Todo controller gerado pelo kit deve:
12
- - Usar DTOs com `class-validator` (`@IsString`, `@IsEmail`, `@MaxLength`, etc.)
13
- - Tratar erro via `HttpException` com código específico
14
- - Ter `*.spec.ts` gerado lado-a-lado
15
- - Aplicar `helmet`, `rate-limit` global e payload máximo de 10MB
16
-
17
- ## Alternativas consideradas
18
- - **Validação opcional** — rejeitada: vira "todo mundo pula"
19
- - **Validação só em endpoints públicos** — rejeitada: classificar "público" é ambíguo
20
-
21
- ## Consequências
22
- **Positivas**: baseline de segurança herdado por todos os projetos derivados.
23
- **Negativas**: scaffold mais verboso (~30% mais arquivos no `--no-only-memory`).
24
-
25
- ## Rastreamento
26
- - `lib/generators/nest-generator.js`
27
- - `docs/archive/REFINAMENTO-v1.0.md` (seção SEC-001..004)
1
+ # ADR-0004: Validação e segurança obrigatórias no scaffold NestJS
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: security, scaffold
6
+
7
+ ## Contexto
8
+ Versão inicial do scaffold gerava controllers sem DTO, sem rate-limit, sem sanitização. Projetos derivados herdaram débito de segurança. Custo de "consertar depois" é alto.
9
+
10
+ ## Decisão
11
+ Todo controller gerado pelo kit deve:
12
+ - Usar DTOs com `class-validator` (`@IsString`, `@IsEmail`, `@MaxLength`, etc.)
13
+ - Tratar erro via `HttpException` com código específico
14
+ - Ter `*.spec.ts` gerado lado-a-lado
15
+ - Aplicar `helmet`, `rate-limit` global e payload máximo de 10MB
16
+
17
+ ## Alternativas consideradas
18
+ - **Validação opcional** — rejeitada: vira "todo mundo pula"
19
+ - **Validação só em endpoints públicos** — rejeitada: classificar "público" é ambíguo
20
+
21
+ ## Consequências
22
+ **Positivas**: baseline de segurança herdado por todos os projetos derivados.
23
+ **Negativas**: scaffold mais verboso (~30% mais arquivos no `--no-only-memory`).
24
+
25
+ ## Rastreamento
26
+ - `lib/generators/nest-generator.js`
27
+ - `docs/archive/REFINAMENTO-v1.0.md` (seção SEC-001..004)
@@ -1,32 +1,32 @@
1
- # ADR-0005: Handoff entre agentes com 7 campos obrigatórios
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-04-26
5
- - **Tags**: orchestration, handoff
6
-
7
- ## Contexto
8
- Handoffs em texto-livre entre agentes (Product → SDD Architect → Worker) perdiam contexto, geravam retrabalho e ambiguidade. Sem contrato, cada agente inventa formato.
9
-
10
- ## Decisão
11
- Todo handoff em `memory/50-orchestration/handoffs/` deve carregar 7 campos:
12
-
13
- 1. **from** — agente origem
14
- 2. **to** — agente destino
15
- 3. **intent** — verbo curto: implement | review | plan | research
16
- 4. **context** — referências (paths, ADRs, specs) suficientes para isolar a tarefa
17
- 5. **acceptance** — critérios mensuráveis de "pronto"
18
- 6. **constraints** — limites (tempo, escopo, padrões a respeitar)
19
- 7. **return** — o que o destinatário deve devolver e onde
20
-
21
- ## Alternativas consideradas
22
- - **Texto-livre** — rejeitada (era o estado anterior)
23
- - **Schema mais rico (15+ campos)** — rejeitada: fricção alta, agentes esqueciam
24
-
25
- ## Consequências
26
- **Positivas**: handoff verificável programaticamente, qualidade mínima garantida.
27
- **Negativas**: precisa ferramenta (`append-handoff.mjs`) para não virar burocracia.
28
-
29
- ## Rastreamento
30
- - `lib/generators/memory-generator.js` (templates de `50-orchestration/`)
31
- - `scripts/append-handoff.mjs` (no projeto gerado)
32
- - Esta refator: migrar handoff para tabela SQLite (ADR futura)
1
+ # ADR-0005: Handoff entre agentes com 7 campos obrigatórios
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-26
5
+ - **Tags**: orchestration, handoff
6
+
7
+ ## Contexto
8
+ Handoffs em texto-livre entre agentes (Product → SDD Architect → Worker) perdiam contexto, geravam retrabalho e ambiguidade. Sem contrato, cada agente inventa formato.
9
+
10
+ ## Decisão
11
+ Todo handoff em `memory/50-orchestration/handoffs/` deve carregar 7 campos:
12
+
13
+ 1. **from** — agente origem
14
+ 2. **to** — agente destino
15
+ 3. **intent** — verbo curto: implement | review | plan | research
16
+ 4. **context** — referências (paths, ADRs, specs) suficientes para isolar a tarefa
17
+ 5. **acceptance** — critérios mensuráveis de "pronto"
18
+ 6. **constraints** — limites (tempo, escopo, padrões a respeitar)
19
+ 7. **return** — o que o destinatário deve devolver e onde
20
+
21
+ ## Alternativas consideradas
22
+ - **Texto-livre** — rejeitada (era o estado anterior)
23
+ - **Schema mais rico (15+ campos)** — rejeitada: fricção alta, agentes esqueciam
24
+
25
+ ## Consequências
26
+ **Positivas**: handoff verificável programaticamente, qualidade mínima garantida.
27
+ **Negativas**: precisa ferramenta (`append-handoff.mjs`) para não virar burocracia.
28
+
29
+ ## Rastreamento
30
+ - `lib/generators/memory-generator.js` (templates de `50-orchestration/`)
31
+ - `scripts/append-handoff.mjs` (no projeto gerado)
32
+ - Esta refator: migrar handoff para tabela SQLite (ADR futura)
@@ -1,23 +1,23 @@
1
- # ADR-0006: Documentação estruturada por persona
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-05-02
5
- - **Tags**: docs, onboarding
6
-
7
- ## Contexto
8
- Antes da refator, 30+ `.md` no root sem ordem fizeram onboarding levar horas. Cada perfil (executivo, arquiteto, dev, QA) precisava de visão diferente, mas tudo era apresentado em massa.
9
-
10
- ## Decisão
11
- Adotar `docs/personas/{executive,architect,developer,qa}/README.md` como ponto de entrada por papel. `DOC-MAP.md` no root indexa as personas. Documentos genéricos (`quick-reference`, `glossary`, `token-optimization`, `dev-workflow`) ficam em `docs/` raiz.
12
-
13
- ## Alternativas consideradas
14
- - **README único gigante** — rejeitada: ninguém lê linear
15
- - **Wiki externa (Notion/GitBook)** — rejeitada: sai do repo, vira desincronizado
16
-
17
- ## Consequências
18
- **Positivas**: tempo de onboarding caiu ~83% (medido em tempo até primeiro commit produtivo).
19
- **Negativas**: 4 entradas para manter; risco de divergência mitigado por DOC-MAP central.
20
-
21
- ## Rastreamento
22
- - `docs/personas/`, `docs/`, `DOC-MAP.md`
23
- - `docs/archive/FASE2-SUMMARY.md` (relatório original)
1
+ # ADR-0006: Documentação estruturada por persona
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-02
5
+ - **Tags**: docs, onboarding
6
+
7
+ ## Contexto
8
+ Antes da refator, 30+ `.md` no root sem ordem fizeram onboarding levar horas. Cada perfil (executivo, arquiteto, dev, QA) precisava de visão diferente, mas tudo era apresentado em massa.
9
+
10
+ ## Decisão
11
+ Adotar `docs/personas/{executive,architect,developer,qa}/README.md` como ponto de entrada por papel. `DOC-MAP.md` no root indexa as personas. Documentos genéricos (`quick-reference`, `glossary`, `token-optimization`, `dev-workflow`) ficam em `docs/` raiz.
12
+
13
+ ## Alternativas consideradas
14
+ - **README único gigante** — rejeitada: ninguém lê linear
15
+ - **Wiki externa (Notion/GitBook)** — rejeitada: sai do repo, vira desincronizado
16
+
17
+ ## Consequências
18
+ **Positivas**: tempo de onboarding caiu ~83% (medido em tempo até primeiro commit produtivo).
19
+ **Negativas**: 4 entradas para manter; risco de divergência mitigado por DOC-MAP central.
20
+
21
+ ## Rastreamento
22
+ - `docs/personas/`, `docs/`, `DOC-MAP.md`
23
+ - `docs/archive/FASE2-SUMMARY.md` (relatório original)
@@ -1,33 +1,33 @@
1
- # ADR-0007: Pipeline Spec-Driven obrigatório para features não-triviais
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-05-10
5
- - **Tags**: sdd, methodology, governance
6
-
7
- ## Contexto
8
- AGENTS.md descrevia um "SDD Architect" mas não havia mecânica que forçasse spec antes de código. Trabalho começava direto na implementação, decisões eram tomadas no PR (tarde), e o "porquê" se perdia no tempo.
9
-
10
- ## Decisão
11
- Adotar pipeline em 3 fases vinculadas:
12
-
13
- 1. **`spec.md`** — produto define problema, AC, NFRs, escopo
14
- 2. **`plan.md`** — SDD Architect define arquitetura, contratos, alternativas; abre ADRs para decisões estruturais
15
- 3. **`tasks.md`** — decomposição executável com owners
16
-
17
- CLI `scripts/spec-cli.mjs` força ordem: `plan` exige `spec` em `approved+`; `tasks` exige `plan` em `approved+`. `spec:check` falha CI quando há violação.
18
-
19
- Lista explícita de "quando NÃO precisa spec" em `specs/README.md` (bugfixes 1-line, renames, doc updates, dep bumps) — evita transformar SDD em burocracia.
20
-
21
- ## Alternativas consideradas
22
- - **GitHub Issues + PR template** — rejeitada: não enforça ordem, sem separação entre "o quê" e "como"
23
- - **ADR como única forma** — rejeitada: ADR é decisão pontual, não rastreia execução
24
- - **Spec opcional** — rejeitada: viraria letra morta como o "Spec-Driven Architect" da versão anterior
25
-
26
- ## Consequências
27
- **Positivas**: rastreabilidade decisão → impl, onboarding de novos agentes mais barato, AC mensuráveis evitam scope creep.
28
- **Negativas**: fricção inicial (~10min por feature). Mitigada por templates e excluindo trabalhos triviais.
29
-
30
- ## Rastreamento
31
- - `specs/`, `scripts/spec-cli.mjs`
32
- - `package.json` (scripts `spec:*`)
33
- - SPEC-001 = pipeline-sdd-e-orquestracao (meta-spec deste trabalho)
1
+ # ADR-0007: Pipeline Spec-Driven obrigatório para features não-triviais
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: sdd, methodology, governance
6
+
7
+ ## Contexto
8
+ AGENTS.md descrevia um "SDD Architect" mas não havia mecânica que forçasse spec antes de código. Trabalho começava direto na implementação, decisões eram tomadas no PR (tarde), e o "porquê" se perdia no tempo.
9
+
10
+ ## Decisão
11
+ Adotar pipeline em 3 fases vinculadas:
12
+
13
+ 1. **`spec.md`** — produto define problema, AC, NFRs, escopo
14
+ 2. **`plan.md`** — SDD Architect define arquitetura, contratos, alternativas; abre ADRs para decisões estruturais
15
+ 3. **`tasks.md`** — decomposição executável com owners
16
+
17
+ CLI `scripts/spec-cli.mjs` força ordem: `plan` exige `spec` em `approved+`; `tasks` exige `plan` em `approved+`. `spec:check` falha CI quando há violação.
18
+
19
+ Lista explícita de "quando NÃO precisa spec" em `specs/README.md` (bugfixes 1-line, renames, doc updates, dep bumps) — evita transformar SDD em burocracia.
20
+
21
+ ## Alternativas consideradas
22
+ - **GitHub Issues + PR template** — rejeitada: não enforça ordem, sem separação entre "o quê" e "como"
23
+ - **ADR como única forma** — rejeitada: ADR é decisão pontual, não rastreia execução
24
+ - **Spec opcional** — rejeitada: viraria letra morta como o "Spec-Driven Architect" da versão anterior
25
+
26
+ ## Consequências
27
+ **Positivas**: rastreabilidade decisão → impl, onboarding de novos agentes mais barato, AC mensuráveis evitam scope creep.
28
+ **Negativas**: fricção inicial (~10min por feature). Mitigada por templates e excluindo trabalhos triviais.
29
+
30
+ ## Rastreamento
31
+ - `specs/`, `scripts/spec-cli.mjs`
32
+ - `package.json` (scripts `spec:*`)
33
+ - SPEC-001 = pipeline-sdd-e-orquestracao (meta-spec deste trabalho)
@@ -1,36 +1,36 @@
1
- # ADR-0008: Sub-agents executáveis + handoff em SQLite
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-05-10
5
- - **Tags**: orchestration, agents, sdd
6
- - **Supersede parcial**: comportamento de handoff em markdown da ADR-0005 (campos continuam valendo)
7
-
8
- ## Contexto
9
- AGENTS.md listava 6 papéis mas nenhum era executável — sub-agents existiam só como descrição. Handoffs viviam em `memory/50-orchestration/handoffs/*.md`, sem validação de campos, sem fila, sem status. Resultado: ninguém "passava o bastão" — papéis colidiam ou ficavam ociosos.
10
-
11
- ## Decisão
12
- 1. **6 sub-agents Claude Code** em `.claude/agents/*.md` — orchestrator, context-engineer, sdd-architect, product, marketing, governance. Cada um com frontmatter `name`/`description`/`tools` e system prompt focado.
13
- 2. **Handoffs persistem em SQLite** (`universal.db.handoffs`), não em markdown. Campos da ADR-0005 (7) são validados em `scripts/agent-router.mjs append`.
14
- 3. **Roteamento explícito**: agent-router CLI grava, lista, marca status (open → in_progress → done). Sem broadcast, sem polling.
15
- 4. Markdown handoffs antigos em `memory/50-orchestration/handoffs/` ficam como histórico — não migrados.
16
-
17
- ## Alternativas consideradas
18
- - **Manter handoff em markdown** — rejeitada: difícil de validar/consultar, status invisível
19
- - **Fila externa (Redis/SQS)** — rejeitada: infra extra para repo de framework
20
- - **Um único super-agent monolítico** — rejeitada: perde especialização e força do system-prompt focado
21
-
22
- ## Consequências
23
- **Positivas**:
24
- - Sub-agents Claude Code podem ser invocados via subagent_type explícito ou descobertos pela descrição
25
- - Handoff é queryável (SQL): "todos os abertos para o sdd-architect"
26
- - Validação de schema bloqueia handoff incompleto na origem
27
-
28
- **Negativas**:
29
- - Adiciona dependência soft de `better-sqlite3` para roteamento (já era devDependency)
30
- - Outras IAs (Copilot/Gemini/Codex) não consomem os `.claude/agents/` — precisam adapter futuro
31
-
32
- ## Rastreamento
33
- - `.claude/agents/`
34
- - `scripts/agent-router.mjs`
35
- - `AGENTS.md` (atualizado para apontar para sub-agents)
36
- - SPEC-001 AC-4..AC-6
1
+ # ADR-0008: Sub-agents executáveis + handoff em SQLite
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: orchestration, agents, sdd
6
+ - **Supersede parcial**: comportamento de handoff em markdown da ADR-0005 (campos continuam valendo)
7
+
8
+ ## Contexto
9
+ AGENTS.md listava 6 papéis mas nenhum era executável — sub-agents existiam só como descrição. Handoffs viviam em `memory/50-orchestration/handoffs/*.md`, sem validação de campos, sem fila, sem status. Resultado: ninguém "passava o bastão" — papéis colidiam ou ficavam ociosos.
10
+
11
+ ## Decisão
12
+ 1. **6 sub-agents Claude Code** em `.claude/agents/*.md` — orchestrator, context-engineer, sdd-architect, product, marketing, governance. Cada um com frontmatter `name`/`description`/`tools` e system prompt focado.
13
+ 2. **Handoffs persistem em SQLite** (`universal.db.handoffs`), não em markdown. Campos da ADR-0005 (7) são validados em `scripts/agent-router.mjs append`.
14
+ 3. **Roteamento explícito**: agent-router CLI grava, lista, marca status (open → in_progress → done). Sem broadcast, sem polling.
15
+ 4. Markdown handoffs antigos em `memory/50-orchestration/handoffs/` ficam como histórico — não migrados.
16
+
17
+ ## Alternativas consideradas
18
+ - **Manter handoff em markdown** — rejeitada: difícil de validar/consultar, status invisível
19
+ - **Fila externa (Redis/SQS)** — rejeitada: infra extra para repo de framework
20
+ - **Um único super-agent monolítico** — rejeitada: perde especialização e força do system-prompt focado
21
+
22
+ ## Consequências
23
+ **Positivas**:
24
+ - Sub-agents Claude Code podem ser invocados via subagent_type explícito ou descobertos pela descrição
25
+ - Handoff é queryável (SQL): "todos os abertos para o sdd-architect"
26
+ - Validação de schema bloqueia handoff incompleto na origem
27
+
28
+ **Negativas**:
29
+ - Adiciona dependência soft de `better-sqlite3` para roteamento (já era devDependency)
30
+ - Outras IAs (Copilot/Gemini/Codex) não consomem os `.claude/agents/` — precisam adapter futuro
31
+
32
+ ## Rastreamento
33
+ - `.claude/agents/`
34
+ - `scripts/agent-router.mjs`
35
+ - `AGENTS.md` (atualizado para apontar para sub-agents)
36
+ - SPEC-001 AC-4..AC-6
@@ -1,43 +1,43 @@
1
- # ADR-0009: Hooks Claude Code para contexto e economia de tokens
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-05-10
5
- - **Tags**: tokens, hooks, claude-code
6
-
7
- ## Contexto
8
- A Fase 3 entregou smart-context API (ADR-0003) mas o agente precisava invocá-la manualmente. Resultado: economia teórica de 40-60% só se materializa quando alguém lembra de chamar. Pre-commit também era leve — não validava SDD nem standards.
9
-
10
- ## Decisão
11
- Três pontos de hook em `.claude/settings.json`:
12
-
13
- 1. **`SessionStart`** → `scripts/hook-session-start.mjs`
14
- Imprime status do framework (specs ativas, handoffs abertos) como `additionalContext`. Roda 1×/sessão. Sem custo recorrente.
15
-
16
- 2. **`UserPromptSubmit`** → `scripts/hook-user-prompt.mjs`
17
- Opt-in via env `FRAMEWORK_HOOK_INJECT=1`. Só injeta quando prompt casa com keywords (`implement`, `refactor`, `criar feature`, `spec:`, …). Cache TTL 30min por hash do prompt. Cap configurável em `.memoryrc.json::hooks.userPromptCap` (default 4KB).
18
-
19
- 3. **Pre-commit ampliado** (`scripts/pre-commit.sh`)
20
- Adicionados passos 6 (`spec:check`) e 7 (`check-standards`). Bloqueia commit se SDD inconsistente.
21
-
22
- ## Alternativas consideradas
23
- - **Sempre injetar contexto** — rejeitada: gasta tokens em prompts triviais, atrasa primeiros tokens
24
- - **Injetar via slash command manual** — rejeitada: vira esquecível; já tem `npm run context:smart`
25
- - **Hook em `PreToolUse`** — rejeitada nesta versão: ruído alto, ganho duvidoso para o caso de uso (framework, não app de produção)
26
-
27
- ## Consequências
28
- **Positivas**:
29
- - Status do framework sempre visível ao iniciar sessão
30
- - Injeção opt-in com safeguards (keyword, cache, cap)
31
- - Pre-commit catch dívida de SDD antes do PR
32
-
33
- **Negativas / Trade-offs**:
34
- - `UserPromptSubmit` adiciona ≤200ms (cache) ou ≤1s (cold) ao primeiro token. Mitigado por trigger restrito.
35
- - Comportamento muda quando `FRAMEWORK_HOOK_INJECT=1` — documentar em onboarding.
36
- - Hooks só rodam no Claude Code; outras IAs (Copilot/Gemini) seguem fluxo manual.
37
-
38
- ## Rastreamento
39
- - `.claude/settings.json`
40
- - `scripts/hook-session-start.mjs`, `scripts/hook-user-prompt.mjs`
41
- - `scripts/pre-commit.sh` (passos 6-7)
42
- - `.memoryrc.json` (chave `hooks`)
43
- - SPEC-001 AC-7
1
+ # ADR-0009: Hooks Claude Code para contexto e economia de tokens
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-05-10
5
+ - **Tags**: tokens, hooks, claude-code
6
+
7
+ ## Contexto
8
+ A Fase 3 entregou smart-context API (ADR-0003) mas o agente precisava invocá-la manualmente. Resultado: economia teórica de 40-60% só se materializa quando alguém lembra de chamar. Pre-commit também era leve — não validava SDD nem standards.
9
+
10
+ ## Decisão
11
+ Três pontos de hook em `.claude/settings.json`:
12
+
13
+ 1. **`SessionStart`** → `scripts/hook-session-start.mjs`
14
+ Imprime status do framework (specs ativas, handoffs abertos) como `additionalContext`. Roda 1×/sessão. Sem custo recorrente.
15
+
16
+ 2. **`UserPromptSubmit`** → `scripts/hook-user-prompt.mjs`
17
+ Opt-in via env `FRAMEWORK_HOOK_INJECT=1`. Só injeta quando prompt casa com keywords (`implement`, `refactor`, `criar feature`, `spec:`, …). Cache TTL 30min por hash do prompt. Cap configurável em `.memoryrc.json::hooks.userPromptCap` (default 4KB).
18
+
19
+ 3. **Pre-commit ampliado** (`scripts/pre-commit.sh`)
20
+ Adicionados passos 6 (`spec:check`) e 7 (`check-standards`). Bloqueia commit se SDD inconsistente.
21
+
22
+ ## Alternativas consideradas
23
+ - **Sempre injetar contexto** — rejeitada: gasta tokens em prompts triviais, atrasa primeiros tokens
24
+ - **Injetar via slash command manual** — rejeitada: vira esquecível; já tem `npm run context:smart`
25
+ - **Hook em `PreToolUse`** — rejeitada nesta versão: ruído alto, ganho duvidoso para o caso de uso (framework, não app de produção)
26
+
27
+ ## Consequências
28
+ **Positivas**:
29
+ - Status do framework sempre visível ao iniciar sessão
30
+ - Injeção opt-in com safeguards (keyword, cache, cap)
31
+ - Pre-commit catch dívida de SDD antes do PR
32
+
33
+ **Negativas / Trade-offs**:
34
+ - `UserPromptSubmit` adiciona ≤200ms (cache) ou ≤1s (cold) ao primeiro token. Mitigado por trigger restrito.
35
+ - Comportamento muda quando `FRAMEWORK_HOOK_INJECT=1` — documentar em onboarding.
36
+ - Hooks só rodam no Claude Code; outras IAs (Copilot/Gemini) seguem fluxo manual.
37
+
38
+ ## Rastreamento
39
+ - `.claude/settings.json`
40
+ - `scripts/hook-session-start.mjs`, `scripts/hook-user-prompt.mjs`
41
+ - `scripts/pre-commit.sh` (passos 6-7)
42
+ - `.memoryrc.json` (chave `hooks`)
43
+ - SPEC-001 AC-7