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,79 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * cost-economy — SPEC-029 AC-5: `token:economy` mede tokens; isto mede o que realmente importa pra
4
+ * quem paga a conta, dólar. Novo comando (em vez de estender `token:economy` in-place) porque os
5
+ * dois eixos medem coisas diferentes: `token:economy` compara CENÁRIOS sintéticos de fixture
6
+ * (arquitetura clean vs flat, memória quente vs fria — nunca rodou um LLM de verdade). `cost:economy`
7
+ * agrega OBSERVAÇÕES REAIS já gravadas por `forja llm:run` (mesmo `ObservationStore` de `llm:eval`),
8
+ * multiplicadas pela tabela de preço local (`lib/core/model-pricing.json`, AC-3). Reaproveitar o
9
+ * comando de fixture faria "economia de token" parecer "economia de custo" sobre dados que nunca
10
+ * geraram custo real — daí o comando irmão em vez de uma seção dentro de `token:economy`.
11
+ *
12
+ * Escopo por projeto/domínio: cada projeto tem seu próprio workspace/DB (FORJA_WORKSPACE), então
13
+ * rodar `forja cost:economy` dentro do workspace de um projeto já reporta o custo DAQUELE projeto —
14
+ * sem precisar de um campo `projectId` novo em `Observation` (fora do escopo deste spec).
15
+ *
16
+ * Estimativa, não fatura: nomeado explicitamente nos dois formatos de saída (mitigação de risco do
17
+ * SPEC-029 — "confundir custo estimado com custo real cobrado").
18
+ */
19
+ import fs from 'node:fs';
20
+ import Database from 'better-sqlite3';
21
+ import { SqliteMigrationRunner, SqliteObservationStore } from "../packages/adapter-sqlite/src/index.js";
22
+ import { getWorkspaceDbDir, getWorkspaceDbPath, getWorkspaceInfo } from "../lib/workspace.js";
23
+ import { loadPricingTable, lookupPrice } from "../lib/core/model-pricing.js";
24
+ function main() {
25
+ const info = getWorkspaceInfo();
26
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
27
+ const db = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
28
+ new SqliteMigrationRunner(db).apply();
29
+ const store = new SqliteObservationStore(db);
30
+ const observations = store.list();
31
+ db.close();
32
+ const table = loadPricingTable();
33
+ const byModel = new Map();
34
+ let totalCostUsd = 0;
35
+ let unknownPricingCount = 0;
36
+ for (const observation of observations) {
37
+ const model = observation.model ?? '(sem modelo)';
38
+ const priceKnown = lookupPrice(table, observation.model) !== undefined;
39
+ const entry = byModel.get(model) ?? { count: 0, inputTokens: 0, outputTokens: 0, costUsd: 0, priceKnown };
40
+ entry.count += 1;
41
+ entry.inputTokens += observation.inputTokens;
42
+ entry.outputTokens += observation.outputTokens;
43
+ entry.costUsd += observation.cost ?? 0;
44
+ entry.priceKnown = entry.priceKnown || priceKnown;
45
+ byModel.set(model, entry);
46
+ totalCostUsd += observation.cost ?? 0;
47
+ if (!priceKnown)
48
+ unknownPricingCount += 1;
49
+ }
50
+ console.log(`\nCost economy — custo real acumulado (SPEC-029) — workspace: ${info.root}\n`);
51
+ console.log('Estimativa baseada na tabela local de preços (lib/core/model-pricing.json), NÃO a fatura do provider.\n');
52
+ if (observations.length === 0) {
53
+ console.log('Nenhuma observação registrada ainda. Rode `forja llm:run --profile <perfil> --prompt <texto>` para gerar execuções.');
54
+ }
55
+ else {
56
+ const rows = [...byModel.entries()].sort((left, right) => right[1].costUsd - left[1].costUsd);
57
+ for (const [model, entry] of rows) {
58
+ const flag = entry.priceKnown ? '' : ' (preço desconhecido nesta execução — custo pode estar subestimado)';
59
+ console.log(`■ ${model}${flag}`);
60
+ console.log(` execuções: ${entry.count} tokens: ${entry.inputTokens + entry.outputTokens} (in ${entry.inputTokens} / out ${entry.outputTokens})`);
61
+ console.log(` custo estimado: $${entry.costUsd.toFixed(4)}\n`);
62
+ }
63
+ console.log(`Total: $${totalCostUsd.toFixed(4)} estimado em ${observations.length} execução(ões).`);
64
+ if (unknownPricingCount > 0) {
65
+ console.log(`Aviso: ${unknownPricingCount} execução(ões) usaram modelo(s) sem preço na tabela local — custo real total pode ser maior que o mostrado. Atualize lib/core/model-pricing.json (\`forja llm:doctor\` lista os gaps).`);
66
+ }
67
+ }
68
+ if (process.argv.includes('--json')) {
69
+ console.log(JSON.stringify({
70
+ workspace: info.root,
71
+ currency: table.currency,
72
+ totalCostUsd,
73
+ observationCount: observations.length,
74
+ unknownPricingCount,
75
+ byModel: Object.fromEntries(byModel),
76
+ }, null, 2));
77
+ }
78
+ }
79
+ main();
@@ -111,7 +111,6 @@ export async function runAutonomyDemo() {
111
111
  cache: new SqliteContextCache(database),
112
112
  }).build({ objective: 'corrigir teste falhando math.test.js', budget, includeContent: true, requireEvidence: false, correlationId });
113
113
  const approvals = new ApprovalLedger(new SqliteApprovalStore(database));
114
- let approved = false;
115
114
  const policy = new PolicyEngine({
116
115
  rules: [{ id: 'demo-code-write', priority: 100, effect: 'REQUIRE_APPROVAL', reason: 'Alteração de código exige aprovação humana', scope: { agentIds: [agent.id], capabilityIds: ['fixture.code.write'], environments: ['local'], categories: ['write'] } }],
117
116
  approvalLedger: approvals,
@@ -152,14 +151,23 @@ export async function runAutonomyDemo() {
152
151
  persistence: new SqliteRuntimePersistence(database),
153
152
  memory: new GraphExecutionMemory(graph),
154
153
  validator: { validate: (run, results) => {
155
- const plan = createPlan(run.runId, testFile, [...new Set([...context.references.map((item) => item.id), ...results.flatMap((result) => result.evidence.map((item) => item.id))])]);
154
+ const allEvidenceIds = results.flatMap((result) => result.evidence.map((item) => item.id));
155
+ const plan = createPlan(run.runId, testFile, [...new Set([...context.references.map((item) => item.id), ...allEvidenceIds])]);
156
156
  const successfulResults = results.filter((result) => result.status === 'succeeded');
157
157
  const testEvidenceIds = successfulResults.flatMap((result) => result.evidence.map((item) => item.id));
158
158
  const testPassed = successfulResults.length > 0;
159
- return new DeterministicValidator().validate({ plan, changedFiles: run.changedFiles, checks: [{ name: 'build', passed: true, evidenceIds: [] }, { name: 'tests', passed: testPassed, evidenceIds: testEvidenceIds }, { name: 'diff', passed: true, evidenceIds: testEvidenceIds }, { name: 'typecheck', passed: true, evidenceIds: [] }, { name: 'lint', passed: true, evidenceIds: [] }], acceptance: [{ criterion: 'npm test passa na fixture', passed: testPassed, evidenceIds: testEvidenceIds }, { criterion: 'diff contém somente o teste falho', passed: run.changedFiles.length === 1 && run.changedFiles[0] === testFile, evidenceIds: [] }], correlationId: run.correlationId });
159
+ const scopeRespected = run.changedFiles.length === 1 && run.changedFiles[0] === testFile;
160
+ // This fixture has no build/lint/typecheck step, so it only claims what it actually ran
161
+ // (the sandboxed `npm test`) — DeterministicValidator now requires evidence behind every
162
+ // "passed" claim, so fabricating the other checks would just get them rejected.
163
+ return new DeterministicValidator().validate({ plan, changedFiles: run.changedFiles, requiredChecks: ['tests'], checks: [{ name: 'tests', passed: testPassed, evidenceIds: testEvidenceIds }], acceptance: [{ criterion: 'npm test passa na fixture', passed: testPassed, evidenceIds: testEvidenceIds }, { criterion: 'diff contém somente o teste falho', passed: scopeRespected, evidenceIds: scopeRespected ? allEvidenceIds : [] }], correlationId: run.correlationId });
160
164
  } },
161
165
  });
162
- const started = await runtime.start({ objective: 'Corrigir teste falhando na fixture externa', agent, budget, policy: { authorize: (request) => approved ? { effect: 'ALLOW', reason: 'Aprovação humana registrada', policyId: 'demo-approved' } : policy.authorize(request) }, correlationId });
166
+ // `policy` is passed through unwrapped: the runtime tags every step of this run with the same
167
+ // stable correlationId (its own runId), so PolicyEngine.authorize() can recognize, on resume,
168
+ // that a human already decided the pending approval for this exact run — rather than needing a
169
+ // hand-rolled bypass that (incorrectly) would have granted ALLOW to every future request too.
170
+ const started = await runtime.start({ objective: 'Corrigir teste falhando na fixture externa', agent, budget, policy, correlationId });
163
171
  const awaiting = await runtime.execute(started.runId);
164
172
  if (awaiting.state !== 'awaiting_approval')
165
173
  throw new Error(`Expected approval gate, got ${awaiting.state}`);
@@ -167,8 +175,7 @@ export async function runAutonomyDemo() {
167
175
  if (approval === undefined)
168
176
  throw new Error('Approval was not persisted');
169
177
  approvals.decide(approval.id, { decision: 'approved', approverId: 'human.demo', decidedAt: now() });
170
- approved = true;
171
- const completed = await runtime.resume(started.runId);
178
+ const completed = await runtime.resume(started.runId, policy);
172
179
  if (completed.state !== 'completed' || completed.validation?.status !== 'accepted')
173
180
  throw new Error(`Runtime did not complete with accepted validation: ${completed.state}/${completed.validation?.status}`);
174
181
  const diff = await sandbox.diff(session.id);
@@ -92,19 +92,19 @@ function showHelp() {
92
92
  console.log(` ${cmd.padEnd(20)} - ${info.desc}`);
93
93
  console.log(` ${' '.repeat(20)} Exemplo: npm run dev -- ${info.example}\n`);
94
94
  }
95
- console.log(`Variaveis de ambiente:
96
- DEBUG=1 - Habilita verbose output
97
- DRY_RUN=1 - Simula execução sem fazer mudanças
98
-
99
- Exemplos:
100
-
101
- npm run dev -- context:build task my-project "payment feature"
102
- npm run dev -- memory:vacuum
103
- npm run dev -- memory:sync my-project
104
- npm run dev -- project:health
105
- npm run dev -- project:init awesome-app
106
- DEBUG=1 npm run dev -- project:health
107
-
95
+ console.log(`Variaveis de ambiente:
96
+ DEBUG=1 - Habilita verbose output
97
+ DRY_RUN=1 - Simula execução sem fazer mudanças
98
+
99
+ Exemplos:
100
+
101
+ npm run dev -- context:build task my-project "payment feature"
102
+ npm run dev -- memory:vacuum
103
+ npm run dev -- memory:sync my-project
104
+ npm run dev -- project:health
105
+ npm run dev -- project:init awesome-app
106
+ DEBUG=1 npm run dev -- project:health
107
+
108
108
  `);
109
109
  }
110
110
  /**
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * drift:check — "verified" continua verdade? (SPEC-030)
4
+ *
5
+ * forja drift:check reindexa o workspace e reporta drift estrutural
6
+ * forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
7
+ *
8
+ * Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
9
+ * para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
10
+ * com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
11
+ * status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
12
+ * extração + diff, igual ao extrator que já indexa o grafo (AC-4).
13
+ *
14
+ * Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
15
+ * julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
16
+ */
17
+ export {};
@@ -0,0 +1,63 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * drift:check — "verified" continua verdade? (SPEC-030)
4
+ *
5
+ * forja drift:check reindexa o workspace e reporta drift estrutural
6
+ * forja drift:check --domain <d> restringe aos documentos cujo path passa por /<d>/
7
+ *
8
+ * Reindexa via o mesmo mecanismo de `graph:sync` (checksum de fonte + extração determinística) e,
9
+ * para cada documento cujo conteúdo mudou, compara as relações `verified` que ele produzia antes
10
+ * com as que produz agora. Uma relação que sumiu vira `stale` (validTo carimbado, sem inventar
11
+ * status novo — GraphLoop já suporta validade temporal). Determinístico, sem LLM, sem rede: é
12
+ * extração + diff, igual ao extrator que já indexa o grafo (AC-4).
13
+ *
14
+ * Não corrige nada sozinho — só sinaliza. Decidir se o código ou a ADR/spec está desatualizada é
15
+ * julgamento humano ou de agente (SPEC-030 §5, fora de escopo deste comando).
16
+ */
17
+ import fs from 'node:fs';
18
+ import Database from 'better-sqlite3';
19
+ import { checkDrift } from "../lib/drift-sentinel.js";
20
+ import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
21
+ import { GraphLoop } from "../packages/graph/src/index.js";
22
+ import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
23
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
24
+ function arg(name) {
25
+ const i = process.argv.indexOf(name);
26
+ return i >= 0 ? process.argv[i + 1] ?? null : null;
27
+ }
28
+ function printReport(report, domain) {
29
+ console.log(`\nForja drift:check${domain ? ` --domain ${domain}` : ''} — o verified continua verdade?\n`);
30
+ console.log(`${report.documents} documento(s) verificado(s), ${report.unchanged} sem mudança, ${report.drifted} com drift detectado.\n`);
31
+ if (report.details.length === 0) {
32
+ console.log(report.changed > 0
33
+ ? `✓ ${report.changed} documento(s) mudaram, mas toda relação verified anterior continua reproduzível.`
34
+ : '✓ nenhum documento mudou desde a última indexação.');
35
+ return;
36
+ }
37
+ for (const drift of report.details) {
38
+ console.log(`✗ ${drift.sourceKey} — ${drift.stale.length} relação(ões) ficaram stale:`);
39
+ for (const relation of drift.stale)
40
+ console.log(` ${relation.type}: ${relation.from} → ${relation.to} — verified antes, não reproduzida pela extração atual`);
41
+ }
42
+ console.log(`\n${report.drifted} documento(s) com drift. As arestas acima ganharam validTo — somem de query()/path()/impact() por padrão, mas continuam auditáveis com o parâmetro --at de quem consultar o grafo.`);
43
+ console.log('drift:check só sinaliza — corrigir a ADR/spec desatualizada ou reverter o código é decisão humana/de agente, não deste comando.');
44
+ }
45
+ async function main() {
46
+ const domain = arg('--domain');
47
+ const graphRoot = process.env.FORJA_GRAPH_ROOT ?? process.cwd();
48
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
49
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
50
+ new SqliteMigrationRunner(database).apply();
51
+ const store = new SqliteGraphStore(database);
52
+ const graph = new GraphLoop(store);
53
+ const source = new GitGraphDocumentSource(graphRoot, new SpawnCommandRunner());
54
+ const report = await checkDrift(graph, store, source, domain === null ? {} : { domain });
55
+ database.close();
56
+ printReport(report, domain);
57
+ if (report.drifted > 0)
58
+ process.exit(1);
59
+ }
60
+ main().catch((error) => {
61
+ console.error(`\ndrift:check falhou: ${error instanceof Error ? error.message : String(error)}`);
62
+ process.exit(1);
63
+ });
@@ -0,0 +1,20 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
4
+ * construíram.
5
+ *
6
+ * forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
7
+ *
8
+ * Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
9
+ * ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
10
+ * architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
11
+ * D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
12
+ * (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
13
+ * recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
14
+ * verdade, não copiada aqui).
15
+ *
16
+ * Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
17
+ * seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
18
+ * chamada de LLM em nenhum ponto deste arquivo.
19
+ */
20
+ export {};
@@ -0,0 +1,208 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * engineer (SPEC-035, estendida por SPEC-042) — façade que compõe o que os Sprints 1-9 já
4
+ * construíram.
5
+ *
6
+ * forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]
7
+ *
8
+ * Ordem de composição (specs/engineering-evidence-ledger/plan.md, +SPEC-042):
9
+ * ContextEngine.build() → GraphLoop.contextRecords() filtrado a ADR/SPEC (SPEC-032) →
10
+ * architecture:check não escopado (SPEC-033) → RiskEngine.assess() só com --ref (SPEC-034,
11
+ * D1: sem diff ainda, não há arquivo pra escopar) → agentes recomendados só com --role
12
+ * (recommendAgent, SPEC-037) → incidentes parecidos (rankIncidentsByQuery, SPEC-041) → fluxo
13
+ * recomendado, parseado da tabela "Etapa → papel → comando" de docs/fluxo.md (D2 — uma fonte de
14
+ * verdade, não copiada aqui).
15
+ *
16
+ * Nenhuma lógica de negócio nova (AC-4/AC-3 de SPEC-035, reafirmado em AC-3 de SPEC-042): cada
17
+ * seção é exatamente o que o subsistema já produziu. Sem síntese de texto livre (AC-3) — não há
18
+ * chamada de LLM em nenhum ponto deste arquivo.
19
+ */
20
+ import fs from 'node:fs';
21
+ import path from 'node:path';
22
+ import { randomUUID } from 'node:crypto';
23
+ import Database from 'better-sqlite3';
24
+ import { ContextEngine, GraphContextSource } from "../packages/context/src/index.js";
25
+ import { checkConstitution } from "../packages/engineering/architecture/src/index.js";
26
+ import { assessRisk } from "../packages/engineering/risk/src/index.js";
27
+ import { recommendAgent } from "../packages/engineering/identity/src/index.js";
28
+ import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
29
+ import { GraphIndexer, GraphLoop } from "../packages/graph/src/index.js";
30
+ import { SqliteAgentProfileStore, SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
31
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
32
+ import { buildRiskInput, changedFiles, graphRoot } from "../lib/core/risk-collect.js";
33
+ import { incidentRecords, rankIncidentsByQuery, titleOf } from "../lib/core/incident-search.js";
34
+ const CONSTITUTION_PATH = '.context/architecture/constitution.json';
35
+ const FLUXO_PATH = 'docs/fluxo.md';
36
+ /** Parseia a tabela "Etapa → papel → comando → capacidade" de docs/fluxo.md — D2 do plan: uma fonte de verdade, não copiada aqui. */
37
+ function recommendedFlow() {
38
+ const file = path.join(graphRoot(), FLUXO_PATH);
39
+ if (!fs.existsSync(file))
40
+ return [];
41
+ const rowPattern = /^\|\s*(\d+)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|$/gm;
42
+ const steps = [];
43
+ for (const match of fs.readFileSync(file, 'utf8').matchAll(rowPattern)) {
44
+ steps.push({ numero: match[1], etapa: match[2], papel: match[3], comandos: match[4], capacidade: match[5] });
45
+ }
46
+ return steps;
47
+ }
48
+ function relevantAdrs(graph, objective) {
49
+ return graph.contextRecords(objective)
50
+ .filter((record) => /\bADR-\d{4}\b|\bSPEC-\d{3,4}\b/.test(record.content))
51
+ .slice(0, 10)
52
+ .map((record) => ({ content: record.content, relevance: record.relevance }));
53
+ }
54
+ async function buildReport(objective, ref, role) {
55
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
56
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
57
+ new SqliteMigrationRunner(database).apply();
58
+ try {
59
+ const store = new SqliteGraphStore(database);
60
+ const graph = new GraphLoop(store);
61
+ await new GraphIndexer(graph).sync(new GitGraphDocumentSource(graphRoot(), new SpawnCommandRunner()));
62
+ const context = await new ContextEngine({
63
+ graph: new GraphContextSource({ searchContext: (o) => graph.contextRecords(o) }),
64
+ // maxItems: 10 — sem isto, um objetivo genérico contra um repositório grande devolve
65
+ // centenas/milhares de candidatos (achado real: "compilar a architecture constitution deste
66
+ // repositório" contra este próprio repositório trouxe 1013). `forja engineer` é pra orientar
67
+ // o início do trabalho, não substituir `context:smart`/`code:query` — os 10 mais relevantes
68
+ // (já ordenados por `ContextEngine.build`) bastam pro humano decidir se e como prosseguir
69
+ // (AC-3/métrica §8); a lista completa continua disponível via os comandos focados.
70
+ }).build({ objective, budget: { inputTokens: 20000, outputTokens: 0, totalTokens: 20000, usedTokens: 0 }, includeContent: true, requireEvidence: false, maxItems: 10 });
71
+ const constitutionFile = path.join(graphRoot(), CONSTITUTION_PATH);
72
+ let architectureCheck;
73
+ if (fs.existsSync(constitutionFile)) {
74
+ const { rules } = JSON.parse(fs.readFileSync(constitutionFile, 'utf8'));
75
+ const edges = store.listEdges().flatMap((edge) => {
76
+ if (edge.type !== 'DEPENDS_ON')
77
+ return [];
78
+ const fromNode = store.getNode(edge.from);
79
+ const toNode = store.getNode(edge.to);
80
+ return fromNode === undefined || toNode === undefined ? [] : [{ fromPath: fromNode.label, targetLabel: toNode.label }];
81
+ });
82
+ architectureCheck = checkConstitution(rules, edges);
83
+ }
84
+ else {
85
+ architectureCheck = { note: 'Constitution não compilada ainda — rode `forja architecture:compile`.' };
86
+ }
87
+ let risk;
88
+ if (ref !== undefined) {
89
+ const paths = changedFiles(ref);
90
+ if (paths.length > 0) {
91
+ const input = await buildRiskInput(paths, database);
92
+ risk = assessRisk(input, { id: randomUUID(), changeId: ref, now: new Date().toISOString() });
93
+ }
94
+ }
95
+ // Só com --role: nunca inventa um papel que o usuário não informou (AC-1 de SPEC-042).
96
+ const recommendedAgents = role === undefined ? undefined : recommendAgent(new SqliteAgentProfileStore(database).list(), { role });
97
+ // Sempre presente (mesmo vazio) — incidentes parecidos com o objetivo, mesma busca por
98
+ // palavra-chave de `incident:similar` (AC-2 de SPEC-042).
99
+ const similarIncidents = rankIncidentsByQuery(incidentRecords(store), objective)
100
+ .slice(0, 5)
101
+ .map((item) => ({ id: item.record.id, title: titleOf(item.record), relevance: item.relevance }));
102
+ return {
103
+ objective,
104
+ ...(ref === undefined ? {} : { ref }),
105
+ ...(role === undefined ? {} : { role }),
106
+ context: { references: context.references.length, content: context.content },
107
+ relevantAdrs: relevantAdrs(graph, objective),
108
+ architectureCheck,
109
+ ...(risk === undefined ? {} : { risk }),
110
+ ...(recommendedAgents === undefined ? {} : { recommendedAgents }),
111
+ similarIncidents,
112
+ recommendedFlow: recommendedFlow(),
113
+ };
114
+ }
115
+ finally {
116
+ database.close();
117
+ }
118
+ }
119
+ function printText(report) {
120
+ console.log(`objetivo: ${report.objective}`);
121
+ if (report.ref !== undefined)
122
+ console.log(`ref: ${report.ref}`);
123
+ console.log('');
124
+ console.log(`CONTEXTO (${report.context.references} referência(s) do grafo)`);
125
+ if (report.context.content.length === 0)
126
+ console.log(' (nenhuma referência encontrada — objetivo novo, sem histórico ainda)');
127
+ for (const line of report.context.content)
128
+ console.log(` ${line}`);
129
+ console.log('');
130
+ console.log(`ADRs/SPECs RELEVANTES (${report.relevantAdrs.length})`);
131
+ if (report.relevantAdrs.length === 0)
132
+ console.log(' (nenhuma)');
133
+ for (const adr of report.relevantAdrs)
134
+ console.log(` [${adr.relevance.toFixed(2)}] ${adr.content}`);
135
+ console.log('');
136
+ console.log('ARCHITECTURE CHECK');
137
+ if ('note' in report.architectureCheck) {
138
+ console.log(` ${report.architectureCheck.note}`);
139
+ }
140
+ else {
141
+ console.log(` ${report.architectureCheck.compliant} regra(s) active em conformidade, ${report.architectureCheck.violations.length} violação(ões)`);
142
+ for (const violation of report.architectureCheck.violations)
143
+ console.log(` ${violation.severity.toUpperCase()} ${violation.file} viola ${violation.ruleId}`);
144
+ }
145
+ console.log('');
146
+ console.log('RISCO');
147
+ if (report.risk === undefined) {
148
+ console.log(' sem --ref — nenhuma mudança ainda para avaliar (rode com --ref <commit> quando houver um).');
149
+ }
150
+ else {
151
+ console.log(` score ${report.risk.score}/100 → ${report.risk.autonomyBand} (confidence ${(report.risk.confidence * 100).toFixed(0)}%)`);
152
+ }
153
+ console.log('');
154
+ if (report.recommendedAgents !== undefined) {
155
+ console.log(`AGENTES RECOMENDADOS (role: ${report.role})`);
156
+ if (report.recommendedAgents.length === 0)
157
+ console.log(' (nenhum agente registrado — rode forja agent:register primeiro)');
158
+ for (const item of report.recommendedAgents)
159
+ console.log(` ${item.agentId} score:${item.score} ${item.reasons.join(', ')}`);
160
+ console.log('');
161
+ }
162
+ console.log(`INCIDENTES PARECIDOS (${report.similarIncidents.length})`);
163
+ if (report.similarIncidents.length === 0)
164
+ console.log(' (nenhum)');
165
+ for (const item of report.similarIncidents)
166
+ console.log(` [${item.relevance.toFixed(2)}] ${item.id} ${item.title}`);
167
+ console.log('');
168
+ console.log('FLUXO RECOMENDADO (docs/fluxo.md)');
169
+ for (const step of report.recommendedFlow)
170
+ console.log(` ${step.numero}. ${step.etapa} (${step.papel}) — ${step.comandos}`);
171
+ }
172
+ async function cmdEngineer(args) {
173
+ const json = args.includes('--json');
174
+ const refIndex = args.indexOf('--ref');
175
+ const roleIndex = args.indexOf('--role');
176
+ const ref = refIndex === -1 ? undefined : args[refIndex + 1];
177
+ const role = roleIndex === -1 ? undefined : args[roleIndex + 1];
178
+ // Cada índice só entra em `consumed` quando a flag correspondente foi de fato encontrada — achado
179
+ // real da primeira versão deste arquivo: computar `refIndex + 1` incondicionalmente, mesmo com
180
+ // `refIndex === -1` (valendo 0), engolia o próprio objetivo quando nenhuma flag era passada.
181
+ const consumed = new Set();
182
+ if (refIndex !== -1) {
183
+ consumed.add(refIndex);
184
+ consumed.add(refIndex + 1);
185
+ }
186
+ if (roleIndex !== -1) {
187
+ consumed.add(roleIndex);
188
+ consumed.add(roleIndex + 1);
189
+ }
190
+ const objective = args.find((arg, index) => arg !== '--json' && !consumed.has(index));
191
+ if (!objective) {
192
+ console.error('Uso: forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json]');
193
+ process.exitCode = 1;
194
+ return;
195
+ }
196
+ const report = await buildReport(objective, ref, role);
197
+ if (json)
198
+ console.log(JSON.stringify(report, null, 2));
199
+ else
200
+ printText(report);
201
+ }
202
+ async function main() {
203
+ await cmdEngineer(process.argv.slice(2));
204
+ }
205
+ main().catch((error) => {
206
+ console.error(`\nengineer: falhou: ${error instanceof Error ? error.message : String(error)}`);
207
+ process.exitCode = 1;
208
+ });
@@ -0,0 +1,12 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * evidence:show (SPEC-035)
4
+ *
5
+ * forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
6
+ * aprovações, arquivos alterados — tudo já persistido
7
+ *
8
+ * `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
9
+ * (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
10
+ * `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
11
+ */
12
+ export {};
@@ -0,0 +1,55 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * evidence:show (SPEC-035)
4
+ *
5
+ * forja evidence:show <run-id> view agregada de evidência de um run: intent, agente, testes,
6
+ * aprovações, arquivos alterados — tudo já persistido
7
+ *
8
+ * `packages/engineering/evidence` faz o mapeamento puro; este script busca o `RuntimeRun` real
9
+ * (`SqliteRuntimeRunStore`), os `AuditRecord`s cujo `aggregateId` é o run (`SqliteAuditStore`) e as
10
+ * `ApprovalRequest`s cujo `correlationId` é o run (`ApprovalLedger`) — nenhuma tabela nova.
11
+ */
12
+ import fs from 'node:fs';
13
+ import Database from 'better-sqlite3';
14
+ import { buildEvidenceLedger } from "../packages/engineering/evidence/src/index.js";
15
+ import { ApprovalLedger } from "../packages/policy/src/index.js";
16
+ import { SqliteApprovalStore, SqliteAuditStore, SqliteMigrationRunner, SqliteRuntimeRunStore } from "../packages/adapter-sqlite/src/index.js";
17
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
18
+ function cmdShow([runId]) {
19
+ if (!runId) {
20
+ console.error('Uso: forja evidence:show <run-id>');
21
+ process.exitCode = 1;
22
+ return;
23
+ }
24
+ fs.mkdirSync(getWorkspaceDbDir(), { recursive: true });
25
+ const database = new Database(process.env.FORJA_RUNTIME_DB ?? getWorkspaceDbPath());
26
+ new SqliteMigrationRunner(database).apply();
27
+ try {
28
+ const run = new SqliteRuntimeRunStore(database).get(runId);
29
+ if (run === undefined) {
30
+ console.error(`Run não encontrado: ${runId}.`);
31
+ process.exitCode = 1;
32
+ return;
33
+ }
34
+ const auditRecords = new SqliteAuditStore(database).list().filter((record) => record.aggregateId === runId);
35
+ const approvals = new ApprovalLedger(new SqliteApprovalStore(database)).list().filter((request) => request.correlationId === runId);
36
+ const record = buildEvidenceLedger({ run, auditRecords, approvals });
37
+ console.log(JSON.stringify(record, null, 2));
38
+ }
39
+ finally {
40
+ database.close();
41
+ }
42
+ }
43
+ async function main() {
44
+ const [subcommand, ...rest] = process.argv.slice(2);
45
+ switch (subcommand) {
46
+ case 'show': return cmdShow(rest);
47
+ default:
48
+ console.error('Uso: forja evidence:show <run-id>');
49
+ process.exitCode = 1;
50
+ }
51
+ }
52
+ main().catch((error) => {
53
+ console.error(`\nevidence: falhou: ${error instanceof Error ? error.message : String(error)}`);
54
+ process.exitCode = 1;
55
+ });
@@ -12,11 +12,11 @@ function extractGlobalLessons() {
12
12
  console.log('🧠 Extraindo lições aprendidas de todos os projetos para Memória Global...');
13
13
  const db = new Database(dbPath, { readonly: true });
14
14
  // Busca ADRs (Decisões) de todos os projetos
15
- const adrs = db.prepare(`
16
- SELECT n.title, n.content, p.name as project
17
- FROM memory_nodes n
18
- JOIN projects p ON p.id = n.project_id
19
- WHERE n.kind = 'adr'
15
+ const adrs = db.prepare(`
16
+ SELECT n.title, n.content, p.name as project
17
+ FROM memory_nodes n
18
+ JOIN projects p ON p.id = n.project_id
19
+ WHERE n.kind = 'adr'
20
20
  `).all();
21
21
  let knowledgeBase = `# Base de Conhecimento Compartilhada (Patterns)\n\n`;
22
22
  knowledgeBase += `> Gerado automaticamente via Cross-Project Analysis em: ${new Date().toISOString()}\n\n`;
@@ -2,8 +2,12 @@
2
2
  /**
3
3
  * check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
4
4
  *
5
- * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
- * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
5
+ * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
+ * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
7
+ * forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
8
+ * reindexar o workspace inteiro não foi medido em repos grandes)
9
+ * forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
10
+ * mesmo motivo pra ser opt-in
7
11
  *
8
12
  * Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
9
13
  */
@@ -2,8 +2,12 @@
2
2
  /**
3
3
  * check:all — a bateria inteira de gates do framework, um veredito (SPEC-020).
4
4
  *
5
- * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
- * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
5
+ * forja check:all coerência (doctor) + projeto gerado (smoke barato)
6
+ * forja check:all --full + tarball (release:check) + build do gerado (smoke --full)
7
+ * forja check:all --with-drift + drift:check (SPEC-030) — opt-in, não roda por padrão (custo de
8
+ * reindexar o workspace inteiro não foi medido em repos grandes)
9
+ * forja check:all --with-architecture + architecture:check (SPEC-033) — mesmo custo de reindexar,
10
+ * mesmo motivo pra ser opt-in
7
11
  *
8
12
  * Não substitui os gates focados — os agrega. "A casa está coerente?" num comando só.
9
13
  */
@@ -11,10 +15,16 @@ import { runGates, overallStatus } from "../lib/core/gates.js";
11
15
  const TAG = { ok: 'OK ', warn: 'AVISO', fail: 'FALHA', skipped: '— ' };
12
16
  async function main() {
13
17
  const full = process.argv.includes('--full');
14
- console.log(`\nForja check:all${full ? ' (--full)' : ''} — a bateria inteira, um veredito\n`);
18
+ const withDrift = process.argv.includes('--with-drift');
19
+ const withArchitecture = process.argv.includes('--with-architecture');
20
+ console.log(`\nForja check:all${full ? ' (--full)' : ''}${withDrift ? ' (--with-drift)' : ''}${withArchitecture ? ' (--with-architecture)' : ''} — a bateria inteira, um veredito\n`);
15
21
  if (full)
16
22
  console.log('Inclui os gates caros (empacota o tarball, builda o backend gerado) — leva minutos.\n');
17
- const groups = await runGates({ full });
23
+ if (withDrift)
24
+ console.log('Inclui drift:check (SPEC-030) — reindexa o workspace inteiro por extração determinística.\n');
25
+ if (withArchitecture)
26
+ console.log('Inclui architecture:check (SPEC-033) — mesmo custo de reindexação de drift:check.\n');
27
+ const groups = await runGates({ full, withDrift, withArchitecture });
18
28
  for (const g of groups) {
19
29
  console.log(`▚ ${g.name}`);
20
30
  for (const r of g.results) {
@@ -17,21 +17,21 @@ function generate() {
17
17
  md += `| Projeto | ADRs | Summaries | Docs | Última Atividade |\n`;
18
18
  md += `|---------|------|-----------|------|-------------------|\n`;
19
19
  for (const p of projects) {
20
- const stats = db.prepare(`
21
- SELECT
22
- SUM(CASE WHEN kind = 'adr' THEN 1 ELSE 0 END) as adrs,
23
- SUM(CASE WHEN kind = 'summary' THEN 1 ELSE 0 END) as summaries,
24
- COUNT(*) as total,
25
- MAX(updated_at) as last_update
26
- FROM memory_nodes
27
- WHERE project_id = ?
20
+ const stats = db.prepare(`
21
+ SELECT
22
+ SUM(CASE WHEN kind = 'adr' THEN 1 ELSE 0 END) as adrs,
23
+ SUM(CASE WHEN kind = 'summary' THEN 1 ELSE 0 END) as summaries,
24
+ COUNT(*) as total,
25
+ MAX(updated_at) as last_update
26
+ FROM memory_nodes
27
+ WHERE project_id = ?
28
28
  `).get(p.id);
29
29
  md += `| **${p.name}** | ${stats.adrs} | ${stats.summaries} | ${stats.total} | ${stats.last_update.split('T')[0]} |\n`;
30
30
  }
31
31
  md += `\n## 🧠 Lições Globais Recentes\n\n`;
32
- const recentLessons = db.prepare(`
33
- SELECT title, path FROM memory_nodes
34
- WHERE kind = 'global' AND path LIKE '%shared-knowledge.md'
32
+ const recentLessons = db.prepare(`
33
+ SELECT title, path FROM memory_nodes
34
+ WHERE kind = 'global' AND path LIKE '%shared-knowledge.md'
35
35
  `).get();
36
36
  if (recentLessons) {
37
37
  md += `- [Clique aqui para ver a Base de Conhecimento Compartilhada](${recentLessons.path})\n`;