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
- # Handoff — foundation contracts
2
-
3
- - **from**: architect
4
- - **to**: worker
5
- - **intent**: implement
6
- - **context**: `docs/vision/FORJA-2.0-VISION.md`; `docs/architecture/FORJA-2.0-ARCHITECTURE.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0034-forja-2-core-e-contratos.md`; `memory/90-decisions/0035-forja-2-local-first-e-autonomia.md`; `packages/contracts/src/index.ts`
7
- - **acceptance**: criar `packages/core` sem imports de framework; registrar capabilities versionadas; rejeitar input inválido antes do handler; retornar `ExecutionResult`; cobrir descoberta, descrição, alias e execução com testes determinísticos.
8
- - **constraints**: manter TypeScript estrito; não alterar CLI 1.x; não usar `any`; não introduzir SQLite/Nest/MCP; usar apenas contratos existentes ou abrir ADR para mudança.
9
- - **return**: devolver arquivos alterados, testes, evidências, riscos e próximo handoff em `memory/50-orchestration/handoffs/`.
10
-
11
- ## Resultado da etapa anterior
12
-
13
- Visão, arquitetura, impacto e contratos foram criados. `npm run types:check` passa e `npm test`
14
- passa com 196 testes. GraphLoop e memória consolidada 2.0 ainda não existem; atualização fica
15
- explicitamente pendente da implementação desses módulos.
1
+ # Handoff — foundation contracts
2
+
3
+ - **from**: architect
4
+ - **to**: worker
5
+ - **intent**: implement
6
+ - **context**: `docs/vision/FORJA-2.0-VISION.md`; `docs/architecture/FORJA-2.0-ARCHITECTURE.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0034-forja-2-core-e-contratos.md`; `memory/90-decisions/0035-forja-2-local-first-e-autonomia.md`; `packages/contracts/src/index.ts`
7
+ - **acceptance**: criar `packages/core` sem imports de framework; registrar capabilities versionadas; rejeitar input inválido antes do handler; retornar `ExecutionResult`; cobrir descoberta, descrição, alias e execução com testes determinísticos.
8
+ - **constraints**: manter TypeScript estrito; não alterar CLI 1.x; não usar `any`; não introduzir SQLite/Nest/MCP; usar apenas contratos existentes ou abrir ADR para mudança.
9
+ - **return**: devolver arquivos alterados, testes, evidências, riscos e próximo handoff em `memory/50-orchestration/handoffs/`.
10
+
11
+ ## Resultado da etapa anterior
12
+
13
+ Visão, arquitetura, impacto e contratos foram criados. `npm run types:check` passa e `npm test`
14
+ passa com 196 testes. GraphLoop e memória consolidada 2.0 ainda não existem; atualização fica
15
+ explicitamente pendente da implementação desses módulos.
@@ -1,22 +1,22 @@
1
- # Handoff — backend Nest adapter
2
-
3
- - **from**: backend-application-engineer
4
- - **to**: nest-bootstrap-engineer
5
- - **intent**: implement
6
- - **context**: `packages/adapter-nest/src/index.ts`; `apps/server/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: fronteira REST/SSE possui correlation IDs, autenticação local, OpenAPI e erros normalizados; `apps/server` compõe módulos oficiais; nenhuma regra crítica vive no frontend/controller.
8
- - **constraints**: manter core sem NestJS; usar Policy/Registry/MCP como fontes de autorização/execução; REST + SSE inicialmente; não adicionar WebSocket sem requisito; não inventar dados de recursos.
9
- - **return**: instalar/configurar NestJS oficialmente, criar bootstrap `main`, módulos/controllers/guards/swagger que deleguem ao adapter, health check, autenticação local e teste e2e determinístico.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/adapter-nest.test.js`: passou.
15
- - `git diff --check`: passou.
16
- - Dependência NestJS ainda ausente; bootstrap real permanece pendente.
17
-
18
- ## Métricas de tokens
19
-
20
- - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
21
- - consumo de LLM: não aplicável; roteamento HTTP, autenticação e OpenAPI foram determinísticos;
22
- - cache: não aplicável nesta unidade.
1
+ # Handoff — backend Nest adapter
2
+
3
+ - **from**: backend-application-engineer
4
+ - **to**: nest-bootstrap-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/adapter-nest/src/index.ts`; `apps/server/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: fronteira REST/SSE possui correlation IDs, autenticação local, OpenAPI e erros normalizados; `apps/server` compõe módulos oficiais; nenhuma regra crítica vive no frontend/controller.
8
+ - **constraints**: manter core sem NestJS; usar Policy/Registry/MCP como fontes de autorização/execução; REST + SSE inicialmente; não adicionar WebSocket sem requisito; não inventar dados de recursos.
9
+ - **return**: instalar/configurar NestJS oficialmente, criar bootstrap `main`, módulos/controllers/guards/swagger que deleguem ao adapter, health check, autenticação local e teste e2e determinístico.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/adapter-nest.test.js`: passou.
15
+ - `git diff --check`: passou.
16
+ - Dependência NestJS ainda ausente; bootstrap real permanece pendente.
17
+
18
+ ## Métricas de tokens
19
+
20
+ - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
21
+ - consumo de LLM: não aplicável; roteamento HTTP, autenticação e OpenAPI foram determinísticos;
22
+ - cache: não aplicável nesta unidade.
@@ -1,16 +1,16 @@
1
- # Handoff — context engine
2
-
3
- - **from**: context-engineer
4
- - **to**: graph-engineer
5
- - **intent**: implement
6
- - **context**: `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0040-forja-2-context-engine-budget-cache.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0017-codegraph-no-harness-gsd.md`
7
- - **acceptance**: GraphLoop deve persistir nós/arestas/evidências com status e validade; extrair imports, links Markdown, specs, ADRs, commits, diffs, tarefas, handoffs e testes deterministicamente; consultar caminho, impacto, contradições e lacunas; nenhuma aresta sem origem.
8
- - **constraints**: separar GraphLoop de CodeGraph; não importar NestJS/Next/SQLite no domínio; LLM apenas para relação semiestruturada com confiança/evidência/status; manter Context Engine consumível por porta.
9
- - **return**: devolver entidades, consultas, extractors, invariantes, testes de consistência e próximo handoff.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - Testes combinados: 7 arquivos passaram.
15
- - Cenários: seleção por relevância, deduplicação, obsoletos, contraditos, orçamento, cache,
16
- expansão e ausência de evidência.
1
+ # Handoff — context engine
2
+
3
+ - **from**: context-engineer
4
+ - **to**: graph-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0040-forja-2-context-engine-budget-cache.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0017-codegraph-no-harness-gsd.md`
7
+ - **acceptance**: GraphLoop deve persistir nós/arestas/evidências com status e validade; extrair imports, links Markdown, specs, ADRs, commits, diffs, tarefas, handoffs e testes deterministicamente; consultar caminho, impacto, contradições e lacunas; nenhuma aresta sem origem.
8
+ - **constraints**: separar GraphLoop de CodeGraph; não importar NestJS/Next/SQLite no domínio; LLM apenas para relação semiestruturada com confiança/evidência/status; manter Context Engine consumível por porta.
9
+ - **return**: devolver entidades, consultas, extractors, invariantes, testes de consistência e próximo handoff.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - Testes combinados: 7 arquivos passaram.
15
+ - Cenários: seleção por relevância, deduplicação, obsoletos, contraditos, orçamento, cache,
16
+ expansão e ausência de evidência.
@@ -1,28 +1,28 @@
1
- # Handoff — Control Plane operacional
2
-
3
- - **from**: control-plane-observability-engineer
4
- - **to**: runtime-application-engineer
5
- - **intent**: implement
6
- - **context**: `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `memory/90-decisions/0050-forja-2-control-plane-application-ports.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: rotas Runtime existem; Control Plane delega operações; Sprint/Task/Handoff/Approvals usam engines reais; observações publicam SSE; ausência de composição falha explicitamente.
8
- - **constraints**: não usar planner vazio; Runtime só inicia com budget, agent, policy, planner e validator; nenhuma conclusão sem validator; preservar Policy e checkpoints.
9
- - **return**: compor `RuntimeEngine` com planner determinístico ou request planner explícito, validator independente, checkpoint store SQLite, PolicyEngine e recorder de observações; implementar start/execute/pause/resume/cancel/get no bootstrap.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - 17 arquivos de testes passaram.
16
- - smoke test Nest/Control Plane: `control-plane-bootstrap-ok true`.
17
- - `git diff --check`: passou.
18
-
19
- ## Pendência crítica
20
-
21
- Runtime ainda não é habilitado por padrão até existir composição verificável de planner, validator
22
- e policy. Isso é bloqueio de segurança/validade, não falha de transporte.
23
-
24
- ## Métricas de tokens
25
-
26
- - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
27
- - consumo de LLM: não aplicável; composição, rotas e eventos foram determinísticos;
28
- - cache: não aplicável nesta unidade.
1
+ # Handoff — Control Plane operacional
2
+
3
+ - **from**: control-plane-observability-engineer
4
+ - **to**: runtime-application-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `memory/90-decisions/0050-forja-2-control-plane-application-ports.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: rotas Runtime existem; Control Plane delega operações; Sprint/Task/Handoff/Approvals usam engines reais; observações publicam SSE; ausência de composição falha explicitamente.
8
+ - **constraints**: não usar planner vazio; Runtime só inicia com budget, agent, policy, planner e validator; nenhuma conclusão sem validator; preservar Policy e checkpoints.
9
+ - **return**: compor `RuntimeEngine` com planner determinístico ou request planner explícito, validator independente, checkpoint store SQLite, PolicyEngine e recorder de observações; implementar start/execute/pause/resume/cancel/get no bootstrap.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - 17 arquivos de testes passaram.
16
+ - smoke test Nest/Control Plane: `control-plane-bootstrap-ok true`.
17
+ - `git diff --check`: passou.
18
+
19
+ ## Pendência crítica
20
+
21
+ Runtime ainda não é habilitado por padrão até existir composição verificável de planner, validator
22
+ e policy. Isso é bloqueio de segurança/validade, não falha de transporte.
23
+
24
+ ## Métricas de tokens
25
+
26
+ - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
27
+ - consumo de LLM: não aplicável; composição, rotas e eventos foram determinísticos;
28
+ - cache: não aplicável nesta unidade.
@@ -1,15 +1,15 @@
1
- # Handoff — capability registry
2
-
3
- - **from**: worker
4
- - **to**: architect
5
- - **intent**: review
6
- - **context**: `packages/core/src/index.ts`; `packages/core/package.json`; `test/capability-registry.test.js`; `memory/90-decisions/0036-forja-2-capability-registry.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: registry registra definições versionadas; descobre por id e alias; filtra por permissões; valida entrada antes do handler; aplica Policy; suporta handler síncrono/assíncrono; retorna `ExecutionResult`; não importa framework ou persistência.
8
- - **constraints**: não alterar CLI 1.x; manter contratos existentes; nenhum `any`; não adicionar dependência de runtime.
9
- - **return**: revisar tipagem, política de depreciação, semântica de `ALLOW_WITH_LIMITS` e compatibilidade dos adapters antes de abrir a próxima tarefa.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - Testes focados de contracts + registry: passaram.
15
- - `npm test`: 18 arquivos passaram; 5 arquivos legados falharam por `spawnSync ... EPERM` no ambiente sandbox, sem erro de assertion no núcleo novo.
1
+ # Handoff — capability registry
2
+
3
+ - **from**: worker
4
+ - **to**: architect
5
+ - **intent**: review
6
+ - **context**: `packages/core/src/index.ts`; `packages/core/package.json`; `test/capability-registry.test.js`; `memory/90-decisions/0036-forja-2-capability-registry.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: registry registra definições versionadas; descobre por id e alias; filtra por permissões; valida entrada antes do handler; aplica Policy; suporta handler síncrono/assíncrono; retorna `ExecutionResult`; não importa framework ou persistência.
8
+ - **constraints**: não alterar CLI 1.x; manter contratos existentes; nenhum `any`; não adicionar dependência de runtime.
9
+ - **return**: revisar tipagem, política de depreciação, semântica de `ALLOW_WITH_LIMITS` e compatibilidade dos adapters antes de abrir a próxima tarefa.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - Testes focados de contracts + registry: passaram.
15
+ - `npm test`: 18 arquivos passaram; 5 arquivos legados falharam por `spawnSync ... EPERM` no ambiente sandbox, sem erro de assertion no núcleo novo.
@@ -1,22 +1,22 @@
1
- # Handoff — Evaluation Engine e Plugin SDK
2
-
3
- - **from**: evals-plugin-engineer
4
- - **to**: dashboard-worker-engineer
5
- - **intent**: implement
6
- - **context**: `packages/evals/src/index.ts`; `packages/plugin-sdk/src/index.ts`; `packages/contracts/src/index.ts`; ADR-0052; ADR-0053; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: `EvaluationEngine` produz relatório determinístico referenciado por observações; `PluginRegistry` valida manifesto, rejeita duplicidade e nega operações sem permissão; typecheck/build/testes focados passam.
8
- - **constraints**: não usar LLM para métricas; não dar acesso direto a recursos do host; não tratar metadados de assinatura/migration/dashboard como execução autorizada; preservar contratos versionados.
9
- - **return**: integrar avaliações e métricas no Control Plane/dashboard, preparar worker/scheduler para avaliação e avançar a validação final.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `node --import tsx --test test/evals.test.js test/plugin-sdk.test.js`: 2 arquivos, 5 testes, passou.
16
- - `git diff --check`: pendente nesta unidade.
17
-
18
- ## Métricas de tokens
19
-
20
- - consumo de LLM: não aplicável; avaliação e autorização são determinísticas;
21
- - orçamento de execução: não aplicável; unidade sem execução de agente;
22
- - observações consumidas pelos testes: 3 na avaliação principal.
1
+ # Handoff — Evaluation Engine e Plugin SDK
2
+
3
+ - **from**: evals-plugin-engineer
4
+ - **to**: dashboard-worker-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/evals/src/index.ts`; `packages/plugin-sdk/src/index.ts`; `packages/contracts/src/index.ts`; ADR-0052; ADR-0053; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: `EvaluationEngine` produz relatório determinístico referenciado por observações; `PluginRegistry` valida manifesto, rejeita duplicidade e nega operações sem permissão; typecheck/build/testes focados passam.
8
+ - **constraints**: não usar LLM para métricas; não dar acesso direto a recursos do host; não tratar metadados de assinatura/migration/dashboard como execução autorizada; preservar contratos versionados.
9
+ - **return**: integrar avaliações e métricas no Control Plane/dashboard, preparar worker/scheduler para avaliação e avançar a validação final.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `node --import tsx --test test/evals.test.js test/plugin-sdk.test.js`: 2 arquivos, 5 testes, passou.
16
+ - `git diff --check`: pendente nesta unidade.
17
+
18
+ ## Métricas de tokens
19
+
20
+ - consumo de LLM: não aplicável; avaliação e autorização são determinísticas;
21
+ - orçamento de execução: não aplicável; unidade sem execução de agente;
22
+ - observações consumidas pelos testes: 3 na avaliação principal.
@@ -1,16 +1,16 @@
1
- # Handoff — events and scheduler
2
-
3
- - **from**: worker
4
- - **to**: context-engineer
5
- - **intent**: implement
6
- - **context**: `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Context Engine deve selecionar referências por checksums e orçamento; cachear sem reenviar conteúdo inalterado; consumir memória/GraphLoop por portas; produzir `ContextPackage` auditável; não chamar LLM para busca/diff/imports/SQL.
8
- - **constraints**: domínio sem NestJS/Next/SQLite; não remover semântica append-only/idempotente; preservar retries/dead-letter; manter CLI 1.x intacta.
9
- - **return**: devolver implementação, testes de cache/budget, evidências de tokens, riscos e próximo handoff.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node test/events-scheduler.test.js`: 7 testes passaram.
15
- - Cenários: sequência/idempotência, retry, dead-letter, one-shot, cron, condição, evento,
16
- cancelamento e concorrência.
1
+ # Handoff — events and scheduler
2
+
3
+ - **from**: worker
4
+ - **to**: context-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Context Engine deve selecionar referências por checksums e orçamento; cachear sem reenviar conteúdo inalterado; consumir memória/GraphLoop por portas; produzir `ContextPackage` auditável; não chamar LLM para busca/diff/imports/SQL.
8
+ - **constraints**: domínio sem NestJS/Next/SQLite; não remover semântica append-only/idempotente; preservar retries/dead-letter; manter CLI 1.x intacta.
9
+ - **return**: devolver implementação, testes de cache/budget, evidências de tokens, riscos e próximo handoff.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node test/events-scheduler.test.js`: 7 testes passaram.
15
+ - Cenários: sequência/idempotência, retry, dead-letter, one-shot, cron, condição, evento,
16
+ cancelamento e concorrência.
@@ -1,16 +1,16 @@
1
- # Handoff — GraphLoop
2
-
3
- - **from**: graph-engineer
4
- - **to**: planner-validator
5
- - **intent**: implement
6
- - **context**: `packages/graph/src/index.ts`; `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Planner consulta GraphLoop e Context Engine, cria etapas pequenas com dependências, risco, orçamento e critérios objetivos; Validator verifica build, testes, lint, typecheck, escopo, critérios, contradições e segurança básica; resultado tem status e evidências.
8
- - **constraints**: domínio sem NestJS/Next/SQLite; não atravessar arestas sem evidência; não tratar hipótese como fato; determinismo antes de LLM; manter CodeGraph como adapter/fonte opcional.
9
- - **return**: devolver Planner/Validator, testes de falsa conclusão e próximo handoff para Sprint/Task/Handoff.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node test/graph.test.js`: 5 testes passaram.
15
- - Cenários: endpoints/evidências obrigatórios, path, impacto, validade temporal, contradição,
16
- agenda, sync incremental e imports/links determinísticos.
1
+ # Handoff — GraphLoop
2
+
3
+ - **from**: graph-engineer
4
+ - **to**: planner-validator
5
+ - **intent**: implement
6
+ - **context**: `packages/graph/src/index.ts`; `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Planner consulta GraphLoop e Context Engine, cria etapas pequenas com dependências, risco, orçamento e critérios objetivos; Validator verifica build, testes, lint, typecheck, escopo, critérios, contradições e segurança básica; resultado tem status e evidências.
8
+ - **constraints**: domínio sem NestJS/Next/SQLite; não atravessar arestas sem evidência; não tratar hipótese como fato; determinismo antes de LLM; manter CodeGraph como adapter/fonte opcional.
9
+ - **return**: devolver Planner/Validator, testes de falsa conclusão e próximo handoff para Sprint/Task/Handoff.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node test/graph.test.js`: 5 testes passaram.
15
+ - Cenários: endpoints/evidências obrigatórios, path, impacto, validade temporal, contradição,
16
+ agenda, sync incremental e imports/links determinísticos.
@@ -1,21 +1,21 @@
1
- # Handoff — MCP adapter
2
-
3
- - **from**: mcp-application-engineer
4
- - **to**: backend-application-engineer
5
- - **intent**: implement
6
- - **context**: `packages/mcp/src/index.ts`; `packages/core/src/index.ts`; `packages/context/src/index.ts`; `packages/graph/src/index.ts`; `packages/orchestration/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `memory/90-decisions/0046-forja-2-mcp-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: tools e recursos oficiais são descobríveis; chamadas delegam aos engines; inputs inválidos e dependências ausentes geram erros estruturados; identidade e Policy são transportadas; MCP não duplica domínio.
8
- - **constraints**: sem lógica de negócio no adapter; Registry é a única execução de capability; dados de recursos devem vir de providers; nenhuma ação mutável ignora Policy; manter operação local/offline.
9
- - **return**: integrar `packages/adapter-nest` e `apps/server` com REST + SSE, OpenAPI, correlation IDs, autenticação local e composição dos adapters sem contaminar o domínio.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/mcp.test.js`: passou.
15
- - `git diff --check`: passou.
16
-
17
- ## Métricas de tokens
18
-
19
- - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
20
- - consumo de LLM: não aplicável; dispatch, validação e normalização foram determinísticos;
21
- - cache: não aplicável nesta unidade.
1
+ # Handoff — MCP adapter
2
+
3
+ - **from**: mcp-application-engineer
4
+ - **to**: backend-application-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/mcp/src/index.ts`; `packages/core/src/index.ts`; `packages/context/src/index.ts`; `packages/graph/src/index.ts`; `packages/orchestration/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `memory/90-decisions/0046-forja-2-mcp-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: tools e recursos oficiais são descobríveis; chamadas delegam aos engines; inputs inválidos e dependências ausentes geram erros estruturados; identidade e Policy são transportadas; MCP não duplica domínio.
8
+ - **constraints**: sem lógica de negócio no adapter; Registry é a única execução de capability; dados de recursos devem vir de providers; nenhuma ação mutável ignora Policy; manter operação local/offline.
9
+ - **return**: integrar `packages/adapter-nest` e `apps/server` com REST + SSE, OpenAPI, correlation IDs, autenticação local e composição dos adapters sem contaminar o domínio.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/mcp.test.js`: passou.
15
+ - `git diff --check`: passou.
16
+
17
+ ## Métricas de tokens
18
+
19
+ - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
20
+ - consumo de LLM: não aplicável; dispatch, validação e normalização foram determinísticos;
21
+ - cache: não aplicável nesta unidade.
@@ -1,28 +1,28 @@
1
- # Handoff — Nest bootstrap
2
-
3
- - **from**: nest-bootstrap-engineer
4
- - **to**: sdk-control-plane-engineer
5
- - **intent**: implement
6
- - **context**: `apps/server/src/main.ts`; `apps/server/src/app.module.ts`; `apps/server/src/forja-nest.module.ts`; `packages/adapter-nest/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: NestJS instalado; módulo dinâmico, controller REST/SSE, guard de autenticação local, Swagger e correlation IDs delegam ao adapter; bootstrap compilado inicializa com sucesso.
8
- - **constraints**: core sem NestJS; controller sem regra de domínio; Policy/Registry/MCP são fontes de autorização e execução; WebSocket não entra; `npm audit fix --force` não foi executado.
9
- - **return**: implementar `packages/sdk` e interfaces do Control Plane para consumir REST/SSE, descobrir capabilities, iniciar/acompanhar runtime, responder approvals e expor métricas auditáveis.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - smoke test compilado: `nest-bootstrap-ok true`.
16
- - `node --test test/adapter-nest.test.js`: passou.
17
- - `git diff --check`: passou.
18
-
19
- ## Riscos
20
-
21
- - npm reportou duas vulnerabilidades high no conjunto de dependências; a correção automática foi adiada para revisão própria.
22
- - Testes com decorators devem usar build prévio; o runner Node strip-only não executa decorators TypeScript.
23
-
24
- ## Métricas de tokens
25
-
26
- - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
27
- - consumo de LLM: não aplicável; bootstrap, compilação e smoke test foram determinísticos;
28
- - cache: não aplicável nesta unidade.
1
+ # Handoff — Nest bootstrap
2
+
3
+ - **from**: nest-bootstrap-engineer
4
+ - **to**: sdk-control-plane-engineer
5
+ - **intent**: implement
6
+ - **context**: `apps/server/src/main.ts`; `apps/server/src/app.module.ts`; `apps/server/src/forja-nest.module.ts`; `packages/adapter-nest/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: NestJS instalado; módulo dinâmico, controller REST/SSE, guard de autenticação local, Swagger e correlation IDs delegam ao adapter; bootstrap compilado inicializa com sucesso.
8
+ - **constraints**: core sem NestJS; controller sem regra de domínio; Policy/Registry/MCP são fontes de autorização e execução; WebSocket não entra; `npm audit fix --force` não foi executado.
9
+ - **return**: implementar `packages/sdk` e interfaces do Control Plane para consumir REST/SSE, descobrir capabilities, iniciar/acompanhar runtime, responder approvals e expor métricas auditáveis.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - smoke test compilado: `nest-bootstrap-ok true`.
16
+ - `node --test test/adapter-nest.test.js`: passou.
17
+ - `git diff --check`: passou.
18
+
19
+ ## Riscos
20
+
21
+ - npm reportou duas vulnerabilidades high no conjunto de dependências; a correção automática foi adiada para revisão própria.
22
+ - Testes com decorators devem usar build prévio; o runner Node strip-only não executa decorators TypeScript.
23
+
24
+ ## Métricas de tokens
25
+
26
+ - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
27
+ - consumo de LLM: não aplicável; bootstrap, compilação e smoke test foram determinísticos;
28
+ - cache: não aplicável nesta unidade.
@@ -1,22 +1,22 @@
1
- # Handoff — Distribuição Next.js inicial
2
-
3
- - **from**: next-distribution-engineer
4
- - **to**: control-plane-ui-engineer
5
- - **intent**: implement
6
- - **context**: `apps/dashboard/app/page.tsx`; `apps/dashboard/app/dashboard-client.tsx`; `apps/dashboard/app/globals.css`; `apps/dashboard/next.config.mjs`; ADR-0055; `apps/dashboard/src/index.ts`
7
- - **acceptance**: dashboard Next compila em produção, carrega métricas/observações via REST, reage a SSE e não contém regra crítica ou acesso direto à persistência.
8
- - **constraints**: manter Next em versão corrigida; não autorizar no cliente; não usar `audit fix --force`; preservar boundary do Control Plane.
9
- - **return**: implementar autenticação local, TanStack Query, ações de aprovação/pausa/cancelamento, áreas de Sprints/Tasks/Agents/GraphLoop e testes de UI/contrato.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run dashboard:build`: passou com Next 15.5.9.
15
- - `npm test`: pendente após esta unidade.
16
- - `git diff --check`: pendente após esta unidade.
17
-
18
- ## Métricas de tokens
19
-
20
- - consumo de LLM: não aplicável;
21
- - página inicial: métricas e observações carregadas deterministicamente;
22
- - eventos: atualização por SSE, sem reprocessamento de histórico no cliente.
1
+ # Handoff — Distribuição Next.js inicial
2
+
3
+ - **from**: next-distribution-engineer
4
+ - **to**: control-plane-ui-engineer
5
+ - **intent**: implement
6
+ - **context**: `apps/dashboard/app/page.tsx`; `apps/dashboard/app/dashboard-client.tsx`; `apps/dashboard/app/globals.css`; `apps/dashboard/next.config.mjs`; ADR-0055; `apps/dashboard/src/index.ts`
7
+ - **acceptance**: dashboard Next compila em produção, carrega métricas/observações via REST, reage a SSE e não contém regra crítica ou acesso direto à persistência.
8
+ - **constraints**: manter Next em versão corrigida; não autorizar no cliente; não usar `audit fix --force`; preservar boundary do Control Plane.
9
+ - **return**: implementar autenticação local, TanStack Query, ações de aprovação/pausa/cancelamento, áreas de Sprints/Tasks/Agents/GraphLoop e testes de UI/contrato.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run dashboard:build`: passou com Next 15.5.9.
15
+ - `npm test`: pendente após esta unidade.
16
+ - `git diff --check`: pendente após esta unidade.
17
+
18
+ ## Métricas de tokens
19
+
20
+ - consumo de LLM: não aplicável;
21
+ - página inicial: métricas e observações carregadas deterministicamente;
22
+ - eventos: atualização por SSE, sem reprocessamento de histórico no cliente.
@@ -1,27 +1,27 @@
1
- # Handoff — observability e Control Plane
2
-
3
- - **from**: control-plane-observability-engineer
4
- - **to**: runtime-application-engineer
5
- - **intent**: implement
6
- - **context**: `packages/observability/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0049-forja-2-observability-control-plane.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Observations auditáveis são persistidas; métricas por run/agent/task/sprint/capability incluem tokens, custo, duração, outcome e evidência; endpoints de métricas/observações delegam ao Control Plane.
8
- - **constraints**: sem agregação no controller/dashboard; sem LLM para métricas; preservar append-only/idempotência; não declarar runtime/approvals/Sprint/Task concluídos sem application service real.
9
- - **return**: integrar Runtime, Policy approvals e Orchestration ao Control Plane, implementar rotas `/api/executions`, `/api/approvals`, `/api/sprints` e `/api/tasks`, publicar observações e eventos SSE.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - testes focados de observabilidade, Nest e SDK passaram.
16
- - `git diff --check`: passou.
17
-
18
- ## Riscos
19
-
20
- - npm mantém duas vulnerabilidades high pendentes de revisão.
21
- - Rotas de runtime, approvals e CRUD ainda são pendência do próximo application service.
22
-
23
- ## Métricas de tokens
24
-
25
- - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
26
- - consumo de LLM: não aplicável; registro e agregação foram determinísticos;
27
- - cache: não aplicável nesta unidade.
1
+ # Handoff — observability e Control Plane
2
+
3
+ - **from**: control-plane-observability-engineer
4
+ - **to**: runtime-application-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/observability/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0049-forja-2-observability-control-plane.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Observations auditáveis são persistidas; métricas por run/agent/task/sprint/capability incluem tokens, custo, duração, outcome e evidência; endpoints de métricas/observações delegam ao Control Plane.
8
+ - **constraints**: sem agregação no controller/dashboard; sem LLM para métricas; preservar append-only/idempotência; não declarar runtime/approvals/Sprint/Task concluídos sem application service real.
9
+ - **return**: integrar Runtime, Policy approvals e Orchestration ao Control Plane, implementar rotas `/api/executions`, `/api/approvals`, `/api/sprints` e `/api/tasks`, publicar observações e eventos SSE.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - testes focados de observabilidade, Nest e SDK passaram.
16
+ - `git diff --check`: passou.
17
+
18
+ ## Riscos
19
+
20
+ - npm mantém duas vulnerabilidades high pendentes de revisão.
21
+ - Rotas de runtime, approvals e CRUD ainda são pendência do próximo application service.
22
+
23
+ ## Métricas de tokens
24
+
25
+ - orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
26
+ - consumo de LLM: não aplicável; registro e agregação foram determinísticos;
27
+ - cache: não aplicável nesta unidade.
@@ -1,21 +1,21 @@
1
- # Handoff — orchestration engine
2
-
3
- - **from**: orchestration-engineer
4
- - **to**: sandbox-adapter-engineer
5
- - **intent**: implement
6
- - **context**: `packages/orchestration/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0043-forja-2-orchestration-entities.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Sprint, Task e Handoff usam persistência por porta; dependências e retomada funcionam; conclusões exigem validator aceito; handoff incompleto é rejeitado e compactado; registros do GraphLoop recebem evidências.
8
- - **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa; não permitir conclusão declarativa do executor; manter contratos versionados e trilha auditável.
9
- - **return**: implementar `packages/sandbox` e adapters iniciais por portas, com fluxo create → prepare → execute → validate → diff → promote/reject → destroy e testes de isolamento/limpeza.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/orchestration.test.js`: 1 arquivo, 3 cenários, passou.
15
- - `git diff --check`: passou.
16
-
17
- ## Métricas de tokens
18
-
19
- - orçamento explícito desta unidade: 150 tokens de entrada e 50 de saída nos fixtures de teste;
20
- - consumo de LLM: não aplicável; implementação e validação foram determinísticas;
21
- - cache de contexto: não aplicável nesta unidade.
1
+ # Handoff — orchestration engine
2
+
3
+ - **from**: orchestration-engineer
4
+ - **to**: sandbox-adapter-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/orchestration/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0043-forja-2-orchestration-entities.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Sprint, Task e Handoff usam persistência por porta; dependências e retomada funcionam; conclusões exigem validator aceito; handoff incompleto é rejeitado e compactado; registros do GraphLoop recebem evidências.
8
+ - **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa; não permitir conclusão declarativa do executor; manter contratos versionados e trilha auditável.
9
+ - **return**: implementar `packages/sandbox` e adapters iniciais por portas, com fluxo create → prepare → execute → validate → diff → promote/reject → destroy e testes de isolamento/limpeza.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/orchestration.test.js`: 1 arquivo, 3 cenários, passou.
15
+ - `git diff --check`: passou.
16
+
17
+ ## Métricas de tokens
18
+
19
+ - orçamento explícito desta unidade: 150 tokens de entrada e 50 de saída nos fixtures de teste;
20
+ - consumo de LLM: não aplicável; implementação e validação foram determinísticas;
21
+ - cache de contexto: não aplicável nesta unidade.
@@ -1,16 +1,16 @@
1
- # Handoff — planner and validator
2
-
3
- - **from**: planner-validator
4
- - **to**: orchestration-engineer
5
- - **intent**: implement
6
- - **context**: `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `packages/contracts/src/index.ts`; `packages/graph/src/index.ts`; `memory/90-decisions/0042-forja-2-planner-validator-independentes.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Sprint, Task e Handoff devem ser entidades persistidas por porta; ter estados, orçamento, critérios, dependências, retomada e compactação; rejeitar handoff incompleto; atualizar GraphLoop com evidência.
8
- - **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa como handoff; não concluir sprint/task sem Validator; preservar contratos versionados e trilha auditável.
9
- - **return**: devolver engines, portas de persistência, testes de retomada/compactação/escopo e próximo handoff para Policy/Sandbox ou adapters.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node test/planner-validator.test.js`: 6 testes passaram.
15
- - Cenários: orçamento dividido, dependências do grafo, checks ausentes, escopo, contradições,
16
- critérios incompletos, blockers e segurança grave.
1
+ # Handoff — planner and validator
2
+
3
+ - **from**: planner-validator
4
+ - **to**: orchestration-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `packages/contracts/src/index.ts`; `packages/graph/src/index.ts`; `memory/90-decisions/0042-forja-2-planner-validator-independentes.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Sprint, Task e Handoff devem ser entidades persistidas por porta; ter estados, orçamento, critérios, dependências, retomada e compactação; rejeitar handoff incompleto; atualizar GraphLoop com evidência.
8
+ - **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa como handoff; não concluir sprint/task sem Validator; preservar contratos versionados e trilha auditável.
9
+ - **return**: devolver engines, portas de persistência, testes de retomada/compactação/escopo e próximo handoff para Policy/Sandbox ou adapters.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node test/planner-validator.test.js`: 6 testes passaram.
15
+ - Cenários: orçamento dividido, dependências do grafo, checks ausentes, escopo, contradições,
16
+ critérios incompletos, blockers e segurança grave.