forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,112 +1,112 @@
1
- # Spec: governanca-visivel
2
-
3
- - **ID**: SPEC-014
4
- - **Status**: done
5
- - **Owner**: apk
6
- - **Criado em**: 2026-07-18
7
- - **Sprint alvo**: S?
8
- - **ADRs relacionadas**: [ADR-0020](../../memory/90-decisions/0020-forja-core-cli-unica.md) (core/registry + auditoria), [ADR-0022](../../memory/90-decisions/0022-congelar-dashboard-web.md) (dashboard congelado), [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0002](../../memory/90-decisions/0002-sqlite-fts5-busca.md) (SQLite FTS5)
9
-
10
- ## 1. Problema
11
-
12
- O core grava **toda execução** em `.context/forja-runs.jsonl` (ADR-0020): comando, args, exit code,
13
- duração, timestamp. São 255 runs registrados hoje. É o dado mais rico de governança que o framework
14
- tem — a resposta viva para *"o processo foi seguido? o que rodou? o que reprovou? quanto custou?"*.
15
-
16
- E é **write-only.** Nada lê. Para responder "quantas vezes o `release:check` reprovou este mês" ou
17
- "qual gate está mais lento", alguém abre um `.jsonl` de 255 linhas e conta na mão. O dado existe e é
18
- inerte — a mesma classe do problema que a sessão inteira atacou (conhecimento que existe mas não é
19
- consultável vira conhecimento morto).
20
-
21
- E há uma segunda ausência: o Forja **não tem superfície visual**. A tentativa anterior (SPEC-002) foi
22
- **congelada** (ADR-0022) — mas não por ser visual, e sim por ser um **servidor** com rotas que
23
- *executam* processos (`POST .../run/:role`): virou passivo de manutenção e de segurança. A lição não
24
- é "sem visual"; é "sem servidor, sem execução". Um artefato **estático, gerado por comando**, de
25
- leitura, não repete o erro — é a mesma natureza do `project:dashboard` (que já gera um relatório),
26
- só que sobre governança e legível de relance.
27
-
28
- ## 2. Proposta de valor
29
-
30
- A trilha de auditoria deixa de ser um arquivo que ninguém abre: vira **consultável** por comando, e
31
- **visível** num painel de governança **estático e gerado** — leitura, sem servidor (a lição do
32
- ADR-0022). "O processo foi seguido?" passa a ter resposta de relance, do dado real.
33
-
34
- ## 3. User stories
35
-
36
- - **Como** governança, **quero** consultar a auditoria por comando/gate/período, **para que**
37
- "quantas vezes o `release:check` reprovou" seja uma query, não uma contagem manual.
38
- - **Como** operador, **quero** um painel de relance com o estado dos gates, do pipeline SDD e da
39
- atividade recente, **para que** eu veja a saúde do framework sem ler dez arquivos.
40
- - **Como** quem opera vários projetos, **quero** que o painel seja um **artefato gerado** (HTML
41
- estático, sem servidor), **para que** eu não reintroduza o passivo que congelou o dashboard antigo.
42
- - **Como** agente, **quero** ler o resumo da auditoria em vez do `.jsonl` cru, **para que** eu gaste
43
- menos tokens entendendo o que já rodou.
44
-
45
- ## 4. Critérios de aceite (Definition of Done)
46
-
47
- - [x] AC-1: **Ingest** — um comando (`audit:sync`) lê `.context/forja-runs.jsonl` (a fonte de verdade
48
- append-only) e o projeta numa tabela SQLite consultável no workspace. Idempotente: rodar duas
49
- vezes não duplica.
50
- - [x] AC-2: **Query** — `audit:query` responde por comando, gate, exit code e janela de tempo
51
- (ex.: `--since 7d`, `--cmd release:check`, `--failed`). Saída legível + contagem.
52
- - [x] AC-3: **Painel gerado** — um comando gera um **HTML estático e self-contained** (CSS/JS
53
- inline, zero asset externo) com: estado dos gates, quadro do pipeline SDD (specs × stages),
54
- atividade recente da auditoria (últimos runs, reprovações, gates mais lentos) e as métricas
55
- (comandos, testes, ADRs).
56
- - [x] AC-4: **Sem servidor, leitura, gerado** (ADR-0022): o painel é um arquivo escrito em disco,
57
- regenerado sob demanda. **Zero** rota, zero processo executável, zero `POST`. O rodapé declara
58
- isso.
59
- - [x] AC-5: **Dado real, não fixture** — o painel e as queries leem a auditoria e as specs de
60
- verdade; nada hard-coded. Um repo sem runs mostra "sem atividade", não quebra.
61
- - [x] AC-6: **Degrada sem workspace/db** — como todo o resto (ADR-0021): sem `universal.db`, os
62
- comandos avisam com a correção (`sync:universal`/`audit:sync`), não estouram.
63
- - [x] AC-7: Entradas no registry (ADR-0020); os comandos passam pelo core e são auditados como os
64
- demais.
65
- - [x] AC-8: Gates do próprio Forja: `release:check` (scripts no `files[]`), `tools:doctor`
66
- (docs-commands não acusa fantasma), `npm test` verde. Testes dos comandos novos.
67
- - [x] AC-9: ADR-0028 registrando a decisão (auditoria consultável; painel estático-gerado como a
68
- resposta correta ao ADR-0022).
69
-
70
- ## 5. Escopo
71
-
72
- **Dentro**:
73
- - `audit:sync` (ingest jsonl → tabela) e `audit:query` (consulta).
74
- - O comando gerador do painel HTML estático de governança.
75
- - Schema da tabela de auditoria (no `memory-schema`/workspace db).
76
- - ADR-0028 + testes.
77
-
78
- **Fora** (explícito):
79
- - **Servidor, rotas, execução pela web.** É exatamente o que o ADR-0022 congelou. Inegociável.
80
- - **Instrumentar token por tarefa.** O painel tem lugar para isso, mas medir o custo de token de
81
- cada tarefa é outra frente (o audit hoje grava duração, não tokens). Follow-up.
82
- - **Substituir o `project:dashboard`** (markdown, ecossistema de projetos). Este é sobre governança
83
- do framework; coexistem. Uma futura unificação é outra decisão.
84
- - **Tempo real / auto-refresh.** O painel é gerado sob demanda; quem quer atualizar, regenera.
85
-
86
- ## 6. NFRs / restrições
87
-
88
- - **Estático e self-contained (inegociável)**: o HTML abre com `file://`, sem rede, sem servidor. É o
89
- que separa esta spec da SPEC-002 congelada.
90
- - **Fonte de verdade preservada**: o `.jsonl` continua sendo o log append-only; a tabela é uma
91
- projeção reconstruível (`audit:sync` do zero recria).
92
- - **Token-aware**: o resumo da auditoria que o agente lê é menor que o `.jsonl` cru — a própria
93
- feature serve o ADR-0009.
94
- - **Resiliência (ADR-0021)**: sem workspace/db, avisa e segue; nunca estoura.
95
-
96
- ## 7. Riscos e mitigação
97
-
98
- | Risco | Prob | Impacto | Mitigação |
99
- |---|---|---|---|
100
- | Virar "dashboard servidor" de novo | B | **A** | AC-4 é gate: zero rota/processo. O painel é arquivo, não serviço |
101
- | FTS5 vs SQL estruturado — over-engineering | M | B | O dado é estruturado (cmd/exit/duração); query por coluna. FTS só nos args, se valer |
102
- | Painel gerado fica pesado/externo | M | M | Self-contained obrigatório (AC-3); mesmo princípio do prototipo já validado |
103
- | Auditoria esparsa deixa o painel vazio | M | B | AC-5: "sem atividade" é estado válido, não erro. O dado cresce com o uso |
104
-
105
- ## 8. Métricas de sucesso
106
-
107
- - "O `release:check` reprovou quantas vezes?" passa de contagem manual num `.jsonl` a **uma query**.
108
- - O painel responde "o framework está saudável?" de relance, do dado real — e é um **arquivo**, não
109
- um serviço rodando (a lição do ADR-0022, aplicada).
110
- - O resumo de auditoria que o agente lê é menor em tokens que o `.jsonl` cru — a governança visível
111
- também economiza contexto (ADR-0009).
112
- - 90 dias: ninguém abre o `forja-runs.jsonl` na mão; a pergunta de governança vira comando ou painel.
1
+ # Spec: governanca-visivel
2
+
3
+ - **ID**: SPEC-014
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-07-18
7
+ - **Sprint alvo**: S?
8
+ - **ADRs relacionadas**: [ADR-0020](../../memory/90-decisions/0020-forja-core-cli-unica.md) (core/registry + auditoria), [ADR-0022](../../memory/90-decisions/0022-congelar-dashboard-web.md) (dashboard congelado), [ADR-0009](../../memory/90-decisions/0009-claude-hooks-token-economy.md) (economia de tokens), [ADR-0002](../../memory/90-decisions/0002-sqlite-fts5-busca.md) (SQLite FTS5)
9
+
10
+ ## 1. Problema
11
+
12
+ O core grava **toda execução** em `.context/forja-runs.jsonl` (ADR-0020): comando, args, exit code,
13
+ duração, timestamp. São 255 runs registrados hoje. É o dado mais rico de governança que o framework
14
+ tem — a resposta viva para *"o processo foi seguido? o que rodou? o que reprovou? quanto custou?"*.
15
+
16
+ E é **write-only.** Nada lê. Para responder "quantas vezes o `release:check` reprovou este mês" ou
17
+ "qual gate está mais lento", alguém abre um `.jsonl` de 255 linhas e conta na mão. O dado existe e é
18
+ inerte — a mesma classe do problema que a sessão inteira atacou (conhecimento que existe mas não é
19
+ consultável vira conhecimento morto).
20
+
21
+ E há uma segunda ausência: o Forja **não tem superfície visual**. A tentativa anterior (SPEC-002) foi
22
+ **congelada** (ADR-0022) — mas não por ser visual, e sim por ser um **servidor** com rotas que
23
+ *executam* processos (`POST .../run/:role`): virou passivo de manutenção e de segurança. A lição não
24
+ é "sem visual"; é "sem servidor, sem execução". Um artefato **estático, gerado por comando**, de
25
+ leitura, não repete o erro — é a mesma natureza do `project:dashboard` (que já gera um relatório),
26
+ só que sobre governança e legível de relance.
27
+
28
+ ## 2. Proposta de valor
29
+
30
+ A trilha de auditoria deixa de ser um arquivo que ninguém abre: vira **consultável** por comando, e
31
+ **visível** num painel de governança **estático e gerado** — leitura, sem servidor (a lição do
32
+ ADR-0022). "O processo foi seguido?" passa a ter resposta de relance, do dado real.
33
+
34
+ ## 3. User stories
35
+
36
+ - **Como** governança, **quero** consultar a auditoria por comando/gate/período, **para que**
37
+ "quantas vezes o `release:check` reprovou" seja uma query, não uma contagem manual.
38
+ - **Como** operador, **quero** um painel de relance com o estado dos gates, do pipeline SDD e da
39
+ atividade recente, **para que** eu veja a saúde do framework sem ler dez arquivos.
40
+ - **Como** quem opera vários projetos, **quero** que o painel seja um **artefato gerado** (HTML
41
+ estático, sem servidor), **para que** eu não reintroduza o passivo que congelou o dashboard antigo.
42
+ - **Como** agente, **quero** ler o resumo da auditoria em vez do `.jsonl` cru, **para que** eu gaste
43
+ menos tokens entendendo o que já rodou.
44
+
45
+ ## 4. Critérios de aceite (Definition of Done)
46
+
47
+ - [x] AC-1: **Ingest** — um comando (`audit:sync`) lê `.context/forja-runs.jsonl` (a fonte de verdade
48
+ append-only) e o projeta numa tabela SQLite consultável no workspace. Idempotente: rodar duas
49
+ vezes não duplica.
50
+ - [x] AC-2: **Query** — `audit:query` responde por comando, gate, exit code e janela de tempo
51
+ (ex.: `--since 7d`, `--cmd release:check`, `--failed`). Saída legível + contagem.
52
+ - [x] AC-3: **Painel gerado** — um comando gera um **HTML estático e self-contained** (CSS/JS
53
+ inline, zero asset externo) com: estado dos gates, quadro do pipeline SDD (specs × stages),
54
+ atividade recente da auditoria (últimos runs, reprovações, gates mais lentos) e as métricas
55
+ (comandos, testes, ADRs).
56
+ - [x] AC-4: **Sem servidor, leitura, gerado** (ADR-0022): o painel é um arquivo escrito em disco,
57
+ regenerado sob demanda. **Zero** rota, zero processo executável, zero `POST`. O rodapé declara
58
+ isso.
59
+ - [x] AC-5: **Dado real, não fixture** — o painel e as queries leem a auditoria e as specs de
60
+ verdade; nada hard-coded. Um repo sem runs mostra "sem atividade", não quebra.
61
+ - [x] AC-6: **Degrada sem workspace/db** — como todo o resto (ADR-0021): sem `universal.db`, os
62
+ comandos avisam com a correção (`sync:universal`/`audit:sync`), não estouram.
63
+ - [x] AC-7: Entradas no registry (ADR-0020); os comandos passam pelo core e são auditados como os
64
+ demais.
65
+ - [x] AC-8: Gates do próprio Forja: `release:check` (scripts no `files[]`), `tools:doctor`
66
+ (docs-commands não acusa fantasma), `npm test` verde. Testes dos comandos novos.
67
+ - [x] AC-9: ADR-0028 registrando a decisão (auditoria consultável; painel estático-gerado como a
68
+ resposta correta ao ADR-0022).
69
+
70
+ ## 5. Escopo
71
+
72
+ **Dentro**:
73
+ - `audit:sync` (ingest jsonl → tabela) e `audit:query` (consulta).
74
+ - O comando gerador do painel HTML estático de governança.
75
+ - Schema da tabela de auditoria (no `memory-schema`/workspace db).
76
+ - ADR-0028 + testes.
77
+
78
+ **Fora** (explícito):
79
+ - **Servidor, rotas, execução pela web.** É exatamente o que o ADR-0022 congelou. Inegociável.
80
+ - **Instrumentar token por tarefa.** O painel tem lugar para isso, mas medir o custo de token de
81
+ cada tarefa é outra frente (o audit hoje grava duração, não tokens). Follow-up.
82
+ - **Substituir o `project:dashboard`** (markdown, ecossistema de projetos). Este é sobre governança
83
+ do framework; coexistem. Uma futura unificação é outra decisão.
84
+ - **Tempo real / auto-refresh.** O painel é gerado sob demanda; quem quer atualizar, regenera.
85
+
86
+ ## 6. NFRs / restrições
87
+
88
+ - **Estático e self-contained (inegociável)**: o HTML abre com `file://`, sem rede, sem servidor. É o
89
+ que separa esta spec da SPEC-002 congelada.
90
+ - **Fonte de verdade preservada**: o `.jsonl` continua sendo o log append-only; a tabela é uma
91
+ projeção reconstruível (`audit:sync` do zero recria).
92
+ - **Token-aware**: o resumo da auditoria que o agente lê é menor que o `.jsonl` cru — a própria
93
+ feature serve o ADR-0009.
94
+ - **Resiliência (ADR-0021)**: sem workspace/db, avisa e segue; nunca estoura.
95
+
96
+ ## 7. Riscos e mitigação
97
+
98
+ | Risco | Prob | Impacto | Mitigação |
99
+ |---|---|---|---|
100
+ | Virar "dashboard servidor" de novo | B | **A** | AC-4 é gate: zero rota/processo. O painel é arquivo, não serviço |
101
+ | FTS5 vs SQL estruturado — over-engineering | M | B | O dado é estruturado (cmd/exit/duração); query por coluna. FTS só nos args, se valer |
102
+ | Painel gerado fica pesado/externo | M | M | Self-contained obrigatório (AC-3); mesmo princípio do prototipo já validado |
103
+ | Auditoria esparsa deixa o painel vazio | M | B | AC-5: "sem atividade" é estado válido, não erro. O dado cresce com o uso |
104
+
105
+ ## 8. Métricas de sucesso
106
+
107
+ - "O `release:check` reprovou quantas vezes?" passa de contagem manual num `.jsonl` a **uma query**.
108
+ - O painel responde "o framework está saudável?" de relance, do dado real — e é um **arquivo**, não
109
+ um serviço rodando (a lição do ADR-0022, aplicada).
110
+ - O resumo de auditoria que o agente lê é menor em tokens que o `.jsonl` cru — a governança visível
111
+ também economiza contexto (ADR-0009).
112
+ - 90 dias: ninguém abre o `forja-runs.jsonl` na mão; a pergunta de governança vira comando ou painel.
@@ -1,60 +1,60 @@
1
- # Tasks: governanca-visivel
2
-
3
- - **Spec**: ./spec.md
4
- - **Plan**: ./plan.md
5
- - **Status**: done
6
- - **Criado em**: 2026-07-19
7
-
8
- > Ordem: dado consultável primeiro (audit), painel depois (que lê o audit). Env injetável em toda a
9
- > lógica pura, para os testes não tocarem o workspace real.
10
-
11
- ---
12
-
13
- ## T1 — Schema + `lib/audit.mjs`
14
- - **Owner**: Worker · **Estimativa**: M · **Depende de**: —
15
- - **Paths**: `scripts/memory-schema.mjs`, `lib/audit.mjs`, `test/audit.test.js`
16
- - **Done**:
17
- - [ ] Tabela `audit_runs` (`line_hash` PK, `ts`, `cmd`, `args`, `exit_code`, `duration_ms`; índices em `cmd`/`ts`).
18
- - [ ] `syncAudit(env)`: lê o jsonl, `INSERT OR IGNORE` por `line_hash` — idempotente (AC-1). Linha malformada é pulada, não derruba.
19
- - [ ] `queryAudit(env, {since,cmd,gate,failed})` e `auditSummary(env)` (total, fails, byCmd, slowest, recent) — AC-2.
20
- - [ ] `env` injetável (`fs`/`dbPath`/`jsonlPath`); testes com jsonl de fixture, incl. idempotência e linha corrompida.
21
-
22
- ## T2 — `audit:sync` + `audit:query` (registry)
23
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
24
- - **Paths**: `scripts/audit-sync.mjs`, `scripts/audit-query.mjs`, `lib/core/registry.mjs`
25
- - **Done**:
26
- - [ ] CLIs finos sobre `lib/audit.mjs`; entradas no registry (domínio `governanca`), passam pelo core.
27
- - [ ] Degradam sem workspace/db: avisam com `sync:universal`/`audit:sync`, não estouram (AC-6).
28
- - [ ] **Prova real**: `audit:sync` ingere os 255 runs do workspace; `audit:query --failed` e `--cmd release:check` respondem.
29
-
30
- ## T3 — `lib/governance-report.mjs` (coleta + render)
31
- - **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
32
- - **Paths**: `lib/governance-report.mjs`, `test/governance-report.test.js`
33
- - **Done**:
34
- - [ ] `collect(env)`: specs (status por stage), ADRs (contagem/lista de `memory/90-decisions`), gates (checks de `health`/`release` + último exit da auditoria — **sem reexecutar**, D4), métricas (comandos do registry).
35
- - [ ] `renderHtml(data)`: HTML **self-contained** — CSS/JS inline, **zero asset externo** (AC-3/AC-4). Tema claro/escuro. Reaproveita o design do protótipo.
36
- - [ ] Dado real, não fixture (AC-5): repo sem runs → seção "sem atividade", não quebra.
37
- - [ ] Teste: `renderHtml` não emite `http`/`src=`/`@import` externo; `collect` degrada sem db.
38
-
39
- ## T4 — `governance:dashboard` (registry)
40
- - **Owner**: Worker · **Estimativa**: P · **Depende de**: T3
41
- - **Paths**: `scripts/governance-dashboard.mjs`, `lib/core/registry.mjs`
42
- - **Done**:
43
- - [ ] Escreve o HTML num arquivo (default `<workspace>/.context/governance.html`), reporta o caminho.
44
- - [ ] **Zero execução** na geração — só lê e escreve (AC-4 / kill criteria). Entrada no registry.
45
- - [ ] **Prova real**: gera o arquivo, abre e confere que os gates/SDD/auditoria refletem o repo.
46
-
47
- ## T5 — ADR-0028
48
- - **Owner**: SDD Architect · **Estimativa**: P · **Depende de**: T2, T4
49
- - **Paths**: `memory/90-decisions/0028-*.md`
50
- - **Done**: registra D1 (tabela = projeção), D4 (painel não executa), D5 (comando novo); referencia
51
- ADR-0022 (a resposta correta ao dashboard congelado), ADR-0020, ADR-0021.
52
-
53
- ## T6 — Gates (Governance)
54
- - **Owner**: Governance · **Estimativa**: P · **Depende de**: T2, T4, T5
55
- - **Done**: `release:check` (scripts no `files[]`), `tools:doctor` (docs-commands não acusa fantasma
56
- nos comandos novos), `npm test` verde. spec → `done`.
57
-
58
- ---
59
- ## Handoffs
60
- Worker (T1-T4), SDD Architect (T5), Governance (T6). `forja agent:route` a cada fronteira (ADR-0005).
1
+ # Tasks: governanca-visivel
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: done
6
+ - **Criado em**: 2026-07-19
7
+
8
+ > Ordem: dado consultável primeiro (audit), painel depois (que lê o audit). Env injetável em toda a
9
+ > lógica pura, para os testes não tocarem o workspace real.
10
+
11
+ ---
12
+
13
+ ## T1 — Schema + `lib/audit.mjs`
14
+ - **Owner**: Worker · **Estimativa**: M · **Depende de**: —
15
+ - **Paths**: `scripts/memory-schema.mjs`, `lib/audit.mjs`, `test/audit.test.js`
16
+ - **Done**:
17
+ - [ ] Tabela `audit_runs` (`line_hash` PK, `ts`, `cmd`, `args`, `exit_code`, `duration_ms`; índices em `cmd`/`ts`).
18
+ - [ ] `syncAudit(env)`: lê o jsonl, `INSERT OR IGNORE` por `line_hash` — idempotente (AC-1). Linha malformada é pulada, não derruba.
19
+ - [ ] `queryAudit(env, {since,cmd,gate,failed})` e `auditSummary(env)` (total, fails, byCmd, slowest, recent) — AC-2.
20
+ - [ ] `env` injetável (`fs`/`dbPath`/`jsonlPath`); testes com jsonl de fixture, incl. idempotência e linha corrompida.
21
+
22
+ ## T2 — `audit:sync` + `audit:query` (registry)
23
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T1
24
+ - **Paths**: `scripts/audit-sync.mjs`, `scripts/audit-query.mjs`, `lib/core/registry.mjs`
25
+ - **Done**:
26
+ - [ ] CLIs finos sobre `lib/audit.mjs`; entradas no registry (domínio `governanca`), passam pelo core.
27
+ - [ ] Degradam sem workspace/db: avisam com `sync:universal`/`audit:sync`, não estouram (AC-6).
28
+ - [ ] **Prova real**: `audit:sync` ingere os 255 runs do workspace; `audit:query --failed` e `--cmd release:check` respondem.
29
+
30
+ ## T3 — `lib/governance-report.mjs` (coleta + render)
31
+ - **Owner**: Worker · **Estimativa**: M · **Depende de**: T1
32
+ - **Paths**: `lib/governance-report.mjs`, `test/governance-report.test.js`
33
+ - **Done**:
34
+ - [ ] `collect(env)`: specs (status por stage), ADRs (contagem/lista de `memory/90-decisions`), gates (checks de `health`/`release` + último exit da auditoria — **sem reexecutar**, D4), métricas (comandos do registry).
35
+ - [ ] `renderHtml(data)`: HTML **self-contained** — CSS/JS inline, **zero asset externo** (AC-3/AC-4). Tema claro/escuro. Reaproveita o design do protótipo.
36
+ - [ ] Dado real, não fixture (AC-5): repo sem runs → seção "sem atividade", não quebra.
37
+ - [ ] Teste: `renderHtml` não emite `http`/`src=`/`@import` externo; `collect` degrada sem db.
38
+
39
+ ## T4 — `governance:dashboard` (registry)
40
+ - **Owner**: Worker · **Estimativa**: P · **Depende de**: T3
41
+ - **Paths**: `scripts/governance-dashboard.mjs`, `lib/core/registry.mjs`
42
+ - **Done**:
43
+ - [ ] Escreve o HTML num arquivo (default `<workspace>/.context/governance.html`), reporta o caminho.
44
+ - [ ] **Zero execução** na geração — só lê e escreve (AC-4 / kill criteria). Entrada no registry.
45
+ - [ ] **Prova real**: gera o arquivo, abre e confere que os gates/SDD/auditoria refletem o repo.
46
+
47
+ ## T5 — ADR-0028
48
+ - **Owner**: SDD Architect · **Estimativa**: P · **Depende de**: T2, T4
49
+ - **Paths**: `memory/90-decisions/0028-*.md`
50
+ - **Done**: registra D1 (tabela = projeção), D4 (painel não executa), D5 (comando novo); referencia
51
+ ADR-0022 (a resposta correta ao dashboard congelado), ADR-0020, ADR-0021.
52
+
53
+ ## T6 — Gates (Governance)
54
+ - **Owner**: Governance · **Estimativa**: P · **Depende de**: T2, T4, T5
55
+ - **Done**: `release:check` (scripts no `files[]`), `tools:doctor` (docs-commands não acusa fantasma
56
+ nos comandos novos), `npm test` verde. spec → `done`.
57
+
58
+ ---
59
+ ## Handoffs
60
+ Worker (T1-T4), SDD Architect (T5), Governance (T6). `forja agent:route` a cada fronteira (ADR-0005).
@@ -1,71 +1,71 @@
1
- # Spec: harness-codegraph
2
-
3
- - **ID**: SPEC-024
4
- - **Status**: done
5
- - **Owner**: framework-team
6
- - **Criado em**: 2026-06-27
7
- - **Sprint alvo**: harness-2026-06
8
- - **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
9
-
10
- ## 1. Problema
11
- O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
12
-
13
- 1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
14
- 2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
15
- 3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
16
-
17
- Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
18
-
19
- ## 2. Proposta de valor
20
- O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
21
-
22
- ## 3. User stories
23
- - **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
24
- - **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
25
- - **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
26
- - **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
27
- - **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
28
-
29
- ## 4. Critérios de aceite (Definition of Done)
30
- - [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
31
- - [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
32
- - [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
33
- - [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
34
- - [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
35
- - [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
36
- - [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
37
- - [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
38
-
39
- ## 5. Escopo
40
- **Dentro**:
41
- - `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
42
- - `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
43
- - `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
44
- - Template do runbook GSD + lógica do `gsd:check`
45
- - `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
46
- - `.claude/agents/` + `prompts/` (sdd-architect, governance)
47
- - Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
48
- - ADR-0017 e ADR-0018
49
-
50
- **Fora** (explícito, evita scope creep):
51
- - Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
52
- - Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
53
- - Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
54
- - Mexer em `projects/` (apps reais, off-limits)
55
-
56
- ## 6. NFRs / restrições
57
- - Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
58
- - Determinístico: `code:check`/`tools:doctor` não dependem de rede
59
- - Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
60
- - pt-BR em toda saída de CLI
61
-
62
- ## 7. Riscos e mitigação
63
- | Risco | Probabilidade | Impacto | Mitigação |
64
- |---|---|---|---|
65
- | codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
66
- | Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
67
- | Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
68
- | Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
69
-
70
- ## 8. Métricas de sucesso
71
- 30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.
1
+ # Spec: harness-codegraph
2
+
3
+ - **ID**: SPEC-024
4
+ - **Status**: done
5
+ - **Owner**: framework-team
6
+ - **Criado em**: 2026-06-27
7
+ - **Sprint alvo**: harness-2026-06
8
+ - **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
9
+
10
+ ## 1. Problema
11
+ O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
12
+
13
+ 1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
14
+ 2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
15
+ 3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
16
+
17
+ Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
18
+
19
+ ## 2. Proposta de valor
20
+ O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
21
+
22
+ ## 3. User stories
23
+ - **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
24
+ - **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
25
+ - **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
26
+ - **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
27
+ - **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
28
+
29
+ ## 4. Critérios de aceite (Definition of Done)
30
+ - [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
31
+ - [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
32
+ - [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
33
+ - [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
34
+ - [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
35
+ - [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
36
+ - [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
37
+ - [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
38
+
39
+ ## 5. Escopo
40
+ **Dentro**:
41
+ - `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
42
+ - `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
43
+ - `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
44
+ - Template do runbook GSD + lógica do `gsd:check`
45
+ - `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
46
+ - `.claude/agents/` + `prompts/` (sdd-architect, governance)
47
+ - Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
48
+ - ADR-0017 e ADR-0018
49
+
50
+ **Fora** (explícito, evita scope creep):
51
+ - Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
52
+ - Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
53
+ - Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
54
+ - Mexer em `projects/` (apps reais, off-limits)
55
+
56
+ ## 6. NFRs / restrições
57
+ - Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
58
+ - Determinístico: `code:check`/`tools:doctor` não dependem de rede
59
+ - Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
60
+ - pt-BR em toda saída de CLI
61
+
62
+ ## 7. Riscos e mitigação
63
+ | Risco | Probabilidade | Impacto | Mitigação |
64
+ |---|---|---|---|
65
+ | codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
66
+ | Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
67
+ | Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
68
+ | Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
69
+
70
+ ## 8. Métricas de sucesso
71
+ 30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.
@@ -1,54 +1,54 @@
1
- # Spec: memory-audit
2
-
3
- - **ID**: SPEC-017
4
- - **Status**: done
5
- - **Owner**: apk
6
- - **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0025 (coerência da doc — a mesma classe), ADR-0020 (core/registry)
7
-
8
- ## 1. Problema
9
-
10
- A economia de token do Forja é o `context.md` como mapa do domínio (`token:economy` mede −61%). Mas
11
- o mapa cita paths de código — "a regra mora em `domain/order.entity.ts`", "teste em
12
- `test/orders/place-order.spec.ts`". Quando o código é renomeado ou movido e o mapa não acompanha, o
13
- mapa passa a **mentir com confiança**: um agente lê o lugar errado, paga o custo, e chega à conclusão
14
- errada. Um mapa desatualizado é *pior* que mapa nenhum. Nada verifica isso hoje — vive de disciplina.
15
-
16
- ## 2. Proposta de valor
17
-
18
- O mapa deixa de poder mentir em silêncio: **todo path de código citado num `context.md` é conferido**,
19
- e uma referência pendurada reprova. É o `adr-refs` (ADR-0025) aplicado aos mapas de memória.
20
-
21
- ## 3. User stories
22
-
23
- - **Como** dev de um projeto gerado, **quero** um comando que reprove quando um mapa aponta para
24
- arquivo que não existe mais, **para que** a economia de token da memória não se volte contra mim.
25
- - **Como** CI de um projeto, **quero** rodar isso como gate, **para que** um rename sem atualizar o
26
- mapa não passe batido.
27
-
28
- ## 4. Critérios de aceite (Definition of Done)
29
-
30
- - [x] AC-1: `forja memory:audit` varre `memory/30-domains/*/context.md`, extrai os paths de código
31
- citados (entre crases, com `/` e terminando em `.ts`) e reprova (exit ≠ 0) se algum não existe.
32
- - [x] AC-2: Resolve o path em múltiplas bases (relativo ao módulo, ao `backend/`, à raiz) — um mesmo
33
- mapa cita as duas convenções (`domain/x.ts` e `test/x.spec.ts`).
34
- - [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`).
35
- - [x] AC-4: Lógica pura e testável (`lib/memory-audit.ts`); reusa `domainsOf` de `code-context`.
36
-
37
- ## 5. Escopo
38
-
39
- **Dentro**: conferir paths de código `.ts` citados nos mapas de domínio.
40
-
41
- **Fora** (explícito):
42
- - Validar que o *conteúdo* do mapa (a linguagem ubíqua, as regras) ainda bate com o código — isso é
43
- julgamento, não path. Este gate pega o path pendurado, que é o sinal barato e objetivo.
44
- - Rodar dentro do `project:smoke` — lá o projeto é recém-gerado, o mapa é fresco por definição. A
45
- divergência mapa↔código acontece com o tempo, num projeto existente; é aí que este comando roda.
46
-
47
- ## 6. NFRs / restrições
48
-
49
- - **Compatibilidade**: comando novo; não muda nada. Sem rede, sem codegraph — leitura de disco.
50
-
51
- ## 7. Métricas de sucesso
52
-
53
- Pelo menos um rename sem atualização de mapa pego antes do merge num projeto real — a prova de que a
54
- fronteira estava descoberta.
1
+ # Spec: memory-audit
2
+
3
+ - **ID**: SPEC-017
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **ADRs relacionadas**: ADR-0009 (economia de token), ADR-0025 (coerência da doc — a mesma classe), ADR-0020 (core/registry)
7
+
8
+ ## 1. Problema
9
+
10
+ A economia de token do Forja é o `context.md` como mapa do domínio (`token:economy` mede −61%). Mas
11
+ o mapa cita paths de código — "a regra mora em `domain/order.entity.ts`", "teste em
12
+ `test/orders/place-order.spec.ts`". Quando o código é renomeado ou movido e o mapa não acompanha, o
13
+ mapa passa a **mentir com confiança**: um agente lê o lugar errado, paga o custo, e chega à conclusão
14
+ errada. Um mapa desatualizado é *pior* que mapa nenhum. Nada verifica isso hoje — vive de disciplina.
15
+
16
+ ## 2. Proposta de valor
17
+
18
+ O mapa deixa de poder mentir em silêncio: **todo path de código citado num `context.md` é conferido**,
19
+ e uma referência pendurada reprova. É o `adr-refs` (ADR-0025) aplicado aos mapas de memória.
20
+
21
+ ## 3. User stories
22
+
23
+ - **Como** dev de um projeto gerado, **quero** um comando que reprove quando um mapa aponta para
24
+ arquivo que não existe mais, **para que** a economia de token da memória não se volte contra mim.
25
+ - **Como** CI de um projeto, **quero** rodar isso como gate, **para que** um rename sem atualizar o
26
+ mapa não passe batido.
27
+
28
+ ## 4. Critérios de aceite (Definition of Done)
29
+
30
+ - [x] AC-1: `forja memory:audit` varre `memory/30-domains/*/context.md`, extrai os paths de código
31
+ citados (entre crases, com `/` e terminando em `.ts`) e reprova (exit ≠ 0) se algum não existe.
32
+ - [x] AC-2: Resolve o path em múltiplas bases (relativo ao módulo, ao `backend/`, à raiz) — um mesmo
33
+ mapa cita as duas convenções (`domain/x.ts` e `test/x.spec.ts`).
34
+ - [x] AC-3: `--project <path>` aponta para outro projeto (default: `cwd`).
35
+ - [x] AC-4: Lógica pura e testável (`lib/memory-audit.ts`); reusa `domainsOf` de `code-context`.
36
+
37
+ ## 5. Escopo
38
+
39
+ **Dentro**: conferir paths de código `.ts` citados nos mapas de domínio.
40
+
41
+ **Fora** (explícito):
42
+ - Validar que o *conteúdo* do mapa (a linguagem ubíqua, as regras) ainda bate com o código — isso é
43
+ julgamento, não path. Este gate pega o path pendurado, que é o sinal barato e objetivo.
44
+ - Rodar dentro do `project:smoke` — lá o projeto é recém-gerado, o mapa é fresco por definição. A
45
+ divergência mapa↔código acontece com o tempo, num projeto existente; é aí que este comando roda.
46
+
47
+ ## 6. NFRs / restrições
48
+
49
+ - **Compatibilidade**: comando novo; não muda nada. Sem rede, sem codegraph — leitura de disco.
50
+
51
+ ## 7. Métricas de sucesso
52
+
53
+ Pelo menos um rename sem atualização de mapa pego antes do merge num projeto real — a prova de que a
54
+ fronteira estava descoberta.