forjajs 2.0.4 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (825) hide show
  1. package/.claude/agents/context-engineer.md +19 -25
  2. package/.claude/agents/governance.md +19 -55
  3. package/.claude/agents/marketing.md +19 -24
  4. package/.claude/agents/orchestrator.md +19 -31
  5. package/.claude/agents/product.md +19 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +19 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +93 -87
  12. package/.github/copilot-instructions.md +93 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +93 -87
  15. package/AGENTS.md +137 -134
  16. package/CHANGELOG.md +656 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +68 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +17 -1
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/release.js +3 -0
  353. package/dist/lib/core/risk-collect.d.ts +19 -0
  354. package/dist/lib/core/risk-collect.js +173 -0
  355. package/dist/lib/drift-sentinel.d.ts +59 -0
  356. package/dist/lib/drift-sentinel.js +126 -0
  357. package/dist/lib/generators/memory-generator.js +691 -691
  358. package/dist/lib/generators/nest-generator.js +412 -398
  359. package/dist/lib/generators/readme-generator.js +180 -180
  360. package/dist/lib/governance-report.js +39 -39
  361. package/dist/lib/llm/codex-output.d.ts +12 -0
  362. package/dist/lib/llm/codex-output.js +56 -0
  363. package/dist/lib/llm/context.d.ts +5 -0
  364. package/dist/lib/llm/context.js +17 -0
  365. package/dist/lib/llm/session.d.ts +18 -0
  366. package/dist/lib/llm/session.js +34 -0
  367. package/dist/lib/llm/validation.d.ts +37 -0
  368. package/dist/lib/llm/validation.js +88 -0
  369. package/dist/lib/workspace.js +29 -29
  370. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  371. package/dist/packages/adapter-git/src/index.js +11 -6
  372. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  373. package/dist/packages/adapter-nest/src/index.js +26 -1
  374. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  375. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  376. package/dist/packages/contracts/src/index.d.ts +33 -0
  377. package/dist/packages/contracts/src/index.js +13 -0
  378. package/dist/packages/core/src/index.d.ts +12 -0
  379. package/dist/packages/core/src/index.js +29 -0
  380. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  381. package/dist/packages/engineering/architecture/src/index.js +131 -0
  382. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  383. package/dist/packages/engineering/evidence/src/index.js +31 -0
  384. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  385. package/dist/packages/engineering/identity/src/index.js +88 -0
  386. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  387. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  388. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  389. package/dist/packages/engineering/provenance/src/index.js +21 -0
  390. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  391. package/dist/packages/engineering/risk/src/index.js +120 -0
  392. package/dist/packages/evals/src/index.js +6 -0
  393. package/dist/packages/graph/src/index.d.ts +23 -1
  394. package/dist/packages/graph/src/index.js +88 -15
  395. package/dist/packages/llm/src/index.d.ts +8 -1
  396. package/dist/packages/llm/src/index.js +64 -7
  397. package/dist/packages/mcp/src/index.js +27 -8
  398. package/dist/packages/orchestration/src/index.d.ts +11 -1
  399. package/dist/packages/orchestration/src/index.js +34 -7
  400. package/dist/packages/policy/src/index.d.ts +40 -0
  401. package/dist/packages/policy/src/index.js +39 -4
  402. package/dist/packages/runtime/src/index.js +3 -0
  403. package/dist/packages/sandbox/src/index.d.ts +47 -0
  404. package/dist/packages/sandbox/src/index.js +59 -0
  405. package/dist/packages/validator/src/index.d.ts +8 -0
  406. package/dist/packages/validator/src/index.js +21 -6
  407. package/dist/scripts/adr.d.ts +17 -0
  408. package/dist/scripts/adr.js +152 -0
  409. package/dist/scripts/agent-harness.js +72 -64
  410. package/dist/scripts/agent-router.js +20 -20
  411. package/dist/scripts/agent.d.ts +27 -0
  412. package/dist/scripts/agent.js +249 -0
  413. package/dist/scripts/architecture.d.ts +16 -0
  414. package/dist/scripts/architecture.js +186 -0
  415. package/dist/scripts/build-smart-context.js +22 -22
  416. package/dist/scripts/compress-memory.js +8 -8
  417. package/dist/scripts/context-ops.js +29 -29
  418. package/dist/scripts/cost-economy.d.ts +2 -0
  419. package/dist/scripts/cost-economy.js +79 -0
  420. package/dist/scripts/demo-autonomy.js +13 -6
  421. package/dist/scripts/dev.js +13 -13
  422. package/dist/scripts/drift-check.d.ts +17 -0
  423. package/dist/scripts/drift-check.js +63 -0
  424. package/dist/scripts/engineer.d.ts +20 -0
  425. package/dist/scripts/engineer.js +208 -0
  426. package/dist/scripts/evidence.d.ts +12 -0
  427. package/dist/scripts/evidence.js +55 -0
  428. package/dist/scripts/extract-global-knowledge.js +5 -5
  429. package/dist/scripts/gates.d.ts +6 -2
  430. package/dist/scripts/gates.js +14 -4
  431. package/dist/scripts/generate-dashboard.js +11 -11
  432. package/dist/scripts/incident.d.ts +19 -0
  433. package/dist/scripts/incident.js +103 -0
  434. package/dist/scripts/llm-fit.js +85 -9
  435. package/dist/scripts/memory-schema.js +48 -48
  436. package/dist/scripts/provenance.d.ts +14 -0
  437. package/dist/scripts/provenance.js +114 -0
  438. package/dist/scripts/query-universal-memory.js +13 -13
  439. package/dist/scripts/risk.d.ts +15 -0
  440. package/dist/scripts/risk.js +81 -0
  441. package/dist/scripts/simulate.d.ts +20 -0
  442. package/dist/scripts/simulate.js +150 -0
  443. package/dist/scripts/sprint-manager.js +39 -39
  444. package/dist/scripts/sync-universal-memory.js +44 -44
  445. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  446. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  447. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  448. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  449. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  450. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  451. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  452. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  453. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  454. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  455. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  456. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  457. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  458. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  459. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  460. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  461. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  462. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  463. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  464. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  465. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  466. package/docs/agent-harnesses.md +149 -149
  467. package/docs/agent-operating-contract.md +26 -0
  468. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  469. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  470. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  471. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  472. package/docs/archive/FASE2-SUMMARY.md +263 -263
  473. package/docs/archive/FASE3-PROGRESS.md +355 -355
  474. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  475. package/docs/archive/INDICE-MASTER.md +282 -282
  476. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  477. package/docs/archive/README-REFINAMENTO.md +293 -293
  478. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  479. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  480. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  481. package/docs/archive/START-HERE.md +319 -319
  482. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  483. package/docs/archive/examples/v1/AGENTS.md +10 -10
  484. package/docs/archive/examples/v1/README.md +36 -36
  485. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  486. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  487. package/docs/archive/examples/v1/backend/package.json +42 -42
  488. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  489. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  490. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  491. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  492. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  493. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  494. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  495. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  496. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  497. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  498. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  499. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  501. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  502. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  503. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  504. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  505. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  506. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  507. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  508. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  509. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  510. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  511. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  512. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  513. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  514. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  515. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  516. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  517. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  518. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  519. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  520. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  521. package/docs/archive/examples/v2/AGENTS.md +16 -16
  522. package/docs/archive/examples/v2/README.md +35 -35
  523. package/docs/archive/examples/v2/agents/README.md +3 -3
  524. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  525. package/docs/archive/examples/v2/agents/dba.md +4 -4
  526. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  527. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  528. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  529. package/docs/archive/examples/v2/agents/security.md +4 -4
  530. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  531. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  532. package/docs/archive/examples/v2/backend/package.json +42 -42
  533. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  534. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  535. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  536. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  537. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  538. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  539. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  540. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  541. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  542. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  543. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  544. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  545. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  547. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  548. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  549. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  550. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  551. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  552. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  553. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  554. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  555. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  556. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  557. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  558. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  559. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  560. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  561. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  562. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  563. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  564. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  565. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  566. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  567. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  568. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  569. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  570. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  571. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  572. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  573. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  574. package/docs/archive/examples/v2/memory/README.md +8 -8
  575. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  576. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  577. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  578. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  579. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  580. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  581. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  582. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  583. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  584. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  585. package/docs/capacidades-externas.md +86 -86
  586. package/docs/cli-first-operacao.md +74 -74
  587. package/docs/dev-workflow.md +421 -421
  588. package/docs/examples.md +546 -546
  589. package/docs/fluxo.md +103 -103
  590. package/docs/glossary.md +453 -453
  591. package/docs/init-project.md +457 -457
  592. package/docs/llm-evolution.md +51 -0
  593. package/docs/llm-fit-loop.md +134 -5
  594. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  595. package/docs/personas/architect/README.md +333 -333
  596. package/docs/personas/developer/README.md +371 -371
  597. package/docs/personas/executive/README.md +172 -172
  598. package/docs/personas/qa/README.md +350 -350
  599. package/docs/processo-projeto.md +138 -138
  600. package/docs/publishing.md +49 -377
  601. package/docs/quick-reference.md +409 -409
  602. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  603. package/docs/structure.md +360 -360
  604. package/docs/token-optimization.md +502 -502
  605. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  606. package/memory/00-global/mission.md +15 -15
  607. package/memory/00-global/shared-knowledge.md +8 -8
  608. package/memory/00-global/standards.md +47 -47
  609. package/memory/10-product/personas.md +21 -21
  610. package/memory/10-product/vision.md +27 -27
  611. package/memory/30-projects/README.md +15 -15
  612. package/memory/40-delivery/backlog.md +15 -15
  613. package/memory/40-delivery/current-sprint.md +20 -20
  614. package/memory/50-orchestration/gsd-harness.md +55 -55
  615. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  616. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  617. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  618. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  619. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  620. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  621. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  622. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  623. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  624. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  625. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  626. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  627. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  628. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  630. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  631. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  632. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  633. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  634. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  635. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  637. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  638. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  639. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  640. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  641. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  642. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  643. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  644. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  645. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  646. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  647. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  648. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  649. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  650. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  651. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  652. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  653. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  654. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  655. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  656. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  657. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  658. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  659. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  660. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  661. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  662. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  663. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  664. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  665. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  666. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  667. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  668. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  669. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  670. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  671. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  672. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  673. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  674. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  675. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  676. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  677. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  678. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  679. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  680. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  681. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  682. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  683. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  684. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  685. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  686. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  687. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  688. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  689. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  690. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  691. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  692. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  693. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  694. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  695. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  696. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  697. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  698. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  699. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  700. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  701. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  702. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  703. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  704. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  705. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  706. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  707. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  708. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  709. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  710. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  711. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  712. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  713. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  714. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  715. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  716. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  717. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  718. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  719. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  720. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  721. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  722. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  723. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  724. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  725. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  726. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  727. package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
  728. package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
  729. package/memory/90-decisions/_template.md +28 -28
  730. package/package.json +159 -157
  731. package/prompts/context-engineer-agent.md +13 -19
  732. package/prompts/governance-agent.md +13 -16
  733. package/prompts/marketing-agent.md +13 -13
  734. package/prompts/orchestrator-agent.md +13 -18
  735. package/prompts/product-agent.md +13 -13
  736. package/prompts/sdd-architect-agent.md +13 -20
  737. package/skills/MANIFEST.json +10 -0
  738. package/skills/llm-provider-routing/SKILL.md +18 -0
  739. package/specs/README.md +70 -70
  740. package/specs/_templates/plan.md +50 -43
  741. package/specs/_templates/spec.md +50 -43
  742. package/specs/_templates/tasks.md +39 -32
  743. package/specs/agent-identity-reputation/plan.md +133 -0
  744. package/specs/agent-identity-reputation/spec.md +125 -0
  745. package/specs/agent-identity-reputation/tasks.md +51 -0
  746. package/specs/agent-instructions-v4/plan.md +8 -0
  747. package/specs/agent-instructions-v4/spec.md +21 -0
  748. package/specs/agent-instructions-v4/tasks.md +12 -0
  749. package/specs/agent-runtime-monitoring/plan.md +78 -0
  750. package/specs/agent-runtime-monitoring/spec.md +92 -0
  751. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  752. package/specs/ai-code-provenance/plan.md +71 -0
  753. package/specs/ai-code-provenance/spec.md +97 -0
  754. package/specs/ai-code-provenance/tasks.md +39 -0
  755. package/specs/architecture-constitution/plan.md +110 -0
  756. package/specs/architecture-constitution/spec.md +114 -0
  757. package/specs/architecture-constitution/tasks.md +58 -0
  758. package/specs/change-risk-engine/plan.md +130 -0
  759. package/specs/change-risk-engine/spec.md +119 -0
  760. package/specs/change-risk-engine/tasks.md +72 -0
  761. package/specs/clean-arch-boilerplate/plan.md +137 -137
  762. package/specs/clean-arch-boilerplate/spec.md +121 -121
  763. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  764. package/specs/cli-first-operacao/plan.md +53 -53
  765. package/specs/cli-first-operacao/spec.md +53 -53
  766. package/specs/cli-first-operacao/tasks.md +53 -53
  767. package/specs/code-context/spec.md +56 -56
  768. package/specs/coerencia-do-sistema/plan.md +155 -155
  769. package/specs/coerencia-do-sistema/spec.md +123 -123
  770. package/specs/coerencia-do-sistema/tasks.md +115 -115
  771. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  772. package/specs/dev-token-assets-db/plan.md +71 -71
  773. package/specs/dev-token-assets-db/spec.md +58 -58
  774. package/specs/dev-token-assets-db/tasks.md +58 -58
  775. package/specs/doctor-do-nucleo/plan.md +165 -165
  776. package/specs/doctor-do-nucleo/spec.md +139 -139
  777. package/specs/doctor-do-nucleo/tasks.md +172 -172
  778. package/specs/drift-sentinel/spec.md +117 -0
  779. package/specs/engineer-facade-extension/plan.md +71 -0
  780. package/specs/engineer-facade-extension/spec.md +98 -0
  781. package/specs/engineer-facade-extension/tasks.md +36 -0
  782. package/specs/engineering-evidence-ledger/plan.md +121 -0
  783. package/specs/engineering-evidence-ledger/spec.md +90 -0
  784. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  785. package/specs/engineering-graph-extensions/plan.md +92 -0
  786. package/specs/engineering-graph-extensions/spec.md +101 -0
  787. package/specs/engineering-graph-extensions/tasks.md +60 -0
  788. package/specs/engineering-intelligence/spec.md +177 -0
  789. package/specs/forja-core/spec.md +71 -71
  790. package/specs/gates/spec.md +63 -63
  791. package/specs/governanca-visivel/plan.md +122 -122
  792. package/specs/governanca-visivel/spec.md +112 -112
  793. package/specs/governanca-visivel/tasks.md +60 -60
  794. package/specs/harness-codegraph/spec.md +71 -71
  795. package/specs/learning-loop-incidents/plan.md +59 -0
  796. package/specs/learning-loop-incidents/spec.md +93 -0
  797. package/specs/learning-loop-incidents/tasks.md +36 -0
  798. package/specs/llm-integration-v2/plan.md +55 -0
  799. package/specs/llm-integration-v2/spec.md +61 -0
  800. package/specs/llm-integration-v2/tasks.md +28 -0
  801. package/specs/llm-resume-validation/plan.md +50 -0
  802. package/specs/llm-resume-validation/spec.md +35 -0
  803. package/specs/llm-resume-validation/tasks.md +19 -0
  804. package/specs/memory-audit/spec.md +54 -54
  805. package/specs/orchestrate/spec.md +108 -108
  806. package/specs/orchestration-coherent/spec.md +95 -95
  807. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  808. package/specs/predictive-change-simulation/plan.md +109 -0
  809. package/specs/predictive-change-simulation/spec.md +107 -0
  810. package/specs/predictive-change-simulation/tasks.md +41 -0
  811. package/specs/project-smoke/spec.md +96 -96
  812. package/specs/project-upgrade/spec.md +58 -58
  813. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  814. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  815. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  816. package/specs/release-auditor-health/spec.md +23 -23
  817. package/specs/release-gate/plan.md +174 -174
  818. package/specs/release-gate/spec.md +122 -122
  819. package/specs/release-gate/tasks.md +183 -183
  820. package/specs/smart-agent-routing/plan.md +55 -0
  821. package/specs/smart-agent-routing/spec.md +85 -0
  822. package/specs/smart-agent-routing/tasks.md +26 -0
  823. package/specs/ts-migration/plan.md +200 -200
  824. package/specs/ts-migration/spec.md +119 -119
  825. package/specs/ts-migration/tasks.md +110 -110
@@ -0,0 +1,114 @@
1
+ # Spec: Architecture Constitution — ADRs como regras executáveis
2
+
3
+ - **ID**: SPEC-033
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-09-01
7
+ - **Sprint alvo**: Sprint 1
8
+ - **ADRs relacionadas**: ADR-0078; depende de SPEC-032 (nós ADR) e reaproveita o motor de
9
+ comparação "isso que era verdade parou de ser" desenhado em `specs/drift-sentinel/spec.md`
10
+ (SPEC-030).
11
+
12
+ ## 1. Problema
13
+
14
+ Uma decisão registrada em ADR (`memory/90-decisions/NNNN-*.md`) hoje só é verificada por um
15
+ humano lembrar de reler o documento. Nada impede que o código viole uma restrição arquitetural
16
+ documentada dias, semanas ou meses atrás, sem que ninguém perceba — a mesma classe de problema que
17
+ `drift-sentinel` resolve para relações genéricas do grafo, aqui aplicada especificamente a
18
+ restrições de arquitetura.
19
+
20
+ ## 2. Proposta de valor
21
+
22
+ ADRs com uma seção `## Constraints` em formato estruturado (ver §4) compilam para regras
23
+ executáveis (`.context/architecture/constitution.json`, versionado em git), verificáveis por
24
+ `forja architecture:check` a qualquer momento — inclusive como gate de CI, quando o projeto
25
+ consumidor optar por isso.
26
+
27
+ ## 3. User stories
28
+
29
+ - **Como** sdd-architect, **quero** que uma restrição documentada em ADR seja verificada
30
+ automaticamente, **para que** "documentado" e "em vigor" nunca divirjam sem ninguém notar.
31
+ - **Como** governance, **quero** um relatório de violações por severidade, **para que** eu saiba
32
+ quais bloqueiam merge e quais são só aviso.
33
+ - **Como** desenvolvedor, **quero** `architecture:explain <rule-id>` antes de contestar uma
34
+ violação, **para que** eu entenda o porquê sem precisar caçar a ADR original.
35
+
36
+ ## 4. Critérios de aceite (Definition of Done)
37
+
38
+ - [x] AC-1: formato de `## Constraints` em ADR é determinístico e documentado (ex.: lista com
39
+ prefixo fixo — `- billing não importa database diretamente` vira
40
+ `{kind: 'forbid_import', patterns: ['**/database/**']}` só quando a frase casa um padrão
41
+ reconhecido; frases que não casam viram regra `proposed` com `confidence < 1`, nunca
42
+ `active` por adivinhação).
43
+ - [x] AC-2: `forja architecture:compile` lê `memory/90-decisions/*.md` com `## Constraints`,
44
+ produz `ArchitectureRule[]`, grava `.context/architecture/constitution.json`.
45
+ - [x] AC-3: `forja architecture:check` compara `constitution.json` contra o Engineering Graph
46
+ (arestas `depends_on`/`imports` já extraídas por `extractDeterministicRelations`) e reporta
47
+ violações com severidade (`info|low|medium|high|critical`), path do arquivo, ADR de origem,
48
+ remediação sugerida.
49
+ - [x] AC-4: `forja architecture:status` resume: N regras ativas, N propostas, última compilação.
50
+ - [x] AC-5: `forja architecture:explain <rule-id>` mostra a ADR de origem, o texto original da
51
+ restrição, e a severidade/razão.
52
+ - [x] AC-6: uma regra `proposed` só vira `active` por `forja architecture:approve <rule-id>`
53
+ (reaproveita `ApprovalLedger` de `packages/policy` — **não** um sistema de aprovação
54
+ paralelo).
55
+ - [x] AC-7: `architecture:check` pode participar de `check:all` como item opcional
56
+ (`--with-architecture`), não obrigatório por padrão (mesma decisão de opt-in já tomada para
57
+ `drift:check` em SPEC-030 AC-5, pelo mesmo motivo: custo em repos grandes ainda não medido).
58
+
59
+ **Nota de implementação (achado real, fora de escopo desta spec)**: testar `architecture:check`
60
+ contra o workspace real (`~/forja-workspace`) expôs um diagnóstico enganoso em `memory-db`
61
+ (`lib/core/health.ts`): o gate reportou "banco existe mas não abre (SQLITE_ERROR) — provavelmente
62
+ corrompido", mas `sqlite3 ... PRAGMA integrity_check` confirmou "ok" — não é corrupção. Causa real:
63
+ `getWorkspaceDbPath()` aponta para o mesmo arquivo físico usado por dois mecanismos independentes —
64
+ `scripts/sync-universal-memory.ts` cria sua própria tabela `memory_nodes` via `CREATE TABLE IF NOT
65
+ EXISTS` fora de qualquer migration, enquanto `adr:*`/`architecture:*` (e o já mergeado `drift:check`,
66
+ SPEC-030) usam `SqliteMigrationRunner` (schema do Engineering Graph/policy/runtime). Os dois são
67
+ aditivos — não há conflito de dados — mas se `sync:universal` nunca rodou nesse workspace, a tabela
68
+ `memory_nodes` simplesmente não existe ainda, e o `SELECT count(*) FROM memory_nodes` do health check
69
+ cai no branch genérico de erro, que rotula como "provavelmente corrompido" em vez de "rode `npm run
70
+ sync:universal`". Nenhum dado foi perdido (o arquivo de teste era novo, criado só pelos meus testes
71
+ desta sprint, removido com segurança). Vale uma correção pontual em `health.ts` para diferenciar
72
+ "tabela ausente" de corrupção de fato — não implementada aqui por estar fora do escopo desta spec.
73
+
74
+ **Corrigido posteriormente**: `lib/core/health.ts`'s `memory-db` agora reconhece
75
+ `"no such table: memory_nodes"` como um caso à parte (`warn`, mesma severidade de "banco nunca
76
+ indexado", com `fix: npm run sync:universal` — que de fato resolve, ao contrário do caso
77
+ CANTOPEN/EACCES) em vez de cair no branch genérico de "provavelmente corrompido". Ver
78
+ `test/health.test.js` e o commit que fecha esta nota.
79
+
80
+ ## 5. Escopo
81
+
82
+ **Dentro**: compile/check/status/explain/approve; parser determinístico de `forbid_import`/
83
+ `require_dependency`/`forbid_dependency` (os três tipos de restrição citados no exemplo da visão
84
+ original); severidade configurável.
85
+
86
+ **Fora**: sugestão de regra via LLM (mencionada na visão como "Fase 6+", não nesta spec — ver
87
+ `ArchitectureConstraint` no documento de arquitetura, campo `confidence` já reservado para quando
88
+ isso existir); auto-correção de violação (só reporta, nunca aplica); tipos de constraint além dos
89
+ três listados (ex.: regras de nomenclatura, limites de complexidade) — aditivo depois que os três
90
+ básicos estiverem em produção.
91
+
92
+ ## 6. NFRs / restrições
93
+
94
+ - **LLM nunca decide regra `active` sozinho** — princípio de segurança explícito da visão
95
+ original, reforçado pela postura fail-closed já em vigor no resto do framework desde a
96
+ auditoria de 2026-08-31.
97
+ - `constitution.json` é artefato de git, não linha SQLite — precisa ser revisável em PR como
98
+ qualquer outro artefato gerado (mesma categoria de `.context/forja-runs.jsonl`).
99
+ - Falso positivo é o risco central (ver riscos) — parser determinístico só reconhece padrões de
100
+ frase explícitos; qualquer coisa fora do padrão vira `proposed`, nunca `active` por default.
101
+
102
+ ## 7. Riscos e mitigação
103
+
104
+ | Risco | Probabilidade | Impacto | Mitigação |
105
+ |---|---|---|---|
106
+ | Parser de linguagem natural de `## Constraints` interpretar errado uma frase | Alta (é a natureza do problema) | Alta (falso positivo em massa) | Vocabulário de frase reconhecida é pequeno e explícito (AC-1); fora do vocabulário = `proposed`, nunca `active` |
107
+ | `architecture:check` virar ruído e ser ignorado | Média | Alta (perde todo o valor) | AC-7 opt-in até o sinal ser medido; kill criteria já registrado no `plan.md` da spec master |
108
+ | Conflito entre duas ADRs com constraints contraditórias | Baixa | Média | `architecture:compile` reporta conflito explicitamente como erro de compilação, não escolhe uma silenciosamente |
109
+
110
+ ## 8. Métricas de sucesso
111
+
112
+ Compilar as ADRs reais deste repositório (`memory/90-decisions/`) produz pelo menos uma regra
113
+ `active` verificável, e `architecture:check` roda sem falso positivo sobre o código atual (linha de
114
+ base limpa, igual ao Sprint 1 do plan.md da spec master).
@@ -0,0 +1,58 @@
1
+ # Tasks: Architecture Constitution
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-09-01
7
+
8
+ ---
9
+
10
+ ## T1 — engine puro: parser + compile + check
11
+ - **Owner**: worker
12
+ - **Estimativa**: G
13
+ - **Depende de**: —
14
+ - **Paths**: `packages/engineering/architecture/src/index.ts`
15
+ - **Done quando**:
16
+ - [ ] `parseConstraintLine` reconhece os 3 padrões (D2 do plan) e retorna `undefined`/confiança
17
+ baixa para qualquer coisa fora do vocabulário
18
+ - [ ] `compileConstitution` produz `ArchitectureRule[]` a partir de ADRs reais com
19
+ `## Constraints`
20
+ - [ ] `checkConstitution` compara regras contra `DependencyEdge[]` e reporta violações com
21
+ severidade e remediação
22
+ - [ ] testes unitários (sem `fs`/rede) cobrindo: padrão reconhecido → confidence 1; padrão
23
+ ambíguo → confidence baixa, nunca `active`; violação injetada é detectada; ausência de
24
+ violação é reportada como `compliant`
25
+
26
+ ## T2 — `scripts/architecture.ts`: compile/check/status/explain/approve
27
+ - **Owner**: worker
28
+ - **Estimativa**: M
29
+ - **Depende de**: T1
30
+ - **Paths**: `scripts/architecture.ts`, `lib/core/registry.ts`
31
+ - **Done quando**:
32
+ - [ ] `architecture:compile` lê `memory/90-decisions/*.md` reais e grava
33
+ `.context/architecture/constitution.json`
34
+ - [ ] `architecture:check` roda sobre o grafo real (reindexado como `adr:*`/`drift:check` já
35
+ fazem) e reporta zero violação na linha de base deste repositório
36
+ - [ ] `architecture:status`/`architecture:explain <rule-id>` funcionais
37
+ - [ ] `architecture:approve <rule-id>` reaproveita `ApprovalLedger` (`packages/policy`), sem
38
+ sistema de aprovação paralelo
39
+ - [ ] `forja tools:doctor` continua verde (comandos documentados no README)
40
+
41
+ ## T3 — prova sobre dado real + violação injetada em teste
42
+ - **Owner**: worker
43
+ - **Estimativa**: P
44
+ - **Depende de**: T2
45
+ - **Paths**: `memory/90-decisions/0078-forjajs-3-engineering-control-plane.md` (`## Constraints`
46
+ já adicionado), `test/architecture-constitution-cli.test.js` (novo)
47
+ - **Done quando**:
48
+ - [ ] `architecture:compile` + `architecture:check` reais sobre este repositório: 1 regra
49
+ ativa, zero violação
50
+ - [ ] teste de CLI com fixture isolada prova que uma violação real (arquivo importando o que a
51
+ regra proíbe) é detectada com exit code ≠ 0
52
+
53
+ ---
54
+
55
+ ## Handoffs entre agentes
56
+
57
+ T1→T2→T3 sequencial. Sem handoff de papel — spec e plan já aprovados cobrem as decisões de
58
+ produto/arquitetura.
@@ -0,0 +1,130 @@
1
+ # Plan: Change Risk Engine
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-09-01
6
+
7
+ ## 1. Abordagem técnica
8
+
9
+ Novo bounded context `packages/engineering/risk` (autorizado por ADR-0078), puro domínio — a
10
+ fórmula dos 7 fatores (§9 do doc de arquitetura) roda inteira sobre um `RiskInput` já calculado,
11
+ sem `fs`/rede/SQLite. Quem coleta os números reais é `scripts/risk.ts` (adapter), reaproveitando
12
+ integralmente o que Sprint 1 já construiu: `GraphLoop.impact()` para blast radius,
13
+ `checkConstitution` (SPEC-033) para violações de arquitetura, `SqliteObservationStore` (já
14
+ existente em `packages/adapter-sqlite`) para taxa histórica de falha. Nenhuma tabela SQLite nova.
15
+
16
+ ## 2. Módulos afetados
17
+
18
+ | Caminho | Mudança | Risco |
19
+ |---|---|---|
20
+ | `packages/engineering/risk/src/index.ts` | novo — `assessRisk`, `explainAssessment`, `createRiskEngine`, pesos/thresholds default | Médio — lógica nova, pura/testável |
21
+ | `scripts/risk.ts` | novo — `risk:assess`/`risk:explain`, coleta blast radius/violações/histórico/testes/serviços reais | Médio — bastante integração, mas cada peça já existe |
22
+ | `lib/core/registry.ts` | 2 comandos novos | Baixo |
23
+ | `packages/policy/src/index.ts` | `PolicyScope.riskScoreRange` + `PolicyRequest.riskScore` (campos aditivos, sem import de `@forja/engineering-risk`) | Baixo — extensão aditiva, mesmo padrão de `maxCostUsd` (SPEC-029) |
24
+ | `test/risk-engine.test.js` (novo) | testes puros do motor: fórmula, confidence, bandas | — |
25
+ | `test/risk-cli.test.js` (novo) | fixture git isolada: `risk:assess`/`risk:explain` ponta a ponta | — |
26
+ | `test/policy.test.js` | +1 teste: `riskScoreRange` na `matches()` | — |
27
+
28
+ ## 3. Diagrama de fluxo
29
+
30
+ ```text
31
+ git diff --name-only [ref] (scripts/risk.ts, coleta)
32
+ │
33
+ ├── GraphLoop.impact(origin) ──────────► blast_radius
34
+ ├── checkConstitution (constitution.json + arestas DEPENDS_ON) ─► architecture_violations
35
+ ├── heurística de path (secrets/database/deployment) ─────────► security_sensitivity
36
+ ├── SqliteObservationStore.list() filtrado por files ──────────► historical_failure_rate
37
+ ├── existência de test/<nome>.test.js ──────────────────────────► test_confidence
38
+ ├── path casa /migration|schema/ ────────────────────────────────► reversibility
39
+ └── packages/*, apps/* distintos tocados ────────────────────────► deployment_complexity
40
+ │
41
+ ▼
42
+ assessRisk(input) [packages/engineering/risk, puro]
43
+ │
44
+ ▼
45
+ ChangeRiskAssessment (score, confidence, autonomyBand, factors[])
46
+ │
47
+ ▼
48
+ .context/risk/<id>.json (efêmero, mesma categoria de forja-runs.jsonl)
49
+ ```
50
+
51
+ ## 4. Contratos (API/CLI/Schema)
52
+
53
+ ```ts
54
+ // packages/engineering/risk/src/index.ts
55
+ export type RiskFactorName = 'blast_radius' | 'architecture_violations' | 'security_sensitivity'
56
+ | 'historical_failure_rate' | 'test_confidence' | 'reversibility' | 'deployment_complexity';
57
+ export type RiskWeights = Readonly<Record<RiskFactorName, number>>;
58
+ export const DEFAULT_RISK_WEIGHTS: RiskWeights; // soma 1.0, pesos do §9 do doc de arquitetura
59
+ export interface AutonomyBandThresholds { readonly autonomous: number; readonly autonomousWithReview: number; readonly supervised: number; }
60
+ export const DEFAULT_AUTONOMY_BAND_THRESHOLDS: AutonomyBandThresholds; // 25/50/75 — >75 = human_in_the_loop
61
+ export type AutonomyBand = 'autonomous' | 'autonomous_with_review' | 'supervised' | 'human_in_the_loop';
62
+ export interface RiskInput { /* 7 métricas cruas + evidenceIds por fator — ver código */ }
63
+ export interface RiskFactorResult { readonly name: RiskFactorName; readonly weight: number; readonly value: number; readonly hasRealData: boolean; readonly evidenceIds: readonly string[]; readonly rationale: string; }
64
+ export interface ChangeRiskAssessment { readonly id: string; readonly changeId: string; readonly createdAt: string; readonly score: number; readonly confidence: number; readonly autonomyBand: AutonomyBand; readonly factors: readonly RiskFactorResult[]; }
65
+ export function assessRisk(input: RiskInput, options: { id: string; changeId: string; now: string; weights?: Partial<RiskWeights>; thresholds?: AutonomyBandThresholds }): ChangeRiskAssessment;
66
+ export function explainAssessment(assessment: ChangeRiskAssessment): string;
67
+ export interface RiskEngine { assess(input: RiskInput, meta: { id: string; changeId: string; now: string }): ChangeRiskAssessment; }
68
+ export function createRiskEngine(config?: { weights?: Partial<RiskWeights>; thresholds?: AutonomyBandThresholds }): RiskEngine;
69
+ ```
70
+
71
+ ```bash
72
+ risk:assess [ref] # default: diff do working tree vs. HEAD
73
+ risk:explain <assessment-id>
74
+ ```
75
+
76
+ ```ts
77
+ // packages/policy/src/index.ts — extensão aditiva
78
+ export interface PolicyScope { /* ...campos existentes... */ readonly riskScoreRange?: readonly [number, number]; }
79
+ export interface PolicyRequest { /* ...campos existentes... */ readonly riskScore?: number; }
80
+ ```
81
+
82
+ ## 5. Decisões e alternativas
83
+
84
+ **D1**: `risk:assess` recebe um **git ref opcional** (`risk:assess [ref]`), não uma string livre em
85
+ linguagem natural. A visão original e o §12 (CLI Plan) escrevem `risk:assess "<mudança>"`, que lido
86
+ literalmente sugeriria parsing de texto — incompatível com o NFR "nenhum fator depende de chamada de
87
+ LLM" e com AC-1 (fatores determinísticos). Sem `ref`, compara o working tree contra `HEAD` (mudança
88
+ não commitada ainda, o caso mais comum ao decidir política antes de commitar); com `ref`, compara
89
+ `<ref>^..<ref>`. Mesma resolução já dada a `adr:impact <id>` (recebe um id concreto, não prosa).
90
+
91
+ **D2**: assessments são persistidos em `.context/risk/<id>.json`, efêmero (fora do git, mesma
92
+ categoria de `.context/forja-runs.jsonl` — já ignorado pelo `.gitignore` existente, nenhuma mudança
93
+ de allowlist necessária, ao contrário de `constitution.json` que é fonte de verdade versionada).
94
+ `risk:explain` lê de volta esse arquivo. Alternativa rejeitada: nova tabela SQLite — violaria a NFR
95
+ "nenhuma tabela SQLite nova" desta spec (§6, redigida pelo próprio autor da spec) sem necessidade;
96
+ um assessment é um artefato de leitura pontual, não algo que precisa de índice/query relacional.
97
+
98
+ **D3**: `PolicyRequest.riskScore` é um `number` simples (0-100), não `ChangeRiskAssessment` completo
99
+ como o texto solto da visão original sugeria. `PolicyEngine` só precisa do score para casar
100
+ `riskScoreRange` — carregar o assessment inteiro obrigaria `packages/policy` a conhecer o shape de
101
+ `ChangeRiskAssessment`, violando AC-5 ("policy não importa `packages/engineering/risk`
102
+ diretamente") por tipo estrutural equivalente a import. Quem quiser o assessment completo já tem
103
+ `risk:explain <id>` ou chama `RiskEngine.assess()` diretamente antes de montar o `PolicyRequest`.
104
+
105
+ **D4**: fatores sem dado real (`historical_failure_rate` em cold start, `test_confidence` quando a
106
+ heurística de arquivo de teste não encontra nada) entram no cálculo com um valor neutro (0 para
107
+ histórico — "sem evidência de falha" não é o mesmo que "sem risco", mas é a leitura mais honesta
108
+ disponível; 0.5 para teste — literalmente "desconhecido") e `hasRealData: false`, nunca são
109
+ omitidos do score. `confidence` cai proporcionalmente (AC-3) em vez de o assessment inteiro falhar
110
+ ou mentir com 100% de confiança.
111
+
112
+ ## 6. Dependências
113
+
114
+ - SPEC-032 (Engineering Graph) — `GraphLoop.impact()` para blast radius.
115
+ - SPEC-033 (Architecture Constitution) — `checkConstitution` para o fator de violação; roda com
116
+ zero regras (`architectureViolationCount: 0`) se `constitution.json` ainda não foi compilado,
117
+ não é erro bloqueante.
118
+ - `packages/adapter-sqlite.SqliteObservationStore` (já existente, sem migração nova).
119
+
120
+ ## 7. Rollout
121
+
122
+ - [ ] Feature flag necessária? Não — comando novo, opt-in por natureza.
123
+ - [ ] Migração de dados existentes? Não.
124
+ - [ ] Doc/persona impactada? README (comandos novos), `docs/architecture/`.
125
+
126
+ ## 8. Sinais de fracasso (kill criteria)
127
+
128
+ Já registrado no apêndice de `specs/engineering-intelligence/spec.md`: se `risk:assess` sobre as 5
129
+ mudanças históricas do §8 do spec não ordenar de acordo com julgamento humano, os pesos/fórmula são
130
+ revisados antes de avançar para o Sprint 3 (Evidence Ledger, que agrega o que Risk já produziu).
@@ -0,0 +1,119 @@
1
+ # Spec: Change Risk Engine
2
+
3
+ - **ID**: SPEC-034
4
+ - **Status**: done
5
+ - **Owner**: apk
6
+ - **Criado em**: 2026-09-01
7
+ - **Sprint alvo**: Sprint 2
8
+ - **ADRs relacionadas**: ADR-0078; depende de SPEC-032 (blast radius via grafo) e SPEC-033
9
+ (violação de arquitetura como fator de risco)
10
+
11
+ ## 1. Problema
12
+
13
+ Hoje, o único sinal de risco de uma mudança é o `risk: RiskLevel` estático declarado na
14
+ `CapabilityDefinition` (`low|medium|high|critical`) — um valor fixo por capability, não calculado a
15
+ partir da mudança real (quantos arquivos, quantos módulos afetados, se viola arquitetura, se o
16
+ domínio tem histórico de falha). Duas mudanças na mesma capability podem ter risco real muito
17
+ diferente e recebem o mesmo tratamento de política.
18
+
19
+ ## 2. Proposta de valor
20
+
21
+ `forja risk:assess "<mudança>"` produz um score 0-100 explicável (fatores nomeados, com evidência),
22
+ que o Policy Engine pode opcionalmente consultar para calibrar a exigência de aprovação além do
23
+ `risk` estático da capability.
24
+
25
+ ## 3. User stories
26
+
27
+ - **Como** governance, **quero** um score de risco com fatores visíveis, **para que** eu confie
28
+ na exigência de aprovação em vez de tratá-la como arbitrária.
29
+ - **Como** desenvolvedor, **quero** `risk:explain` mostrando exatamente por que um score saiu alto,
30
+ **para que** eu saiba o que reduzir (mais teste? menos arquivos? revisão de arquitetura?) antes
31
+ de tentar de novo.
32
+
33
+ ## 4. Critérios de aceite (Definition of Done)
34
+
35
+ - [x] AC-1: `RiskEngine.assess(input): ChangeRiskAssessment` (interface pura, sem I/O) implementa a
36
+ fórmula documentada em `docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md`
37
+ §9, com os 7 fatores nomeados e pesos default configuráveis.
38
+ - [x] AC-2: cada fator do assessment carrega `evidenceIds` (nós/arestas do grafo, `Observation`s
39
+ históricas) — nenhum score sem rastro de onde veio.
40
+ - [x] AC-3: `confidence` do assessment reflete a fração de fatores com dado real disponível — um
41
+ projeto sem histórico de falha ainda produz um score, mas com confiança visivelmente menor,
42
+ nunca escondida.
43
+ - [x] AC-4: `forja risk:assess [ref]` (CLI, ver D1 do plan — ref de git, não prosa livre) e
44
+ `forja risk:explain <assessment-id>` funcionais.
45
+ - [x] AC-5: interface `RiskAssessor`/`RiskEngine` pequena e opcional — `packages/policy` nunca
46
+ importa `packages/engineering/risk`; `PolicyRequest.riskScore` é um `number` puro (D3 do
47
+ plan), não o assessment inteiro.
48
+ - [x] AC-6: faixas de autonomia (0-25 autonomous / 26-50 autonomous_with_review / 51-75 supervised
49
+ / 76-100 human_in_the_loop, sugeridas na visão original) são **configuração default**, nunca
50
+ constante fixa no código — mesmo padrão já usado por `RuntimeLimits`/`PolicyLimits`.
51
+
52
+ ## 5. Escopo
53
+
54
+ **Dentro**: os 7 fatores documentados em §9 do doc de arquitetura; interface pura `RiskEngine`;
55
+ CLI `risk:assess`/`risk:explain`; interface de consumo opcional pelo Policy Engine.
56
+
57
+ **Fora**: aplicação automática de `REQUIRE_APPROVAL`/`DENY` a partir do score sem uma regra de
58
+ política explícita configurada para isso (o score informa a decisão, não a toma sozinho — decisão
59
+ de política continua sendo do `PolicyEngine`, nunca do `RiskEngine`); UI/heatmap de risco (Fase
60
+ posterior).
61
+
62
+ ## 6. NFRs / restrições
63
+
64
+ - Determinístico onde possível; nenhum fator depende de chamada de LLM.
65
+ - `RiskEngine` não tem efeito colateral — é uma função pura sobre dados já coletados em outro
66
+ lugar (grafo, `Observation`, `architecture:check`).
67
+ - Fórmula e pesos vivem em um único lugar documentado (código + este spec) — nunca duplicados.
68
+
69
+ ## 7. Riscos e mitigação
70
+
71
+ | Risco | Probabilidade | Impacto | Mitigação |
72
+ |---|---|---|---|
73
+ | Score virar "número mágico" que ninguém entende | Alta se mal implementado | Alta (perde toda a confiança) | AC-2/AC-3 obrigam evidência e confidence em todo assessment, sem exceção |
74
+ | Pesos default não fazerem sentido para todo tipo de projeto | Alta | Média | Pesos configuráveis por projeto desde o dia 1 (AC-1), não hardcoded |
75
+ | Cold start: projeto novo sem `Observation` histórica | Alta em projetos novos | Baixa (é esperado) | `confidence` reduzida é a resposta correta, não um erro ou bloqueio |
76
+
77
+ ## 8. Métricas de sucesso
78
+
79
+ Rodar `risk:assess` sobre 5 mudanças históricas reais deste repositório (ex.: a extração do
80
+ `isPathWithinRoot`, a correção do policy approval bypass) produz scores que, em revisão humana,
81
+ ordenam corretamente do menos para o mais arriscado.
82
+
83
+ **Validado**: `risk:assess <ref>` rodado contra 5 commits reais deste repositório (grafo real,
84
+ `.context/architecture/constitution.json` real, sem fixture):
85
+
86
+ | Commit | Descrição | Score |
87
+ |---|---|---|
88
+ | `6f220ed` | refatoração: extrai runner de capability sandboxed reutilizável | 7 |
89
+ | `a950711` | fix de segurança pontual (1 arquivo): argument-injection em `code:impact` | 11 |
90
+ | `1a49682` | docs: remove citação de comando ainda não implementado | 13 |
91
+ | `fdab8e3` | feature nova: `drift:check` (SPEC-030) | 13 |
92
+ | `f678d37` | fix de segurança multi-arquivo: auth do proxy do dashboard, DB shutdown handler | 19 |
93
+
94
+ Ordem (revisão humana, apk): o fix de segurança multi-arquivo fica corretamente no topo; a
95
+ refatoração autocontida (menor blast radius, nada ainda depende do novo helper) fica corretamente
96
+ no fundo. Ordem aceita — sem redesenho de pesos necessário (kill criteria do apêndice de
97
+ `specs/engineering-intelligence/spec.md` não disparado).
98
+
99
+ **Achado real (limitação documentada, não corrigida — heurística determinística, não regressão de
100
+ AC)**: `security_sensitivity` não pegou `f678d37` como sensível, apesar de o commit mexer em
101
+ autenticação (`apps/dashboard/app/api/forja/guard.ts`) e desligamento de banco
102
+ (`apps/server/src/main.ts`). A heurística de `scripts/risk.ts` (`inferSensitiveCategories`) casa só
103
+ substring de path (`secret|credential|\.env`, `adapter-sqlite|migration|database`,
104
+ `deploy|\.github/workflows|Dockerfile`) — nenhum desses arquivos tem esses termos no caminho, então
105
+ o fator não disparou. É determinístico (cumpre a NFR de "nenhum fator depende de LLM") mas tem
106
+ recall baixo para segurança que não está em path óbvio. Não corrigido aqui: exigiria uma heurística
107
+ mais rica (ex.: casar contra `PolicyCategory` já inferida do `capabilityId`/handler tocado, não só
108
+ o path do arquivo) — candidato a uma spec própria de refinamento, fora do escopo desta fundação.
109
+
110
+ **Melhoria posterior (não a correção estrutural completa, uma redução da superfície mais óbvia de
111
+ falso-negativo)**: `SENSITIVE_PATTERNS` (`lib/core/risk-collect.ts`, movida de `scripts/risk.ts` no
112
+ Sprint 6) ganhou `auth|guard|session|token` na categoria `secrets` e `shutdown` na categoria
113
+ `database` — termos adjacentes a controle de acesso/ciclo de vida de credencial e conexão que a
114
+ lista original não cobria. Revalidado contra o mesmo `f678d37`: `security_sensitivity` agora
115
+ detecta `secrets, database` (antes: nenhuma), score final `19/100 → 29/100`, banda de autonomia
116
+ `autonomous → autonomous_with_review` — mais correto pro que o commit de fato fez. **A limitação
117
+ estrutural continua real**: qualquer lista fixa de palavras-chave tem recall limitado por natureza;
118
+ a correção estrutural sugerida na nota original (casar contra `PolicyCategory` inferida do
119
+ handler/capability tocado) segue não implementada e fora do escopo desta fundação.
@@ -0,0 +1,72 @@
1
+ # Tasks: Change Risk Engine
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-09-01
7
+
8
+ ---
9
+
10
+ ## T1 — engine puro: fórmula + confidence + bandas de autonomia
11
+ - **Owner**: worker
12
+ - **Estimativa**: G
13
+ - **Depende de**: —
14
+ - **Paths**: `packages/engineering/risk/src/index.ts`
15
+ - **Done quando**:
16
+ - [ ] `assessRisk` implementa os 7 fatores com os pesos default de §9 do doc de arquitetura
17
+ (soma 1.0), pesos sobrescrevíveis via `options.weights`
18
+ - [ ] `confidence` = fração de fatores com `hasRealData: true` (AC-3)
19
+ - [ ] `autonomyBand` usa `AutonomyBandThresholds` configurável, default 25/50/75 (AC-6)
20
+ - [ ] cada `RiskFactorResult` carrega `evidenceIds` (passthrough do `RiskInput`, nunca inventado
21
+ pelo engine) — AC-2
22
+ - [ ] testes unitários (sem `fs`/rede): fator sem dado real reduz `confidence` mas não quebra o
23
+ score; pesos customizados mudam o resultado; as 4 bandas de autonomia nos limites exatos
24
+ (25/26/50/51/75/76)
25
+
26
+ ## T2 — `scripts/risk.ts`: coleta real + `risk:assess`/`risk:explain`
27
+ - **Owner**: worker
28
+ - **Estimativa**: M
29
+ - **Depende de**: T1
30
+ - **Paths**: `scripts/risk.ts`, `lib/core/registry.ts`
31
+ - **Done quando**:
32
+ - [ ] blast radius via `GraphLoop.impact()` sobre o grafo real (reindexado como
33
+ `adr:*`/`architecture:*` já fazem)
34
+ - [ ] violações de arquitetura via `checkConstitution` sobre `constitution.json` (SPEC-033),
35
+ escopadas aos arquivos alterados
36
+ - [ ] taxa histórica de falha via `SqliteObservationStore.list()` filtrado por `files`
37
+ (cold start = `undefined`, não 0 mentiroso)
38
+ - [ ] `risk:assess [ref]` grava `.context/risk/<id>.json` (D2 do plan) e imprime
39
+ `explainAssessment`
40
+ - [ ] `risk:explain <id>` lê o arquivo de volta
41
+ - [ ] `forja tools:doctor` continua verde (comandos documentados no README)
42
+
43
+ ## T3 — integração opcional com Policy Engine
44
+ - **Owner**: worker
45
+ - **Estimativa**: P
46
+ - **Depende de**: T1
47
+ - **Paths**: `packages/policy/src/index.ts`, `test/policy.test.js`
48
+ - **Done quando**:
49
+ - [ ] `PolicyScope.riskScoreRange`/`PolicyRequest.riskScore` (D3 do plan — `number`, não o
50
+ assessment inteiro)
51
+ - [ ] `PolicyEngine.matches()` respeita `riskScoreRange` quando presente, sem quebrar nenhuma
52
+ regra existente que não o declara (campo opcional)
53
+ - [ ] `packages/policy` continua sem importar `packages/engineering/risk` (AC-5, checável por
54
+ `grep -r "engineering-risk\|engineering/risk" packages/policy/src`)
55
+
56
+ ## T4 — prova sobre dado real
57
+ - **Owner**: worker
58
+ - **Estimativa**: P
59
+ - **Depende de**: T2
60
+ - **Paths**: `test/risk-cli.test.js` (novo)
61
+ - **Done quando**:
62
+ - [ ] fixture git isolada com 2+ pacotes, uma mudança que toca 1 arquivo: `risk:assess` produz
63
+ score+fatores+confidence coerentes com os dados da fixture (blast radius > 0, sem histórico
64
+ → `historical_failure_rate.hasRealData === false`)
65
+ - [ ] `risk:explain <id>` recupera o mesmo assessment
66
+
67
+ ---
68
+
69
+ ## Handoffs entre agentes
70
+
71
+ T1 → (T2, T3 em paralelo, ambas só dependem de T1) → T4. Sem handoff de papel — spec e plan já
72
+ aprovados cobrem as decisões de produto/arquitetura.