forjajs 2.0.2 → 2.0.4

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