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,57 @@
1
+ /**
2
+ * @forja/engineering-identity — Agent Reputation (SPEC-036) + Smart Agent Routing (SPEC-037).
3
+ *
4
+ * Domínio puro: `computeReputationScore` recebe um `EvaluationReport` já produzido por
5
+ * `packages/evals.EvaluationEngine` (reaproveitado, não reimplementado — nenhuma métrica nova
6
+ * calculada aqui) e devolve um `AgentReputationScore`. `recommendAgent` classifica
7
+ * `AgentProfile2[]` (já registrados/pontuados) por adequação a um papel/domínio — não confundir
8
+ * com `packages/llm.recommendProfile` (routing de provider/model de LLM, problema adjacente, não
9
+ * o mesmo; ver nota no topo de `specs/smart-agent-routing/spec.md`). Nenhum `fs`/rede/SQLite — a
10
+ * persistência (`SqliteAgentProfileStore`) e a coleta de `Observation`s vivem em `scripts/agent.ts`.
11
+ */
12
+ import type { AgentProfile2, EvaluationReport } from '../../../contracts/src/index.ts';
13
+ export type AutonomyLevel = 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
14
+ export interface AgentReputationScore {
15
+ readonly agentId: string;
16
+ readonly domain?: string;
17
+ /** 0-5. */
18
+ readonly trustLevel: number;
19
+ readonly autonomyLevel: AutonomyLevel;
20
+ /** 0-1 — proporcional ao tamanho da amostra, nunca escondida (AC-2). */
21
+ readonly confidence: number;
22
+ readonly sampleSize: number;
23
+ readonly metrics: Readonly<Record<string, number>>;
24
+ readonly evidenceIds: readonly string[];
25
+ }
26
+ export interface ReputationThresholds {
27
+ /** Abaixo disso, `autonomyLevel` é sempre `human_in_the_loop` — fail-closed em cold start (AC-3). */
28
+ readonly minSampleSize: number;
29
+ /** `trustLevel` mínimo (escala 0-5) para cada banda, do mais alto para o mais baixo. */
30
+ readonly autonomous: number;
31
+ readonly autonomousWithReview: number;
32
+ readonly supervised: number;
33
+ }
34
+ /** Sugeridos na visão original — configuração default, nunca constante fixa (mesmo princípio de RiskEngine/SPEC-034). */
35
+ export declare const DEFAULT_REPUTATION_THRESHOLDS: ReputationThresholds;
36
+ export declare function computeReputationScore(report: EvaluationReport, meta: {
37
+ readonly agentId: string;
38
+ readonly domain?: string;
39
+ readonly thresholds?: ReputationThresholds;
40
+ }): AgentReputationScore;
41
+ export interface AgentRecommendation {
42
+ readonly agentId: string;
43
+ readonly score: number;
44
+ readonly reasons: readonly string[];
45
+ }
46
+ export interface AgentRecommendationCriteria {
47
+ readonly role: string;
48
+ readonly domain?: string;
49
+ }
50
+ /**
51
+ * `score` = (role casado ? 100 : 0) + (domain casado em `architectureDomains` ? 50 : 0) +
52
+ * (`trustLevel` ?? 0) · 10 (0-50) — mesma proporção de pesos de `packages/llm.recommendProfile`
53
+ * (D1 do plan), nunca "número mágico". Um agente sem `trustLevel` ainda **não é excluído** do
54
+ * ranking (AC-2) — o termo de reputação entra como 0 e o motivo declara isso explicitamente, nunca
55
+ * finge um trust level que não existe.
56
+ */
57
+ export declare function recommendAgent(profiles: readonly AgentProfile2[], criteria: AgentRecommendationCriteria): readonly AgentRecommendation[];
@@ -0,0 +1,88 @@
1
+ /**
2
+ * @forja/engineering-identity — Agent Reputation (SPEC-036) + Smart Agent Routing (SPEC-037).
3
+ *
4
+ * Domínio puro: `computeReputationScore` recebe um `EvaluationReport` já produzido por
5
+ * `packages/evals.EvaluationEngine` (reaproveitado, não reimplementado — nenhuma métrica nova
6
+ * calculada aqui) e devolve um `AgentReputationScore`. `recommendAgent` classifica
7
+ * `AgentProfile2[]` (já registrados/pontuados) por adequação a um papel/domínio — não confundir
8
+ * com `packages/llm.recommendProfile` (routing de provider/model de LLM, problema adjacente, não
9
+ * o mesmo; ver nota no topo de `specs/smart-agent-routing/spec.md`). Nenhum `fs`/rede/SQLite — a
10
+ * persistência (`SqliteAgentProfileStore`) e a coleta de `Observation`s vivem em `scripts/agent.ts`.
11
+ */
12
+ /** Sugeridos na visão original — configuração default, nunca constante fixa (mesmo princípio de RiskEngine/SPEC-034). */
13
+ export const DEFAULT_REPUTATION_THRESHOLDS = {
14
+ minSampleSize: 5,
15
+ autonomous: 4,
16
+ autonomousWithReview: 3,
17
+ supervised: 1,
18
+ };
19
+ /**
20
+ * `trustLevel` = 0.5·successRate + 0.2·(1-reworkRate) + 0.2·(1-rollbackRate) +
21
+ * 0.1·(1-assertionsWithoutEvidenceRate), escalado 0-5. Pesos documentados aqui e no plan
22
+ * (D1) — nunca "número mágico" (mesmo princípio de RiskEngine).
23
+ *
24
+ * `sampleSize === 0` é tratado à parte, ANTES da fórmula: `EvaluationEngine.rate()` devolve `0`
25
+ * (não `undefined`) para toda métrica quando não há `Observation` nenhuma — a fórmula acima leria
26
+ * esses zeros de "sem dado" como reworkRate/rollbackRate/assertionsWithoutEvidenceRate = 0 (bom
27
+ * sinal!) e produziria um trustLevel médio (~3/5) sem nenhuma evidência real por trás. Isso
28
+ * contradiz AC-2 ("nunca escondida"): 0 observações é 0 de confiança, não neutro.
29
+ */
30
+ function trustLevelFrom(metrics, sampleSize) {
31
+ if (sampleSize === 0)
32
+ return 0;
33
+ const successRate = metrics.successRate ?? 0;
34
+ const reworkRate = metrics.reworkRate ?? 0;
35
+ const rollbackRate = metrics.rollbackRate ?? 0;
36
+ const assertionsWithoutEvidenceRate = metrics.assertionsWithoutEvidenceRate ?? 0;
37
+ const raw = 0.5 * successRate + 0.2 * (1 - reworkRate) + 0.2 * (1 - rollbackRate) + 0.1 * (1 - assertionsWithoutEvidenceRate);
38
+ return Math.min(5, Math.max(0, Math.round(raw * 5)));
39
+ }
40
+ function autonomyLevelFor(trustLevel, sampleSize, thresholds) {
41
+ if (sampleSize < thresholds.minSampleSize)
42
+ return 'human_in_the_loop';
43
+ if (trustLevel >= thresholds.autonomous)
44
+ return 'autonomous';
45
+ if (trustLevel >= thresholds.autonomousWithReview)
46
+ return 'autonomous_with_review';
47
+ if (trustLevel >= thresholds.supervised)
48
+ return 'supervised';
49
+ return 'human_in_the_loop';
50
+ }
51
+ export function computeReputationScore(report, meta) {
52
+ const thresholds = meta.thresholds ?? DEFAULT_REPUTATION_THRESHOLDS;
53
+ const sampleSize = report.metrics.observationCount ?? report.observationIds.length;
54
+ const trustLevel = trustLevelFrom(report.metrics, sampleSize);
55
+ return {
56
+ agentId: meta.agentId,
57
+ ...(meta.domain === undefined ? {} : { domain: meta.domain }),
58
+ trustLevel,
59
+ autonomyLevel: autonomyLevelFor(trustLevel, sampleSize, thresholds),
60
+ confidence: Math.min(1, sampleSize / thresholds.minSampleSize),
61
+ sampleSize,
62
+ metrics: report.metrics,
63
+ evidenceIds: report.observationIds,
64
+ };
65
+ }
66
+ /**
67
+ * `score` = (role casado ? 100 : 0) + (domain casado em `architectureDomains` ? 50 : 0) +
68
+ * (`trustLevel` ?? 0) · 10 (0-50) — mesma proporção de pesos de `packages/llm.recommendProfile`
69
+ * (D1 do plan), nunca "número mágico". Um agente sem `trustLevel` ainda **não é excluído** do
70
+ * ranking (AC-2) — o termo de reputação entra como 0 e o motivo declara isso explicitamente, nunca
71
+ * finge um trust level que não existe.
72
+ */
73
+ export function recommendAgent(profiles, criteria) {
74
+ return profiles
75
+ .map((profile) => {
76
+ const roleMatch = profile.role === criteria.role;
77
+ const domainMatch = criteria.domain !== undefined && profile.architectureDomains.includes(criteria.domain);
78
+ const trustLevel = profile.trustLevel;
79
+ const score = (roleMatch ? 100 : 0) + (domainMatch ? 50 : 0) + (trustLevel ?? 0) * 10;
80
+ const reasons = [
81
+ ...(roleMatch ? [`role:${criteria.role}`] : []),
82
+ ...(domainMatch ? [`domain:${criteria.domain}`] : []),
83
+ ...(trustLevel === undefined ? ['sem pontuação ainda — rode agent:score'] : [`trustLevel ${trustLevel}/5 (${profile.autonomyLevel})`]),
84
+ ];
85
+ return { agentId: profile.id, score, reasons };
86
+ })
87
+ .sort((left, right) => right.score - left.score || left.agentId.localeCompare(right.agentId));
88
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * @forja/engineering-monitoring — Agent Runtime Monitoring / Behavior Anomaly Engine (SPEC-040).
3
+ *
4
+ * Domínio puro: `detectAnomaly` compara dois `EvaluationReport` (linha de base + recente, ambos já
5
+ * produzidos por `packages/evals.EvaluationEngine` — nenhuma métrica reimplementada aqui) e devolve
6
+ * um `AnomalyAssessment`. Nenhum `fs`/rede/SQLite — a coleta de `Observation`s por janela de tempo
7
+ * vive em `scripts/agent.ts`.
8
+ *
9
+ * "Dentro de Policy, não paralelo" (gap analysis original): o cálculo mora aqui, separado; a
10
+ * *decisão* continua sendo do `PolicyEngine`/humano — `packages/policy` ganha um campo `number`
11
+ * opcional (`anomalyScore`) pra consultar isto, exatamente como `riskScore` já faz pra risco
12
+ * (SPEC-034 D3). `detectAnomaly` nunca decide nada sozinho.
13
+ */
14
+ import type { EvaluationReport } from '../../../contracts/src/index.ts';
15
+ export interface AnomalySignal {
16
+ readonly metric: string;
17
+ readonly baseline: number;
18
+ readonly recent: number;
19
+ readonly delta: number;
20
+ }
21
+ export interface AnomalyAssessment {
22
+ readonly agentId: string;
23
+ /** 0-100. */
24
+ readonly score: number;
25
+ /** 0-1 — proporcional ao menor dos dois tamanhos de amostra, nunca escondida (AC-2). */
26
+ readonly confidence: number;
27
+ readonly signals: readonly AnomalySignal[];
28
+ }
29
+ /**
30
+ * `score` = 0.5·max(0, -ΔsuccessRate) + 0.25·max(0, ΔreworkRate) + 0.25·max(0, ΔrollbackRate),
31
+ * escalado 0-100 — mesmo vocabulário de métricas de `computeReputationScore` (D1 do plan, SPEC-036),
32
+ * só o sinal muda (aqui é desvio de linha de base, não nível absoluto). Só a direção "ruim" de cada
33
+ * métrica conta — sucesso subindo ou retrabalho/rollback caindo nunca aumentam o score.
34
+ */
35
+ export declare function detectAnomaly(agentId: string, baseline: EvaluationReport, recent: EvaluationReport, options?: {
36
+ readonly minSampleSize?: number;
37
+ }): AnomalyAssessment;
@@ -0,0 +1,40 @@
1
+ /**
2
+ * @forja/engineering-monitoring — Agent Runtime Monitoring / Behavior Anomaly Engine (SPEC-040).
3
+ *
4
+ * Domínio puro: `detectAnomaly` compara dois `EvaluationReport` (linha de base + recente, ambos já
5
+ * produzidos por `packages/evals.EvaluationEngine` — nenhuma métrica reimplementada aqui) e devolve
6
+ * um `AnomalyAssessment`. Nenhum `fs`/rede/SQLite — a coleta de `Observation`s por janela de tempo
7
+ * vive em `scripts/agent.ts`.
8
+ *
9
+ * "Dentro de Policy, não paralelo" (gap analysis original): o cálculo mora aqui, separado; a
10
+ * *decisão* continua sendo do `PolicyEngine`/humano — `packages/policy` ganha um campo `number`
11
+ * opcional (`anomalyScore`) pra consultar isto, exatamente como `riskScore` já faz pra risco
12
+ * (SPEC-034 D3). `detectAnomaly` nunca decide nada sozinho.
13
+ */
14
+ const DEFAULT_MIN_SAMPLE_SIZE = 5;
15
+ function signal(metric, baseline, recent) {
16
+ const baselineValue = baseline[metric] ?? 0;
17
+ const recentValue = recent[metric] ?? 0;
18
+ return { metric, baseline: baselineValue, recent: recentValue, delta: recentValue - baselineValue };
19
+ }
20
+ /**
21
+ * `score` = 0.5·max(0, -ΔsuccessRate) + 0.25·max(0, ΔreworkRate) + 0.25·max(0, ΔrollbackRate),
22
+ * escalado 0-100 — mesmo vocabulário de métricas de `computeReputationScore` (D1 do plan, SPEC-036),
23
+ * só o sinal muda (aqui é desvio de linha de base, não nível absoluto). Só a direção "ruim" de cada
24
+ * métrica conta — sucesso subindo ou retrabalho/rollback caindo nunca aumentam o score.
25
+ */
26
+ export function detectAnomaly(agentId, baseline, recent, options) {
27
+ const minSampleSize = options?.minSampleSize ?? DEFAULT_MIN_SAMPLE_SIZE;
28
+ const signals = [
29
+ signal('successRate', baseline.metrics, recent.metrics),
30
+ signal('reworkRate', baseline.metrics, recent.metrics),
31
+ signal('rollbackRate', baseline.metrics, recent.metrics),
32
+ ];
33
+ const [successSignal, reworkSignal, rollbackSignal] = signals;
34
+ const raw = 0.5 * Math.max(0, -successSignal.delta) + 0.25 * Math.max(0, reworkSignal.delta) + 0.25 * Math.max(0, rollbackSignal.delta);
35
+ const score = Math.min(100, Math.max(0, Math.round(raw * 100)));
36
+ const baselineSampleSize = baseline.metrics.observationCount ?? baseline.observationIds.length;
37
+ const recentSampleSize = recent.metrics.observationCount ?? recent.observationIds.length;
38
+ const confidence = Math.min(1, Math.min(baselineSampleSize, recentSampleSize) / minSampleSize);
39
+ return { agentId, score, confidence, signals };
40
+ }
@@ -0,0 +1,25 @@
1
+ /**
2
+ * @forja/engineering-provenance — AI Code Provenance (SPEC-039).
3
+ *
4
+ * Domínio puro: `extractProvenance` mapeia um `RuntimeRun` já persistido (`packages/contracts`,
5
+ * `changedFiles`+`agent` já existentes) para `ProvenanceRecord[]` — um por arquivo. Nenhum `fs`/
6
+ * rede/SQLite aqui; a persistência (`SqliteProvenanceStore`) e a leitura do `RuntimeRun` vivem em
7
+ * `scripts/provenance.ts`.
8
+ *
9
+ * Granularidade é **arquivo**, não linha (AC-2, `ProvenanceRecord.lines` sempre `undefined` nesta
10
+ * spec) — nenhuma fonte de dado real deste repositório rastreia hunks de linha por run hoje, e
11
+ * fingir essa granularidade seria inventar precisão que os dados não sustentam.
12
+ */
13
+ import type { RuntimeRun } from '../../../contracts/src/index.ts';
14
+ export interface ProvenanceRecord {
15
+ readonly file: string;
16
+ readonly runId: string;
17
+ readonly agentId: string;
18
+ readonly agentName: string;
19
+ /** Sempre `undefined` — `AgentIdentity` (o tipo de `RuntimeRun.agent`) não carrega um campo de modelo de LLM hoje. Presente no tipo para não quebrar quando uma fonte real desse dado existir. */
20
+ readonly model?: string;
21
+ /** Sempre `undefined` nesta spec — ver nota no topo do arquivo. Presente no tipo pela mesma razão de `model`. */
22
+ readonly lines?: readonly [number, number][];
23
+ readonly recordedAt: string;
24
+ }
25
+ export declare function extractProvenance(run: RuntimeRun): readonly ProvenanceRecord[];
@@ -0,0 +1,21 @@
1
+ /**
2
+ * @forja/engineering-provenance — AI Code Provenance (SPEC-039).
3
+ *
4
+ * Domínio puro: `extractProvenance` mapeia um `RuntimeRun` já persistido (`packages/contracts`,
5
+ * `changedFiles`+`agent` já existentes) para `ProvenanceRecord[]` — um por arquivo. Nenhum `fs`/
6
+ * rede/SQLite aqui; a persistência (`SqliteProvenanceStore`) e a leitura do `RuntimeRun` vivem em
7
+ * `scripts/provenance.ts`.
8
+ *
9
+ * Granularidade é **arquivo**, não linha (AC-2, `ProvenanceRecord.lines` sempre `undefined` nesta
10
+ * spec) — nenhuma fonte de dado real deste repositório rastreia hunks de linha por run hoje, e
11
+ * fingir essa granularidade seria inventar precisão que os dados não sustentam.
12
+ */
13
+ export function extractProvenance(run) {
14
+ return run.changedFiles.map((file) => ({
15
+ file,
16
+ runId: run.runId,
17
+ agentId: run.agent.id,
18
+ agentName: run.agent.name,
19
+ recordedAt: run.updatedAt,
20
+ }));
21
+ }
@@ -0,0 +1,89 @@
1
+ /**
2
+ * @forja/engineering-risk — Change Risk Engine (SPEC-034).
3
+ *
4
+ * Domínio puro: nenhum `fs`/rede/SQLite aqui. `assessRisk` recebe métricas já coletadas por um
5
+ * adapter (`scripts/risk.ts`) e aplica a fórmula documentada em
6
+ * `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md` §9: 7 fatores nomeados,
7
+ * pesos configuráveis (nunca constante escondida), cada fator carregando os `evidenceIds` que o
8
+ * adapter coletou — o engine nunca inventa evidência, só soma o que recebeu (AC-2).
9
+ */
10
+ export type RiskFactorName = 'blast_radius' | 'architecture_violations' | 'security_sensitivity' | 'historical_failure_rate' | 'test_confidence' | 'reversibility' | 'deployment_complexity';
11
+ export type RiskWeights = Readonly<Record<RiskFactorName, number>>;
12
+ /** Pesos default do §9 do doc de arquitetura — somam 1.0. Sempre sobrescrevíveis via `options.weights` (AC-1). */
13
+ export declare const DEFAULT_RISK_WEIGHTS: RiskWeights;
14
+ export interface AutonomyBandThresholds {
15
+ /** Score máximo (inclusive) ainda considerado 'autonomous'. */
16
+ readonly autonomous: number;
17
+ /** Score máximo (inclusive) ainda 'autonomous_with_review'. */
18
+ readonly autonomousWithReview: number;
19
+ /** Score máximo (inclusive) ainda 'supervised'; acima disso, 'human_in_the_loop'. */
20
+ readonly supervised: number;
21
+ }
22
+ /** Faixas sugeridas na visão original (0-25/26-50/51-75/76-100) — configuração default, nunca constante fixa (AC-6). */
23
+ export declare const DEFAULT_AUTONOMY_BAND_THRESHOLDS: AutonomyBandThresholds;
24
+ export type AutonomyBand = 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
25
+ /**
26
+ * Métricas cruas já coletadas pelo adapter (grafo, `architecture:check`, `Observation` histórica,
27
+ * heurísticas de path). Cada campo tem seu par de evidência — nada entra no score sem rastro de
28
+ * onde veio (AC-2). Campos `?:` (histórico, teste) podem ser `undefined` — cold start é esperado,
29
+ * não erro (AC-3, D4 do plan).
30
+ */
31
+ export interface RiskInput {
32
+ readonly blastRadiusCount: number;
33
+ readonly blastRadiusEvidenceIds: readonly string[];
34
+ readonly architectureViolationCount: number;
35
+ readonly architectureViolationEvidenceIds: readonly string[];
36
+ readonly sensitiveCategoriesTouched: readonly string[];
37
+ readonly sensitiveCategoryEvidenceIds: readonly string[];
38
+ readonly historicalFailureRate?: number;
39
+ readonly historicalEvidenceIds: readonly string[];
40
+ readonly testedPathsRatio?: number;
41
+ readonly testEvidenceIds: readonly string[];
42
+ readonly touchesSchemaOrMigration: boolean;
43
+ readonly reversibilityEvidenceIds: readonly string[];
44
+ readonly affectedServiceCount: number;
45
+ readonly totalServiceCount: number;
46
+ readonly deploymentEvidenceIds: readonly string[];
47
+ }
48
+ export interface RiskFactorResult {
49
+ readonly name: RiskFactorName;
50
+ readonly weight: number;
51
+ /** Normalizado 0-1. */
52
+ readonly value: number;
53
+ /** `false` = cold start / dado indisponível; o fator ainda participa do score (com valor neutro), mas `confidence` cai. */
54
+ readonly hasRealData: boolean;
55
+ readonly evidenceIds: readonly string[];
56
+ readonly rationale: string;
57
+ }
58
+ export interface ChangeRiskAssessment {
59
+ readonly id: string;
60
+ readonly changeId: string;
61
+ readonly createdAt: string;
62
+ /** 0-100. */
63
+ readonly score: number;
64
+ /** 0-1, fração de fatores com `hasRealData: true`. */
65
+ readonly confidence: number;
66
+ readonly autonomyBand: AutonomyBand;
67
+ readonly factors: readonly RiskFactorResult[];
68
+ }
69
+ export interface RiskAssessMeta {
70
+ readonly id: string;
71
+ readonly changeId: string;
72
+ readonly now: string;
73
+ readonly weights?: Partial<RiskWeights>;
74
+ readonly thresholds?: AutonomyBandThresholds;
75
+ }
76
+ export declare function assessRisk(input: RiskInput, meta: RiskAssessMeta): ChangeRiskAssessment;
77
+ export declare function explainAssessment(assessment: ChangeRiskAssessment): string;
78
+ /** Interface pequena e opcional para quem quiser injetar o engine (ex.: montar `PolicyRequest.riskScore` antes de `authorize()`) sem acoplar ao módulo inteiro. */
79
+ export interface RiskEngine {
80
+ assess(input: RiskInput, meta: {
81
+ readonly id: string;
82
+ readonly changeId: string;
83
+ readonly now: string;
84
+ }): ChangeRiskAssessment;
85
+ }
86
+ export declare function createRiskEngine(config?: {
87
+ readonly weights?: Partial<RiskWeights>;
88
+ readonly thresholds?: AutonomyBandThresholds;
89
+ }): RiskEngine;
@@ -0,0 +1,120 @@
1
+ /**
2
+ * @forja/engineering-risk — Change Risk Engine (SPEC-034).
3
+ *
4
+ * Domínio puro: nenhum `fs`/rede/SQLite aqui. `assessRisk` recebe métricas já coletadas por um
5
+ * adapter (`scripts/risk.ts`) e aplica a fórmula documentada em
6
+ * `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md` §9: 7 fatores nomeados,
7
+ * pesos configuráveis (nunca constante escondida), cada fator carregando os `evidenceIds` que o
8
+ * adapter coletou — o engine nunca inventa evidência, só soma o que recebeu (AC-2).
9
+ */
10
+ /** Pesos default do §9 do doc de arquitetura — somam 1.0. Sempre sobrescrevíveis via `options.weights` (AC-1). */
11
+ export const DEFAULT_RISK_WEIGHTS = {
12
+ blast_radius: 0.20,
13
+ architecture_violations: 0.20,
14
+ security_sensitivity: 0.15,
15
+ historical_failure_rate: 0.15,
16
+ test_confidence: 0.10,
17
+ reversibility: 0.10,
18
+ deployment_complexity: 0.10,
19
+ };
20
+ /** Faixas sugeridas na visão original (0-25/26-50/51-75/76-100) — configuração default, nunca constante fixa (AC-6). */
21
+ export const DEFAULT_AUTONOMY_BAND_THRESHOLDS = {
22
+ autonomous: 25,
23
+ autonomousWithReview: 50,
24
+ supervised: 75,
25
+ };
26
+ const BLAST_RADIUS_CAP = 30;
27
+ const ARCHITECTURE_VIOLATION_CAP = 5;
28
+ const SENSITIVE_CATEGORY_VOCAB = ['secrets', 'database', 'deployment'];
29
+ function computeFactors(input, weights) {
30
+ const blastValue = Math.min(1, input.blastRadiusCount / BLAST_RADIUS_CAP);
31
+ const architectureValue = Math.min(1, input.architectureViolationCount / ARCHITECTURE_VIOLATION_CAP);
32
+ const sensitiveCount = SENSITIVE_CATEGORY_VOCAB.filter((category) => input.sensitiveCategoriesTouched.includes(category)).length;
33
+ const securityValue = sensitiveCount / SENSITIVE_CATEGORY_VOCAB.length;
34
+ const historicalHasData = input.historicalFailureRate !== undefined;
35
+ const historicalValue = input.historicalFailureRate ?? 0;
36
+ const testedHasData = input.testedPathsRatio !== undefined;
37
+ const testValue = testedHasData ? 1 - input.testedPathsRatio : 0.5;
38
+ const reversibilityValue = input.touchesSchemaOrMigration ? 1 : 0;
39
+ const deploymentValue = input.totalServiceCount === 0 ? 0 : Math.min(1, input.affectedServiceCount / input.totalServiceCount);
40
+ return [
41
+ {
42
+ name: 'blast_radius', weight: weights.blast_radius, value: blastValue, hasRealData: true,
43
+ evidenceIds: input.blastRadiusEvidenceIds,
44
+ rationale: `${input.blastRadiusCount} nó(s) alcançável(is) no Engineering Graph (cap ${BLAST_RADIUS_CAP})`,
45
+ },
46
+ {
47
+ name: 'architecture_violations', weight: weights.architecture_violations, value: architectureValue, hasRealData: true,
48
+ evidenceIds: input.architectureViolationEvidenceIds,
49
+ rationale: `${input.architectureViolationCount} violação(ões) de architecture:check no escopo afetado (cap ${ARCHITECTURE_VIOLATION_CAP})`,
50
+ },
51
+ {
52
+ name: 'security_sensitivity', weight: weights.security_sensitivity, value: securityValue, hasRealData: true,
53
+ evidenceIds: input.sensitiveCategoryEvidenceIds,
54
+ rationale: sensitiveCount === 0 ? 'nenhuma categoria sensível tocada' : `categorias tocadas: ${input.sensitiveCategoriesTouched.join(', ')}`,
55
+ },
56
+ {
57
+ name: 'historical_failure_rate', weight: weights.historical_failure_rate, value: historicalValue, hasRealData: historicalHasData,
58
+ evidenceIds: input.historicalEvidenceIds,
59
+ rationale: historicalHasData ? `taxa de falha observada: ${(historicalValue * 100).toFixed(0)}%` : 'sem Observation histórica para os arquivos afetados — cold start',
60
+ },
61
+ {
62
+ name: 'test_confidence', weight: weights.test_confidence, value: testValue, hasRealData: testedHasData,
63
+ evidenceIds: input.testEvidenceIds,
64
+ rationale: testedHasData ? `${(input.testedPathsRatio * 100).toFixed(0)}% dos arquivos afetados têm teste associado` : 'cobertura de teste não determinada',
65
+ },
66
+ {
67
+ name: 'reversibility', weight: weights.reversibility, value: reversibilityValue, hasRealData: true,
68
+ evidenceIds: input.reversibilityEvidenceIds,
69
+ rationale: input.touchesSchemaOrMigration ? 'toca migration/schema — baixa reversibilidade' : 'não toca migration/schema',
70
+ },
71
+ {
72
+ name: 'deployment_complexity', weight: weights.deployment_complexity, value: deploymentValue, hasRealData: true,
73
+ evidenceIds: input.deploymentEvidenceIds,
74
+ rationale: `${input.affectedServiceCount} de ${input.totalServiceCount} pacote(s)/app(s) afetado(s)`,
75
+ },
76
+ ];
77
+ }
78
+ function autonomyBandFor(score, thresholds) {
79
+ if (score <= thresholds.autonomous)
80
+ return 'autonomous';
81
+ if (score <= thresholds.autonomousWithReview)
82
+ return 'autonomous_with_review';
83
+ if (score <= thresholds.supervised)
84
+ return 'supervised';
85
+ return 'human_in_the_loop';
86
+ }
87
+ export function assessRisk(input, meta) {
88
+ const weights = { ...DEFAULT_RISK_WEIGHTS, ...meta.weights };
89
+ const thresholds = meta.thresholds ?? DEFAULT_AUTONOMY_BAND_THRESHOLDS;
90
+ const factors = computeFactors(input, weights);
91
+ const score = Math.round(100 * factors.reduce((sum, factor) => sum + factor.weight * factor.value, 0));
92
+ const confidence = Math.round((factors.filter((factor) => factor.hasRealData).length / factors.length) * 100) / 100;
93
+ return {
94
+ id: meta.id,
95
+ changeId: meta.changeId,
96
+ createdAt: meta.now,
97
+ score,
98
+ confidence,
99
+ autonomyBand: autonomyBandFor(score, thresholds),
100
+ factors,
101
+ };
102
+ }
103
+ export function explainAssessment(assessment) {
104
+ const lines = [
105
+ `${assessment.id} — mudança "${assessment.changeId}"`,
106
+ `score ${assessment.score}/100 → ${assessment.autonomyBand} (confidence ${(assessment.confidence * 100).toFixed(0)}%)`,
107
+ '',
108
+ ];
109
+ for (const factor of assessment.factors) {
110
+ const flag = factor.hasRealData ? '' : ' (sem dado real)';
111
+ lines.push(`${factor.name.padEnd(24)} peso ${factor.weight.toFixed(2)} valor ${factor.value.toFixed(2)}${flag}`);
112
+ lines.push(` ${factor.rationale}`);
113
+ }
114
+ return lines.join('\n');
115
+ }
116
+ export function createRiskEngine(config) {
117
+ return {
118
+ assess: (input, meta) => assessRisk(input, { ...meta, weights: config?.weights, thresholds: config?.thresholds }),
119
+ };
120
+ }
@@ -6,6 +6,7 @@ export interface GraphNodeSpec {
6
6
  readonly status: KnowledgeStatus;
7
7
  readonly validFrom?: ISO8601;
8
8
  readonly validTo?: ISO8601;
9
+ readonly documentStatus?: string;
9
10
  }
10
11
  export interface GraphEdgeSpec {
11
12
  readonly id?: EntityId;
@@ -61,10 +62,22 @@ export interface GraphStore {
61
62
  saveEvidence(item: Evidence): void;
62
63
  getSourceChecksum(sourceKey: string): string | undefined;
63
64
  saveSourceChecksum(sourceKey: string, checksum: string): void;
65
+ /**
66
+ * Opcional (achado real, GraphIndexer.sync contra ~1000 documentos): sem isto, cada
67
+ * `saveNode`/`saveEdge`/`saveEvidence` é um `INSERT` commitado individualmente — dezenas de
68
+ * milhares de fsyncs num repositório real. Um `GraphStore` que grava em algo transacional (ex.
69
+ * `SqliteGraphStore`) implementa isto pra agrupar; `InMemoryGraphStore` não precisa — sem custo
70
+ * de I/O, não há nada a agrupar, e `GraphLoop.transaction` cai pra "só chame `fn()`" quando
71
+ * ausente.
72
+ */
73
+ transaction?<T>(fn: () => T): T;
64
74
  }
65
75
  export declare class GraphError extends Error {
66
76
  constructor(message: string);
67
77
  }
78
+ export interface GraphLoopOptions {
79
+ readonly trustedEvidenceSources?: readonly string[];
80
+ }
68
81
  export declare class InMemoryGraphStore implements GraphStore {
69
82
  readonly nodes: Map<EntityId, GraphNode>;
70
83
  readonly edges: Map<string, GraphEdge>;
@@ -83,7 +96,9 @@ export declare class InMemoryGraphStore implements GraphStore {
83
96
  }
84
97
  export declare class GraphLoop {
85
98
  private readonly store;
86
- constructor(store?: GraphStore);
99
+ private readonly trustedEvidenceSources;
100
+ constructor(store?: GraphStore, options?: GraphLoopOptions);
101
+ private isTrustedSource;
87
102
  addEvidence(item: Evidence): void;
88
103
  upsertNode(spec: GraphNodeSpec): GraphNode;
89
104
  upsertEdge(spec: GraphEdgeSpec): GraphEdge;
@@ -92,6 +107,13 @@ export declare class GraphLoop {
92
107
  readonly edges: number;
93
108
  readonly skipped: boolean;
94
109
  };
110
+ /**
111
+ * Agrupa `fn` numa transação do `store`, se ele suportar uma (`GraphStore.transaction`,
112
+ * opcional). `GraphIndexer.sync` usa isto pra envolver o loop inteiro de `apply()` — uma
113
+ * transação pra todos os documentos, não uma implícita por `INSERT`. Sem suporte do store
114
+ * (ex. `InMemoryGraphStore`), só roda `fn()` normalmente.
115
+ */
116
+ transaction<T>(fn: () => T): T;
95
117
  query(query?: GraphQuery): readonly GraphNode[];
96
118
  path(from: EntityId, to: EntityId, maxDepth?: number, at?: ISO8601): GraphPath | undefined;
97
119
  impact(origin: EntityId, depth?: number, direction?: 'outgoing' | 'incoming' | 'both', at?: ISO8601): GraphImpact;