forjajs 2.0.4 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (825) hide show
  1. package/.claude/agents/context-engineer.md +19 -25
  2. package/.claude/agents/governance.md +19 -55
  3. package/.claude/agents/marketing.md +19 -24
  4. package/.claude/agents/orchestrator.md +19 -31
  5. package/.claude/agents/product.md +19 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +19 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +93 -87
  12. package/.github/copilot-instructions.md +93 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +93 -87
  15. package/AGENTS.md +137 -134
  16. package/CHANGELOG.md +656 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +68 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +17 -1
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/release.js +3 -0
  353. package/dist/lib/core/risk-collect.d.ts +19 -0
  354. package/dist/lib/core/risk-collect.js +173 -0
  355. package/dist/lib/drift-sentinel.d.ts +59 -0
  356. package/dist/lib/drift-sentinel.js +126 -0
  357. package/dist/lib/generators/memory-generator.js +691 -691
  358. package/dist/lib/generators/nest-generator.js +412 -398
  359. package/dist/lib/generators/readme-generator.js +180 -180
  360. package/dist/lib/governance-report.js +39 -39
  361. package/dist/lib/llm/codex-output.d.ts +12 -0
  362. package/dist/lib/llm/codex-output.js +56 -0
  363. package/dist/lib/llm/context.d.ts +5 -0
  364. package/dist/lib/llm/context.js +17 -0
  365. package/dist/lib/llm/session.d.ts +18 -0
  366. package/dist/lib/llm/session.js +34 -0
  367. package/dist/lib/llm/validation.d.ts +37 -0
  368. package/dist/lib/llm/validation.js +88 -0
  369. package/dist/lib/workspace.js +29 -29
  370. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  371. package/dist/packages/adapter-git/src/index.js +11 -6
  372. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  373. package/dist/packages/adapter-nest/src/index.js +26 -1
  374. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  375. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  376. package/dist/packages/contracts/src/index.d.ts +33 -0
  377. package/dist/packages/contracts/src/index.js +13 -0
  378. package/dist/packages/core/src/index.d.ts +12 -0
  379. package/dist/packages/core/src/index.js +29 -0
  380. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  381. package/dist/packages/engineering/architecture/src/index.js +131 -0
  382. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  383. package/dist/packages/engineering/evidence/src/index.js +31 -0
  384. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  385. package/dist/packages/engineering/identity/src/index.js +88 -0
  386. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  387. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  388. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  389. package/dist/packages/engineering/provenance/src/index.js +21 -0
  390. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  391. package/dist/packages/engineering/risk/src/index.js +120 -0
  392. package/dist/packages/evals/src/index.js +6 -0
  393. package/dist/packages/graph/src/index.d.ts +23 -1
  394. package/dist/packages/graph/src/index.js +88 -15
  395. package/dist/packages/llm/src/index.d.ts +8 -1
  396. package/dist/packages/llm/src/index.js +64 -7
  397. package/dist/packages/mcp/src/index.js +27 -8
  398. package/dist/packages/orchestration/src/index.d.ts +11 -1
  399. package/dist/packages/orchestration/src/index.js +34 -7
  400. package/dist/packages/policy/src/index.d.ts +40 -0
  401. package/dist/packages/policy/src/index.js +39 -4
  402. package/dist/packages/runtime/src/index.js +3 -0
  403. package/dist/packages/sandbox/src/index.d.ts +47 -0
  404. package/dist/packages/sandbox/src/index.js +59 -0
  405. package/dist/packages/validator/src/index.d.ts +8 -0
  406. package/dist/packages/validator/src/index.js +21 -6
  407. package/dist/scripts/adr.d.ts +17 -0
  408. package/dist/scripts/adr.js +152 -0
  409. package/dist/scripts/agent-harness.js +72 -64
  410. package/dist/scripts/agent-router.js +20 -20
  411. package/dist/scripts/agent.d.ts +27 -0
  412. package/dist/scripts/agent.js +249 -0
  413. package/dist/scripts/architecture.d.ts +16 -0
  414. package/dist/scripts/architecture.js +186 -0
  415. package/dist/scripts/build-smart-context.js +22 -22
  416. package/dist/scripts/compress-memory.js +8 -8
  417. package/dist/scripts/context-ops.js +29 -29
  418. package/dist/scripts/cost-economy.d.ts +2 -0
  419. package/dist/scripts/cost-economy.js +79 -0
  420. package/dist/scripts/demo-autonomy.js +13 -6
  421. package/dist/scripts/dev.js +13 -13
  422. package/dist/scripts/drift-check.d.ts +17 -0
  423. package/dist/scripts/drift-check.js +63 -0
  424. package/dist/scripts/engineer.d.ts +20 -0
  425. package/dist/scripts/engineer.js +208 -0
  426. package/dist/scripts/evidence.d.ts +12 -0
  427. package/dist/scripts/evidence.js +55 -0
  428. package/dist/scripts/extract-global-knowledge.js +5 -5
  429. package/dist/scripts/gates.d.ts +6 -2
  430. package/dist/scripts/gates.js +14 -4
  431. package/dist/scripts/generate-dashboard.js +11 -11
  432. package/dist/scripts/incident.d.ts +19 -0
  433. package/dist/scripts/incident.js +103 -0
  434. package/dist/scripts/llm-fit.js +85 -9
  435. package/dist/scripts/memory-schema.js +48 -48
  436. package/dist/scripts/provenance.d.ts +14 -0
  437. package/dist/scripts/provenance.js +114 -0
  438. package/dist/scripts/query-universal-memory.js +13 -13
  439. package/dist/scripts/risk.d.ts +15 -0
  440. package/dist/scripts/risk.js +81 -0
  441. package/dist/scripts/simulate.d.ts +20 -0
  442. package/dist/scripts/simulate.js +150 -0
  443. package/dist/scripts/sprint-manager.js +39 -39
  444. package/dist/scripts/sync-universal-memory.js +44 -44
  445. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  446. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  447. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  448. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  449. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  450. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  451. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  452. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  453. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  454. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  455. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  456. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  457. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  458. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  459. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  460. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  461. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  462. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  463. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  464. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  465. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  466. package/docs/agent-harnesses.md +149 -149
  467. package/docs/agent-operating-contract.md +26 -0
  468. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  469. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  470. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  471. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  472. package/docs/archive/FASE2-SUMMARY.md +263 -263
  473. package/docs/archive/FASE3-PROGRESS.md +355 -355
  474. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  475. package/docs/archive/INDICE-MASTER.md +282 -282
  476. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  477. package/docs/archive/README-REFINAMENTO.md +293 -293
  478. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  479. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  480. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  481. package/docs/archive/START-HERE.md +319 -319
  482. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  483. package/docs/archive/examples/v1/AGENTS.md +10 -10
  484. package/docs/archive/examples/v1/README.md +36 -36
  485. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  486. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  487. package/docs/archive/examples/v1/backend/package.json +42 -42
  488. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  489. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  490. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  491. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  492. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  493. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  494. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  495. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  496. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  497. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  498. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  499. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  501. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  502. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  503. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  504. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  505. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  506. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  507. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  508. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  509. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  510. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  511. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  512. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  513. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  514. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  515. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  516. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  517. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  518. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  519. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  520. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  521. package/docs/archive/examples/v2/AGENTS.md +16 -16
  522. package/docs/archive/examples/v2/README.md +35 -35
  523. package/docs/archive/examples/v2/agents/README.md +3 -3
  524. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  525. package/docs/archive/examples/v2/agents/dba.md +4 -4
  526. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  527. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  528. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  529. package/docs/archive/examples/v2/agents/security.md +4 -4
  530. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  531. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  532. package/docs/archive/examples/v2/backend/package.json +42 -42
  533. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  534. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  535. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  536. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  537. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  538. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  539. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  540. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  541. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  542. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  543. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  544. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  545. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  547. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  548. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  549. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  550. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  551. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  552. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  553. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  554. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  555. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  556. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  557. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  558. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  559. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  560. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  561. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  562. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  563. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  564. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  565. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  566. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  567. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  568. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  569. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  570. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  571. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  572. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  573. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  574. package/docs/archive/examples/v2/memory/README.md +8 -8
  575. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  576. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  577. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  578. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  579. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  580. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  581. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  582. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  583. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  584. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  585. package/docs/capacidades-externas.md +86 -86
  586. package/docs/cli-first-operacao.md +74 -74
  587. package/docs/dev-workflow.md +421 -421
  588. package/docs/examples.md +546 -546
  589. package/docs/fluxo.md +103 -103
  590. package/docs/glossary.md +453 -453
  591. package/docs/init-project.md +457 -457
  592. package/docs/llm-evolution.md +51 -0
  593. package/docs/llm-fit-loop.md +134 -5
  594. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  595. package/docs/personas/architect/README.md +333 -333
  596. package/docs/personas/developer/README.md +371 -371
  597. package/docs/personas/executive/README.md +172 -172
  598. package/docs/personas/qa/README.md +350 -350
  599. package/docs/processo-projeto.md +138 -138
  600. package/docs/publishing.md +49 -377
  601. package/docs/quick-reference.md +409 -409
  602. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  603. package/docs/structure.md +360 -360
  604. package/docs/token-optimization.md +502 -502
  605. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  606. package/memory/00-global/mission.md +15 -15
  607. package/memory/00-global/shared-knowledge.md +8 -8
  608. package/memory/00-global/standards.md +47 -47
  609. package/memory/10-product/personas.md +21 -21
  610. package/memory/10-product/vision.md +27 -27
  611. package/memory/30-projects/README.md +15 -15
  612. package/memory/40-delivery/backlog.md +15 -15
  613. package/memory/40-delivery/current-sprint.md +20 -20
  614. package/memory/50-orchestration/gsd-harness.md +55 -55
  615. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  616. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  617. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  618. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  619. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  620. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  621. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  622. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  623. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  624. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  625. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  626. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  627. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  628. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  630. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  631. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  632. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  633. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  634. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  635. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  637. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  638. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  639. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  640. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  641. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  642. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  643. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  644. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  645. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  646. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  647. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  648. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  649. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  650. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  651. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  652. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  653. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  654. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  655. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  656. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  657. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  658. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  659. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  660. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  661. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  662. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  663. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  664. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  665. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  666. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  667. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  668. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  669. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  670. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  671. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  672. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  673. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  674. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  675. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  676. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  677. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  678. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  679. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  680. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  681. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  682. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  683. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  684. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  685. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  686. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  687. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  688. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  689. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  690. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  691. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  692. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  693. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  694. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  695. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  696. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  697. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  698. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  699. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  700. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  701. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  702. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  703. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  704. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  705. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  706. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  707. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  708. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  709. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  710. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  711. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  712. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  713. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  714. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  715. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  716. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  717. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  718. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  719. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  720. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  721. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  722. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  723. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  724. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  725. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  726. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  727. package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
  728. package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
  729. package/memory/90-decisions/_template.md +28 -28
  730. package/package.json +159 -157
  731. package/prompts/context-engineer-agent.md +13 -19
  732. package/prompts/governance-agent.md +13 -16
  733. package/prompts/marketing-agent.md +13 -13
  734. package/prompts/orchestrator-agent.md +13 -18
  735. package/prompts/product-agent.md +13 -13
  736. package/prompts/sdd-architect-agent.md +13 -20
  737. package/skills/MANIFEST.json +10 -0
  738. package/skills/llm-provider-routing/SKILL.md +18 -0
  739. package/specs/README.md +70 -70
  740. package/specs/_templates/plan.md +50 -43
  741. package/specs/_templates/spec.md +50 -43
  742. package/specs/_templates/tasks.md +39 -32
  743. package/specs/agent-identity-reputation/plan.md +133 -0
  744. package/specs/agent-identity-reputation/spec.md +125 -0
  745. package/specs/agent-identity-reputation/tasks.md +51 -0
  746. package/specs/agent-instructions-v4/plan.md +8 -0
  747. package/specs/agent-instructions-v4/spec.md +21 -0
  748. package/specs/agent-instructions-v4/tasks.md +12 -0
  749. package/specs/agent-runtime-monitoring/plan.md +78 -0
  750. package/specs/agent-runtime-monitoring/spec.md +92 -0
  751. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  752. package/specs/ai-code-provenance/plan.md +71 -0
  753. package/specs/ai-code-provenance/spec.md +97 -0
  754. package/specs/ai-code-provenance/tasks.md +39 -0
  755. package/specs/architecture-constitution/plan.md +110 -0
  756. package/specs/architecture-constitution/spec.md +114 -0
  757. package/specs/architecture-constitution/tasks.md +58 -0
  758. package/specs/change-risk-engine/plan.md +130 -0
  759. package/specs/change-risk-engine/spec.md +119 -0
  760. package/specs/change-risk-engine/tasks.md +72 -0
  761. package/specs/clean-arch-boilerplate/plan.md +137 -137
  762. package/specs/clean-arch-boilerplate/spec.md +121 -121
  763. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  764. package/specs/cli-first-operacao/plan.md +53 -53
  765. package/specs/cli-first-operacao/spec.md +53 -53
  766. package/specs/cli-first-operacao/tasks.md +53 -53
  767. package/specs/code-context/spec.md +56 -56
  768. package/specs/coerencia-do-sistema/plan.md +155 -155
  769. package/specs/coerencia-do-sistema/spec.md +123 -123
  770. package/specs/coerencia-do-sistema/tasks.md +115 -115
  771. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  772. package/specs/dev-token-assets-db/plan.md +71 -71
  773. package/specs/dev-token-assets-db/spec.md +58 -58
  774. package/specs/dev-token-assets-db/tasks.md +58 -58
  775. package/specs/doctor-do-nucleo/plan.md +165 -165
  776. package/specs/doctor-do-nucleo/spec.md +139 -139
  777. package/specs/doctor-do-nucleo/tasks.md +172 -172
  778. package/specs/drift-sentinel/spec.md +117 -0
  779. package/specs/engineer-facade-extension/plan.md +71 -0
  780. package/specs/engineer-facade-extension/spec.md +98 -0
  781. package/specs/engineer-facade-extension/tasks.md +36 -0
  782. package/specs/engineering-evidence-ledger/plan.md +121 -0
  783. package/specs/engineering-evidence-ledger/spec.md +90 -0
  784. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  785. package/specs/engineering-graph-extensions/plan.md +92 -0
  786. package/specs/engineering-graph-extensions/spec.md +101 -0
  787. package/specs/engineering-graph-extensions/tasks.md +60 -0
  788. package/specs/engineering-intelligence/spec.md +177 -0
  789. package/specs/forja-core/spec.md +71 -71
  790. package/specs/gates/spec.md +63 -63
  791. package/specs/governanca-visivel/plan.md +122 -122
  792. package/specs/governanca-visivel/spec.md +112 -112
  793. package/specs/governanca-visivel/tasks.md +60 -60
  794. package/specs/harness-codegraph/spec.md +71 -71
  795. package/specs/learning-loop-incidents/plan.md +59 -0
  796. package/specs/learning-loop-incidents/spec.md +93 -0
  797. package/specs/learning-loop-incidents/tasks.md +36 -0
  798. package/specs/llm-integration-v2/plan.md +55 -0
  799. package/specs/llm-integration-v2/spec.md +61 -0
  800. package/specs/llm-integration-v2/tasks.md +28 -0
  801. package/specs/llm-resume-validation/plan.md +50 -0
  802. package/specs/llm-resume-validation/spec.md +35 -0
  803. package/specs/llm-resume-validation/tasks.md +19 -0
  804. package/specs/memory-audit/spec.md +54 -54
  805. package/specs/orchestrate/spec.md +108 -108
  806. package/specs/orchestration-coherent/spec.md +95 -95
  807. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  808. package/specs/predictive-change-simulation/plan.md +109 -0
  809. package/specs/predictive-change-simulation/spec.md +107 -0
  810. package/specs/predictive-change-simulation/tasks.md +41 -0
  811. package/specs/project-smoke/spec.md +96 -96
  812. package/specs/project-upgrade/spec.md +58 -58
  813. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  814. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  815. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  816. package/specs/release-auditor-health/spec.md +23 -23
  817. package/specs/release-gate/plan.md +174 -174
  818. package/specs/release-gate/spec.md +122 -122
  819. package/specs/release-gate/tasks.md +183 -183
  820. package/specs/smart-agent-routing/plan.md +55 -0
  821. package/specs/smart-agent-routing/spec.md +85 -0
  822. package/specs/smart-agent-routing/tasks.md +26 -0
  823. package/specs/ts-migration/plan.md +200 -200
  824. package/specs/ts-migration/spec.md +119 -119
  825. package/specs/ts-migration/tasks.md +110 -110
@@ -1,63 +1,63 @@
1
- # Spec: gates
2
-
3
- - **ID**: SPEC-020
4
- - **Status**: done
5
- - **Owner**: apk
6
- - **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
7
-
8
- ## 1. Problema
9
-
10
- O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
11
- `release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
12
- **espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
13
- justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
14
- É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
15
-
16
- ## 2. Proposta de valor
17
-
18
- Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
19
- coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
20
-
21
- ## 3. User stories
22
-
23
- - **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
24
- não esqueça um gate e descubra a quebra no CI (ou depois).
25
- - **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
26
- **para que** o pré-release seja um comando, não um checklist.
27
-
28
- ## 4. Critérios de aceite (Definition of Done)
29
-
30
- - [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
31
- `project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
32
- - [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
33
- (instala + builda o backend gerado).
34
- - [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
35
- pior status ao final — legível, não um despejo.
36
- - [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
37
- zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
38
- - [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
39
- devolvem status conhecidos, sem gerar projeto de verdade).
40
-
41
- ## 5. Escopo
42
-
43
- **Dentro**: compor os gates do framework num comando com veredito único e tiers.
44
-
45
- **Fora** (explícito):
46
- - `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
47
- framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
48
- - Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
49
- - Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
50
- `check:all` é o agregador, não o dono.
51
-
52
- ## 6. NFRs / restrições
53
-
54
- - **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
55
- rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
56
- momento certo, como no `release:check`.
57
- - **Compatibilidade**: comando novo; não muda os gates que agrega.
58
-
59
- ## 7. Métricas de sucesso
60
-
61
- Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
62
- reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
63
- gates rodar.
1
+ # Spec: gates
2
+
3
+ - **ID**: SPEC-020
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **ADRs relacionadas**: ADR-0023 (doctor como gate), ADR-0024 (release gate), ADR-0029 (project:smoke), ADR-0020 (core/registry)
7
+
8
+ ## 1. Problema
9
+
10
+ O framework acumulou uma família de gates — `tools:doctor` (núcleo + coerência de doc + topologia),
11
+ `release:check` (tarball), `project:smoke` (projeto gerado). Cada um guarda uma fronteira, mas estão
12
+ **espalhados**: ninguém lembra de rodar os três antes de um PR, e a governança do Forja — que existe
13
+ justamente para não depender de memória — depende da memória de quem publica para *invocar* os gates.
14
+ É a mesma ironia do ADR-0021, um nível acima: os gates existem, mas rodá-los ainda é disciplina.
15
+
16
+ ## 2. Proposta de valor
17
+
18
+ Um comando roda **todos os gates aplicáveis ao framework** e dá **um veredito só**. "A casa está
19
+ coerente?" deixa de ser quatro comandos lembrados e vira um: `forja check:all`.
20
+
21
+ ## 3. User stories
22
+
23
+ - **Como** mantenedor, **quero** um comando que rode a bateria inteira antes do PR, **para que** eu
24
+ não esqueça um gate e descubra a quebra no CI (ou depois).
25
+ - **Como** quem publica, **quero** `--full` que inclua os gates caros (tarball, build do gerado),
26
+ **para que** o pré-release seja um comando, não um checklist.
27
+
28
+ ## 4. Critérios de aceite (Definition of Done)
29
+
30
+ - [ ] AC-1: `forja check:all` roda os gates de coerência (o catálogo do `tools:doctor`) **+** o
31
+ `project:smoke` (tier barato) e reporta **um veredito** (exit ≠ 0 se qualquer crítico falhar).
32
+ - [ ] AC-2: `--full` adiciona os gates caros: `release:check` (tarball) e `project:smoke --full`
33
+ (instala + builda o backend gerado).
34
+ - [ ] AC-3: A saída **agrupa por gate** (núcleo & coerência / projeto gerado / tarball) e resume o
35
+ pior status ao final — legível, não um despejo.
36
+ - [ ] AC-4: **Compõe os runners existentes** (`health`, `project-smoke`, `release`) — uma máquina,
37
+ zero reimplementação de check. Reusa `worstStatus` de `checks.ts`.
38
+ - [ ] AC-5: Lógica de composição pura e testável (env/runners injetáveis; teste com fakes que
39
+ devolvem status conhecidos, sem gerar projeto de verdade).
40
+
41
+ ## 5. Escopo
42
+
43
+ **Dentro**: compor os gates do framework num comando com veredito único e tiers.
44
+
45
+ **Fora** (explícito):
46
+ - `memory:audit` — é gate de **projeto gerado** (precisa de `memory/30-domains` de produto), não do
47
+ framework. Fica de fora do `check:all` do framework; roda no CI do projeto (ADR-0030).
48
+ - Reimplementar qualquer check — este comando só orquestra os catálogos que já existem.
49
+ - Substituir `tools:doctor`/`release:check`/`project:smoke` — eles seguem existindo, focados; o
50
+ `check:all` é o agregador, não o dono.
51
+
52
+ ## 6. NFRs / restrições
53
+
54
+ - **Custo consciente**: o tier barato inclui a geração de um projeto (`project:smoke`) — segundos, sem
55
+ rede. O `--full` é minutos (empacota o tarball, `npm install` do backend). O tier certo para o
56
+ momento certo, como no `release:check`.
57
+ - **Compatibilidade**: comando novo; não muda os gates que agrega.
58
+
59
+ ## 7. Métricas de sucesso
60
+
61
+ Um `forja check:all` antes do PR pega uma quebra que passaria (um gate esquecido) — a prova de que
62
+ reunir a bateria num comando valeu. A governança do framework deixa de depender de lembrar quais
63
+ gates rodar.
@@ -1,122 +1,122 @@
1
- # Plan: governanca-visivel
2
-
3
- - **Spec**: ./spec.md
4
- - **Status**: done
5
- - **Criado em**: 2026-07-19
6
-
7
- > Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
8
-
9
- ## 1. Abordagem técnica
10
-
11
- Três comandos no domínio `governanca`, todos passando pelo core (auditados como os demais):
12
-
13
- - `audit:sync` — ingest do `.context/forja-runs.jsonl` (fonte de verdade append-only) numa tabela
14
- `audit_runs` do `universal.db` do workspace. A tabela é **projeção reconstruível**: o `.jsonl`
15
- manda.
16
- - `audit:query` — consulta estruturada (`--since`, `--cmd`, `--gate`, `--failed`).
17
- - `governance:dashboard` — gera um HTML **estático e self-contained** de governança.
18
-
19
- O painel **não executa nada** — lê specs, ADRs e a tabela de auditoria e escreve um arquivo. É a
20
- resposta correta ao ADR-0022: o dashboard antigo era servidor com rotas; este é um *artefato*, como
21
- o `project:dashboard` já é (só que HTML e sobre governança). O design do HTML reaproveita o protótipo
22
- já validado nesta sessão.
23
-
24
- ## 2. Módulos afetados
25
-
26
- | Caminho | Mudança | Risco |
27
- |---|---|---|
28
- | `scripts/memory-schema.mjs` | criar tabela `audit_runs` (+ índices) | B |
29
- | `lib/audit.mjs` | **criar** — ingest do jsonl + queries (puro, testável) | M |
30
- | `scripts/audit-sync.mjs` · `scripts/audit-query.mjs` | **criar** — CLIs finos sobre `lib/audit.mjs` | B |
31
- | `lib/governance-report.mjs` | **criar** — coleta (specs/ADRs/audit/métricas) + render HTML self-contained | M |
32
- | `scripts/governance-dashboard.mjs` | **criar** — CLI que escreve o arquivo | B |
33
- | `lib/core/registry.mjs` | 3 entradas novas (`governanca`) | B |
34
- | `test/audit.test.js` · `test/governance-report.test.js` | **criar** | B |
35
- | `memory/90-decisions/0028-*.md` | **criar** — ADR | B |
36
-
37
- Risco mora na coleta (`governance-report`): ler dados reais sem quebrar quando faltam (repo sem runs,
38
- sem workspace). A renderização é mecânica; o design já está provado.
39
-
40
- ## 3. Fluxo
41
-
42
- ```
43
- .context/forja-runs.jsonl ──audit:sync──► audit_runs (universal.db)
44
- (append-only, verdade) │
45
- ├──► audit:query (--since/--cmd/--failed)
46
- │
47
- specs/* + memory/90-decisions/* + registry ─┴──► governance:dashboard
48
- │
49
- ▼
50
- governance.html (estático, file://)
51
- zero rota · zero processo · leitura
52
- ```
53
-
54
- ## 4. Contratos
55
-
56
- ```js
57
- // lib/audit.mjs — puro, env injetável ({ fs, dbPath, jsonlPath })
58
- export function syncAudit(env); // jsonl → audit_runs; idempotente. -> { ingested, total }
59
- export function queryAudit(env, { since, cmd, gate, failed }); // -> Run[]
60
- export function auditSummary(env); // p/ o painel: { total, fails, byCmd, slowest, recent }
61
-
62
- // lib/governance-report.mjs — puro, devolve string HTML
63
- export function collect(env); // { specs, adrs, gates, audit, metrics }
64
- export function renderHtml(data); // -> HTML self-contained (CSS/JS inline, zero asset externo)
65
- ```
66
-
67
- **Schema `audit_runs`**: `line_hash TEXT PRIMARY KEY` (idempotência — hash da linha do jsonl),
68
- `ts TEXT`, `cmd TEXT`, `args TEXT` (json), `exit_code INTEGER`, `duration_ms INTEGER`. Índices em
69
- `cmd` e `ts`. Sem FTS5: o dado é colunar; query por coluna basta (D3).
70
-
71
- ## 5. Decisões e alternativas
72
-
73
- **D1: A tabela é projeção; o `.jsonl` é a verdade.** `audit:sync` reconstrói do zero a qualquer
74
- momento. Alternativa rejeitada: gravar direto no SQLite no core — acoplaria toda execução ao banco
75
- (e o banco pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é derivada.
76
-
77
- **D2: Idempotência por `line_hash`, não por cursor.** Hash do conteúdo da linha como PK + `INSERT OR
78
- IGNORE`. Robusto a re-sync e a truncamento do jsonl. Um cursor (contar linhas) quebra se o arquivo
79
- for reescrito.
80
-
81
- **D3: SQL estruturado, não FTS5.** O dado é `{cmd, exit, duração, ts}` — colunar. Query por coluna e
82
- janela de tempo resolve as perguntas reais ("release:check reprovou quantas vezes"). FTS5 seria
83
- over-engineering aqui; entra só se a busca por texto livre em `args` provar valer.
84
-
85
- **D4: O painel não executa gates — lê o último resultado da auditoria.** Rodar `tools:doctor`/
86
- `release:check` na geração seria lento e com efeito colateral. O painel mostra os checks de cada
87
- catálogo (de `health`/`release`) + o **último exit** daquele comando na auditoria. Estado real, sem
88
- reexecutar. Reforça o AC-4 (zero processo).
89
-
90
- **D5: Comando novo, não estender `project:dashboard`.** O `project:dashboard` é markdown sobre o
91
- ecossistema de projetos; este é HTML sobre a saúde do framework. Fundir confundiria dois públicos.
92
- Coexistem (spec §5).
93
-
94
- **D6: HTML self-contained, reaproveitando o protótipo.** CSS/JS inline, zero asset externo — abre com
95
- `file://`. O design (gates, quadro SDD, métricas, tema claro/escuro) já foi validado como artifact
96
- nesta sessão; vira template do gerador.
97
-
98
- D1, D4 e D5 são estruturais → **ADR-0028** (auditoria consultável; painel estático-gerado como a
99
- resposta correta ao ADR-0022), referenciando ADR-0022, ADR-0020 e ADR-0021.
100
-
101
- ## 6. Dependências
102
-
103
- - **Specs**: nenhuma bloqueante. Usa o `universal.db` (SPEC-009/reestruturacao) e o audit (ADR-0020).
104
- - **Pacotes**: **nenhum novo.** `better-sqlite3` (já runtime dep) + `node:fs`. HTML é string.
105
- - **Migrações**: `audit_runs` é `CREATE TABLE IF NOT EXISTS` — aditivo, sem migração de dado.
106
-
107
- ## 7. Rollout
108
-
109
- - [ ] Schema `audit_runs` + `lib/audit.mjs` (sync/query/summary) + testes, com env injetável.
110
- - [ ] `audit:sync` e `audit:query` no registry; provar contra os 255 runs reais do workspace.
111
- - [ ] `lib/governance-report.mjs` (coleta + render) + `governance:dashboard`; abrir o HTML e conferir.
112
- - [ ] Degradação (AC-6): sem workspace/db, avisa e segue. Repo sem runs → "sem atividade", não quebra.
113
- - [ ] ADR-0028; gates (`release:check`, `tools:doctor`, `npm test`).
114
-
115
- ## 8. Sinais de fracasso (kill criteria)
116
-
117
- - **Qualquer coisa que execute na geração do painel** — se o gerador rodar um gate ou abrir um
118
- processo, virou a SPEC-002 de novo. O painel só lê e escreve um arquivo (AC-4).
119
- - **O HTML puxa asset externo** (CDN, fonte, imagem remota) — quebra o "abre com `file://`". Tudo
120
- inline.
121
- - **A tabela vira a fonte de verdade** — se alguém passar a gravar só no SQLite e largar o `.jsonl`,
122
- perdemos a resiliência do log em arquivo (D1). A tabela é sempre derivável.
1
+ # Plan: governanca-visivel
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: done
5
+ - **Criado em**: 2026-07-19
6
+
7
+ > Como vamos construir o que a spec define. Sem código aqui — só estrutura e decisões.
8
+
9
+ ## 1. Abordagem técnica
10
+
11
+ Três comandos no domínio `governanca`, todos passando pelo core (auditados como os demais):
12
+
13
+ - `audit:sync` — ingest do `.context/forja-runs.jsonl` (fonte de verdade append-only) numa tabela
14
+ `audit_runs` do `universal.db` do workspace. A tabela é **projeção reconstruível**: o `.jsonl`
15
+ manda.
16
+ - `audit:query` — consulta estruturada (`--since`, `--cmd`, `--gate`, `--failed`).
17
+ - `governance:dashboard` — gera um HTML **estático e self-contained** de governança.
18
+
19
+ O painel **não executa nada** — lê specs, ADRs e a tabela de auditoria e escreve um arquivo. É a
20
+ resposta correta ao ADR-0022: o dashboard antigo era servidor com rotas; este é um *artefato*, como
21
+ o `project:dashboard` já é (só que HTML e sobre governança). O design do HTML reaproveita o protótipo
22
+ já validado nesta sessão.
23
+
24
+ ## 2. Módulos afetados
25
+
26
+ | Caminho | Mudança | Risco |
27
+ |---|---|---|
28
+ | `scripts/memory-schema.mjs` | criar tabela `audit_runs` (+ índices) | B |
29
+ | `lib/audit.mjs` | **criar** — ingest do jsonl + queries (puro, testável) | M |
30
+ | `scripts/audit-sync.mjs` · `scripts/audit-query.mjs` | **criar** — CLIs finos sobre `lib/audit.mjs` | B |
31
+ | `lib/governance-report.mjs` | **criar** — coleta (specs/ADRs/audit/métricas) + render HTML self-contained | M |
32
+ | `scripts/governance-dashboard.mjs` | **criar** — CLI que escreve o arquivo | B |
33
+ | `lib/core/registry.mjs` | 3 entradas novas (`governanca`) | B |
34
+ | `test/audit.test.js` · `test/governance-report.test.js` | **criar** | B |
35
+ | `memory/90-decisions/0028-*.md` | **criar** — ADR | B |
36
+
37
+ Risco mora na coleta (`governance-report`): ler dados reais sem quebrar quando faltam (repo sem runs,
38
+ sem workspace). A renderização é mecânica; o design já está provado.
39
+
40
+ ## 3. Fluxo
41
+
42
+ ```
43
+ .context/forja-runs.jsonl ──audit:sync──► audit_runs (universal.db)
44
+ (append-only, verdade) │
45
+ ├──► audit:query (--since/--cmd/--failed)
46
+ │
47
+ specs/* + memory/90-decisions/* + registry ─┴──► governance:dashboard
48
+ │
49
+ ▼
50
+ governance.html (estático, file://)
51
+ zero rota · zero processo · leitura
52
+ ```
53
+
54
+ ## 4. Contratos
55
+
56
+ ```js
57
+ // lib/audit.mjs — puro, env injetável ({ fs, dbPath, jsonlPath })
58
+ export function syncAudit(env); // jsonl → audit_runs; idempotente. -> { ingested, total }
59
+ export function queryAudit(env, { since, cmd, gate, failed }); // -> Run[]
60
+ export function auditSummary(env); // p/ o painel: { total, fails, byCmd, slowest, recent }
61
+
62
+ // lib/governance-report.mjs — puro, devolve string HTML
63
+ export function collect(env); // { specs, adrs, gates, audit, metrics }
64
+ export function renderHtml(data); // -> HTML self-contained (CSS/JS inline, zero asset externo)
65
+ ```
66
+
67
+ **Schema `audit_runs`**: `line_hash TEXT PRIMARY KEY` (idempotência — hash da linha do jsonl),
68
+ `ts TEXT`, `cmd TEXT`, `args TEXT` (json), `exit_code INTEGER`, `duration_ms INTEGER`. Índices em
69
+ `cmd` e `ts`. Sem FTS5: o dado é colunar; query por coluna basta (D3).
70
+
71
+ ## 5. Decisões e alternativas
72
+
73
+ **D1: A tabela é projeção; o `.jsonl` é a verdade.** `audit:sync` reconstrói do zero a qualquer
74
+ momento. Alternativa rejeitada: gravar direto no SQLite no core — acoplaria toda execução ao banco
75
+ (e o banco pode estar morto, ADR-0021). O log em arquivo é resiliente; a tabela é derivada.
76
+
77
+ **D2: Idempotência por `line_hash`, não por cursor.** Hash do conteúdo da linha como PK + `INSERT OR
78
+ IGNORE`. Robusto a re-sync e a truncamento do jsonl. Um cursor (contar linhas) quebra se o arquivo
79
+ for reescrito.
80
+
81
+ **D3: SQL estruturado, não FTS5.** O dado é `{cmd, exit, duração, ts}` — colunar. Query por coluna e
82
+ janela de tempo resolve as perguntas reais ("release:check reprovou quantas vezes"). FTS5 seria
83
+ over-engineering aqui; entra só se a busca por texto livre em `args` provar valer.
84
+
85
+ **D4: O painel não executa gates — lê o último resultado da auditoria.** Rodar `tools:doctor`/
86
+ `release:check` na geração seria lento e com efeito colateral. O painel mostra os checks de cada
87
+ catálogo (de `health`/`release`) + o **último exit** daquele comando na auditoria. Estado real, sem
88
+ reexecutar. Reforça o AC-4 (zero processo).
89
+
90
+ **D5: Comando novo, não estender `project:dashboard`.** O `project:dashboard` é markdown sobre o
91
+ ecossistema de projetos; este é HTML sobre a saúde do framework. Fundir confundiria dois públicos.
92
+ Coexistem (spec §5).
93
+
94
+ **D6: HTML self-contained, reaproveitando o protótipo.** CSS/JS inline, zero asset externo — abre com
95
+ `file://`. O design (gates, quadro SDD, métricas, tema claro/escuro) já foi validado como artifact
96
+ nesta sessão; vira template do gerador.
97
+
98
+ D1, D4 e D5 são estruturais → **ADR-0028** (auditoria consultável; painel estático-gerado como a
99
+ resposta correta ao ADR-0022), referenciando ADR-0022, ADR-0020 e ADR-0021.
100
+
101
+ ## 6. Dependências
102
+
103
+ - **Specs**: nenhuma bloqueante. Usa o `universal.db` (SPEC-009/reestruturacao) e o audit (ADR-0020).
104
+ - **Pacotes**: **nenhum novo.** `better-sqlite3` (já runtime dep) + `node:fs`. HTML é string.
105
+ - **Migrações**: `audit_runs` é `CREATE TABLE IF NOT EXISTS` — aditivo, sem migração de dado.
106
+
107
+ ## 7. Rollout
108
+
109
+ - [ ] Schema `audit_runs` + `lib/audit.mjs` (sync/query/summary) + testes, com env injetável.
110
+ - [ ] `audit:sync` e `audit:query` no registry; provar contra os 255 runs reais do workspace.
111
+ - [ ] `lib/governance-report.mjs` (coleta + render) + `governance:dashboard`; abrir o HTML e conferir.
112
+ - [ ] Degradação (AC-6): sem workspace/db, avisa e segue. Repo sem runs → "sem atividade", não quebra.
113
+ - [ ] ADR-0028; gates (`release:check`, `tools:doctor`, `npm test`).
114
+
115
+ ## 8. Sinais de fracasso (kill criteria)
116
+
117
+ - **Qualquer coisa que execute na geração do painel** — se o gerador rodar um gate ou abrir um
118
+ processo, virou a SPEC-002 de novo. O painel só lê e escreve um arquivo (AC-4).
119
+ - **O HTML puxa asset externo** (CDN, fonte, imagem remota) — quebra o "abre com `file://`". Tudo
120
+ inline.
121
+ - **A tabela vira a fonte de verdade** — se alguém passar a gravar só no SQLite e largar o `.jsonl`,
122
+ perdemos a resiliência do log em arquivo (D1). A tabela é sempre derivável.
@@ -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.