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,442 @@
1
+ # ForjaJS 3.0 — Engineering Intelligence / Engineering Twin — Architecture
2
+
3
+ - **Status**: draft — primeira entrega (auditoria + arquitetura proposta), sem implementação
4
+ - **Autor**: apk (com assistência do Forja Engineer via Claude)
5
+ - **Criado em**: 2026-09-01
6
+ - **ADR principal**: [ADR-0078](../../memory/90-decisions/0078-forjajs-3-engineering-control-plane.md)
7
+ - **Spec master**: [SPEC-031 — Engineering Intelligence](../../specs/engineering-intelligence/spec.md)
8
+
9
+ > Este documento é o produto da "primeira entrega" pedida antes de qualquer código: auditoria do
10
+ > estado atual, gap analysis, arquitetura proposta e plano de sprints. Nenhuma das 33 features
11
+ > listadas na visão original foi implementada a partir deste documento — ele existe para decidir
12
+ > **o que construir e em que ordem**, não para documentar o que já foi construído.
13
+
14
+ ---
15
+
16
+ ## 1. Current State — o que a Forja já é
17
+
18
+ A Forja 2.0 já é, hoje, uma plataforma real (não um protótipo) com os seguintes componentes
19
+ verificados em código, não em documentação:
20
+
21
+ | Pacote | O que já faz | Linhas (aprox.) |
22
+ |---|---|---|
23
+ | `packages/contracts` | Contratos versionados (`CONTRACT_VERSION = '2.0'`), `KnowledgeStatus`, `PolicyEffect`, `ExecutionState`, `SandboxState`, `GraphNode`/`GraphEdge`/`Evidence`, `RuntimeRun`, `ApprovalRequest`, `Sprint`/`Task`/`Handoff`, `Observation`, `ControlPlaneMetrics`, `EvaluationReport`, e (desde a auditoria de 2026-08-31) `isPathWithinRoot` | ~145 |
24
+ | `packages/graph` | **GraphLoop**: nós/arestas com `status: verified\|inferred\|hypothesis\|contradicted\|unknown`, validade temporal (`validFrom`/`validTo`), evidência ligada a aresta, `path()`/`impact()`/`contradictions()`/`agenda()`/`contextRecords()`. `GraphIndexer.sync()` é idempotente por checksum de fonte. `extractDeterministicRelations()` extrai `DEPENDS_ON`/`CALLS`/`IMPLEMENTS`/`DERIVED_FROM` (ADR)/`CONTAINS` (task)/`ASSIGNED_TO` (agent)/`VALIDATES` (test) por regex determinístico — **sem LLM**. Desde a auditoria, `status: 'verified'` só é aceito de fontes de evidência confiáveis (allowlist configurável) | ~410 |
25
+ | `packages/policy` | `PolicyEngine`: regras com `scope` (agente/role/capability/projeto/ambiente/risco/categoria/`pathPrefixes`), efeitos `ALLOW\|ALLOW_WITH_LIMITS\|REQUIRE_APPROVAL\|DENY`, `limits` (`maxTokens`/`maxFiles`/`maxDurationMs`/`maxRetries`, agora **aplicados de verdade**, não só computados), `ApprovalLedger` com resolução por `correlationId` (aprovar uma vez resolve o retry, não fica pedindo pra sempre) | ~230 |
26
+ | `packages/core` | `CapabilityRegistry`: registro de capabilities com `definition` (risco, side effects, permissões, timeout, retry), `execute()` chama `policy.authorize()` antes do handler, aplica `decision.limits` | ~240 |
27
+ | `packages/runtime` | `RuntimeEngine`: máquina de estados (`created→planning→running→awaiting_approval→validating→completed\|blocked\|failed`), checkpoint/retomada via SQLite, limites globais (`maxSteps`/`maxTokens`/`maxFiles`/`maxDurationMs`/`maxRetries`) | ~345 |
28
+ | `packages/validator` | `DeterministicValidator`: agrega checks/critérios de aceite, computa `scope` automaticamente contra `allowedFiles` do plano, **exige evidência para qualquer "passed"** (desde a auditoria) | ~95 |
29
+ | `packages/orchestration` | `SprintEngine`/`TaskEngine`/`HandoffEngine`: sprint→task→handoff com 7 campos obrigatórios (ADR-0005), guarda de concorrência otimista, teto de handoffs por `correlationId` | ~265 |
30
+ | `packages/sandbox` | `SandboxEngine`: máquina de estados `created→prepared→executing→validating→ready_to_promote→promoted\|rejected\|rolled_back→destroyed`. Desde hoje, `runSandboxedCapability()` empacota o ciclo completo em uma chamada reutilizável | ~220 |
31
+ | `packages/adapter-git` | `GitWorktreeBackend` (isolamento real via `git worktree`), `GitPatchApplier`, `SpawnCommandRunner` sem herdar env por padrão | ~150 |
32
+ | `packages/adapter-sqlite` | Stores SQLite para cada engine acima — memória, aprovações, sandbox, runtime, orquestração, auditoria, observações, grafo | ~300 |
33
+ | `packages/adapter-nest` | Adapter HTTP local (`ForjaNestAdapter`), autenticação **fail-closed a loopback** quando sem token (desde a auditoria) | ~130 |
34
+ | `packages/context` | `ContextEngine`: seleciona candidatos por relevância, deduplica por checksum, respeita orçamento de tokens, cacheia | ~175 |
35
+ | `packages/mcp` | Servidor MCP com ferramentas `forja_capability_execute`, `forja_handoff_create`, `forja_context_build`, `forja_memory_query`, `forja_graph_query`, `forja_code_impact`, `forja_task_next`, `forja_spec_check`, `forja_test_run`, `forja_execution_validate` — todas passam por `authorize()` desde a auditoria | ~260 |
36
+ | `packages/plugin-sdk` | `PluginRegistry`, manifesto com `permissions` explícitas, `PluginContext` que aplica `requirePermission()` antes de qualquer chamada ao host | ~90 |
37
+ | `packages/observability` | `ObservabilityRecorder`, `ControlPlane` (métricas agregadas: runs, sucesso, tokens, custo, evidência) | ~155 |
38
+ | `packages/events` | `EventBus` com idempotência, dead-letter, offsets — já é o barramento de eventos do sistema | ~150 |
39
+ | `packages/evals` | `EvaluationEngine`: agrega `Observation[]` em `EvaluationReport` por escopo (`run\|agent\|task\|sprint\|capability\|model\|strategy\|workspace`) | ~75 |
40
+ | `packages/planner` | `DeterministicPlanner`: decompõe objetivo em plano com dependências, risco, orçamento — **sem LLM** | ~90 |
41
+ | `apps/cli` | CLI real (`bin/forja.ts`) roteando ~50 comandos; nenhuma capability registrada aqui escreve em arquivos de projeto (todas são leitura, `context_run_record`, `handoff_record` ou `graph_write` — bookkeeping do framework, não edição de código) | — |
42
+ | `apps/server` | NestJS + REST/SSE, controle de acesso, fecha SQLite no shutdown | — |
43
+ | `apps/dashboard` | Next.js, proxy autenticado para o server, sem lógica de autorização própria | — |
44
+ | `apps/worker` | Processo separado para jobs longos | — |
45
+ | `scripts/demo-autonomy.ts` | **Prova end-to-end real** do ciclo completo: contexto → plano → política → aprovação humana → sandbox real (git worktree) → validação → promoção → grafo → sprint/task/handoff → evento — hoje o único lugar que fecha o círculo inteiro | — |
46
+
47
+ **O que isso significa**: a Forja já tem — implementados e testados, não apenas desenhados — quatro
48
+ das cinco peças que a visão de "Engineering Control Plane" precisa: um motor de política com
49
+ aprovação, um runtime supervisionado com checkpoint, um grafo de conhecimento com evidência e
50
+ validade temporal, e um sandbox real. **O que falta não é reinventar essas peças — é estender o
51
+ grafo para cobrir engenharia (não só código) e construir três motores novos por cima delas**
52
+ (Constitution, Risk, Provenance) mais um pouco de identidade/reputação de agente.
53
+
54
+ ## 2. Target State — o que a visão pede
55
+
56
+ Resumo dos 33 blocos da visão, agrupados pelas 5 perguntas que a Forja deveria conseguir responder
57
+ de forma estruturada e auditável ao final da evolução (ver §12 do documento original):
58
+
59
+ 1. **Por que o código existe** → Engineering Graph liga código a SPEC/ADR/Requirement.
60
+ 2. **A mudança viola a arquitetura** → Architecture Constitution + `architecture:check`.
61
+ 3. **Qual o risco** → Change Risk Engine + Risk-Based Autonomy (integrado ao Policy Engine já
62
+ existente, não um sistema paralelo).
63
+ 4. **Quem/o quê mudou isso** → AI Code Provenance (`forja blame`) + Agent Identity.
64
+ 5. **A Forja aprende com o passado** → Learning Loop + Incident Graph + Agent Reputation.
65
+
66
+ ## 3. Gap Analysis
67
+
68
+ | Capacidade pedida | Situação real | Classificação |
69
+ |---|---|---|
70
+ | Engineering Graph (nós Code/ADR/Spec/Agent/Run/Test/Incident/PR) | `GraphLoop` já é um grafo genérico com evidência e validade temporal; só faltam os **tipos de nó/aresta** de engenharia (ADR, SPEC, Agent, Run, Incident, PR) e os extratores que os populam | **Estender**, não recriar |
71
+ | Architecture Constitution | Não existe. `extractDeterministicRelations` já prova que extração determinística de ADR funciona (regex por `ADR-\d{4}`) — é a base para extrair `## Constraints` de forma determinística | **Construir**, reaproveitando o extrator |
72
+ | Architecture Drift Detection (`architecture:check`) | `specs/drift-sentinel` (em implementação nesta mesma sessão) já resolve a versão genérica ("uma relação verificada parou de ser reproduzida") — Architecture Drift é esse mesmo motor aplicado especificamente a regras da Constitution | **Compor** drift-sentinel + Constitution, não duplicar |
73
+ | Change Risk Engine | Não existe motor de score. Mas todos os insumos já existem: `GraphLoop.impact()` (blast radius), `EvaluationReport`/`Observation` (taxa histórica de falha), `PolicyEngine` (categoria/risco por regra) | **Construir**, compondo dados existentes |
74
+ | Risk-Based Autonomy | `PolicyEngine` já tem `ALLOW\|ALLOW_WITH_LIMITS\|REQUIRE_APPROVAL\|DENY` e `approvalRequiredRisks` configurável por `RiskLevel` | **Estender** `RiskLevel`/regras, não criar motor de decisão paralelo |
75
+ | Predictive Change Simulation (`forja simulate`) | `SandboxEngine` + `GitWorktreeBackend` + `runSandboxedCapability` (hoje) já são exatamente "aplicar em worktree isolado, testar, decidir promover ou descartar" | **Compor** sandbox + risk engine + architecture:check |
76
+ | ADR Graph / Decision Impact | `extractDeterministicRelations` já cria nós `ADR` e aresta `DERIVED_FROM` a partir de `ADR-\d{4}` no texto | **Estender** com status (`accepted/proposed/deprecated/superseded`) e `adr:impact` usando `GraphLoop.impact()` que já existe |
77
+ | `forja engineer` (façade) | Nada equivalente hoje — mas é literalmente uma composição de `ContextEngine` + `DeterministicPlanner` + `GraphLoop` + Risk Engine (novo) + `PolicyEngine`, todos já existentes | **Construir só a façade**, proibido reimplementar qualquer peça |
78
+ | Agent Identity | `AgentIdentity` já existe como tipo (`id`, `role`, `autonomy`) mas é efêmero — não é uma entidade persistida com histórico | **Estender** o contrato + persistência, não trocar o conceito |
79
+ | Agent Reputation / Project Evals | `EvaluationEngine`/`EvaluationReport` já agregam `Observation[]` por `scope: 'agent' \| 'model' \| ...` — a agregação existe, falta só o *report* voltado a reputação e o comando `agent:score` | **Estender**, não recriar |
80
+ | Smart Agent Routing | `scripts/llm-fit.ts`/`llm:recommend`/`llm:profiles` já fazem roteamento determinístico por papel/tarefa sem custo de rede ("LLM Fit Loop", ADR-0074) — é precisamente o esqueleto de Smart Routing | **Estender** com dados de reputação, não substituir |
81
+ | AI Code Provenance (`forja blame`) | `Observation` já tem `model`, `agentId`, `runId`, `inputHash`, `contextRefs` — falta ligar linha de código a `Observation`, o que exige um novo tipo de aresta no grafo (`GENERATED_BY`) | **Construir**, dado que os campos-fonte já existem |
82
+ | AI-SBOM | Não existe, mas é um relatório derivado do grafo de provenance — nenhuma nova fonte de dado, só agregação | **Construir** por cima do grafo |
83
+ | Agent Runtime Monitoring / Anomaly Engine | Não existe. `PolicyEngine` já é o lugar certo para acoplar (política decide, não o LLM) | **Construir**, mas *dentro* de Policy, não paralelo |
84
+ | Learning Loop / Incident → Knowledge | Não existe. `GraphLoop` + evidência já dão a base; falta o tipo de nó `Incident` e o fluxo de sugestão (nunca aplicação automática) | **Construir**, reaproveitando grafo + approvals |
85
+ | Autonomous Maintenance | Não existe nada além da base (`RuntimeEngine` + `PolicyEngine` + `SandboxEngine` já provam o ciclo supervisionado de ponta a ponta via `demo-autonomy.ts`) | **Fase 7** — arquitetar o caminho, não habilitar agora |
86
+ | Engineering API (`packages/engineering`, etc.) | Não existe como pacote — mas o padrão "domain core sem framework" já é a convenção de todo `packages/*` hoje | **Construir seguindo o padrão existente** |
87
+ | Provider-agnostic model layer | Já existe: `packages/llm` roteia por CLI adapter, sem acoplamento a um provider | **Nada a fazer** — só não violar |
88
+
89
+ **Conclusão do gap analysis**: nenhuma das 33 features exige reescrever nada que já existe. Todas
90
+ se apoiam em três extensões de contrato (tipos de nó/aresta no grafo, campos em `AgentIdentity`,
91
+ campos em `PolicyRule`) e quatro motores novos (Constitution, Risk, Provenance, Identity/Reputation)
92
+ que **compõem** engines existentes em vez de duplicá-las.
93
+
94
+ ## 4. Bounded Contexts propostos
95
+
96
+ Novo pacote: **`packages/engineering`** — não um pacote monolítico, mas um diretório com
97
+ sub-bounded-contexts próprios, cada um seguindo a mesma regra que já rege `packages/core`,
98
+ `packages/policy` etc.: **framework-independent, importa só `packages/contracts` e (quando preciso)
99
+ `packages/graph`**.
100
+
101
+ ```text
102
+ packages/engineering/
103
+ architecture/ ArchitectureEngine — compila Constitution, roda architecture:check
104
+ risk/ RiskEngine — score de mudança, fórmula configurável
105
+ provenance/ ProvenanceEngine — liga código a Observation/Run/Agent
106
+ identity/ AgentIdentityService, AgentReputationService
107
+ ```
108
+
109
+ Por que um pacote com sub-diretórios e não quatro pacotes `@forja/architecture`,
110
+ `@forja/risk`, etc.? Porque os quatro comportam contratos e regras de negócio da MESMA camada
111
+ (bounded contexts irmãos, não em cadeia de dependência um do outro) e crescem juntos nas mesmas
112
+ sprints (Fase 1). Divergir em pacotes separados antes de qualquer um deles estabilizar é
113
+ over-engineering — `packages/policy`/`packages/core`/`packages/runtime` só viraram pacotes
114
+ separados depois que a fronteira entre eles já estava provada em uso real (ADR-0020). Fica como
115
+ critério explícito de follow-up: se `engineering/risk` crescer a ponto de precisar de sua própria
116
+ release/versão independente de `engineering/architecture`, aí sim vira `packages/risk` — decisão
117
+ adiada de propósito, não ignorada.
118
+
119
+ `packages/engineering` depende de `packages/contracts` e `packages/graph` (para ler/escrever nós de
120
+ engenharia). **Não depende de `packages/policy`** — é o inverso: `PolicyEngine` opcionalmente
121
+ consulta um `RiskEngine` via uma interface pequena (`RiskAssessor`), não o contrário, preservando a
122
+ direção de dependência do ADR-0020 (`policy` não sabe de `engineering`; `engineering` não sabe de
123
+ `policy` — quem os compõe é a camada de aplicação, ex.: `forja engineer`).
124
+
125
+ ## 5. Arquitetura proposta
126
+
127
+ ```text
128
+ packages/contracts
129
+ │
130
+ packages/graph ◄──────────────┐
131
+ │ │
132
+ packages/engineering │
133
+ (architecture, risk, │
134
+ provenance, identity) │
135
+ │ │
136
+ ┌────────────┼────────────┐ │
137
+ │ │ │ │
138
+ packages/policy packages/planner │ │
139
+ │ │ │ │
140
+ └────────────┼────────────┘ │
141
+ │ │
142
+ packages/orchestration │
143
+ │ │
144
+ packages/runtime │
145
+ │ │
146
+ apps/cli · apps/server · packages/mcp ──────┘
147
+ (adapters — cada um compõe os engines,
148
+ nenhum reimplementa lógica)
149
+ ```
150
+
151
+ `packages/engineering` senta **entre** `graph` e `policy`/`planner`, na mesma posição de domínio
152
+ independente de framework descrita em `docs/architecture/FORJA-2.0-ARCHITECTURE.md` — mesma direção
153
+ de dependência (interfaces externas → adapters → application → domain core), estendida com uma
154
+ camada de domínio a mais.
155
+
156
+ ## 6. Data Model — extensões de contrato
157
+
158
+ Em `packages/contracts/src/index.ts`, aditivo (nunca remove campo existente — SPEC-012/`noImplicitAny`
159
+ já provou que este repo trata mudança de contrato como ratchet, não como reescrita):
160
+
161
+ ```ts
162
+ // Novos tipos de nó de engenharia — reaproveitam GraphNode.type (string livre) e
163
+ // GraphNode.status (KnowledgeStatus) já existentes. Não é um novo contrato de nó,
164
+ // é um VOCABULÁRIO de `type` documentado — igual o extractDeterministicRelations
165
+ // já faz hoje com 'Project'|'Document'|'File'|'Symbol'|'ADR'|'Task'|'Agent'|'Test'.
166
+ export const ENGINEERING_NODE_TYPES = [
167
+ 'ADR', 'SPEC', 'Requirement', 'BusinessRule', // já parcial (ADR)
168
+ 'Module', 'Class', 'Function', 'API', 'Worker', 'Table', // já parcial (File/Symbol)
169
+ 'Agent', 'Model', 'Run', 'Context', 'Tool', 'Capability', // Agent já existe
170
+ 'Test', 'Evaluation', 'Failure', 'Incident', // Test já existe
171
+ 'Commit', 'Branch', 'PullRequest', 'Release',
172
+ 'Approval', 'Policy', 'Risk', 'Evidence',
173
+ ] as const;
174
+
175
+ export const ENGINEERING_EDGE_TYPES = [
176
+ 'implements', 'depends_on', 'calls', 'imports', 'reads', 'writes', // parcial (DEPENDS_ON/CALLS)
177
+ 'defined_by', 'governed_by', 'violates', 'supersedes',
178
+ 'generated_by', 'reviewed_by', 'approved_by',
179
+ 'tested_by', 'failed_by',
180
+ 'changed_by', 'introduced_by', 'fixed_by',
181
+ 'affects', 'impacts', 'observed_in', 'deployed_in',
182
+ ] as const;
183
+
184
+ // Identidade de agente persistente — hoje AgentIdentity é efêmero (só id/role/autonomy).
185
+ export interface AgentProfile2 extends AuditFields {
186
+ readonly id: EntityId; // forja://agents/<slug>
187
+ readonly role: string;
188
+ readonly provider?: string;
189
+ readonly model?: string;
190
+ readonly capabilities: readonly string[];
191
+ readonly trustLevel: number; // 0-5, derivado por AgentReputationService — nunca setado à mão
192
+ readonly autonomyLevel: 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
193
+ readonly architectureDomains: readonly string[];
194
+ readonly limits?: { readonly maxFiles?: number; readonly maxCostUsd?: number; readonly maxDurationMs?: number };
195
+ }
196
+
197
+ // Regra de Architecture Constitution
198
+ export interface ArchitectureRule {
199
+ readonly id: string;
200
+ readonly source: string; // ex.: 'memory/90-decisions/0042-....md'
201
+ readonly sourceType: 'adr' | 'spec' | 'manual';
202
+ readonly status: 'active' | 'superseded' | 'proposed';
203
+ readonly scope: { readonly paths: readonly string[] };
204
+ readonly constraint: ArchitectureConstraint;
205
+ readonly severity: 'info' | 'low' | 'medium' | 'high' | 'critical';
206
+ readonly rationale: string;
207
+ readonly confidence: number; // 1.0 para regra explícita; < 1.0 só quando sourceType sugere via LLM e AINDA não foi aprovada por humano
208
+ }
209
+ export type ArchitectureConstraint =
210
+ | { readonly kind: 'forbid_import'; readonly patterns: readonly string[] }
211
+ | { readonly kind: 'require_dependency'; readonly symbols: readonly string[] }
212
+ | { readonly kind: 'forbid_dependency'; readonly symbols: readonly string[] };
213
+
214
+ // Risk score — nunca mágico, sempre com fatores nomeados (ver SPEC-035)
215
+ export interface ChangeRiskAssessment {
216
+ readonly score: number; // 0-100
217
+ readonly confidence: number; // 0-1
218
+ readonly factors: readonly { readonly name: string; readonly weight: number; readonly value: number; readonly evidenceIds: readonly EntityId[] }[];
219
+ readonly recommendedControls: readonly string[];
220
+ }
221
+ ```
222
+
223
+ Nenhum desses tipos precisa de tabela SQLite nova além do que `adapter-sqlite` já tem para
224
+ `GraphNode`/`GraphEdge`/`Evidence` — `ArchitectureRule` e `ChangeRiskAssessment` são **derivados em
225
+ tempo de leitura** (compilados/computados), não persistidos como fonte de verdade primária; o que
226
+ é persistido é o artefato compilado (`.context/architecture/constitution.json`, versionado em git,
227
+ não em SQLite — decisão explícita, ver §9).
228
+
229
+ ## 7. Engineering Graph Model — nós e arestas novos, concretamente
230
+
231
+ Extração determinística (sem LLM) a partir de fontes já lidas hoje pelo `GraphIndexer`:
232
+
233
+ | Documento fonte | Extrator | Nó(s) produzido(s) | Aresta(s) |
234
+ |---|---|---|---|
235
+ | `memory/90-decisions/NNNN-*.md` | já existe (`ADR-\d{4}` regex) — **estender** para ler `## Constraints` como lista determinística | `ADR` (com `status` do frontmatter, hoje ignorado — precisa passar a ler) | `governed_by` do módulo em `scope.paths` para o ADR |
236
+ | `specs/*/spec.md` | novo, mesmo padrão regex (`SPEC-\d{3}`, `## Escopo`) | `SPEC` | `implements` do módulo pra SPEC; `derived_from` da SPEC pro ADR referenciado |
237
+ | `.context/forja-runs.jsonl` / SQLite `runtime_*` | novo — já é dado estruturado, não precisa regex | `Run`, `Agent` (já existe), `Capability` (já existe via `GraphExecutionMemory`) | `generated_by` |
238
+ | `git log` (via `adapter-git`, já usado por `code:sync`) | novo, reaproveita `SpawnCommandRunner` já existente | `Commit` | `changed_by`, `introduced_by` |
239
+ | `test/*.test.js` | já parcial (`describe`/`it`/`test` regex existe) | `Test` (já existe) | `tested_by` |
240
+
241
+ **Importante — nada disso precisa de LLM.** O padrão do `extractDeterministicRelations` já provou
242
+ (código em produção, testado) que regex + parsing estruturado cobre ADR/SPEC/Task/Test/Agent/ADR.
243
+ LLM entra só como **sugestão opcional** de regra ambígua (§8), nunca como fonte de verdade do grafo.
244
+
245
+ ## 8. Architecture Constitution — design
246
+
247
+ Pipeline: `memory/90-decisions/*.md` (fonte legível por humano) → parser determinístico de
248
+ `## Constraints` (mesma técnica regex do extrator de grafo) → `ArchitectureRule[]` → compilado em
249
+ `.context/architecture/constitution.json` (versionado em git, revisável em PR como qualquer outro
250
+ artefato gerado — mesmo padrão de `.context/forja-runs.jsonl`).
251
+
252
+ Comandos propostos (nenhum existe ainda — nomenclatura sem prefixo `forja`, ver §12):
253
+
254
+ - `architecture:compile` — ADRs → `constitution.json` (determinístico)
255
+ - `architecture:check` — `constitution.json` vs. CodeGraph vs. código atual
256
+ - `architecture:status` — resumo: N regras ativas, última compilação
257
+ - `architecture:explain <rule-id>` — por que essa regra existe, qual ADR, qual severidade
258
+
259
+ `architecture:compile` **nunca** usa LLM para gerar uma regra `active` diretamente. Fluxo com LLM
260
+ (opcional, Fase 6+): quando um ADR tem `## Constraints` mal-formado ou ambíguo, o parser
261
+ determinístico produz uma regra com `confidence < 1.0` e `status: 'proposed'`; só passa a `active`
262
+ depois de `architecture:approve <rule-id>` (comando proposto, ver §12; reaproveita `ApprovalLedger` — **não** um sistema
263
+ de aprovação paralelo).
264
+
265
+ `architecture:check` reaproveita o mesmo motor de "isso que era verdade parou de ser" que o
266
+ `drift:check` (SPEC-030, em implementação nesta sessão) já constrói — arquitetura é um caso
267
+ particular de drift: a fonte é `constitution.json` em vez de um documento livre, e a comparação é
268
+ contra imports/dependências reais (via `CodeGraph`/`extractDeterministicRelations`, que já produz
269
+ arestas `DEPENDS_ON`) em vez de contra uma relação semântica textual qualquer.
270
+
271
+ ## 9. Change Risk Engine — design
272
+
273
+ Fórmula inicial, documentada e com pesos configuráveis (nunca hardcoded sem explicação — pedido
274
+ explícito da visão):
275
+
276
+ ```ts
277
+ interface RiskFactor { readonly name: string; readonly weight: number; readonly compute: (input: RiskInput) => number /* 0-1 */; }
278
+
279
+ const DEFAULT_RISK_FACTORS: readonly RiskFactor[] = [
280
+ { name: 'blast_radius', weight: 0.20, compute: /* GraphLoop.impact(origin).nodes.length, normalizado */ },
281
+ { name: 'architecture_violations', weight: 0.20, compute: /* count de architecture:check reprovado no diff */ },
282
+ { name: 'security_sensitivity',weight: 0.15, compute: /* categorias 'secrets'|'database'|'deployment' tocadas, já vocabulário de PolicyCategory */ },
283
+ { name: 'historical_failure_rate', weight: 0.15, compute: /* EvaluationReport do domínio/capability afetado */ },
284
+ { name: 'test_confidence', weight: 0.10, compute: /* cobertura de teste dos arquivos afetados, inverso */ },
285
+ { name: 'reversibility', weight: 0.10, compute: /* migration/schema change = baixa reversibilidade */ },
286
+ { name: 'deployment_complexity', weight: 0.10, compute: /* número de serviços/apps afetados */ },
287
+ ];
288
+
289
+ score = round(100 * Σ(factor.weight * factor.compute(input)))
290
+ ```
291
+
292
+ Todo fator carrega `evidenceIds` (nós/arestas do grafo, `Observation`s) — nunca um número solto.
293
+ `confidence` do assessment é a fração de fatores que tiveram dado real disponível (ex.: sem
294
+ histórico de falha nesse domínio ainda → esse fator entra com peso mas confiança reduzida,
295
+ declarado, não escondido).
296
+
297
+ Integração com `PolicyEngine` (§ visão original, Feature 4): **sem** motor de decisão paralelo.
298
+ `RiskLevel` (`'low'|'medium'|'high'|'critical'`) já é o vocabulário do `PolicyRule.scope.risks` e
299
+ de `approvalRequiredRisks` — a mudança é permitir que `PolicyRequest` opcionalmente carregue um
300
+ `riskScore: ChangeRiskAssessment` calculado por `RiskEngine` (interface pequena, injetada, igual
301
+ `request.policy` já é injetado hoje), e que uma regra de política possa referenciar faixas de score
302
+ (`scope.riskScoreRange?: [number, number]`) além de `risks: RiskLevel[]`. As faixas 0-25/26-50/51-
303
+ 75/76-100 sugeridas na visão viram os **valores default** de configuração, nunca constantes fixas
304
+ no código — mesmo princípio já usado em `RuntimeLimits`/`PolicyLimits` (default object, sempre
305
+ sobrescrevível).
306
+
307
+ ## 10. Engineering Evidence Ledger
308
+
309
+ Não é um sistema novo — é `Evidence`/`AuditRecord` (já existem em `packages/contracts`) mais
310
+ `SqliteAuditStore`/`SqliteObservationStore` (já existem em `packages/adapter-sqlite`), com um
311
+ formato de **exportação** append-only por run (o JSON de exemplo na visão — `run/intent/agent/risk/
312
+ architectureCheck/tests/approvals/commit`) construído a partir de dados que já são gravados hoje em
313
+ tabelas separadas. O trabalho real aqui é uma **view agregada**, não uma nova fonte de dado.
314
+
315
+ ## 11. API Contracts (packages/engineering)
316
+
317
+ ```ts
318
+ // packages/engineering/architecture/src/index.ts
319
+ export interface ArchitectureEngine {
320
+ compile(sources: { adrs: readonly string[]; specs: readonly string[] }): readonly ArchitectureRule[];
321
+ check(rules: readonly ArchitectureRule[], graph: GraphLoop): ArchitectureCheckReport;
322
+ explain(ruleId: string, rules: readonly ArchitectureRule[]): ArchitectureRuleExplanation;
323
+ }
324
+
325
+ // packages/engineering/risk/src/index.ts
326
+ export interface RiskEngine {
327
+ assess(input: RiskInput): ChangeRiskAssessment;
328
+ }
329
+ // Consumido opcionalmente por PolicyEngine via uma interface local pequena — PolicyEngine não
330
+ // importa @forja/engineering-risk, só uma interface estrutural (mesmo padrão de CapabilityPolicy
331
+ // hoje: PolicyEngine satisfaz a interface por forma, não por import direto).
332
+
333
+ // packages/engineering/provenance/src/index.ts
334
+ export interface ProvenanceEngine {
335
+ recordGeneration(input: { readonly files: readonly string[]; readonly lines?: readonly [number, number][]; readonly runId: RunId; readonly agentId: EntityId }): void;
336
+ blame(file: string, lineRange?: readonly [number, number]): readonly ProvenanceRecord[];
337
+ }
338
+
339
+ // packages/engineering/identity/src/index.ts
340
+ export interface AgentIdentityService { register(profile: AgentProfileInput): AgentProfile2; get(id: EntityId): AgentProfile2 | undefined; }
341
+ export interface AgentReputationService { score(agentId: EntityId, domain?: string): AgentReputationScore; }
342
+ ```
343
+
344
+ Cada um é **puro domínio** (sem `fs`/`spawnSync`/rede) — os adapters (`apps/cli`, `packages/mcp`,
345
+ `apps/server`) é que ligam a fontes reais (arquivos ADR, git log, SQLite).
346
+
347
+ ## 12. CLI Plan
348
+
349
+ Sem explosão de comandos — agrupado por domínio, uma façade principal (`engineer`) por cima do
350
+ resto. **Nenhum comando abaixo existe ainda** — esta é a superfície proposta para os Sprints 1-3;
351
+ por isso a tabela usa nome do comando sem o prefixo `forja`/`npm run` (convenção deste repositório
352
+ para citação de comando *proposto*, não real — ver `lib/core/doc-graph.ts`, `DOC_SURFACES`: `docs/`
353
+ é superfície que orienta o agente *agora*, então só cita comando que já existe no registry;
354
+ comando proposto pertence à spec que o define, referenciada na coluna "Spec").
355
+
356
+ | Domínio | Comando proposto | Spec |
357
+ |---|---|---|
358
+ | Façade | `engineer "<objetivo>"` — compõe tudo abaixo | SPEC-035 |
359
+ | Arquitetura | `architecture:compile` / `:check` / `:status` / `:explain <rule-id>` / `:approve <rule-id>` | SPEC-033 |
360
+ | Risco | `risk:assess "<mudança>"` / `:explain <assessment-id>` | SPEC-034 |
361
+ | ADR | `adr:list` / `:show <id>` / `:impact <id>` / `:graph` | SPEC-032 |
362
+ | Agente | `agent:list` / `:show` / `:score` / `:history` | Fase 3 (fora desta spec master) |
363
+ | Proveniência | `provenance:blame <arquivo>` / `:generate` (AI-SBOM) | Fase 5 (fora desta spec master) |
364
+ | Outros | `simulate "<mudança>"`, `explain <alvo>`, `timeline` | Fases 4/2 (fora desta spec master) |
365
+
366
+ `eval:*`, `route`, `learn:*`, `watch` ficam para Fases 3/6/7 — não fazem parte da primeira entrega
367
+ de comandos (P0).
368
+
369
+ ## 13. Events
370
+
371
+ Novos eventos no `EventBus` já existente (`packages/events`), sem barramento paralelo:
372
+
373
+ ```text
374
+ architecture.compiled architecture.violation_detected
375
+ change.risk_assessed
376
+ agent.identity_registered agent.reputation_updated
377
+ provenance.recorded
378
+ simulation.completed
379
+ incident.detected learning.proposed
380
+ ```
381
+
382
+ ## 14. Persistence
383
+
384
+ SQLite local-first, como todo o resto do framework. `constitution.json` é a única exceção
385
+ deliberada (artefato versionado em git, não em SQLite) — mesma categoria de `.context/forja-runs.jsonl`:
386
+ precisa ser revisável em PR por humano, não só consultável por comando.
387
+
388
+ ## 15. Security
389
+
390
+ Segue os princípios já estabelecidos e reforçados pela auditoria de 2026-08-31: local-first,
391
+ fail-closed em ambiguidade, LLM nunca é fonte de verdade para segurança crítica (Constitution:
392
+ regra `active` só de parser determinístico ou aprovação humana explícita — nunca de sugestão de
393
+ LLM direto).
394
+
395
+ ## 16. Policy Integration
396
+
397
+ Detalhado em §9. Resumo: `RiskEngine` é consumido por `PolicyEngine`, nunca o substitui.
398
+
399
+ ## 17. Migration Strategy / Compatibility
400
+
401
+ Toda extensão de contrato é aditiva (campos opcionais). Nenhum comando existente muda de
402
+ comportamento. `ENGINEERING_NODE_TYPES`/`ENGINEERING_EDGE_TYPES` são vocabulário adicional sobre o
403
+ `type: string` já livre de `GraphNode`/`GraphEdge` — zero migração de dado existente necessária.
404
+
405
+ ## 18. Test Strategy
406
+
407
+ Mesmo padrão do resto do repo: `node --test`, sem mocking framework, fixtures de fake
408
+ store/backend (ver `test/sandbox.test.js` para o padrão de referência). `ArchitectureEngine`/
409
+ `RiskEngine` são puros — testáveis sem I/O. Testes negativos obrigatórios para: regra de
410
+ Constitution mal-formada, risco com fator sem dado (confidence reduzida, não erro), Constitution
411
+ compilada de ADR sem `## Constraints` (vazio, não crash).
412
+
413
+ ## 19. Release Plan
414
+
415
+ Ver `specs/engineering-intelligence/plan.md` para o detalhamento em sprints — resumo:
416
+
417
+ - **Sprint 1**: `packages/engineering/architecture` (Constitution compile/check/explain) +
418
+ extração de `ADR`/`SPEC` no grafo.
419
+ - **Sprint 2**: `packages/engineering/risk` (RiskEngine) + integração `PolicyEngine`.
420
+ - **Sprint 3**: Evidence Ledger (view agregada) + `forja engineer` (façade mínima, sem routing/
421
+ identity ainda).
422
+ - Fases 2-7 da visão original ficam para specs subsequentes, quebradas quando Sprint 1-3 estiver
423
+ em produção e puder informar as decisões de design das fases seguintes (Agent Identity, em
424
+ particular, se beneficia de já ter dados reais de `RiskEngine`/`ArchitectureEngine` rodando).
425
+
426
+ ## 20. Riscos
427
+
428
+ | Risco | Mitigação |
429
+ |---|---|
430
+ | `packages/engineering` virar um monólito acoplado | Sub-diretórios com fronteira de interface clara desde o dia 1 (§4); nenhum dos quatro importa os outros três diretamente |
431
+ | Risk score "mágico" sem explicação | Fórmula documentada em código E neste doc (§9); todo `ChangeRiskAssessment` carrega `factors[]` com `evidenceIds` |
432
+ | Architecture Constitution virar fonte de falso-positivo (ruído) | Reaproveita a mesma mitigação já desenhada para drift-sentinel: comparação por relação semântica (import/depend), não por hash de texto |
433
+ | Confundir sugestão de LLM com regra ativa | `confidence`/`status: 'proposed'` obrigatórios em qualquer regra não-determinística; `active` só por parser ou aprovação humana |
434
+
435
+ ## 21. Open Questions
436
+
437
+ 1. `AgentProfile2` é um nome provisório — o contrato final substitui ou convive com
438
+ `AgentIdentity` atual? (Decisão de ADR-0078, marcada como aberta até Sprint 3.)
439
+ 2. `constitution.json` versionado em git — e se dois branches compilarem regras conflitantes?
440
+ Fica para o design de `architecture:compile` (Sprint 1), não bloqueia a arquitetura geral.
441
+ 3. Onde mora o limite entre "Change Risk Engine" e "Policy Engine" quando os dois crescerem —
442
+ revisar depois que `RiskEngine` tiver uso real (Sprint 2 retro).