forjajs 2.0.3 → 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 (701) 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 -339
  21. package/README.pt-BR.md +345 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,172 +1,172 @@
1
- # Tasks: doctor-do-nucleo
2
-
3
- - **Spec**: ./spec.md
4
- - **Plan**: ./plan.md
5
- - **Status**: done
6
- - **Criado em**: 2026-07-13
7
-
8
- > Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
9
-
10
- Convenção de IDs: `T1`, `T2`, … A sequência reflete a **ordem de merge do plano §7**: a lib e os
11
- testes primeiro (nada a consome ainda), depois as superfícies, e o hook por último — é o de maior
12
- risco e o único que roda em toda sessão.
13
-
14
- ---
15
-
16
- ## T1 — Runner e contrato de `lib/core/health.mjs`
17
- - **Owner**: Worker
18
- - **Estimativa**: M
19
- - **Depende de**: —
20
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
21
- - **Escopo**: o esqueleto sem nenhum probe real — `CHECKS[]` vazio ou com um probe de fixture.
22
- - **Done quando**:
23
- - [x] `runChecks({ scope, env })` e `worstStatus(results)` exportados conforme plano §4 (AC-1)
24
- - [x] Cascata: check com `dependsOn` que falhou é reportado `skipped`, nunca `fail`
25
- - [x] Runner blinda o probe: probe que **lança** vira `fail` com o erro no `detail`, e o runner
26
- continua os demais — nunca propaga exceção (NFR de resiliência)
27
- - [x] `worstStatus` só devolve `fail` para `critical`; `warn` nunca escala
28
- - [x] `env` injetável (`{ root, importModule, fs, workspace }`) com default real (D5)
29
- - [x] `test/health.test.js` cobre cascata, blindagem e `worstStatus` com probes de fixture
30
- - [x] Zero dependências novas (plano §6)
31
-
32
- ## T2 — Probes de memória: `native-abi`, `memory-db`, `memory-fresh`
33
- - **Owner**: Worker
34
- - **Estimativa**: M
35
- - **Depende de**: T1
36
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
37
- - **Escopo**: os três checks que teriam pego a quebra de hoje. É o núcleo do núcleo.
38
- - **Done quando**:
39
- - [x] `native-abi` (critical) classifica por `err.code`, **não** por string de mensagem (risco da
40
- spec): `ERR_DLOPEN_FAILED` → `npm rebuild better-sqlite3`; `ERR_MODULE_NOT_FOUND` →
41
- `npm install` (AC-3)
42
- - [x] `memory-db` (critical, `dependsOn: native-abi`) distingue **ausente** de **inacessível**,
43
- cada um com sua correção (AC-4)
44
- - [x] `memory-fresh` (**warn**, `dependsOn: memory-db`): `memory/` alterado depois do último sync
45
- → `npm run sync:universal`. Reaproveita a lógica de `newestMemoryMtime` que hoje vive no
46
- hook (AC-4)
47
- - [x] Teste do ABI quebrado injeta `env.importModule` que lança `ERR_DLOPEN_FAILED` — sem mock de
48
- módulo, sem corromper `node_modules` (D5)
49
- - [x] Cada probe testado nos dois estados: são e quebrado (AC-9)
50
-
51
- ## T3 — Probes de ambiente: `workspace`, `node-engines`
52
- - **Owner**: Worker
53
- - **Estimativa**: P
54
- - **Depende de**: T1
55
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
56
- - **Done quando**:
57
- - [x] `workspace` (**warn**, D4) usa `getWorkspaceInfo()` de `lib/workspace.mjs`; se não resolve
58
- para diretório existente → `npm run workspace:init`. Reporta também a **origem** da
59
- resolução (`FORJA_WORKSPACE` / `~/.forjarc.json` / default), que é metade do diagnóstico
60
- quando o workspace certo existe mas não é o que está sendo usado (AC-5)
61
- - [x] `node-engines` (**warn**) compara `process.versions.node` com `engines.node` do
62
- `package.json`
63
- - [x] Ambos testados nos dois estados via `env.fs` / `env.workspace` injetados
64
-
65
- ## T4 — Probes de regressão do repo: `runtime-deps`, `mcp-json`
66
- - **Owner**: Worker
67
- - **Estimativa**: M
68
- - **Depende de**: T1
69
- - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
70
- - **Escopo**: converte em gate executável os dois invariantes que o ADR-0021 corrigiu à mão e que
71
- hoje podem reincidir sem que nada perceba.
72
- - **Done quando**:
73
- - [x] Ambos com `scope: 'repo'` — **não** rodam fora do repo do framework, onde produziriam falso
74
- positivo crítico na máquina do usuário final (D3). Detecção: `.git` + `package.json` com
75
- `name: forjajs`
76
- - [x] `runtime-deps` (critical): todo módulo importado **estaticamente** por script sob `files[]`
77
- está em `dependencies`, não em `devDependencies` (AC-6). Parser **conservador**: import
78
- dinâmico ou não resolvido → `warn`, nunca `fail` (risco da spec)
79
- - [x] `mcp-json` (critical): nenhum path absoluto versionado em `.mcp.json` (AC-7)
80
- - [x] Teste com fixture de `package.json`/`.mcp.json` quebrados, via `env.fs` e `env.root`
81
- - [x] Teste garantindo que ambos são `skipped` quando `scope: 'runtime'`
82
-
83
- ## T5 — `tools:doctor` consome a lib e vira gate
84
- - **Owner**: Worker
85
- - **Estimativa**: M
86
- - **Depende de**: T2, T3, T4
87
- - **Paths**: `scripts/tools-doctor.mjs`
88
- - **Done quando**:
89
- - [x] Duas seções na saída: **Núcleo** e **Ferramentas** (AC-2)
90
- - [x] `exit 1` **se e somente se** algum check `critical` do núcleo falhar. Ferramenta opcional
91
- ausente segue `exit 0` — contrato do ADR-0018 preservado (AC-2, D4)
92
- - [x] `TOOLS[]` das cinco ferramentas opcionais permanece intocado (spec §5, fora de escopo)
93
- - [x] Cada falha imprime o comando de correção ao lado
94
- - [x] Roda em < 2s (NFR)
95
- - [x] Funciona **sem `node_modules`** — é justamente aí que ele mais importa (NFR)
96
-
97
- ## T6 — `SessionStart` consome a lib e perde a heurística própria
98
- - **Owner**: Worker
99
- - **Estimativa**: M
100
- - **Depende de**: T2, T3
101
- - **Paths**: `scripts/hook-session-start.mjs`
102
- - **Escopo**: a task de maior risco. O hook roda em toda sessão e o ADR-0021 o marcou como "nunca
103
- pode derrubar a sessão".
104
- - **Done quando**:
105
- - [x] `resolveDbPath()` e `staleIndex()` **deixam de existir** — o `catch { return null }` que
106
- colapsa três causas distintas é a raiz do problema (plano §1)
107
- - [x] A prescrição errada (`npm install` para ABI quebrado, linha 91) não existe mais no código
108
- (AC-8)
109
- - [x] Chama `runChecks({ scope: 'runtime' })` — zero heurística própria (AC-8)
110
- - [x] **Sempre `exit 0`**: o hook reporta, nunca trava a sessão (ADR-0021)
111
- - [x] Cabe com folga no timeout de 5s; se não couber, ver kill criteria do plano §8
112
- - [x] `test/hooks.test.js` estendido: sem `node_modules` o hook degrada, não estoura
113
-
114
- ## T7 — ADR-0023
115
- - **Owner**: SDD Architect
116
- - **Estimativa**: P
117
- - **Depende de**: T5, T6
118
- - **Paths**: `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`
119
- - **Done quando**:
120
- - [x] Registra D1 (checks como dados), D3 (`scope` repo/runtime) e a mudança de contrato do exit
121
- code (AC-10)
122
- - [x] Referencia ADR-0018 (que estende) e ADR-0021 (a classe de falha que fecha)
123
- - [x] Segue `memory/90-decisions/_template.md`
124
-
125
- ## T8 — Registry e documentação
126
- - **Owner**: Worker
127
- - **Estimativa**: P
128
- - **Depende de**: T5
129
- - **Paths**: `lib/core/registry.mjs`, `CLAUDE.md`, `docs/`
130
- - **Done quando**:
131
- - [x] `desc` do `tools:doctor` no registry reflete o novo papel (deixa de ser só "ferramentas de
132
- processo")
133
- - [x] `CLAUDE.md` e `docs/` onde o comando é descrito como "raio-x de ferramentas"
134
- - [x] `npm test` verde, incluindo `test/forja-core.test.js` (integridade do registry, ADR-0020)
135
-
136
- ## T9 — Validação no cenário real
137
- - **Owner**: Governance
138
- - **Estimativa**: P
139
- - **Depende de**: T5, T6, T7, T8
140
- - **Paths**: —
141
- - **Done quando**:
142
- - [x] `tools:doctor` roda sob um Node de **major diferente** e reporta o ABI quebrado com a
143
- prescrição certa. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está
144
- escrito (plano §7)
145
- - [x] `npm run project:check` e `npm test` verdes
146
- - [x] `gitleaks detect --no-banner` limpo
147
- - [x] Suíte completa verde (AC-9); spec → `done`
148
-
149
- ## T10 — `spec:new` mantém a allow-list do `.gitignore`
150
- - **Owner**: Worker
151
- - **Estimativa**: P
152
- - **Depende de**: — *(independente da lib; pode ir primeiro)*
153
- - **Paths**: `scripts/spec-cli.mjs`, `test/spec-cli.test.js`
154
- - **Contexto**: descoberto ao escrever o plano. O `.gitignore` ignora `/specs/*` e mantém uma
155
- allow-list manual; **toda spec nova do framework nasce invisível ao git**. Aconteceu com esta
156
- própria spec. Emenda de 2026-07-13 à spec (AC-11).
157
- - **Done quando**:
158
- - [x] `spec:new <slug>` acrescenta `!/specs/<slug>` ao bloco de allow-list do `.gitignore`
159
- - [x] **Idempotente**: rodar duas vezes não duplica a linha
160
- - [x] Insere **dentro do bloco existente** (após a última `!/specs/…`), não no fim do arquivo —
161
- as regras seguintes do `.gitignore` dependem da ordem
162
- - [x] Se o bloco não existir (ou o `.gitignore` sumir), **não falha** a criação da spec: avisa e
163
- segue. Criar spec é o trabalho; manter o gitignore é o efeito colateral
164
- - [x] Teste: cria spec num `.gitignore` de fixture e verifica a linha, a idempotência e a posição
165
- - [x] `git status` mostra a spec recém-criada, sem passo manual (AC-11)
166
-
167
- ---
168
-
169
- ## Handoffs entre agentes
170
-
171
- Este conjunto atravessa Worker (T1-T6, T8, T10), SDD Architect (T7) e Governance (T9). Registrar
172
- handoff a cada fronteira via `npm run agent:route` — 7 campos obrigatórios (ADR-0005).
1
+ # Tasks: doctor-do-nucleo
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: done
6
+ - **Criado em**: 2026-07-13
7
+
8
+ > Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
9
+
10
+ Convenção de IDs: `T1`, `T2`, … A sequência reflete a **ordem de merge do plano §7**: a lib e os
11
+ testes primeiro (nada a consome ainda), depois as superfícies, e o hook por último — é o de maior
12
+ risco e o único que roda em toda sessão.
13
+
14
+ ---
15
+
16
+ ## T1 — Runner e contrato de `lib/core/health.mjs`
17
+ - **Owner**: Worker
18
+ - **Estimativa**: M
19
+ - **Depende de**: —
20
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
21
+ - **Escopo**: o esqueleto sem nenhum probe real — `CHECKS[]` vazio ou com um probe de fixture.
22
+ - **Done quando**:
23
+ - [x] `runChecks({ scope, env })` e `worstStatus(results)` exportados conforme plano §4 (AC-1)
24
+ - [x] Cascata: check com `dependsOn` que falhou é reportado `skipped`, nunca `fail`
25
+ - [x] Runner blinda o probe: probe que **lança** vira `fail` com o erro no `detail`, e o runner
26
+ continua os demais — nunca propaga exceção (NFR de resiliência)
27
+ - [x] `worstStatus` só devolve `fail` para `critical`; `warn` nunca escala
28
+ - [x] `env` injetável (`{ root, importModule, fs, workspace }`) com default real (D5)
29
+ - [x] `test/health.test.js` cobre cascata, blindagem e `worstStatus` com probes de fixture
30
+ - [x] Zero dependências novas (plano §6)
31
+
32
+ ## T2 — Probes de memória: `native-abi`, `memory-db`, `memory-fresh`
33
+ - **Owner**: Worker
34
+ - **Estimativa**: M
35
+ - **Depende de**: T1
36
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
37
+ - **Escopo**: os três checks que teriam pego a quebra de hoje. É o núcleo do núcleo.
38
+ - **Done quando**:
39
+ - [x] `native-abi` (critical) classifica por `err.code`, **não** por string de mensagem (risco da
40
+ spec): `ERR_DLOPEN_FAILED` → `npm rebuild better-sqlite3`; `ERR_MODULE_NOT_FOUND` →
41
+ `npm install` (AC-3)
42
+ - [x] `memory-db` (critical, `dependsOn: native-abi`) distingue **ausente** de **inacessível**,
43
+ cada um com sua correção (AC-4)
44
+ - [x] `memory-fresh` (**warn**, `dependsOn: memory-db`): `memory/` alterado depois do último sync
45
+ → `npm run sync:universal`. Reaproveita a lógica de `newestMemoryMtime` que hoje vive no
46
+ hook (AC-4)
47
+ - [x] Teste do ABI quebrado injeta `env.importModule` que lança `ERR_DLOPEN_FAILED` — sem mock de
48
+ módulo, sem corromper `node_modules` (D5)
49
+ - [x] Cada probe testado nos dois estados: são e quebrado (AC-9)
50
+
51
+ ## T3 — Probes de ambiente: `workspace`, `node-engines`
52
+ - **Owner**: Worker
53
+ - **Estimativa**: P
54
+ - **Depende de**: T1
55
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
56
+ - **Done quando**:
57
+ - [x] `workspace` (**warn**, D4) usa `getWorkspaceInfo()` de `lib/workspace.mjs`; se não resolve
58
+ para diretório existente → `npm run workspace:init`. Reporta também a **origem** da
59
+ resolução (`FORJA_WORKSPACE` / `~/.forjarc.json` / default), que é metade do diagnóstico
60
+ quando o workspace certo existe mas não é o que está sendo usado (AC-5)
61
+ - [x] `node-engines` (**warn**) compara `process.versions.node` com `engines.node` do
62
+ `package.json`
63
+ - [x] Ambos testados nos dois estados via `env.fs` / `env.workspace` injetados
64
+
65
+ ## T4 — Probes de regressão do repo: `runtime-deps`, `mcp-json`
66
+ - **Owner**: Worker
67
+ - **Estimativa**: M
68
+ - **Depende de**: T1
69
+ - **Paths**: `lib/core/health.mjs`, `test/health.test.js`
70
+ - **Escopo**: converte em gate executável os dois invariantes que o ADR-0021 corrigiu à mão e que
71
+ hoje podem reincidir sem que nada perceba.
72
+ - **Done quando**:
73
+ - [x] Ambos com `scope: 'repo'` — **não** rodam fora do repo do framework, onde produziriam falso
74
+ positivo crítico na máquina do usuário final (D3). Detecção: `.git` + `package.json` com
75
+ `name: forjajs`
76
+ - [x] `runtime-deps` (critical): todo módulo importado **estaticamente** por script sob `files[]`
77
+ está em `dependencies`, não em `devDependencies` (AC-6). Parser **conservador**: import
78
+ dinâmico ou não resolvido → `warn`, nunca `fail` (risco da spec)
79
+ - [x] `mcp-json` (critical): nenhum path absoluto versionado em `.mcp.json` (AC-7)
80
+ - [x] Teste com fixture de `package.json`/`.mcp.json` quebrados, via `env.fs` e `env.root`
81
+ - [x] Teste garantindo que ambos são `skipped` quando `scope: 'runtime'`
82
+
83
+ ## T5 — `tools:doctor` consome a lib e vira gate
84
+ - **Owner**: Worker
85
+ - **Estimativa**: M
86
+ - **Depende de**: T2, T3, T4
87
+ - **Paths**: `scripts/tools-doctor.mjs`
88
+ - **Done quando**:
89
+ - [x] Duas seções na saída: **Núcleo** e **Ferramentas** (AC-2)
90
+ - [x] `exit 1` **se e somente se** algum check `critical` do núcleo falhar. Ferramenta opcional
91
+ ausente segue `exit 0` — contrato do ADR-0018 preservado (AC-2, D4)
92
+ - [x] `TOOLS[]` das cinco ferramentas opcionais permanece intocado (spec §5, fora de escopo)
93
+ - [x] Cada falha imprime o comando de correção ao lado
94
+ - [x] Roda em < 2s (NFR)
95
+ - [x] Funciona **sem `node_modules`** — é justamente aí que ele mais importa (NFR)
96
+
97
+ ## T6 — `SessionStart` consome a lib e perde a heurística própria
98
+ - **Owner**: Worker
99
+ - **Estimativa**: M
100
+ - **Depende de**: T2, T3
101
+ - **Paths**: `scripts/hook-session-start.mjs`
102
+ - **Escopo**: a task de maior risco. O hook roda em toda sessão e o ADR-0021 o marcou como "nunca
103
+ pode derrubar a sessão".
104
+ - **Done quando**:
105
+ - [x] `resolveDbPath()` e `staleIndex()` **deixam de existir** — o `catch { return null }` que
106
+ colapsa três causas distintas é a raiz do problema (plano §1)
107
+ - [x] A prescrição errada (`npm install` para ABI quebrado, linha 91) não existe mais no código
108
+ (AC-8)
109
+ - [x] Chama `runChecks({ scope: 'runtime' })` — zero heurística própria (AC-8)
110
+ - [x] **Sempre `exit 0`**: o hook reporta, nunca trava a sessão (ADR-0021)
111
+ - [x] Cabe com folga no timeout de 5s; se não couber, ver kill criteria do plano §8
112
+ - [x] `test/hooks.test.js` estendido: sem `node_modules` o hook degrada, não estoura
113
+
114
+ ## T7 — ADR-0023
115
+ - **Owner**: SDD Architect
116
+ - **Estimativa**: P
117
+ - **Depende de**: T5, T6
118
+ - **Paths**: `memory/90-decisions/0023-doctor-como-gate-do-nucleo.md`
119
+ - **Done quando**:
120
+ - [x] Registra D1 (checks como dados), D3 (`scope` repo/runtime) e a mudança de contrato do exit
121
+ code (AC-10)
122
+ - [x] Referencia ADR-0018 (que estende) e ADR-0021 (a classe de falha que fecha)
123
+ - [x] Segue `memory/90-decisions/_template.md`
124
+
125
+ ## T8 — Registry e documentação
126
+ - **Owner**: Worker
127
+ - **Estimativa**: P
128
+ - **Depende de**: T5
129
+ - **Paths**: `lib/core/registry.mjs`, `CLAUDE.md`, `docs/`
130
+ - **Done quando**:
131
+ - [x] `desc` do `tools:doctor` no registry reflete o novo papel (deixa de ser só "ferramentas de
132
+ processo")
133
+ - [x] `CLAUDE.md` e `docs/` onde o comando é descrito como "raio-x de ferramentas"
134
+ - [x] `npm test` verde, incluindo `test/forja-core.test.js` (integridade do registry, ADR-0020)
135
+
136
+ ## T9 — Validação no cenário real
137
+ - **Owner**: Governance
138
+ - **Estimativa**: P
139
+ - **Depende de**: T5, T6, T7, T8
140
+ - **Paths**: —
141
+ - **Done quando**:
142
+ - [x] `tools:doctor` roda sob um Node de **major diferente** e reporta o ABI quebrado com a
143
+ prescrição certa. Um doctor de ABI que nunca viu um ABI quebrado não está testado, está
144
+ escrito (plano §7)
145
+ - [x] `npm run project:check` e `npm test` verdes
146
+ - [x] `gitleaks detect --no-banner` limpo
147
+ - [x] Suíte completa verde (AC-9); spec → `done`
148
+
149
+ ## T10 — `spec:new` mantém a allow-list do `.gitignore`
150
+ - **Owner**: Worker
151
+ - **Estimativa**: P
152
+ - **Depende de**: — *(independente da lib; pode ir primeiro)*
153
+ - **Paths**: `scripts/spec-cli.mjs`, `test/spec-cli.test.js`
154
+ - **Contexto**: descoberto ao escrever o plano. O `.gitignore` ignora `/specs/*` e mantém uma
155
+ allow-list manual; **toda spec nova do framework nasce invisível ao git**. Aconteceu com esta
156
+ própria spec. Emenda de 2026-07-13 à spec (AC-11).
157
+ - **Done quando**:
158
+ - [x] `spec:new <slug>` acrescenta `!/specs/<slug>` ao bloco de allow-list do `.gitignore`
159
+ - [x] **Idempotente**: rodar duas vezes não duplica a linha
160
+ - [x] Insere **dentro do bloco existente** (após a última `!/specs/…`), não no fim do arquivo —
161
+ as regras seguintes do `.gitignore` dependem da ordem
162
+ - [x] Se o bloco não existir (ou o `.gitignore` sumir), **não falha** a criação da spec: avisa e
163
+ segue. Criar spec é o trabalho; manter o gitignore é o efeito colateral
164
+ - [x] Teste: cria spec num `.gitignore` de fixture e verifica a linha, a idempotência e a posição
165
+ - [x] `git status` mostra a spec recém-criada, sem passo manual (AC-11)
166
+
167
+ ---
168
+
169
+ ## Handoffs entre agentes
170
+
171
+ Este conjunto atravessa Worker (T1-T6, T8, T10), SDD Architect (T7) e Governance (T9). Registrar
172
+ handoff a cada fronteira via `npm run agent:route` — 7 campos obrigatórios (ADR-0005).
@@ -1,71 +1,71 @@
1
- # Spec: forja-core
2
-
3
- - **ID**: SPEC-025
4
- - **Status**: done
5
- - **Owner**: framework-team
6
- - **Criado em**: 2026-07-06
7
- - **Sprint alvo**: core-2026-07
8
- - **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
9
-
10
- ## 1. Problema
11
- O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
12
-
13
- 1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
14
- 2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
15
- 3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
16
-
17
- Consequências mensuráveis:
18
- - Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
19
- - Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
20
- - O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
21
- - Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
22
-
23
- ## 2. Proposta de valor
24
- Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
25
-
26
- ## 3. User stories
27
- - **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
28
- - **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
29
- - **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
30
- - **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
31
-
32
- ## 4. Critérios de aceite (Definition of Done)
33
- - [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
34
- - [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
35
- - [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
36
- - [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
37
- - [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
38
- - [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
39
- - [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
40
-
41
- ## 5. Escopo
42
- **Dentro**:
43
- - `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
44
- - `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
45
- - `scripts/agent-harness.mjs`: ficha automática no `project:new`
46
- - `test/forja-core.test.js`
47
- - README/DOC-MAP: documentar o core como ponto de entrada
48
-
49
- **Fora** (explícito, evita scope creep):
50
- - Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
51
- - Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
52
- - Dashboard (`dashboard:*`) — front opcional, fora do processo
53
- - Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
54
-
55
- ## 6. NFRs / restrições
56
- - Zero dependências novas (Node stdlib apenas).
57
- - Overhead do roteamento imperceptível (< 100ms além do script alvo).
58
- - Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
59
- - Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
60
- - pt-BR em toda saída de CLI.
61
-
62
- ## 7. Riscos e mitigação
63
- | Risco | Probabilidade | Impacto | Mitigação |
64
- |---|---|---|---|
65
- | Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
66
- | Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
67
- | Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
68
- | JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
69
-
70
- ## 8. Métricas de sucesso
71
- 30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
1
+ # Spec: forja-core
2
+
3
+ - **ID**: SPEC-025
4
+ - **Status**: done
5
+ - **Owner**: framework-team
6
+ - **Criado em**: 2026-07-06
7
+ - **Sprint alvo**: core-2026-07
8
+ - **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
9
+
10
+ ## 1. Problema
11
+ O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
12
+
13
+ 1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
14
+ 2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
15
+ 3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
16
+
17
+ Consequências mensuráveis:
18
+ - Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
19
+ - Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
20
+ - O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
21
+ - Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
22
+
23
+ ## 2. Proposta de valor
24
+ Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
25
+
26
+ ## 3. User stories
27
+ - **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
28
+ - **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
29
+ - **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
30
+ - **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
31
+
32
+ ## 4. Critérios de aceite (Definition of Done)
33
+ - [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
34
+ - [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
35
+ - [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
36
+ - [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
37
+ - [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
38
+ - [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
39
+ - [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
40
+
41
+ ## 5. Escopo
42
+ **Dentro**:
43
+ - `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
44
+ - `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
45
+ - `scripts/agent-harness.mjs`: ficha automática no `project:new`
46
+ - `test/forja-core.test.js`
47
+ - README/DOC-MAP: documentar o core como ponto de entrada
48
+
49
+ **Fora** (explícito, evita scope creep):
50
+ - Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
51
+ - Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
52
+ - Dashboard (`dashboard:*`) — front opcional, fora do processo
53
+ - Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
54
+
55
+ ## 6. NFRs / restrições
56
+ - Zero dependências novas (Node stdlib apenas).
57
+ - Overhead do roteamento imperceptível (< 100ms além do script alvo).
58
+ - Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
59
+ - Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
60
+ - pt-BR em toda saída de CLI.
61
+
62
+ ## 7. Riscos e mitigação
63
+ | Risco | Probabilidade | Impacto | Mitigação |
64
+ |---|---|---|---|
65
+ | Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
66
+ | Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
67
+ | Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
68
+ | JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
69
+
70
+ ## 8. Métricas de sucesso
71
+ 30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
@@ -1,63 +1,63 @@
1
- # Spec: gates
2
-
3
- - **ID**: SPEC-020
4
- - **Status**: done
5
- - **Owner**: apk
6
- - **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
7
-
8
- ## 1. Problema
9
-
10
- O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
11
- `release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
12
- **espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
13
- justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
14
- É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
15
-
16
- ## 2. Proposta de valor
17
-
18
- Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
19
- coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
20
-
21
- ## 3. User stories
22
-
23
- - **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
24
- não esqueça um gate e descubra a quebra no CI (ou depois).
25
- - **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
26
- **para que** o pré-release seja um comando, não um checklist.
27
-
28
- ## 4. Critérios de aceite (Definition of Done)
29
-
30
- - [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
31
- `project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
32
- - [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
33
- (instala + builda o backend gerado).
34
- - [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
35
- pior status ao final — legível, não um despejo.
36
- - [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
37
- zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
38
- - [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
39
- devolvem status conhecidos, sem gerar projeto de verdade).
40
-
41
- ## 5. Escopo
42
-
43
- **Dentro**: compor os gates do framework num comando com veredito único e tiers.
44
-
45
- **Fora** (explícito):
46
- - `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
47
- framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
48
- - Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
49
- - Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
50
- `check:all` é o agregador, não o dono.
51
-
52
- ## 6. NFRs / restrições
53
-
54
- - **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
55
- rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
56
- momento certo, como no `release:check`.
57
- - **Compatibilidade**: comando novo; não muda os gates que agrega.
58
-
59
- ## 7. Métricas de sucesso
60
-
61
- Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
62
- reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
63
- gates rodar.
1
+ # Spec: gates
2
+
3
+ - **ID**: SPEC-020
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
7
+
8
+ ## 1. Problema
9
+
10
+ O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
11
+ `release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
12
+ **espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
13
+ justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
14
+ É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
15
+
16
+ ## 2. Proposta de valor
17
+
18
+ Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
19
+ coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
20
+
21
+ ## 3. User stories
22
+
23
+ - **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
24
+ não esqueça um gate e descubra a quebra no CI (ou depois).
25
+ - **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
26
+ **para que** o pré-release seja um comando, não um checklist.
27
+
28
+ ## 4. Critérios de aceite (Definition of Done)
29
+
30
+ - [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
31
+ `project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
32
+ - [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
33
+ (instala + builda o backend gerado).
34
+ - [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
35
+ pior status ao final — legível, não um despejo.
36
+ - [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
37
+ zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
38
+ - [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
39
+ devolvem status conhecidos, sem gerar projeto de verdade).
40
+
41
+ ## 5. Escopo
42
+
43
+ **Dentro**: compor os gates do framework num comando com veredito único e tiers.
44
+
45
+ **Fora** (explícito):
46
+ - `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
47
+ framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
48
+ - Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
49
+ - Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
50
+ `check:all` é o agregador, não o dono.
51
+
52
+ ## 6. NFRs / restrições
53
+
54
+ - **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
55
+ rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
56
+ momento certo, como no `release:check`.
57
+ - **Compatibilidade**: comando novo; não muda os gates que agrega.
58
+
59
+ ## 7. Métricas de sucesso
60
+
61
+ Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
62
+ reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
63
+ gates rodar.