forjajs 2.0.2 → 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 (712) 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 -317
  21. package/README.pt-BR.md +345 -323
  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/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -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