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,14 +1,14 @@
1
- # Handoff — policy engine
2
-
3
- - **from**: worker
4
- - **to**: runtime-engineer
5
- - **intent**: implement
6
- - **context**: `packages/policy/src/index.ts`; `packages/core/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: runtime deve consumir PolicyDecision; bloquear `DENY`/aprovação; impor limites de tokens, arquivos, tempo, retries e paralelismo; criar estado, checkpoint, pausa e retomada; retornar RuntimeRun auditável.
8
- - **constraints**: domínio sem NestJS/Next/SQLite; não ignorar `ALLOW_WITH_LIMITS`; nenhuma execução crítica sem Policy Engine; persistência fica atrás de porta; manter CLI 1.x intacta.
9
- - **return**: devolver estados, invariantes, testes de falha/retomada, evidências e próximo handoff.
10
-
11
- ## Resultado da etapa anterior
12
-
13
- Policy Engine implementado com default deny, regras determinísticas, limites, aprovação para risco
14
- crítico e ledger de aprovação em memória. Registry → Policy foi validado por teste de integração.
1
+ # Handoff — policy engine
2
+
3
+ - **from**: worker
4
+ - **to**: runtime-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/policy/src/index.ts`; `packages/core/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: runtime deve consumir PolicyDecision; bloquear `DENY`/aprovação; impor limites de tokens, arquivos, tempo, retries e paralelismo; criar estado, checkpoint, pausa e retomada; retornar RuntimeRun auditável.
8
+ - **constraints**: domínio sem NestJS/Next/SQLite; não ignorar `ALLOW_WITH_LIMITS`; nenhuma execução crítica sem Policy Engine; persistência fica atrás de porta; manter CLI 1.x intacta.
9
+ - **return**: devolver estados, invariantes, testes de falha/retomada, evidências e próximo handoff.
10
+
11
+ ## Resultado da etapa anterior
12
+
13
+ Policy Engine implementado com default deny, regras determinísticas, limites, aprovação para risco
14
+ crítico e ledger de aprovação em memória. Registry → Policy foi validado por teste de integração.
@@ -1,23 +1,23 @@
1
- # Handoff — Runtime Control Plane
2
-
3
- - **from**: runtime-application-engineer
4
- - **to**: evals-plugin-dashboard-engineer
5
- - **intent**: implement
6
- - **context**: `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Runtime start/execute/pause/resume/cancel/get delegado pelo Control Plane; etapas explícitas e budget validados; Policy read-only local; validator independente exige evidência; observações e SSE são publicados.
8
- - **constraints**: não habilitar escrita sem Policy/approval; não usar planner vazio; não concluir sem validator; manter checkpoint e limites do Runtime; não usar LLM para planejamento determinístico.
9
- - **return**: implementar Evaluation Engine, Plugin SDK permissionado e dashboard/control plane operacional para métricas, avaliações, custos, runs, approvals e GraphLoop.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - 17 arquivos de testes passaram.
16
- - smoke `runtime-control-plane-ok completed accepted 2`.
17
- - `git diff --check`: passou.
18
-
19
- ## Métricas de tokens
20
-
21
- - orçamento explícito no smoke: 10 tokens de entrada, 0 de saída, 1 token estimado usado;
22
- - consumo de LLM: não aplicável; planner, validator e Policy foram determinísticos;
23
- - observações geradas: 2.
1
+ # Handoff — Runtime Control Plane
2
+
3
+ - **from**: runtime-application-engineer
4
+ - **to**: evals-plugin-dashboard-engineer
5
+ - **intent**: implement
6
+ - **context**: `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Runtime start/execute/pause/resume/cancel/get delegado pelo Control Plane; etapas explícitas e budget validados; Policy read-only local; validator independente exige evidência; observações e SSE são publicados.
8
+ - **constraints**: não habilitar escrita sem Policy/approval; não usar planner vazio; não concluir sem validator; manter checkpoint e limites do Runtime; não usar LLM para planejamento determinístico.
9
+ - **return**: implementar Evaluation Engine, Plugin SDK permissionado e dashboard/control plane operacional para métricas, avaliações, custos, runs, approvals e GraphLoop.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - 17 arquivos de testes passaram.
16
+ - smoke `runtime-control-plane-ok completed accepted 2`.
17
+ - `git diff --check`: passou.
18
+
19
+ ## Métricas de tokens
20
+
21
+ - orçamento explícito no smoke: 10 tokens de entrada, 0 de saída, 1 token estimado usado;
22
+ - consumo de LLM: não aplicável; planner, validator e Policy foram determinísticos;
23
+ - observações geradas: 2.
@@ -1,15 +1,15 @@
1
- # Handoff — runtime controlado
2
-
3
- - **from**: runtime-engineer
4
- - **to**: architect
5
- - **intent**: review
6
- - **context**: `packages/runtime/src/index.ts`; `packages/contracts/src/index.ts`; `packages/core/src/index.ts`; `packages/policy/src/index.ts`; `memory/90-decisions/0038-forja-2-runtime-controlado.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: run tem estado, orçamento, métricas, erros e evidências; planner e validator são portas; Policy é consumida por capability; limites bloqueiam; checkpoint ocorre em boundaries; pausa/retomada/cancelamento funcionam; validator rejeita falsa conclusão.
8
- - **constraints**: sem NestJS/Next/SQLite; execução inicial sequencial; nenhum bypass de Policy; persistência fica atrás de `CheckpointStore`/`RuntimeMemory`; manter CLI 1.x intacta.
9
- - **return**: revisar invariantes de transição, persistência dos checkpoints, semântica de aprovação na retomada e seguir para Scheduler/Event Bus.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/runtime.test.js`: 6 testes passaram.
15
- - Cenários cobertos: sucesso, checkpoint, pausa/retomada, default deny, orçamento, retry e validator rejeitando conclusão.
1
+ # Handoff — runtime controlado
2
+
3
+ - **from**: runtime-engineer
4
+ - **to**: architect
5
+ - **intent**: review
6
+ - **context**: `packages/runtime/src/index.ts`; `packages/contracts/src/index.ts`; `packages/core/src/index.ts`; `packages/policy/src/index.ts`; `memory/90-decisions/0038-forja-2-runtime-controlado.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: run tem estado, orçamento, métricas, erros e evidências; planner e validator são portas; Policy é consumida por capability; limites bloqueiam; checkpoint ocorre em boundaries; pausa/retomada/cancelamento funcionam; validator rejeita falsa conclusão.
8
+ - **constraints**: sem NestJS/Next/SQLite; execução inicial sequencial; nenhum bypass de Policy; persistência fica atrás de `CheckpointStore`/`RuntimeMemory`; manter CLI 1.x intacta.
9
+ - **return**: revisar invariantes de transição, persistência dos checkpoints, semântica de aprovação na retomada e seguir para Scheduler/Event Bus.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/runtime.test.js`: 6 testes passaram.
15
+ - Cenários cobertos: sucesso, checkpoint, pausa/retomada, default deny, orçamento, retry e validator rejeitando conclusão.
@@ -1,21 +1,21 @@
1
- # Handoff — sandbox e adapter Git
2
-
3
- - **from**: sandbox-adapter-engineer
4
- - **to**: persistence-adapter-engineer
5
- - **intent**: implement
6
- - **context**: `packages/sandbox/src/index.ts`; `packages/adapter-git/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0044-forja-2-sandbox-worktree.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: Sandbox controla ciclo isolado, validação aceita, diff obrigatório, promoção explícita, rejeição e destruição; adapter Git traduz operações por portas e não contém regra de domínio.
8
- - **constraints**: domínio sem Git/filesystem/subprocessos; promoção e destruição crítica devem ser autorizadas pela camada de Policy; não executar comandos reais nos testes determinísticos; manter auditoria e contratos versionados.
9
- - **return**: implementar `packages/adapter-sqlite` para persistir contratos, sessões, eventos, checkpoints, sprints, tasks, handoffs e auditoria, com migração não destrutiva e testes de idempotência/retomada.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/sandbox.test.js test/adapter-git.test.js`: 2 arquivos passaram.
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; implementação, parsing e validação foram determinísticos;
21
- - cache: não aplicável nesta unidade.
1
+ # Handoff — sandbox e adapter Git
2
+
3
+ - **from**: sandbox-adapter-engineer
4
+ - **to**: persistence-adapter-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/sandbox/src/index.ts`; `packages/adapter-git/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0044-forja-2-sandbox-worktree.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: Sandbox controla ciclo isolado, validação aceita, diff obrigatório, promoção explícita, rejeição e destruição; adapter Git traduz operações por portas e não contém regra de domínio.
8
+ - **constraints**: domínio sem Git/filesystem/subprocessos; promoção e destruição crítica devem ser autorizadas pela camada de Policy; não executar comandos reais nos testes determinísticos; manter auditoria e contratos versionados.
9
+ - **return**: implementar `packages/adapter-sqlite` para persistir contratos, sessões, eventos, checkpoints, sprints, tasks, handoffs e auditoria, com migração não destrutiva e testes de idempotência/retomada.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/sandbox.test.js test/adapter-git.test.js`: 2 arquivos passaram.
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; implementação, parsing e validação foram determinísticos;
21
+ - cache: não aplicável nesta unidade.
@@ -1,27 +1,27 @@
1
- # Handoff — SDK e transporte
2
-
3
- - **from**: sdk-control-plane-engineer
4
- - **to**: control-plane-observability-engineer
5
- - **intent**: implement
6
- - **context**: `packages/sdk/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/forja-nest.module.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0048-forja-2-sdk-transport.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: SDK consome transporte substituível; capabilities/contexto/grafo/orquestração/runtime/approvals/métricas/eventos possuem métodos tipados; headers e erros são preservados; eventos suportam unsubscribe.
8
- - **constraints**: sem NestJS/Express no SDK; não considerar rota apenas declarada como implementada; não esconder erros HTTP; manter Policy e execução no núcleo.
9
- - **return**: implementar Control Plane e Observabilidade: rotas de runtime, approvals, Sprint/Task, métricas por run/agent/task/sprint/capability, auditoria e eventos SSE consumíveis pelo SDK.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `node --test ... test/sdk.test.js`: 16 arquivos passaram.
16
- - `git diff --check`: passou.
17
-
18
- ## Riscos
19
-
20
- - Rotas de runtime, approvals, métricas e criação de Sprint/Task ainda são superfície declarada no SDK e pendem do Control Plane.
21
- - Vulnerabilidades high reportadas pelo npm permanecem sob revisão separada.
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; transporte, serialização e erros foram determinísticos;
27
- - cache: não aplicável nesta unidade.
1
+ # Handoff — SDK e transporte
2
+
3
+ - **from**: sdk-control-plane-engineer
4
+ - **to**: control-plane-observability-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/sdk/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/forja-nest.module.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0048-forja-2-sdk-transport.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: SDK consome transporte substituível; capabilities/contexto/grafo/orquestração/runtime/approvals/métricas/eventos possuem métodos tipados; headers e erros são preservados; eventos suportam unsubscribe.
8
+ - **constraints**: sem NestJS/Express no SDK; não considerar rota apenas declarada como implementada; não esconder erros HTTP; manter Policy e execução no núcleo.
9
+ - **return**: implementar Control Plane e Observabilidade: rotas de runtime, approvals, Sprint/Task, métricas por run/agent/task/sprint/capability, auditoria e eventos SSE consumíveis pelo SDK.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `node --test ... test/sdk.test.js`: 16 arquivos passaram.
16
+ - `git diff --check`: passou.
17
+
18
+ ## Riscos
19
+
20
+ - Rotas de runtime, approvals, métricas e criação de Sprint/Task ainda são superfície declarada no SDK e pendem do Control Plane.
21
+ - Vulnerabilidades high reportadas pelo npm permanecem sob revisão separada.
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; transporte, serialização e erros foram determinísticos;
27
+ - cache: não aplicável nesta unidade.
@@ -1,21 +1,21 @@
1
- # Handoff — adapter SQLite
2
-
3
- - **from**: persistence-adapter-engineer
4
- - **to**: mcp-application-engineer
5
- - **intent**: implement
6
- - **context**: `packages/adapter-sqlite/src/index.ts`; `packages/contracts/src/index.ts`; `packages/events/src/index.ts`; `packages/runtime/src/index.ts`; `packages/orchestration/src/index.ts`; `memory/90-decisions/0045-forja-2-sqlite-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
- - **acceptance**: migrações versionadas e idempotentes; persistência de Sprint, Task, Handoff, Sandbox, Checkpoint, Runtime Run, Event e Auditoria; eventos deduplicados por idempotência; retomada recupera checkpoint.
8
- - **constraints**: domínio sem SQLite/driver; nenhuma migração destrutiva; JSON e SQL confinados ao adapter; manter contratos versionados e resultados auditáveis.
9
- - **return**: implementar `packages/mcp` como adaptador sobre Capability Registry, Context, GraphLoop e orchestration, com schemas derivados dos contratos, policy aplicada, identidade registrada e erros normalizados.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `node --test test/adapter-sqlite.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; migração, serialização e idempotência foram determinísticas;
21
- - cache: não aplicável nesta unidade.
1
+ # Handoff — adapter SQLite
2
+
3
+ - **from**: persistence-adapter-engineer
4
+ - **to**: mcp-application-engineer
5
+ - **intent**: implement
6
+ - **context**: `packages/adapter-sqlite/src/index.ts`; `packages/contracts/src/index.ts`; `packages/events/src/index.ts`; `packages/runtime/src/index.ts`; `packages/orchestration/src/index.ts`; `memory/90-decisions/0045-forja-2-sqlite-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
7
+ - **acceptance**: migrações versionadas e idempotentes; persistência de Sprint, Task, Handoff, Sandbox, Checkpoint, Runtime Run, Event e Auditoria; eventos deduplicados por idempotência; retomada recupera checkpoint.
8
+ - **constraints**: domínio sem SQLite/driver; nenhuma migração destrutiva; JSON e SQL confinados ao adapter; manter contratos versionados e resultados auditáveis.
9
+ - **return**: implementar `packages/mcp` como adaptador sobre Capability Registry, Context, GraphLoop e orchestration, com schemas derivados dos contratos, policy aplicada, identidade registrada e erros normalizados.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `node --test test/adapter-sqlite.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; migração, serialização e idempotência foram determinísticas;
21
+ - cache: não aplicável nesta unidade.
@@ -1,23 +1,23 @@
1
- # Handoff — Worker e Dashboard boundary
2
-
3
- - **from**: dashboard-worker-engineer
4
- - **to**: next-distribution-engineer
5
- - **intent**: implement
6
- - **context**: `apps/worker/src/main.ts`; `apps/dashboard/src/index.ts`; `packages/observability/src/index.ts`; `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; ADR-0054
7
- - **acceptance**: worker compõe Event Bus/Scheduler/Evaluation; dashboard lê Control Plane e delega ações críticas; nenhuma regra crítica está no view model; testes e build passam.
8
- - **constraints**: não conectar dashboard diretamente a SQLite; não autorizar no cliente; preservar backend offline e contratos existentes; Next/React deve ser adaptador de distribuição.
9
- - **return**: ligar a distribuição Next.js/React, TanStack Query, SSE e telas operacionais sobre esse boundary; depois validar release/packaging.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `node --import tsx --test test/dashboard-worker.test.js`: passou.
16
- - `npm test`: pendente após esta unidade.
17
- - `git diff --check`: pendente após esta unidade.
18
-
19
- ## Métricas de tokens
20
-
21
- - consumo de LLM: não aplicável;
22
- - worker sem execução de agente no teste;
23
- - dashboard usa somente métricas/observações fornecidas pelo Control Plane.
1
+ # Handoff — Worker e Dashboard boundary
2
+
3
+ - **from**: dashboard-worker-engineer
4
+ - **to**: next-distribution-engineer
5
+ - **intent**: implement
6
+ - **context**: `apps/worker/src/main.ts`; `apps/dashboard/src/index.ts`; `packages/observability/src/index.ts`; `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; ADR-0054
7
+ - **acceptance**: worker compõe Event Bus/Scheduler/Evaluation; dashboard lê Control Plane e delega ações críticas; nenhuma regra crítica está no view model; testes e build passam.
8
+ - **constraints**: não conectar dashboard diretamente a SQLite; não autorizar no cliente; preservar backend offline e contratos existentes; Next/React deve ser adaptador de distribuição.
9
+ - **return**: ligar a distribuição Next.js/React, TanStack Query, SSE e telas operacionais sobre esse boundary; depois validar release/packaging.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `node --import tsx --test test/dashboard-worker.test.js`: passou.
16
+ - `npm test`: pendente após esta unidade.
17
+ - `git diff --check`: pendente após esta unidade.
18
+
19
+ ## Métricas de tokens
20
+
21
+ - consumo de LLM: não aplicável;
22
+ - worker sem execução de agente no teste;
23
+ - dashboard usa somente métricas/observações fornecidas pelo Control Plane.
@@ -1,23 +1,23 @@
1
- # Handoff — Approval server-side concluído
2
-
3
- - **from**: graphloop-ui-engineer
4
- - **to**: release-security-auditor
5
- - **intent**: review
6
- - **context**: `apps/dashboard/app/api/forja/approval.ts`; `apps/dashboard/app/api/forja/[...path]/route.ts`; `apps/dashboard/app/dashboard-client.tsx`; ADR-0058
7
- - **acceptance**: cliente envia apenas decisão; proxy exige `FORJA_APPROVER_ID`, injeta identidade/timestamp e encaminha; entradas inválidas são rejeitadas; ausência de identidade não aprova.
8
- - **constraints**: não expor token/identidade como segredo no cliente; não bypassar ApprovalLedger; não usar fallback permissivo.
9
- - **return**: executar auditoria de segurança, verificar packaging/dependencies, revisar release gates e preparar GO/NO-GO.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `npm run dashboard:build`: passou.
16
- - `npm test -- --test-concurrency=1`: 267 testes passaram.
17
- - `git diff --check`: passou.
18
-
19
- ## Métricas de tokens
20
-
21
- - consumo de LLM: não aplicável;
22
- - decisões de approval: determinísticas e server-side;
23
- - testes adicionados: 2 cenários de identidade/configuração.
1
+ # Handoff — Approval server-side concluído
2
+
3
+ - **from**: graphloop-ui-engineer
4
+ - **to**: release-security-auditor
5
+ - **intent**: review
6
+ - **context**: `apps/dashboard/app/api/forja/approval.ts`; `apps/dashboard/app/api/forja/[...path]/route.ts`; `apps/dashboard/app/dashboard-client.tsx`; ADR-0058
7
+ - **acceptance**: cliente envia apenas decisão; proxy exige `FORJA_APPROVER_ID`, injeta identidade/timestamp e encaminha; entradas inválidas são rejeitadas; ausência de identidade não aprova.
8
+ - **constraints**: não expor token/identidade como segredo no cliente; não bypassar ApprovalLedger; não usar fallback permissivo.
9
+ - **return**: executar auditoria de segurança, verificar packaging/dependencies, revisar release gates e preparar GO/NO-GO.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `npm run dashboard:build`: passou.
16
+ - `npm test -- --test-concurrency=1`: 267 testes passaram.
17
+ - `git diff --check`: passou.
18
+
19
+ ## Métricas de tokens
20
+
21
+ - consumo de LLM: não aplicável;
22
+ - decisões de approval: determinísticas e server-side;
23
+ - testes adicionados: 2 cenários de identidade/configuração.
@@ -1,24 +1,24 @@
1
- # Handoff — Dashboard proxy, autenticação e estado remoto
2
-
3
- - **from**: control-plane-ui-engineer
4
- - **to**: graphloop-ui-release-auditor
5
- - **intent**: implement
6
- - **context**: `apps/dashboard/app/api/forja/[...path]/route.ts`; `apps/dashboard/app/providers.tsx`; `apps/dashboard/app/dashboard-client.tsx`; `packages/adapter-nest/src/index.ts`; `apps/server/src/main.ts`; ADR-0056
7
- - **acceptance**: token fica server-side; proxy aplica allowlist; TanStack Query cacheia métricas/observações; SSE invalida snapshot; pausa/cancelamento delegam ao Control Plane; Bearer inválido é rejeitado.
8
- - **constraints**: não expor `FORJA_AUTH_TOKEN`; não usar proxy genérico; não autorizar no cliente; manter Policy e persistência fora do dashboard.
9
- - **return**: implementar GraphLoop visual, approvals e demais áreas operacionais; executar auditoria de segurança, packaging e release gates.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `npm run dashboard:build`: passou com Next 15.5.9.
16
- - `npm test -- --test-concurrency=1`: 265 testes passaram.
17
- - `npm test` paralelo: instável em testes legados que alteram PATH/processos; investigar no harness antes do release.
18
- - `git diff --check`: passou.
19
-
20
- ## Métricas de tokens
21
-
22
- - consumo de LLM: não aplicável;
23
- - dashboard usa cache remoto com `staleTime` de 5 segundos;
24
- - SSE invalida a query sem reenviar histórico ao cliente.
1
+ # Handoff — Dashboard proxy, autenticação e estado remoto
2
+
3
+ - **from**: control-plane-ui-engineer
4
+ - **to**: graphloop-ui-release-auditor
5
+ - **intent**: implement
6
+ - **context**: `apps/dashboard/app/api/forja/[...path]/route.ts`; `apps/dashboard/app/providers.tsx`; `apps/dashboard/app/dashboard-client.tsx`; `packages/adapter-nest/src/index.ts`; `apps/server/src/main.ts`; ADR-0056
7
+ - **acceptance**: token fica server-side; proxy aplica allowlist; TanStack Query cacheia métricas/observações; SSE invalida snapshot; pausa/cancelamento delegam ao Control Plane; Bearer inválido é rejeitado.
8
+ - **constraints**: não expor `FORJA_AUTH_TOKEN`; não usar proxy genérico; não autorizar no cliente; manter Policy e persistência fora do dashboard.
9
+ - **return**: implementar GraphLoop visual, approvals e demais áreas operacionais; executar auditoria de segurança, packaging e release gates.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `npm run dashboard:build`: passou com Next 15.5.9.
16
+ - `npm test -- --test-concurrency=1`: 265 testes passaram.
17
+ - `npm test` paralelo: instável em testes legados que alteram PATH/processos; investigar no harness antes do release.
18
+ - `git diff --check`: passou.
19
+
20
+ ## Métricas de tokens
21
+
22
+ - consumo de LLM: não aplicável;
23
+ - dashboard usa cache remoto com `staleTime` de 5 segundos;
24
+ - SSE invalida a query sem reenviar histórico ao cliente.
@@ -1,23 +1,23 @@
1
- # Handoff — GraphLoop e approvals no dashboard
2
-
3
- - **from**: graphloop-ui-engineer
4
- - **to**: release-security-auditor
5
- - **intent**: review
6
- - **context**: `packages/graph/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/policy/src/index.ts`; `packages/observability/src/index.ts`; `apps/server/src/main.ts`; `apps/dashboard/app/dashboard-client.tsx`; ADR-0057
7
- - **acceptance**: dashboard consulta nós/impacto e lista approvals por API; GraphLoop permanece no domínio; Policy/approval não são decididos no cliente; proxy mantém allowlist; typecheck/build/testes passam.
8
- - **constraints**: não inventar arestas/evidências; não aprovar sem identidade; não liberar acesso direto a SQLite; manter execução crítica no Control Plane.
9
- - **return**: implementar visualização avançada/evidências e fluxo de aprovação autenticado, depois executar auditoria de segurança, packaging e release.
10
-
11
- ## Evidências
12
-
13
- - `npm run types:check`: passou.
14
- - `npm run build`: passou.
15
- - `npm run dashboard:build`: passou.
16
- - `npm test -- --test-concurrency=1`: 265 testes passaram.
17
- - `git diff --check`: passou.
18
-
19
- ## Métricas de tokens
20
-
21
- - consumo de LLM: não aplicável;
22
- - GraphLoop e impacto: consultas determinísticas;
23
- - approvals: listagem estruturada, sem decisão automática.
1
+ # Handoff — GraphLoop e approvals no dashboard
2
+
3
+ - **from**: graphloop-ui-engineer
4
+ - **to**: release-security-auditor
5
+ - **intent**: review
6
+ - **context**: `packages/graph/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/policy/src/index.ts`; `packages/observability/src/index.ts`; `apps/server/src/main.ts`; `apps/dashboard/app/dashboard-client.tsx`; ADR-0057
7
+ - **acceptance**: dashboard consulta nós/impacto e lista approvals por API; GraphLoop permanece no domínio; Policy/approval não são decididos no cliente; proxy mantém allowlist; typecheck/build/testes passam.
8
+ - **constraints**: não inventar arestas/evidências; não aprovar sem identidade; não liberar acesso direto a SQLite; manter execução crítica no Control Plane.
9
+ - **return**: implementar visualização avançada/evidências e fluxo de aprovação autenticado, depois executar auditoria de segurança, packaging e release.
10
+
11
+ ## Evidências
12
+
13
+ - `npm run types:check`: passou.
14
+ - `npm run build`: passou.
15
+ - `npm run dashboard:build`: passou.
16
+ - `npm test -- --test-concurrency=1`: 265 testes passaram.
17
+ - `git diff --check`: passou.
18
+
19
+ ## Métricas de tokens
20
+
21
+ - consumo de LLM: não aplicável;
22
+ - GraphLoop e impacto: consultas determinísticas;
23
+ - approvals: listagem estruturada, sem decisão automática.
@@ -1,41 +1,41 @@
1
- # Handoff — Sprint 1: CLI e Capability Registry
2
-
3
- - **from**: Orchestrator
4
- - **to**: SDD Architect / Worker
5
- - **intent**: continuar a migração progressiva dos comandos públicos para o Capability Registry.
6
- - **context**: a auditoria encontrou dois registries: o declarativo legado em
7
- `lib/core/registry.ts` e o registry executável em `packages/core`. A ponte foi implementada em
8
- `apps/cli/src/index.ts` para três comandos de prova.
9
- - **acceptance**: manter `npm run types:check`, testes da suíte e `tools:doctor` sem falha crítica;
10
- adicionar a próxima capability com schema, alias, policy, evidência, `ExecutionResult` e teste
11
- de equivalência antes de alterar o dispatch legado.
12
- - **constraints**: não integrar MCP, GraphLoop, runtime persistente ou autonomia nesta sprint;
13
- não duplicar handler; preservar compatibilidade dos comandos não migrados; evitar mudanças
14
- destrutivas e manter contratos versionados.
15
- - **return**: entregar mapa atualizado comando→capability, testes determinísticos, documentação,
16
- ADR se a decisão alterar fronteiras e relatório de auditoria atualizado.
17
-
18
- ## Trabalho concluído
19
-
20
- - `tools:doctor` → `system.doctor`;
21
- - `code:impact` → `code.impact`;
22
- - `context:budget` → `context.budget`;
23
- - descoberta por `capabilities:list` e `capabilities:describe`;
24
- - execução por `capability:execute`;
25
- - validação antes do handler, policy gate, evidência `forja.cli` e normalização de exit code;
26
- - audit record inclui `capabilityId`, `runId`, `correlationId`, status e duração.
27
-
28
- ## Evidências
29
-
30
- - `docs/2x/IMPLEMENTATION-AUDIT.md`;
31
- - `docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md`;
32
- - `docs/2x/CLI-CAPABILITIES.md`;
33
- - `test/cli-capability-adapter.test.js`;
34
- - execução real dos três comandos com workspace temporário em 2026-08-01.
35
-
36
- ## Bloqueios e ressalvas
37
-
38
- - CodeGraph não inicializado no workspace usado na prova; `code:impact` preservou o comportamento
39
- legado e terminou com saída zero, mas registrou a mensagem diagnóstica no envelope.
40
- - `tools:doctor` continua reportando apenas avisos conhecidos sobre workspace/memória e ferramentas
41
- opcionais ausentes; não há falha crítica após a integração.
1
+ # Handoff — Sprint 1: CLI e Capability Registry
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: SDD Architect / Worker
5
+ - **intent**: continuar a migração progressiva dos comandos públicos para o Capability Registry.
6
+ - **context**: a auditoria encontrou dois registries: o declarativo legado em
7
+ `lib/core/registry.ts` e o registry executável em `packages/core`. A ponte foi implementada em
8
+ `apps/cli/src/index.ts` para três comandos de prova.
9
+ - **acceptance**: manter `npm run types:check`, testes da suíte e `tools:doctor` sem falha crítica;
10
+ adicionar a próxima capability com schema, alias, policy, evidência, `ExecutionResult` e teste
11
+ de equivalência antes de alterar o dispatch legado.
12
+ - **constraints**: não integrar MCP, GraphLoop, runtime persistente ou autonomia nesta sprint;
13
+ não duplicar handler; preservar compatibilidade dos comandos não migrados; evitar mudanças
14
+ destrutivas e manter contratos versionados.
15
+ - **return**: entregar mapa atualizado comando→capability, testes determinísticos, documentação,
16
+ ADR se a decisão alterar fronteiras e relatório de auditoria atualizado.
17
+
18
+ ## Trabalho concluído
19
+
20
+ - `tools:doctor` → `system.doctor`;
21
+ - `code:impact` → `code.impact`;
22
+ - `context:budget` → `context.budget`;
23
+ - descoberta por `capabilities:list` e `capabilities:describe`;
24
+ - execução por `capability:execute`;
25
+ - validação antes do handler, policy gate, evidência `forja.cli` e normalização de exit code;
26
+ - audit record inclui `capabilityId`, `runId`, `correlationId`, status e duração.
27
+
28
+ ## Evidências
29
+
30
+ - `docs/2x/IMPLEMENTATION-AUDIT.md`;
31
+ - `docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md`;
32
+ - `docs/2x/CLI-CAPABILITIES.md`;
33
+ - `test/cli-capability-adapter.test.js`;
34
+ - execução real dos três comandos com workspace temporário em 2026-08-01.
35
+
36
+ ## Bloqueios e ressalvas
37
+
38
+ - CodeGraph não inicializado no workspace usado na prova; `code:impact` preservou o comportamento
39
+ legado e terminou com saída zero, mas registrou a mensagem diagnóstica no envelope.
40
+ - `tools:doctor` continua reportando apenas avisos conhecidos sobre workspace/memória e ferramentas
41
+ opcionais ausentes; não há falha crítica após a integração.
@@ -1,23 +1,23 @@
1
- # Handoff — Sprint 10: Graph sync
2
-
3
- - **from**: Orchestrator
4
- - **to**: Graph / Runtime / Governance
5
- - **intent**: operar a indexação incremental do GraphLoop sobre workspace Git.
6
- - **context**: `GitGraphDocumentSource` lista arquivos rastreáveis e indexáveis;
7
- `GraphIndexer` aplica extractors com checksum; `graph.sync` é capability
8
- estruturada registrada no server e protegida por permissão de escrita.
9
- - **acceptance**: manter exclusões de escopo, idempotência, evidência e falha
10
- aberta para Git inválido; não podar remoções sem evidência de histórico.
11
- - **constraints**: operação local/offline; limite de 1 MB por arquivo; sem LLM;
12
- commits e diffs ainda não são indexados.
13
- - **return**: próxima sprint deve adicionar estado de sincronização/remoção e
14
- integrar `graph.sync` à CLI/MCP com observabilidade de duração, arquivos e
15
- contagens.
16
-
17
- ## Evidências
18
-
19
- - `docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md`;
20
- - `memory/90-decisions/0067-graph-sync-capability.md`;
21
- - `test/adapter-git.test.js`;
22
- - `test/graph.test.js`;
23
- - `test/cli-capability-adapter.test.js`.
1
+ # Handoff — Sprint 10: Graph sync
2
+
3
+ - **from**: Orchestrator
4
+ - **to**: Graph / Runtime / Governance
5
+ - **intent**: operar a indexação incremental do GraphLoop sobre workspace Git.
6
+ - **context**: `GitGraphDocumentSource` lista arquivos rastreáveis e indexáveis;
7
+ `GraphIndexer` aplica extractors com checksum; `graph.sync` é capability
8
+ estruturada registrada no server e protegida por permissão de escrita.
9
+ - **acceptance**: manter exclusões de escopo, idempotência, evidência e falha
10
+ aberta para Git inválido; não podar remoções sem evidência de histórico.
11
+ - **constraints**: operação local/offline; limite de 1 MB por arquivo; sem LLM;
12
+ commits e diffs ainda não são indexados.
13
+ - **return**: próxima sprint deve adicionar estado de sincronização/remoção e
14
+ integrar `graph.sync` à CLI/MCP com observabilidade de duração, arquivos e
15
+ contagens.
16
+
17
+ ## Evidências
18
+
19
+ - `docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md`;
20
+ - `memory/90-decisions/0067-graph-sync-capability.md`;
21
+ - `test/adapter-git.test.js`;
22
+ - `test/graph.test.js`;
23
+ - `test/cli-capability-adapter.test.js`.