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