forjajs 2.0.3 → 2.0.4

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 (701) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -339
  21. package/README.pt-BR.md +345 -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/dashboard-client.jsx +10 -10
  328. package/dist/bin/create-memory-nest-kit.js +17 -17
  329. package/dist/bin/forja.js +14 -2
  330. package/dist/bin/init-project.js +38 -38
  331. package/dist/lib/audit.js +7 -7
  332. package/dist/lib/context-builder.js +32 -32
  333. package/dist/lib/core/doc-graph.js +6 -4
  334. package/dist/lib/core/registry.d.ts +54 -0
  335. package/dist/lib/core/registry.js +55 -0
  336. package/dist/lib/core/release.d.ts +53 -0
  337. package/dist/lib/core/release.js +5 -1
  338. package/dist/lib/generators/memory-generator.js +700 -698
  339. package/dist/lib/generators/nest-generator.js +398 -398
  340. package/dist/lib/generators/readme-generator.js +180 -180
  341. package/dist/lib/governance-report.js +39 -39
  342. package/dist/lib/project-upgrade.js +1 -1
  343. package/dist/lib/workspace.d.ts +7 -0
  344. package/dist/lib/workspace.js +63 -34
  345. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  346. package/dist/packages/llm/src/index.d.ts +43 -0
  347. package/dist/packages/llm/src/index.js +108 -0
  348. package/dist/scripts/agent-harness.js +66 -64
  349. package/dist/scripts/agent-router.js +20 -20
  350. package/dist/scripts/build-smart-context.js +22 -22
  351. package/dist/scripts/compress-memory.js +8 -8
  352. package/dist/scripts/context-ops.js +29 -29
  353. package/dist/scripts/demo-autonomy.js +2 -2
  354. package/dist/scripts/demo-workspace.d.ts +6 -0
  355. package/dist/scripts/demo-workspace.js +101 -0
  356. package/dist/scripts/dev.js +13 -13
  357. package/dist/scripts/extract-global-knowledge.js +5 -5
  358. package/dist/scripts/generate-dashboard.js +11 -11
  359. package/dist/scripts/llm-fit.js +131 -0
  360. package/dist/scripts/memory-schema.js +48 -48
  361. package/dist/scripts/query-universal-memory.js +13 -13
  362. package/dist/scripts/sprint-manager.js +39 -39
  363. package/dist/scripts/sync-universal-memory.js +63 -50
  364. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  365. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  366. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  367. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  368. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  369. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  370. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  371. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  372. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  373. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  374. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  375. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  376. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  377. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  378. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  379. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  380. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  381. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  382. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  383. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  384. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  385. package/docs/agent-harnesses.md +149 -149
  386. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  387. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  388. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  389. package/docs/archive/FASE2-SUMMARY.md +263 -263
  390. package/docs/archive/FASE3-PROGRESS.md +355 -355
  391. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  392. package/docs/archive/INDICE-MASTER.md +282 -282
  393. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  394. package/docs/archive/README-REFINAMENTO.md +293 -293
  395. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  396. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  397. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  398. package/docs/archive/START-HERE.md +319 -319
  399. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  400. package/docs/archive/examples/v1/AGENTS.md +10 -10
  401. package/docs/archive/examples/v1/README.md +36 -36
  402. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  403. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  404. package/docs/archive/examples/v1/backend/package.json +42 -42
  405. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  406. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  407. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  408. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  409. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  410. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  411. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  412. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  413. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  414. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  415. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  416. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  417. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  418. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  419. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  420. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  421. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  422. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  423. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  424. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  425. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  426. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  427. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  428. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  429. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  430. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  431. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  433. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  434. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  435. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  436. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  437. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  438. package/docs/archive/examples/v2/AGENTS.md +16 -16
  439. package/docs/archive/examples/v2/README.md +35 -35
  440. package/docs/archive/examples/v2/agents/README.md +3 -3
  441. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  442. package/docs/archive/examples/v2/agents/dba.md +4 -4
  443. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  444. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  445. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  446. package/docs/archive/examples/v2/agents/security.md +4 -4
  447. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  448. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  449. package/docs/archive/examples/v2/backend/package.json +42 -42
  450. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  451. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  452. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  453. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  454. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  455. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  456. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  457. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  458. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  459. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  460. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  461. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  462. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  463. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  464. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  465. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  466. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  467. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  468. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  469. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  470. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  471. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  472. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  473. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  474. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  475. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  476. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  477. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  479. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  480. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  481. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  482. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  483. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  484. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  485. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  486. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  487. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  488. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  489. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  490. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  491. package/docs/archive/examples/v2/memory/README.md +8 -8
  492. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  493. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  494. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  495. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  496. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  497. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  498. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  499. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  500. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  501. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  502. package/docs/capacidades-externas.md +86 -86
  503. package/docs/cli-first-operacao.md +74 -74
  504. package/docs/dev-workflow.md +421 -421
  505. package/docs/examples.md +546 -546
  506. package/docs/fluxo.md +103 -103
  507. package/docs/glossary.md +453 -453
  508. package/docs/init-project.md +457 -457
  509. package/docs/llm-fit-loop.md +41 -0
  510. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  511. package/docs/modos-de-operacao.md +52 -0
  512. package/docs/personas/architect/README.md +333 -333
  513. package/docs/personas/developer/README.md +371 -371
  514. package/docs/personas/executive/README.md +172 -172
  515. package/docs/personas/qa/README.md +350 -350
  516. package/docs/processo-projeto.md +138 -138
  517. package/docs/produto/factsheet-marketing.md +151 -0
  518. package/docs/produto/roteiro-demo.md +47 -0
  519. package/docs/publishing.md +377 -377
  520. package/docs/quick-reference.md +409 -409
  521. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  522. package/docs/structure.md +360 -360
  523. package/docs/token-optimization.md +502 -502
  524. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  525. package/memory/00-global/mission.md +15 -15
  526. package/memory/00-global/shared-knowledge.md +8 -8
  527. package/memory/00-global/standards.md +47 -47
  528. package/memory/10-product/personas.md +21 -21
  529. package/memory/10-product/vision.md +27 -27
  530. package/memory/30-projects/README.md +15 -15
  531. package/memory/40-delivery/backlog.md +15 -15
  532. package/memory/40-delivery/current-sprint.md +23 -26
  533. package/memory/50-orchestration/gsd-harness.md +55 -55
  534. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  535. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  536. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  537. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  538. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  539. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  540. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  541. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  542. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  543. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  544. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  545. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  546. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  547. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  548. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  549. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  550. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  551. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  552. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  553. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  554. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  555. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  556. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  557. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  558. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  559. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  560. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  561. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  562. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  563. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  564. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  565. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  566. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  567. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  568. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  569. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  570. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  571. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  572. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  573. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  574. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  575. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  576. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  577. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  578. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  579. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  580. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  581. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  582. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  583. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  584. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  585. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  586. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  587. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  588. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  589. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  590. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  591. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  592. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  593. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  594. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  595. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  596. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  597. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  598. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  599. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  600. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  601. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  602. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  603. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  604. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  605. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  606. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  607. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  608. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  609. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  610. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  611. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  612. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  613. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  614. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  615. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  616. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  617. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  618. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  619. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  620. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  621. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  622. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  623. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  624. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  625. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  626. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  627. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  628. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  629. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  630. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  631. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  632. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  633. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  634. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  635. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  636. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  637. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  638. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  639. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  640. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  641. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  642. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  643. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  644. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  645. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  646. package/memory/90-decisions/_template.md +28 -28
  647. package/package.json +157 -150
  648. package/prompts/context-engineer-agent.md +19 -19
  649. package/prompts/governance-agent.md +16 -16
  650. package/prompts/marketing-agent.md +13 -13
  651. package/prompts/orchestrator-agent.md +18 -18
  652. package/prompts/product-agent.md +13 -13
  653. package/prompts/sdd-architect-agent.md +20 -20
  654. package/specs/README.md +70 -70
  655. package/specs/_templates/plan.md +43 -43
  656. package/specs/_templates/spec.md +43 -43
  657. package/specs/_templates/tasks.md +32 -32
  658. package/specs/clean-arch-boilerplate/plan.md +137 -137
  659. package/specs/clean-arch-boilerplate/spec.md +121 -121
  660. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  661. package/specs/cli-first-operacao/plan.md +53 -53
  662. package/specs/cli-first-operacao/spec.md +53 -53
  663. package/specs/cli-first-operacao/tasks.md +53 -53
  664. package/specs/code-context/spec.md +56 -56
  665. package/specs/coerencia-do-sistema/plan.md +155 -155
  666. package/specs/coerencia-do-sistema/spec.md +123 -123
  667. package/specs/coerencia-do-sistema/tasks.md +115 -115
  668. package/specs/dev-token-assets-db/plan.md +71 -71
  669. package/specs/dev-token-assets-db/spec.md +58 -58
  670. package/specs/dev-token-assets-db/tasks.md +58 -58
  671. package/specs/doctor-do-nucleo/plan.md +165 -165
  672. package/specs/doctor-do-nucleo/spec.md +139 -139
  673. package/specs/doctor-do-nucleo/tasks.md +172 -172
  674. package/specs/forja-core/spec.md +71 -71
  675. package/specs/gates/spec.md +63 -63
  676. package/specs/governanca-visivel/plan.md +122 -122
  677. package/specs/governanca-visivel/spec.md +112 -112
  678. package/specs/governanca-visivel/tasks.md +60 -60
  679. package/specs/harness-codegraph/spec.md +71 -71
  680. package/specs/memory-audit/spec.md +54 -54
  681. package/specs/orchestrate/spec.md +108 -108
  682. package/specs/orchestration-coherent/spec.md +95 -95
  683. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  684. package/specs/project-smoke/spec.md +96 -96
  685. package/specs/project-upgrade/spec.md +58 -58
  686. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  687. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  688. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  689. package/specs/release-auditor-health/plan.md +88 -0
  690. package/specs/release-auditor-health/spec.md +82 -0
  691. package/specs/release-auditor-health/tasks.md +72 -0
  692. package/specs/release-gate/plan.md +174 -174
  693. package/specs/release-gate/spec.md +122 -122
  694. package/specs/release-gate/tasks.md +183 -183
  695. package/specs/ts-migration/plan.md +200 -200
  696. package/specs/ts-migration/spec.md +119 -119
  697. package/specs/ts-migration/tasks.md +110 -110
  698. package/dist/scripts/server-persistence-probe.d.ts +0 -1
  699. package/dist/scripts/server-persistence-probe.js +0 -52
  700. package/dist/scripts/server-persistence-probe.mjs +0 -52
  701. /package/dist/scripts/{server-persistence-probe.d.mts → llm-fit.d.ts} +0 -0
@@ -1,64 +1,64 @@
1
- # ADR-0033: `memory-db` distingue permissão/lock de corrupção
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-23
5
- - **Autor(es)**: Allan Pablo
6
- - **Tags**: doctor, memory, diagnostics, sqlite
7
-
8
- ## Contexto
9
-
10
- O check `memory-db` (`lib/core/health.ts`), consumido por `tools:doctor` e pelo hook
11
- `SessionStart`, abria `universal.db` e tratava **qualquer** exceção do `better-sqlite3` como
12
- corrupção:
13
-
14
- ```ts
15
- } catch (err) {
16
- return {
17
- status: 'fail',
18
- detail: `... (${asErrno(err).code}) — provavelmente corrompido`,
19
- fix: 'npm run sync:universal',
20
- };
21
- }
22
- ```
23
-
24
- O `err.code` — que já distingue os casos — estava impresso no `detail`, mas não decidia nada.
25
- Num ambiente sem permissão de escrita (sandbox, FS read-only, diretório protegido) o driver
26
- lança `SQLITE_CANTOPEN`, e o doctor diagnosticava "provavelmente corrompido" prescrevendo
27
- `sync:universal`. A prescrição é ativamente errada: `sync:universal` **escreve** no banco — no
28
- mesmo ambiente ele reencena o `CANTOPEN` sem curar nada, e ainda confunde o operador levando-o a
29
- "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox restrito.
30
-
31
- É a violação do princípio 1 do próprio `health.ts` ("nunca colapsar causas distintas num
32
- booleano"), a mesma classe do bug de ABI que motivou a SPEC-009 — sobrevivendo dentro do arquivo
33
- escrito para fechá-la.
34
-
35
- ## Decisão
36
-
37
- Classificar a falha de abertura por `err.code`, uma causa por prescrição:
38
-
39
- - `SQLITE_CANTOPEN` / `EACCES` → `fail`, **permissão/sandbox**, não corrupção; fix orienta
40
- garantir leitura no path e **desaconselha** `sync:universal`.
41
- - `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); fix é aguardar.
42
- - Resto (`SQLITE_CORRUPT`, `SQLITE_NOTADB`, …) → `fail`, **corrupção**; fix `npm run sync:universal`.
43
-
44
- ## Alternativas consideradas
45
-
46
- - **Testar a integridade com `PRAGMA quick_check` antes de classificar** — rejeitada: um banco que
47
- nem abre (CANTOPEN) não chega ao pragma; o `err.code` da abertura já carrega a distinção sem I/O extra.
48
- - **Discriminar por mensagem de erro** — rejeitada: mensagens do SQLite variam entre versões e
49
- locale; `err.code` é o contrato estável, como o resto do `health.ts` já assume.
50
-
51
- ## Consequências
52
-
53
- **Positivas**:
54
- - Sandbox/permissão deixa de ser confundido com corrupção; o operador recebe a correção da causa real.
55
- - `sync:universal` nunca é prescrito para um banco íntegro-mas-inacessível.
56
- - Lock concorrente vira `warn`, não reprova o núcleo.
57
-
58
- **Negativas / Trade-offs**:
59
- - Mais um `err.code` (`SQLITE_BUSY`) a manter caso o driver mude a taxonomia — coberto por teste.
60
-
61
- ## Rastreamento
62
- - Implementação: `lib/core/health.ts` (check `memory-db`)
63
- - Testes: `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB)
64
- - ADRs relacionadas: ADR-0023 (doctor como gate do núcleo), SPEC-009 (doctor-do-nucleo)
1
+ # ADR-0033: `memory-db` distingue permissão/lock de corrupção
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-23
5
+ - **Autor(es)**: Allan Pablo
6
+ - **Tags**: doctor, memory, diagnostics, sqlite
7
+
8
+ ## Contexto
9
+
10
+ O check `memory-db` (`lib/core/health.ts`), consumido por `tools:doctor` e pelo hook
11
+ `SessionStart`, abria `universal.db` e tratava **qualquer** exceção do `better-sqlite3` como
12
+ corrupção:
13
+
14
+ ```ts
15
+ } catch (err) {
16
+ return {
17
+ status: 'fail',
18
+ detail: `... (${asErrno(err).code}) — provavelmente corrompido`,
19
+ fix: 'npm run sync:universal',
20
+ };
21
+ }
22
+ ```
23
+
24
+ O `err.code` — que já distingue os casos — estava impresso no `detail`, mas não decidia nada.
25
+ Num ambiente sem permissão de escrita (sandbox, FS read-only, diretório protegido) o driver
26
+ lança `SQLITE_CANTOPEN`, e o doctor diagnosticava "provavelmente corrompido" prescrevendo
27
+ `sync:universal`. A prescrição é ativamente errada: `sync:universal` **escreve** no banco — no
28
+ mesmo ambiente ele reencena o `CANTOPEN` sem curar nada, e ainda confunde o operador levando-o a
29
+ "reindexar" um banco íntegro. Reportado a partir de uma sessão real em sandbox restrito.
30
+
31
+ É a violação do princípio 1 do próprio `health.ts` ("nunca colapsar causas distintas num
32
+ booleano"), a mesma classe do bug de ABI que motivou a SPEC-009 — sobrevivendo dentro do arquivo
33
+ escrito para fechá-la.
34
+
35
+ ## Decisão
36
+
37
+ Classificar a falha de abertura por `err.code`, uma causa por prescrição:
38
+
39
+ - `SQLITE_CANTOPEN` / `EACCES` → `fail`, **permissão/sandbox**, não corrupção; fix orienta
40
+ garantir leitura no path e **desaconselha** `sync:universal`.
41
+ - `SQLITE_BUSY` → `warn` (lock temporário de outro processo; não trava o gate); fix é aguardar.
42
+ - Resto (`SQLITE_CORRUPT`, `SQLITE_NOTADB`, …) → `fail`, **corrupção**; fix `npm run sync:universal`.
43
+
44
+ ## Alternativas consideradas
45
+
46
+ - **Testar a integridade com `PRAGMA quick_check` antes de classificar** — rejeitada: um banco que
47
+ nem abre (CANTOPEN) não chega ao pragma; o `err.code` da abertura já carrega a distinção sem I/O extra.
48
+ - **Discriminar por mensagem de erro** — rejeitada: mensagens do SQLite variam entre versões e
49
+ locale; `err.code` é o contrato estável, como o resto do `health.ts` já assume.
50
+
51
+ ## Consequências
52
+
53
+ **Positivas**:
54
+ - Sandbox/permissão deixa de ser confundido com corrupção; o operador recebe a correção da causa real.
55
+ - `sync:universal` nunca é prescrito para um banco íntegro-mas-inacessível.
56
+ - Lock concorrente vira `warn`, não reprova o núcleo.
57
+
58
+ **Negativas / Trade-offs**:
59
+ - Mais um `err.code` (`SQLITE_BUSY`) a manter caso o driver mude a taxonomia — coberto por teste.
60
+
61
+ ## Rastreamento
62
+ - Implementação: `lib/core/health.ts` (check `memory-db`)
63
+ - Testes: `test/health.test.js` (CANTOPEN, EACCES, BUSY, NOTADB)
64
+ - ADRs relacionadas: ADR-0023 (doctor como gate do núcleo), SPEC-009 (doctor-do-nucleo)
@@ -1,29 +1,29 @@
1
- # ADR-0034: Fundação 2.0 em contratos versionados e domínio independente
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: architecture, contracts, domain, migration
7
-
8
- ## Contexto
9
-
10
- O ForjaJS 1.x é um CLI TypeScript com memória SQLite e adapters misturados à operação. A 2.0
11
- precisa ser consumível por CLI, MCP, SDK, worker e NestJS sem duplicar regras ou contaminar o
12
- domínio com frameworks.
13
-
14
- ## Decisão
15
-
16
- Introduzir `packages/contracts` como fonte versionada dos contratos públicos e adotar a direção
17
- interfaces → adapters → application → domain. A primeira entrega é aditiva; a compatibilidade
18
- 1.x continua roteada pelo CLI até cada capability possuir equivalente 2.0.
19
-
20
- ## Consequências
21
-
22
- Contratos podem ser testados sem infraestrutura e adapters ficam substituíveis. O custo inicial
23
- é manter versões, schemas e compatibilidade explícita.
24
-
25
- ## Rastreamento
26
-
27
- - Implementação: `packages/contracts/`
28
- - Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
29
- - Visão: `docs/vision/FORJA-2.0-VISION.md`
1
+ # ADR-0034: Fundação 2.0 em contratos versionados e domínio independente
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: architecture, contracts, domain, migration
7
+
8
+ ## Contexto
9
+
10
+ O ForjaJS 1.x é um CLI TypeScript com memória SQLite e adapters misturados à operação. A 2.0
11
+ precisa ser consumível por CLI, MCP, SDK, worker e NestJS sem duplicar regras ou contaminar o
12
+ domínio com frameworks.
13
+
14
+ ## Decisão
15
+
16
+ Introduzir `packages/contracts` como fonte versionada dos contratos públicos e adotar a direção
17
+ interfaces → adapters → application → domain. A primeira entrega é aditiva; a compatibilidade
18
+ 1.x continua roteada pelo CLI até cada capability possuir equivalente 2.0.
19
+
20
+ ## Consequências
21
+
22
+ Contratos podem ser testados sem infraestrutura e adapters ficam substituíveis. O custo inicial
23
+ é manter versões, schemas e compatibilidade explícita.
24
+
25
+ ## Rastreamento
26
+
27
+ - Implementação: `packages/contracts/`
28
+ - Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
29
+ - Visão: `docs/vision/FORJA-2.0-VISION.md`
@@ -1,23 +1,23 @@
1
- # ADR-0035: SQLite local-first e autonomia supervisionada
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: runtime, policy, sqlite, autonomy
7
-
8
- ## Decisão
9
-
10
- SQLite é o backend local padrão para estado durável, eventos, auditoria, memória e checkpoints.
11
- O nível padrão de autonomia é supervisionado: toda ação crítica passa pelo Policy Engine e uma
12
- execução só termina após validação independente. Operações longas devem ser retomáveis.
13
-
14
- ## Alternativas rejeitadas
15
-
16
- - banco remoto obrigatório — viola offline/local-first;
17
- - autonomia irrestrita — não permite governança verificável;
18
- - estado apenas em memória — perde retomada e auditoria.
19
-
20
- ## Rastreamento
21
-
22
- - `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
23
- - `packages/contracts/`
1
+ # ADR-0035: SQLite local-first e autonomia supervisionada
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: runtime, policy, sqlite, autonomy
7
+
8
+ ## Decisão
9
+
10
+ SQLite é o backend local padrão para estado durável, eventos, auditoria, memória e checkpoints.
11
+ O nível padrão de autonomia é supervisionado: toda ação crítica passa pelo Policy Engine e uma
12
+ execução só termina após validação independente. Operações longas devem ser retomáveis.
13
+
14
+ ## Alternativas rejeitadas
15
+
16
+ - banco remoto obrigatório — viola offline/local-first;
17
+ - autonomia irrestrita — não permite governança verificável;
18
+ - estado apenas em memória — perde retomada e auditoria.
19
+
20
+ ## Rastreamento
21
+
22
+ - `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
23
+ - `packages/contracts/`
@@ -1,30 +1,30 @@
1
- # ADR-0036: Capability Registry como núcleo executável
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: capabilities, contracts, runtime, architecture
7
-
8
- ## Contexto
9
-
10
- CLI, MCP, SDK, API e Runtime precisam descobrir e executar a mesma operação sem duplicar regras.
11
- Uma lista de comandos não oferece schema, risco, permissões, idempotência ou resultado auditável.
12
-
13
- ## Decisão
14
-
15
- `packages/core` mantém um registry em memória como núcleo inicial. Cada registro possui definição
16
- versionada, aliases, validadores de entrada/saída e handler. A entrada é validada antes da
17
- autorização e do handler; toda execução retorna `ExecutionResult`. Policy é uma porta injetada e
18
- não uma implementação dentro do registry.
19
-
20
- ## Consequências
21
-
22
- Interfaces externas podem ser adaptadores finos e testes não precisam de banco ou framework. A
23
- persistência do registry, schemas especializados e Policy Engine completo ficam para fases
24
- posteriores.
25
-
26
- ## Rastreamento
27
-
28
- - Implementação: `packages/core/src/index.ts`
29
- - Testes: `test/capability-registry.test.js`
30
- - Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
1
+ # ADR-0036: Capability Registry como núcleo executável
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: capabilities, contracts, runtime, architecture
7
+
8
+ ## Contexto
9
+
10
+ CLI, MCP, SDK, API e Runtime precisam descobrir e executar a mesma operação sem duplicar regras.
11
+ Uma lista de comandos não oferece schema, risco, permissões, idempotência ou resultado auditável.
12
+
13
+ ## Decisão
14
+
15
+ `packages/core` mantém um registry em memória como núcleo inicial. Cada registro possui definição
16
+ versionada, aliases, validadores de entrada/saída e handler. A entrada é validada antes da
17
+ autorização e do handler; toda execução retorna `ExecutionResult`. Policy é uma porta injetada e
18
+ não uma implementação dentro do registry.
19
+
20
+ ## Consequências
21
+
22
+ Interfaces externas podem ser adaptadores finos e testes não precisam de banco ou framework. A
23
+ persistência do registry, schemas especializados e Policy Engine completo ficam para fases
24
+ posteriores.
25
+
26
+ ## Rastreamento
27
+
28
+ - Implementação: `packages/core/src/index.ts`
29
+ - Testes: `test/capability-registry.test.js`
30
+ - Arquitetura: `docs/architecture/FORJA-2.0-ARCHITECTURE.md`
@@ -1,28 +1,28 @@
1
- # ADR-0037: Policy Engine obrigatório e default deny
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: security, policy, autonomy, approvals
7
-
8
- ## Contexto
9
-
10
- Capabilities podem ler, escrever, executar comandos, acessar rede ou afetar um deployment. Uma
11
- autonomia sem decisão centralizada permite que cada adapter invente suas próprias permissões.
12
-
13
- ## Decisão
14
-
15
- Toda execução recebe uma porta de Policy Engine. O engine aplica regras determinísticas por
16
- identidade, papel, capability, projeto, ambiente, risco, categoria e escopo de arquivos. Sem
17
- regra correspondente, o resultado é `DENY`. Empates têm precedência `DENY`, `REQUIRE_APPROVAL`,
18
- `ALLOW_WITH_LIMITS`, `ALLOW`. Risco crítico exige aprovação explícita mesmo quando uma regra permite
19
- a ação. Limites retornados pela política devem ser impostos pelo Runtime.
20
-
21
- Approval requests são contratos auditáveis; o primeiro ledger é em memória e será substituído por
22
- adapter persistente sem mudar o domínio.
23
-
24
- ## Rastreamento
25
-
26
- - Implementação: `packages/policy/src/index.ts`
27
- - Testes: `test/policy.test.js`, `test/policy-registry.integration.test.js`
28
- - Relacionadas: ADR-0035, ADR-0036
1
+ # ADR-0037: Policy Engine obrigatório e default deny
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: security, policy, autonomy, approvals
7
+
8
+ ## Contexto
9
+
10
+ Capabilities podem ler, escrever, executar comandos, acessar rede ou afetar um deployment. Uma
11
+ autonomia sem decisão centralizada permite que cada adapter invente suas próprias permissões.
12
+
13
+ ## Decisão
14
+
15
+ Toda execução recebe uma porta de Policy Engine. O engine aplica regras determinísticas por
16
+ identidade, papel, capability, projeto, ambiente, risco, categoria e escopo de arquivos. Sem
17
+ regra correspondente, o resultado é `DENY`. Empates têm precedência `DENY`, `REQUIRE_APPROVAL`,
18
+ `ALLOW_WITH_LIMITS`, `ALLOW`. Risco crítico exige aprovação explícita mesmo quando uma regra permite
19
+ a ação. Limites retornados pela política devem ser impostos pelo Runtime.
20
+
21
+ Approval requests são contratos auditáveis; o primeiro ledger é em memória e será substituído por
22
+ adapter persistente sem mudar o domínio.
23
+
24
+ ## Rastreamento
25
+
26
+ - Implementação: `packages/policy/src/index.ts`
27
+ - Testes: `test/policy.test.js`, `test/policy-registry.integration.test.js`
28
+ - Relacionadas: ADR-0035, ADR-0036
@@ -1,28 +1,28 @@
1
- # ADR-0038: Runtime controlado por estados, limites e validação independente
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: runtime, autonomy, checkpoint, validation
7
-
8
- ## Contexto
9
-
10
- Um agente não pode ser considerado concluído apenas porque um handler terminou. Execuções longas
11
- precisam ser pausáveis, limitadas, retomáveis e validadas por uma fonte independente.
12
-
13
- ## Decisão
14
-
15
- `packages/runtime` coordena planner → capabilities autorizadas → checkpoint → validator. Cada run
16
- possui estado explícito, orçamento, limites de passos/tokens/arquivos/tempo/retries, métricas,
17
- erros e evidências. A implementação inicial é sequencial e limita concorrência a uma capability
18
- por vez. `DENY` e aprovação pendente bloqueiam; falhas retryable podem repetir até o limite;
19
- validação rejeitada nunca produz `completed`.
20
-
21
- Planner, validator, checkpoint e memória são portas. O primeiro armazenamento é em memória; SQLite
22
- será um adapter posterior.
23
-
24
- ## Rastreamento
25
-
26
- - Implementação: `packages/runtime/src/index.ts`
27
- - Testes: `test/runtime.test.js`
28
- - Relacionadas: ADR-0035, ADR-0037
1
+ # ADR-0038: Runtime controlado por estados, limites e validação independente
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: runtime, autonomy, checkpoint, validation
7
+
8
+ ## Contexto
9
+
10
+ Um agente não pode ser considerado concluído apenas porque um handler terminou. Execuções longas
11
+ precisam ser pausáveis, limitadas, retomáveis e validadas por uma fonte independente.
12
+
13
+ ## Decisão
14
+
15
+ `packages/runtime` coordena planner → capabilities autorizadas → checkpoint → validator. Cada run
16
+ possui estado explícito, orçamento, limites de passos/tokens/arquivos/tempo/retries, métricas,
17
+ erros e evidências. A implementação inicial é sequencial e limita concorrência a uma capability
18
+ por vez. `DENY` e aprovação pendente bloqueiam; falhas retryable podem repetir até o limite;
19
+ validação rejeitada nunca produz `completed`.
20
+
21
+ Planner, validator, checkpoint e memória são portas. O primeiro armazenamento é em memória; SQLite
22
+ será um adapter posterior.
23
+
24
+ ## Rastreamento
25
+
26
+ - Implementação: `packages/runtime/src/index.ts`
27
+ - Testes: `test/runtime.test.js`
28
+ - Relacionadas: ADR-0035, ADR-0037
@@ -1,31 +1,31 @@
1
- # ADR-0039: Event Bus append-only e Scheduler determinístico local-first
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: events, scheduler, reliability, local-first
7
-
8
- ## Contexto
9
-
10
- Execuções, tarefas, aprovações e mudanças do workspace precisam disparar trabalho sem perder
11
- ordem, repetir efeitos de forma segura ou ocultar falhas de consumidores.
12
-
13
- ## Decisão
14
-
15
- O Event Bus usa log append-only, sequência por aggregate, chave de idempotência, consumers com
16
- retry limitado e dead-letter. O Scheduler suporta one-shot, cron UTC de cinco campos, condição e
17
- evento, com cancelamento, chave de execução por slot/evento, retries e limite de concorrência.
18
- As portas permitem substituir o armazenamento em memória por SQLite e o relógio por adapter sem
19
- mover regra de domínio.
20
-
21
- ## Consequências
22
-
23
- Falhas ficam observáveis e eventos duplicados não reexecutam efeitos concluídos. A implementação
24
- em memória não sobrevive a processo; persistência, consumer offsets e recovery serão tratados em
25
- `adapter-sqlite`/worker.
26
-
27
- ## Rastreamento
28
-
29
- - Implementação: `packages/events/src/index.ts`, `packages/scheduler/src/index.ts`
30
- - Testes: `test/events-scheduler.test.js`
31
- - Relacionadas: ADR-0035, ADR-0038
1
+ # ADR-0039: Event Bus append-only e Scheduler determinístico local-first
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: events, scheduler, reliability, local-first
7
+
8
+ ## Contexto
9
+
10
+ Execuções, tarefas, aprovações e mudanças do workspace precisam disparar trabalho sem perder
11
+ ordem, repetir efeitos de forma segura ou ocultar falhas de consumidores.
12
+
13
+ ## Decisão
14
+
15
+ O Event Bus usa log append-only, sequência por aggregate, chave de idempotência, consumers com
16
+ retry limitado e dead-letter. O Scheduler suporta one-shot, cron UTC de cinco campos, condição e
17
+ evento, com cancelamento, chave de execução por slot/evento, retries e limite de concorrência.
18
+ As portas permitem substituir o armazenamento em memória por SQLite e o relógio por adapter sem
19
+ mover regra de domínio.
20
+
21
+ ## Consequências
22
+
23
+ Falhas ficam observáveis e eventos duplicados não reexecutam efeitos concluídos. A implementação
24
+ em memória não sobrevive a processo; persistência, consumer offsets e recovery serão tratados em
25
+ `adapter-sqlite`/worker.
26
+
27
+ ## Rastreamento
28
+
29
+ - Implementação: `packages/events/src/index.ts`, `packages/scheduler/src/index.ts`
30
+ - Testes: `test/events-scheduler.test.js`
31
+ - Relacionadas: ADR-0035, ADR-0038
@@ -1,32 +1,32 @@
1
- # ADR-0040: Context Engine determinístico com orçamento e cache por checksum
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: context, tokens, cache, memory
7
-
8
- ## Contexto
9
-
10
- Enviar memória integral ao agente aumenta custo, repetição e risco de contexto obsoleto. Busca,
11
- deduplicação, diff e imports são operações determinísticas e não devem depender de LLM.
12
-
13
- ## Decisão
14
-
15
- O Context Engine recebe candidatos recortados de memória e GraphLoop, exige evidência atual,
16
- ordena por relevância, deduplica por checksum e seleciona até o orçamento de tokens. O conteúdo
17
- pode ser omitido no pacote e expandido sob demanda pelo checksum. Cache e métricas são portas e o
18
- `ContextPackage` registra referências, checksum, tokens selecionados, cache hits e conteúdo não
19
- utilizado.
20
-
21
- ## Consequências
22
-
23
- O contexto enviado é menor, auditável e reproduzível. O Engine não lê banco nem arquivos; adapters
24
- devem produzir candidatos com locators, snippets e evidências. A estimativa atual é bytes UTF-8 / 4,
25
- compatível com o proxy existente do ForjaJS 1.x.
26
-
27
- ## Rastreamento
28
-
29
- - Implementação: `packages/context/src/index.ts`
30
- - Contrato: `packages/contracts/src/index.ts`
31
- - Testes: `test/context.test.js`
32
- - Relacionadas: ADR-0003, ADR-0009
1
+ # ADR-0040: Context Engine determinístico com orçamento e cache por checksum
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: context, tokens, cache, memory
7
+
8
+ ## Contexto
9
+
10
+ Enviar memória integral ao agente aumenta custo, repetição e risco de contexto obsoleto. Busca,
11
+ deduplicação, diff e imports são operações determinísticas e não devem depender de LLM.
12
+
13
+ ## Decisão
14
+
15
+ O Context Engine recebe candidatos recortados de memória e GraphLoop, exige evidência atual,
16
+ ordena por relevância, deduplica por checksum e seleciona até o orçamento de tokens. O conteúdo
17
+ pode ser omitido no pacote e expandido sob demanda pelo checksum. Cache e métricas são portas e o
18
+ `ContextPackage` registra referências, checksum, tokens selecionados, cache hits e conteúdo não
19
+ utilizado.
20
+
21
+ ## Consequências
22
+
23
+ O contexto enviado é menor, auditável e reproduzível. O Engine não lê banco nem arquivos; adapters
24
+ devem produzir candidatos com locators, snippets e evidências. A estimativa atual é bytes UTF-8 / 4,
25
+ compatível com o proxy existente do ForjaJS 1.x.
26
+
27
+ ## Rastreamento
28
+
29
+ - Implementação: `packages/context/src/index.ts`
30
+ - Contrato: `packages/contracts/src/index.ts`
31
+ - Testes: `test/context.test.js`
32
+ - Relacionadas: ADR-0003, ADR-0009
@@ -1,32 +1,32 @@
1
- # ADR-0041: GraphLoop verificável separado de CodeGraph
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-31
5
- - **Autor(es)**: ForjaJS
6
- - **Tags**: graph, memory, evidence, codegraph
7
-
8
- ## Contexto
9
-
10
- CodeGraph já existe no ForjaJS 1.x como índice de símbolos e blast radius. A 2.0 precisa de um
11
- grafo de trabalho mais amplo, com projetos, specs, decisões, execuções, evidências e validade
12
- temporal, sem transformar o domínio em dependente do binário ou MCP do CodeGraph.
13
-
14
- ## Decisão
15
-
16
- GraphLoop é um domínio separado. Toda aresta exige endpoints existentes e ao menos uma evidência;
17
- status e validade temporal participam das consultas. O núcleo oferece paths, impacto, contradições,
18
- agenda e sync incremental por checksum. Extractors determinísticos têm prioridade para imports,
19
- links Markdown e artefatos do processo. Relações semiestruturadas de LLM só poderão entrar como
20
- `inferred`/`hypothesis`, com confiança e evidência revisável.
21
-
22
- ## Consequências
23
-
24
- O grafo pode operar offline e receber fontes diferentes, inclusive CodeGraph, sem acoplamento. O
25
- primeiro store é em memória; persistência SQLite e extractors de commits/diffs/specs completos
26
- serão adapters/expansões posteriores.
27
-
28
- ## Rastreamento
29
-
30
- - Implementação: `packages/graph/src/index.ts`
31
- - Testes: `test/graph.test.js`
32
- - Relacionadas: ADR-0017, ADR-0040
1
+ # ADR-0041: GraphLoop verificável separado de CodeGraph
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-31
5
+ - **Autor(es)**: ForjaJS
6
+ - **Tags**: graph, memory, evidence, codegraph
7
+
8
+ ## Contexto
9
+
10
+ CodeGraph já existe no ForjaJS 1.x como índice de símbolos e blast radius. A 2.0 precisa de um
11
+ grafo de trabalho mais amplo, com projetos, specs, decisões, execuções, evidências e validade
12
+ temporal, sem transformar o domínio em dependente do binário ou MCP do CodeGraph.
13
+
14
+ ## Decisão
15
+
16
+ GraphLoop é um domínio separado. Toda aresta exige endpoints existentes e ao menos uma evidência;
17
+ status e validade temporal participam das consultas. O núcleo oferece paths, impacto, contradições,
18
+ agenda e sync incremental por checksum. Extractors determinísticos têm prioridade para imports,
19
+ links Markdown e artefatos do processo. Relações semiestruturadas de LLM só poderão entrar como
20
+ `inferred`/`hypothesis`, com confiança e evidência revisável.
21
+
22
+ ## Consequências
23
+
24
+ O grafo pode operar offline e receber fontes diferentes, inclusive CodeGraph, sem acoplamento. O
25
+ primeiro store é em memória; persistência SQLite e extractors de commits/diffs/specs completos
26
+ serão adapters/expansões posteriores.
27
+
28
+ ## Rastreamento
29
+
30
+ - Implementação: `packages/graph/src/index.ts`
31
+ - Testes: `test/graph.test.js`
32
+ - Relacionadas: ADR-0017, ADR-0040