forjajs 2.0.4 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (798) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
@@ -1,15 +1,15 @@
1
- # ADR-0057 — GraphLoop e approvals no dashboard por portas do Control Plane
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: A interface precisava tornar relações e aprovações operacionais sem reproduzir algoritmos do domínio nem criar decisões no cliente.
6
- - **Decisão**: O adapter Nest expõe consulta de nós, impacto e listagem de approvals; o dashboard renderiza nós/status e impacto sob demanda, além de listar decisões pendentes/finais. GraphLoop continua no pacote de domínio e Policy continua no backend.
7
- - **Regras**:
8
- - toda relação exibida vem da API e preserva status/evidência do GraphLoop;
9
- - impacto exige um ID de origem explícito;
10
- - approvals são somente leitura nesta fatia; decisão deve usar identidade/aprovador configurado;
11
- - nenhuma heurística de grafo é executada no React;
12
- - endpoints entram na allowlist do proxy, nunca em proxy genérico.
13
- - **Alternativas rejeitadas**: importar GraphLoop para o browser; renderizar arestas inventadas; aprovar sem identidade explícita; consultar SQLite no dashboard.
14
- - **Consequências**: A UI já permite inspeção operacional básica offline/remota. Visualização espacial avançada, evidências detalhadas e fluxo de aprovação autenticado continuam etapas posteriores.
15
- - **Evidências**: `packages/adapter-nest/src/index.ts`, `packages/policy/src/index.ts`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/app/api/forja/[...path]/route.ts`, 265 testes.
1
+ # ADR-0057 — GraphLoop e approvals no dashboard por portas do Control Plane
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: A interface precisava tornar relações e aprovações operacionais sem reproduzir algoritmos do domínio nem criar decisões no cliente.
6
+ - **Decisão**: O adapter Nest expõe consulta de nós, impacto e listagem de approvals; o dashboard renderiza nós/status e impacto sob demanda, além de listar decisões pendentes/finais. GraphLoop continua no pacote de domínio e Policy continua no backend.
7
+ - **Regras**:
8
+ - toda relação exibida vem da API e preserva status/evidência do GraphLoop;
9
+ - impacto exige um ID de origem explícito;
10
+ - approvals são somente leitura nesta fatia; decisão deve usar identidade/aprovador configurado;
11
+ - nenhuma heurística de grafo é executada no React;
12
+ - endpoints entram na allowlist do proxy, nunca em proxy genérico.
13
+ - **Alternativas rejeitadas**: importar GraphLoop para o browser; renderizar arestas inventadas; aprovar sem identidade explícita; consultar SQLite no dashboard.
14
+ - **Consequências**: A UI já permite inspeção operacional básica offline/remota. Visualização espacial avançada, evidências detalhadas e fluxo de aprovação autenticado continuam etapas posteriores.
15
+ - **Evidências**: `packages/adapter-nest/src/index.ts`, `packages/policy/src/index.ts`, `apps/dashboard/app/dashboard-client.tsx`, `apps/dashboard/app/api/forja/[...path]/route.ts`, 265 testes.
@@ -1,15 +1,15 @@
1
- # ADR-0058 — Decisão de approval com identidade server-side
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: O dashboard precisava responder approvals sem permitir que o cliente escolhesse ou falsificasse o aprovador.
6
- - **Decisão**: O cliente envia somente `approved` ou `rejected`. O Route Handler valida o valor, exige `FORJA_APPROVER_ID`, injeta o aprovador e timestamp, e encaminha a decisão ao Control Plane usando o token server-side.
7
- - **Regras**:
8
- - ausência de `FORJA_APPROVER_ID` retorna configuração indisponível;
9
- - qualquer decisão fora do enum é rejeitada;
10
- - o valor de `approverId` vindo do cliente é ignorado;
11
- - Policy/ApprovalLedger continuam responsáveis por validade, expiração e idempotência semântica;
12
- - a UI não exibe nem recebe segredo de autenticação.
13
- - **Alternativas rejeitadas**: aceitar aprovador no body do browser; usar identidade fixa inventada; aprovar automaticamente quando não houver configuração.
14
- - **Consequências**: O dashboard operacional exige configuração explícita do ambiente para decidir approvals. Listagem continua possível sem identidade de decisão.
15
- - **Evidências**: `apps/dashboard/app/api/forja/approval.ts`, `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/dashboard-client.tsx`, `test/dashboard-approval.test.js`, 267 testes.
1
+ # ADR-0058 — Decisão de approval com identidade server-side
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: O dashboard precisava responder approvals sem permitir que o cliente escolhesse ou falsificasse o aprovador.
6
+ - **Decisão**: O cliente envia somente `approved` ou `rejected`. O Route Handler valida o valor, exige `FORJA_APPROVER_ID`, injeta o aprovador e timestamp, e encaminha a decisão ao Control Plane usando o token server-side.
7
+ - **Regras**:
8
+ - ausência de `FORJA_APPROVER_ID` retorna configuração indisponível;
9
+ - qualquer decisão fora do enum é rejeitada;
10
+ - o valor de `approverId` vindo do cliente é ignorado;
11
+ - Policy/ApprovalLedger continuam responsáveis por validade, expiração e idempotência semântica;
12
+ - a UI não exibe nem recebe segredo de autenticação.
13
+ - **Alternativas rejeitadas**: aceitar aprovador no body do browser; usar identidade fixa inventada; aprovar automaticamente quando não houver configuração.
14
+ - **Consequências**: O dashboard operacional exige configuração explícita do ambiente para decidir approvals. Listagem continua possível sem identidade de decisão.
15
+ - **Evidências**: `apps/dashboard/app/api/forja/approval.ts`, `apps/dashboard/app/api/forja/[...path]/route.ts`, `apps/dashboard/app/dashboard-client.tsx`, `test/dashboard-approval.test.js`, 267 testes.
@@ -1,17 +1,17 @@
1
- # ADR-0059 — CLI como adaptador transitório do Capability Registry
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o Forja possuía o registry declarativo de comandos em `lib/core/registry.ts` e o
6
- `CapabilityRegistry` executável em `packages/core`, sem uma ponte operacional entre ambos.
7
- - **Decisão**: migrar comandos por fatias para `apps/cli/src/index.ts`. Cada capability declara
8
- contrato, validação, política, alias legado e handler injetado. O binário da CLI somente adapta
9
- argumentos, invoca o registry e registra o resultado; comandos não migrados preservam o dispatch
10
- declarativo durante a transição.
11
- - **Consequências**: CLI, descoberta e execução passam a compartilhar `ExecutionResult`, validação
12
- e autorização nos comandos migrados. A auditoria JSONL permanece no core executivo até o
13
- armazenamento de auditoria persistente ser integrado em sprint posterior.
14
- - **Fora desta decisão**: persistência do runtime, MCP nativo, GraphLoop, sandbox e migração dos
15
- demais comandos.
16
- - **Evidência**: `docs/2x/IMPLEMENTATION-AUDIT.md`, `apps/cli/src/index.ts` e
17
- `test/cli-capability-adapter.test.js`.
1
+ # ADR-0059 — CLI como adaptador transitório do Capability Registry
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o Forja possuía o registry declarativo de comandos em `lib/core/registry.ts` e o
6
+ `CapabilityRegistry` executável em `packages/core`, sem uma ponte operacional entre ambos.
7
+ - **Decisão**: migrar comandos por fatias para `apps/cli/src/index.ts`. Cada capability declara
8
+ contrato, validação, política, alias legado e handler injetado. O binário da CLI somente adapta
9
+ argumentos, invoca o registry e registra o resultado; comandos não migrados preservam o dispatch
10
+ declarativo durante a transição.
11
+ - **Consequências**: CLI, descoberta e execução passam a compartilhar `ExecutionResult`, validação
12
+ e autorização nos comandos migrados. A auditoria JSONL permanece no core executivo até o
13
+ armazenamento de auditoria persistente ser integrado em sprint posterior.
14
+ - **Fora desta decisão**: persistência do runtime, MCP nativo, GraphLoop, sandbox e migração dos
15
+ demais comandos.
16
+ - **Evidência**: `docs/2x/IMPLEMENTATION-AUDIT.md`, `apps/cli/src/index.ts` e
17
+ `test/cli-capability-adapter.test.js`.
@@ -1,17 +1,17 @@
1
- # ADR-0060 — Persistência do Runtime por porta e recuperação explícita
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: `RuntimeEngine` mantinha runs, planos, resultados e cursor em `Map`s. Checkpoints
6
- SQLite já existiam, mas não eram suficientes para recriar o engine após reinício.
7
- - **Decisão**: o domínio expõe `RuntimePersistence` com operações para run, plano, resultados e
8
- cursor. `SqliteRuntimePersistence` implementa a porta usando migração versionada e payloads JSON
9
- em tabelas próprias. A recuperação recebe a policy ativa explicitamente; funções e dependências
10
- executáveis nunca são serializadas.
11
- - **Consequências**: uma nova instância pode recuperar uma execução pausada e continuar do cursor
12
- persistido. O Runtime permanece independente de SQLite. A persistência síncrona é adequada para
13
- o backend local-first inicial e a porta permite adapter assíncrono futuro.
14
- - **Alternativas rejeitadas**: serializar policy/handlers; depender apenas de checkpoints; acoplar
15
- `packages/runtime` ao driver SQLite.
16
- - **Evidência**: `packages/runtime/src/index.ts`, `packages/adapter-sqlite/src/index.ts` e
17
- `test/runtime.test.js`.
1
+ # ADR-0060 — Persistência do Runtime por porta e recuperação explícita
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: `RuntimeEngine` mantinha runs, planos, resultados e cursor em `Map`s. Checkpoints
6
+ SQLite já existiam, mas não eram suficientes para recriar o engine após reinício.
7
+ - **Decisão**: o domínio expõe `RuntimePersistence` com operações para run, plano, resultados e
8
+ cursor. `SqliteRuntimePersistence` implementa a porta usando migração versionada e payloads JSON
9
+ em tabelas próprias. A recuperação recebe a policy ativa explicitamente; funções e dependências
10
+ executáveis nunca são serializadas.
11
+ - **Consequências**: uma nova instância pode recuperar uma execução pausada e continuar do cursor
12
+ persistido. O Runtime permanece independente de SQLite. A persistência síncrona é adequada para
13
+ o backend local-first inicial e a porta permite adapter assíncrono futuro.
14
+ - **Alternativas rejeitadas**: serializar policy/handlers; depender apenas de checkpoints; acoplar
15
+ `packages/runtime` ao driver SQLite.
16
+ - **Evidência**: `packages/runtime/src/index.ts`, `packages/adapter-sqlite/src/index.ts` e
17
+ `test/runtime.test.js`.
@@ -1,16 +1,16 @@
1
- # ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
6
- consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
7
- - **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
8
- ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
9
- `forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
10
- delega todas as chamadas ao `McpServer`.
11
- - **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
12
- mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
13
- autorização; schemas detalhados permanecem nos validadores do registry.
14
- - **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
15
- remoto obrigatório nesta etapa.
16
- - **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
1
+ # ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
6
+ consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
7
+ - **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
8
+ ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
9
+ `forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
10
+ delega todas as chamadas ao `McpServer`.
11
+ - **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
12
+ mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
13
+ autorização; schemas detalhados permanecem nos validadores do registry.
14
+ - **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
15
+ remoto obrigatório nesta etapa.
16
+ - **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
@@ -1,17 +1,17 @@
1
- # ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
6
- memória ou sem sink persistente.
7
- - **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
8
- compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
9
- recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
10
- operação, mas é responsabilidade do sink expor saúde própria.
11
- - **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
12
- sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
13
- memória no boot, enquanto persistência de definições fica adiada.
14
- - **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
15
- auditoria somente em memória.
16
- - **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
17
- `packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
1
+ # ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
6
+ memória ou sem sink persistente.
7
+ - **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
8
+ compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
9
+ recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
10
+ operação, mas é responsabilidade do sink expor saúde própria.
11
+ - **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
12
+ sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
13
+ memória no boot, enquanto persistência de definições fica adiada.
14
+ - **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
15
+ auditoria somente em memória.
16
+ - **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
17
+ `packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
@@ -1,19 +1,19 @@
1
- # ADR-0063 — Event Bus SQLite e prova E2E determinística
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
6
- o server publicava eventos somente no stream SSE e não havia uma prova integrada
7
- do ciclo supervisionado.
8
- - **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
9
- `EventStore` antes do primeiro append/list. O bootstrap NestJS usa
10
- `SqliteEventStore` no banco local e encaminha publicações do Control Plane para
11
- SSE e persistência. A prova operacional usa capability, sandbox e validator
12
- determinísticos, sem LLM.
13
- - **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
14
- idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
15
- letters ainda não são duráveis entre processos.
16
- - **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
17
- eventos; prova baseada em chamada real de modelo.
18
- - **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
19
- `test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
1
+ # ADR-0063 — Event Bus SQLite e prova E2E determinística
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
6
+ o server publicava eventos somente no stream SSE e não havia uma prova integrada
7
+ do ciclo supervisionado.
8
+ - **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
9
+ `EventStore` antes do primeiro append/list. O bootstrap NestJS usa
10
+ `SqliteEventStore` no banco local e encaminha publicações do Control Plane para
11
+ SSE e persistência. A prova operacional usa capability, sandbox e validator
12
+ determinísticos, sem LLM.
13
+ - **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
14
+ idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
15
+ letters ainda não são duráveis entre processos.
16
+ - **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
17
+ eventos; prova baseada em chamada real de modelo.
18
+ - **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
19
+ `test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
@@ -1,20 +1,20 @@
1
- # ADR-0064 — GraphLoop com porta de store e SQLite oficial
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
6
- store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
7
- após reinício.
8
- - **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
9
- permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
10
- A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
11
- futuras claims/contradições/agenda/extractions. O server compartilha a mesma
12
- instância persistente entre MCP e Runtime.
13
- - **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
14
- a política de “toda aresta tem endpoints e evidência” continua no core. O
15
- schema das entidades futuras existe, mas seus engines ainda não persistem
16
- automaticamente.
17
- - **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
18
- operações assíncronas nesta fase; manter o server em memória.
19
- - **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
20
- `apps/server/src/main.ts` e testes da Sprint 7.
1
+ # ADR-0064 — GraphLoop com porta de store e SQLite oficial
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
6
+ store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
7
+ após reinício.
8
+ - **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
9
+ permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
10
+ A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
11
+ futuras claims/contradições/agenda/extractions. O server compartilha a mesma
12
+ instância persistente entre MCP e Runtime.
13
+ - **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
14
+ a política de “toda aresta tem endpoints e evidência” continua no core. O
15
+ schema das entidades futuras existe, mas seus engines ainda não persistem
16
+ automaticamente.
17
+ - **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
18
+ operações assíncronas nesta fase; manter o server em memória.
19
+ - **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
20
+ `apps/server/src/main.ts` e testes da Sprint 7.
@@ -1,20 +1,20 @@
1
- # ADR-0065 — GraphLoop como fonte determinística do Context Engine
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
6
- server não a compunha com o GraphLoop persistente; o cache padrão era apenas
7
- em memória.
8
- - **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
9
- GraphLoop retorna relações ativas que tenham evidência e coincidam
10
- deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
11
- conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
12
- Context Engine, MCP e Runtime.
13
- - **Consequências**: contexto mínimo pode ser recuperado offline, com referências
14
- auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
15
- trechos de arquivos e sumarização ficam para fases posteriores.
16
- - **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
17
- context; duplicar uma busca de grafo dentro do MCP.
18
- - **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
19
- `packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
20
- Sprint 8.
1
+ # ADR-0065 — GraphLoop como fonte determinística do Context Engine
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
6
+ server não a compunha com o GraphLoop persistente; o cache padrão era apenas
7
+ em memória.
8
+ - **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
9
+ GraphLoop retorna relações ativas que tenham evidência e coincidam
10
+ deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
11
+ conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
12
+ Context Engine, MCP e Runtime.
13
+ - **Consequências**: contexto mínimo pode ser recuperado offline, com referências
14
+ auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
15
+ trechos de arquivos e sumarização ficam para fases posteriores.
16
+ - **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
17
+ context; duplicar uma busca de grafo dentro do MCP.
18
+ - **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
19
+ `packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
20
+ Sprint 8.
@@ -1,16 +1,16 @@
1
- # ADR-0066 — Extração determinística incremental do GraphLoop
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: o extractor inicial cobria somente imports e links Markdown,
6
- deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
7
- - **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
8
- chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
9
- de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
10
- pela mesma mutation com checksum.
11
- - **Consequências**: consultas de impacto e contexto ganham relações offline sem
12
- custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
13
- diffs permanece fora do extractor lexical.
14
- - **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
15
- parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
16
- - **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
1
+ # ADR-0066 — Extração determinística incremental do GraphLoop
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: o extractor inicial cobria somente imports e links Markdown,
6
+ deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
7
+ - **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
8
+ chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
9
+ de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
10
+ pela mesma mutation com checksum.
11
+ - **Consequências**: consultas de impacto e contexto ganham relações offline sem
12
+ custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
13
+ diffs permanece fora do extractor lexical.
14
+ - **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
15
+ parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
16
+ - **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
@@ -1,17 +1,17 @@
1
- # ADR-0067 — Indexação GraphLoop por fonte Git e capability `graph.sync`
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: extractors determinísticos existiam, mas não havia uma operação
6
- incremental que lesse o workspace e aplicasse mutations ao GraphLoop.
7
- - **Decisão**: `GraphIndexer` recebe uma porta `GraphDocumentSource`; o adapter
8
- `GitGraphDocumentSource` usa `git ls-files` e leitura local limitada; a
9
- capability `graph.sync` executa o indexador, retorna contagens estruturadas e
10
- gera evidência. O server compõe essa capability sobre `SqliteGraphStore`.
11
- - **Consequências**: indexação local é reproduzível, incremental e sem LLM;
12
- arquivos ignorados ficam fora. Remoções, commits e diffs exigem uma próxima
13
- evolução para não introduzir poda ou histórico incorreto nesta fase.
14
- - **Alternativas rejeitadas**: varrer recursivamente sem respeitar `.gitignore`;
15
- indexar conteúdo binário; criar um segundo registry específico para o grafo.
16
- - **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-git/src/index.ts`,
17
- `apps/cli/src/index.ts`, `apps/server/src/main.ts` e testes Sprint 10.
1
+ # ADR-0067 — Indexação GraphLoop por fonte Git e capability `graph.sync`
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: extractors determinísticos existiam, mas não havia uma operação
6
+ incremental que lesse o workspace e aplicasse mutations ao GraphLoop.
7
+ - **Decisão**: `GraphIndexer` recebe uma porta `GraphDocumentSource`; o adapter
8
+ `GitGraphDocumentSource` usa `git ls-files` e leitura local limitada; a
9
+ capability `graph.sync` executa o indexador, retorna contagens estruturadas e
10
+ gera evidência. O server compõe essa capability sobre `SqliteGraphStore`.
11
+ - **Consequências**: indexação local é reproduzível, incremental e sem LLM;
12
+ arquivos ignorados ficam fora. Remoções, commits e diffs exigem uma próxima
13
+ evolução para não introduzir poda ou histórico incorreto nesta fase.
14
+ - **Alternativas rejeitadas**: varrer recursivamente sem respeitar `.gitignore`;
15
+ indexar conteúdo binário; criar um segundo registry específico para o grafo.
16
+ - **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-git/src/index.ts`,
17
+ `apps/cli/src/index.ts`, `apps/server/src/main.ts` e testes Sprint 10.
@@ -1,17 +1,17 @@
1
- # ADR-0068 — Graph sync compartilhado entre CLI e MCP
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-08-01
5
- - **Contexto**: `graph.sync` estava registrável no server, mas o dispatch
6
- standalone e o MCP stdio ainda criavam somente o catálogo legado.
7
- - **Decisão**: `graph:sync` declara `capability: graph.sync` no registry do core;
8
- o adaptador CLI recebe uma composição opcional GraphLoop + Git source e registra
9
- o mesmo handler. O MCP stdio usa essa composição e descobre a ferramenta
10
- dinâmica automaticamente. O resultado inclui contagens, arquivos e duração.
11
- - **Consequências**: CLI, MCP e server compartilham execução e policy; a CLI
12
- mantém um resumo humano e o envelope JSON. O banco local é aberto pela
13
- composição do processo e usa as migrações existentes.
14
- - **Alternativas rejeitadas**: duplicar um handler em `bin/forja`; manter lista
15
- manual de ferramenta MCP; indexar sem `.gitignore`.
16
- - **Evidência**: `lib/core/registry.ts`, `apps/cli/src/index.ts`, `bin/forja.ts`,
17
- `packages/graph/src/index.ts` e testes Sprint 11.
1
+ # ADR-0068 — Graph sync compartilhado entre CLI e MCP
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-08-01
5
+ - **Contexto**: `graph.sync` estava registrável no server, mas o dispatch
6
+ standalone e o MCP stdio ainda criavam somente o catálogo legado.
7
+ - **Decisão**: `graph:sync` declara `capability: graph.sync` no registry do core;
8
+ o adaptador CLI recebe uma composição opcional GraphLoop + Git source e registra
9
+ o mesmo handler. O MCP stdio usa essa composição e descobre a ferramenta
10
+ dinâmica automaticamente. O resultado inclui contagens, arquivos e duração.
11
+ - **Consequências**: CLI, MCP e server compartilham execução e policy; a CLI
12
+ mantém um resumo humano e o envelope JSON. O banco local é aberto pela
13
+ composição do processo e usa as migrações existentes.
14
+ - **Alternativas rejeitadas**: duplicar um handler em `bin/forja`; manter lista
15
+ manual de ferramenta MCP; indexar sem `.gitignore`.
16
+ - **Evidência**: `lib/core/registry.ts`, `apps/cli/src/index.ts`, `bin/forja.ts`,
17
+ `packages/graph/src/index.ts` e testes Sprint 11.
@@ -1,16 +1,16 @@
1
- # ADR-0069 — Demonstração de autonomia com sandbox Git real
2
-
3
- - **Status:** aceito
4
- - **Data:** 2026-08-01
5
- - **Decisão:** o caminho demonstrável de autonomia deve usar uma fixture externa, Git
6
- worktree real, comandos reais, aprovação persistida, Validator independente e
7
- promoção explícita. O agente da fixture pode ser determinístico para manter a prova
8
- offline e repetível.
9
- - **Motivo:** os testes anteriores validavam o contrato do sandbox, mas usavam store e
10
- backend simulados; isso não comprovava isolamento, subprocesso, diff ou promoção.
11
- - **Consequências:** `npm run demo:autonomy` é uma prova operacional e não depende de
12
- LLM. O cenário usa um teste Node nativo para evitar instalação de dependências na
13
- fixture e deixa SQLite, Git e npm observáveis.
14
- - **Evidências:** `scripts/demo-autonomy.ts` e `test/demo-autonomy.test.js`.
15
- - **Próximos passos:** repetir a mesma composição no MCP stdio e no bootstrap oficial
16
- do servidor; adicionar rollback e cenários de caos.
1
+ # ADR-0069 — Demonstração de autonomia com sandbox Git real
2
+
3
+ - **Status:** aceito
4
+ - **Data:** 2026-08-01
5
+ - **Decisão:** o caminho demonstrável de autonomia deve usar uma fixture externa, Git
6
+ worktree real, comandos reais, aprovação persistida, Validator independente e
7
+ promoção explícita. O agente da fixture pode ser determinístico para manter a prova
8
+ offline e repetível.
9
+ - **Motivo:** os testes anteriores validavam o contrato do sandbox, mas usavam store e
10
+ backend simulados; isso não comprovava isolamento, subprocesso, diff ou promoção.
11
+ - **Consequências:** `npm run demo:autonomy` é uma prova operacional e não depende de
12
+ LLM. O cenário usa um teste Node nativo para evitar instalação de dependências na
13
+ fixture e deixa SQLite, Git e npm observáveis.
14
+ - **Evidências:** `scripts/demo-autonomy.ts` e `test/demo-autonomy.test.js`.
15
+ - **Próximos passos:** repetir a mesma composição no MCP stdio e no bootstrap oficial
16
+ do servidor; adicionar rollback e cenários de caos.
@@ -1,11 +1,11 @@
1
- # ADR-0070 — MCP stdio como transporte testado por processo real
2
-
3
- - **Status:** aceito
4
- - **Decisão:** o transporte MCP local usa JSON-RPC delimitado por newline em
5
- stdin/stdout; logs operacionais não podem ocupar stdout. Notificações sem `id`
6
- não recebem resposta. EOF é o shutdown normal.
7
- - **Motivo:** testes unitários do adapter não provavam compatibilidade do processo
8
- lançado pelo usuário nem isolamento do canal de protocolo.
9
- - **Consequências:** o teste inicia o binário real, envia mensagens em sequência e
10
- rejeita stdout não parseável; diagnósticos devem usar stderr.
11
- - **Evidência:** `test/mcp-stdio.test.js`.
1
+ # ADR-0070 — MCP stdio como transporte testado por processo real
2
+
3
+ - **Status:** aceito
4
+ - **Decisão:** o transporte MCP local usa JSON-RPC delimitado por newline em
5
+ stdin/stdout; logs operacionais não podem ocupar stdout. Notificações sem `id`
6
+ não recebem resposta. EOF é o shutdown normal.
7
+ - **Motivo:** testes unitários do adapter não provavam compatibilidade do processo
8
+ lançado pelo usuário nem isolamento do canal de protocolo.
9
+ - **Consequências:** o teste inicia o binário real, envia mensagens em sequência e
10
+ rejeita stdout não parseável; diagnósticos devem usar stderr.
11
+ - **Evidência:** `test/mcp-stdio.test.js`.
@@ -1,12 +1,12 @@
1
- # ADR-0071 — Bootstrap Nest com persistência SQLite completa
2
-
3
- - **Status:** aceito
4
- - **Decisão:** o bootstrap oficial injeta `SqliteRuntimePersistence`,
5
- `SqliteGraphStore`, `SqliteApprovalStore`, `SqliteEventStore`,
6
- `SqliteContextCache`, `SqliteOrchestrationStore` e `SqliteObservationStore`.
7
- Stores em memória ficam restritos a defaults de testes e composição isolada.
8
- - **Motivo:** a composição anterior persistia runtime, approvals, eventos, grafo e
9
- contexto, mas criava orquestração e observabilidade em memória.
10
- - **Consequências:** Sprint/Task/Handoff e métricas sobrevivem ao restart; shutdown
11
- deve drenar publicações assíncronas do Event Bus antes de fechar SQLite.
12
- - **Evidência:** `apps/server/src/main.ts` e `test/server-persistence.test.js`.
1
+ # ADR-0071 — Bootstrap Nest com persistência SQLite completa
2
+
3
+ - **Status:** aceito
4
+ - **Decisão:** o bootstrap oficial injeta `SqliteRuntimePersistence`,
5
+ `SqliteGraphStore`, `SqliteApprovalStore`, `SqliteEventStore`,
6
+ `SqliteContextCache`, `SqliteOrchestrationStore` e `SqliteObservationStore`.
7
+ Stores em memória ficam restritos a defaults de testes e composição isolada.
8
+ - **Motivo:** a composição anterior persistia runtime, approvals, eventos, grafo e
9
+ contexto, mas criava orquestração e observabilidade em memória.
10
+ - **Consequências:** Sprint/Task/Handoff e métricas sobrevivem ao restart; shutdown
11
+ deve drenar publicações assíncronas do Event Bus antes de fechar SQLite.
12
+ - **Evidência:** `apps/server/src/main.ts` e `test/server-persistence.test.js`.
@@ -1,9 +1,9 @@
1
- # ADR-0072 — Limites de ambiente e caminho no adapter Git
2
-
3
- - **Status:** aceito
4
- - **Decisão:** `SpawnCommandRunner` herda apenas variáveis operacionais mínimas
5
- (`PATH`, temporários e `NODE_PATH`) e permite overrides explícitos. O
6
- `GitGraphDocumentSource` rejeita locators que escapem da raiz resolvida.
7
- - **Motivo:** comandos de sandbox não devem copiar secrets do processo e fontes
8
- Git não devem transformar um locator malicioso em leitura fora do workspace.
9
- - **Evidência:** testes de segurança em `test/adapter-git.test.js`.
1
+ # ADR-0072 — Limites de ambiente e caminho no adapter Git
2
+
3
+ - **Status:** aceito
4
+ - **Decisão:** `SpawnCommandRunner` herda apenas variáveis operacionais mínimas
5
+ (`PATH`, temporários e `NODE_PATH`) e permite overrides explícitos. O
6
+ `GitGraphDocumentSource` rejeita locators que escapem da raiz resolvida.
7
+ - **Motivo:** comandos de sandbox não devem copiar secrets do processo e fontes
8
+ Git não devem transformar um locator malicioso em leitura fora do workspace.
9
+ - **Evidência:** testes de segurança em `test/adapter-git.test.js`.
@@ -1,17 +1,17 @@
1
- # ADR-0073 — Última milha: rollback, benchmark e plugins permissionados
2
-
3
- ## Status
4
-
5
- Accepted
6
-
7
- ## Contexto
8
-
9
- O ForjaJS já comprovava promoção de uma alteração em Git worktree, contexto com cache e isolamento de plugins, mas não possuía uma operação de rollback formal, um artefato de benchmark estável nem plugins oficiais registráveis.
10
-
11
- ## Decisão
12
-
13
- Adicionar `rollback` ao contrato `SandboxBackend` e ao `SandboxEngine`, com estado terminal `rolled_back`. O backend Git reverte o patch binário na raiz do repositório através do mesmo `PatchApplier` usado na promoção. O benchmark de contexto emite JSON determinístico com checksum e estimativa documentada de tokens. GitHub e Docker são manifests oficiais mínimos; handlers de rede/daemon são injetados pelo host e nunca implícitos.
14
-
15
- ## Consequências
16
-
17
- Rollback permanece explícito e auditável. A medição pode ser reproduzida em CI, mas tokens continuam uma estimativa bytes/4. Os plugins são extensíveis e permissionados, porém não afirmam uma integração externa até que um adapter real seja fornecido.
1
+ # ADR-0073 — Última milha: rollback, benchmark e plugins permissionados
2
+
3
+ ## Status
4
+
5
+ Accepted
6
+
7
+ ## Contexto
8
+
9
+ O ForjaJS já comprovava promoção de uma alteração em Git worktree, contexto com cache e isolamento de plugins, mas não possuía uma operação de rollback formal, um artefato de benchmark estável nem plugins oficiais registráveis.
10
+
11
+ ## Decisão
12
+
13
+ Adicionar `rollback` ao contrato `SandboxBackend` e ao `SandboxEngine`, com estado terminal `rolled_back`. O backend Git reverte o patch binário na raiz do repositório através do mesmo `PatchApplier` usado na promoção. O benchmark de contexto emite JSON determinístico com checksum e estimativa documentada de tokens. GitHub e Docker são manifests oficiais mínimos; handlers de rede/daemon são injetados pelo host e nunca implícitos.
14
+
15
+ ## Consequências
16
+
17
+ Rollback permanece explícito e auditável. A medição pode ser reproduzida em CI, mas tokens continuam uma estimativa bytes/4. Os plugins são extensíveis e permissionados, porém não afirmam uma integração externa até que um adapter real seja fornecido.