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,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`.
@@ -0,0 +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,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`.
@@ -0,0 +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
@@ -0,0 +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
@@ -0,0 +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
@@ -0,0 +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,38 +1,38 @@
1
- # ADR-0001: Memória hierárquica em 9 camadas (00-90)
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-04-21
5
- - **Tags**: memory, structure
6
-
7
- ## Contexto
8
- Agentes precisam de contexto durável entre sessões, mas carregar todo o histórico estoura janela de tokens. Memórias planas (single file) ficam ingovernáveis acima de ~5k linhas; pastas sem semântica viram dump.
9
-
10
- ## Decisão
11
- Adotar hierarquia fixa de 9 prefixos numerados em `memory/`:
12
-
13
- | Prefixo | Conteúdo |
14
- |---|---|
15
- | `00-global` | Missão, padrões, política de contexto, contrato de agentes |
16
- | `10-product` | Visão, personas, regras de negócio, NFRs |
17
- | `20-architecture` | Frontend, backend, dados, segurança, observabilidade |
18
- | `30-domains` | Um subdiretório por bounded-context (auth, billing, …) |
19
- | `40-delivery` | Roadmap, sprint atual, backlog |
20
- | `50-orchestration` | Topologia, roteamento, handoff protocol, playbook |
21
- | `60-runs` | Log cronológico de execuções (arquivado após 30d) |
22
- | `70-summaries` | Resumos global e por domínio (gerados por compress-memory) |
23
- | `80-data` | Documentação do SQLite e schemas |
24
- | `90-decisions` | ADRs |
25
-
26
- ## Alternativas consideradas
27
- - **Memória plana em 1 arquivo** — rejeitada: ingovernável acima de 5k linhas
28
- - **Pastas por feature sem prefixo** — rejeitada: ordem alfabética não reflete relevância
29
- - **Banco vetorial puro** — rejeitada: perde estrutura humana-legível e versionamento git
30
-
31
- ## Consequências
32
- **Positivas**: navegação previsível, prefixos ordenam por relevância de contexto, fácil arquivamento por nível.
33
- **Negativas**: rigidez — adicionar uma camada nova exige decisão coletiva.
34
-
35
- ## Rastreamento
36
- - `bin/create-memory-nest-kit.js` (writeMemoryAndOps)
37
- - `lib/generators/memory-generator.js`
38
- - `memory/00-global/` (este repositório)
1
+ # ADR-0001: Memória hierárquica em 9 camadas (00-90)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-04-21
5
+ - **Tags**: memory, structure
6
+
7
+ ## Contexto
8
+ Agentes precisam de contexto durável entre sessões, mas carregar todo o histórico estoura janela de tokens. Memórias planas (single file) ficam ingovernáveis acima de ~5k linhas; pastas sem semântica viram dump.
9
+
10
+ ## Decisão
11
+ Adotar hierarquia fixa de 9 prefixos numerados em `memory/`:
12
+
13
+ | Prefixo | Conteúdo |
14
+ |---|---|
15
+ | `00-global` | Missão, padrões, política de contexto, contrato de agentes |
16
+ | `10-product` | Visão, personas, regras de negócio, NFRs |
17
+ | `20-architecture` | Frontend, backend, dados, segurança, observabilidade |
18
+ | `30-domains` | Um subdiretório por bounded-context (auth, billing, …) |
19
+ | `40-delivery` | Roadmap, sprint atual, backlog |
20
+ | `50-orchestration` | Topologia, roteamento, handoff protocol, playbook |
21
+ | `60-runs` | Log cronológico de execuções (arquivado após 30d) |
22
+ | `70-summaries` | Resumos global e por domínio (gerados por compress-memory) |
23
+ | `80-data` | Documentação do SQLite e schemas |
24
+ | `90-decisions` | ADRs |
25
+
26
+ ## Alternativas consideradas
27
+ - **Memória plana em 1 arquivo** — rejeitada: ingovernável acima de 5k linhas
28
+ - **Pastas por feature sem prefixo** — rejeitada: ordem alfabética não reflete relevância
29
+ - **Banco vetorial puro** — rejeitada: perde estrutura humana-legível e versionamento git
30
+
31
+ ## Consequências
32
+ **Positivas**: navegação previsível, prefixos ordenam por relevância de contexto, fácil arquivamento por nível.
33
+ **Negativas**: rigidez — adicionar uma camada nova exige decisão coletiva.
34
+
35
+ ## Rastreamento
36
+ - `bin/create-memory-nest-kit.js` (writeMemoryAndOps)
37
+ - `lib/generators/memory-generator.js`
38
+ - `memory/00-global/` (este repositório)