forjajs 2.0.4 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (825) hide show
  1. package/.claude/agents/context-engineer.md +19 -25
  2. package/.claude/agents/governance.md +19 -55
  3. package/.claude/agents/marketing.md +19 -24
  4. package/.claude/agents/orchestrator.md +19 -31
  5. package/.claude/agents/product.md +19 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +19 -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 +93 -87
  12. package/.github/copilot-instructions.md +93 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +93 -87
  15. package/AGENTS.md +137 -134
  16. package/CHANGELOG.md +656 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +68 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +17 -1
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/release.js +3 -0
  353. package/dist/lib/core/risk-collect.d.ts +19 -0
  354. package/dist/lib/core/risk-collect.js +173 -0
  355. package/dist/lib/drift-sentinel.d.ts +59 -0
  356. package/dist/lib/drift-sentinel.js +126 -0
  357. package/dist/lib/generators/memory-generator.js +691 -691
  358. package/dist/lib/generators/nest-generator.js +412 -398
  359. package/dist/lib/generators/readme-generator.js +180 -180
  360. package/dist/lib/governance-report.js +39 -39
  361. package/dist/lib/llm/codex-output.d.ts +12 -0
  362. package/dist/lib/llm/codex-output.js +56 -0
  363. package/dist/lib/llm/context.d.ts +5 -0
  364. package/dist/lib/llm/context.js +17 -0
  365. package/dist/lib/llm/session.d.ts +18 -0
  366. package/dist/lib/llm/session.js +34 -0
  367. package/dist/lib/llm/validation.d.ts +37 -0
  368. package/dist/lib/llm/validation.js +88 -0
  369. package/dist/lib/workspace.js +29 -29
  370. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  371. package/dist/packages/adapter-git/src/index.js +11 -6
  372. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  373. package/dist/packages/adapter-nest/src/index.js +26 -1
  374. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  375. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  376. package/dist/packages/contracts/src/index.d.ts +33 -0
  377. package/dist/packages/contracts/src/index.js +13 -0
  378. package/dist/packages/core/src/index.d.ts +12 -0
  379. package/dist/packages/core/src/index.js +29 -0
  380. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  381. package/dist/packages/engineering/architecture/src/index.js +131 -0
  382. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  383. package/dist/packages/engineering/evidence/src/index.js +31 -0
  384. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  385. package/dist/packages/engineering/identity/src/index.js +88 -0
  386. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  387. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  388. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  389. package/dist/packages/engineering/provenance/src/index.js +21 -0
  390. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  391. package/dist/packages/engineering/risk/src/index.js +120 -0
  392. package/dist/packages/evals/src/index.js +6 -0
  393. package/dist/packages/graph/src/index.d.ts +23 -1
  394. package/dist/packages/graph/src/index.js +88 -15
  395. package/dist/packages/llm/src/index.d.ts +8 -1
  396. package/dist/packages/llm/src/index.js +64 -7
  397. package/dist/packages/mcp/src/index.js +27 -8
  398. package/dist/packages/orchestration/src/index.d.ts +11 -1
  399. package/dist/packages/orchestration/src/index.js +34 -7
  400. package/dist/packages/policy/src/index.d.ts +40 -0
  401. package/dist/packages/policy/src/index.js +39 -4
  402. package/dist/packages/runtime/src/index.js +3 -0
  403. package/dist/packages/sandbox/src/index.d.ts +47 -0
  404. package/dist/packages/sandbox/src/index.js +59 -0
  405. package/dist/packages/validator/src/index.d.ts +8 -0
  406. package/dist/packages/validator/src/index.js +21 -6
  407. package/dist/scripts/adr.d.ts +17 -0
  408. package/dist/scripts/adr.js +152 -0
  409. package/dist/scripts/agent-harness.js +72 -64
  410. package/dist/scripts/agent-router.js +20 -20
  411. package/dist/scripts/agent.d.ts +27 -0
  412. package/dist/scripts/agent.js +249 -0
  413. package/dist/scripts/architecture.d.ts +16 -0
  414. package/dist/scripts/architecture.js +186 -0
  415. package/dist/scripts/build-smart-context.js +22 -22
  416. package/dist/scripts/compress-memory.js +8 -8
  417. package/dist/scripts/context-ops.js +29 -29
  418. package/dist/scripts/cost-economy.d.ts +2 -0
  419. package/dist/scripts/cost-economy.js +79 -0
  420. package/dist/scripts/demo-autonomy.js +13 -6
  421. package/dist/scripts/dev.js +13 -13
  422. package/dist/scripts/drift-check.d.ts +17 -0
  423. package/dist/scripts/drift-check.js +63 -0
  424. package/dist/scripts/engineer.d.ts +20 -0
  425. package/dist/scripts/engineer.js +208 -0
  426. package/dist/scripts/evidence.d.ts +12 -0
  427. package/dist/scripts/evidence.js +55 -0
  428. package/dist/scripts/extract-global-knowledge.js +5 -5
  429. package/dist/scripts/gates.d.ts +6 -2
  430. package/dist/scripts/gates.js +14 -4
  431. package/dist/scripts/generate-dashboard.js +11 -11
  432. package/dist/scripts/incident.d.ts +19 -0
  433. package/dist/scripts/incident.js +103 -0
  434. package/dist/scripts/llm-fit.js +85 -9
  435. package/dist/scripts/memory-schema.js +48 -48
  436. package/dist/scripts/provenance.d.ts +14 -0
  437. package/dist/scripts/provenance.js +114 -0
  438. package/dist/scripts/query-universal-memory.js +13 -13
  439. package/dist/scripts/risk.d.ts +15 -0
  440. package/dist/scripts/risk.js +81 -0
  441. package/dist/scripts/simulate.d.ts +20 -0
  442. package/dist/scripts/simulate.js +150 -0
  443. package/dist/scripts/sprint-manager.js +39 -39
  444. package/dist/scripts/sync-universal-memory.js +44 -44
  445. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  446. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  447. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  448. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  449. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  450. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  451. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  452. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  453. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  454. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  455. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  456. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  457. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  458. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  459. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  460. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  461. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  462. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  463. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  464. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  465. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  466. package/docs/agent-harnesses.md +149 -149
  467. package/docs/agent-operating-contract.md +26 -0
  468. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  469. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  470. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  471. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  472. package/docs/archive/FASE2-SUMMARY.md +263 -263
  473. package/docs/archive/FASE3-PROGRESS.md +355 -355
  474. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  475. package/docs/archive/INDICE-MASTER.md +282 -282
  476. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  477. package/docs/archive/README-REFINAMENTO.md +293 -293
  478. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  479. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  480. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  481. package/docs/archive/START-HERE.md +319 -319
  482. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  483. package/docs/archive/examples/v1/AGENTS.md +10 -10
  484. package/docs/archive/examples/v1/README.md +36 -36
  485. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  486. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  487. package/docs/archive/examples/v1/backend/package.json +42 -42
  488. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  489. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  490. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  491. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  492. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  493. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  494. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  495. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  496. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  497. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  498. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  499. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  501. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  502. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  503. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  504. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  505. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  506. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  507. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  508. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  509. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  510. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  511. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  512. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  513. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  514. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  515. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  516. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  517. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  518. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  519. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  520. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  521. package/docs/archive/examples/v2/AGENTS.md +16 -16
  522. package/docs/archive/examples/v2/README.md +35 -35
  523. package/docs/archive/examples/v2/agents/README.md +3 -3
  524. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  525. package/docs/archive/examples/v2/agents/dba.md +4 -4
  526. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  527. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  528. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  529. package/docs/archive/examples/v2/agents/security.md +4 -4
  530. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  531. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  532. package/docs/archive/examples/v2/backend/package.json +42 -42
  533. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  534. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  535. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  536. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  537. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  538. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  539. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  540. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  541. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  542. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  543. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  544. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  545. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  547. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  548. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  549. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  550. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  551. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  552. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  553. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  554. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  555. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  556. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  557. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  558. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  559. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  560. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  561. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  562. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  563. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  564. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  565. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  566. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  567. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  568. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  569. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  570. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  571. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  572. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  573. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  574. package/docs/archive/examples/v2/memory/README.md +8 -8
  575. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  576. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  577. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  578. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  579. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  580. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  581. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  582. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  583. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  584. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  585. package/docs/capacidades-externas.md +86 -86
  586. package/docs/cli-first-operacao.md +74 -74
  587. package/docs/dev-workflow.md +421 -421
  588. package/docs/examples.md +546 -546
  589. package/docs/fluxo.md +103 -103
  590. package/docs/glossary.md +453 -453
  591. package/docs/init-project.md +457 -457
  592. package/docs/llm-evolution.md +51 -0
  593. package/docs/llm-fit-loop.md +134 -5
  594. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  595. package/docs/personas/architect/README.md +333 -333
  596. package/docs/personas/developer/README.md +371 -371
  597. package/docs/personas/executive/README.md +172 -172
  598. package/docs/personas/qa/README.md +350 -350
  599. package/docs/processo-projeto.md +138 -138
  600. package/docs/publishing.md +49 -377
  601. package/docs/quick-reference.md +409 -409
  602. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  603. package/docs/structure.md +360 -360
  604. package/docs/token-optimization.md +502 -502
  605. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  606. package/memory/00-global/mission.md +15 -15
  607. package/memory/00-global/shared-knowledge.md +8 -8
  608. package/memory/00-global/standards.md +47 -47
  609. package/memory/10-product/personas.md +21 -21
  610. package/memory/10-product/vision.md +27 -27
  611. package/memory/30-projects/README.md +15 -15
  612. package/memory/40-delivery/backlog.md +15 -15
  613. package/memory/40-delivery/current-sprint.md +20 -20
  614. package/memory/50-orchestration/gsd-harness.md +55 -55
  615. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  616. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  617. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  618. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  619. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  620. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  621. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  622. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  623. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  624. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  625. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  626. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  627. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  628. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  630. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  631. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  632. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  633. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  634. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  635. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  637. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  638. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  639. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  640. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  641. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  642. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  643. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  644. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  645. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  646. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  647. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  648. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  649. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  650. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  651. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  652. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  653. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  654. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  655. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  656. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  657. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  658. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  659. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  660. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  661. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  662. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  663. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  664. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  665. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  666. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  667. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  668. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  669. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  670. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  671. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  672. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  673. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  674. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  675. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  676. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  677. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  678. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  679. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  680. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  681. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  682. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  683. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  684. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  685. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  686. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  687. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  688. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  689. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  690. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  691. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  692. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  693. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  694. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  695. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  696. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  697. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  698. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  699. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  700. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  701. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  702. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  703. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  704. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  705. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  706. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  707. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  708. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  709. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  710. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  711. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  712. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  713. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  714. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  715. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  716. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  717. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  718. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  719. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  720. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  721. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  722. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  723. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  724. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  725. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  726. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  727. package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
  728. package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
  729. package/memory/90-decisions/_template.md +28 -28
  730. package/package.json +159 -157
  731. package/prompts/context-engineer-agent.md +13 -19
  732. package/prompts/governance-agent.md +13 -16
  733. package/prompts/marketing-agent.md +13 -13
  734. package/prompts/orchestrator-agent.md +13 -18
  735. package/prompts/product-agent.md +13 -13
  736. package/prompts/sdd-architect-agent.md +13 -20
  737. package/skills/MANIFEST.json +10 -0
  738. package/skills/llm-provider-routing/SKILL.md +18 -0
  739. package/specs/README.md +70 -70
  740. package/specs/_templates/plan.md +50 -43
  741. package/specs/_templates/spec.md +50 -43
  742. package/specs/_templates/tasks.md +39 -32
  743. package/specs/agent-identity-reputation/plan.md +133 -0
  744. package/specs/agent-identity-reputation/spec.md +125 -0
  745. package/specs/agent-identity-reputation/tasks.md +51 -0
  746. package/specs/agent-instructions-v4/plan.md +8 -0
  747. package/specs/agent-instructions-v4/spec.md +21 -0
  748. package/specs/agent-instructions-v4/tasks.md +12 -0
  749. package/specs/agent-runtime-monitoring/plan.md +78 -0
  750. package/specs/agent-runtime-monitoring/spec.md +92 -0
  751. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  752. package/specs/ai-code-provenance/plan.md +71 -0
  753. package/specs/ai-code-provenance/spec.md +97 -0
  754. package/specs/ai-code-provenance/tasks.md +39 -0
  755. package/specs/architecture-constitution/plan.md +110 -0
  756. package/specs/architecture-constitution/spec.md +114 -0
  757. package/specs/architecture-constitution/tasks.md +58 -0
  758. package/specs/change-risk-engine/plan.md +130 -0
  759. package/specs/change-risk-engine/spec.md +119 -0
  760. package/specs/change-risk-engine/tasks.md +72 -0
  761. package/specs/clean-arch-boilerplate/plan.md +137 -137
  762. package/specs/clean-arch-boilerplate/spec.md +121 -121
  763. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  764. package/specs/cli-first-operacao/plan.md +53 -53
  765. package/specs/cli-first-operacao/spec.md +53 -53
  766. package/specs/cli-first-operacao/tasks.md +53 -53
  767. package/specs/code-context/spec.md +56 -56
  768. package/specs/coerencia-do-sistema/plan.md +155 -155
  769. package/specs/coerencia-do-sistema/spec.md +123 -123
  770. package/specs/coerencia-do-sistema/tasks.md +115 -115
  771. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  772. package/specs/dev-token-assets-db/plan.md +71 -71
  773. package/specs/dev-token-assets-db/spec.md +58 -58
  774. package/specs/dev-token-assets-db/tasks.md +58 -58
  775. package/specs/doctor-do-nucleo/plan.md +165 -165
  776. package/specs/doctor-do-nucleo/spec.md +139 -139
  777. package/specs/doctor-do-nucleo/tasks.md +172 -172
  778. package/specs/drift-sentinel/spec.md +117 -0
  779. package/specs/engineer-facade-extension/plan.md +71 -0
  780. package/specs/engineer-facade-extension/spec.md +98 -0
  781. package/specs/engineer-facade-extension/tasks.md +36 -0
  782. package/specs/engineering-evidence-ledger/plan.md +121 -0
  783. package/specs/engineering-evidence-ledger/spec.md +90 -0
  784. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  785. package/specs/engineering-graph-extensions/plan.md +92 -0
  786. package/specs/engineering-graph-extensions/spec.md +101 -0
  787. package/specs/engineering-graph-extensions/tasks.md +60 -0
  788. package/specs/engineering-intelligence/spec.md +177 -0
  789. package/specs/forja-core/spec.md +71 -71
  790. package/specs/gates/spec.md +63 -63
  791. package/specs/governanca-visivel/plan.md +122 -122
  792. package/specs/governanca-visivel/spec.md +112 -112
  793. package/specs/governanca-visivel/tasks.md +60 -60
  794. package/specs/harness-codegraph/spec.md +71 -71
  795. package/specs/learning-loop-incidents/plan.md +59 -0
  796. package/specs/learning-loop-incidents/spec.md +93 -0
  797. package/specs/learning-loop-incidents/tasks.md +36 -0
  798. package/specs/llm-integration-v2/plan.md +55 -0
  799. package/specs/llm-integration-v2/spec.md +61 -0
  800. package/specs/llm-integration-v2/tasks.md +28 -0
  801. package/specs/llm-resume-validation/plan.md +50 -0
  802. package/specs/llm-resume-validation/spec.md +35 -0
  803. package/specs/llm-resume-validation/tasks.md +19 -0
  804. package/specs/memory-audit/spec.md +54 -54
  805. package/specs/orchestrate/spec.md +108 -108
  806. package/specs/orchestration-coherent/spec.md +95 -95
  807. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  808. package/specs/predictive-change-simulation/plan.md +109 -0
  809. package/specs/predictive-change-simulation/spec.md +107 -0
  810. package/specs/predictive-change-simulation/tasks.md +41 -0
  811. package/specs/project-smoke/spec.md +96 -96
  812. package/specs/project-upgrade/spec.md +58 -58
  813. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  814. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  815. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  816. package/specs/release-auditor-health/spec.md +23 -23
  817. package/specs/release-gate/plan.md +174 -174
  818. package/specs/release-gate/spec.md +122 -122
  819. package/specs/release-gate/tasks.md +183 -183
  820. package/specs/smart-agent-routing/plan.md +55 -0
  821. package/specs/smart-agent-routing/spec.md +85 -0
  822. package/specs/smart-agent-routing/tasks.md +26 -0
  823. package/specs/ts-migration/plan.md +200 -200
  824. package/specs/ts-migration/spec.md +119 -119
  825. package/specs/ts-migration/tasks.md +110 -110
@@ -1,29 +1,29 @@
1
- # ADR-0042: Planner determinístico e Validator independente
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: planner, validation, evidence, governance
7
-
8
- ## Contexto
9
-
10
- O agente que implementa uma tarefa não pode ser a única fonte de plano ou de veredito. O Forja
11
- precisa transformar objetivos em etapas pequenas e impedir conclusão baseada apenas em declaração
12
- de sucesso.
13
-
14
- ## Decisão
15
-
16
- O Planner cria etapas determinísticas com critérios, arquivos permitidos, dependências, risco,
17
- evidências e orçamento dividido. O Validator recebe o plano e resultados externos de build, testes,
18
- lint e typecheck, além de critérios, escopo, contradições, blockers e achados de segurança. Ele
19
- retorna `accepted`, `rejected`, `inconclusive` ou `blocked`; checks ausentes produzem `inconclusive`
20
- e falhas não podem produzir `accepted`.
21
-
22
- Planner e Validator não executam comandos nem importam frameworks. Adapters fornecem os resultados
23
- observáveis.
24
-
25
- ## Rastreamento
26
-
27
- - Implementação: `packages/planner/src/index.ts`, `packages/validator/src/index.ts`
28
- - Testes: `test/planner-validator.test.js`
29
- - Relacionadas: ADR-0038, ADR-0041
1
+ # ADR-0042: Planner determinístico e Validator independente
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: planner, validation, evidence, governance
7
+
8
+ ## Contexto
9
+
10
+ O agente que implementa uma tarefa não pode ser a única fonte de plano ou de veredito. O Forja
11
+ precisa transformar objetivos em etapas pequenas e impedir conclusão baseada apenas em declaração
12
+ de sucesso.
13
+
14
+ ## Decisão
15
+
16
+ O Planner cria etapas determinísticas com critérios, arquivos permitidos, dependências, risco,
17
+ evidências e orçamento dividido. O Validator recebe o plano e resultados externos de build, testes,
18
+ lint e typecheck, além de critérios, escopo, contradições, blockers e achados de segurança. Ele
19
+ retorna `accepted`, `rejected`, `inconclusive` ou `blocked`; checks ausentes produzem `inconclusive`
20
+ e falhas não podem produzir `accepted`.
21
+
22
+ Planner e Validator não executam comandos nem importam frameworks. Adapters fornecem os resultados
23
+ observáveis.
24
+
25
+ ## Rastreamento
26
+
27
+ - Implementação: `packages/planner/src/index.ts`, `packages/validator/src/index.ts`
28
+ - Testes: `test/planner-validator.test.js`
29
+ - Relacionadas: ADR-0038, ADR-0041
@@ -1,16 +1,16 @@
1
- # ADR-0043 — Sprint, Task e Handoff como engines de domínio
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O runtime precisa de unidades retomáveis, rastreáveis e pequenas para organizar execução agêntica.
6
- - **Decisão**: Implementar `SprintEngine`, `TaskEngine` e `HandoffEngine` em `packages/orchestration`, usando `OrchestrationStore`, `CompletionValidator` e `GraphRecorder` como portas. A implementação em memória serve como referência determinística; persistência durável e adapters ficam fora do domínio.
7
- - **Regras**:
8
- - Task só pode iniciar em Sprint ativo e suas dependências devem estar concluídas para aparecer em `next`.
9
- - Task e Sprint não podem ser concluídos sem validação independente com status `accepted`.
10
- - Handoff é um resumo estruturado, com evidências obrigatórias, deduplicação e limites de compactação; transcrições completas não são aceitas.
11
- - Atualizações do GraphLoop recebem relações e evidências por uma porta, sem importar o pacote GraphLoop.
12
- - **Alternativas rejeitadas**:
13
- - Persistir diretamente em SQLite: violaria a independência do domínio e anteciparia o adapter.
14
- - Permitir que o executor declare conclusão: permitiria falsa conclusão sem gate de validação.
15
- - **Consequências**: Os adapters futuros devem implementar `OrchestrationStore`, e o GraphLoop deve consumir os registros de `GraphRecorder`. A API de validação permanece explícita para permitir testes e validators independentes.
16
- - **Evidências**: `test/orchestration.test.js`; `npm run types:check`; `git diff --check`.
1
+ # ADR-0043 — Sprint, Task e Handoff como engines de domínio
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O runtime precisa de unidades retomáveis, rastreáveis e pequenas para organizar execução agêntica.
6
+ - **Decisão**: Implementar `SprintEngine`, `TaskEngine` e `HandoffEngine` em `packages/orchestration`, usando `OrchestrationStore`, `CompletionValidator` e `GraphRecorder` como portas. A implementação em memória serve como referência determinística; persistência durável e adapters ficam fora do domínio.
7
+ - **Regras**:
8
+ - Task só pode iniciar em Sprint ativo e suas dependências devem estar concluídas para aparecer em `next`.
9
+ - Task e Sprint não podem ser concluídos sem validação independente com status `accepted`.
10
+ - Handoff é um resumo estruturado, com evidências obrigatórias, deduplicação e limites de compactação; transcrições completas não são aceitas.
11
+ - Atualizações do GraphLoop recebem relações e evidências por uma porta, sem importar o pacote GraphLoop.
12
+ - **Alternativas rejeitadas**:
13
+ - Persistir diretamente em SQLite: violaria a independência do domínio e anteciparia o adapter.
14
+ - Permitir que o executor declare conclusão: permitiria falsa conclusão sem gate de validação.
15
+ - **Consequências**: Os adapters futuros devem implementar `OrchestrationStore`, e o GraphLoop deve consumir os registros de `GraphRecorder`. A API de validação permanece explícita para permitir testes e validators independentes.
16
+ - **Evidências**: `test/orchestration.test.js`; `npm run types:check`; `git diff --check`.
@@ -1,19 +1,19 @@
1
- # ADR-0044 — Sandbox por worktree com promoção explícita
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Execuções agênticas precisam de isolamento, diff auditável, validação independente e descarte seguro antes de afetar o workspace principal.
6
- - **Decisão**: `packages/sandbox` implementa o ciclo de sessão por portas. A implementação inicial de backend é Git worktree em `packages/adapter-git`, usando `CommandRunner` e `PatchApplier` injetados.
7
- - **Regras**:
8
- - uma sessão só executa após `prepare`;
9
- - `validate` deve retornar `accepted` para habilitar `diff` e `promote`;
10
- - `promote` exige diff com o mesmo `sessionId` e checksum não vazio;
11
- - rejeição e destruição são operações explícitas e auditáveis;
12
- - o domínio não importa Git, filesystem, subprocessos ou Docker;
13
- - comandos e aplicação de patch pertencem ao adapter e devem passar por policy na camada de aplicação.
14
- - **Alternativas rejeitadas**:
15
- - executar diretamente no workspace: elimina isolamento e dificulta rollback;
16
- - promoção automática após comando bem-sucedido: sucesso do processo não é validação do resultado;
17
- - acoplar o domínio a `child_process`: inviabiliza backend substituível e testes determinísticos.
18
- - **Consequências**: O adapter SQLite deverá persistir sessões, execuções e diffs; a camada de aplicação deverá autorizar operações críticas antes de chamar promoção ou destruição forçada.
19
- - **Evidências**: `test/sandbox.test.js`, `test/adapter-git.test.js`, `npm run types:check`, `git diff --check`.
1
+ # ADR-0044 — Sandbox por worktree com promoção explícita
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Execuções agênticas precisam de isolamento, diff auditável, validação independente e descarte seguro antes de afetar o workspace principal.
6
+ - **Decisão**: `packages/sandbox` implementa o ciclo de sessão por portas. A implementação inicial de backend é Git worktree em `packages/adapter-git`, usando `CommandRunner` e `PatchApplier` injetados.
7
+ - **Regras**:
8
+ - uma sessão só executa após `prepare`;
9
+ - `validate` deve retornar `accepted` para habilitar `diff` e `promote`;
10
+ - `promote` exige diff com o mesmo `sessionId` e checksum não vazio;
11
+ - rejeição e destruição são operações explícitas e auditáveis;
12
+ - o domínio não importa Git, filesystem, subprocessos ou Docker;
13
+ - comandos e aplicação de patch pertencem ao adapter e devem passar por policy na camada de aplicação.
14
+ - **Alternativas rejeitadas**:
15
+ - executar diretamente no workspace: elimina isolamento e dificulta rollback;
16
+ - promoção automática após comando bem-sucedido: sucesso do processo não é validação do resultado;
17
+ - acoplar o domínio a `child_process`: inviabiliza backend substituível e testes determinísticos.
18
+ - **Consequências**: O adapter SQLite deverá persistir sessões, execuções e diffs; a camada de aplicação deverá autorizar operações críticas antes de chamar promoção ou destruição forçada.
19
+ - **Evidências**: `test/sandbox.test.js`, `test/adapter-git.test.js`, `npm run types:check`, `git diff --check`.
@@ -1,19 +1,19 @@
1
- # ADR-0045 — Adapter SQLite por porta e migrações idempotentes
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O ForjaJS precisa sobreviver a reinícios e manter eventos, checkpoints, sessões, entidades de sprint e trilha de auditoria em execução local/offline.
6
- - **Decisão**: `packages/adapter-sqlite` expõe uma interface mínima `SqliteConnection`, um runner de migrações versionadas e repositórios específicos sobre uma tabela de registros JSON, uma tabela append-only de eventos e uma tabela de auditoria.
7
- - **Regras**:
8
- - migrações são ordenadas por versão e reaplicação é no-op;
9
- - eventos têm `idempotency_key` único e não são sobrescritos;
10
- - domínio não importa `better-sqlite3` nem conhece SQL;
11
- - serialização JSON é responsabilidade do adapter;
12
- - restauração de checkpoint é indexada por `runId`;
13
- - a migração não remove tabelas ou dados existentes.
14
- - **Alternativas rejeitadas**:
15
- - importar `better-sqlite3` em cada pacote de domínio: criaria acoplamento ao driver nativo;
16
- - criar uma tabela específica para cada entidade nesta primeira fatia: aumentaria o custo de migração antes de estabilizar os contratos;
17
- - usar apenas memória: perderia retomada e auditoria após reinício.
18
- - **Consequências**: O adapter de composição deve executar `SqliteMigrationRunner` na inicialização. A evolução de schemas JSON exigirá validação e migração explícita quando os contratos estabilizarem.
19
- - **Evidências**: `test/adapter-sqlite.test.js`, `npm run types:check`, `git diff --check`.
1
+ # ADR-0045 — Adapter SQLite por porta e migrações idempotentes
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O ForjaJS precisa sobreviver a reinícios e manter eventos, checkpoints, sessões, entidades de sprint e trilha de auditoria em execução local/offline.
6
+ - **Decisão**: `packages/adapter-sqlite` expõe uma interface mínima `SqliteConnection`, um runner de migrações versionadas e repositórios específicos sobre uma tabela de registros JSON, uma tabela append-only de eventos e uma tabela de auditoria.
7
+ - **Regras**:
8
+ - migrações são ordenadas por versão e reaplicação é no-op;
9
+ - eventos têm `idempotency_key` único e não são sobrescritos;
10
+ - domínio não importa `better-sqlite3` nem conhece SQL;
11
+ - serialização JSON é responsabilidade do adapter;
12
+ - restauração de checkpoint é indexada por `runId`;
13
+ - a migração não remove tabelas ou dados existentes.
14
+ - **Alternativas rejeitadas**:
15
+ - importar `better-sqlite3` em cada pacote de domínio: criaria acoplamento ao driver nativo;
16
+ - criar uma tabela específica para cada entidade nesta primeira fatia: aumentaria o custo de migração antes de estabilizar os contratos;
17
+ - usar apenas memória: perderia retomada e auditoria após reinício.
18
+ - **Consequências**: O adapter de composição deve executar `SqliteMigrationRunner` na inicialização. A evolução de schemas JSON exigirá validação e migração explícita quando os contratos estabilizarem.
19
+ - **Evidências**: `test/adapter-sqlite.test.js`, `npm run types:check`, `git diff --check`.
@@ -1,18 +1,18 @@
1
- # ADR-0046 — MCP como adaptador fino sobre o núcleo
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Agentes precisam consumir capabilities, contexto, grafo, tarefas e handoffs por MCP sem criar uma segunda implementação de domínio.
6
- - **Decisão**: `packages/mcp` expõe `McpServer`, definições de tools, recursos oficiais e resultados estruturados. O servidor delega a portas e engines existentes, transportando identidade, política e contratos versionados.
7
- - **Regras**:
8
- - Registry continua sendo a fonte única de execução de capabilities;
9
- - input é validado antes do dispatch e erros são normalizados;
10
- - ações mutáveis do MCP passam por `McpPolicy`;
11
- - recursos são providers externos e ausência de provider não gera conteúdo fictício;
12
- - o pacote não importa SDK específico de MCP, NestJS, HTTP ou banco nesta fatia.
13
- - **Alternativas rejeitadas**:
14
- - lógica de negócio dentro de handlers MCP: duplicaria regras e dificultaria CLI/SDK/API consistentes;
15
- - recurso MCP com snapshot inventado: produziria contexto sem evidência;
16
- - executar capability diretamente no MCP: bypassaria Registry e Policy.
17
- - **Consequências**: Um adapter de transporte MCP poderá converter `McpServer` para o protocolo oficial; o núcleo permanece testável sem servidor externo.
18
- - **Evidências**: `test/mcp.test.js`, `npm run types:check`, `git diff --check`.
1
+ # ADR-0046 — MCP como adaptador fino sobre o núcleo
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Agentes precisam consumir capabilities, contexto, grafo, tarefas e handoffs por MCP sem criar uma segunda implementação de domínio.
6
+ - **Decisão**: `packages/mcp` expõe `McpServer`, definições de tools, recursos oficiais e resultados estruturados. O servidor delega a portas e engines existentes, transportando identidade, política e contratos versionados.
7
+ - **Regras**:
8
+ - Registry continua sendo a fonte única de execução de capabilities;
9
+ - input é validado antes do dispatch e erros são normalizados;
10
+ - ações mutáveis do MCP passam por `McpPolicy`;
11
+ - recursos são providers externos e ausência de provider não gera conteúdo fictício;
12
+ - o pacote não importa SDK específico de MCP, NestJS, HTTP ou banco nesta fatia.
13
+ - **Alternativas rejeitadas**:
14
+ - lógica de negócio dentro de handlers MCP: duplicaria regras e dificultaria CLI/SDK/API consistentes;
15
+ - recurso MCP com snapshot inventado: produziria contexto sem evidência;
16
+ - executar capability diretamente no MCP: bypassaria Registry e Policy.
17
+ - **Consequências**: Um adapter de transporte MCP poderá converter `McpServer` para o protocolo oficial; o núcleo permanece testável sem servidor externo.
18
+ - **Evidências**: `test/mcp.test.js`, `npm run types:check`, `git diff --check`.
@@ -1,19 +1,19 @@
1
- # ADR-0047 — Backend Nest como composição externa do núcleo
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O ForjaJS precisa de uma distribuição oficial HTTP em NestJS sem mover regras de domínio para controllers, guards ou decorators.
6
- - **Decisão**: `packages/adapter-nest` define a fronteira REST/SSE, autenticação por porta, correlation IDs, erros normalizados, módulos e OpenAPI. `apps/server` compõe essa fronteira e será o bootstrap Nest oficial quando as dependências do framework forem instaladas.
7
- - **Regras**:
8
- - chamadas delegam ao `McpServer`/application ports e não implementam domínio;
9
- - Policy e identidade permanecem no Registry/MCP/application layer;
10
- - REST é a interface inicial e SSE é o canal de eventos;
11
- - WebSocket permanece adiado;
12
- - autenticação local é uma porta substituível;
13
- - controllers Nest, guards e Swagger ficam na camada externa.
14
- - **Alternativas rejeitadas**:
15
- - importar NestJS no domínio: viola a direção de dependências;
16
- - implementar autorização apenas em controllers: permitiria bypass por MCP/CLI;
17
- - exigir WebSocket nesta fase: não há requisito verificável além de SSE.
18
- - **Consequências**: O backend oficial adiciona dependências Nest no root e usa compilação TypeScript antes da execução. O adapter-neutral continua testável sem servidor.
19
- - **Evidências**: `apps/server/src/main.ts`, `apps/server/src/app.module.ts`, `test/adapter-nest.test.js`, `npm run types:check`, `npm run build`, smoke test `nest-bootstrap-ok`.
1
+ # ADR-0047 — Backend Nest como composição externa do núcleo
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O ForjaJS precisa de uma distribuição oficial HTTP em NestJS sem mover regras de domínio para controllers, guards ou decorators.
6
+ - **Decisão**: `packages/adapter-nest` define a fronteira REST/SSE, autenticação por porta, correlation IDs, erros normalizados, módulos e OpenAPI. `apps/server` compõe essa fronteira e será o bootstrap Nest oficial quando as dependências do framework forem instaladas.
7
+ - **Regras**:
8
+ - chamadas delegam ao `McpServer`/application ports e não implementam domínio;
9
+ - Policy e identidade permanecem no Registry/MCP/application layer;
10
+ - REST é a interface inicial e SSE é o canal de eventos;
11
+ - WebSocket permanece adiado;
12
+ - autenticação local é uma porta substituível;
13
+ - controllers Nest, guards e Swagger ficam na camada externa.
14
+ - **Alternativas rejeitadas**:
15
+ - importar NestJS no domínio: viola a direção de dependências;
16
+ - implementar autorização apenas em controllers: permitiria bypass por MCP/CLI;
17
+ - exigir WebSocket nesta fase: não há requisito verificável além de SSE.
18
+ - **Consequências**: O backend oficial adiciona dependências Nest no root e usa compilação TypeScript antes da execução. O adapter-neutral continua testável sem servidor.
19
+ - **Evidências**: `apps/server/src/main.ts`, `apps/server/src/app.module.ts`, `test/adapter-nest.test.js`, `npm run types:check`, `npm run build`, smoke test `nest-bootstrap-ok`.
@@ -1,18 +1,18 @@
1
- # ADR-0048 — SDK sobre transporte substituível
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: CLI, agentes e plugins precisam consumir a plataforma sem depender de NestJS, Express ou de uma biblioteca HTTP específica.
6
- - **Decisão**: `packages/sdk` expõe `ForjaSdk` sobre `SdkTransport`, com métodos tipados para capabilities, contexto, GraphLoop, orquestração, runtime, approvals, métricas e eventos.
7
- - **Regras**:
8
- - transporte injeta headers de token e correlation ID;
9
- - respostas não-2xx geram `SdkError` estruturado;
10
- - eventos são opcionais e falham explicitamente quando o transporte não suporta subscription;
11
- - tipos de domínio vêm de `packages/contracts`;
12
- - o SDK não executa regra de negócio nem replica Policy.
13
- - **Alternativas rejeitadas**:
14
- - acoplar diretamente a `fetch`: dificultaria CLI offline, testes e futuros transports;
15
- - retornar `unknown` para toda a API: perderia o benefício dos contratos tipados;
16
- - esconder erros HTTP: impediria governança e retry consciente.
17
- - **Consequências**: O Control Plane deve implementar as rotas de runtime, approvals, métricas e CRUD de Sprint/Task para completar a superfície do SDK.
18
- - **Evidências**: `packages/sdk/src/index.ts`, `test/sdk.test.js`, `npm run types:check`, `npm run build`.
1
+ # ADR-0048 — SDK sobre transporte substituível
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: CLI, agentes e plugins precisam consumir a plataforma sem depender de NestJS, Express ou de uma biblioteca HTTP específica.
6
+ - **Decisão**: `packages/sdk` expõe `ForjaSdk` sobre `SdkTransport`, com métodos tipados para capabilities, contexto, GraphLoop, orquestração, runtime, approvals, métricas e eventos.
7
+ - **Regras**:
8
+ - transporte injeta headers de token e correlation ID;
9
+ - respostas não-2xx geram `SdkError` estruturado;
10
+ - eventos são opcionais e falham explicitamente quando o transporte não suporta subscription;
11
+ - tipos de domínio vêm de `packages/contracts`;
12
+ - o SDK não executa regra de negócio nem replica Policy.
13
+ - **Alternativas rejeitadas**:
14
+ - acoplar diretamente a `fetch`: dificultaria CLI offline, testes e futuros transports;
15
+ - retornar `unknown` para toda a API: perderia o benefício dos contratos tipados;
16
+ - esconder erros HTTP: impediria governança e retry consciente.
17
+ - **Consequências**: O Control Plane deve implementar as rotas de runtime, approvals, métricas e CRUD de Sprint/Task para completar a superfície do SDK.
18
+ - **Evidências**: `packages/sdk/src/index.ts`, `test/sdk.test.js`, `npm run types:check`, `npm run build`.
@@ -1,18 +1,18 @@
1
- # ADR-0049 — Observabilidade como fonte do Control Plane
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Autonomia supervisionada exige medir execução, contexto, custo, validação, retrabalho e evidência por várias dimensões operacionais.
6
- - **Decisão**: `packages/observability` registra `Observation` estruturada e calcula `ControlPlaneMetrics`. `SqliteObservationStore` fornece persistência local e `ControlPlanePort` expõe consultas ao adapter HTTP.
7
- - **Regras**:
8
- - cada observação tem `traceId`, outcome e campos de custo/tempo/tokens;
9
- - cobertura de evidência é calculada a partir de refs de contexto ou checksum de entrada;
10
- - agregação não vive em controller, dashboard ou SDK;
11
- - observações são append-only no store lógico;
12
- - métricas vazias retornam zeros, não `NaN`.
13
- - **Alternativas rejeitadas**:
14
- - métricas apenas em logs: dificulta consulta estruturada e avaliação;
15
- - custo apenas por modelo: perde relação com task, capability e run;
16
- - observabilidade apenas no dashboard: quebra operação CLI/offline.
17
- - **Consequências**: O Control Plane deve receber eventos do Runtime, Registry, Context e Validator. Rotas de runtime, approvals e CRUD de Sprint/Task ainda precisam de application services.
18
- - **Evidências**: `packages/observability/src/index.ts`, `packages/adapter-sqlite/src/index.ts`, `test/observability.test.js`, `npm run types:check`, `npm run build`.
1
+ # ADR-0049 — Observabilidade como fonte do Control Plane
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Autonomia supervisionada exige medir execução, contexto, custo, validação, retrabalho e evidência por várias dimensões operacionais.
6
+ - **Decisão**: `packages/observability` registra `Observation` estruturada e calcula `ControlPlaneMetrics`. `SqliteObservationStore` fornece persistência local e `ControlPlanePort` expõe consultas ao adapter HTTP.
7
+ - **Regras**:
8
+ - cada observação tem `traceId`, outcome e campos de custo/tempo/tokens;
9
+ - cobertura de evidência é calculada a partir de refs de contexto ou checksum de entrada;
10
+ - agregação não vive em controller, dashboard ou SDK;
11
+ - observações são append-only no store lógico;
12
+ - métricas vazias retornam zeros, não `NaN`.
13
+ - **Alternativas rejeitadas**:
14
+ - métricas apenas em logs: dificulta consulta estruturada e avaliação;
15
+ - custo apenas por modelo: perde relação com task, capability e run;
16
+ - observabilidade apenas no dashboard: quebra operação CLI/offline.
17
+ - **Consequências**: O Control Plane deve receber eventos do Runtime, Registry, Context e Validator. Rotas de runtime, approvals e CRUD de Sprint/Task ainda precisam de application services.
18
+ - **Evidências**: `packages/observability/src/index.ts`, `packages/adapter-sqlite/src/index.ts`, `test/observability.test.js`, `npm run types:check`, `npm run build`.
@@ -1,18 +1,18 @@
1
- # ADR-0050 — Control Plane por portas de aplicação
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Rotas HTTP precisam coordenar Runtime, Orchestration, Approvals e Observabilidade sem transferir composição ou regras para controllers.
6
- - **Decisão**: `ControlPlanePort` expõe operações opcionais por portas de aplicação. `ControlPlane` delega para serviços configurados, publica observações/eventos e falha explicitamente quando uma composição não existe. O bootstrap oficial compõe Sprint/Task/Handoff e ApprovalLedger reais.
7
- - **Regras**:
8
- - ausência de serviço retorna erro estruturado, nunca sucesso vazio;
9
- - controllers somente transportam request/response;
10
- - eventos SSE derivam de eventos do Control Plane;
11
- - Runtime só será habilitado com planner, validator e Policy reais;
12
- - operações críticas permanecem sujeitas ao Policy Engine.
13
- - **Alternativas rejeitadas**:
14
- - planner vazio para “habilitar” Runtime: permitiria conclusão falsa;
15
- - regras de transição no controller: duplicaria Orchestration;
16
- - polling obrigatório para observabilidade: perde atualização operacional e aumenta custo.
17
- - **Consequências**: Sprint/Task/Handoff/Approvals estão compostos no servidor. Runtime ainda requer uma aplicação específica que converta entrada HTTP em `RuntimeStartRequest` seguro.
18
- - **Evidências**: `apps/server/src/main.ts`, `packages/observability/src/index.ts`, `packages/adapter-nest/src/index.ts`, `test/adapter-nest.test.js`, `npm run build`, smoke `control-plane-bootstrap-ok`.
1
+ # ADR-0050 — Control Plane por portas de aplicação
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Rotas HTTP precisam coordenar Runtime, Orchestration, Approvals e Observabilidade sem transferir composição ou regras para controllers.
6
+ - **Decisão**: `ControlPlanePort` expõe operações opcionais por portas de aplicação. `ControlPlane` delega para serviços configurados, publica observações/eventos e falha explicitamente quando uma composição não existe. O bootstrap oficial compõe Sprint/Task/Handoff e ApprovalLedger reais.
7
+ - **Regras**:
8
+ - ausência de serviço retorna erro estruturado, nunca sucesso vazio;
9
+ - controllers somente transportam request/response;
10
+ - eventos SSE derivam de eventos do Control Plane;
11
+ - Runtime só será habilitado com planner, validator e Policy reais;
12
+ - operações críticas permanecem sujeitas ao Policy Engine.
13
+ - **Alternativas rejeitadas**:
14
+ - planner vazio para “habilitar” Runtime: permitiria conclusão falsa;
15
+ - regras de transição no controller: duplicaria Orchestration;
16
+ - polling obrigatório para observabilidade: perde atualização operacional e aumenta custo.
17
+ - **Consequências**: Sprint/Task/Handoff/Approvals estão compostos no servidor. Runtime ainda requer uma aplicação específica que converta entrada HTTP em `RuntimeStartRequest` seguro.
18
+ - **Evidências**: `apps/server/src/main.ts`, `packages/observability/src/index.ts`, `packages/adapter-nest/src/index.ts`, `test/adapter-nest.test.js`, `npm run build`, smoke `control-plane-bootstrap-ok`.
@@ -1,18 +1,18 @@
1
- # ADR-0051 — Runtime seguro no Control Plane
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O backend precisava expor Runtime sem aceitar um executor vazio ou permitir que uma capability bypassasse Policy, budget e validação.
6
- - **Decisão**: O bootstrap compõe `RuntimeEngine` com etapas de capability explícitas na requisição, planner determinístico, PolicyEngine com allowlist `read` em ambiente local, budget validado e validator independente que exige todos os resultados sucedidos com evidência.
7
- - **Regras**:
8
- - Runtime exige ao menos uma etapa, objective, agent e TokenBudget válido;
9
- - categorias, arquivos, ambiente, approval e budget são transportados ao Registry;
10
- - ausência de capability ou Policy bloqueia/falha a execução;
11
- - conclusão só ocorre após validator independente;
12
- - cada operação de Control Plane gera Observation e evento SSE.
13
- - **Alternativas rejeitadas**:
14
- - planner vazio: faria runs sem trabalho verificável;
15
- - permitir escrita por padrão: violaria autonomia supervisionada;
16
- - considerar handler bem-sucedido como conclusão: ignoraria validação e evidência.
17
- - **Consequências**: O servidor local consegue executar fluxos read-only determinísticos. Capabilities de escrita exigirão regras/políticas explícitas e approval adequado.
18
- - **Evidências**: `apps/server/src/main.ts`, `packages/runtime/src/index.ts`, `test/runtime.test.js`, smoke `runtime-control-plane-ok completed accepted 2`, `npm run types:check`, `npm run build`.
1
+ # ADR-0051 — Runtime seguro no Control Plane
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O backend precisava expor Runtime sem aceitar um executor vazio ou permitir que uma capability bypassasse Policy, budget e validação.
6
+ - **Decisão**: O bootstrap compõe `RuntimeEngine` com etapas de capability explícitas na requisição, planner determinístico, PolicyEngine com allowlist `read` em ambiente local, budget validado e validator independente que exige todos os resultados sucedidos com evidência.
7
+ - **Regras**:
8
+ - Runtime exige ao menos uma etapa, objective, agent e TokenBudget válido;
9
+ - categorias, arquivos, ambiente, approval e budget são transportados ao Registry;
10
+ - ausência de capability ou Policy bloqueia/falha a execução;
11
+ - conclusão só ocorre após validator independente;
12
+ - cada operação de Control Plane gera Observation e evento SSE.
13
+ - **Alternativas rejeitadas**:
14
+ - planner vazio: faria runs sem trabalho verificável;
15
+ - permitir escrita por padrão: violaria autonomia supervisionada;
16
+ - considerar handler bem-sucedido como conclusão: ignoraria validação e evidência.
17
+ - **Consequências**: O servidor local consegue executar fluxos read-only determinísticos. Capabilities de escrita exigirão regras/políticas explícitas e approval adequado.
18
+ - **Evidências**: `apps/server/src/main.ts`, `packages/runtime/src/index.ts`, `test/runtime.test.js`, smoke `runtime-control-plane-ok completed accepted 2`, `npm run types:check`, `npm run build`.
@@ -1,15 +1,15 @@
1
- # ADR-0052 — Evaluation Engine determinístico sobre observações
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Métricas de qualidade e custo não podem depender de declaração do agente nem de LLM.
6
- - **Decisão**: `@forja/evals` recebe `ObservationStore` ou uma coleção explícita e produz `EvaluationReport` versionado. Sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência, rollback e uso de contexto são calculados por regras determinísticas.
7
- - **Regras**:
8
- - hash de entrada repetido conta como repetição/cache hit observável;
9
- - tokens por task usam tarefas distintas presentes nas observações;
10
- - ausência simultânea de `contextRefs` e `inputHash` é sinalizada como afirmação sem evidência;
11
- - rollback é identificado por `errorCode=ROLLBACK` e não inferido de texto livre;
12
- - relatório mantém IDs das observações como evidência.
13
- - **Alternativas rejeitadas**: LLM para classificar sucesso; custo calculado sem observação; relatório sem referências auditáveis.
14
- - **Consequências**: Resultados são reproduzíveis e offline. Métricas que exigirem semântica adicional devem ganhar campo contratual explícito, não heurística silenciosa.
15
- - **Evidências**: `packages/evals/src/index.ts`, `packages/contracts/src/index.ts`, `test/evals.test.js`, `npm run types:check`, `npm run build`.
1
+ # ADR-0052 — Evaluation Engine determinístico sobre observações
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Métricas de qualidade e custo não podem depender de declaração do agente nem de LLM.
6
+ - **Decisão**: `@forja/evals` recebe `ObservationStore` ou uma coleção explícita e produz `EvaluationReport` versionado. Sucesso, retrabalho/cache, tokens por task, etapas sem atividade, ausência de evidência, rollback e uso de contexto são calculados por regras determinísticas.
7
+ - **Regras**:
8
+ - hash de entrada repetido conta como repetição/cache hit observável;
9
+ - tokens por task usam tarefas distintas presentes nas observações;
10
+ - ausência simultânea de `contextRefs` e `inputHash` é sinalizada como afirmação sem evidência;
11
+ - rollback é identificado por `errorCode=ROLLBACK` e não inferido de texto livre;
12
+ - relatório mantém IDs das observações como evidência.
13
+ - **Alternativas rejeitadas**: LLM para classificar sucesso; custo calculado sem observação; relatório sem referências auditáveis.
14
+ - **Consequências**: Resultados são reproduzíveis e offline. Métricas que exigirem semântica adicional devem ganhar campo contratual explícito, não heurística silenciosa.
15
+ - **Evidências**: `packages/evals/src/index.ts`, `packages/contracts/src/index.ts`, `test/evals.test.js`, `npm run types:check`, `npm run build`.
@@ -1,16 +1,16 @@
1
- # ADR-0053 — Plugin SDK com permissões declaradas
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: Extensões precisam consumir o Forja sem receber acesso implícito ao processo, filesystem, banco ou capabilities não autorizadas.
6
- - **Decisão**: `@forja/plugin-sdk` registra manifestos validados e entrega ao plugin somente um `PluginContext` composto por serviços externos. Cada método verifica uma permissão declarada antes de acessar a porta correspondente.
7
- - **Regras**:
8
- - manifesto exige id, versão e compatibilidade do core;
9
- - permissões e capabilities declaradas devem ser únicas;
10
- - plugins com ID já registrado são rejeitados;
11
- - serviço ausente ou permissão ausente falha explicitamente;
12
- - falha no setup remove o registro parcial;
13
- - o SDK não oferece acesso direto a recursos do host.
14
- - **Alternativas rejeitadas**: entregar um objeto host irrestrito; confiar apenas em convenção documental; permitir mutação de manifesto após registro.
15
- - **Consequências**: A composição do host permanece substituível e testável. Assinatura, migrations e extensões de dashboard ficam como metadados até haver política de instalação correspondente.
16
- - **Evidências**: `packages/plugin-sdk/src/index.ts`, `test/plugin-sdk.test.js`, `npm run types:check`, `npm run build`.
1
+ # ADR-0053 — Plugin SDK com permissões declaradas
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: Extensões precisam consumir o Forja sem receber acesso implícito ao processo, filesystem, banco ou capabilities não autorizadas.
6
+ - **Decisão**: `@forja/plugin-sdk` registra manifestos validados e entrega ao plugin somente um `PluginContext` composto por serviços externos. Cada método verifica uma permissão declarada antes de acessar a porta correspondente.
7
+ - **Regras**:
8
+ - manifesto exige id, versão e compatibilidade do core;
9
+ - permissões e capabilities declaradas devem ser únicas;
10
+ - plugins com ID já registrado são rejeitados;
11
+ - serviço ausente ou permissão ausente falha explicitamente;
12
+ - falha no setup remove o registro parcial;
13
+ - o SDK não oferece acesso direto a recursos do host.
14
+ - **Alternativas rejeitadas**: entregar um objeto host irrestrito; confiar apenas em convenção documental; permitir mutação de manifesto após registro.
15
+ - **Consequências**: A composição do host permanece substituível e testável. Assinatura, migrations e extensões de dashboard ficam como metadados até haver política de instalação correspondente.
16
+ - **Evidências**: `packages/plugin-sdk/src/index.ts`, `test/plugin-sdk.test.js`, `npm run types:check`, `npm run build`.
@@ -1,15 +1,15 @@
1
- # ADR-0054 — Worker e dashboard como adaptadores do Control Plane
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O processamento assíncrono e a interface operacional precisam consumir o núcleo sem duplicar suas regras.
6
- - **Decisão**: `apps/worker` compõe Event Bus, Scheduler, Observability e Evaluation Engine. `apps/dashboard` expõe um view model de snapshot e ações delegadas ao `ControlPlanePort`; a futura casca Next/React consumirá esse view model por transporte remoto.
7
- - **Regras**:
8
- - worker não executa capabilities diretamente nem bypassa Policy;
9
- - dashboard não autoriza, executa agente ou calcula GraphLoop;
10
- - ações críticas são delegadas a portas do Control Plane;
11
- - ausência de serviço é erro explícito;
12
- - a camada atual permanece compilável offline sem instalar framework visual prematuramente.
13
- - **Alternativas rejeitadas**: regra de negócio dentro de componentes React; worker com executor próprio; dashboard chamando SQLite diretamente.
14
- - **Consequências**: A fronteira operacional pode ser testada sem navegador. Next/React, TanStack Query e SSE real serão ligados na etapa de distribuição visual, sem mudar o domínio.
15
- - **Evidências**: `apps/worker/src/main.ts`, `apps/dashboard/src/index.ts`, `test/dashboard-worker.test.js`, `npm run types:check`, `npm run build`.
1
+ # ADR-0054 — Worker e dashboard como adaptadores do Control Plane
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O processamento assíncrono e a interface operacional precisam consumir o núcleo sem duplicar suas regras.
6
+ - **Decisão**: `apps/worker` compõe Event Bus, Scheduler, Observability e Evaluation Engine. `apps/dashboard` expõe um view model de snapshot e ações delegadas ao `ControlPlanePort`; a futura casca Next/React consumirá esse view model por transporte remoto.
7
+ - **Regras**:
8
+ - worker não executa capabilities diretamente nem bypassa Policy;
9
+ - dashboard não autoriza, executa agente ou calcula GraphLoop;
10
+ - ações críticas são delegadas a portas do Control Plane;
11
+ - ausência de serviço é erro explícito;
12
+ - a camada atual permanece compilável offline sem instalar framework visual prematuramente.
13
+ - **Alternativas rejeitadas**: regra de negócio dentro de componentes React; worker com executor próprio; dashboard chamando SQLite diretamente.
14
+ - **Consequências**: A fronteira operacional pode ser testada sem navegador. Next/React, TanStack Query e SSE real serão ligados na etapa de distribuição visual, sem mudar o domínio.
15
+ - **Evidências**: `apps/worker/src/main.ts`, `apps/dashboard/src/index.ts`, `test/dashboard-worker.test.js`, `npm run types:check`, `npm run build`.
@@ -1,16 +1,16 @@
1
- # ADR-0055 — Dashboard Next.js como adaptador de distribuição
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Contexto**: O ForjaJS precisa de uma interface oficial operacional sem deslocar autorização, execução ou GraphLoop para o cliente.
6
- - **Decisão**: `apps/dashboard` usa Next.js 15.5.9, React 19.2 e App Router. A página consulta métricas/observações por REST, reage a SSE e mantém ações críticas fora do cliente, delegadas ao Control Plane boundary.
7
- - **Regras**:
8
- - cliente não acessa SQLite nem conhece persistência;
9
- - cliente não decide Policy nem executa capability;
10
- - dados remotos são tratados como estado operacional, não como fonte de autorização;
11
- - `outputFileTracingRoot` aponta para a raiz do monorepo;
12
- - a versão do Next deve permanecer em linha corrigida de segurança.
13
- - **Alternativas rejeitadas**: dashboard com regras próprias; polling como único canal; importação direta de adapters.
14
- - **Consequências**: Existe uma distribuição visual compilável e offline quanto ao bundle. Autenticação real, TanStack Query, filtros avançados e GraphLoop visual continuam incrementos posteriores sobre o mesmo boundary.
15
- - **Risco conhecido**: npm reportou vulnerabilidades altas transitivas no conjunto instalado; o release gate deve executar auditoria e não usar `audit fix --force` automaticamente.
16
- - **Evidências**: `apps/dashboard/app/page.tsx`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/next.config.mjs`, `npm run dashboard:build`.
1
+ # ADR-0055 — Dashboard Next.js como adaptador de distribuição
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Contexto**: O ForjaJS precisa de uma interface oficial operacional sem deslocar autorização, execução ou GraphLoop para o cliente.
6
+ - **Decisão**: `apps/dashboard` usa Next.js 15.5.9, React 19.2 e App Router. A página consulta métricas/observações por REST, reage a SSE e mantém ações críticas fora do cliente, delegadas ao Control Plane boundary.
7
+ - **Regras**:
8
+ - cliente não acessa SQLite nem conhece persistência;
9
+ - cliente não decide Policy nem executa capability;
10
+ - dados remotos são tratados como estado operacional, não como fonte de autorização;
11
+ - `outputFileTracingRoot` aponta para a raiz do monorepo;
12
+ - a versão do Next deve permanecer em linha corrigida de segurança.
13
+ - **Alternativas rejeitadas**: dashboard com regras próprias; polling como único canal; importação direta de adapters.
14
+ - **Consequências**: Existe uma distribuição visual compilável e offline quanto ao bundle. Autenticação real, TanStack Query, filtros avançados e GraphLoop visual continuam incrementos posteriores sobre o mesmo boundary.
15
+ - **Risco conhecido**: npm reportou vulnerabilidades altas transitivas no conjunto instalado; o release gate deve executar auditoria e não usar `audit fix --force` automaticamente.
16
+ - **Evidências**: `apps/dashboard/app/page.tsx`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/next.config.mjs`, `npm run dashboard:build`.
@@ -1,16 +1,16 @@
1
- # ADR-0056 — Proxy server-side, autenticação local e cache remoto do dashboard
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: O dashboard precisava consumir o backend local sem expor segredo no bundle, duplicar autorização ou refazer consultas a cada renderização.
6
- - **Decisão**: `apps/dashboard` usa Route Handler server-side com allowlist de recursos, encaminha `FORJA_AUTH_TOKEN` somente ao backend e usa TanStack Query no cliente para cache/invalidação. SSE invalida a query; não transporta credenciais.
7
- - **Regras**:
8
- - somente métricas, observações, eventos e transições de execução são encaminhados;
9
- - rotas fora da allowlist retornam 403;
10
- - token nunca usa prefixo `NEXT_PUBLIC_`;
11
- - backend valida Bearer com comparação de tamanho e `timingSafeEqual`;
12
- - cliente não decide Policy e não acessa SQLite;
13
- - pausa/cancelamento continuam comandos do Control Plane.
14
- - **Alternativas rejeitadas**: token público no bundle; proxy genérico para qualquer URL; autorização no React; polling sem invalidação por evento.
15
- - **Consequências**: Desenvolvimento local continua simples com `FORJA_API_URL` e `FORJA_AUTH_TOKEN`; autenticação sem token permanece compatibilidade de ambiente local, e implantação deve definir o token.
16
- - **Evidências**: `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/providers.tsx`, `apps/dashboard/app/dashboard-client.tsx`, `packages/adapter-nest/src/index.ts`, `apps/server/src/main.ts`, 265 testes.
1
+ # ADR-0056 — Proxy server-side, autenticação local e cache remoto do dashboard
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: O dashboard precisava consumir o backend local sem expor segredo no bundle, duplicar autorização ou refazer consultas a cada renderização.
6
+ - **Decisão**: `apps/dashboard` usa Route Handler server-side com allowlist de recursos, encaminha `FORJA_AUTH_TOKEN` somente ao backend e usa TanStack Query no cliente para cache/invalidação. SSE invalida a query; não transporta credenciais.
7
+ - **Regras**:
8
+ - somente métricas, observações, eventos e transições de execução são encaminhados;
9
+ - rotas fora da allowlist retornam 403;
10
+ - token nunca usa prefixo `NEXT_PUBLIC_`;
11
+ - backend valida Bearer com comparação de tamanho e `timingSafeEqual`;
12
+ - cliente não decide Policy e não acessa SQLite;
13
+ - pausa/cancelamento continuam comandos do Control Plane.
14
+ - **Alternativas rejeitadas**: token público no bundle; proxy genérico para qualquer URL; autorização no React; polling sem invalidação por evento.
15
+ - **Consequências**: Desenvolvimento local continua simples com `FORJA_API_URL` e `FORJA_AUTH_TOKEN`; autenticação sem token permanece compatibilidade de ambiente local, e implantação deve definir o token.
16
+ - **Evidências**: `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/providers.tsx`, `apps/dashboard/app/dashboard-client.tsx`, `packages/adapter-nest/src/index.ts`, `apps/server/src/main.ts`, 265 testes.