forjajs 2.0.4 → 3.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 (798) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -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 +15 -0
  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/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
@@ -0,0 +1,117 @@
1
+ # Spec: Drift Sentinel — verificação contínua de que o verificado continua verdade
2
+
3
+ - **ID**: SPEC-030
4
+ - **Status**: implementing
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-08-31
7
+ - **Sprint alvo**: <a definir>
8
+ - **Implementação**: `lib/drift-sentinel.ts` (motor), `scripts/drift-check.ts` (CLI, `forja drift:check
9
+ [--domain <d>]`), `lib/core/drift-gate.ts` + `lib/core/gates.ts`/`scripts/gates.ts`
10
+ (`check:all --with-drift`, AC-5). AC-1 a AC-4 completos, com testes em
11
+ `test/drift-sentinel.test.js`. AC-5 implementado com escopo reduzido: em vez de restruturar
12
+ `runGates`/`CHECKS` para rodar `drift:check` in-process, o gate opt-in chama o comando real via
13
+ subprocess (mesmo padrão de `lib/core/release.ts`/`project-smoke.ts`) e traduz o resultado —
14
+ mantém `check:all` desacoplado do wiring do grafo (SQLite/git) sem tocar o contrato do runner de
15
+ checks. Não marcado `done` porque a métrica de sucesso do §8 (drift genuíno encontrado em projeto
16
+ real, confirmado por humano, 30 dias após o release) ainda não foi observada — só dogfooding
17
+ local contra o próprio monorepo, que não achou drift real algum ainda.
18
+ - **ADRs relacionadas**: nenhuma ainda — nasce da auditoria de segurança de 2026-08-31, que corrigiu
19
+ `packages/graph` para que `status: 'verified'` só venha de fontes de evidência confiáveis
20
+ (`deterministic-extractor`, `sandbox.*`). Este spec é a continuação natural: **verified é um
21
+ instantâneo, não uma garantia permanente.**
22
+
23
+ ## 1. Problema
24
+
25
+ O GraphLoop agora distingue de verdade `verified` de `inferred`/`hypothesis` (a auditoria fechou o
26
+ buraco onde qualquer chamador podia se autodeclarar "verificado"). Mas isso resolve só metade do
27
+ problema: **um nó ou aresta `verified` continua marcado `verified` para sempre**, mesmo que o código
28
+ que o originou tenha mudado depois. `GraphIndexer.sync` já é idempotente por checksum de fonte
29
+ (`apply()` pula quando `sourceChecksum` não mudou) — ou seja, **o mecanismo para detectar "isso
30
+ mudou" já existe**. O que falta é: quando um documento muda, nada hoje sinaliza que as
31
+ arestas/evidências antigas derivadas dele podem estar obsoletas até a próxima reindexação, e nada
32
+ compara a nova extração contra a ADR/spec que descrevia o estado anterior. Uma ADR pode descrever uma
33
+ decisão que o código não implementa mais há três sprints, e nada no Forja aponta a divergência — ela
34
+ só aparece quando um humano tropeça nela.
35
+
36
+ ## 2. Proposta de valor
37
+
38
+ Um novo comando, `forja drift:check`, reindexa (via `GraphIndexer.sync`, já existente) e classifica
39
+ cada documento em três estados: **inalterado**, **mudou e a extração continua consistente com as
40
+ relações registradas**, ou **mudou e uma relação antes `verified` não é mais reproduzível a partir do
41
+ conteúdo atual** — este último caso é o "drift" que importa: uma ADR, um `DEPENDS_ON`, um `IMPLEMENTS`
42
+ que já foi verdade e hoje não é mais, sem que nada tenha formalmente revogado essa relação.
43
+
44
+ ## 3. User stories
45
+
46
+ - **Como** sdd-architect, **quero** saber quando uma ADR descreve algo que o código não faz mais,
47
+ **para que** eu não continue arquitetando em cima de uma premissa que já morreu.
48
+ - **Como** governance, **quero** um relatório de "quantos documentos divergiram desde a última
49
+ verificação", **para que** drift vire um item de rotina (tipo `gsd:check`), não uma surpresa.
50
+ - **Como** consultor com dezenas de projetos gerados pelo Forja, **quero** rodar `drift:check` em lote
51
+ antes de retomar um projeto que não toco há meses, **para que** eu recupere contexto real em vez de
52
+ confiar cegamente em specs/ADRs antigas.
53
+
54
+ ## 4. Critérios de aceite (Definition of Done)
55
+
56
+ - [x] AC-1: `forja drift:check [--domain <d>]` roda `GraphIndexer.sync` e, para cada `GraphMutation`
57
+ cujo `sourceChecksum` mudou desde a última indexação, compara as arestas que o documento
58
+ produzia **antes** com as que produz **agora**. *(`checkDrift` em `lib/drift-sentinel.ts`
59
+ reimplementa o laço de `GraphIndexer.sync` — mesma extração + `GraphLoop.apply` — em vez de
60
+ chamá-lo por dentro, porque `sync()` não expõe o "antes" por documento; nenhum dos dois ganhou
61
+ contrato novo, como o §5 já antecipava.)*
62
+ - [x] AC-2: uma aresta que existia com `status: 'verified'` e não é mais produzida pela extração atual
63
+ do mesmo `sourceKey` é marcada `stale` (reaproveitando `validTo` — GraphLoop já suporta validade
64
+ temporal — em vez de inventar um estado novo em `KnowledgeStatus`, que é um contrato versionado
65
+ e não deve crescer sem necessidade real). *(A proveniência "quais arestas este sourceKey
66
+ produziu" também não ganhou campo novo em `GraphEdge` — é derivada do `locator` da evidência,
67
+ `${sourceKey}:${line}`, que `extractDeterministicRelations` já grava.)*
68
+ - [x] AC-3: o comando imprime um relatório: N documentos verificados, M sem mudança, K com drift
69
+ detectado (lista de `sourceKey` + quais relações ficaram `stale`).
70
+ - [x] AC-4: `drift:check` é determinístico e não usa LLM — é extração + diff, igual ao
71
+ `extractDeterministicRelations` que já existe. Nenhuma dependência nova de rede ou modelo.
72
+ - [x] AC-5: `gsd:check`/`check:all` ganham um modo opcional (`--with-drift`, não obrigatório por
73
+ padrão) que inclui `drift:check` na bateria — opcional porque rodar em todo commit seria caro
74
+ demais para repos grandes; ver NFRs. *(Escopo reduzido — ver `Implementação` no cabeçalho: gate
75
+ via subprocess, não integração in-process em `runGates`.)*
76
+
77
+ ## 5. Escopo
78
+
79
+ **Dentro**:
80
+ - Comando `drift:check`, reaproveitando `GraphIndexer`/`GraphLoop`/`extractDeterministicRelations`
81
+ como estão (nenhuma mudança de contrato nesses três é necessária além de expor o "antes vs. depois"
82
+ que `apply()` já computa internamente e hoje descarta).
83
+ - Marcação de arestas obsoletas via `validTo` (mecanismo já existente).
84
+ - Relatório CLI.
85
+
86
+ **Fora** (explícito, evita scope creep):
87
+ - **Corrigir automaticamente** o código ou a ADR — o comando só sinaliza; decidir qual lado (código ou
88
+ documento) está desatualizado é julgamento humano ou de agente, não deste comando.
89
+ - Rodar em CI/pre-commit por padrão — fica opt-in (ver AC-5) até haver medição de custo em repos
90
+ grandes.
91
+ - Drift semântico ("a ADR ainda é logicamente verdadeira mas o código foi refatorado") — este spec
92
+ cobre só drift **estrutural**, detectável pelo mesmo extrator determinístico que já indexa o grafo.
93
+
94
+ ## 6. NFRs / restrições
95
+
96
+ - **Performance**: `drift:check` não pode ser mais caro que rodar `code:index` duas vezes (é
97
+ essencialmente isso) — sem chamada de LLM, custo é I/O + regex, já provado barato pelo indexador
98
+ existente.
99
+ - **Falso positivo em refactors cosméticos**: renomear uma variável sem mudar a relação semântica não
100
+ deve gerar drift — mitigado porque o extrator já trabalha por relação (`DEPENDS_ON`, `CALLS`,
101
+ `IMPLEMENTS`...), não por hash de linha inteira; um rename que preserva a relação preserva a aresta.
102
+ - **Determinismo antes de LLM** (princípio já declarado na visão do Forja 2.0): este comando não
103
+ introduz nenhuma dependência de modelo.
104
+
105
+ ## 7. Riscos e mitigação
106
+
107
+ | Risco | Probabilidade | Impacto | Mitigação |
108
+ |---|---|---|---|
109
+ | Ruído: muito drift cosmético reportado, comando vira "grito de lobo" | Média | Alta (ninguém mais lê o relatório) | Escopo restrito a relações semânticas, não hash de conteúdo bruto (ver NFR acima); medir taxa de falso positivo no dogfooding antes do GO |
110
+ | Confundir `stale` com `contradicted` (que já existe e significa outra coisa — conflito ativo) | Baixa | Média | AC-2 usa `validTo`, não reaproveita `contradicted`; documentar a diferença explicitamente no plan |
111
+ | Escopo crescer para "corrigir automaticamente" | Média | Alta (autonomia não supervisionada mexendo em ADR) | Fora de escopo explícito (§5); qualquer autocorreção é uma spec futura, com gate de aprovação próprio |
112
+
113
+ ## 8. Métricas de sucesso
114
+
115
+ 30 dias após o release: rodar `drift:check` num projeto real e ativo (não um fixture) resulta em pelo
116
+ menos um drift genuíno encontrado que um humano confirma como real (não falso positivo) — provando que
117
+ o sinal vale o custo de rodar.
@@ -0,0 +1,71 @@
1
+ # Plan: `forja engineer` — compor recomendação de agente + incidentes parecidos
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-09-01
6
+
7
+ ## 1. Abordagem técnica
8
+
9
+ `rankIncidentsByQuery`/`incidentRecords`/`titleOf` (hoje locais a `scripts/incident.ts`) mudam pra
10
+ `lib/core/incident-search.ts` — **não** ficam exportadas de `scripts/incident.ts` (revisado durante
11
+ a implementação, D3): um script tem `main()` executado incondicionalmente ao ser importado (mesmo
12
+ padrão de todo `scripts/*.ts` deste repositório), então `scripts/engineer.ts` importando de
13
+ `scripts/incident.ts` rodaria o `main()` de `incident.ts` como efeito colateral, processando o
14
+ `argv` de `engineer` como se fosse de `incident`. `lib/core/risk-collect.ts` já resolveu exatamente
15
+ esse problema pra `risk`/`engineer`/`simulate` — mesma solução aqui. `scripts/incident.ts` passa a
16
+ *importar* de `lib/core/incident-search.ts`, não a exportar pra ele.
17
+
18
+ `scripts/engineer.ts` importa as três funções + `recommendAgent`/`SqliteAgentProfileStore` (já
19
+ usados em `scripts/agent.ts`, agora também aqui) e adiciona duas seções ao `EngineerReport`.
20
+
21
+ ## 2. Módulos afetados
22
+
23
+ | Caminho | Mudança | Risco |
24
+ |---|---|---|
25
+ | `lib/core/incident-search.ts` (novo) | `rankIncidentsByQuery`/`incidentRecords`/`titleOf`, extraídas de `scripts/incident.ts` | Baixo — mesmo padrão já usado por `risk-collect.ts` |
26
+ | `scripts/incident.ts` | passa a importar de `lib/core/incident-search.ts` em vez de definir localmente — comportamento idêntico (refactor puro) | Baixo |
27
+ | `scripts/engineer.ts` | `--role <role>` novo flag; 2 seções novas no relatório | Baixo — só composição |
28
+ | `test/incident-cli.test.js` | nenhuma mudança esperada (comportamento de `incident:similar` idêntico) | — |
29
+ | `test/engineer-cli.test.js` | +testes das 2 seções novas | — |
30
+
31
+ ## 3. Contratos
32
+
33
+ ```ts
34
+ // lib/core/incident-search.ts
35
+ export interface RankedIncident { readonly record: GraphNode; readonly relevance: number; }
36
+ export function rankIncidentsByQuery(records: readonly GraphNode[], query: string): readonly RankedIncident[];
37
+ export function incidentRecords(store: SqliteGraphStore): readonly GraphNode[];
38
+ export function titleOf(node: GraphNode): string;
39
+ ```
40
+
41
+ ```bash
42
+ engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
43
+ ```
44
+
45
+ `EngineerReport` ganha:
46
+ ```ts
47
+ readonly recommendedAgents?: readonly { readonly agentId: string; readonly score: number; readonly reasons: readonly string[] }[]; // só com --role
48
+ readonly similarIncidents: readonly { readonly id: string; readonly title: string; readonly relevance: number }[]; // sempre presente, [] se vazio
49
+ ```
50
+
51
+ ## 4. Decisões
52
+
53
+ **D1**: seção de incidentes usa o **objetivo inteiro** como busca (mesmo texto livre já usado por
54
+ `ContextEngine.build`/`GraphLoop.contextRecords` na mesma função) — não um `--query` separado, pra
55
+ não multiplicar flags sem necessidade real; o objetivo já É a busca mais natural.
56
+
57
+ **D2**: `rankIncidentsByQuery` extraída sem alterar `incident:similar` de comportamento — mesmo
58
+ teste de CLI (`test/incident-cli.test.js`) continua valendo como prova de regressão do refactor.
59
+
60
+ **D3** (revisada durante a implementação): a extração vai pra `lib/core/incident-search.ts`, não
61
+ fica exportada de `scripts/incident.ts` como a primeira versão deste plan previa — ver §1, motivo
62
+ completo é o mesmo já documentado no cabeçalho do próprio arquivo novo.
63
+
64
+ ## 5. Rollout
65
+
66
+ Sem migração, sem feature flag.
67
+
68
+ ## 6. Kill criteria
69
+
70
+ Já coberto pelo princípio geral — se as duas seções novas não ajudarem na prática (§8), removê-las
71
+ é mais barato que mantê-las: nenhuma outra spec depende delas.
@@ -0,0 +1,98 @@
1
+ # Spec: `forja engineer` — compor recomendação de agente + incidentes parecidos
2
+
3
+ - **ID**: SPEC-042
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-09-01
7
+ - **Sprint alvo**: Sprint 10 (extensão de composição — todos os Sprints 4-9 da Fase 3-6 já entregam
8
+ sinais que `forja engineer`, de SPEC-035/Sprint 3, ainda não compõe)
9
+ - **ADRs relacionadas**: ADR-0078; depende de SPEC-035 (`forja engineer`), SPEC-037
10
+ (`recommendAgent`), SPEC-041 (`incident:similar`) — todos reaproveitados sem mudança
11
+
12
+ > `forja engineer` (SPEC-035) foi implementada no Sprint 3, antes de `recommendAgent` (SPEC-037,
13
+ > Sprint 5) e `incident:similar` (SPEC-041, Sprint 9) existirem. AC-2 de SPEC-035 já definia a
14
+ > façade como composição extensível ("nenhuma lógica de negócio nova... qualquer decisão real
15
+ > continua nos engines que ela chama") — esta spec é literalmente isso: compor dois sinais que já
16
+ > existem e que a proposta de valor original de `forja engineer` (SPEC-031 §2: "uma única pergunta
17
+ > que já traga arquitetura, risco, ADRs relevantes e fluxo recomendado") já pedia implicitamente,
18
+ > mas que não existiam ainda no Sprint 3.
19
+
20
+ ## 1. Problema
21
+
22
+ `forja engineer "<objetivo>"` já compõe contexto, ADRs relevantes, `architecture:check` e risco —
23
+ mas não sugere qual agente registrado é mais adequado pro objetivo, nem mostra incidentes passados
24
+ parecidos, mesmo essas duas capacidades já existindo (`agent:recommend`, `incident:similar`) e
25
+ sendo exatamente o tipo de sinal que orienta o início de um trabalho.
26
+
27
+ ## 2. Proposta de valor
28
+
29
+ `forja engineer "<objetivo>" [--role <role>]` passa a incluir, quando aplicável: ranking de agentes
30
+ registrados adequados ao `--role` informado (reaproveita `recommendAgent`, SPEC-037), e incidentes
31
+ passados parecidos com o objetivo (reaproveita a busca por palavra-chave de `incident:similar`,
32
+ SPEC-041) — sem nenhuma lógica nova, só mais composição, exatamente como AC-4 de SPEC-035 já exigia.
33
+
34
+ ## 3. User stories
35
+
36
+ - **Como** desenvolvedor/orquestrador, **quero** que `forja engineer` já sugira quem trabalhar e o
37
+ que já aconteceu de parecido, **para que** eu não precise rodar `agent:recommend`/
38
+ `incident:similar` manualmente depois de já ter rodado `engineer`.
39
+
40
+ ## 4. Critérios de aceite (Definition of Done)
41
+
42
+ - [x] AC-1: `forja engineer "<objetivo>" --role <role>` inclui uma seção de agentes recomendados
43
+ (reaproveita `recommendAgent`, SPEC-037, sem reimplementar a fórmula de scoring). Sem
44
+ `--role`, a seção não aparece — nunca inventa um papel que o usuário não informou.
45
+ - [x] AC-2: `forja engineer "<objetivo>"` sempre inclui uma seção de incidentes parecidos
46
+ (reaproveita o matching por palavra-chave de `incident:similar`, SPEC-041, exportado do
47
+ mesmo módulo — sem duplicar a lógica de scoring). Vazio quando não há incidente parecido, não
48
+ erro.
49
+ - [x] AC-3: nenhuma lógica nova além de composição/formatação (mesmo princípio de AC-4 de
50
+ SPEC-035) — `recommendAgent`/o matching de incidentes continuam sendo a única fonte de
51
+ verdade de cada score.
52
+ - [x] AC-4: `--json` inclui as duas seções novas estruturadas; texto legível mostra as duas.
53
+
54
+ ## 5. Escopo
55
+
56
+ **Dentro**: extensão aditiva de `scripts/engineer.ts` + mover o matching de incidentes de
57
+ `scripts/incident.ts` pra `lib/core/incident-search.ts` (mesmo padrão de `risk-collect.ts`) pra
58
+ reaproveitamento sem duplicar.
59
+
60
+ **Fora**: incluir `detectAnomaly` (SPEC-040) na composição — não se encaixa na mesma pergunta
61
+ ("por onde eu começo") que `forja engineer` responde; anomalia é sobre comportamento contínuo de UM
62
+ agente já em operação, não sobre iniciar um objetivo novo (nota já registrada em ADR-0079). Fica de
63
+ fora por não ser a mesma pergunta, não por limitação técnica.
64
+
65
+ ## 6. NFRs / restrições
66
+
67
+ - Zero lógica de scoring nova — só import + composição.
68
+ - Zero migration/persistência nova.
69
+
70
+ ## 7. Riscos e mitigação
71
+
72
+ | Risco | Probabilidade | Impacto | Mitigação |
73
+ |---|---|---|---|
74
+ | `forja engineer` virar um monólito de composição frágil (toda spec futura quer adicionar uma seção) | Média a longo prazo | Baixa agora (só mais 2 seções) | Mesmo padrão de AC-4/AC-3 de SPEC-035 continua valendo — cada seção nova precisa ser genuinamente "por onde eu começo", não qualquer sinal disponível (ver §5 "Fora" sobre anomalia) |
75
+
76
+ ## 8. Métricas de sucesso
77
+
78
+ Rodar `forja engineer` com `--role` sobre os agentes já registrados nos testes de SPEC-037, e sobre
79
+ os incidentes já registrados nos testes de SPEC-041 (reaproveitados como fixture), e confirmar que
80
+ as duas seções aparecem corretamente — revisão humana, mesma metodologia das specs anteriores.
81
+
82
+ **Validado** (`test/engineer-cli.test.js`): agente + incidente reais de fixtures das specs
83
+ anteriores; `engineer --role developer` mostrou a recomendação certa; `engineer "npm hangs..."`
84
+ achou o incidente correspondente e ignorou o não relacionado; sem `--role`, a seção de agentes
85
+ corretamente não aparece; sem nenhum incidente registrado, seção vazia sem erro.
86
+
87
+ **Achados reais corrigidos durante a implementação (não adiados)**:
88
+
89
+ 1. **Importar de `scripts/incident.ts` executaria seu `main()` como efeito colateral** (todo
90
+ `scripts/*.ts` roda incondicionalmente ao ser importado, mesmo padrão que motivou
91
+ `lib/core/risk-collect.ts` em SPEC-034/038) — capturado no design antes de qualquer código ser
92
+ escrito, corrigido movendo `rankIncidentsByQuery`/`incidentRecords`/`titleOf` pra
93
+ `lib/core/incident-search.ts` (D3 do plan, revisão de D1/D2 originais).
94
+ 2. **Bug de parsing de argumentos**: a primeira versão do parser de `--role` computava
95
+ `roleIndex + 1` incondicionalmente (0 quando `roleIndex === -1`), engolindo o próprio objetivo
96
+ sempre que `--role` não era passado — reproduzido imediatamente ao testar manualmente
97
+ (`forja engineer "<objetivo>"` sem flags devolvia "Uso: ..."). Corrigido: cada índice só entra
98
+ no conjunto de "consumidos" quando a flag correspondente foi de fato encontrada.
@@ -0,0 +1,36 @@
1
+ # Tasks: `forja engineer` — compor recomendação de agente + incidentes parecidos
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-09-01
7
+
8
+ ---
9
+
10
+ ## T1 — extrair matching de incidentes + compor em `forja engineer`
11
+ - **Owner**: worker
12
+ - **Estimativa**: M
13
+ - **Depende de**: —
14
+ - **Paths**: `scripts/incident.ts`, `scripts/engineer.ts`
15
+ - **Done quando**:
16
+ - [ ] `rankIncidentsByQuery`/`incidentRecords` exportados, `incident:similar` inalterado em
17
+ comportamento (testes existentes continuam verdes)
18
+ - [ ] `forja engineer --role <role>` inclui agentes recomendados; sem `--role`, seção ausente
19
+ - [ ] `forja engineer` sempre inclui incidentes parecidos (vazio, não erro, se nenhum)
20
+ - [ ] `--json` estrutura as duas seções
21
+
22
+ ## T2 — prova
23
+ - **Owner**: worker
24
+ - **Estimativa**: P
25
+ - **Depende de**: T1
26
+ - **Paths**: `test/engineer-cli.test.js`, `test/incident-cli.test.js` (verificação de não-regressão)
27
+ - **Done quando**:
28
+ - [ ] teste com agente registrado + `--role` mostra a recomendação certa
29
+ - [ ] teste com incidente registrado que casa com o objetivo aparece na seção
30
+ - [ ] `test/incident-cli.test.js` continua 100% verde (prova do refactor D2)
31
+
32
+ ---
33
+
34
+ ## Handoffs entre agentes
35
+
36
+ T1 → T2 sequencial. Sem handoff de papel.
@@ -0,0 +1,121 @@
1
+ # Plan: Engineering Evidence Ledger + `forja engineer` (façade)
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-09-01
6
+
7
+ ## 1. Abordagem técnica
8
+
9
+ Dois entregáveis pequenos, ambos composição pura sobre o que já existe — nenhuma tabela SQLite
10
+ nova, nenhuma lógica de decisão nova:
11
+
12
+ 1. `packages/engineering/evidence` — `buildEvidenceLedger(input)`, função pura que recebe um
13
+ `RuntimeRun` + `AuditRecord[]`/`ApprovalRequest[]` já filtrados + `ArchitectureCheckReport`/
14
+ `ChangeRiskAssessment` opcionais e devolve o JSON agregado (`run/intent/agent/risk/
15
+ architectureCheck/tests/approvals/commit`). `scripts/evidence.ts` é o adapter (`evidence:show
16
+ <run-id>`) que busca esses dados reais via `SqliteRuntimeRunStore`/`SqliteAuditStore`/
17
+ `ApprovalLedger`.
18
+ 2. `scripts/engineer.ts` — `forja engineer "<objetivo>"`, façade que chama, nesta ordem:
19
+ `ContextEngine.build()` (grafo, mesmo padrão de `scripts/demo-autonomy.ts`) →
20
+ `GraphLoop.contextRecords(objetivo)` filtrado a nós ADR/SPEC (SPEC-032, reaproveitado, não uma
21
+ busca nova) → `architecture:check` (não escopado — antes de haver diff, não há arquivo pra
22
+ escopar; ver D1) → `RiskEngine.assess()` (só com `--ref`; ver D1) → fluxo recomendado, parseado
23
+ de `docs/fluxo.md` (D2 — parser, não cópia hardcoded).
24
+
25
+ ## 2. Módulos afetados
26
+
27
+ | Caminho | Mudança | Risco |
28
+ |---|---|---|
29
+ | `packages/engineering/evidence/src/index.ts` | novo — `buildEvidenceLedger` | Baixo — mapeamento puro |
30
+ | `scripts/evidence.ts` | novo — `evidence:show <run-id>` | Baixo |
31
+ | `scripts/engineer.ts` | novo — `engineer "<objetivo>" [--ref <ref>] [--json]` | Médio — orquestra 4 subsistemas, mas cada chamada já existe |
32
+ | `lib/core/registry.ts` | 2 comandos novos | Baixo |
33
+ | `test/evidence-ledger.test.js` (novo) | testes puros de `buildEvidenceLedger` | — |
34
+ | `test/engineer-cli.test.js` (novo) | fixture git isolada, `engineer` ponta a ponta | — |
35
+
36
+ ## 3. Diagrama de fluxo
37
+
38
+ ```text
39
+ forja engineer "<objetivo>" [--ref <ref>]
40
+ │
41
+ ├─► ContextEngine.build({ objective, graph: GraphContextSource(graph.contextRecords) })
42
+ ├─► graph.contextRecords(objetivo) filtrado a nós ADR/SPEC (SPEC-032)
43
+ ├─► architecture:check (constitution.json real, SPEC-033) — não escopado
44
+ ├─► RiskEngine.assess() (SPEC-034) — só se --ref foi passado
45
+ └─► fluxo recomendado — parseado da tabela "Etapa → papel → comando" de docs/fluxo.md
46
+ │
47
+ ▼
48
+ saída de texto (default) ou --json (AC-3: nunca sintetiza além do que cada
49
+ subsistema já disse)
50
+ ```
51
+
52
+ ## 4. Contratos (API/CLI/Schema)
53
+
54
+ ```ts
55
+ // packages/engineering/evidence/src/index.ts
56
+ export interface EvidenceLedgerInput {
57
+ readonly run: RuntimeRun;
58
+ readonly auditRecords: readonly AuditRecord[];
59
+ readonly approvals: readonly ApprovalRequest[];
60
+ readonly architectureCheck?: ArchitectureCheckReport;
61
+ readonly riskAssessment?: ChangeRiskAssessment;
62
+ readonly commit?: string;
63
+ }
64
+ export interface EvidenceLedgerRecord {
65
+ readonly run: { readonly runId: string; readonly state: string; readonly startedAt: string; readonly updatedAt: string; readonly steps: number; readonly changedFiles: readonly string[] };
66
+ readonly intent: string;
67
+ readonly agent: AgentIdentity;
68
+ readonly architectureCheck?: ArchitectureCheckReport;
69
+ readonly risk?: ChangeRiskAssessment;
70
+ readonly tests?: EvaluationResult;
71
+ readonly approvals: readonly ApprovalRequest[];
72
+ readonly commit?: string;
73
+ }
74
+ export function buildEvidenceLedger(input: EvidenceLedgerInput): EvidenceLedgerRecord;
75
+ ```
76
+
77
+ ```bash
78
+ evidence:show <run-id>
79
+ engineer "<objetivo>" [--ref <ref>] [--json]
80
+ ```
81
+
82
+ ## 5. Decisões e alternativas
83
+
84
+ **D1**: `forja engineer` roda `architecture:check` **não escopado** (relatório completo, não
85
+ filtrado a arquivos) e só inclui `risk` quando `--ref` é passado explicitamente. A visão original
86
+ lista os dois como parte fixa da composição, mas `forja engineer` roda **antes** de existir um
87
+ diff (é a ferramenta que orienta o início do trabalho) — não há arquivos afetados ainda para
88
+ escopar nenhum dos dois. Alternativa rejeitada: inferir arquivos afetados a partir do texto do
89
+ objetivo (aí sim seria síntese/adivinhação, proibido por AC-3). Quando `--ref` é passado (ex.:
90
+ objetivo já tem uma branch com commits), o risco entra completo, exatamente como `risk:assess`
91
+ computaria.
92
+
93
+ **D2**: o "fluxo recomendado" é **parseado** da tabela "Etapa → papel → comando" existente em
94
+ `docs/fluxo.md`, não copiado/hardcoded em `scripts/engineer.ts`. Só uma fonte de verdade para os 6
95
+ passos SDD/GSD — se `docs/fluxo.md` mudar, `forja engineer` acompanha sem exigir sincronização
96
+ manual. Parser é uma regex sobre linhas de tabela markdown (determinístico, sem LLM).
97
+
98
+ **D3**: `EvidenceLedgerInput` não busca dado nenhum sozinho — é `scripts/evidence.ts`/
99
+ `scripts/engineer.ts` que buscam `RuntimeRun`/`AuditRecord`/`ApprovalRequest` reais e montam o
100
+ input. `buildEvidenceLedger` é só o mapeamento — igual ao par engine-puro/CLI-adapter já usado em
101
+ `packages/engineering/architecture` e `packages/engineering/risk`.
102
+
103
+ ## 6. Dependências
104
+
105
+ - SPEC-032 (`GraphLoop.contextRecords`), SPEC-033 (`checkConstitution`), SPEC-034
106
+ (`assessRisk`/`RiskEngine`) — todas já mergeadas/em PR quando este sprint começa.
107
+ - `packages/context.ContextEngine`/`GraphContextSource` (já existentes, mesmo padrão de
108
+ `scripts/demo-autonomy.ts`).
109
+ - `packages/adapter-sqlite.SqliteRuntimeRunStore`/`SqliteAuditStore` (já existentes).
110
+
111
+ ## 7. Rollout
112
+
113
+ - [ ] Feature flag necessária? Não.
114
+ - [ ] Migração de dados existentes? Não.
115
+ - [ ] Doc/persona impactada? README (comandos novos).
116
+
117
+ ## 8. Sinais de fracasso (kill criteria)
118
+
119
+ Já registrado no apêndice de `specs/engineering-intelligence/spec.md`, §8 deste spec: se a saída de
120
+ `forja engineer` sobre um objetivo real não for usável sem edição, o design da façade (não os
121
+ engines subjacentes, já validados nos Sprints 1-2) é revisado.
@@ -0,0 +1,90 @@
1
+ # Spec: Engineering Evidence Ledger + `forja engineer` (façade)
2
+
3
+ - **ID**: SPEC-035
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-09-01
7
+ - **Sprint alvo**: Sprint 3
8
+ - **ADRs relacionadas**: ADR-0078; depende de SPEC-032, SPEC-033, SPEC-034 (a façade compõe as
9
+ três)
10
+
11
+ ## 1. Problema
12
+
13
+ `AuditRecord`/`Observation`/`RuntimeRun` já são gravados por run, mas cada um em sua própria
14
+ tabela/stream — não existe uma view única "o que aconteceu neste run, do intent à evidência".
15
+ Separadamente, montar o quadro completo de uma mudança antes de começar (contexto + arquitetura +
16
+ risco + ADRs relevantes) hoje exige rodar vários comandos manualmente.
17
+
18
+ ## 2. Proposta de valor
19
+
20
+ Uma view agregada por run (Evidence Ledger) e uma façade única (`forja engineer`) que compõe tudo
21
+ que já existe — sem introduzir nenhuma fonte de dado nova.
22
+
23
+ ## 3. User stories
24
+
25
+ - **Como** governance, **quero** um registro append-only por run (`intent`, `agent`, `risk`,
26
+ `architectureCheck`, `tests`, `approvals`, `commit`), **para que** eu audite uma execução sem
27
+ cruzar manualmente quatro tabelas.
28
+ - **Como** desenvolvedor, **quero** `forja engineer "<objetivo>"` trazendo de uma vez arquitetura
29
+ afetada, ADRs relevantes, risco estimado e o fluxo recomendado, **para que** eu comece o trabalho
30
+ já orientado.
31
+
32
+ ## 4. Critérios de aceite (Definition of Done)
33
+
34
+ - [x] AC-1: view agregada (função pura sobre `AuditRecord`/`Observation`/`RuntimeRun` já
35
+ persistidos) produz o JSON no formato do exemplo da visão original (`run`, `intent`, `agent`,
36
+ `risk`, `architectureCheck`, `tests`, `approvals`, `commit`) — sem nova tabela SQLite além
37
+ das já existentes.
38
+ - [x] AC-2: `forja engineer "<objetivo>"` compõe, nesta ordem: `ContextEngine.build()` (já
39
+ existente) → `GraphLoop`/ADR relevantes (SPEC-032) → `architecture:check` (SPEC-033;
40
+ não escopado sem `--ref`, ver D1 do plan — não há diff ainda antes do trabalho começar) →
41
+ `RiskEngine.assess()` (SPEC-034, só com `--ref`) → fluxo recomendado (parseado de
42
+ `docs/fluxo.md`, D2 do plan — não reinventado).
43
+ - [x] AC-3: saída de `forja engineer` é estruturada (JSON opcional via `--json`, texto legível por
44
+ padrão) e nunca afirma nada que os componentes subjacentes não afirmaram — sem síntese de
45
+ LLM que possa alucinar arquitetura inexistente.
46
+ - [x] AC-4: nenhuma lógica de negócio nova em `forja engineer` além de composição e formatação —
47
+ qualquer decisão real continua nos engines que ela chama.
48
+
49
+ ## 5. Escopo
50
+
51
+ **Dentro**: view agregada de evidência; façade `forja engineer` na versão mínima descrita acima
52
+ (sem seleção de time de agentes, que depende de Agent Identity/Reputation, fora de escopo).
53
+
54
+ **Fora**: seleção/recomendação de agente ou modelo (Fase 3); relatório de release
55
+ (`release:engineering-report`, feature separada da visão original, útil mas não bloqueante para
56
+ esta fundação); qualquer persistência nova — esta spec é puramente uma camada de leitura/composição
57
+ sobre dados que Sprints 1-2 e o framework já existente produzem.
58
+
59
+ ## 6. NFRs / restrições
60
+
61
+ - View de evidência é derivável a qualquer momento a partir do que já está persistido — se
62
+ recalculada, produz o mesmo resultado (sem estado próprio para divergir).
63
+ - `forja engineer` nunca é a única fonte de verdade de nada — é sempre um resumo do que os
64
+ componentes subjacentes já disseram, rastreável de volta a cada um.
65
+
66
+ ## 7. Riscos e mitigação
67
+
68
+ | Risco | Probabilidade | Impacto | Mitigação |
69
+ |---|---|---|---|
70
+ | `forja engineer` virar um "resumo de LLM" que esconde de onde vieram os fatos | Média (é a tentação óbvia de UX) | Alta (quebra auditabilidade) | AC-3 proíbe síntese que não seja rastreável componente-a-componente |
71
+ | Evidence Ledger duplicar dado já em `AuditRecord`/`Observation` | Baixa se implementado como view | Média (duas fontes de verdade) | AC-1 explicitamente "função pura sobre dados já persistidos", sem gravação própria |
72
+
73
+ ## 8. Métricas de sucesso
74
+
75
+ Rodar `forja engineer` para uma mudança real proposta neste repositório produz uma saída que um
76
+ humano usaria sem edição para decidir se e como prosseguir — mesma métrica da spec master, aqui
77
+ verificada no nível do comando específico.
78
+
79
+ **Validado**: `forja engineer "compilar a architecture constitution deste repositório"` rodado
80
+ contra este próprio repositório (grafo real, 1013 arquivos). Produziu contexto relevante (specs e
81
+ testes de SPEC-033), ADRs/SPECs corretos (ADR-0078, SPEC-032/033/034), `architecture:check` real
82
+ (constitution já compilada neste repo) e o fluxo recomendado de `docs/fluxo.md` — utilizável sem
83
+ edição.
84
+
85
+ **Achado real corrigido durante a implementação (não um bug de lógica — um limite de exibição
86
+ ausente)**: a primeira execução sem `maxItems` devolveu **1013** referências de contexto (todo o
87
+ grafo do repositório caiu dentro do orçamento de 20k tokens), tornando a saída inutilizável sem
88
+ edição — o oposto do que esta métrica pede. Corrigido passando `maxItems: 10` para
89
+ `ContextEngine.build()` (as 10 mais relevantes, já ordenadas por `ContextEngine`); a lista completa
90
+ continua disponível via `context:smart`/`code:query`, que `forja engineer` não substitui.
@@ -0,0 +1,54 @@
1
+ # Tasks: Engineering Evidence Ledger + `forja engineer`
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-09-01
7
+
8
+ ---
9
+
10
+ ## T1 — `buildEvidenceLedger` (view pura) + `evidence:show`
11
+ - **Owner**: worker
12
+ - **Estimativa**: M
13
+ - **Depende de**: —
14
+ - **Paths**: `packages/engineering/evidence/src/index.ts`, `scripts/evidence.ts`, `lib/core/registry.ts`
15
+ - **Done quando**:
16
+ - [ ] `buildEvidenceLedger` mapeia `EvidenceLedgerInput` → `EvidenceLedgerRecord` sem inventar
17
+ nenhum campo que não veio no input (AC-1)
18
+ - [ ] `evidence:show <run-id>` busca `RuntimeRun` real (`SqliteRuntimeRunStore`), `AuditRecord`s
19
+ (`SqliteAuditStore`, filtrado por `aggregateId === runId`), `ApprovalRequest`s
20
+ (`ApprovalLedger`, filtrado por `correlationId === runId`)
21
+ - [ ] testes unitários (sem `fs`/rede): campos opcionais ausentes não aparecem como `null`
22
+ inventado; `run-id` inexistente é erro claro, não JSON vazio
23
+
24
+ ## T2 — `forja engineer "<objetivo>"` façade
25
+ - **Owner**: worker
26
+ - **Estimativa**: G
27
+ - **Depende de**: T1 (reaproveita o mesmo padrão engine-puro/CLI-adapter)
28
+ - **Paths**: `scripts/engineer.ts`, `lib/core/registry.ts`
29
+ - **Done quando**:
30
+ - [ ] compõe, na ordem do plan: `ContextEngine.build()` → `contextRecords` filtrado a ADR/SPEC →
31
+ `architecture:check` não escopado → `RiskEngine.assess()` só com `--ref` (D1) → fluxo
32
+ recomendado parseado de `docs/fluxo.md` (D2)
33
+ - [ ] `--json` produz JSON estruturado; sem a flag, texto legível
34
+ - [ ] nenhuma string sintetizada além do que os componentes já disseram (grep manual: sem
35
+ chamada de LLM/heurística de texto livre em `scripts/engineer.ts`)
36
+ - [ ] `forja tools:doctor` continua verde
37
+
38
+ ## T3 — prova sobre objetivo real deste repositório
39
+ - **Owner**: worker
40
+ - **Estimativa**: P
41
+ - **Depende de**: T2
42
+ - **Paths**: `test/engineer-cli.test.js` (novo)
43
+ - **Done quando**:
44
+ - [ ] fixture git isolada: `engineer "<objetivo>"` roda ponta a ponta (sem `--ref`) e produz
45
+ texto com todas as seções (contexto, ADRs relevantes, architecture:check, fluxo)
46
+ - [ ] com `--ref`, a seção de risco aparece com score real
47
+ - [ ] `evidence:show` recupera um run persistido de ponta a ponta
48
+
49
+ ---
50
+
51
+ ## Handoffs entre agentes
52
+
53
+ T1 → T2 → T3 sequencial. Sem handoff de papel — spec e plan já aprovados cobrem as decisões de
54
+ produto/arquitetura.