forjajs 2.0.4 → 3.0.0

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 (798) 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 +50 -50
  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 +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
package/CHANGELOG.md CHANGED
@@ -1,9 +1,73 @@
1
- # Changelog
2
-
3
- Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
4
-
1
+ # Changelog
2
+
3
+ Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
4
+
5
5
  ---
6
6
 
7
+ ## [3.0.0] — 2026-09-01 — Engineering Control Plane
8
+
9
+ Fundação inteira da visão ForjaJS 3.0 (ADR-0078): a Forja passa a responder, de forma estruturada
10
+ e com evidência, *por que* um código existe, *se* uma mudança viola a arquitetura pretendida,
11
+ *qual o risco* de uma mudança antes dela acontecer, e *quem/o quê* a produziu. Major version pelo
12
+ critério já registrado no ADR-0078 — mudança de modelo mental, não quebra de compatibilidade:
13
+ **nenhum comando/contrato existente muda de assinatura ou comportamento**; toda extensão é aditiva.
14
+
15
+ ### Adicionado
16
+
17
+ **Fundação P0 — Engineering Graph, Architecture Constitution, Change Risk Engine, Evidence Ledger**
18
+ - `adr:list`/`:show`/`:impact`/`:graph` — ADRs/SPECs como nós de primeira classe do Engineering
19
+ Graph, extração determinística (sem LLM).
20
+ - `architecture:compile`/`:check`/`:status`/`:explain`/`:approve` — decisões de ADR (`##
21
+ Constraints`) viram regras executáveis, checadas contra o código real.
22
+ - `risk:assess`/`:explain` — score de risco 0-100 explicável, 7 fatores nomeados com evidência.
23
+ - `evidence:show`, `forja engineer "<objetivo>"` — view agregada por run e façade única que compõe
24
+ contexto + ADRs relevantes + arquitetura + risco + fluxo recomendado.
25
+
26
+ **Fase 3 — Agent Identity, Reputation, Smart Routing**
27
+ - `agent:register`/`:list`/`:show`/`:score`/`:history`/`:recommend` — identidade de agente
28
+ persistente com reputação derivada de comportamento real (nunca auto-declarada), e recomendação
29
+ de agente por adequação a papel/domínio.
30
+
31
+ **Fase 4 — Predictive Change Simulation**
32
+ - `forja simulate <ref>` — testa+arquitetura+risco de um ref num worktree git isolado, nunca
33
+ promove automaticamente.
34
+
35
+ **Fase 5 — AI Code Provenance, Runtime Monitoring**
36
+ - `forja blame <file>`, `forja sbom`, `provenance:record` — proveniência de código gerado por IA
37
+ (granularidade de arquivo).
38
+ - `agent:monitor` — compara comportamento recente de um agente contra sua própria linha de base,
39
+ informação para `PolicyEngine` consultar (`riskScoreRange`/`anomalyScoreRange`), nunca decisão
40
+ automática.
41
+
42
+ **Fase 6 — Learning Loop**
43
+ - `incident:record`/`:list`/`:similar` — registro de incidentes e sugestão por palavra-chave,
44
+ nunca aplicação automática.
45
+
46
+ **`forja engineer` estendida** — passa a compor também agentes recomendados e incidentes parecidos
47
+ conforme essas capacidades passaram a existir.
48
+
49
+ **Fase 7 — Autonomous Maintenance**: documentada em ADR-0079 como prontidão arquitetural
50
+ ("arquitetura preparatória, nunca habilitação automática", por desenho explícito da visão
51
+ original) — os guardrails que qualquer manutenção autônoma real precisará respeitar.
52
+
53
+ ### Corrigido
54
+
55
+ Achados reais descobertos e corrigidos ao longo da implementação, não deixados como dívida:
56
+ - `SqliteGraphStore` gravava nó a nó sem transação — reindexação do Engineering Graph 2,8× mais
57
+ rápida (7,65s → 2,75s medido contra este repositório), tempo de sistema caindo ~36×.
58
+ - `memory-db` (gate de saúde) reportava "corrompido" quando na verdade só faltava sincronizar uma
59
+ tabela — diagnóstico corrigido.
60
+ - `sandboxEnvironment` (isolamento de sandbox) não passava `HOME`/`USERPROFILE`, travando `npm`
61
+ indefinidamente dentro de um worktree isolado.
62
+ - `security_sensitivity` (fator de risco) não reconhecia auth/session/shutdown como sensíveis —
63
+ vocabulário expandido, limitação estrutural remanescente documentada.
64
+
65
+ ### Validação
66
+
67
+ 461 testes, `tsc --noEmit`, `check:all`, `spec:check` e `release:check` verdes. 15 PRs (#45-#59),
68
+ cada sprint seguindo o próprio processo SDD da Forja (spec → plan → tasks → implementação → testes)
69
+ e validado contra dado real ou sintético explicitamente documentado como tal.
70
+
7
71
  ## [2.0.4] — 2026-08-17 — Auditoria de release e handoffs confiáveis
8
72
 
9
73
  ### Alterado
@@ -21,554 +85,554 @@ Histórico consolidado das mudanças estruturais do framework. Para decisões ar
21
85
  - `npm audit --omit=dev`: zero vulnerabilidades de produção.
22
86
 
23
87
  ## [2.0.2] — 2026-08-01 — Integração operacional das Sprints 1–11
24
-
25
- Consolida a evolução do ForjaJS 2.x após a fundação 2.0.1, conectando a CLI,
26
- Capability Registry, Runtime, MCP, SQLite, GraphLoop e Context Engine em um
27
- fluxo persistente, auditável e testado.
28
-
29
- ### Adicionado
30
- - Adapter da CLI sobre o Capability Registry com `ExecutionResult` estruturado.
31
- - Persistência SQLite para runtime, aprovações, eventos e GraphLoop.
32
- - MCP dinâmico derivado das capabilities registradas.
33
- - Context Engine integrado ao GraphLoop, com cache por checksum e orçamento.
34
- - Extractors determinísticos e capability `graph.sync` para CLI/MCP.
35
- - Testes de recuperação, autonomia E2E, contratos e integração.
36
- - ADRs, auditoria de implementação e handoffs das Sprints 1–11.
37
-
38
- ## [2.0.1] — 2026-08-01 — Higiene de dependências do pacote
39
-
40
- Move as dependências de NestJS e dashboard para os manifests das aplicações e
41
- para `devDependencies` do repositório. O tarball do framework agora carrega
42
- somente `better-sqlite3` como dependência de runtime, eliminando peso morto sem
43
- alterar os ambientes oficiais de server e dashboard.
44
-
45
- ## [2.0.0] — 2026-08-01 — Fundação programável local-first
46
-
47
- Primeira release da plataforma ForjaJS 2.0. A versão mantém a
48
- CLI-first e adiciona um núcleo programável por agentes, com contratos
49
- versionados, capabilities, runtime controlado, políticas, memória, GraphLoop,
50
- contexto orçamentado, MCP, SDK, adapters oficiais, observabilidade e dashboard.
51
-
52
- ### Adicionado
53
- - Monorepo modular com `apps/server`, `apps/dashboard`, `apps/worker` e pacotes
54
- de domínio/adaptação independentes de framework.
55
- - Contracts, Capability Registry, Policy Engine, Runtime, Sprint/Task/Handoff,
56
- Event Bus, Scheduler, Sandbox, Planner, Validator, GraphLoop e Context Engine.
57
- - MCP, SDK, Plugin SDK, adapters SQLite/Git/NestJS, Control Plane e Evaluation
58
- Engine.
59
- - Dashboard Next.js com consultas, GraphLoop, aprovações e ações supervisionadas.
60
- - Auditoria de segurança, release e migração documentada.
61
-
62
- ### Validação do candidato
63
- - TypeScript, builds e 267 testes determinísticos aprovados.
64
- - `npm audit --offline --omit=dev --audit-level=high`: zero vulnerabilidades.
65
- - Gitleaks: zero achados após limpeza dos artefatos de build.
66
- - Release validada após merge da PR #40 e execução do gate de publicação sobre
67
- o commit/tag limpos.
68
-
69
- ## [1.7.3] — 2026-07-23 — Doctor: permissão/lock não é corrupção
70
-
71
- O check `memory-db` (consumido por `tools:doctor` e pelo `SessionStart`) tratava **qualquer** falha
72
- de abertura do `universal.db` como corrupção e prescrevia `sync:universal`. Num ambiente sem escrita
73
- (sandbox, FS read-only, diretório protegido) o driver lança `SQLITE_CANTOPEN` — e a prescrição é
74
- ativamente errada: `sync:universal` *escreve* no banco, reencenaria o mesmo erro sem curar nada, e
75
- levaria o operador a "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox.
76
-
77
- ### Corrigido
78
- - **`memory-db` classifica a falha de abertura por `err.code`** em vez de colapsar tudo em
79
- "corrompido" (ADR-0033):
80
- - `SQLITE_CANTOPEN` / `EACCES` → **permissão/sandbox**, não corrupção; o fix orienta garantir
81
- leitura no path e **desaconselha** `sync:universal`.
82
- - `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); o fix é aguardar.
83
- - `SQLITE_CORRUPT` / `SQLITE_NOTADB` / resto → corrupção; fix `npm run sync:universal`.
84
- O `err.code` já vinha impresso no `detail`, mas não decidia nada — a informação existia, faltava
85
- ramificar. É a mesma classe do bug de ABI que motivou a SPEC-009, sobrevivendo dentro do arquivo
86
- escrito para fechá-la.
87
-
88
- ### Adicionado
89
- - **ADR-0033** e quatro casos em `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB): a distinção
90
- vira invariante que roda.
91
-
92
- ---
93
-
94
- ## [1.7.2] — 2026-07-22 — Fechando a classe: superfícies do projeto usam `cwd`
95
-
96
- A auditoria sistemática dos comandos consumer-facing (o passo estrutural após os fixes caso-a-caso
97
- de `spec:new`/`project:check`) achou **mais três instâncias vivas** da mesma classe — todas escondidas
98
- num `const root = __dirname/..` que misturava "recurso do framework" com "projeto do usuário". Agora a
99
- regra é explícita e tem gate (ADR-0032).
100
-
101
- ### Corrigido
102
- - **`gsd:plan`/`gsd:handoff`/`gsd:check`** (agent-harness) gravavam o runbook e liam `specs/` dentro
103
- do pacote no consumidor; o `gsd:check` ainda spawava o `spec:check` com `cwd` do pacote e caminho
104
- `.mjs` cravado (inexistente no dist). Agora operam em `process.cwd()` e resolvem o script via
105
- `resolveScript` (`.ts` no dev, `.js` no dist).
106
- - **`context:budget`/`agent:brief`/`context:sprint`** (context-ops) resolviam `.context/`, `specs/`,
107
- `memory/` e o `.memoryrc.json` no pacote; o `cmdBudget` ainda validava travessia contra a raiz do
108
- pacote e rejeitava arquivos do projeto. Agora usam `projectRoot = process.cwd()`; `catalog:*`
109
- (recurso do framework) segue em `root`.
110
- - **`design:check`** rejeitava o brief do consumidor ("caminho fora do projeto") por ancorar a
111
- travessia no pacote — agora ancora no projeto.
112
-
113
- ### Adicionado
114
- - **Gate `consumer-project-surfaces`** no `release:check`: executa `gsd:plan` + `context:budget` no
115
- cwd de um consumidor instalado e prova que o runbook cai em `<cwd>/.context/` e que o budget o lê de
116
- lá. Testemunha cruzada, independente do banco — reprova a classe inteira antes do publish.
117
- - **ADR-0032** e `test/consumer-project-surfaces.test.js`: a regra `projectRoot` (cwd) vs `root`
118
- (framework) como invariante que roda. `sprint-manager` foi auditado e está são (opera pelo workspace).
119
-
120
- ---
121
-
122
- ## [1.7.1] — 2026-07-22 — Correção: `project:check` em projetos consumidores
123
-
124
- ### Corrigido
125
- - **`forja project:check` num projeto consumidor auditava `node_modules/forjajs/dist/`** em vez do
126
- projeto (raiz cravada em `__dirname/..`), reportando os arquivos obrigatórios como faltando (score
127
- 0%) — o que travava o gate `implement` do `orchestrate`. Agora audita `process.cwd()` (propagado
128
- pelo dispatcher desde a 1.6.2). Mesma classe do `spec-cli` (v1.6.2); o `check-standards` ficou de
129
- fora. O `check:all` **não** é afetado (agrega health/smoke/release, não `project:check`).
130
-
131
- ### Adicionado
132
- - **Gate `consumer-project-check`** no `release:check`: planta um arquivo só no cwd e prova que
133
- `project:check` audita o projeto do consumidor, não o pacote. Provado com dentes (reprova o bug).
134
-
135
- ---
136
-
137
- ## [1.7.0] — 2026-07-22 — O motor de orquestração: o namesake executando
138
-
139
- O nome do framework sempre foi orquestração multiagente; até aqui, a topologia era coerente
140
- (SPEC-019) mas o fluxo vivia por disciplina. Esta release o faz **rodar**.
141
-
142
- ### Adicionado
143
- - **`orchestrate` / `orchestrate:status` / `orchestrate:advance`** (SPEC-021, ADR-0031): a cadeia
144
- SDD/GSD (spec→plan→tasks→implement→review) como **máquina de estados guardada por gates**. Cada
145
- etapa abre com um handoff ADR-0005 para o dono do papel; `advance` só fecha a etapa se o artefato
146
- SDD estiver aprovado **e** o gate da transição sair verde — pular etapa é bloqueado pela máquina,
147
- não pela memória. O framework orquestra e guarda; o agente (IA ou humano) executa. Estado em
148
- `<cwd>/.context/orchestrate-<slug>.json`; roda no framework e em projetos consumidores.
149
- - `commands-documented` ganha fallback para comandos **sem dois-pontos** (grep literal de nome
150
- conhecido) — `orchestrate` é o primeiro do registry.
151
-
152
- ### Corrigido
153
- - **Backend gerado compila em Node 26**: o template pinava `better-sqlite3 ^11` (sem prebuild para
154
- Node novo); alinhado ao do framework (`^12`). Fecha o caveat da v1.6.0 — `check:all --full` verde.
155
- - **Roadmap defasado**: o `release-auditor` já consumia o gate (ADR-0024); refresh da tabela
156
- (+ `consumer-spec-new`) e checkboxes marcados nos READMEs.
157
-
158
- ---
159
-
160
- ## [1.6.2] — 2026-07-21 — Correção: `spec:new` em projetos consumidores
161
-
162
- ### Corrigido
163
- - **`forja spec:new` num projeto consumidor escrevia a spec DENTRO de `node_modules/forjajs/dist`**
164
- e falhava com "template ausente". Duas causas: o dispatcher spawnava os filhos com `cwd` = raiz do
165
- pacote (agora usa o cwd de quem invocou — uma CLI opera onde é chamada), e o `spec-cli` resolvia
166
- templates e destino por uma raiz só (agora separa `pkgRoot`, de onde vêm os templates, de
167
- `targetRoot`, onde as specs nascem). Framework inalterado.
168
- - Sem `.gitignore` ou sem bloco de allowlist: silêncio em vez de aviso — num consumidor esse é o
169
- estado saudável (specs versionadas normalmente).
170
-
171
- ### Adicionado
172
- - **Gate `consumer-spec-new`** no `release:check`: roda `spec:new` na instalação limpa e reprova se a
173
- spec não nascer no projeto do consumidor ou vazar para dentro do pacote. O smoke pegava "não
174
- carrega"; este pega "opera no mundo errado".
175
-
176
- ---
177
-
178
- ## [1.6.1] — 2026-07-20 — Correção: `project:upgrade` no pacote publicado
179
-
180
- ### Corrigido
181
- - **`project:upgrade` quebrava com `Cannot find module .../create-memory-nest-kit.ts`** no pacote
182
- instalado. O spawn do gerador cravava a extensão `.ts`; em dev funciona, mas o `dist/` publicado
183
- tem `.js`. Agora resolve dinamicamente via `resolveScript` (`.ts` em dev, `.js` no publicado). O
184
- `project:smoke` tinha o mesmo defeito, também corrigido. Teste de regressão guarda a classe.
185
-
186
- ---
187
-
188
- ## [1.6.0] — 2026-07-20 — A orquestração coerente e a governança num comando
189
-
190
- A governança do framework ganha um ponto de entrada e o namesake — orquestração multiagente — deixa
191
- de viver por prosa.
192
-
193
- ### Adicionado
194
- - **`check:all`** (SPEC-020): roda a **bateria inteira de gates** e dá um veredito só. Tier barato:
195
- coerência (`tools:doctor`) + `project:smoke`; `--full`: + tarball (`release:check`) + build do
196
- gerado. Compõe os runners existentes — zero check reimplementado. "A casa está coerente?" num
197
- comando, não num checklist lembrado.
198
- - **`agent-topology`** (check no `tools:doctor`, SPEC-019): a topologia de orquestração é descrita em
199
- três fontes (`VALID_AGENTS`, `.claude/agents/*.md`, `AGENTS.md`) e pode divergir em silêncio. O
200
- check as cruza e reprova quando não concordam. Pegou o `release-auditor` (sub-agent executável sem
201
- rota) na 1ª execução — agora first-class no router e documentado (AGENTS.md §7).
202
-
203
- ### Corrigido / interno
204
- - **`generators.test` migrado para `node:test`**: o harness custom legado não contava suas falhas no
205
- tally do CI e vazava um `/tmp` por execução (588 diretórios acumulados). Agora é `node:test` com
206
- cleanup — falha derruba o CI de verdade.
207
-
208
- ---
209
-
210
- ## [1.5.0] — 2026-07-19 — A memória como sistema fechado: medir → entregar → proteger → propagar
211
-
212
- A economia de token do Forja sempre foi a memória persistente (ADR-0009), mas era uma promessa. Esta
213
- release a torna um ciclo completo e verificável — cada peça fecha um elo.
214
-
215
- ### Adicionado
216
- - **`code:context <domínio>`** (SPEC-016): **entrega** o mapa da memória como pacote pronto para
217
- colar (o `context.md`), com `--code` para o código da fatia e o custo em token à mostra. É o −61%
218
- medido no `token:economy` virado ferramenta. Compõe com `code:impact` para o blast radius.
219
- - **`memory:audit`** (SPEC-017): **protege** o mapa nas duas direções — reprova se um `context.md`
220
- cita código que não existe (mapa que mente é pior que mapa nenhum) e avisa sobre módulo de código
221
- sem mapa (economia perdida em silêncio). O `adr-refs` aplicado aos mapas de memória.
222
- - **`token:economy --project <path>`**: mede o eixo memória nos **domínios reais do usuário** (mapa
223
- vs código, por domínio) — o número fica dele, não da fixture.
224
- - **`project:upgrade`** (SPEC-018): a metade que faltava do scaffolder. Traz peças novas de scaffold
225
- para um projeto já gerado — **aditivo, nunca sobrescreve** (o código do usuário é intocável).
226
- Dry-run por padrão; `--apply` copia.
227
- - **O projeto gerado herda o gate** (ADR-0030): o gerador emite `scripts/check-memory-maps.mjs`, um
228
- `memory:audit` self-contained (Node puro, zero dep), e o `project:smoke` prova a propagação. O
229
- invariante da coerência mapa↔código passa a viajar com cada projeto.
230
-
231
- ### Nota
232
- - Comandos e gates novos do framework; nada muda para projetos já gerados até rodarem `project:upgrade`.
233
-
234
- ---
235
-
236
- ## [1.4.0] — 2026-07-19 — Governança que mede: gate do gerador, economia de token e integridade de ADR
237
-
238
- Três fronteiras que viviam por disciplina viram harness — e cada uma provou seu valor pegando um
239
- problema real na estreia.
240
-
241
- ### Adicionado
242
- - **`project:smoke`** (SPEC-015, ADR-0029): o gate do projeto gerado. Gera um projeto num tmp isolado
243
- e prova que é coerente — zero placeholder `{{...}}` vazado, `package.json` válido, estrutura íntegra
244
- (reusa o `structure-validator`). Tier `--full` (opt-in): `npm install` + `npm run build` do backend
245
- gerado. É o `release:check` da saída do gerador, um nível acima do tarball.
246
- - **`token:economy`** (fecha a dívida do ADR-0027; mede ADR-0009): mede a economia de token em dois
247
- eixos, com file-sets explícitos. **Eixo arquitetura** (clean vs flat, mesma feature): camadas
248
- custam **+56%** numa feature pequena — a versão ingênua de "Clean Architecture economiza tokens"
249
- não se sustenta. **Eixo memória** (frio vs quente): o `context.md` (mapa) faz o contexto mínimo
250
- custar **−61%** vs varrer a fatia no frio — e isso **compõe** a cada tarefa. A economia do Forja é
251
- da memória persistente, amortizada no tempo, não das camadas. Narrativa corrigida no
252
- `WHEN-CLEAN-WHEN-LEAN.md` e no ADR-0027.
253
- - **`adr-refs`** (check no `tools:doctor`, ADR-0025): toda citação `ADR-NNNN` aponta para um ADR que
254
- existe. Na 1ª execução pegou o `ADR-0026` pendurado (citado pela SPEC-012, nunca escrito) — fechado
255
- escrevendo o **ADR-0026** (arquitetura da migração TS: resolver, runtime duplo, gate-builda-dist).
256
-
257
- ### Nota
258
- - Nada muda para quem já tem projetos gerados; são comandos e gates novos do framework.
259
-
260
- ---
261
-
262
- ## [1.3.2] — 2026-07-19 — Migração TypeScript concluída (interno)
263
-
264
- **Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.1. Fecha a SPEC-012.
265
-
266
- ### Alterado (interno)
267
- - **Fonte 100% TypeScript**: os 16 `.js` restantes (entries públicos `init-project`/
268
- `create-memory-nest-kit`, generators, validators, `context-builder`, scaffolding) viraram `.ts`.
269
- - **`noImplicitAny: true`** — o ratchet está armado: daqui pra frente todo parâmetro novo precisa de
270
- tipo explícito. Os ~285 params existentes foram anotados (tipo real onde agrega, `any` explícito
271
- onde o valor é dinâmico). Os checks de `health`/`release` viram `Check[]` de verdade.
272
- - Shim `lib/vendor.d.ts` para o `better-sqlite3` (sem tipos publicados); `lib/templates` fora do
273
- type-check (é conteúdo copiado, não código do framework).
274
- - Correção pega pelo `release:check`: um sed havia corrompido o array de fallback do `resolveScript`
275
- (`['.ts','.js','.mjs']`→`['.ts','.ts','.ts']`), quebrando a resolução do `dist/*.js`.
276
-
277
- ---
278
-
279
- ## [1.3.1] — 2026-07-19 — Migração TypeScript dos módulos do framework (interno)
280
-
281
- **Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.0. A conversão é
282
- interna: fecha a renomeação leaf-first da SPEC-012 Fase 2.
283
-
284
- ### Alterado (interno)
285
- - **Todos os 21 módulos `.mjs` do framework** (`bin/forja`, `lib/{audit,governance-report,workspace}`,
286
- todos os `scripts/` incluindo os 4 hooks) convertidos para `.ts`, com ~130 anotações de tipo. Os
287
- typedefs JSDoc viraram `interface`; os casts-comentário `/** @type */ (x)` viraram `as`.
288
- - Dev e CI rodam a fonte `.ts` (Node ≥22.6); o `ci.yml` invoca `bin/forja.ts`. O publicado segue
289
- `dist/*.js` (Node ≥20), provado pelo `release-gate`.
290
- - **Fora desta fatia** (deliberado): os 16 `.js` (entries públicos + generators + scaffolding), que
291
- seguem no checkJs, e `noImplicitAny: true` (endurecimento final).
292
-
293
- ---
294
-
295
- ## [1.3.0] — 2026-07-19 — Governança visível e o núcleo em TypeScript
296
-
297
- Duas frentes que amadurecem o framework: a governança sai do arquivo que ninguém abre para
298
- **consultável e visível**, e o motor de invariantes (`lib/core/`) passa a ser **TypeScript de
299
- verdade**, com o pacote publicando `dist/` compilado.
300
-
301
- ### Adicionado
302
- - **Auditoria consultável + painel de governança** (SPEC-014, ADR-0028): `audit:sync` projeta o
303
- `.context/forja-runs.jsonl` na tabela `audit_runs` (idempotente por `line_hash` — o `.jsonl` segue
304
- sendo a fonte de verdade); `audit:query` filtra a trilha por `--failed`/`--cmd`/`--since`/`--gate`;
305
- `governance:dashboard` gera um HTML **estático e self-contained** (sem servidor — a lição do
306
- ADR-0022) com o estado de specs, ADRs, gates e métricas.
307
- - **`lib/core/` em TypeScript** (SPEC-012 Fase 2, leaf-first): `checks`, `health`, `release`,
308
- `doc-graph` e `registry` viram `.ts` com `interface Check/Probe/Result` reais. Dev roda `.ts`
309
- nativo (Node ≥22.6); o publicado embarca `dist/*.js` (Node ≥20).
310
-
311
- ### Alterado
312
- - **O pacote publica `dist/` compilado** (SPEC-012 Fase 3): `bin`/`files[]` apontam para `dist/`. O
313
- `release:check` **builda o `dist/` antes de empacotar**, então o tarball provado é exatamente o
314
- publicado — sem step de build no CI, sem `dist/` no git, sem janela de staleness.
315
- - **CI**: o job `test` roda em Node 22.x/24.x (a fonte `.ts` exige strip-types ≥22.6). O suporte a
316
- Node 20 do pacote publicado (que é `dist/*.js`) segue provado pelo job `release-gate`.
317
-
318
- ---
319
-
320
- ## [1.2.0] — 2026-07-18 — Boilerplate Clean Architecture, coerência de doc e correções
321
-
322
- Feature nova (um boilerplate), o terceiro gate de invariante (coerência da documentação), e
323
- **correções de dois bugs vivos na 1.1.6** que o TypeScript achou. A migração TS avançou até o
324
- pipeline de build provado — mas continua publicando a fonte `.mjs` (a troca para `dist/` é interna
325
- e fica para uma release futura).
326
-
327
- ### Corrigido
328
- - **`npm run dev` estava quebrado** na 1.1.6: `scripts/dev.mjs` chamava `spawn()` sem importar —
329
- `ReferenceError` em três caminhos (agent-harness, compress-memory, create-memory-nest-kit).
330
- - **`context:budget` / `catalog:assets` estavam quebrados** na 1.1.6: `scripts/context-ops.mjs`
331
- importava `dbPath` (inexistente; só há `getDbPath`) e o usava em `new Database(dbPath)`.
332
- - Typedefs `Check`/`Result` duplicados e divergentes em `health.mjs` (resíduo da extração do runner).
333
- - 22 links relativos quebrados em docs legadas (personas, quick-reference, structure).
334
-
335
- ### Adicionado
336
- - **Boilerplate `06-clean-arch`** (SPEC-013, ADR-0027): DDD por camadas onde se paga, caminho enxuto
337
- onde não. Fatia rica (Orders) com inversão de dependência e invariante testável sem subir o Nest;
338
- caminho enxuto (Products) lado a lado; `WHEN-CLEAN-WHEN-LEAN.md` com o critério; memória por
339
- bounded context. A economia de token é reportada com honestidade (argumentada, não provada — o
340
- benchmark é follow-up).
341
- - **Gate de coerência da documentação** (SPEC-011, ADR-0025): `lib/core/doc-graph.mjs` + três checks
342
- no `health.mjs` — `docs-commands` (critical: todo `forja <cmd>` citado existe no registry),
343
- `commands-documented` e `docs-links` (warn). Rodam no `tools:doctor` e no CI.
344
- - **Resolver de script agnóstico de extensão** (SPEC-012): `resolveScript` desacopla o registry da
345
- extensão (`.ts → .js → .mjs`), preparando a migração TS. Backward-compatible.
346
-
347
- ### Interno
348
- - **TypeScript como gate** (SPEC-012, Fases 0-1): `checkJs` estrito sobre a fonte `.mjs`,
349
- `types:check` no CI, contratos do núcleo (`Check`/`Probe`/`Result`) tipados. Pipeline de build
350
- (`tsc → dist`) provado; a publicação de `dist/` e a renomeação `.mjs → .ts` ficam para depois.
351
-
352
- ### Nota
353
- - O `docs-links` pegou o **próprio autor**: um erro de profundidade relativa (`../../` vs `../../../`)
354
- na correção dos links foi detectado pelo doctor antes do commit. E o `release:check` pegou o
355
- acoplamento do dist-publish (código em `dist/scripts`, não `scripts/`) antes de qualquer publish.
356
-
357
- ## [1.1.6] — 2026-07-14 — README em inglês
358
-
359
- A vitrine do pacote passa a ter versão em inglês, para alcançar quem chega pelo npm.
360
-
361
- ### Adicionado
362
- - `README.en.md` — adaptação fiel do README em português, no estilo canônico `forja <comando>`.
363
- Seletor de idioma no topo dos dois arquivos. Incluído no `files[]` do pacote.
364
-
365
- ### Nota
366
- - A **documentação** (`docs/`) permanece em pt-BR — é parte da identidade do projeto. Só a capa
367
- ganhou inglês. O README inglês foi verificado contra o registry: zero comandos inexistentes,
368
- zero links quebrados.
369
-
370
- ## [1.1.5] — 2026-07-14 — O comando é forja
371
-
372
- A documentação pública ainda falava a língua interna do repo: `npm run x -- args` onde o usuário
373
- do pacote tem `forja x args`. Esta versão alinha o que o README promete com o que o binário faz.
374
-
375
- ### Corrigido
376
-
377
- - **README inteiro migrado para `forja` como forma canônica** — os scripts npm continuam
378
- existindo como aliases do repo clonado, mas deixam de ser a vitrine.
379
- - **Exemplos do "60 segundos" estavam quebrados**: `forja gsd:handoff -- plan …` passa o `--`
380
- cru para o script (o core não filtra separador) e o comando falha. O `--` só era necessário
381
- na forma `npm run`; removido dos exemplos diretos.
382
- - **Comando errado na lista de essenciais**: validar projeto do workspace é
383
- `workspace:project:check <nome>`, não `project:check <nome>` (que é o standards check do framework).
384
- - **Links mortos**: `projects/ai-engineering-from-scratch-main/` não existe no repo;
385
- `docs/capacidades-externas.md` agora aponta para as fontes upstream (ADR-0016) e a
386
- reinstalação segue a prescrição do `tools:doctor` (`npm i -g @codegraph/cli`) em vez do
387
- symlink manual antigo.
388
- - **`package-lock.json` preso em 1.1.3** desde o bump da 1.1.4; sincronizado.
389
-
390
- ### Adicionado
391
-
392
- - Seção "Comandos essenciais" do README ampliada com o que já existia no registry mas não
393
- aparecia: `gsd:plan`/`gsd:check`, `code:check`/`code:impact`, `memory:compress`,
394
- `tools:doctor`, `release:check --publish`.
395
- - `allowScripts` no `package.json`: instalações com política allow-scripts ativa deixam de
396
- bloquear silenciosamente o prebuild do `better-sqlite3` — exatamente o modo de falha que
397
- matava a memória (ADR-0023).
398
-
399
- ---
400
-
401
- ## [1.1.4] — 2026-07-14 — Os gates
402
-
403
- Duas fronteiras do framework funcionavam por disciplina, e a disciplina falhou nas duas. Esta versão
404
- as fecha com gates executáveis — e, pela primeira vez, com **prova**: os bugs históricos foram
405
- reintroduzidos um a um, e o gate reprovou cada um deles.
406
-
407
- > "Uma regra que depende de memória não é uma regra; é uma sugestão." — ADR-0021
408
-
409
- ### O que muda para quem usa
410
-
411
- - **`npm publish` está bloqueado** se a instalação limpa não funcionar (`prepublishOnly` → ADR-0024).
412
- - **`tools:doctor` reprova** (exit 1) quando o núcleo está quebrado — antes ele auditava só
413
- ferramentas opcionais e saía com 0 mesmo com a memória morta (ADR-0023).
414
- - Quando algo quebra, a saída traz **o comando que corrige**, não um stack trace.
415
-
416
- ### Adicionado
417
-
418
- - **`lib/core/health.mjs`** — saúde do núcleo como dados: ABI do `better-sqlite3`, memória, índice,
419
- workspace, `engines`, deps de runtime, `.mcp.json`. Fonte única do `tools:doctor` e do hook
420
- `SessionStart` (ADR-0023).
421
- - **`lib/core/release.mjs` + `release:check`** — o gate do tarball. Empacota, instala num diretório
422
- isolado e **executa** os comandos. Grep não prova ausência; instalação prova (ADR-0024).
423
- - **`lib/core/checks.mjs`** — runner compartilhado. Uma máquina, dois catálogos: um guarda o repo,
424
- outro guarda o pacote publicado.
425
- - **CI**: `tools:doctor` na matriz de Nodes e `release:check` em job próprio. A evidência do release
426
- passa a viver no log do CI, não na memória de quem publica.
427
- - `spec:new` mantém a allow-list do `.gitignore` — toda spec nova do framework nascia invisível ao git.
428
-
429
- ### Corrigido
430
-
431
- - **A memória morria em silêncio.** Com o `better-sqlite3` compilado contra outra major do Node,
432
- `query:universal`, `sync:universal`, `context:smart`, `agent:route` e `memory:compress` ficavam
433
- todos inoperantes — e o `SessionStart` prescrevia `npm install`, que **não** recompila binário
434
- nativo. A correção é `npm rebuild better-sqlite3`, e agora é isso que o framework diz.
435
- - **`docs/token-optimization.md` mandava rodar quatro comandos inexistentes** (`context:build`,
436
- `memory:db:reindex`, `memory:db:stats`, `cache:clear`) e linkava um `DEPLOYMENT.md` que nunca
437
- existiu. É o documento que ensina a economia de tokens (ADR-0009) — um agente obediente executava
438
- fantasmas.
439
- - **O Governance não conhecia os gates**: descrevia o `tools:doctor` pela definição anterior ao
440
- ADR-0023 e ignorava o `release:check`.
441
- - `runtime-deps` passava por sorte: os geradores emitem `import … from '@nestjs/common'` dentro de
442
- template literal, e o parser contava como dependência do framework.
443
-
444
- ### Evidência
445
-
446
- | Bug histórico | Reintroduzido → |
447
- |---|---|
448
- | `better-sqlite3` como `devDependency` (ADR-0021) | reprovado por **dois** checks independentes |
449
- | `dashboard/` fora do `files[]` (v1.1.3) | reprovado: 4 comandos mortos, 19 imports sem destino |
450
- | `otplib`/`qrcode` publicados sem existir no git (v1.1.1) | reprovado sob `--publish`; `npm publish` aborta |
451
-
452
- **88 testes** (eram 28). ADR-0023 e ADR-0024. SPEC-009 e SPEC-010.
453
-
454
- ## [1.1.3] — 2026-07-09 — Dashboard congelado
455
-
456
- SPEC-002 (`specs/agent-dashboard/`) passa a `abandoned`. O código permanece em `dashboard/`,
457
- versionado e com os 68 testes verdes, mas deixa de ser superfície pública. Ver
458
- ADR-0022 (`memory/90-decisions/0022-congelar-dashboard-web.md`) para rationale e condições de retomada.
459
-
460
- ### Corrigido
461
- - **Bug de release**: `docs/dashboard.md` e o script `npm run dashboard` eram publicados no npm,
462
- mas a pasta `dashboard/` nunca esteve no `files[]`. Quem instalava o pacote recebia a documentação
463
- e o comando, sem o código. Ambos saíram do tarball.
464
- - `README.md` descrevia o dashboard como "visão opcional read-only"; ele expõe rotas que executam
465
- processos (`POST /api/workflow/:project/run/:role`). Descrição corrigida.
466
- - `scripts/spec-cli.mjs` — `abandoned` é status válido, mas o `check` o rejeitava como incoerente
467
- quando havia `plan.md`/`tasks.md`, derrubando o gate com exit 1. Agora é tratado como terminal,
468
- junto de `done`.
469
-
470
- ### Removido
471
- - Scripts `dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:dev` e
472
- `dashboard:web:build` do `package.json` do root.
473
- - `docs/dashboard.md` e `specs/agent-dashboard/` do `files[]` do pacote npm.
474
-
475
- ## [Unreleased] — Workspace separado
476
-
477
- SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
478
-
479
- - `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
480
- - `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
481
- - `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
482
- - `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
483
- - `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
484
- - Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
485
- - ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
486
- - `.gitignore` reforça que projetos de produto não entram no repo do framework.
487
-
488
- ## [Unreleased] — Dashboard local
489
-
490
- SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
491
-
492
- - `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
493
- - `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
494
- - `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
495
- - Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
496
- - **60 testes verde** (55 dashboard + 5 root)
497
- - `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
498
-
499
- ## [v1.1] — 2026-05-10 — Refator SDD + Orquestração
500
-
501
- ### Frente 1 — Cleanup + ADRs
502
- - 13 relatórios históricos movidos para `docs/archive/`
503
- - 4 guias úteis migrados para `docs/{structure,init-project,examples,publishing}.md`
504
- - 2 exemplos antigos arquivados em `docs/archive/examples/`
505
- - Monolito bin (1486 LOC) preservado em `docs/archive/legacy-bin/`
506
- - `DOC-MAP.md` reescrito (204 → 50 linhas)
507
- - 6 ADRs criados a partir de decisões dispersas (`memory/90-decisions/0001-0006`)
508
-
509
- ### Frente 2 — Bins e exemplos consolidados
510
- - `bin/create-memory-nest-kit-v2.js` promovido a oficial (substituiu monolito)
511
- - `package.json`: bin secundário, novos scripts `spec:*`, `agent:route`, `memory:vacuum`
512
- - `exemplo-v3` mantido como exemplo canônico
513
-
514
- ### Frente 3 — Pipeline SDD
515
- - `specs/_templates/{spec,plan,tasks}.md`
516
- - `scripts/spec-cli.mjs` com `new`/`plan`/`tasks`/`check` (4/4 testes verdes)
517
- - ADR-0007 estabelece SDD como obrigatório para features não-triviais
518
- - SPEC-001 (`specs/pipeline-sdd-e-orquestracao/`) é a meta-spec deste refator
519
-
520
- ### Frente 4 — Sub-agents executáveis
521
- - 6 sub-agents em `.claude/agents/`: orchestrator, context-engineer, sdd-architect, product, marketing, governance
522
- - 3 prompts portáveis novos em `prompts/`
523
- - `scripts/agent-router.mjs` persiste handoffs em `universal.db.handoffs` (7 campos validados)
524
- - ADR-0008 documenta migração handoff markdown → SQLite
525
- - `AGENTS.md` reescrito
526
-
527
- ### Frente 5 — Hooks token-economy
528
- - `.claude/settings.json` com hooks `SessionStart` e `UserPromptSubmit`
529
- - `scripts/hook-session-start.mjs` injeta status de specs + handoffs abertos
530
- - `scripts/hook-user-prompt.mjs` opt-in (`FRAMEWORK_HOOK_INJECT=1`), cache 30min, cap 4KB
531
- - `scripts/pre-commit.sh` agora roda `spec:check` + `check-standards`
532
- - ADR-0009 documenta trade-offs
533
- - `.memoryrc.json` ganha seção `hooks`; `handoff` aponta para SQLite
534
-
535
- ---
536
-
537
- ## [v1.0] — 2026-05-02 — 4 Fases Estruturais
538
-
539
- Detalhes completos em `docs/archive/PROJETO-COMPLETO.md`.
540
-
541
- ### Fase 1 — Arquitetura
542
- - Monolito `bin/create-memory-nest-kit.js` (1486 LOC) refatorado em 5 módulos em `lib/`
543
- - Orquestrador final: 125 LOC (redução de 91%)
544
- - 1.820 LOC reutilizáveis em `lib/generators/`, `lib/validators/`, `lib/utils/`, `lib/context-builder.js`
545
- - 7/7 testes passando; backward compatible
546
-
547
- ### Fase 2 — Documentação por Persona
548
- - `docs/personas/{executive,architect,developer,qa}/` — guias estruturados
549
- - `docs/quick-reference.md`, `docs/glossary.md`, `DOC-MAP.md`
550
- - Onboarding reduzido em ~83% (medido em tempo de leitura)
551
-
552
- ### Fase 3 — Economia de Tokens
553
- - `lib/context-builder.js` — API com 3 modos (`global`, `domain`, `task`), FTS5, cache LRU
554
- - `scripts/compress-memory.mjs` — archive de runs > 30 dias, VACUUM
555
- - `.memoryrc.json` — configuração centralizada
556
- - `docs/token-optimization.md`, `scripts/token-benchmark.mjs`
557
- - Redução estimada: 40-60% em tokens enviados ao modelo
558
-
559
- ### Fase 4 — Dev Workflow
560
- - `scripts/dev.mjs` — CLI unificada (health/build-context/sprint/check)
561
- - `scripts/pre-commit.sh` — validação automática
562
- - `scripts/check-standards.js`, `scripts/generate-dashboard.js`
563
- - 100% das operações cobertas por scripts npm
564
-
565
- ---
566
-
567
- ## [v0.x] — 2026-04 — Bootstrap
568
-
569
- - Estrutura inicial `memory/` hierárquica (00-global a 90-decisions)
570
- - `bin/create-memory-nest-kit.js` — scaffold inicial monolítico
571
- - SQLite universal (`.memory/sqlite/universal.db`) com FTS5
572
- - Scripts `sprint-manager.js`, `sync-universal-memory.js`, `query-universal-memory.js`
573
- - AGENTS.md com topologia de 6 papéis
574
- - `exemplo-projeto/`, `exemplo-v2/`, `exemplo-v3/` — outputs de referência
88
+
89
+ Consolida a evolução do ForjaJS 2.x após a fundação 2.0.1, conectando a CLI,
90
+ Capability Registry, Runtime, MCP, SQLite, GraphLoop e Context Engine em um
91
+ fluxo persistente, auditável e testado.
92
+
93
+ ### Adicionado
94
+ - Adapter da CLI sobre o Capability Registry com `ExecutionResult` estruturado.
95
+ - Persistência SQLite para runtime, aprovações, eventos e GraphLoop.
96
+ - MCP dinâmico derivado das capabilities registradas.
97
+ - Context Engine integrado ao GraphLoop, com cache por checksum e orçamento.
98
+ - Extractors determinísticos e capability `graph.sync` para CLI/MCP.
99
+ - Testes de recuperação, autonomia E2E, contratos e integração.
100
+ - ADRs, auditoria de implementação e handoffs das Sprints 1–11.
101
+
102
+ ## [2.0.1] — 2026-08-01 — Higiene de dependências do pacote
103
+
104
+ Move as dependências de NestJS e dashboard para os manifests das aplicações e
105
+ para `devDependencies` do repositório. O tarball do framework agora carrega
106
+ somente `better-sqlite3` como dependência de runtime, eliminando peso morto sem
107
+ alterar os ambientes oficiais de server e dashboard.
108
+
109
+ ## [2.0.0] — 2026-08-01 — Fundação programável local-first
110
+
111
+ Primeira release da plataforma ForjaJS 2.0. A versão mantém a
112
+ CLI-first e adiciona um núcleo programável por agentes, com contratos
113
+ versionados, capabilities, runtime controlado, políticas, memória, GraphLoop,
114
+ contexto orçamentado, MCP, SDK, adapters oficiais, observabilidade e dashboard.
115
+
116
+ ### Adicionado
117
+ - Monorepo modular com `apps/server`, `apps/dashboard`, `apps/worker` e pacotes
118
+ de domínio/adaptação independentes de framework.
119
+ - Contracts, Capability Registry, Policy Engine, Runtime, Sprint/Task/Handoff,
120
+ Event Bus, Scheduler, Sandbox, Planner, Validator, GraphLoop e Context Engine.
121
+ - MCP, SDK, Plugin SDK, adapters SQLite/Git/NestJS, Control Plane e Evaluation
122
+ Engine.
123
+ - Dashboard Next.js com consultas, GraphLoop, aprovações e ações supervisionadas.
124
+ - Auditoria de segurança, release e migração documentada.
125
+
126
+ ### Validação do candidato
127
+ - TypeScript, builds e 267 testes determinísticos aprovados.
128
+ - `npm audit --offline --omit=dev --audit-level=high`: zero vulnerabilidades.
129
+ - Gitleaks: zero achados após limpeza dos artefatos de build.
130
+ - Release validada após merge da PR #40 e execução do gate de publicação sobre
131
+ o commit/tag limpos.
132
+
133
+ ## [1.7.3] — 2026-07-23 — Doctor: permissão/lock não é corrupção
134
+
135
+ O check `memory-db` (consumido por `tools:doctor` e pelo `SessionStart`) tratava **qualquer** falha
136
+ de abertura do `universal.db` como corrupção e prescrevia `sync:universal`. Num ambiente sem escrita
137
+ (sandbox, FS read-only, diretório protegido) o driver lança `SQLITE_CANTOPEN` — e a prescrição é
138
+ ativamente errada: `sync:universal` *escreve* no banco, reencenaria o mesmo erro sem curar nada, e
139
+ levaria o operador a "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox.
140
+
141
+ ### Corrigido
142
+ - **`memory-db` classifica a falha de abertura por `err.code`** em vez de colapsar tudo em
143
+ "corrompido" (ADR-0033):
144
+ - `SQLITE_CANTOPEN` / `EACCES` → **permissão/sandbox**, não corrupção; o fix orienta garantir
145
+ leitura no path e **desaconselha** `sync:universal`.
146
+ - `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); o fix é aguardar.
147
+ - `SQLITE_CORRUPT` / `SQLITE_NOTADB` / resto → corrupção; fix `npm run sync:universal`.
148
+ O `err.code` já vinha impresso no `detail`, mas não decidia nada — a informação existia, faltava
149
+ ramificar. É a mesma classe do bug de ABI que motivou a SPEC-009, sobrevivendo dentro do arquivo
150
+ escrito para fechá-la.
151
+
152
+ ### Adicionado
153
+ - **ADR-0033** e quatro casos em `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB): a distinção
154
+ vira invariante que roda.
155
+
156
+ ---
157
+
158
+ ## [1.7.2] — 2026-07-22 — Fechando a classe: superfícies do projeto usam `cwd`
159
+
160
+ A auditoria sistemática dos comandos consumer-facing (o passo estrutural após os fixes caso-a-caso
161
+ de `spec:new`/`project:check`) achou **mais três instâncias vivas** da mesma classe — todas escondidas
162
+ num `const root = __dirname/..` que misturava "recurso do framework" com "projeto do usuário". Agora a
163
+ regra é explícita e tem gate (ADR-0032).
164
+
165
+ ### Corrigido
166
+ - **`gsd:plan`/`gsd:handoff`/`gsd:check`** (agent-harness) gravavam o runbook e liam `specs/` dentro
167
+ do pacote no consumidor; o `gsd:check` ainda spawava o `spec:check` com `cwd` do pacote e caminho
168
+ `.mjs` cravado (inexistente no dist). Agora operam em `process.cwd()` e resolvem o script via
169
+ `resolveScript` (`.ts` no dev, `.js` no dist).
170
+ - **`context:budget`/`agent:brief`/`context:sprint`** (context-ops) resolviam `.context/`, `specs/`,
171
+ `memory/` e o `.memoryrc.json` no pacote; o `cmdBudget` ainda validava travessia contra a raiz do
172
+ pacote e rejeitava arquivos do projeto. Agora usam `projectRoot = process.cwd()`; `catalog:*`
173
+ (recurso do framework) segue em `root`.
174
+ - **`design:check`** rejeitava o brief do consumidor ("caminho fora do projeto") por ancorar a
175
+ travessia no pacote — agora ancora no projeto.
176
+
177
+ ### Adicionado
178
+ - **Gate `consumer-project-surfaces`** no `release:check`: executa `gsd:plan` + `context:budget` no
179
+ cwd de um consumidor instalado e prova que o runbook cai em `<cwd>/.context/` e que o budget o lê de
180
+ lá. Testemunha cruzada, independente do banco — reprova a classe inteira antes do publish.
181
+ - **ADR-0032** e `test/consumer-project-surfaces.test.js`: a regra `projectRoot` (cwd) vs `root`
182
+ (framework) como invariante que roda. `sprint-manager` foi auditado e está são (opera pelo workspace).
183
+
184
+ ---
185
+
186
+ ## [1.7.1] — 2026-07-22 — Correção: `project:check` em projetos consumidores
187
+
188
+ ### Corrigido
189
+ - **`forja project:check` num projeto consumidor auditava `node_modules/forjajs/dist/`** em vez do
190
+ projeto (raiz cravada em `__dirname/..`), reportando os arquivos obrigatórios como faltando (score
191
+ 0%) — o que travava o gate `implement` do `orchestrate`. Agora audita `process.cwd()` (propagado
192
+ pelo dispatcher desde a 1.6.2). Mesma classe do `spec-cli` (v1.6.2); o `check-standards` ficou de
193
+ fora. O `check:all` **não** é afetado (agrega health/smoke/release, não `project:check`).
194
+
195
+ ### Adicionado
196
+ - **Gate `consumer-project-check`** no `release:check`: planta um arquivo só no cwd e prova que
197
+ `project:check` audita o projeto do consumidor, não o pacote. Provado com dentes (reprova o bug).
198
+
199
+ ---
200
+
201
+ ## [1.7.0] — 2026-07-22 — O motor de orquestração: o namesake executando
202
+
203
+ O nome do framework sempre foi orquestração multiagente; até aqui, a topologia era coerente
204
+ (SPEC-019) mas o fluxo vivia por disciplina. Esta release o faz **rodar**.
205
+
206
+ ### Adicionado
207
+ - **`orchestrate` / `orchestrate:status` / `orchestrate:advance`** (SPEC-021, ADR-0031): a cadeia
208
+ SDD/GSD (spec→plan→tasks→implement→review) como **máquina de estados guardada por gates**. Cada
209
+ etapa abre com um handoff ADR-0005 para o dono do papel; `advance` só fecha a etapa se o artefato
210
+ SDD estiver aprovado **e** o gate da transição sair verde — pular etapa é bloqueado pela máquina,
211
+ não pela memória. O framework orquestra e guarda; o agente (IA ou humano) executa. Estado em
212
+ `<cwd>/.context/orchestrate-<slug>.json`; roda no framework e em projetos consumidores.
213
+ - `commands-documented` ganha fallback para comandos **sem dois-pontos** (grep literal de nome
214
+ conhecido) — `orchestrate` é o primeiro do registry.
215
+
216
+ ### Corrigido
217
+ - **Backend gerado compila em Node 26**: o template pinava `better-sqlite3 ^11` (sem prebuild para
218
+ Node novo); alinhado ao do framework (`^12`). Fecha o caveat da v1.6.0 — `check:all --full` verde.
219
+ - **Roadmap defasado**: o `release-auditor` já consumia o gate (ADR-0024); refresh da tabela
220
+ (+ `consumer-spec-new`) e checkboxes marcados nos READMEs.
221
+
222
+ ---
223
+
224
+ ## [1.6.2] — 2026-07-21 — Correção: `spec:new` em projetos consumidores
225
+
226
+ ### Corrigido
227
+ - **`forja spec:new` num projeto consumidor escrevia a spec DENTRO de `node_modules/forjajs/dist`**
228
+ e falhava com "template ausente". Duas causas: o dispatcher spawnava os filhos com `cwd` = raiz do
229
+ pacote (agora usa o cwd de quem invocou — uma CLI opera onde é chamada), e o `spec-cli` resolvia
230
+ templates e destino por uma raiz só (agora separa `pkgRoot`, de onde vêm os templates, de
231
+ `targetRoot`, onde as specs nascem). Framework inalterado.
232
+ - Sem `.gitignore` ou sem bloco de allowlist: silêncio em vez de aviso — num consumidor esse é o
233
+ estado saudável (specs versionadas normalmente).
234
+
235
+ ### Adicionado
236
+ - **Gate `consumer-spec-new`** no `release:check`: roda `spec:new` na instalação limpa e reprova se a
237
+ spec não nascer no projeto do consumidor ou vazar para dentro do pacote. O smoke pegava "não
238
+ carrega"; este pega "opera no mundo errado".
239
+
240
+ ---
241
+
242
+ ## [1.6.1] — 2026-07-20 — Correção: `project:upgrade` no pacote publicado
243
+
244
+ ### Corrigido
245
+ - **`project:upgrade` quebrava com `Cannot find module .../create-memory-nest-kit.ts`** no pacote
246
+ instalado. O spawn do gerador cravava a extensão `.ts`; em dev funciona, mas o `dist/` publicado
247
+ tem `.js`. Agora resolve dinamicamente via `resolveScript` (`.ts` em dev, `.js` no publicado). O
248
+ `project:smoke` tinha o mesmo defeito, também corrigido. Teste de regressão guarda a classe.
249
+
250
+ ---
251
+
252
+ ## [1.6.0] — 2026-07-20 — A orquestração coerente e a governança num comando
253
+
254
+ A governança do framework ganha um ponto de entrada e o namesake — orquestração multiagente — deixa
255
+ de viver por prosa.
256
+
257
+ ### Adicionado
258
+ - **`check:all`** (SPEC-020): roda a **bateria inteira de gates** e dá um veredito só. Tier barato:
259
+ coerência (`tools:doctor`) + `project:smoke`; `--full`: + tarball (`release:check`) + build do
260
+ gerado. Compõe os runners existentes — zero check reimplementado. "A casa está coerente?" num
261
+ comando, não num checklist lembrado.
262
+ - **`agent-topology`** (check no `tools:doctor`, SPEC-019): a topologia de orquestração é descrita em
263
+ três fontes (`VALID_AGENTS`, `.claude/agents/*.md`, `AGENTS.md`) e pode divergir em silêncio. O
264
+ check as cruza e reprova quando não concordam. Pegou o `release-auditor` (sub-agent executável sem
265
+ rota) na 1ª execução — agora first-class no router e documentado (AGENTS.md §7).
266
+
267
+ ### Corrigido / interno
268
+ - **`generators.test` migrado para `node:test`**: o harness custom legado não contava suas falhas no
269
+ tally do CI e vazava um `/tmp` por execução (588 diretórios acumulados). Agora é `node:test` com
270
+ cleanup — falha derruba o CI de verdade.
271
+
272
+ ---
273
+
274
+ ## [1.5.0] — 2026-07-19 — A memória como sistema fechado: medir → entregar → proteger → propagar
275
+
276
+ A economia de token do Forja sempre foi a memória persistente (ADR-0009), mas era uma promessa. Esta
277
+ release a torna um ciclo completo e verificável — cada peça fecha um elo.
278
+
279
+ ### Adicionado
280
+ - **`code:context <domínio>`** (SPEC-016): **entrega** o mapa da memória como pacote pronto para
281
+ colar (o `context.md`), com `--code` para o código da fatia e o custo em token à mostra. É o −61%
282
+ medido no `token:economy` virado ferramenta. Compõe com `code:impact` para o blast radius.
283
+ - **`memory:audit`** (SPEC-017): **protege** o mapa nas duas direções — reprova se um `context.md`
284
+ cita código que não existe (mapa que mente é pior que mapa nenhum) e avisa sobre módulo de código
285
+ sem mapa (economia perdida em silêncio). O `adr-refs` aplicado aos mapas de memória.
286
+ - **`token:economy --project <path>`**: mede o eixo memória nos **domínios reais do usuário** (mapa
287
+ vs código, por domínio) — o número fica dele, não da fixture.
288
+ - **`project:upgrade`** (SPEC-018): a metade que faltava do scaffolder. Traz peças novas de scaffold
289
+ para um projeto já gerado — **aditivo, nunca sobrescreve** (o código do usuário é intocável).
290
+ Dry-run por padrão; `--apply` copia.
291
+ - **O projeto gerado herda o gate** (ADR-0030): o gerador emite `scripts/check-memory-maps.mjs`, um
292
+ `memory:audit` self-contained (Node puro, zero dep), e o `project:smoke` prova a propagação. O
293
+ invariante da coerência mapa↔código passa a viajar com cada projeto.
294
+
295
+ ### Nota
296
+ - Comandos e gates novos do framework; nada muda para projetos já gerados até rodarem `project:upgrade`.
297
+
298
+ ---
299
+
300
+ ## [1.4.0] — 2026-07-19 — Governança que mede: gate do gerador, economia de token e integridade de ADR
301
+
302
+ Três fronteiras que viviam por disciplina viram harness — e cada uma provou seu valor pegando um
303
+ problema real na estreia.
304
+
305
+ ### Adicionado
306
+ - **`project:smoke`** (SPEC-015, ADR-0029): o gate do projeto gerado. Gera um projeto num tmp isolado
307
+ e prova que é coerente — zero placeholder `{{...}}` vazado, `package.json` válido, estrutura íntegra
308
+ (reusa o `structure-validator`). Tier `--full` (opt-in): `npm install` + `npm run build` do backend
309
+ gerado. É o `release:check` da saída do gerador, um nível acima do tarball.
310
+ - **`token:economy`** (fecha a dívida do ADR-0027; mede ADR-0009): mede a economia de token em dois
311
+ eixos, com file-sets explícitos. **Eixo arquitetura** (clean vs flat, mesma feature): camadas
312
+ custam **+56%** numa feature pequena — a versão ingênua de "Clean Architecture economiza tokens"
313
+ não se sustenta. **Eixo memória** (frio vs quente): o `context.md` (mapa) faz o contexto mínimo
314
+ custar **−61%** vs varrer a fatia no frio — e isso **compõe** a cada tarefa. A economia do Forja é
315
+ da memória persistente, amortizada no tempo, não das camadas. Narrativa corrigida no
316
+ `WHEN-CLEAN-WHEN-LEAN.md` e no ADR-0027.
317
+ - **`adr-refs`** (check no `tools:doctor`, ADR-0025): toda citação `ADR-NNNN` aponta para um ADR que
318
+ existe. Na 1ª execução pegou o `ADR-0026` pendurado (citado pela SPEC-012, nunca escrito) — fechado
319
+ escrevendo o **ADR-0026** (arquitetura da migração TS: resolver, runtime duplo, gate-builda-dist).
320
+
321
+ ### Nota
322
+ - Nada muda para quem já tem projetos gerados; são comandos e gates novos do framework.
323
+
324
+ ---
325
+
326
+ ## [1.3.2] — 2026-07-19 — Migração TypeScript concluída (interno)
327
+
328
+ **Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.1. Fecha a SPEC-012.
329
+
330
+ ### Alterado (interno)
331
+ - **Fonte 100% TypeScript**: os 16 `.js` restantes (entries públicos `init-project`/
332
+ `create-memory-nest-kit`, generators, validators, `context-builder`, scaffolding) viraram `.ts`.
333
+ - **`noImplicitAny: true`** — o ratchet está armado: daqui pra frente todo parâmetro novo precisa de
334
+ tipo explícito. Os ~285 params existentes foram anotados (tipo real onde agrega, `any` explícito
335
+ onde o valor é dinâmico). Os checks de `health`/`release` viram `Check[]` de verdade.
336
+ - Shim `lib/vendor.d.ts` para o `better-sqlite3` (sem tipos publicados); `lib/templates` fora do
337
+ type-check (é conteúdo copiado, não código do framework).
338
+ - Correção pega pelo `release:check`: um sed havia corrompido o array de fallback do `resolveScript`
339
+ (`['.ts','.js','.mjs']`→`['.ts','.ts','.ts']`), quebrando a resolução do `dist/*.js`.
340
+
341
+ ---
342
+
343
+ ## [1.3.1] — 2026-07-19 — Migração TypeScript dos módulos do framework (interno)
344
+
345
+ **Sem mudança para quem instala** — o `dist/*.js` publicado é idêntico ao da 1.3.0. A conversão é
346
+ interna: fecha a renomeação leaf-first da SPEC-012 Fase 2.
347
+
348
+ ### Alterado (interno)
349
+ - **Todos os 21 módulos `.mjs` do framework** (`bin/forja`, `lib/{audit,governance-report,workspace}`,
350
+ todos os `scripts/` incluindo os 4 hooks) convertidos para `.ts`, com ~130 anotações de tipo. Os
351
+ typedefs JSDoc viraram `interface`; os casts-comentário `/** @type */ (x)` viraram `as`.
352
+ - Dev e CI rodam a fonte `.ts` (Node ≥22.6); o `ci.yml` invoca `bin/forja.ts`. O publicado segue
353
+ `dist/*.js` (Node ≥20), provado pelo `release-gate`.
354
+ - **Fora desta fatia** (deliberado): os 16 `.js` (entries públicos + generators + scaffolding), que
355
+ seguem no checkJs, e `noImplicitAny: true` (endurecimento final).
356
+
357
+ ---
358
+
359
+ ## [1.3.0] — 2026-07-19 — Governança visível e o núcleo em TypeScript
360
+
361
+ Duas frentes que amadurecem o framework: a governança sai do arquivo que ninguém abre para
362
+ **consultável e visível**, e o motor de invariantes (`lib/core/`) passa a ser **TypeScript de
363
+ verdade**, com o pacote publicando `dist/` compilado.
364
+
365
+ ### Adicionado
366
+ - **Auditoria consultável + painel de governança** (SPEC-014, ADR-0028): `audit:sync` projeta o
367
+ `.context/forja-runs.jsonl` na tabela `audit_runs` (idempotente por `line_hash` — o `.jsonl` segue
368
+ sendo a fonte de verdade); `audit:query` filtra a trilha por `--failed`/`--cmd`/`--since`/`--gate`;
369
+ `governance:dashboard` gera um HTML **estático e self-contained** (sem servidor — a lição do
370
+ ADR-0022) com o estado de specs, ADRs, gates e métricas.
371
+ - **`lib/core/` em TypeScript** (SPEC-012 Fase 2, leaf-first): `checks`, `health`, `release`,
372
+ `doc-graph` e `registry` viram `.ts` com `interface Check/Probe/Result` reais. Dev roda `.ts`
373
+ nativo (Node ≥22.6); o publicado embarca `dist/*.js` (Node ≥20).
374
+
375
+ ### Alterado
376
+ - **O pacote publica `dist/` compilado** (SPEC-012 Fase 3): `bin`/`files[]` apontam para `dist/`. O
377
+ `release:check` **builda o `dist/` antes de empacotar**, então o tarball provado é exatamente o
378
+ publicado — sem step de build no CI, sem `dist/` no git, sem janela de staleness.
379
+ - **CI**: o job `test` roda em Node 22.x/24.x (a fonte `.ts` exige strip-types ≥22.6). O suporte a
380
+ Node 20 do pacote publicado (que é `dist/*.js`) segue provado pelo job `release-gate`.
381
+
382
+ ---
383
+
384
+ ## [1.2.0] — 2026-07-18 — Boilerplate Clean Architecture, coerência de doc e correções
385
+
386
+ Feature nova (um boilerplate), o terceiro gate de invariante (coerência da documentação), e
387
+ **correções de dois bugs vivos na 1.1.6** que o TypeScript achou. A migração TS avançou até o
388
+ pipeline de build provado — mas continua publicando a fonte `.mjs` (a troca para `dist/` é interna
389
+ e fica para uma release futura).
390
+
391
+ ### Corrigido
392
+ - **`npm run dev` estava quebrado** na 1.1.6: `scripts/dev.mjs` chamava `spawn()` sem importar —
393
+ `ReferenceError` em três caminhos (agent-harness, compress-memory, create-memory-nest-kit).
394
+ - **`context:budget` / `catalog:assets` estavam quebrados** na 1.1.6: `scripts/context-ops.mjs`
395
+ importava `dbPath` (inexistente; só há `getDbPath`) e o usava em `new Database(dbPath)`.
396
+ - Typedefs `Check`/`Result` duplicados e divergentes em `health.mjs` (resíduo da extração do runner).
397
+ - 22 links relativos quebrados em docs legadas (personas, quick-reference, structure).
398
+
399
+ ### Adicionado
400
+ - **Boilerplate `06-clean-arch`** (SPEC-013, ADR-0027): DDD por camadas onde se paga, caminho enxuto
401
+ onde não. Fatia rica (Orders) com inversão de dependência e invariante testável sem subir o Nest;
402
+ caminho enxuto (Products) lado a lado; `WHEN-CLEAN-WHEN-LEAN.md` com o critério; memória por
403
+ bounded context. A economia de token é reportada com honestidade (argumentada, não provada — o
404
+ benchmark é follow-up).
405
+ - **Gate de coerência da documentação** (SPEC-011, ADR-0025): `lib/core/doc-graph.mjs` + três checks
406
+ no `health.mjs` — `docs-commands` (critical: todo `forja <cmd>` citado existe no registry),
407
+ `commands-documented` e `docs-links` (warn). Rodam no `tools:doctor` e no CI.
408
+ - **Resolver de script agnóstico de extensão** (SPEC-012): `resolveScript` desacopla o registry da
409
+ extensão (`.ts → .js → .mjs`), preparando a migração TS. Backward-compatible.
410
+
411
+ ### Interno
412
+ - **TypeScript como gate** (SPEC-012, Fases 0-1): `checkJs` estrito sobre a fonte `.mjs`,
413
+ `types:check` no CI, contratos do núcleo (`Check`/`Probe`/`Result`) tipados. Pipeline de build
414
+ (`tsc → dist`) provado; a publicação de `dist/` e a renomeação `.mjs → .ts` ficam para depois.
415
+
416
+ ### Nota
417
+ - O `docs-links` pegou o **próprio autor**: um erro de profundidade relativa (`../../` vs `../../../`)
418
+ na correção dos links foi detectado pelo doctor antes do commit. E o `release:check` pegou o
419
+ acoplamento do dist-publish (código em `dist/scripts`, não `scripts/`) antes de qualquer publish.
420
+
421
+ ## [1.1.6] — 2026-07-14 — README em inglês
422
+
423
+ A vitrine do pacote passa a ter versão em inglês, para alcançar quem chega pelo npm.
424
+
425
+ ### Adicionado
426
+ - `README.en.md` — adaptação fiel do README em português, no estilo canônico `forja <comando>`.
427
+ Seletor de idioma no topo dos dois arquivos. Incluído no `files[]` do pacote.
428
+
429
+ ### Nota
430
+ - A **documentação** (`docs/`) permanece em pt-BR — é parte da identidade do projeto. Só a capa
431
+ ganhou inglês. O README inglês foi verificado contra o registry: zero comandos inexistentes,
432
+ zero links quebrados.
433
+
434
+ ## [1.1.5] — 2026-07-14 — O comando é forja
435
+
436
+ A documentação pública ainda falava a língua interna do repo: `npm run x -- args` onde o usuário
437
+ do pacote tem `forja x args`. Esta versão alinha o que o README promete com o que o binário faz.
438
+
439
+ ### Corrigido
440
+
441
+ - **README inteiro migrado para `forja` como forma canônica** — os scripts npm continuam
442
+ existindo como aliases do repo clonado, mas deixam de ser a vitrine.
443
+ - **Exemplos do "60 segundos" estavam quebrados**: `forja gsd:handoff -- plan …` passa o `--`
444
+ cru para o script (o core não filtra separador) e o comando falha. O `--` só era necessário
445
+ na forma `npm run`; removido dos exemplos diretos.
446
+ - **Comando errado na lista de essenciais**: validar projeto do workspace é
447
+ `workspace:project:check <nome>`, não `project:check <nome>` (que é o standards check do framework).
448
+ - **Links mortos**: `projects/ai-engineering-from-scratch-main/` não existe no repo;
449
+ `docs/capacidades-externas.md` agora aponta para as fontes upstream (ADR-0016) e a
450
+ reinstalação segue a prescrição do `tools:doctor` (`npm i -g @codegraph/cli`) em vez do
451
+ symlink manual antigo.
452
+ - **`package-lock.json` preso em 1.1.3** desde o bump da 1.1.4; sincronizado.
453
+
454
+ ### Adicionado
455
+
456
+ - Seção "Comandos essenciais" do README ampliada com o que já existia no registry mas não
457
+ aparecia: `gsd:plan`/`gsd:check`, `code:check`/`code:impact`, `memory:compress`,
458
+ `tools:doctor`, `release:check --publish`.
459
+ - `allowScripts` no `package.json`: instalações com política allow-scripts ativa deixam de
460
+ bloquear silenciosamente o prebuild do `better-sqlite3` — exatamente o modo de falha que
461
+ matava a memória (ADR-0023).
462
+
463
+ ---
464
+
465
+ ## [1.1.4] — 2026-07-14 — Os gates
466
+
467
+ Duas fronteiras do framework funcionavam por disciplina, e a disciplina falhou nas duas. Esta versão
468
+ as fecha com gates executáveis — e, pela primeira vez, com **prova**: os bugs históricos foram
469
+ reintroduzidos um a um, e o gate reprovou cada um deles.
470
+
471
+ > "Uma regra que depende de memória não é uma regra; é uma sugestão." — ADR-0021
472
+
473
+ ### O que muda para quem usa
474
+
475
+ - **`npm publish` está bloqueado** se a instalação limpa não funcionar (`prepublishOnly` → ADR-0024).
476
+ - **`tools:doctor` reprova** (exit 1) quando o núcleo está quebrado — antes ele auditava só
477
+ ferramentas opcionais e saía com 0 mesmo com a memória morta (ADR-0023).
478
+ - Quando algo quebra, a saída traz **o comando que corrige**, não um stack trace.
479
+
480
+ ### Adicionado
481
+
482
+ - **`lib/core/health.mjs`** — saúde do núcleo como dados: ABI do `better-sqlite3`, memória, índice,
483
+ workspace, `engines`, deps de runtime, `.mcp.json`. Fonte única do `tools:doctor` e do hook
484
+ `SessionStart` (ADR-0023).
485
+ - **`lib/core/release.mjs` + `release:check`** — o gate do tarball. Empacota, instala num diretório
486
+ isolado e **executa** os comandos. Grep não prova ausência; instalação prova (ADR-0024).
487
+ - **`lib/core/checks.mjs`** — runner compartilhado. Uma máquina, dois catálogos: um guarda o repo,
488
+ outro guarda o pacote publicado.
489
+ - **CI**: `tools:doctor` na matriz de Nodes e `release:check` em job próprio. A evidência do release
490
+ passa a viver no log do CI, não na memória de quem publica.
491
+ - `spec:new` mantém a allow-list do `.gitignore` — toda spec nova do framework nascia invisível ao git.
492
+
493
+ ### Corrigido
494
+
495
+ - **A memória morria em silêncio.** Com o `better-sqlite3` compilado contra outra major do Node,
496
+ `query:universal`, `sync:universal`, `context:smart`, `agent:route` e `memory:compress` ficavam
497
+ todos inoperantes — e o `SessionStart` prescrevia `npm install`, que **não** recompila binário
498
+ nativo. A correção é `npm rebuild better-sqlite3`, e agora é isso que o framework diz.
499
+ - **`docs/token-optimization.md` mandava rodar quatro comandos inexistentes** (`context:build`,
500
+ `memory:db:reindex`, `memory:db:stats`, `cache:clear`) e linkava um `DEPLOYMENT.md` que nunca
501
+ existiu. É o documento que ensina a economia de tokens (ADR-0009) — um agente obediente executava
502
+ fantasmas.
503
+ - **O Governance não conhecia os gates**: descrevia o `tools:doctor` pela definição anterior ao
504
+ ADR-0023 e ignorava o `release:check`.
505
+ - `runtime-deps` passava por sorte: os geradores emitem `import … from '@nestjs/common'` dentro de
506
+ template literal, e o parser contava como dependência do framework.
507
+
508
+ ### Evidência
509
+
510
+ | Bug histórico | Reintroduzido → |
511
+ |---|---|
512
+ | `better-sqlite3` como `devDependency` (ADR-0021) | reprovado por **dois** checks independentes |
513
+ | `dashboard/` fora do `files[]` (v1.1.3) | reprovado: 4 comandos mortos, 19 imports sem destino |
514
+ | `otplib`/`qrcode` publicados sem existir no git (v1.1.1) | reprovado sob `--publish`; `npm publish` aborta |
515
+
516
+ **88 testes** (eram 28). ADR-0023 e ADR-0024. SPEC-009 e SPEC-010.
517
+
518
+ ## [1.1.3] — 2026-07-09 — Dashboard congelado
519
+
520
+ SPEC-002 (`specs/agent-dashboard/`) passa a `abandoned`. O código permanece em `dashboard/`,
521
+ versionado e com os 68 testes verdes, mas deixa de ser superfície pública. Ver
522
+ ADR-0022 (`memory/90-decisions/0022-congelar-dashboard-web.md`) para rationale e condições de retomada.
523
+
524
+ ### Corrigido
525
+ - **Bug de release**: `docs/dashboard.md` e o script `npm run dashboard` eram publicados no npm,
526
+ mas a pasta `dashboard/` nunca esteve no `files[]`. Quem instalava o pacote recebia a documentação
527
+ e o comando, sem o código. Ambos saíram do tarball.
528
+ - `README.md` descrevia o dashboard como "visão opcional read-only"; ele expõe rotas que executam
529
+ processos (`POST /api/workflow/:project/run/:role`). Descrição corrigida.
530
+ - `scripts/spec-cli.mjs` — `abandoned` é status válido, mas o `check` o rejeitava como incoerente
531
+ quando havia `plan.md`/`tasks.md`, derrubando o gate com exit 1. Agora é tratado como terminal,
532
+ junto de `done`.
533
+
534
+ ### Removido
535
+ - Scripts `dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:dev` e
536
+ `dashboard:web:build` do `package.json` do root.
537
+ - `docs/dashboard.md` e `specs/agent-dashboard/` do `files[]` do pacote npm.
538
+
539
+ ## [Unreleased] — Workspace separado
540
+
541
+ SPEC-028 (`specs/reestruturacao-forja-v2/`): separação do framework Forja do workspace de produção.
542
+
543
+ - `lib/workspace.mjs` — resolução centralizada do workspace (`FORJA_WORKSPACE` > `~/.forjarc.json` > `~/forja-workspace`).
544
+ - `bin/init-project.js` — projetos de produto obrigatoriamente em `~/forja-workspace/projects/<nome>`.
545
+ - `scripts/sync-universal-memory.js`, `query-universal-memory.js`, `build-smart-context.js`, `memory-schema.mjs` — memória universal (SQLite) movida para o workspace.
546
+ - `scripts/check-standards.js` — `npm run project:check <nome>` resolve projeto no workspace.
547
+ - `scripts/agent-harness.mjs` + `package.json` — comandos `workspace:init`, `project:new`, `project:list`, `workspace:project:check`.
548
+ - Documentação atualizada: `README.md`, `AGENTS.md`, `docs/init-project.md`, `docs/structure.md`.
549
+ - ADR-0019 (`memory/90-decisions/0019-workspace-separado.md`) documenta a decisão.
550
+ - `.gitignore` reforça que projetos de produto não entram no repo do framework.
551
+
552
+ ## [Unreleased] — Dashboard local
553
+
554
+ SPEC-002 (`specs/agent-dashboard/`) implementada em 12 tasks (T1-T12).
555
+
556
+ - `dashboard/server/` — Fastify 5 com 7 rotas (specs, handoffs, projects, tokens, commands SSE, briefing, health)
557
+ - `dashboard/web/` — Vite + React + Tailwind + Recharts; 6 telas; bundle 166KB gzip (NFR < 500KB ✓)
558
+ - `dashboard/server/lib/` — allowlist hard-coded, run-command, spec-parser, briefing-parser, token-estimator
559
+ - Scripts: `npm run dashboard`, `dashboard:dev`, `dashboard:install`, `dashboard:web:build`
560
+ - **60 testes verde** (55 dashboard + 5 root)
561
+ - `docs/dashboard.md` cobre uso, allowlist, troubleshooting, segurança
562
+
563
+ ## [v1.1] — 2026-05-10 — Refator SDD + Orquestração
564
+
565
+ ### Frente 1 — Cleanup + ADRs
566
+ - 13 relatórios históricos movidos para `docs/archive/`
567
+ - 4 guias úteis migrados para `docs/{structure,init-project,examples,publishing}.md`
568
+ - 2 exemplos antigos arquivados em `docs/archive/examples/`
569
+ - Monolito bin (1486 LOC) preservado em `docs/archive/legacy-bin/`
570
+ - `DOC-MAP.md` reescrito (204 → 50 linhas)
571
+ - 6 ADRs criados a partir de decisões dispersas (`memory/90-decisions/0001-0006`)
572
+
573
+ ### Frente 2 — Bins e exemplos consolidados
574
+ - `bin/create-memory-nest-kit-v2.js` promovido a oficial (substituiu monolito)
575
+ - `package.json`: bin secundário, novos scripts `spec:*`, `agent:route`, `memory:vacuum`
576
+ - `exemplo-v3` mantido como exemplo canônico
577
+
578
+ ### Frente 3 — Pipeline SDD
579
+ - `specs/_templates/{spec,plan,tasks}.md`
580
+ - `scripts/spec-cli.mjs` com `new`/`plan`/`tasks`/`check` (4/4 testes verdes)
581
+ - ADR-0007 estabelece SDD como obrigatório para features não-triviais
582
+ - SPEC-001 (`specs/pipeline-sdd-e-orquestracao/`) é a meta-spec deste refator
583
+
584
+ ### Frente 4 — Sub-agents executáveis
585
+ - 6 sub-agents em `.claude/agents/`: orchestrator, context-engineer, sdd-architect, product, marketing, governance
586
+ - 3 prompts portáveis novos em `prompts/`
587
+ - `scripts/agent-router.mjs` persiste handoffs em `universal.db.handoffs` (7 campos validados)
588
+ - ADR-0008 documenta migração handoff markdown → SQLite
589
+ - `AGENTS.md` reescrito
590
+
591
+ ### Frente 5 — Hooks token-economy
592
+ - `.claude/settings.json` com hooks `SessionStart` e `UserPromptSubmit`
593
+ - `scripts/hook-session-start.mjs` injeta status de specs + handoffs abertos
594
+ - `scripts/hook-user-prompt.mjs` opt-in (`FRAMEWORK_HOOK_INJECT=1`), cache 30min, cap 4KB
595
+ - `scripts/pre-commit.sh` agora roda `spec:check` + `check-standards`
596
+ - ADR-0009 documenta trade-offs
597
+ - `.memoryrc.json` ganha seção `hooks`; `handoff` aponta para SQLite
598
+
599
+ ---
600
+
601
+ ## [v1.0] — 2026-05-02 — 4 Fases Estruturais
602
+
603
+ Detalhes completos em `docs/archive/PROJETO-COMPLETO.md`.
604
+
605
+ ### Fase 1 — Arquitetura
606
+ - Monolito `bin/create-memory-nest-kit.js` (1486 LOC) refatorado em 5 módulos em `lib/`
607
+ - Orquestrador final: 125 LOC (redução de 91%)
608
+ - 1.820 LOC reutilizáveis em `lib/generators/`, `lib/validators/`, `lib/utils/`, `lib/context-builder.js`
609
+ - 7/7 testes passando; backward compatible
610
+
611
+ ### Fase 2 — Documentação por Persona
612
+ - `docs/personas/{executive,architect,developer,qa}/` — guias estruturados
613
+ - `docs/quick-reference.md`, `docs/glossary.md`, `DOC-MAP.md`
614
+ - Onboarding reduzido em ~83% (medido em tempo de leitura)
615
+
616
+ ### Fase 3 — Economia de Tokens
617
+ - `lib/context-builder.js` — API com 3 modos (`global`, `domain`, `task`), FTS5, cache LRU
618
+ - `scripts/compress-memory.mjs` — archive de runs > 30 dias, VACUUM
619
+ - `.memoryrc.json` — configuração centralizada
620
+ - `docs/token-optimization.md`, `scripts/token-benchmark.mjs`
621
+ - Redução estimada: 40-60% em tokens enviados ao modelo
622
+
623
+ ### Fase 4 — Dev Workflow
624
+ - `scripts/dev.mjs` — CLI unificada (health/build-context/sprint/check)
625
+ - `scripts/pre-commit.sh` — validação automática
626
+ - `scripts/check-standards.js`, `scripts/generate-dashboard.js`
627
+ - 100% das operações cobertas por scripts npm
628
+
629
+ ---
630
+
631
+ ## [v0.x] — 2026-04 — Bootstrap
632
+
633
+ - Estrutura inicial `memory/` hierárquica (00-global a 90-decisions)
634
+ - `bin/create-memory-nest-kit.js` — scaffold inicial monolítico
635
+ - SQLite universal (`.memory/sqlite/universal.db`) com FTS5
636
+ - Scripts `sprint-manager.js`, `sync-universal-memory.js`, `query-universal-memory.js`
637
+ - AGENTS.md com topologia de 6 papéis
638
+ - `exemplo-projeto/`, `exemplo-v2/`, `exemplo-v3/` — outputs de referência