forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,273 +1,273 @@
1
- # Análise de impacto — Fundação ForjaJS 2.0
2
-
3
- - **Data**: 2026-07-31
4
- - **Escopo**: visão, arquitetura, contratos públicos e typecheck
5
- - **Base**: ForjaJS 1.7.3, ADR-0003, ADR-0005, ADR-0019, ADR-0020, ADR-0027
6
-
7
- ## Contratos afetados
8
-
9
- | Área | Impacto atual | Decisão nesta fatia |
10
- | --- | --- | --- |
11
- | CLI 1.x | Nenhuma API alterada | Mantida como caminho legado |
12
- | Workspace | Nenhuma alteração de resolução | Mantido conforme ADR-0019 |
13
- | Memória SQLite | Nenhuma migração | Adapter fica para fase posterior |
14
- | Handoffs | Nenhuma alteração no router | Contrato 2.0 é aditivo |
15
- | TypeScript | Novo escopo `packages/**/*` | Typecheck do domínio entra no gate |
16
- | Publicação npm | Pacotes 2.0 ainda não publicados | Empacotamento será tratado com monorepo |
17
-
18
- ## Dependências e blast radius
19
-
20
- O único arquivo existente alterado é `tsconfig.json`, adicionando o diretório de pacotes ao
21
- typecheck. `lib/`, `scripts/`, `bin/`, registry e CLI não foram alterados. Os novos contratos não
22
- importam código existente nem dependências externas; portanto não há ciclo ou efeito runtime na
23
- CLI 1.x.
24
-
25
- ## Hipóteses
26
-
27
- - Node 20+ continuará sendo o runtime mínimo do pacote publicado; desenvolvimento pode usar o
28
- suporte nativo a TypeScript já adotado pelo projeto.
29
- - `packages/contracts` será a fonte canônica antes de schemas serem derivados para MCP/REST.
30
- - A escolha de biblioteca de schema (ou implementação própria) permanece aberta; esta fatia usa
31
- validação determinística mínima sem introduzir dependência.
32
- - IDs continuarão sendo strings opacas no transporte, representadas por brands no TypeScript.
33
-
34
- ## Informações ausentes
35
-
36
- - estratégia final de workspace/package manager;
37
- - formato de persistência e migrações 2.0;
38
- - protocolo exato de execução de handlers;
39
- - biblioteca de schema runtime e biblioteca de testes de integração;
40
- - política de compatibilidade semântica entre versões de contrato;
41
- - requisitos de autenticação local do server.
42
-
43
- ## Riscos
44
-
45
- - Os contratos ainda não cobrem invariantes de cada bounded context.
46
- - `unknown` em payloads é intencional nesta etapa, mas cada capability deverá fornecer schema
47
- específico antes de execução.
48
- - A existência de apenas dois ADRs 2.0 não fecha a governança completa; ADRs de runtime, policy,
49
- GraphLoop, sandbox, eventos, adapters e UI ainda precisam ser aprovadas.
50
-
51
- ## Atualização da unidade Registry (2026-07-31)
52
-
53
- `packages/core` foi criado com registry em memória, aliases, descoberta filtrada por agente,
54
- validação de input antes do handler, autorização por uma porta de Policy Engine, suporte a
55
- handlers síncronos/assíncronos e `ExecutionResult` normalizado. Não há persistência nem adapter.
56
-
57
- ## Atualização da unidade Policy (2026-07-31)
58
-
59
- `packages/policy` foi criado com default deny, regras por agente, papel, capability, projeto,
60
- ambiente, risco, categoria e prefixo de arquivo; precedência determinística; limites; exigência
61
- de aprovação para risco crítico; e ledger de aprovações em memória. A fronteira Registry → Policy
62
- foi testada sem acoplamento de pacote: o contexto de execução é transportado por uma porta comum.
63
-
64
- O ledger não é persistente nesta etapa. O adapter SQLite e a auditoria durável ficam para o
65
- Runtime Controlado.
66
-
67
- ## Atualização da unidade Runtime (2026-07-31)
68
-
69
- `packages/runtime` foi criado com planner, validator, checkpoint store e memory writer como
70
- portas. O motor controla estados, limites de passos/tokens/arquivos/tempo/retries, execução
71
- sequencial (`maxParallel=1` nesta primeira implementação), pausa, retomada, cancelamento e
72
- validação independente. O estado é em memória; a persistência durável permanece pendente.
73
-
74
- ## Atualização das unidades Events/Scheduler (2026-07-31)
75
-
76
- `packages/events` fornece log append-only por porta, sequência por aggregate, deduplicação por
77
- idempotency key, consumidores com retry e dead-letter. `packages/scheduler` fornece one-shot,
78
- cron UTC de cinco campos, condição, evento, cancelamento, retries, idempotência por slot e limite
79
- de concorrência. As implementações atuais são determinísticas e em memória; `adapter-sqlite` e a
80
- integração de relógio/eventos ficam para a camada de adapters.
81
-
82
- ## Atualização da unidade Context (2026-07-31)
83
-
84
- `packages/context` consulta memória e GraphLoop por portas, descarta evidência obsoleta ou
85
- contradita, ordena por relevância, deduplica por checksum, limita itens e tokens, mantém cache
86
- por checksum e permite expansão sob demanda. `ContextPackage` agora expõe métricas de candidatos,
87
- seleção, deduplicação, cache, tokens usados e tokens não utilizados. Não há busca SQL, diff ou LLM
88
- dentro do Engine.
89
-
90
- ## Atualização da unidade GraphLoop (2026-07-31)
91
-
92
- `packages/graph` fornece nós, arestas, evidências, status, validade temporal, upsert idempotente,
93
- paths, impacto, contradições, agenda e sincronização incremental por checksum de fonte. Arestas
94
- sem endpoints ou evidência são rejeitadas. Imports e links Markdown são extraídos deterministicamente;
95
- CodeGraph continua separado e pode alimentar mutations por adapter. O store atual é em memória.
96
-
97
- ## Atualização das unidades Planner/Validator (2026-07-31)
98
-
99
- `packages/planner` produz planos determinísticos com três etapas mínimas, dependências do grafo,
100
- evidências de contexto, risco, critérios e orçamento dividido. `packages/validator` verifica
101
- checks obrigatórios, escopo de arquivos, critérios de aceitação, contradições, blockers e achados
102
- de segurança, retornando `accepted`, `rejected`, `inconclusive` ou `blocked`. Nenhum dos dois
103
- executa comandos ou depende do implementador.
104
-
105
- ## Próxima unidade verificável
106
-
107
- Criar `packages/orchestration` para Sprint, Task e Handoff, com persistência por porta, estados,
108
- orçamento, retomada, compactação e atualização do GraphLoop.
109
-
110
- ## Atualização da unidade Orchestration (2026-07-31)
111
-
112
- `packages/orchestration` implementa `SprintEngine`, `TaskEngine` e `HandoffEngine` sobre a porta
113
- `OrchestrationStore`. A implementação de referência é em memória e não conhece SQLite, NestJS ou
114
- Next.js. Tasks só avançam quando as dependências estão concluídas; conclusões de Task e Sprint
115
- exigem um `CompletionValidator` independente retornando `accepted`. Handoffs exigem objetivo,
116
- aceite e evidências, removem itens duplicados e rejeitam seções acima dos limites definidos.
117
- `GraphRecorder` registra Sprint, Task e Handoff com relações e evidências, deixando a persistência
118
- do GraphLoop para o adapter apropriado.
119
-
120
- O contrato de Sprint passou a explicitar `risks`, `taskIds` e `evidenceIds`; Task passou a
121
- explicitar `evidenceIds`. A alteração é aditiva e permanece compatível com a direção de
122
- dependências do domínio.
123
-
124
- ## Atualização da unidade Sandbox (2026-07-31)
125
-
126
- `packages/sandbox` fornece `SandboxEngine` com ciclo explícito `create → prepare → execute →
127
- validate → diff → promote/reject → destroy`. O engine depende de `SandboxStore` e
128
- `SandboxBackend`; não executa subprocessos, não acessa filesystem e não importa Git. Promoção
129
- exige validação aceita e um diff pertencente à mesma sessão. Falhas de execução levam a estado
130
- `failed`, e destruição é registrada como estado terminal.
131
-
132
- `packages/adapter-git` implementa o backend inicial por `CommandRunner` e `PatchApplier`. O
133
- adapter traduz worktree, status, execução, `git diff --check`, diff numstat/name-only, aplicação
134
- de patch e remoção de worktree. O adapter não é chamado diretamente pelo domínio e não foi
135
- executado contra o repositório durante os testes; seus comandos foram verificados com runner
136
- determinístico.
137
-
138
- ## Atualização da unidade Adapter SQLite (2026-07-31)
139
-
140
- `packages/adapter-sqlite` fornece `SqliteConnection`, `SqliteMigrationRunner` e repositórios para
141
- Orchestration, Sandbox, Checkpoint, Runtime Run, Event Bus e Auditoria. A migração inicial cria
142
- tabelas de registros JSON, eventos append-only, auditoria e controle de versão. Migrações já
143
- aplicadas são ignoradas por versão; eventos usam chave de idempotência no SQLite. O adapter não
144
- é importado pelo domínio e não escolhe o driver: `better-sqlite3` pode ser ligado na composição
145
- externa por duck typing da conexão.
146
-
147
- ## Atualização da unidade MCP (2026-07-31)
148
-
149
- `packages/mcp` implementa `McpServer` como adaptador fino. As ferramentas delegam para Registry,
150
- Context, GraphLoop, Memory, Task, Handoff e portas de validação/testes; não duplicam regras de
151
- negócio. A identidade do agente é transportada nas operações de Registry e Policy é aplicada ao
152
- handoff por `McpPolicy`. Erros são normalizados em resultados estruturados com código, mensagem e
153
- `isError`.
154
-
155
- O servidor anuncia os sete URIs oficiais de recursos; dados são fornecidos por providers externos.
156
- Quando um provider não existe, o recurso informa explicitamente indisponibilidade. Nenhum dado de
157
- workspace é inventado pelo adapter.
158
-
159
- ## Atualização da unidade Backend Nest (2026-07-31)
160
-
161
- `packages/adapter-nest` fornece a fronteira HTTP verificável: rotas REST para health, capabilities,
162
- contexto, GraphLoop, tasks, handoffs e MCP; correlation IDs; erros HTTP normalizados; SSE por
163
- `EventStream`; autenticação local por porta; e documento OpenAPI 3.1. `apps/server` compõe essa
164
- fronteira em `ForjaServerApplication` e expõe os módulos oficiais.
165
-
166
- NestJS agora está instalado no workspace. `apps/server/src/app.module.ts`,
167
- `forja-nest.module.ts` e `main.ts` fornecem o módulo dinâmico, controller, guard local, SSE e
168
- Swagger reais. Como decorators não são executados pelo Node strip-only, o gate do bootstrap é
169
- `npm run build` seguido de smoke test sobre `dist`; os testes nativos continuam cobrindo o adapter
170
- sem exigir compilação prévia. Nenhuma regra de domínio foi colocada nessa composição.
171
-
172
- ## Atualização da unidade SDK (2026-07-31)
173
-
174
- `packages/sdk` fornece `ForjaSdk` sobre a porta `SdkTransport`, sem importar NestJS, Express ou
175
- um cliente HTTP concreto. A superfície cobre descoberta e execução de capabilities, contexto,
176
- GraphLoop, próxima task, Sprint/Task/Handoff, runtime, approvals, métricas e subscription de
177
- eventos. O SDK preserva headers de autenticação/correlation, serializa queries e transforma
178
- respostas HTTP não-2xx em `SdkError` com status e corpo.
179
-
180
- Rotas ainda não expostas pelo controller atual (runtime, approvals, métricas e criação de
181
- Sprint/Task) permanecem contratos de cliente para a próxima fatia do Control Plane; não foram
182
- tratadas como implementadas apenas por existirem no SDK.
183
-
184
- ## Atualização da unidade Observability/Control Plane (2026-07-31)
185
-
186
- `packages/observability` registra observações por trace, run, agente, task, sprint e capability,
187
- incluindo hashes de entrada, refs de contexto, tokens, duração, custo, ferramentas, arquivos,
188
- comandos, validação, outcome e erro. `ControlPlane` calcula métricas de sucesso, bloqueio,
189
- tokens, duração, custo e cobertura de evidência.
190
-
191
- `packages/adapter-sqlite` agora fornece `SqliteObservationStore`. `packages/adapter-nest` expõe
192
- `/api/control-plane/metrics` e `/api/observability/observations` por `ControlPlanePort`; a
193
- agregação continua fora do controller. Runtime, approvals e CRUD de Sprint/Task ainda exigem
194
- serviços de aplicação específicos.
195
-
196
- ## Atualização da unidade Control Plane operacional (2026-07-31)
197
-
198
- `ControlPlaneServices` agora define portas explícitas para Runtime, Sprint, Task, Handoff e
199
- Approvals. `apps/server/src/main.ts` compõe as engines reais de Sprint/Task/Handoff e
200
- `ApprovalLedger`, e `packages/adapter-nest` expõe as rotas de criação/transição/decisão. Eventos
201
- de observação são convertidos para `InMemoryEventStream` e chegam ao endpoint SSE.
202
-
203
- Runtime possui rotas e portas, mas continua sem composição padrão no bootstrap porque exige um
204
- planner, validator e policy executáveis. Um runtime sem capabilities planejadas ou sem validação
205
- independente seria uma falsa conclusão e permanece bloqueado por decisão arquitetural.
206
-
207
- ## Atualização da unidade Runtime Control Plane (2026-07-31)
208
-
209
- `DefaultRuntimeApplication` agora compõe `RuntimeEngine` com planner determinístico baseado em
210
- etapas explícitas da requisição, validator independente que exige sucesso e evidência em todas as
211
- etapas, `PolicyEngine` read-only/local e transporte de categorias, arquivos, ambiente e budget
212
- para o Registry. Runtime expõe start/get/execute/pause/resume/cancel pelo Control Plane.
213
-
214
- O smoke test executou uma capability `read` em sandbox lógico, terminou `completed/accepted` e
215
- gerou duas observações de Control Plane. Escritas continuam bloqueadas pela política padrão.
216
-
217
- ## Atualização da unidade Evaluation Engine e Plugin SDK (2026-07-31)
218
-
219
- `packages/evals` consome observações do Control Plane e produz `EvaluationReport` versionado com
220
- taxa de sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência,
221
- rollback, uso de contexto, tokens e custo. A avaliação não chama LLM e mantém os IDs das
222
- observações no relatório.
223
-
224
- `packages/plugin-sdk` define manifesto com permissões, capabilities, eventos, migrations,
225
- extensões e compatibilidade. `PluginRegistry` rejeita IDs duplicados e entrega um contexto com
226
- checagem de permissão por operação. O SDK não concede acesso direto a filesystem, processo ou
227
- persistência; dashboard e migrations permanecem metadados até suas políticas de host existirem.
228
-
229
- ## Atualização da unidade Worker e Dashboard boundary (2026-07-31)
230
-
231
- `apps/worker` compõe Event Bus, Scheduler, ObservationStore/Recorder e Evaluation Engine para
232
- permitir processamento assíncrono determinístico. O worker não recebe executor de capability por
233
- fora do Runtime/Policy.
234
-
235
- `apps/dashboard` fornece o view model operacional mínimo: snapshot de métricas/observações e ações
236
- de pausa, cancelamento e aprovação delegadas ao Control Plane. A casca Next.js/React, Query e SSE
237
- remoto ainda é pendência explícita; nenhum componente visual foi inventado como se já existisse.
238
-
239
- ## Atualização da unidade Dashboard Next.js (2026-07-31)
240
-
241
- `apps/dashboard` agora possui distribuição Next.js/React com App Router, layout, Overview, métricas,
242
- observações recentes, atualização manual e revalidação por SSE. A tela usa REST para obter o estado
243
- do Control Plane e não importa persistência, Policy, Runtime ou GraphLoop.
244
-
245
- O build usa `outputFileTracingRoot` na raiz do monorepo e passou em produção. Autenticação de
246
- usuário, TanStack Query, filtros/inspeção visual do GraphLoop e comandos de aprovação ainda são
247
- incrementos pendentes; o dashboard não é considerado completo por esta casca inicial.
248
-
249
- ## Atualização da unidade Dashboard proxy/auth/query (2026-08-01)
250
-
251
- O dashboard agora usa TanStack Query para cache e invalidação do snapshot. Um Route Handler
252
- server-side encaminha somente endpoints allowlisted ao backend; `FORJA_AUTH_TOKEN` não é exposto ao
253
- cliente. SSE apenas invalida o cache remoto.
254
-
255
- `createBearerAuthenticator` foi centralizado no adapter Nest com comparação constante e o bootstrap
256
- usa `FORJA_AUTH_TOKEN` quando definido. O modo sem token continua local/offline, mas implantação
257
- operacional deve configurar autenticação. A suíte passou serialmente; testes paralelos que alteram
258
- PATH/processos continuam sujeitos a interferência ambiental.
259
-
260
- ## Atualização da unidade GraphLoop e Approvals no dashboard (2026-08-01)
261
-
262
- O adapter Nest agora expõe listagem de approvals e o bootstrap conecta a lista do `ApprovalLedger`.
263
- O GraphLoop padrão é composto no MCP do servidor, permitindo consulta de nós e impacto sem LLM.
264
-
265
- O dashboard renderiza os nós retornados, seus status, impacto sob demanda e a fila de approvals.
266
- Decisões de aprovação permanecem fora desta tela até haver identidade/aprovador configurado;
267
- nenhuma relação ou decisão é sintetizada no cliente.
268
-
269
- ## Atualização da unidade Approval server-side (2026-08-01)
270
-
271
- O dashboard agora permite aprovar/rejeitar somente quando `FORJA_APPROVER_ID` está configurado no
272
- servidor. O browser envia apenas a decisão; o proxy valida o enum, injeta identidade e timestamp e
273
- encaminha ao `ApprovalLedger`. Configuração ausente não gera fallback permissivo.
1
+ # Análise de impacto — Fundação ForjaJS 2.0
2
+
3
+ - **Data**: 2026-07-31
4
+ - **Escopo**: visão, arquitetura, contratos públicos e typecheck
5
+ - **Base**: ForjaJS 1.7.3, ADR-0003, ADR-0005, ADR-0019, ADR-0020, ADR-0027
6
+
7
+ ## Contratos afetados
8
+
9
+ | Área | Impacto atual | Decisão nesta fatia |
10
+ | --- | --- | --- |
11
+ | CLI 1.x | Nenhuma API alterada | Mantida como caminho legado |
12
+ | Workspace | Nenhuma alteração de resolução | Mantido conforme ADR-0019 |
13
+ | Memória SQLite | Nenhuma migração | Adapter fica para fase posterior |
14
+ | Handoffs | Nenhuma alteração no router | Contrato 2.0 é aditivo |
15
+ | TypeScript | Novo escopo `packages/**/*` | Typecheck do domínio entra no gate |
16
+ | Publicação npm | Pacotes 2.0 ainda não publicados | Empacotamento será tratado com monorepo |
17
+
18
+ ## Dependências e blast radius
19
+
20
+ O único arquivo existente alterado é `tsconfig.json`, adicionando o diretório de pacotes ao
21
+ typecheck. `lib/`, `scripts/`, `bin/`, registry e CLI não foram alterados. Os novos contratos não
22
+ importam código existente nem dependências externas; portanto não há ciclo ou efeito runtime na
23
+ CLI 1.x.
24
+
25
+ ## Hipóteses
26
+
27
+ - Node 20+ continuará sendo o runtime mínimo do pacote publicado; desenvolvimento pode usar o
28
+ suporte nativo a TypeScript já adotado pelo projeto.
29
+ - `packages/contracts` será a fonte canônica antes de schemas serem derivados para MCP/REST.
30
+ - A escolha de biblioteca de schema (ou implementação própria) permanece aberta; esta fatia usa
31
+ validação determinística mínima sem introduzir dependência.
32
+ - IDs continuarão sendo strings opacas no transporte, representadas por brands no TypeScript.
33
+
34
+ ## Informações ausentes
35
+
36
+ - estratégia final de workspace/package manager;
37
+ - formato de persistência e migrações 2.0;
38
+ - protocolo exato de execução de handlers;
39
+ - biblioteca de schema runtime e biblioteca de testes de integração;
40
+ - política de compatibilidade semântica entre versões de contrato;
41
+ - requisitos de autenticação local do server.
42
+
43
+ ## Riscos
44
+
45
+ - Os contratos ainda não cobrem invariantes de cada bounded context.
46
+ - `unknown` em payloads é intencional nesta etapa, mas cada capability deverá fornecer schema
47
+ específico antes de execução.
48
+ - A existência de apenas dois ADRs 2.0 não fecha a governança completa; ADRs de runtime, policy,
49
+ GraphLoop, sandbox, eventos, adapters e UI ainda precisam ser aprovadas.
50
+
51
+ ## Atualização da unidade Registry (2026-07-31)
52
+
53
+ `packages/core` foi criado com registry em memória, aliases, descoberta filtrada por agente,
54
+ validação de input antes do handler, autorização por uma porta de Policy Engine, suporte a
55
+ handlers síncronos/assíncronos e `ExecutionResult` normalizado. Não há persistência nem adapter.
56
+
57
+ ## Atualização da unidade Policy (2026-07-31)
58
+
59
+ `packages/policy` foi criado com default deny, regras por agente, papel, capability, projeto,
60
+ ambiente, risco, categoria e prefixo de arquivo; precedência determinística; limites; exigência
61
+ de aprovação para risco crítico; e ledger de aprovações em memória. A fronteira Registry → Policy
62
+ foi testada sem acoplamento de pacote: o contexto de execução é transportado por uma porta comum.
63
+
64
+ O ledger não é persistente nesta etapa. O adapter SQLite e a auditoria durável ficam para o
65
+ Runtime Controlado.
66
+
67
+ ## Atualização da unidade Runtime (2026-07-31)
68
+
69
+ `packages/runtime` foi criado com planner, validator, checkpoint store e memory writer como
70
+ portas. O motor controla estados, limites de passos/tokens/arquivos/tempo/retries, execução
71
+ sequencial (`maxParallel=1` nesta primeira implementação), pausa, retomada, cancelamento e
72
+ validação independente. O estado é em memória; a persistência durável permanece pendente.
73
+
74
+ ## Atualização das unidades Events/Scheduler (2026-07-31)
75
+
76
+ `packages/events` fornece log append-only por porta, sequência por aggregate, deduplicação por
77
+ idempotency key, consumidores com retry e dead-letter. `packages/scheduler` fornece one-shot,
78
+ cron UTC de cinco campos, condição, evento, cancelamento, retries, idempotência por slot e limite
79
+ de concorrência. As implementações atuais são determinísticas e em memória; `adapter-sqlite` e a
80
+ integração de relógio/eventos ficam para a camada de adapters.
81
+
82
+ ## Atualização da unidade Context (2026-07-31)
83
+
84
+ `packages/context` consulta memória e GraphLoop por portas, descarta evidência obsoleta ou
85
+ contradita, ordena por relevância, deduplica por checksum, limita itens e tokens, mantém cache
86
+ por checksum e permite expansão sob demanda. `ContextPackage` agora expõe métricas de candidatos,
87
+ seleção, deduplicação, cache, tokens usados e tokens não utilizados. Não há busca SQL, diff ou LLM
88
+ dentro do Engine.
89
+
90
+ ## Atualização da unidade GraphLoop (2026-07-31)
91
+
92
+ `packages/graph` fornece nós, arestas, evidências, status, validade temporal, upsert idempotente,
93
+ paths, impacto, contradições, agenda e sincronização incremental por checksum de fonte. Arestas
94
+ sem endpoints ou evidência são rejeitadas. Imports e links Markdown são extraídos deterministicamente;
95
+ CodeGraph continua separado e pode alimentar mutations por adapter. O store atual é em memória.
96
+
97
+ ## Atualização das unidades Planner/Validator (2026-07-31)
98
+
99
+ `packages/planner` produz planos determinísticos com três etapas mínimas, dependências do grafo,
100
+ evidências de contexto, risco, critérios e orçamento dividido. `packages/validator` verifica
101
+ checks obrigatórios, escopo de arquivos, critérios de aceitação, contradições, blockers e achados
102
+ de segurança, retornando `accepted`, `rejected`, `inconclusive` ou `blocked`. Nenhum dos dois
103
+ executa comandos ou depende do implementador.
104
+
105
+ ## Próxima unidade verificável
106
+
107
+ Criar `packages/orchestration` para Sprint, Task e Handoff, com persistência por porta, estados,
108
+ orçamento, retomada, compactação e atualização do GraphLoop.
109
+
110
+ ## Atualização da unidade Orchestration (2026-07-31)
111
+
112
+ `packages/orchestration` implementa `SprintEngine`, `TaskEngine` e `HandoffEngine` sobre a porta
113
+ `OrchestrationStore`. A implementação de referência é em memória e não conhece SQLite, NestJS ou
114
+ Next.js. Tasks só avançam quando as dependências estão concluídas; conclusões de Task e Sprint
115
+ exigem um `CompletionValidator` independente retornando `accepted`. Handoffs exigem objetivo,
116
+ aceite e evidências, removem itens duplicados e rejeitam seções acima dos limites definidos.
117
+ `GraphRecorder` registra Sprint, Task e Handoff com relações e evidências, deixando a persistência
118
+ do GraphLoop para o adapter apropriado.
119
+
120
+ O contrato de Sprint passou a explicitar `risks`, `taskIds` e `evidenceIds`; Task passou a
121
+ explicitar `evidenceIds`. A alteração é aditiva e permanece compatível com a direção de
122
+ dependências do domínio.
123
+
124
+ ## Atualização da unidade Sandbox (2026-07-31)
125
+
126
+ `packages/sandbox` fornece `SandboxEngine` com ciclo explícito `create → prepare → execute →
127
+ validate → diff → promote/reject → destroy`. O engine depende de `SandboxStore` e
128
+ `SandboxBackend`; não executa subprocessos, não acessa filesystem e não importa Git. Promoção
129
+ exige validação aceita e um diff pertencente à mesma sessão. Falhas de execução levam a estado
130
+ `failed`, e destruição é registrada como estado terminal.
131
+
132
+ `packages/adapter-git` implementa o backend inicial por `CommandRunner` e `PatchApplier`. O
133
+ adapter traduz worktree, status, execução, `git diff --check`, diff numstat/name-only, aplicação
134
+ de patch e remoção de worktree. O adapter não é chamado diretamente pelo domínio e não foi
135
+ executado contra o repositório durante os testes; seus comandos foram verificados com runner
136
+ determinístico.
137
+
138
+ ## Atualização da unidade Adapter SQLite (2026-07-31)
139
+
140
+ `packages/adapter-sqlite` fornece `SqliteConnection`, `SqliteMigrationRunner` e repositórios para
141
+ Orchestration, Sandbox, Checkpoint, Runtime Run, Event Bus e Auditoria. A migração inicial cria
142
+ tabelas de registros JSON, eventos append-only, auditoria e controle de versão. Migrações já
143
+ aplicadas são ignoradas por versão; eventos usam chave de idempotência no SQLite. O adapter não
144
+ é importado pelo domínio e não escolhe o driver: `better-sqlite3` pode ser ligado na composição
145
+ externa por duck typing da conexão.
146
+
147
+ ## Atualização da unidade MCP (2026-07-31)
148
+
149
+ `packages/mcp` implementa `McpServer` como adaptador fino. As ferramentas delegam para Registry,
150
+ Context, GraphLoop, Memory, Task, Handoff e portas de validação/testes; não duplicam regras de
151
+ negócio. A identidade do agente é transportada nas operações de Registry e Policy é aplicada ao
152
+ handoff por `McpPolicy`. Erros são normalizados em resultados estruturados com código, mensagem e
153
+ `isError`.
154
+
155
+ O servidor anuncia os sete URIs oficiais de recursos; dados são fornecidos por providers externos.
156
+ Quando um provider não existe, o recurso informa explicitamente indisponibilidade. Nenhum dado de
157
+ workspace é inventado pelo adapter.
158
+
159
+ ## Atualização da unidade Backend Nest (2026-07-31)
160
+
161
+ `packages/adapter-nest` fornece a fronteira HTTP verificável: rotas REST para health, capabilities,
162
+ contexto, GraphLoop, tasks, handoffs e MCP; correlation IDs; erros HTTP normalizados; SSE por
163
+ `EventStream`; autenticação local por porta; e documento OpenAPI 3.1. `apps/server` compõe essa
164
+ fronteira em `ForjaServerApplication` e expõe os módulos oficiais.
165
+
166
+ NestJS agora está instalado no workspace. `apps/server/src/app.module.ts`,
167
+ `forja-nest.module.ts` e `main.ts` fornecem o módulo dinâmico, controller, guard local, SSE e
168
+ Swagger reais. Como decorators não são executados pelo Node strip-only, o gate do bootstrap é
169
+ `npm run build` seguido de smoke test sobre `dist`; os testes nativos continuam cobrindo o adapter
170
+ sem exigir compilação prévia. Nenhuma regra de domínio foi colocada nessa composição.
171
+
172
+ ## Atualização da unidade SDK (2026-07-31)
173
+
174
+ `packages/sdk` fornece `ForjaSdk` sobre a porta `SdkTransport`, sem importar NestJS, Express ou
175
+ um cliente HTTP concreto. A superfície cobre descoberta e execução de capabilities, contexto,
176
+ GraphLoop, próxima task, Sprint/Task/Handoff, runtime, approvals, métricas e subscription de
177
+ eventos. O SDK preserva headers de autenticação/correlation, serializa queries e transforma
178
+ respostas HTTP não-2xx em `SdkError` com status e corpo.
179
+
180
+ Rotas ainda não expostas pelo controller atual (runtime, approvals, métricas e criação de
181
+ Sprint/Task) permanecem contratos de cliente para a próxima fatia do Control Plane; não foram
182
+ tratadas como implementadas apenas por existirem no SDK.
183
+
184
+ ## Atualização da unidade Observability/Control Plane (2026-07-31)
185
+
186
+ `packages/observability` registra observações por trace, run, agente, task, sprint e capability,
187
+ incluindo hashes de entrada, refs de contexto, tokens, duração, custo, ferramentas, arquivos,
188
+ comandos, validação, outcome e erro. `ControlPlane` calcula métricas de sucesso, bloqueio,
189
+ tokens, duração, custo e cobertura de evidência.
190
+
191
+ `packages/adapter-sqlite` agora fornece `SqliteObservationStore`. `packages/adapter-nest` expõe
192
+ `/api/control-plane/metrics` e `/api/observability/observations` por `ControlPlanePort`; a
193
+ agregação continua fora do controller. Runtime, approvals e CRUD de Sprint/Task ainda exigem
194
+ serviços de aplicação específicos.
195
+
196
+ ## Atualização da unidade Control Plane operacional (2026-07-31)
197
+
198
+ `ControlPlaneServices` agora define portas explícitas para Runtime, Sprint, Task, Handoff e
199
+ Approvals. `apps/server/src/main.ts` compõe as engines reais de Sprint/Task/Handoff e
200
+ `ApprovalLedger`, e `packages/adapter-nest` expõe as rotas de criação/transição/decisão. Eventos
201
+ de observação são convertidos para `InMemoryEventStream` e chegam ao endpoint SSE.
202
+
203
+ Runtime possui rotas e portas, mas continua sem composição padrão no bootstrap porque exige um
204
+ planner, validator e policy executáveis. Um runtime sem capabilities planejadas ou sem validação
205
+ independente seria uma falsa conclusão e permanece bloqueado por decisão arquitetural.
206
+
207
+ ## Atualização da unidade Runtime Control Plane (2026-07-31)
208
+
209
+ `DefaultRuntimeApplication` agora compõe `RuntimeEngine` com planner determinístico baseado em
210
+ etapas explícitas da requisição, validator independente que exige sucesso e evidência em todas as
211
+ etapas, `PolicyEngine` read-only/local e transporte de categorias, arquivos, ambiente e budget
212
+ para o Registry. Runtime expõe start/get/execute/pause/resume/cancel pelo Control Plane.
213
+
214
+ O smoke test executou uma capability `read` em sandbox lógico, terminou `completed/accepted` e
215
+ gerou duas observações de Control Plane. Escritas continuam bloqueadas pela política padrão.
216
+
217
+ ## Atualização da unidade Evaluation Engine e Plugin SDK (2026-07-31)
218
+
219
+ `packages/evals` consome observações do Control Plane e produz `EvaluationReport` versionado com
220
+ taxa de sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência,
221
+ rollback, uso de contexto, tokens e custo. A avaliação não chama LLM e mantém os IDs das
222
+ observações no relatório.
223
+
224
+ `packages/plugin-sdk` define manifesto com permissões, capabilities, eventos, migrations,
225
+ extensões e compatibilidade. `PluginRegistry` rejeita IDs duplicados e entrega um contexto com
226
+ checagem de permissão por operação. O SDK não concede acesso direto a filesystem, processo ou
227
+ persistência; dashboard e migrations permanecem metadados até suas políticas de host existirem.
228
+
229
+ ## Atualização da unidade Worker e Dashboard boundary (2026-07-31)
230
+
231
+ `apps/worker` compõe Event Bus, Scheduler, ObservationStore/Recorder e Evaluation Engine para
232
+ permitir processamento assíncrono determinístico. O worker não recebe executor de capability por
233
+ fora do Runtime/Policy.
234
+
235
+ `apps/dashboard` fornece o view model operacional mínimo: snapshot de métricas/observações e ações
236
+ de pausa, cancelamento e aprovação delegadas ao Control Plane. A casca Next.js/React, Query e SSE
237
+ remoto ainda é pendência explícita; nenhum componente visual foi inventado como se já existisse.
238
+
239
+ ## Atualização da unidade Dashboard Next.js (2026-07-31)
240
+
241
+ `apps/dashboard` agora possui distribuição Next.js/React com App Router, layout, Overview, métricas,
242
+ observações recentes, atualização manual e revalidação por SSE. A tela usa REST para obter o estado
243
+ do Control Plane e não importa persistência, Policy, Runtime ou GraphLoop.
244
+
245
+ O build usa `outputFileTracingRoot` na raiz do monorepo e passou em produção. Autenticação de
246
+ usuário, TanStack Query, filtros/inspeção visual do GraphLoop e comandos de aprovação ainda são
247
+ incrementos pendentes; o dashboard não é considerado completo por esta casca inicial.
248
+
249
+ ## Atualização da unidade Dashboard proxy/auth/query (2026-08-01)
250
+
251
+ O dashboard agora usa TanStack Query para cache e invalidação do snapshot. Um Route Handler
252
+ server-side encaminha somente endpoints allowlisted ao backend; `FORJA_AUTH_TOKEN` não é exposto ao
253
+ cliente. SSE apenas invalida o cache remoto.
254
+
255
+ `createBearerAuthenticator` foi centralizado no adapter Nest com comparação constante e o bootstrap
256
+ usa `FORJA_AUTH_TOKEN` quando definido. O modo sem token continua local/offline, mas implantação
257
+ operacional deve configurar autenticação. A suíte passou serialmente; testes paralelos que alteram
258
+ PATH/processos continuam sujeitos a interferência ambiental.
259
+
260
+ ## Atualização da unidade GraphLoop e Approvals no dashboard (2026-08-01)
261
+
262
+ O adapter Nest agora expõe listagem de approvals e o bootstrap conecta a lista do `ApprovalLedger`.
263
+ O GraphLoop padrão é composto no MCP do servidor, permitindo consulta de nós e impacto sem LLM.
264
+
265
+ O dashboard renderiza os nós retornados, seus status, impacto sob demanda e a fila de approvals.
266
+ Decisões de aprovação permanecem fora desta tela até haver identidade/aprovador configurado;
267
+ nenhuma relação ou decisão é sintetizada no cliente.
268
+
269
+ ## Atualização da unidade Approval server-side (2026-08-01)
270
+
271
+ O dashboard agora permite aprovar/rejeitar somente quando `FORJA_APPROVER_ID` está configurado no
272
+ servidor. O browser envia apenas a decisão; o proxy valida o enum, injeta identidade e timestamp e
273
+ encaminha ao `ApprovalLedger`. Configuração ausente não gera fallback permissivo.