forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,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.
@@ -0,0 +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.
@@ -0,0 +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`.
@@ -0,0 +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`.
@@ -0,0 +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`.
@@ -0,0 +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.
@@ -0,0 +1,51 @@
1
+ # ADR-0074: LLM Fit Loop por adapters de CLI
2
+
3
+ - **Status**: proposed
4
+ - **Data**: 2026-08-17
5
+ - **Autor(es)**: Allan Pablo
6
+ - **Tags**: llm, cli, observability, local-first, security
7
+
8
+ ## Contexto
9
+
10
+ O ForjaJS já preserva `Observation`, avaliação determinística e execução supervisionada, mas o
11
+ roteamento de LLMs era uma configuração estática de dashboard, com paths locais e sem evidência de
12
+ qual perfil funcionou para cada papel ou tarefa. Chamar SDKs diretamente concentraria credenciais no
13
+ framework e contrariaria a operação local-first. A escolha precisa continuar explícita, auditável e
14
+ independente do fornecedor.
15
+
16
+ ## Decisão
17
+
18
+ Adotar perfis de LLM no workspace e adapters de CLI sem shell. O Forja registra somente metadata de
19
+ execução e hashes: perfis, executável, modelo, tipo de tarefa, duração, tokens estimados e resultado.
20
+ Credenciais, prompts e respostas não são persistidos. `llm:recommend` ordena perfis por compatibilidade
21
+ declarada e observações locais; não altera a rota automaticamente.
22
+
23
+ ## Alternativas consideradas
24
+
25
+ - **SDKs/API keys de cada fornecedor no core**: rejeitada porque amplia a superfície de segredo,
26
+ acopla releases aos fornecedores e exclui CLIs autenticadas pelo operador.
27
+ - **Manter o routing no dashboard**: rejeitada porque uma superfície opcional não pode ser o caminho
28
+ de configuração, execução e auditoria de uma operação CLI-first.
29
+ - **Failover automático por custo ou latência**: rejeitada no MVP porque troca silenciosamente a
30
+ fronteira de privacidade e não possui evidência suficiente por tipo de tarefa.
31
+
32
+ ## Consequências
33
+
34
+ **Positivas**:
35
+ - Conectores de Codex, Claude, Gemini, Ollama e executáveis compatíveis usam um contrato único.
36
+ - A recomendação usa dados persistidos e a avaliação existente, sem uma LLM julgando outra LLM.
37
+ - Perfis são portáveis dentro do workspace e não expõem API keys.
38
+
39
+ **Negativas / Trade-offs**:
40
+ - Cada CLI continua responsável por autenticação, formato de custo e disponibilidade.
41
+ - Tokens são estimados por bytes/4 quando o adapter não fornece telemetria do provedor.
42
+ - A execução inicial é de leitura; mudanças de arquivos permanecem no runtime/sandbox supervisionado.
43
+ - O dashboard legado perde a execução direta de modelos; ele continua apenas como leitura/edição de
44
+ perfis do workspace.
45
+
46
+ ## Rastreamento
47
+
48
+ - Implementação: `packages/llm/src/index.ts`, `scripts/llm-fit.ts`, `lib/core/registry.ts`, `dashboard/server/`
49
+ - Testes: `test/llm-fit.test.js`
50
+ - Documentação: `docs/llm-fit-loop.md`, `skills/llm-provider-routing/SKILL.md`
51
+ - ADRs relacionadas: ADR-0037, ADR-0049, ADR-0052, ADR-0059
@@ -0,0 +1,43 @@
1
+ # ADR-0075: Workspace de demonstração isolado
2
+
3
+ - **Status**: proposed
4
+ - **Data**: 2026-08-17
5
+ - **Autor(es)**: Allan Pablo
6
+ - **Tags**: demo, workspace, marketing, local-first
7
+
8
+ ## Contexto
9
+
10
+ O dashboard e a demonstração comercial precisam de artefatos visuais, mas usar dados reais de produto
11
+ expõe contexto e torna a apresentação irreproduzível. Uma UI vazia também não permite demonstrar o
12
+ fluxo SDD, handoffs, memória e observabilidade.
13
+
14
+ ## Decisão
15
+
16
+ Adicionar `forja demo:workspace`, que cria por padrão `~/forja-demo-workspace`, separado do workspace
17
+ de produção. O cenário é explicitamente marcado, contém apenas dados sintéticos e recusa escrever em
18
+ um diretório existente sem o selo de demo.
19
+
20
+ ## Alternativas consideradas
21
+
22
+ - **Preencher o workspace padrão**: rejeitada porque mistura dados de apresentação e dados reais.
23
+ - **Usar screenshots estáticos**: rejeitada porque não prova que CLI, SQLite e dashboard lêem o mesmo
24
+ cenário local.
25
+ - **Chamar uma LLM para gerar dados**: rejeitada porque torna a demo variável, pode exigir credenciais
26
+ e não acrescenta prova de produto.
27
+
28
+ ## Consequências
29
+
30
+ **Positivas**:
31
+ - Demonstrações reproduzíveis mostram artefatos reais do ForjaJS sem dados de cliente.
32
+ - Dashboard, CLI e observabilidade podem ser apresentados com a mesma fonte local.
33
+
34
+ **Negativas / Trade-offs**:
35
+ - Os dados precisam permanecer explicitamente rotulados como sintéticos.
36
+ - O cenário não substitui uma prova de autonomia com Git real, coberta por `demo:autonomy`.
37
+
38
+ ## Rastreamento
39
+
40
+ - Implementação: `scripts/demo-workspace.ts`, `lib/core/registry.ts`
41
+ - Testes: `test/demo-workspace.test.js`
42
+ - Documentação: `docs/produto/roteiro-demo.md`
43
+ - ADRs relacionadas: ADR-0019, ADR-0069, ADR-0074