forjajs 2.0.3 → 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 (701) 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 -339
  21. package/README.pt-BR.md +345 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,22 +1,22 @@
1
- # Handoff — Sprint 11: Graph sync na CLI e MCP
2
-
3
- - **from**: Orchestrator
4
- - **to**: Graph / MCP / Observability / Governance
5
- - **intent**: operar e auditar sincronização do GraphLoop nas interfaces locais.
6
- - **context**: `graph:sync` agora aponta para `graph.sync` no registry; CLI
7
- standalone e MCP stdio montam GraphLoop SQLite + Git source e usam o mesmo
8
- registro. Resultado inclui documentos, indexados, ignorados, nós, arestas,
9
- arquivos e duração.
10
- - **acceptance**: manter um handler único, policy de escrita, checksum e
11
- exclusões de escopo; falha de Git não pode virar sucesso vazio.
12
- - **constraints**: sem poda automática, sem commits/diffs nesta etapa e sem LLM;
13
- observabilidade de Control Plane detalhada ainda será consolidada.
14
- - **return**: próxima sprint deve persistir estado de remoção/commit e ligar
15
- observações de `graph.sync` ao Control Plane.
16
-
17
- ## Evidências
18
-
19
- - `docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md`;
20
- - `memory/90-decisions/0068-graph-sync-cli-mcp.md`;
21
- - `test/cli-capability-adapter.test.js`;
22
- - smoke real de `capabilities:list --json` e `graph:sync --json`.
1
+ # Handoff — Sprint 11: Graph sync na CLI e MCP
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Graph / MCP / Observability / Governance
5
+ - **intent**: operar e auditar sincronização do GraphLoop nas interfaces locais.
6
+ - **context**: `graph:sync` agora aponta para `graph.sync` no registry; CLI
7
+ standalone e MCP stdio montam GraphLoop SQLite + Git source e usam o mesmo
8
+ registro. Resultado inclui documentos, indexados, ignorados, nós, arestas,
9
+ arquivos e duração.
10
+ - **acceptance**: manter um handler único, policy de escrita, checksum e
11
+ exclusões de escopo; falha de Git não pode virar sucesso vazio.
12
+ - **constraints**: sem poda automática, sem commits/diffs nesta etapa e sem LLM;
13
+ observabilidade de Control Plane detalhada ainda será consolidada.
14
+ - **return**: próxima sprint deve persistir estado de remoção/commit e ligar
15
+ observações de `graph.sync` ao Control Plane.
16
+
17
+ ## Evidências
18
+
19
+ - `docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md`;
20
+ - `memory/90-decisions/0068-graph-sync-cli-mcp.md`;
21
+ - `test/cli-capability-adapter.test.js`;
22
+ - smoke real de `capabilities:list --json` e `graph:sync --json`.
@@ -1,16 +1,16 @@
1
- # Handoff — Sprint 12: autonomia real
2
-
3
- - **from:** autonomy-integration-engineer
4
- - **to:** mcp-and-recovery-engineer
5
- - **intent:** continuar a prova de última milha do ForjaJS 2.x
6
- - **context:** `scripts/demo-autonomy.ts`, `test/demo-autonomy.test.js`,
7
- `docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`, ADR-0069
8
- - **acceptance:** demo cria fixture externa, usa worktree Git real, bloqueia escrita
9
- até aprovação, edita arquivo, executa npm test, valida, promove diff, persiste
10
- estado, atualiza GraphLoop e cria handoff
11
- - **constraints:** sem LLM; sem mocks no caminho principal; escopo limitado ao
12
- arquivo `tests/math.test.js`; promoção somente após Validator `accepted`
13
- - **return:** implementar Sprint 13 para transporte MCP stdio real e shutdown limpo;
14
- depois provar restart do servidor e recuperação de execução/approval/contexto
15
- - **evidence:** `npm run demo:autonomy` retornou `accepted`, uma alteração promovida,
16
- 18 nós e 14 arestas; teste automatizado repete e limpa a fixture
1
+ # Handoff — Sprint 12: autonomia real
2
+
3
+ - **from:** autonomy-integration-engineer
4
+ - **to:** mcp-and-recovery-engineer
5
+ - **intent:** continuar a prova de última milha do ForjaJS 2.x
6
+ - **context:** `scripts/demo-autonomy.ts`, `test/demo-autonomy.test.js`,
7
+ `docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`, ADR-0069
8
+ - **acceptance:** demo cria fixture externa, usa worktree Git real, bloqueia escrita
9
+ até aprovação, edita arquivo, executa npm test, valida, promove diff, persiste
10
+ estado, atualiza GraphLoop e cria handoff
11
+ - **constraints:** sem LLM; sem mocks no caminho principal; escopo limitado ao
12
+ arquivo `tests/math.test.js`; promoção somente após Validator `accepted`
13
+ - **return:** implementar Sprint 13 para transporte MCP stdio real e shutdown limpo;
14
+ depois provar restart do servidor e recuperação de execução/approval/contexto
15
+ - **evidence:** `npm run demo:autonomy` retornou `accepted`, uma alteração promovida,
16
+ 18 nós e 14 arestas; teste automatizado repete e limpa a fixture
@@ -1,30 +1,30 @@
1
- # Handoff — Sprint 2: capabilities de processo CLI
2
-
3
- - **from**: Orchestrator
4
- - **to**: SDD Architect / Worker
5
- - **intent**: continuar a migração dos comandos públicos para o Capability Registry e preparar a próxima fatia.
6
- - **context**: as Sprints 1 e 2 conectaram seis comandos ao adapter CLI. O registry valida payload,
7
- aplica policy e normaliza o envelope antes de delegar aos handlers determinísticos existentes.
8
- - **acceptance**: preservar os seis aliases migrados, adicionar testes para qualquer novo comando,
9
- atualizar `IMPLEMENTATION-AUDIT.md` e não iniciar runtime persistente sem plano/ADR próprio.
10
- - **constraints**: manter os comandos não migrados no fallback legado; não integrar MCP, GraphLoop,
11
- sandbox ou autonomia nesta etapa; não salvar transcrição em handoff; não usar `any` novo.
12
- - **return**: próxima sprint deve escolher entre migrar capabilities de contexto/memória ou iniciar
13
- a persistência do Runtime, após análise de impacto e contratos afetados.
14
-
15
- ## Entregas
16
-
17
- - `spec:check` → `spec.validate`;
18
- - `sprint:status` → `sprint.status`;
19
- - `gsd:handoff` → `handoff.create`;
20
- - schemas de `feature`, `project`, `phase`, `slug` e `context`;
21
- - policy explícita para a escrita local de handoff;
22
- - testes de sucesso, input inválido e equivalência de argumentos.
23
-
24
- ## Evidências
25
-
26
- - `docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md`;
27
- - `docs/2x/IMPLEMENTATION-AUDIT.md`;
28
- - `test/cli-capability-adapter.test.js`;
29
- - `npm run types:check`;
30
- - execução da suíte completa após a implementação.
1
+ # Handoff — Sprint 2: capabilities de processo CLI
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: SDD Architect / Worker
5
+ - **intent**: continuar a migração dos comandos públicos para o Capability Registry e preparar a próxima fatia.
6
+ - **context**: as Sprints 1 e 2 conectaram seis comandos ao adapter CLI. O registry valida payload,
7
+ aplica policy e normaliza o envelope antes de delegar aos handlers determinísticos existentes.
8
+ - **acceptance**: preservar os seis aliases migrados, adicionar testes para qualquer novo comando,
9
+ atualizar `IMPLEMENTATION-AUDIT.md` e não iniciar runtime persistente sem plano/ADR próprio.
10
+ - **constraints**: manter os comandos não migrados no fallback legado; não integrar MCP, GraphLoop,
11
+ sandbox ou autonomia nesta etapa; não salvar transcrição em handoff; não usar `any` novo.
12
+ - **return**: próxima sprint deve escolher entre migrar capabilities de contexto/memória ou iniciar
13
+ a persistência do Runtime, após análise de impacto e contratos afetados.
14
+
15
+ ## Entregas
16
+
17
+ - `spec:check` → `spec.validate`;
18
+ - `sprint:status` → `sprint.status`;
19
+ - `gsd:handoff` → `handoff.create`;
20
+ - schemas de `feature`, `project`, `phase`, `slug` e `context`;
21
+ - policy explícita para a escrita local de handoff;
22
+ - testes de sucesso, input inválido e equivalência de argumentos.
23
+
24
+ ## Evidências
25
+
26
+ - `docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md`;
27
+ - `docs/2x/IMPLEMENTATION-AUDIT.md`;
28
+ - `test/cli-capability-adapter.test.js`;
29
+ - `npm run types:check`;
30
+ - execução da suíte completa após a implementação.
@@ -1,29 +1,29 @@
1
- # Handoff — Sprint 3: Runtime persistente
2
-
3
- - **from**: Orchestrator
4
- - **to**: Runtime Worker / Governance
5
- - **intent**: continuar a integração operacional do Runtime sobre estado SQLite durável.
6
- - **context**: `RuntimeEngine` agora usa a porta `RuntimePersistence`; o adapter SQLite persiste
7
- runs, planos, resultados e cursor. O bootstrap NestJS oficial aplica migrações e injeta o adapter.
8
- - **acceptance**: preservar recuperação após reinício, exigir policy ativa na recuperação e manter
9
- migrações idempotentes. Qualquer mudança de contrato deve incluir ADR, schema e teste de replay.
10
- - **constraints**: não serializar funções/policies; não acoplar domínio a SQLite; stores em memória
11
- permanecem para testes; approvals, GraphLoop, sandbox e execução paralela não estão concluídos.
12
- - **return**: próxima sprint deve integrar persistência de approvals/eventos ou iniciar MCP sobre o
13
- catálogo compartilhado, após análise de impacto e critérios de recuperação.
14
-
15
- ## Entregas
16
-
17
- - `RuntimePersistence` no domínio;
18
- - `SqliteRuntimePersistence` e migração SQLite v2;
19
- - recuperação de plano, resultados, cursor e policy ativa;
20
- - server oficial inicializando SQLite no workspace;
21
- - teste de pausa, fechamento, nova instância e retomada.
22
-
23
- ## Evidências
24
-
25
- - `docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md`;
26
- - `memory/90-decisions/0060-runtime-persistence-port.md`;
27
- - `test/runtime.test.js`;
28
- - `test/adapter-sqlite.test.js`;
29
- - `npm run types:check`, `npm test` e `npm run build`.
1
+ # Handoff — Sprint 3: Runtime persistente
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Runtime Worker / Governance
5
+ - **intent**: continuar a integração operacional do Runtime sobre estado SQLite durável.
6
+ - **context**: `RuntimeEngine` agora usa a porta `RuntimePersistence`; o adapter SQLite persiste
7
+ runs, planos, resultados e cursor. O bootstrap NestJS oficial aplica migrações e injeta o adapter.
8
+ - **acceptance**: preservar recuperação após reinício, exigir policy ativa na recuperação e manter
9
+ migrações idempotentes. Qualquer mudança de contrato deve incluir ADR, schema e teste de replay.
10
+ - **constraints**: não serializar funções/policies; não acoplar domínio a SQLite; stores em memória
11
+ permanecem para testes; approvals, GraphLoop, sandbox e execução paralela não estão concluídos.
12
+ - **return**: próxima sprint deve integrar persistência de approvals/eventos ou iniciar MCP sobre o
13
+ catálogo compartilhado, após análise de impacto e critérios de recuperação.
14
+
15
+ ## Entregas
16
+
17
+ - `RuntimePersistence` no domínio;
18
+ - `SqliteRuntimePersistence` e migração SQLite v2;
19
+ - recuperação de plano, resultados, cursor e policy ativa;
20
+ - server oficial inicializando SQLite no workspace;
21
+ - teste de pausa, fechamento, nova instância e retomada.
22
+
23
+ ## Evidências
24
+
25
+ - `docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md`;
26
+ - `memory/90-decisions/0060-runtime-persistence-port.md`;
27
+ - `test/runtime.test.js`;
28
+ - `test/adapter-sqlite.test.js`;
29
+ - `npm run types:check`, `npm test` e `npm run build`.
@@ -1,29 +1,29 @@
1
- # Handoff — Sprint 4: MCP Registry
2
-
3
- - **from**: Orchestrator
4
- - **to**: MCP Adapter / Governance
5
- - **intent**: continuar a integração do catálogo compartilhado com clientes MCP.
6
- - **context**: o MCP agora descobre capabilities visíveis no registry, descreve definições e expõe
7
- transporte local JSON-RPC por stdio via `forja mcp:start`.
8
- - **acceptance**: manter ferramentas dinâmicas alinhadas ao registry, validar payload no registry,
9
- preservar identidade/policy e testar clientes que enviam mais de uma mensagem no mesmo chunk.
10
- - **constraints**: não duplicar handlers; não colocar regra de domínio no transporte; não tratar
11
- stdio como autenticação remota; GraphLoop persistente e approvals MCP seguem pendentes.
12
- - **return**: próxima sprint deve integrar catálogo padrão no server/MCP e decidir persistência de
13
- auditoria MCP, com teste de contrato para SDK/MCP.
14
-
15
- ## Entregas
16
-
17
- - `forja mcp:start`;
18
- - `forja_capability_describe`;
19
- - ferramentas dinâmicas para as seis capabilities migradas;
20
- - framing por linha e resposta JSON-RPC estruturada;
21
- - testes MCP atualizados.
22
-
23
- ## Evidências
24
-
25
- - `docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md`;
26
- - `memory/90-decisions/0061-mcp-dynamic-registry-stdio.md`;
27
- - `test/mcp.test.js`;
28
- - smoke `tools/list` + `tools/call` executado em workspace temporário;
29
- - `npm run types:check`.
1
+ # Handoff — Sprint 4: MCP Registry
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: MCP Adapter / Governance
5
+ - **intent**: continuar a integração do catálogo compartilhado com clientes MCP.
6
+ - **context**: o MCP agora descobre capabilities visíveis no registry, descreve definições e expõe
7
+ transporte local JSON-RPC por stdio via `forja mcp:start`.
8
+ - **acceptance**: manter ferramentas dinâmicas alinhadas ao registry, validar payload no registry,
9
+ preservar identidade/policy e testar clientes que enviam mais de uma mensagem no mesmo chunk.
10
+ - **constraints**: não duplicar handlers; não colocar regra de domínio no transporte; não tratar
11
+ stdio como autenticação remota; GraphLoop persistente e approvals MCP seguem pendentes.
12
+ - **return**: próxima sprint deve integrar catálogo padrão no server/MCP e decidir persistência de
13
+ auditoria MCP, com teste de contrato para SDK/MCP.
14
+
15
+ ## Entregas
16
+
17
+ - `forja mcp:start`;
18
+ - `forja_capability_describe`;
19
+ - ferramentas dinâmicas para as seis capabilities migradas;
20
+ - framing por linha e resposta JSON-RPC estruturada;
21
+ - testes MCP atualizados.
22
+
23
+ ## Evidências
24
+
25
+ - `docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md`;
26
+ - `memory/90-decisions/0061-mcp-dynamic-registry-stdio.md`;
27
+ - `test/mcp.test.js`;
28
+ - smoke `tools/list` + `tools/call` executado em workspace temporário;
29
+ - `npm run types:check`.
@@ -1,22 +1,22 @@
1
- # Handoff — Sprint 5: server, approvals e auditoria MCP
2
-
3
- - **from**: Orchestrator
4
- - **to**: Runtime / MCP / Governance
5
- - **intent**: continuar a operação persistente do control plane local-first.
6
- - **context**: o server oficial agora compõe o mesmo catálogo de seis capabilities da CLI; approvals
7
- e chamadas MCP são persistidos no SQLite do workspace.
8
- - **acceptance**: manter migrações v1–v3 idempotentes, testar recuperação de approval e preservar
9
- falha aberta da auditoria sem ocultar o erro do sink.
10
- - **constraints**: não criar catálogo manual paralelo; não serializar handlers ou policies; manter
11
- domínio sem SQLite; GraphLoop persistente e sandbox operacional seguem pendentes.
12
- - **return**: próxima sprint deve integrar eventos persistentes e/ou iniciar a prova ponta a ponta
13
- usando server, runtime, approval, sandbox e validator.
14
-
15
- ## Evidências
16
-
17
- - `docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md`;
18
- - `memory/90-decisions/0062-server-catalog-approval-audit.md`;
19
- - `test/policy.test.js`;
20
- - `test/adapter-sqlite.test.js`;
21
- - `test/mcp.test.js`;
22
- - `npm test`, `npm run build` e `npm run release:check`.
1
+ # Handoff — Sprint 5: server, approvals e auditoria MCP
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Runtime / MCP / Governance
5
+ - **intent**: continuar a operação persistente do control plane local-first.
6
+ - **context**: o server oficial agora compõe o mesmo catálogo de seis capabilities da CLI; approvals
7
+ e chamadas MCP são persistidos no SQLite do workspace.
8
+ - **acceptance**: manter migrações v1–v3 idempotentes, testar recuperação de approval e preservar
9
+ falha aberta da auditoria sem ocultar o erro do sink.
10
+ - **constraints**: não criar catálogo manual paralelo; não serializar handlers ou policies; manter
11
+ domínio sem SQLite; GraphLoop persistente e sandbox operacional seguem pendentes.
12
+ - **return**: próxima sprint deve integrar eventos persistentes e/ou iniciar a prova ponta a ponta
13
+ usando server, runtime, approval, sandbox e validator.
14
+
15
+ ## Evidências
16
+
17
+ - `docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md`;
18
+ - `memory/90-decisions/0062-server-catalog-approval-audit.md`;
19
+ - `test/policy.test.js`;
20
+ - `test/adapter-sqlite.test.js`;
21
+ - `test/mcp.test.js`;
22
+ - `npm test`, `npm run build` e `npm run release:check`.
@@ -1,25 +1,25 @@
1
- # Handoff — Sprint 6: eventos persistentes e prova E2E
2
-
3
- - **from**: Orchestrator
4
- - **to**: GraphLoop / Runtime / Governance
5
- - **intent**: continuar a integração operacional do ForjaJS 2.x sobre trilha de
6
- eventos durável.
7
- - **context**: o Event Bus agora hidrata estado do `EventStore`, preserva
8
- idempotência e sequência por aggregate em SQLite, e o server registra eventos
9
- do Control Plane no mesmo banco local. A prova determinística cobre aprovação,
10
- sandbox, runtime, validator e `execution.completed`.
11
- - **acceptance**: preservar o contrato do Event Bus, manter migrações idempotentes,
12
- exigir validator aceito antes de `completed` e manter a prova sem rede/LLM.
13
- - **constraints**: SSE continua efêmero; não declarar persistência de subscriptions
14
- ou dead letters; não chamar o GraphLoop persistente de concluído.
15
- - **return**: próxima sprint deve integrar GraphLoop SQLite, evidências e consultas
16
- de impacto ao contexto/runtime.
17
-
18
- ## Evidências
19
-
20
- - `docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md`;
21
- - `memory/90-decisions/0063-events-persistent-e2e.md`;
22
- - `test/events-scheduler.test.js`;
23
- - `test/autonomy-e2e.test.js`;
24
- - `packages/events/src/index.ts`;
25
- - `apps/server/src/main.ts`.
1
+ # Handoff — Sprint 6: eventos persistentes e prova E2E
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: GraphLoop / Runtime / Governance
5
+ - **intent**: continuar a integração operacional do ForjaJS 2.x sobre trilha de
6
+ eventos durável.
7
+ - **context**: o Event Bus agora hidrata estado do `EventStore`, preserva
8
+ idempotência e sequência por aggregate em SQLite, e o server registra eventos
9
+ do Control Plane no mesmo banco local. A prova determinística cobre aprovação,
10
+ sandbox, runtime, validator e `execution.completed`.
11
+ - **acceptance**: preservar o contrato do Event Bus, manter migrações idempotentes,
12
+ exigir validator aceito antes de `completed` e manter a prova sem rede/LLM.
13
+ - **constraints**: SSE continua efêmero; não declarar persistência de subscriptions
14
+ ou dead letters; não chamar o GraphLoop persistente de concluído.
15
+ - **return**: próxima sprint deve integrar GraphLoop SQLite, evidências e consultas
16
+ de impacto ao contexto/runtime.
17
+
18
+ ## Evidências
19
+
20
+ - `docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md`;
21
+ - `memory/90-decisions/0063-events-persistent-e2e.md`;
22
+ - `test/events-scheduler.test.js`;
23
+ - `test/autonomy-e2e.test.js`;
24
+ - `packages/events/src/index.ts`;
25
+ - `apps/server/src/main.ts`.
@@ -1,23 +1,23 @@
1
- # Handoff — Sprint 7: GraphLoop persistente
2
-
3
- - **from**: Orchestrator
4
- - **to**: Context / Runtime / Governance
5
- - **intent**: continuar a integração do grafo verificável com o fluxo operacional.
6
- - **context**: `GraphStore` foi extraído como porta do domínio; SQLite v4 persiste
7
- nós, arestas, evidências e checksums. O server compõe MCP e Runtime sobre o
8
- mesmo GraphLoop. Resultados de execução com evidência geram `Execution
9
- PRODUCES Capability`.
10
- - **acceptance**: manter as invariantes de endpoints, evidência, validade temporal
11
- e checksum; preservar migração não destrutiva; não declarar persistidos os
12
- engines de contradição/agenda ainda não ligados ao schema.
13
- - **constraints**: GraphLoop não importa SQLite/NestJS; não usar LLM para as
14
- relações determinísticas; não criar evidência artificial.
15
- - **return**: próxima sprint deve ligar Context Engine ao GraphLoop persistente,
16
- incluindo seleção por relevância, referências de evidência e orçamento.
17
-
18
- ## Evidências
19
-
20
- - `docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md`;
21
- - `memory/90-decisions/0064-graphloop-sqlite-store.md`;
22
- - `test/graph.test.js`;
23
- - `test/adapter-sqlite.test.js`.
1
+ # Handoff — Sprint 7: GraphLoop persistente
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Context / Runtime / Governance
5
+ - **intent**: continuar a integração do grafo verificável com o fluxo operacional.
6
+ - **context**: `GraphStore` foi extraído como porta do domínio; SQLite v4 persiste
7
+ nós, arestas, evidências e checksums. O server compõe MCP e Runtime sobre o
8
+ mesmo GraphLoop. Resultados de execução com evidência geram `Execution
9
+ PRODUCES Capability`.
10
+ - **acceptance**: manter as invariantes de endpoints, evidência, validade temporal
11
+ e checksum; preservar migração não destrutiva; não declarar persistidos os
12
+ engines de contradição/agenda ainda não ligados ao schema.
13
+ - **constraints**: GraphLoop não importa SQLite/NestJS; não usar LLM para as
14
+ relações determinísticas; não criar evidência artificial.
15
+ - **return**: próxima sprint deve ligar Context Engine ao GraphLoop persistente,
16
+ incluindo seleção por relevância, referências de evidência e orçamento.
17
+
18
+ ## Evidências
19
+
20
+ - `docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md`;
21
+ - `memory/90-decisions/0064-graphloop-sqlite-store.md`;
22
+ - `test/graph.test.js`;
23
+ - `test/adapter-sqlite.test.js`.
@@ -1,23 +1,23 @@
1
- # Handoff — Sprint 8: Context Engine e GraphLoop
2
-
3
- - **from**: Orchestrator
4
- - **to**: Runtime / Context / Governance
5
- - **intent**: continuar a redução de contexto com fontes persistentes e evidência.
6
- - **context**: GraphLoop expõe registros de relações relevantes; `GraphContextSource`
7
- os adapta ao Context Engine; `SqliteContextCache` persiste checksums; server
8
- compõe tudo no banco local e entrega o pacote ao planner do Runtime.
9
- - **acceptance**: preservar referências, orçamento, cache e exclusão de conteúdo
10
- contradito/obsoleto; não usar LLM para ranking lexical; manter compatibilidade
11
- com fontes de memória existentes.
12
- - **constraints**: conteúdo atual é relação compacta, não trecho integral de
13
- arquivo; `requireEvidence: false` é apenas a política de compatibilidade do
14
- runtime server; MCP e clientes podem exigir evidência.
15
- - **return**: próxima sprint deve conectar extractors de arquivos/specs e medir
16
- `context unused`, repetição e cobertura de evidência em runs reais.
17
-
18
- ## Evidências
19
-
20
- - `docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md`;
21
- - `memory/90-decisions/0065-context-graph-source-cache.md`;
22
- - `test/context.test.js`;
23
- - `test/adapter-sqlite.test.js`.
1
+ # Handoff — Sprint 8: Context Engine e GraphLoop
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Runtime / Context / Governance
5
+ - **intent**: continuar a redução de contexto com fontes persistentes e evidência.
6
+ - **context**: GraphLoop expõe registros de relações relevantes; `GraphContextSource`
7
+ os adapta ao Context Engine; `SqliteContextCache` persiste checksums; server
8
+ compõe tudo no banco local e entrega o pacote ao planner do Runtime.
9
+ - **acceptance**: preservar referências, orçamento, cache e exclusão de conteúdo
10
+ contradito/obsoleto; não usar LLM para ranking lexical; manter compatibilidade
11
+ com fontes de memória existentes.
12
+ - **constraints**: conteúdo atual é relação compacta, não trecho integral de
13
+ arquivo; `requireEvidence: false` é apenas a política de compatibilidade do
14
+ runtime server; MCP e clientes podem exigir evidência.
15
+ - **return**: próxima sprint deve conectar extractors de arquivos/specs e medir
16
+ `context unused`, repetição e cobertura de evidência em runs reais.
17
+
18
+ ## Evidências
19
+
20
+ - `docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md`;
21
+ - `memory/90-decisions/0065-context-graph-source-cache.md`;
22
+ - `test/context.test.js`;
23
+ - `test/adapter-sqlite.test.js`.
@@ -1,21 +1,21 @@
1
- # Handoff — Sprint 9: extractors determinísticos
2
-
3
- - **from**: Orchestrator
4
- - **to**: Graph / Context / Governance
5
- - **intent**: continuar a indexação verificável de fontes do projeto.
6
- - **context**: o extractor GraphLoop agora cobre imports, links, exports,
7
- chamadas, `implements`, ADRs, tarefas Markdown, agentes de handoff, testes e
8
- dependências de manifests, sempre com evidência e checksum.
9
- - **acceptance**: preservar idempotência, não criar arestas sem evidência e não
10
- tratar JSON inválido como sucesso de validação.
11
- - **constraints**: extração é lexical/determinística; resolução completa de
12
- símbolos, commits e diffs não está incluída; nenhuma chamada de LLM.
13
- - **return**: próxima sprint deve integrar indexação de workspace/Git e expor
14
- atualização incremental por capability, mantendo o Context Engine limitado ao
15
- contexto necessário.
16
-
17
- ## Evidências
18
-
19
- - `docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md`;
20
- - `memory/90-decisions/0066-graph-deterministic-extractors.md`;
21
- - `test/graph.test.js`.
1
+ # Handoff — Sprint 9: extractors determinísticos
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Graph / Context / Governance
5
+ - **intent**: continuar a indexação verificável de fontes do projeto.
6
+ - **context**: o extractor GraphLoop agora cobre imports, links, exports,
7
+ chamadas, `implements`, ADRs, tarefas Markdown, agentes de handoff, testes e
8
+ dependências de manifests, sempre com evidência e checksum.
9
+ - **acceptance**: preservar idempotência, não criar arestas sem evidência e não
10
+ tratar JSON inválido como sucesso de validação.
11
+ - **constraints**: extração é lexical/determinística; resolução completa de
12
+ símbolos, commits e diffs não está incluída; nenhuma chamada de LLM.
13
+ - **return**: próxima sprint deve integrar indexação de workspace/Git e expor
14
+ atualização incremental por capability, mantendo o Context Engine limitado ao
15
+ contexto necessário.
16
+
17
+ ## Evidências
18
+
19
+ - `docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md`;
20
+ - `memory/90-decisions/0066-graph-deterministic-extractors.md`;
21
+ - `test/graph.test.js`.
@@ -1,14 +1,14 @@
1
- # Handoff — Sprint 13: MCP stdio real
2
-
3
- - **from:** autonomy-integration-engineer
4
- - **to:** persistence-chaos-engineer
5
- - **intent:** continuar a prova de última milha do ForjaJS 2.x
6
- - **context:** `bin/forja.ts`, `test/mcp-stdio.test.js`, Sprint 13, ADR-0070
7
- - **acceptance:** cliente filho inicia MCP real, negocia initialize, lista tools,
8
- descreve e executa capability, lê resource e encerra por EOF sem ruído em stdout
9
- - **constraints:** stdio newline-delimited JSON-RPC; notificações não recebem resposta;
10
- nenhuma regra de negócio nova no transporte
11
- - **return:** provar restart abrupto do servidor e retomada de runtime/approval/contexto
12
- com SQLite; adicionar casos de desconexão e payload inválido
13
- - **evidence:** teste de processo real aprovado; stdout parseável; stderr vazio;
14
- shutdown exit code 0
1
+ # Handoff — Sprint 13: MCP stdio real
2
+
3
+ - **from:** autonomy-integration-engineer
4
+ - **to:** persistence-chaos-engineer
5
+ - **intent:** continuar a prova de última milha do ForjaJS 2.x
6
+ - **context:** `bin/forja.ts`, `test/mcp-stdio.test.js`, Sprint 13, ADR-0070
7
+ - **acceptance:** cliente filho inicia MCP real, negocia initialize, lista tools,
8
+ descreve e executa capability, lê resource e encerra por EOF sem ruído em stdout
9
+ - **constraints:** stdio newline-delimited JSON-RPC; notificações não recebem resposta;
10
+ nenhuma regra de negócio nova no transporte
11
+ - **return:** provar restart abrupto do servidor e retomada de runtime/approval/contexto
12
+ com SQLite; adicionar casos de desconexão e payload inválido
13
+ - **evidence:** teste de processo real aprovado; stdout parseável; stderr vazio;
14
+ shutdown exit code 0
@@ -1,15 +1,15 @@
1
- # Handoff — Sprint 14: persistência oficial e restart
2
-
3
- - **from:** persistence-composition-engineer
4
- - **to:** chaos-and-security-engineer
5
- - **intent:** continuar o fechamento 10/10 com falhas e recuperação
6
- - **context:** `apps/server/src/main.ts`, `test/server-persistence.test.js`, Sprint 14,
7
- ADR-0071
8
- - **acceptance:** duas composições oficiais compartilham SQLite; runtime e approval
9
- pendente são recuperados; contexto, grafo, eventos e observações permanecem
10
- - **constraints:** stores em memória apenas para testes; adapter SQLite permanece fora
11
- do domínio; probe executa com loader Nest real
12
- - **return:** adicionar processo morto, approval expirada, SQLite bloqueado,
13
- checkpoint corrompido, timeout e payload malicioso; registrar rollback e recuperação
14
- - **evidence:** probe passou com run `awaiting_approval`, approval 1, contexto
15
- preservado, grafo 1 nó, eventos e observações persistidos
1
+ # Handoff — Sprint 14: persistência oficial e restart
2
+
3
+ - **from:** persistence-composition-engineer
4
+ - **to:** chaos-and-security-engineer
5
+ - **intent:** continuar o fechamento 10/10 com falhas e recuperação
6
+ - **context:** `apps/server/src/main.ts`, `test/server-persistence.test.js`, Sprint 14,
7
+ ADR-0071
8
+ - **acceptance:** duas composições oficiais compartilham SQLite; runtime e approval
9
+ pendente são recuperados; contexto, grafo, eventos e observações permanecem
10
+ - **constraints:** stores em memória apenas para testes; adapter SQLite permanece fora
11
+ do domínio; probe executa com loader Nest real
12
+ - **return:** adicionar processo morto, approval expirada, SQLite bloqueado,
13
+ checkpoint corrompido, timeout e payload malicioso; registrar rollback e recuperação
14
+ - **evidence:** probe passou com run `awaiting_approval`, approval 1, contexto
15
+ preservado, grafo 1 nó, eventos e observações persistidos
@@ -1,13 +1,13 @@
1
- # Handoff — Sprint 15: caos e segurança
2
-
3
- - **from:** chaos-and-security-engineer
4
- - **to:** release-hardening-engineer
5
- - **intent:** fechar os casos de falha restantes antes do próximo release
6
- - **context:** adapter Git, policy, SQLite, MCP stdio, Sprint 15, ADR-0072
7
- - **acceptance:** approval expirada, payload corrompido, deny-by-default,
8
- path traversal e herança de secrets têm comportamento determinístico e testado
9
- - **constraints:** sem mascarar corrupção; sem secrets no ambiente padrão do sandbox;
10
- nenhuma leitura fora da raiz; alterações críticas continuam sob Policy Engine
11
- - **return:** implementar SQLite lock/timeout, processo morto no meio do step,
12
- checkpoint rollback, fuzz MCP, plugins maliciosos e threat model formal
13
- - **evidence:** testes de chaos/security e 291+ testes de integração existentes
1
+ # Handoff — Sprint 15: caos e segurança
2
+
3
+ - **from:** chaos-and-security-engineer
4
+ - **to:** release-hardening-engineer
5
+ - **intent:** fechar os casos de falha restantes antes do próximo release
6
+ - **context:** adapter Git, policy, SQLite, MCP stdio, Sprint 15, ADR-0072
7
+ - **acceptance:** approval expirada, payload corrompido, deny-by-default,
8
+ path traversal e herança de secrets têm comportamento determinístico e testado
9
+ - **constraints:** sem mascarar corrupção; sem secrets no ambiente padrão do sandbox;
10
+ nenhuma leitura fora da raiz; alterações críticas continuam sob Policy Engine
11
+ - **return:** implementar SQLite lock/timeout, processo morto no meio do step,
12
+ checkpoint rollback, fuzz MCP, plugins maliciosos e threat model formal
13
+ - **evidence:** testes de chaos/security e 291+ testes de integração existentes
@@ -1,11 +1,11 @@
1
- # Handoff — Sprint 16: última milha
2
-
3
- - objetivo: fechar lacunas verificáveis para a avaliação 10/10;
4
- - concluído: rollback explícito de sandbox; reversão Git por patch binário; benchmark JSON determinístico; manifests oficiais GitHub/Docker; testes de isolamento;
5
- - decisões: `promoted → rolled_back` é terminal; plugins oficiais são boundaries sem rede implícita; benchmark usa checksum e proxy bytes/4;
6
- - restrições: rollback exige diff da mesma sessão; handlers externos dependem de adapters permissionados;
7
- - evidências: testes `sandbox`, `adapter-git`, `context-benchmark`, `official-plugins`; `npm test` 300/300; build TypeScript aprovado; benchmark mediu 95,72% de redução nesta árvore;
8
- - pendências: executar `release:check --publish` em árvore limpa e decidir publicação 2.0.3; integrar handlers externos reais apenas com credenciais e sandbox apropriadas;
9
- - critérios de aceite: todos os testes e build aprovados;
10
- - bloqueios: nenhum bloqueio técnico nesta sprint;
11
- - próximo agente: Governance/Release Auditor.
1
+ # Handoff — Sprint 16: última milha
2
+
3
+ - objetivo: fechar lacunas verificáveis para a avaliação 10/10;
4
+ - concluído: rollback explícito de sandbox; reversão Git por patch binário; benchmark JSON determinístico; manifests oficiais GitHub/Docker; testes de isolamento;
5
+ - decisões: `promoted → rolled_back` é terminal; plugins oficiais são boundaries sem rede implícita; benchmark usa checksum e proxy bytes/4;
6
+ - restrições: rollback exige diff da mesma sessão; handlers externos dependem de adapters permissionados;
7
+ - evidências: testes `sandbox`, `adapter-git`, `context-benchmark`, `official-plugins`; `npm test` 300/300; build TypeScript aprovado; benchmark mediu 95,72% de redução nesta árvore;
8
+ - pendências: executar `release:check --publish` em árvore limpa e decidir publicação 2.0.3; integrar handlers externos reais apenas com credenciais e sandbox apropriadas;
9
+ - critérios de aceite: todos os testes e build aprovados;
10
+ - bloqueios: nenhum bloqueio técnico nesta sprint;
11
+ - próximo agente: Governance/Release Auditor.