forjajs 2.0.4 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (798) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +133 -133
  16. package/CHANGELOG.md +619 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +64 -60
  19. package/LICENSE +21 -21
  20. package/README.md +404 -343
  21. package/README.pt-BR.md +374 -345
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +8 -1
  328. package/dist/apps/dashboard/app/api/forja/guard.d.ts +24 -0
  329. package/dist/apps/dashboard/app/api/forja/guard.js +63 -0
  330. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  331. package/dist/apps/server/src/forja-nest.module.js +9 -4
  332. package/dist/apps/server/src/main.js +10 -1
  333. package/dist/bin/create-memory-nest-kit.js +17 -17
  334. package/dist/bin/init-project.js +38 -38
  335. package/dist/lib/audit.js +7 -7
  336. package/dist/lib/code-context.js +6 -0
  337. package/dist/lib/context-builder.js +32 -32
  338. package/dist/lib/core/architecture-gate.d.ts +20 -0
  339. package/dist/lib/core/architecture-gate.js +60 -0
  340. package/dist/lib/core/drift-gate.d.ts +18 -0
  341. package/dist/lib/core/drift-gate.js +55 -0
  342. package/dist/lib/core/gates.d.ts +9 -2
  343. package/dist/lib/core/gates.js +13 -2
  344. package/dist/lib/core/health.js +15 -0
  345. package/dist/lib/core/incident-search.d.ts +19 -0
  346. package/dist/lib/core/incident-search.js +32 -0
  347. package/dist/lib/core/model-pricing.d.ts +31 -0
  348. package/dist/lib/core/model-pricing.js +74 -0
  349. package/dist/lib/core/registry.d.ts +194 -0
  350. package/dist/lib/core/registry.js +194 -0
  351. package/dist/lib/core/release.d.ts +194 -0
  352. package/dist/lib/core/risk-collect.d.ts +19 -0
  353. package/dist/lib/core/risk-collect.js +173 -0
  354. package/dist/lib/drift-sentinel.d.ts +59 -0
  355. package/dist/lib/drift-sentinel.js +126 -0
  356. package/dist/lib/generators/memory-generator.js +691 -691
  357. package/dist/lib/generators/nest-generator.js +412 -398
  358. package/dist/lib/generators/readme-generator.js +180 -180
  359. package/dist/lib/governance-report.js +39 -39
  360. package/dist/lib/workspace.js +29 -29
  361. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  362. package/dist/packages/adapter-git/src/index.js +11 -6
  363. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  364. package/dist/packages/adapter-nest/src/index.js +26 -1
  365. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  366. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  367. package/dist/packages/contracts/src/index.d.ts +33 -0
  368. package/dist/packages/contracts/src/index.js +13 -0
  369. package/dist/packages/core/src/index.d.ts +12 -0
  370. package/dist/packages/core/src/index.js +29 -0
  371. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  372. package/dist/packages/engineering/architecture/src/index.js +131 -0
  373. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  374. package/dist/packages/engineering/evidence/src/index.js +31 -0
  375. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  376. package/dist/packages/engineering/identity/src/index.js +88 -0
  377. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  378. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  379. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  380. package/dist/packages/engineering/provenance/src/index.js +21 -0
  381. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  382. package/dist/packages/engineering/risk/src/index.js +120 -0
  383. package/dist/packages/graph/src/index.d.ts +23 -1
  384. package/dist/packages/graph/src/index.js +88 -15
  385. package/dist/packages/llm/src/index.js +27 -4
  386. package/dist/packages/mcp/src/index.js +27 -8
  387. package/dist/packages/orchestration/src/index.d.ts +11 -1
  388. package/dist/packages/orchestration/src/index.js +34 -7
  389. package/dist/packages/policy/src/index.d.ts +40 -0
  390. package/dist/packages/policy/src/index.js +39 -4
  391. package/dist/packages/runtime/src/index.js +3 -0
  392. package/dist/packages/sandbox/src/index.d.ts +47 -0
  393. package/dist/packages/sandbox/src/index.js +59 -0
  394. package/dist/packages/validator/src/index.d.ts +8 -0
  395. package/dist/packages/validator/src/index.js +21 -6
  396. package/dist/scripts/adr.d.ts +17 -0
  397. package/dist/scripts/adr.js +152 -0
  398. package/dist/scripts/agent-harness.js +72 -64
  399. package/dist/scripts/agent-router.js +20 -20
  400. package/dist/scripts/agent.d.ts +27 -0
  401. package/dist/scripts/agent.js +249 -0
  402. package/dist/scripts/architecture.d.ts +16 -0
  403. package/dist/scripts/architecture.js +186 -0
  404. package/dist/scripts/build-smart-context.js +22 -22
  405. package/dist/scripts/compress-memory.js +8 -8
  406. package/dist/scripts/context-ops.js +29 -29
  407. package/dist/scripts/cost-economy.d.ts +2 -0
  408. package/dist/scripts/cost-economy.js +79 -0
  409. package/dist/scripts/demo-autonomy.js +13 -6
  410. package/dist/scripts/dev.js +13 -13
  411. package/dist/scripts/drift-check.d.ts +17 -0
  412. package/dist/scripts/drift-check.js +63 -0
  413. package/dist/scripts/engineer.d.ts +20 -0
  414. package/dist/scripts/engineer.js +208 -0
  415. package/dist/scripts/evidence.d.ts +12 -0
  416. package/dist/scripts/evidence.js +55 -0
  417. package/dist/scripts/extract-global-knowledge.js +5 -5
  418. package/dist/scripts/gates.d.ts +6 -2
  419. package/dist/scripts/gates.js +14 -4
  420. package/dist/scripts/generate-dashboard.js +11 -11
  421. package/dist/scripts/incident.d.ts +19 -0
  422. package/dist/scripts/incident.js +103 -0
  423. package/dist/scripts/llm-fit.js +32 -3
  424. package/dist/scripts/memory-schema.js +48 -48
  425. package/dist/scripts/provenance.d.ts +14 -0
  426. package/dist/scripts/provenance.js +114 -0
  427. package/dist/scripts/query-universal-memory.js +13 -13
  428. package/dist/scripts/risk.d.ts +15 -0
  429. package/dist/scripts/risk.js +81 -0
  430. package/dist/scripts/simulate.d.ts +20 -0
  431. package/dist/scripts/simulate.js +150 -0
  432. package/dist/scripts/sprint-manager.js +39 -39
  433. package/dist/scripts/sync-universal-memory.js +44 -44
  434. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  435. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  436. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  437. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  438. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  439. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  440. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  441. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  442. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  443. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  444. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  445. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  446. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  447. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  448. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  449. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  450. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  451. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  452. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  453. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  454. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  455. package/docs/agent-harnesses.md +149 -149
  456. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  457. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  458. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  459. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  460. package/docs/archive/FASE2-SUMMARY.md +263 -263
  461. package/docs/archive/FASE3-PROGRESS.md +355 -355
  462. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  463. package/docs/archive/INDICE-MASTER.md +282 -282
  464. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  465. package/docs/archive/README-REFINAMENTO.md +293 -293
  466. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  467. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  468. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  469. package/docs/archive/START-HERE.md +319 -319
  470. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  471. package/docs/archive/examples/v1/AGENTS.md +10 -10
  472. package/docs/archive/examples/v1/README.md +36 -36
  473. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  474. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  475. package/docs/archive/examples/v1/backend/package.json +42 -42
  476. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  477. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  478. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  479. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  480. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  481. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  482. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  483. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  484. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  485. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  486. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  487. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  488. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  489. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  490. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  491. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  492. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  493. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  494. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  495. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  496. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  497. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  498. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  499. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  501. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  502. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  503. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  504. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  505. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  506. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  507. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  508. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  509. package/docs/archive/examples/v2/AGENTS.md +16 -16
  510. package/docs/archive/examples/v2/README.md +35 -35
  511. package/docs/archive/examples/v2/agents/README.md +3 -3
  512. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  513. package/docs/archive/examples/v2/agents/dba.md +4 -4
  514. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  515. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  516. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  517. package/docs/archive/examples/v2/agents/security.md +4 -4
  518. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  519. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  520. package/docs/archive/examples/v2/backend/package.json +42 -42
  521. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  522. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  523. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  524. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  525. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  526. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  527. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  528. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  529. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  530. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  531. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  532. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  533. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  534. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  535. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  536. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  537. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  538. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  539. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  540. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  541. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  542. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  543. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  544. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  545. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  547. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  548. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  549. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  550. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  551. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  552. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  553. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  554. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  555. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  556. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  557. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  558. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  559. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  560. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  561. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  562. package/docs/archive/examples/v2/memory/README.md +8 -8
  563. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  564. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  565. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  566. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  567. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  568. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  569. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  570. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  571. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  572. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  573. package/docs/capacidades-externas.md +86 -86
  574. package/docs/cli-first-operacao.md +74 -74
  575. package/docs/dev-workflow.md +421 -421
  576. package/docs/examples.md +546 -546
  577. package/docs/fluxo.md +103 -103
  578. package/docs/glossary.md +453 -453
  579. package/docs/init-project.md +457 -457
  580. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  581. package/docs/personas/architect/README.md +333 -333
  582. package/docs/personas/developer/README.md +371 -371
  583. package/docs/personas/executive/README.md +172 -172
  584. package/docs/personas/qa/README.md +350 -350
  585. package/docs/processo-projeto.md +138 -138
  586. package/docs/publishing.md +377 -377
  587. package/docs/quick-reference.md +409 -409
  588. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  589. package/docs/structure.md +360 -360
  590. package/docs/token-optimization.md +502 -502
  591. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  592. package/memory/00-global/mission.md +15 -15
  593. package/memory/00-global/shared-knowledge.md +8 -8
  594. package/memory/00-global/standards.md +47 -47
  595. package/memory/10-product/personas.md +21 -21
  596. package/memory/10-product/vision.md +27 -27
  597. package/memory/30-projects/README.md +15 -15
  598. package/memory/40-delivery/backlog.md +15 -15
  599. package/memory/40-delivery/current-sprint.md +20 -20
  600. package/memory/50-orchestration/gsd-harness.md +55 -55
  601. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  602. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  603. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  604. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  605. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  606. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  607. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  608. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  609. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  610. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  611. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  612. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  613. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  614. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  615. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  616. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  617. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  618. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  619. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  620. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  621. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  622. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  623. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  624. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  625. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  626. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  627. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  628. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  630. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  631. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  632. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  633. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  634. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  635. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  637. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  638. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  639. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  640. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  641. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  642. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  643. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  644. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  645. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  646. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  647. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  648. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  649. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  650. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  651. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  652. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  653. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  654. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  655. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  656. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  657. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  658. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  659. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  660. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  661. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  662. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  663. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  664. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  665. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  666. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  667. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  668. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  669. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  670. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  671. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  672. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  673. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  674. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  675. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  676. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  677. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  678. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  679. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  680. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  681. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  682. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  683. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  684. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  685. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  686. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  687. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  688. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  689. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  690. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  691. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  692. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  693. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  694. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  695. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  696. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  697. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  698. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  699. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  700. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  701. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  702. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  703. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  704. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  705. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  706. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  707. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  708. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  709. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  710. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  711. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  712. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  713. package/memory/90-decisions/_template.md +28 -28
  714. package/package.json +157 -157
  715. package/prompts/context-engineer-agent.md +19 -19
  716. package/prompts/governance-agent.md +16 -16
  717. package/prompts/marketing-agent.md +13 -13
  718. package/prompts/orchestrator-agent.md +18 -18
  719. package/prompts/product-agent.md +13 -13
  720. package/prompts/sdd-architect-agent.md +20 -20
  721. package/specs/README.md +70 -70
  722. package/specs/_templates/plan.md +43 -43
  723. package/specs/_templates/spec.md +43 -43
  724. package/specs/_templates/tasks.md +32 -32
  725. package/specs/agent-identity-reputation/plan.md +133 -0
  726. package/specs/agent-identity-reputation/spec.md +125 -0
  727. package/specs/agent-identity-reputation/tasks.md +51 -0
  728. package/specs/agent-runtime-monitoring/plan.md +78 -0
  729. package/specs/agent-runtime-monitoring/spec.md +92 -0
  730. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  731. package/specs/ai-code-provenance/plan.md +71 -0
  732. package/specs/ai-code-provenance/spec.md +97 -0
  733. package/specs/ai-code-provenance/tasks.md +39 -0
  734. package/specs/architecture-constitution/plan.md +110 -0
  735. package/specs/architecture-constitution/spec.md +114 -0
  736. package/specs/architecture-constitution/tasks.md +58 -0
  737. package/specs/change-risk-engine/plan.md +130 -0
  738. package/specs/change-risk-engine/spec.md +119 -0
  739. package/specs/change-risk-engine/tasks.md +72 -0
  740. package/specs/clean-arch-boilerplate/plan.md +137 -137
  741. package/specs/clean-arch-boilerplate/spec.md +121 -121
  742. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  743. package/specs/cli-first-operacao/plan.md +53 -53
  744. package/specs/cli-first-operacao/spec.md +53 -53
  745. package/specs/cli-first-operacao/tasks.md +53 -53
  746. package/specs/code-context/spec.md +56 -56
  747. package/specs/coerencia-do-sistema/plan.md +155 -155
  748. package/specs/coerencia-do-sistema/spec.md +123 -123
  749. package/specs/coerencia-do-sistema/tasks.md +115 -115
  750. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  751. package/specs/dev-token-assets-db/plan.md +71 -71
  752. package/specs/dev-token-assets-db/spec.md +58 -58
  753. package/specs/dev-token-assets-db/tasks.md +58 -58
  754. package/specs/doctor-do-nucleo/plan.md +165 -165
  755. package/specs/doctor-do-nucleo/spec.md +139 -139
  756. package/specs/doctor-do-nucleo/tasks.md +172 -172
  757. package/specs/drift-sentinel/spec.md +117 -0
  758. package/specs/engineer-facade-extension/plan.md +71 -0
  759. package/specs/engineer-facade-extension/spec.md +98 -0
  760. package/specs/engineer-facade-extension/tasks.md +36 -0
  761. package/specs/engineering-evidence-ledger/plan.md +121 -0
  762. package/specs/engineering-evidence-ledger/spec.md +90 -0
  763. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  764. package/specs/engineering-graph-extensions/plan.md +92 -0
  765. package/specs/engineering-graph-extensions/spec.md +101 -0
  766. package/specs/engineering-graph-extensions/tasks.md +60 -0
  767. package/specs/engineering-intelligence/spec.md +177 -0
  768. package/specs/forja-core/spec.md +71 -71
  769. package/specs/gates/spec.md +63 -63
  770. package/specs/governanca-visivel/plan.md +122 -122
  771. package/specs/governanca-visivel/spec.md +112 -112
  772. package/specs/governanca-visivel/tasks.md +60 -60
  773. package/specs/harness-codegraph/spec.md +71 -71
  774. package/specs/learning-loop-incidents/plan.md +59 -0
  775. package/specs/learning-loop-incidents/spec.md +93 -0
  776. package/specs/learning-loop-incidents/tasks.md +36 -0
  777. package/specs/memory-audit/spec.md +54 -54
  778. package/specs/orchestrate/spec.md +108 -108
  779. package/specs/orchestration-coherent/spec.md +95 -95
  780. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  781. package/specs/predictive-change-simulation/plan.md +109 -0
  782. package/specs/predictive-change-simulation/spec.md +107 -0
  783. package/specs/predictive-change-simulation/tasks.md +41 -0
  784. package/specs/project-smoke/spec.md +96 -96
  785. package/specs/project-upgrade/spec.md +58 -58
  786. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  787. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  788. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  789. package/specs/release-auditor-health/spec.md +23 -23
  790. package/specs/release-gate/plan.md +174 -174
  791. package/specs/release-gate/spec.md +122 -122
  792. package/specs/release-gate/tasks.md +183 -183
  793. package/specs/smart-agent-routing/plan.md +55 -0
  794. package/specs/smart-agent-routing/spec.md +85 -0
  795. package/specs/smart-agent-routing/tasks.md +26 -0
  796. package/specs/ts-migration/plan.md +200 -200
  797. package/specs/ts-migration/spec.md +119 -119
  798. package/specs/ts-migration/tasks.md +110 -110
package/README.md CHANGED
@@ -1,125 +1,132 @@
1
- <h1 align="center">🔨 Forja</h1>
2
-
3
- <p align="center">
4
- <strong>Turn coding AI into an engineering team with process and memory:<br>every project starts from a spec, every decision becomes an ADR, and nothing is lost between sessions.</strong>
5
- </p>
6
-
7
- <p align="center">
8
- <a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
9
- <img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
10
- <img src="https://img.shields.io/badge/operation-CLI--first-3553ff?style=flat-square" alt="CLI-first">
11
- <img src="https://img.shields.io/badge/agents-6_roles-orange?style=flat-square" alt="6 agents">
12
- <img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
13
- <img src="https://img.shields.io/badge/memory-SQLite_FTS5-green?style=flat-square" alt="Memory">
14
- <img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
15
- <img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
16
- <img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
17
- </p>
18
-
19
- <p align="center"><sub>🌐 <strong>English</strong> · <a href="README.pt-BR.md">Português</a></sub></p>
20
-
21
- ---
22
-
23
- ## Why Forja exists
24
-
25
- Coding agents are **amnesiac and undisciplined**: every session starts from zero, architecture
26
- decisions evaporate, code drifts from intent — and if you run several products at once, you pay
27
- that tax multiplied by N.
28
-
29
- **Forja** is the studio around the AI. It coordinates **6 agent roles** through a
30
- **Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)** pipeline, keeps a **hierarchical memory** indexed
31
- in SQLite that survives across sessions, and ties it all together behind **a single core CLI with
32
- gates and an audit trail** (`forja`, ADR-0020). Multi-AI by design (Claude, Copilot, Gemini,
33
- Codex). Everything is driven from the CLI.
34
-
35
- **Who it's for**: the solo dev or small team running multiple products with AI as the main
36
- workforce — and needing the discipline of a big team without having one.
37
-
38
- ## The 3 pillars
39
-
40
- | Pillar | What it delivers | Proof |
41
- |---|---|---|
42
- | **Memory that survives** | hierarchical, searchable context, shared across sessions and AIs | SQLite FTS5, smart-context (ADR-0003) |
43
- | **Process that governs** | nothing becomes code without a spec; nothing structural without an ADR; every command audited | SDD+GSD, 7-field handoffs (ADR-0005), `forja` core (ADR-0020) |
44
- | **A factory, not a single project** | multi-product workspace, per-project agent teams | ADR-0019, harness, codegraph (ADR-0017) |
45
-
46
- > This repository is the **engine (framework)** — it does not host production apps.
47
- > Your products live in the **Forja workspace** (`~/forja-workspace` by default), outside this repo.
48
- > See ADR-0019 for the rationale.
49
-
50
- ## Forja in 60 seconds
51
-
52
- ```console
53
- $ forja spec:new pix-payments
54
- ✓ Spec created: specs/pix-payments/spec.md # nothing becomes code without this
55
-
56
- $ forja gsd:handoff plan pix-payments
57
- Handoff recorded: product → sdd-architect # 7 fields, auditable (ADR-0005)
58
-
59
- $ forja code:impact processPayment
60
- Impact map: processPayment (depth 2) # blast radius BEFORE you edit
61
- --- Direct callers ---
62
- BillingController.charge · RetryWorker.run
63
-
64
- $ forja gsd:check pix-payments
65
- OK GSD runbook OK Spec directory
66
- OK SDD spec check OK Codegraph
67
- Result: baseline gates ready. # executable governance, not a checklist
68
- ```
69
-
70
- And each command above was recorded in `.context/forja-runs.jsonl` — when governance asks "was the
71
- process followed?", the answer is a file, not a promise.
72
-
73
- ## Why not just…?
74
-
75
- | Alternative | Where it stops | What Forja adds |
76
- |---|---|---|
77
- | **Plain Claude Code / Copilot** | brilliant in-session, amnesiac between sessions | FTS5 memory + process + audit around the AI |
78
- | **LangGraph / CrewAI** | infrastructure to *build* agents | the layer above: it *operates* the agent team day to day |
79
- | **Templates & spec kits** | stop once the spec is written | the full pipeline through governance, with gates that execute |
80
-
81
- ## Key capabilities
82
-
83
- - **Single core CLI** — every process command goes through `forja <command>`: a declarative
84
- registry, cross-cutting gates (workspace), and append-only audit in
85
- `.context/forja-runs.jsonl` (ADR-0020).
86
- - **Multi-agent orchestration** — 6 roles (orchestrator, context-engineer, sdd-architect, product,
87
- marketing, governance) with tracked handoffs (7 fields, ADR-0005).
88
- - **Hierarchical memory** — global → domain → task → summary, with FTS5 search and *smart-context*
89
- in 3 modes (ADR-0003).
90
- - **SDD + GSD pipeline** — `spec → plan → tasks → check`, decisions recorded as ADRs.
91
- - **Self-verification (invariants that run)** — the framework proves itself: a family of gates guards
92
- each frontier (core, tarball, doc coherence, agent topology, generated project), and `check:all`
93
- runs the whole battery into a single verdict. Governance stops depending on discipline — it becomes
94
- harness.
95
- - **Token economy measured, not asserted** — memory (the `context.md` as a map) saves ~60% vs
96
- exploring cold, and `token:economy` **proves** it across your domains. `code:context` delivers the
97
- map ready to paste; `memory:audit` guarantees it doesn't lie about the code.
98
- - **Project generation** — `project:new` scaffolds a full project (memory, agents, multi-AI
99
- instructions, a NestJS backend as the default boilerplate) and registers the record; `project:upgrade`
100
- brings new scaffold pieces to already-generated projects without touching the user's code.
1
+ <h1 align="center">🔨 Forja</h1>
2
+
3
+ <p align="center">
4
+ <strong>Turn coding AI into an engineering team with process and memory:<br>every project starts from a spec, every decision becomes an ADR, and nothing is lost between sessions.</strong>
5
+ </p>
6
+
7
+ <p align="center">
8
+ <a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
9
+ <img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
10
+ <img src="https://img.shields.io/badge/operation-CLI--first-3553ff?style=flat-square" alt="CLI-first">
11
+ <img src="https://img.shields.io/badge/agents-6_roles-orange?style=flat-square" alt="6 agents">
12
+ <img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
13
+ <img src="https://img.shields.io/badge/memory-SQLite_FTS5-green?style=flat-square" alt="Memory">
14
+ <img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
15
+ <img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
16
+ <img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
17
+ </p>
18
+
19
+ <p align="center"><sub>🌐 <strong>English</strong> · <a href="README.pt-BR.md">Português</a></sub></p>
20
+
21
+ ---
22
+
23
+ ## Why Forja exists
24
+
25
+ Coding agents are **amnesiac and undisciplined**: every session starts from zero, architecture
26
+ decisions evaporate, code drifts from intent — and if you run several products at once, you pay
27
+ that tax multiplied by N.
28
+
29
+ **Forja** is the studio around the AI. It coordinates **6 agent roles** through a
30
+ **Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)** pipeline, keeps a **hierarchical memory** indexed
31
+ in SQLite that survives across sessions, and ties it all together behind **a single core CLI with
32
+ gates and an audit trail** (`forja`, ADR-0020). Multi-AI by design (Claude, Copilot, Gemini,
33
+ Codex). Everything is driven from the CLI.
34
+
35
+ **Who it's for**: the solo dev or small team running multiple products with AI as the main
36
+ workforce — and needing the discipline of a big team without having one.
37
+
38
+ ## The 3 pillars
39
+
40
+ | Pillar | What it delivers | Proof |
41
+ |---|---|---|
42
+ | **Memory that survives** | hierarchical, searchable context, shared across sessions and AIs | SQLite FTS5, smart-context (ADR-0003) |
43
+ | **Process that governs** | nothing becomes code without a spec; nothing structural without an ADR; every command audited | SDD+GSD, 7-field handoffs (ADR-0005), `forja` core (ADR-0020) |
44
+ | **A factory, not a single project** | multi-product workspace, per-project agent teams | ADR-0019, harness, codegraph (ADR-0017) |
45
+
46
+ > This repository is the **engine (framework)** — it does not host production apps.
47
+ > Your products live in the **Forja workspace** (`~/forja-workspace` by default), outside this repo.
48
+ > See ADR-0019 for the rationale.
49
+
50
+ ## Forja in 60 seconds
51
+
52
+ ```console
53
+ $ forja spec:new pix-payments
54
+ ✓ Spec created: specs/pix-payments/spec.md # nothing becomes code without this
55
+
56
+ $ forja gsd:handoff plan pix-payments
57
+ Handoff recorded: product → sdd-architect # 7 fields, auditable (ADR-0005)
58
+
59
+ $ forja code:impact processPayment
60
+ Impact map: processPayment (depth 2) # blast radius BEFORE you edit
61
+ --- Direct callers ---
62
+ BillingController.charge · RetryWorker.run
63
+
64
+ $ forja gsd:check pix-payments
65
+ OK GSD runbook OK Spec directory
66
+ OK SDD spec check OK Codegraph
67
+ Result: baseline gates ready. # executable governance, not a checklist
68
+ ```
69
+
70
+ And each command above was recorded in `.context/forja-runs.jsonl` — when governance asks "was the
71
+ process followed?", the answer is a file, not a promise.
72
+
73
+ ## Why not just…?
74
+
75
+ | Alternative | Where it stops | What Forja adds |
76
+ |---|---|---|
77
+ | **Plain Claude Code / Copilot** | brilliant in-session, amnesiac between sessions | FTS5 memory + process + audit around the AI |
78
+ | **LangGraph / CrewAI** | infrastructure to *build* agents | the layer above: it *operates* the agent team day to day |
79
+ | **Templates & spec kits** | stop once the spec is written | the full pipeline through governance, with gates that execute |
80
+
81
+ ## Key capabilities
82
+
83
+ - **Single core CLI** — every process command goes through `forja <command>`: a declarative
84
+ registry, cross-cutting gates (workspace), and append-only audit in
85
+ `.context/forja-runs.jsonl` (ADR-0020).
86
+ - **Multi-agent orchestration** — 6 roles (orchestrator, context-engineer, sdd-architect, product,
87
+ marketing, governance) with tracked handoffs (7 fields, ADR-0005).
88
+ - **Hierarchical memory** — global → domain → task → summary, with FTS5 search and *smart-context*
89
+ in 3 modes (ADR-0003).
90
+ - **SDD + GSD pipeline** — `spec → plan → tasks → check`, decisions recorded as ADRs.
91
+ - **Self-verification (invariants that run)** — the framework proves itself: a family of gates guards
92
+ each frontier (core, tarball, doc coherence, agent topology, generated project), and `check:all`
93
+ runs the whole battery into a single verdict. Governance stops depending on discipline — it becomes
94
+ harness.
95
+ - **Token economy measured, not asserted** — memory (the `context.md` as a map) saves ~60% vs
96
+ exploring cold, and `token:economy` **proves** it across your domains. `code:context` delivers the
97
+ map ready to paste; `memory:audit` guarantees it doesn't lie about the code.
98
+ - **Project generation** — `project:new` scaffolds a full project (memory, agents, multi-AI
99
+ instructions, a NestJS backend as the default boilerplate) and registers the record; `project:upgrade`
100
+ brings new scaffold pieces to already-generated projects without touching the user's code.
101
101
  - **3 integrated capabilities** (ADR-0016): **codegraph** (code analysis via MCP), **harness**
102
102
  (agent-team design), **ai-engineering** (knowledge base).
103
103
  - **LLM Fit Loop** — adapters de CLI, perfis no workspace, probes sem custo, observações e
104
104
  recomendação determinística por papel/tarefa; credenciais nunca entram no Forja.
105
-
106
- ## ⚡ Quick start
107
-
108
- ```bash
109
- # Install (the package is forjajs; the command is forja)
110
- npm install -g forjajs
111
- forja # help grouped by domain
112
-
113
- # Prepare the production workspace (the fixed home for your projects)
114
- forja workspace:init
115
-
116
- # Create a new project (generated in ~/forja-workspace/projects/<name>)
117
- forja project:new my-project --ai claude,copilot
118
-
119
- # Enter the SDD/GSD cycle for the first feature
120
- forja spec:new my-feature
121
- forja spec:plan my-feature
122
- forja spec:tasks my-feature
105
+ - **Engineering Control Plane** (v3.0, ADR-0078) — the Engineering Graph turns ADRs/SPECs into
106
+ first-class, queryable nodes; the Architecture Constitution checks real code against decisions
107
+ already recorded; the Change Risk Engine scores a change 0-100 with named, evidenced factors;
108
+ `forja simulate` tests a ref in an isolated worktree and never promotes on its own. One façade,
109
+ `forja engineer "<goal>"`, composes all of it — context, relevant ADRs, architecture check, risk,
110
+ recommended agents, similar past incidents — before you start. Every score is information for a
111
+ human/policy rule to consult, never an autonomous decision on its own.
112
+
113
+ ## ⚡ Quick start
114
+
115
+ ```bash
116
+ # Install (the package is forjajs; the command is forja)
117
+ npm install -g forjajs
118
+ forja # help grouped by domain
119
+
120
+ # Prepare the production workspace (the fixed home for your projects)
121
+ forja workspace:init
122
+
123
+ # Create a new project (generated in ~/forja-workspace/projects/<name>)
124
+ forja project:new my-project --ai claude,copilot
125
+
126
+ # Enter the SDD/GSD cycle for the first feature
127
+ forja spec:new my-feature
128
+ forja spec:plan my-feature
129
+ forja spec:tasks my-feature
123
130
  forja spec:check my-feature
124
131
  ```
125
132
 
@@ -134,113 +141,141 @@ forja spec:set-status <feature> <spec|plan|tasks> <draft|approved>
134
141
  ```
135
142
 
136
143
  ### Prove supervised autonomy locally
137
-
138
- The deterministic offline proof uses an external fixture, a real Git worktree,
139
- human approval, a real `npm test`, diff validation, promotion, SQLite state,
140
- GraphLoop evidence and a compact handoff:
141
-
142
- ```bash
143
- npm run demo:autonomy
144
- ```
145
-
146
- The full flow is documented in [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
147
-
148
- Measure the deterministic context baseline and cache evidence:
149
-
150
- ```bash
151
- npm run benchmark:context
152
- ```
153
-
154
- The sandbox also exposes an explicit, auditable rollback after promotion. Official
155
- plugin boundaries are available as `@forja/plugin-github` and `@forja/plugin-docker`;
156
- external network or Docker handlers must be injected and permissioned by the host.
157
-
158
- > Cloned the repo instead of installing? The same commands run as
159
- > `node bin/forja.ts <command>` — the npm scripts are just thin aliases of the core.
160
- > The source is TypeScript and runs natively: **dev needs Node ≥ 22.6** (type stripping). The
161
- > *published* package ships `dist/*.js` and runs on **Node ≥ 20** — the `release-gate` proves it
162
- > every release (SPEC-012).
163
-
164
- Step by step on **create vs update** a project: [`docs/processo-projeto.md`](docs/processo-projeto.md).
165
-
166
- ## How it works — the process
167
-
168
- ```
169
- 💡 Demand
170
- ├─ project does NOT exist ─► project:new + boilerplate + harness (designs the team)
171
- └─ project DOES exist ─────► overlay --only-memory + codegraph init (understands the code)
172
- │
173
- ▼
174
- CLI-first CYCLE (docs/fluxo.md):
175
- 1·Understand → 2·Specify → 3·Architect → 4·Decompose → 5·Implement → 6·Govern → ✅
176
- ```
177
-
178
- | Step | Role | Capability |
179
- |------|------|------------|
180
- | 1 Understand | context-engineer | codegraph · ai-engineering |
181
- | 2 Specify | product | — |
182
- | 3 Architect | sdd-architect | harness · ADR |
183
- | 4 Decompose | sdd-architect | — |
184
- | 5 Implement | orchestrator + worker | codegraph (MCP) |
185
- | 6 Govern | governance | codegraph (`affected`) |
186
-
187
- Full cycle map: [`docs/fluxo.md`](docs/fluxo.md).
188
-
189
- ## The 3 integrated capabilities
190
-
191
- | Capability | Role | How to use |
192
- |---|---|---|
193
- | **codegraph** | code analysis (local MCP) | `forja code:index` · `codegraph explore "<area>"` · MCP tools `codegraph_explore`/`codegraph_node` |
194
- | **harness** | agent-team design (plugin) | in a Claude Code session: _"build a harness for this project"_ → generates `.claude/agents` + `.claude/skills` |
195
- | **ai-engineering** | knowledge base (reference) | see [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
196
-
197
- Details and reinstall: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
198
-
199
- ## The `forja` core
200
-
201
- Every process command goes through a single entry point (ADR-0020):
202
-
203
- ```bash
204
- forja # help grouped by domain
205
- forja <command> [args] # in a cloned repo: node bin/forja.ts <command>
206
- ```
207
-
208
- The core applies **gates** before running (e.g. product commands fail fast without a workspace) and
209
- records an **audit** of each run (command, args, exit code, duration) in
210
- `<workspace>/.context/forja-runs.jsonl` — the trail governance uses at review. The repo's npm
211
- scripts are thin aliases that route through the core.
212
-
213
- ## Essential commands
214
-
215
- ```bash
216
- # Workspace & projects
217
- forja workspace:init # create ~/forja-workspace
218
- forja project:new <name> --ai claude,copilot # create a project in the workspace
219
- forja project:list # list workspace projects
220
- forja workspace:project:check <name> # validate standards in a workspace project
221
-
222
- # SDD pipeline
223
- forja spec:new <slug> # also: spec:plan · spec:tasks · spec:check
224
-
225
- # Sprint & handoffs (GSD)
226
- forja sprint:start # also: sprint:status · sprint:complete
227
- forja gsd:plan <slug> # GSD runbook in .context/
228
- forja gsd:handoff <intent> <slug> # role-to-role handoff (ADR-0005)
229
- forja gsd:check <slug> # baseline runbook gates
230
- forja orchestrate "<goal>" --slug <s> # open a run: the SDD/GSD chain as a gated state machine (SPEC-021)
231
- forja orchestrate:status <slug> # the machine state: stages, gates, verdicts
232
- forja orchestrate:advance <slug> # run the stage gate; green → next; red → blocked
233
-
234
- # Code analysis (codegraph)
235
- forja code:check # trustworthy index (worktree + freshness)
236
- forja code:impact <symbol> # callers + blast radius before you edit
237
- forja code:query "<term>" # also: code:index · code:sync · code:status
238
-
239
- # Memory & context (workspace)
240
- forja sync:universal # reindex the workspace SQLite FTS5
241
- forja query:universal "<query>" # FTS5 search
144
+
145
+ The deterministic offline proof uses an external fixture, a real Git worktree,
146
+ human approval, a real `npm test`, diff validation, promotion, SQLite state,
147
+ GraphLoop evidence and a compact handoff:
148
+
149
+ ```bash
150
+ npm run demo:autonomy
151
+ ```
152
+
153
+ The full flow is documented in [`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`](docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md).
154
+
155
+ Measure the deterministic context baseline and cache evidence:
156
+
157
+ ```bash
158
+ npm run benchmark:context
159
+ ```
160
+
161
+ The sandbox also exposes an explicit, auditable rollback after promotion. Official
162
+ plugin boundaries are available as `@forja/plugin-github` and `@forja/plugin-docker`;
163
+ external network or Docker handlers must be injected and permissioned by the host.
164
+
165
+ > Cloned the repo instead of installing? The same commands run as
166
+ > `node bin/forja.ts <command>` — the npm scripts are just thin aliases of the core.
167
+ > The source is TypeScript and runs natively: **dev needs Node ≥ 22.6** (type stripping). The
168
+ > *published* package ships `dist/*.js` and runs on **Node ≥ 20** — the `release-gate` proves it
169
+ > every release (SPEC-012).
170
+
171
+ Step by step on **create vs update** a project: [`docs/processo-projeto.md`](docs/processo-projeto.md).
172
+
173
+ ## How it works — the process
174
+
175
+ ```
176
+ 💡 Demand
177
+ ├─ project does NOT exist ─► project:new + boilerplate + harness (designs the team)
178
+ └─ project DOES exist ─────► overlay --only-memory + codegraph init (understands the code)
179
+ │
180
+ ▼
181
+ CLI-first CYCLE (docs/fluxo.md):
182
+ 1·Understand → 2·Specify → 3·Architect → 4·Decompose → 5·Implement → 6·Govern → ✅
183
+ ```
184
+
185
+ | Step | Role | Capability |
186
+ |------|------|------------|
187
+ | 1 Understand | context-engineer | codegraph · ai-engineering |
188
+ | 2 Specify | product | — |
189
+ | 3 Architect | sdd-architect | harness · ADR |
190
+ | 4 Decompose | sdd-architect | — |
191
+ | 5 Implement | orchestrator + worker | codegraph (MCP) |
192
+ | 6 Govern | governance | codegraph (`affected`) |
193
+
194
+ Full cycle map: [`docs/fluxo.md`](docs/fluxo.md).
195
+
196
+ ## The 3 integrated capabilities
197
+
198
+ | Capability | Role | How to use |
199
+ |---|---|---|
200
+ | **codegraph** | code analysis (local MCP) | `forja code:index` · `codegraph explore "<area>"` · MCP tools `codegraph_explore`/`codegraph_node` |
201
+ | **harness** | agent-team design (plugin) | in a Claude Code session: _"build a harness for this project"_ → generates `.claude/agents` + `.claude/skills` |
202
+ | **ai-engineering** | knowledge base (reference) | see [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
203
+
204
+ Details and reinstall: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
205
+
206
+ ## The `forja` core
207
+
208
+ Every process command goes through a single entry point (ADR-0020):
209
+
210
+ ```bash
211
+ forja # help grouped by domain
212
+ forja <command> [args] # in a cloned repo: node bin/forja.ts <command>
213
+ ```
214
+
215
+ The core applies **gates** before running (e.g. product commands fail fast without a workspace) and
216
+ records an **audit** of each run (command, args, exit code, duration) in
217
+ `<workspace>/.context/forja-runs.jsonl` — the trail governance uses at review. The repo's npm
218
+ scripts are thin aliases that route through the core.
219
+
220
+ ## Essential commands
221
+
222
+ ```bash
223
+ # Workspace & projects
224
+ forja workspace:init # create ~/forja-workspace
225
+ forja project:new <name> --ai claude,copilot # create a project in the workspace
226
+ forja project:list # list workspace projects
227
+ forja workspace:project:check <name> # validate standards in a workspace project
228
+
229
+ # SDD pipeline
230
+ forja spec:new <slug> # also: spec:plan · spec:tasks · spec:check
231
+
232
+ # Sprint & handoffs (GSD)
233
+ forja sprint:start # also: sprint:status · sprint:complete
234
+ forja gsd:plan <slug> # GSD runbook in .context/
235
+ forja gsd:handoff <intent> <slug> # role-to-role handoff (ADR-0005)
236
+ forja gsd:check <slug> # baseline runbook gates
237
+ forja orchestrate "<goal>" --slug <s> # open a run: the SDD/GSD chain as a gated state machine (SPEC-021)
238
+ forja orchestrate:status <slug> # the machine state: stages, gates, verdicts
239
+ forja orchestrate:advance <slug> # run the stage gate; green → next; red → blocked
240
+
241
+ # Code analysis (codegraph)
242
+ forja code:check # trustworthy index (worktree + freshness)
243
+ forja code:impact <symbol> # callers + blast radius before you edit
244
+ forja code:query "<term>" # also: code:index · code:sync · code:status
245
+ forja drift:check [--domain <d>] # reindex + flag 'verified' relations that stopped being true
246
+ forja adr:list # ADRs as first-class graph nodes, with status (SPEC-032)
247
+ forja adr:show <id> # status, source file, constraints
248
+ forja adr:impact <id> # who/what depends on this ADR — GraphLoop.impact()
249
+ forja adr:graph [<id>] # ADR/SPEC subgraph as JSON
250
+ forja architecture:compile # ADRs (## Constraints) → constitution.json (SPEC-033)
251
+ forja architecture:check # real code vs. the compiled Constitution
252
+ forja architecture:status # active/proposed rules, last compile
253
+ forja architecture:explain <rule-id> # source ADR, original text, severity
254
+ forja architecture:approve <rule-id> # promotes a proposed rule to active (via ApprovalLedger)
255
+ forja risk:assess [ref] # 0-100 change risk score, 7 named factors (SPEC-034)
256
+ forja risk:explain <assessment-id> # replays a computed assessment, factor by factor
257
+ forja evidence:show <run-id> # aggregated view of a persisted run (SPEC-035)
258
+ forja engineer "<objetivo>" [--ref <ref>] [--role <role>] [--json] # façade: context + relevant ADRs + architecture check + risk + recommended agents + similar incidents + recommended flow (SPEC-035, SPEC-042)
259
+ forja agent:register <id> --role <role> [--provider <p>] [--model <m>] [--capabilities <c1,c2>] [--domains <d1,d2>] # register/update an agent (SPEC-036)
260
+ forja agent:list # registered agents, with trustLevel if already scored
261
+ forja agent:show <id> # detail of one registered agent
262
+ forja agent:score <id> [--domain <d>] # computes and persists trustLevel/autonomyLevel from real Observations
263
+ forja agent:history <id> # an agent's Observations, most recent first
264
+ forja agent:recommend --role <role> [--domain <d>] # ranks registered agents by fit — information, not assignment (SPEC-037)
265
+ forja simulate <ref> [--command "npm test"] [--json] # test+architecture+risk against an isolated worktree, never promotes (SPEC-038)
266
+ forja provenance:record <run-id> # extracts file<->agent provenance from a persisted RuntimeRun (SPEC-039)
267
+ forja blame <file> # provenance history for a file — file granularity, not line
268
+ forja sbom [--json] # AI-SBOM: provenance report aggregated by agent
269
+ forja agent:monitor <id> [--window-hours <n>] # compares recent behavior against historical baseline — information, never blocks (SPEC-040)
270
+ forja incident:record --title <t> [--description <d>] # records an incident in the Engineering Graph (SPEC-041)
271
+ forja incident:list # recorded incidents, most recent first
272
+ forja incident:similar "<query>" # keyword-based similar-incident suggestion — never applies anything
273
+
274
+ # Memory & context (workspace)
275
+ forja sync:universal # reindex the workspace SQLite FTS5
276
+ forja query:universal "<query>" # FTS5 search
242
277
  forja context:smart # smart-context (3 modes, ADR-0003)
243
- forja memory:compress # archive old runs + VACUUM
278
+ forja memory:compress # archive old runs + VACUUM
244
279
  forja memory:extract # extract global knowledge from memory
245
280
 
246
281
  # LLM adapters and evidence
@@ -249,122 +284,148 @@ forja llm:doctor # verify configured CLIs without invo
249
284
  forja llm:recommend --role worker --task implementation
250
285
  forja llm:run --profile codex --task specs/my-feature/spec.md
251
286
  forja llm:eval --scope model --id codex:default
252
-
253
- # Quality & release
254
- forja project:check # framework standards (pre-commit)
255
- forja tools:doctor # core X-ray; tells permission/lock from corruption; exit 1 if broken
256
- forja release:check --publish # tarball gate before publishing
257
- forja project:smoke # generated-project gate; --full installs and builds the backend
258
- forja project:dashboard # static status report
259
-
260
- # Governance & audit
261
- forja audit:sync # project the audit trail into a queryable table
262
- forja audit:query --failed # query: --failed, --cmd <x>, --since 7d
263
- forja governance:dashboard # static HTML panel (gates, SDD, audit) — no server
264
- ```
265
-
266
- ## Framework vs workspace separation
267
-
268
- Forja is split in two:
269
-
270
- 1. **Framework** (this repository): the engine, conventions, scripts, and the framework's own memory.
271
- 2. **Workspace** (`~/forja-workspace` by default): the "fixed home" where product projects, their
272
- universal memory, and product specs live.
273
-
274
- The workspace path is resolved by priority:
275
-
276
- 1. `FORJA_WORKSPACE` environment variable
277
- 2. `workspaceRoot` field in `~/.forjarc.json`
278
- 3. Default: `~/forja-workspace`
279
-
280
- See ADR-0019 for the architectural decision.
281
-
282
- ## Repository structure (framework)
283
-
284
- ```
285
- bin/ CLIs (forja — the core; init-project, create-memory-nest-kit)
286
- lib/ Reusable modules; lib/core/ is the invariant engine (registry, checks, health, release, doc-graph, gates)
287
- scripts/ Automation (sprint-manager, agent-router, sync-universal-memory, …)
288
- specs/ The framework's own SDD pipeline (spec → plan → tasks)
289
- boilerplates/ Stack templates (api-rest, saas, ecommerce, microservices, monorepo)
290
- memory/ Framework memory (00-global … 90-decisions/ADRs)
291
- docs/ Documentation by persona and by topic (see DOC-MAP.md)
292
- prompts/ Portable prompts for the 6 roles
293
- .claude/ Claude Code sub-agents and settings
294
- projects/ LEGACY — do not use; projects live in the external workspace
295
- ```
296
-
297
- ## Workspace structure
298
-
299
- ```
300
- ~/forja-workspace/
301
- projects/ # generated products
302
- memory/
303
- sqlite/universal.db # SQLite FTS5 for the products
304
- 30-projects/ # project records
305
- specs/ # product specs
306
- .context/ # product GSD runbooks
307
- README.md
308
- ```
309
-
310
- ## Documentation
311
-
312
- The docs are written in **Brazilian Portuguese** — that's part of the project's identity. The CLI
313
- output, code, and ADRs are readable regardless of language.
314
-
315
- - [`DOC-MAP.md`](DOC-MAP.md) — map by role and by topic (start here)
316
- - [`docs/processo-projeto.md`](docs/processo-projeto.md) — create vs update a project
317
- - [`docs/fluxo.md`](docs/fluxo.md) — the CLI-first cycle map
318
- - [`AGENTS.md`](AGENTS.md) — the 6 roles and the topology
319
- - [`memory/90-decisions/`](memory/90-decisions/) — ADRs with rationale
320
- - [`CHANGELOG.md`](CHANGELOG.md) — history
321
-
322
- ## Conventions
323
-
324
- - **CLI-first** — sprints, SDD, GSD, handoffs, and governance by command; the UI is never a gate.
325
- - **ADRs** — every structural decision becomes `memory/90-decisions/NNNN-title.md`.
326
- - **Handoffs** — 7 required fields (ADR-0005), stored in SQLite (ADR-0008).
327
- - **pt-BR** — communication and documentation in Portuguese.
328
-
329
- ## Roadmap
330
-
331
- The throughline: **turn knowledge that lives as convention into an executable invariant.** Each item
332
- below either closes a framework frontier with a gate, or carries that pattern into generated projects.
333
-
334
- **Shipped** (through v1.6.0)
335
-
336
- - [x] **Gate family** — every framework frontier is guarded by an invariant that runs: core
337
- (`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), doc + ADR + agent-topology
338
- coherence (ADR-0025, SPEC-019), generated project (`project:smoke`, ADR-0029). And `check:all`
339
- runs the whole battery into one verdict (SPEC-020).
340
- - [x] **TypeScript migration complete** — source 100% `.ts`, ships `dist/`, `noImplicitAny` ON. Found
341
- latent bugs no test caught (SPEC-012).
342
- - [x] **Memory economy as a system** — **measured** (`token:economy` proves ~60% vs cold),
343
- **delivered** (`code:context`), **protected** (`memory:audit`, both directions), and **propagated**:
344
- the generated project inherits the maps gate (ADR-0030).
345
- - [x] **`project:upgrade`** — update an already-generated project without losing code: additive, never
346
- overwrites (SPEC-018).
347
- - [x] **Calibrated Clean Architecture** — layers where they pay off, lean where they don't; and the
348
- token claim **measured and corrected** — the saving is memory's, not the layers' (ADR-0027).
349
-
350
- **Next** (by dependency, not by wish)
351
-
352
- - [x] **Generated backend `builds` under new toolchains** — the template now matches the
353
- framework's `better-sqlite3` (^12, with prebuilds); `check:all --full` compiles the generated
354
- backend on Node 26.
355
- - [x] **`release-auditor` consumes the gate** — the agent runs and judges `release:check --publish`
356
- (ADR-0024), including `consumer-spec-new`; it doesn't reimplement the procedure.
357
- - [ ] **Boilerplates beyond NestJS** — the process is stack-agnostic; the templates will follow.
358
- - [ ] **(vision) the orchestration engine** — the handoff chain that **runs**, not just is coherent
359
- (SPEC-019 left it as future). The namesake executing: a 2.0 candidate.
360
-
361
- Suggestions? Open an issue — a non-trivial feature here starts from a spec, yours included.
362
-
363
- ---
364
-
365
- <p align="center">
366
- <strong>Did Forja help you tame your agents?</strong><br>
367
- A ⭐ is what carries the project to more devs still paying the amnesiac-AI tax.
368
- </p>
369
-
370
- <p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contributing</a></sub></p>
287
+ forja cost:economy # real $ cost per model, from the observation store
288
+
289
+ # Quality & release
290
+ forja project:check # framework standards (pre-commit)
291
+ forja tools:doctor # core X-ray; tells permission/lock from corruption; exit 1 if broken
292
+ forja release:check --publish # tarball gate before publishing
293
+ forja project:smoke # generated-project gate; --full installs and builds the backend
294
+ forja project:dashboard # static status report
295
+
296
+ # Governance & audit
297
+ forja audit:sync # project the audit trail into a queryable table
298
+ forja audit:query --failed # query: --failed, --cmd <x>, --since 7d
299
+ forja governance:dashboard # static HTML panel (gates, SDD, audit) — no server
300
+ ```
301
+
302
+ ## Framework vs workspace separation
303
+
304
+ Forja is split in two:
305
+
306
+ 1. **Framework** (this repository): the engine, conventions, scripts, and the framework's own memory.
307
+ 2. **Workspace** (`~/forja-workspace` by default): the "fixed home" where product projects, their
308
+ universal memory, and product specs live.
309
+
310
+ The workspace path is resolved by priority:
311
+
312
+ 1. `FORJA_WORKSPACE` environment variable
313
+ 2. `workspaceRoot` field in `~/.forjarc.json`
314
+ 3. Default: `~/forja-workspace`
315
+
316
+ See ADR-0019 for the architectural decision.
317
+
318
+ ## Repository structure (framework)
319
+
320
+ ```
321
+ bin/ CLIs (forja — the core; init-project, create-memory-nest-kit)
322
+ lib/ Reusable modules; lib/core/ is the invariant engine (registry, checks, health, release, doc-graph, gates)
323
+ scripts/ Automation (sprint-manager, agent-router, sync-universal-memory, …)
324
+ specs/ The framework's own SDD pipeline (spec → plan → tasks)
325
+ boilerplates/ Stack templates (api-rest, saas, ecommerce, microservices, monorepo)
326
+ memory/ Framework memory (00-global … 90-decisions/ADRs)
327
+ docs/ Documentation by persona and by topic (see DOC-MAP.md)
328
+ prompts/ Portable prompts for the 6 roles
329
+ .claude/ Claude Code sub-agents and settings
330
+ projects/ LEGACY — do not use; projects live in the external workspace
331
+ ```
332
+
333
+ ## Workspace structure
334
+
335
+ ```
336
+ ~/forja-workspace/
337
+ projects/ # generated products
338
+ memory/
339
+ sqlite/universal.db # SQLite FTS5 for the products
340
+ 30-projects/ # project records
341
+ specs/ # product specs
342
+ .context/ # product GSD runbooks
343
+ README.md
344
+ ```
345
+
346
+ ## Documentation
347
+
348
+ The docs are written in **Brazilian Portuguese** — that's part of the project's identity. The CLI
349
+ output, code, and ADRs are readable regardless of language.
350
+
351
+ - [`DOC-MAP.md`](DOC-MAP.md) — map by role and by topic (start here)
352
+ - [`docs/processo-projeto.md`](docs/processo-projeto.md) — create vs update a project
353
+ - [`docs/fluxo.md`](docs/fluxo.md) — the CLI-first cycle map
354
+ - [`AGENTS.md`](AGENTS.md) — the 6 roles and the topology
355
+ - [`memory/90-decisions/`](memory/90-decisions/) — ADRs with rationale
356
+ - [`CHANGELOG.md`](CHANGELOG.md) — history
357
+
358
+ ## Conventions
359
+
360
+ - **CLI-first** — sprints, SDD, GSD, handoffs, and governance by command; the UI is never a gate.
361
+ - **ADRs** — every structural decision becomes `memory/90-decisions/NNNN-title.md`.
362
+ - **Handoffs** — 7 required fields (ADR-0005), stored in SQLite (ADR-0008).
363
+ - **pt-BR** — communication and documentation in Portuguese.
364
+
365
+ ## Roadmap
366
+
367
+ The throughline: **turn knowledge that lives as convention into an executable invariant.** Each item
368
+ below either closes a framework frontier with a gate, or carries that pattern into generated projects.
369
+
370
+ **Shipped** (v3.0.0 — Engineering Control Plane, ADR-0078)
371
+
372
+ - [x] **Engineering Graph** — ADRs/SPECs as first-class, queryable nodes (`adr:list/show/impact/graph`),
373
+ deterministic extraction, no LLM (SPEC-032).
374
+ - [x] **Architecture Constitution** — ADR `## Constraints` compile into rules checked against real
375
+ code (`architecture:compile/check/status/explain/approve`), reusing `ApprovalLedger`, not a
376
+ parallel approval system (SPEC-033).
377
+ - [x] **Change Risk Engine** — a 0-100 score with 7 named, evidenced factors (`risk:assess/explain`);
378
+ `PolicyEngine` can optionally consult it (`riskScoreRange`), never a parallel decision engine
379
+ (SPEC-034).
380
+ - [x] **Evidence Ledger + `forja engineer`** — a per-run aggregated view, and the façade that
381
+ composes context + relevant ADRs + architecture + risk + recommended agents + similar incidents +
382
+ recommended flow before you start (SPEC-035, extended in SPEC-042).
383
+ - [x] **Agent Identity & Reputation, Smart Routing** — persistent agent registry with reputation
384
+ derived from real behavior, never self-declared (`agent:register/score/recommend`, SPEC-036/037).
385
+ - [x] **Predictive Change Simulation** — `forja simulate <ref>` tests a ref in an isolated git
386
+ worktree; never promotes on its own (SPEC-038).
387
+ - [x] **AI Code Provenance + Runtime Monitoring** — `forja blame`/`sbom` (file-granularity
388
+ provenance), `agent:monitor` (behavior-anomaly detection vs. an agent's own baseline) — both
389
+ information for `PolicyEngine`/a human to consult, never automatic (SPEC-039/040).
390
+ - [x] **Learning Loop** — `incident:record/list/similar`, keyword-based suggestion, never automatic
391
+ application (SPEC-041).
392
+ - [x] **Autonomous Maintenance readiness** — ADR-0079 documents the guardrails any future real
393
+ autonomous-maintenance spec must respect; deliberately not enabled yet, by the vision's own design.
394
+
395
+ **Shipped** (through v1.6.0)
396
+
397
+ - [x] **Gate family** — every framework frontier is guarded by an invariant that runs: core
398
+ (`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), doc + ADR + agent-topology
399
+ coherence (ADR-0025, SPEC-019), generated project (`project:smoke`, ADR-0029). And `check:all`
400
+ runs the whole battery into one verdict (SPEC-020).
401
+ - [x] **TypeScript migration complete** — source 100% `.ts`, ships `dist/`, `noImplicitAny` ON. Found
402
+ latent bugs no test caught (SPEC-012).
403
+ - [x] **Memory economy as a system** — **measured** (`token:economy` proves ~60% vs cold),
404
+ **delivered** (`code:context`), **protected** (`memory:audit`, both directions), and **propagated**:
405
+ the generated project inherits the maps gate (ADR-0030).
406
+ - [x] **`project:upgrade`** — update an already-generated project without losing code: additive, never
407
+ overwrites (SPEC-018).
408
+ - [x] **Calibrated Clean Architecture** — layers where they pay off, lean where they don't; and the
409
+ token claim **measured and corrected** — the saving is memory's, not the layers' (ADR-0027).
410
+ - [x] **Generated backend `builds` under new toolchains** — the template now matches the
411
+ framework's `better-sqlite3` (^12, with prebuilds); `check:all --full` compiles the generated
412
+ backend on Node 26.
413
+ - [x] **`release-auditor` consumes the gate** — the agent runs and judges `release:check --publish`
414
+ (ADR-0024), including `consumer-spec-new`; it doesn't reimplement the procedure.
415
+
416
+ **Next** (by dependency, not by wish)
417
+
418
+ - [ ] **Cross-project Intelligence** (Phase 6 remainder) — correlating incidents across multiple
419
+ repositories; needs a data source this single-repo workspace doesn't have yet.
420
+ - [ ] **Boilerplates beyond NestJS** — the process is stack-agnostic; the templates will follow.
421
+
422
+ Suggestions? Open an issue — a non-trivial feature here starts from a spec, yours included.
423
+
424
+ ---
425
+
426
+ <p align="center">
427
+ <strong>Did Forja help you tame your agents?</strong><br>
428
+ A ⭐ is what carries the project to more devs still paying the amnesiac-AI tax.
429
+ </p>
430
+
431
+ <p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contributing</a></sub></p>