forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,111 +1,111 @@
1
- # ADR-0021: Guardrails de harness e dependência de runtime explícita
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-09
5
- - **Autor(es)**: Allan Pablo
6
- - **Tags**: harness, hooks, npm, memory, governance
7
-
8
- ## Contexto
9
-
10
- Três falhas silenciosas foram encontradas com o framework já publicado como `forjajs` no npm.
11
- As três compartilham a mesma natureza: **erram sem avisar**. Nenhuma quebrava um teste,
12
- nenhuma aparecia no `git status`, e todas produziam trabalho errado com aparência de trabalho certo.
13
-
14
- 1. **`.mcp.json` com path absoluto obsoleto.** O codegraph era iniciado com
15
- `-p /home/apk/.../2-Projeto-Agents/projects/forja`, uma cópia parada no commit `282c265`
16
- (anterior ao ADR-0020). Consequência: `bin/forja.mjs` e `lib/core/` — o core inteiro que o
17
- `CLAUDE.md` manda todo agente usar — eram invisíveis ao índice. Qualquer `codegraph_explore`
18
- respondia sobre código morto, com confiança. O path também era versionado, quebrando para
19
- qualquer outro contribuidor.
20
-
21
- 2. **`better-sqlite3` como `devDependency`.** Dez scripts sob `files[]` a importam
22
- estaticamente, e o pacote declarava zero `dependencies`. Numa instalação limpa
23
- (`npm i -g forjajs`), `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
24
- `memory:compress` e `project:dashboard` estouravam com `ERR_MODULE_NOT_FOUND`. O `forja`
25
- sem argumentos funcionava — o help não carrega os scripts — o que mascarava a quebra.
26
-
27
- 3. **Regras de repositório existiam só como prosa.** `projects/` é declarado off-limits no
28
- `CLAUDE.md`, e a invariante do ADR-0020 ("comando novo = entrada no registry") era validada
29
- apenas no pre-commit via lefthook, que é opt-in. Ambas dependiam de a IA lembrar. Uma regra
30
- que depende de memória não é uma regra; é uma sugestão.
31
-
32
- 4. **Índice FTS5 cruzado com o conteúdo errado.** `sync-universal-memory.js` obtinha o id do nó
33
- recém-gravado via `result.lastInsertRowid || SELECT id ...`. Num `INSERT ... ON CONFLICT DO
34
- UPDATE` que *atualiza*, o SQLite não redefine `lastInsertRowid` — mantém o id do último INSERT
35
- da conexão. Sendo truthy, o fallback nunca disparava. Toda execução com um insert seguido de
36
- updates gravava o conteúdo de um documento sob o `node_id` de outro. Efeito medido: o ADR-0021
37
- indexado com o corpo de "Harnesses: Hermes e GSD"; `query:universal "registry"` não encontrava
38
- o ADR-0020; 135 linhas órfãs acumuladas. Como `query:universal` é o **primeiro passo** da
39
- economia de tokens do ADR-0009, o framework vinha alimentando os agentes com o documento
40
- errado — sem erro, sem log, sem sintoma.
41
-
42
- ## Decisão
43
-
44
- Mover a aplicação das regras do texto para o harness, e a verificação da publicação da leitura
45
- para a execução.
46
-
47
- - **`.mcp.json` sem `-p`.** Em modo MCP o codegraph resolve o projeto pelo `rootUri` do cliente.
48
- Remover o path elimina a classe inteira de erro em vez de corrigir uma instância.
49
- - **`better-sqlite3` em `dependencies`.** É dependência de runtime; era só declaração errada.
50
- - **`PreToolUse` → `scripts/hook-guard-paths.mjs`.** Bloqueia escrita em `projects/` e
51
- `docs/archive/` com exit 2, devolvendo o motivo e a alternativa. Falha aberta.
52
- - **`PostToolUse` → `scripts/hook-post-edit.mjs`.** Ao editar `lib/core/registry.mjs` ou
53
- `package.json`, roda `test/forja-core.test.js` na hora. A quebra chega junto da edição que
54
- a causou, não commits depois.
55
- - **`SessionStart` resiliente e honesto.** Todo acesso a SQLite passa a ser lazy — o hook
56
- degradava para stack trace sem `node_modules`. Além disso, passa a avisar quando `memory/`
57
- mudou depois do último `sync:universal`: índice defasado é a versão local do problema (1).
58
- - **`RETURNING id` no upsert de `memory_nodes`.** Devolve a linha realmente afetada, inserida ou
59
- atualizada, eliminando a dependência de `lastInsertRowid`. O sync passa a purgar linhas órfãs
60
- do `search_idx` ao final, e o `title` volta a ser atualizado no conflito.
61
- - **Subagent `release-auditor`.** Audita o pacote instalando o tarball de verdade e exercitando
62
- comandos reais. Proibido aprovar por leitura de código. Exige árvore git limpa antes e depois:
63
- `npm publish` empacota o **disco**, não o commit, e sua aprovação é perecível. A v1.1.1 saiu
64
- publicada com `otplib` e `qrcode` em `dependencies` — instalados na árvore de trabalho para
65
- gerar o código OTP do 2FA, nunca commitados, nunca importados por linha alguma do projeto.
66
- A auditoria havia passado minutos antes, sobre um disco que deixou de existir.
67
- - **Skills `new-adr` e `new-command`.** Os dois rituais do repo viram etapas executáveis.
68
-
69
- ## Alternativas consideradas
70
-
71
- - **Path relativo (`-p .`) no `.mcp.json`** — rejeitada porque ainda depende do `cwd` do processo
72
- do servidor, que não é contratual. Omitir a flag delega ao protocolo, que é.
73
- - **`better-sqlite3` como `optionalDependency` com degradação** — rejeitada porque a memória
74
- hierárquica com FTS5 é a proposta central do Forja, não um extra. Um `forjajs` sem memória
75
- não é uma instalação degradada; é uma instalação errada.
76
- - **Manter as regras no `CLAUDE.md` e confiar na leitura do agente** — rejeitada por evidência:
77
- as regras já estavam escritas e ainda assim o índice ficou apontando para a árvore errada por
78
- mais de uma semana.
79
- - **Rodar a suíte inteira no `PostToolUse`** — rejeitada por custo. O gate é `forja-core.test.js`,
80
- um arquivo, poucos segundos. Um hook lento é um hook que alguém desliga.
81
- - **Reconstruir o `search_idx` do zero a cada sync** — rejeitada porque esconderia a causa. O
82
- índice ficaria correto sem que o upsert deixasse de devolver o id errado, e o próximo consumidor
83
- de `lastInsertRowid` reencontraria o mesmo bug.
84
-
85
- ## Consequências
86
-
87
- **Positivas**:
88
- - O pacote publicado passa a funcionar numa instalação limpa — verificado via `npm pack` + install.
89
- - `query:universal` volta a devolver o documento que casou com a busca. Medido: 709 pares
90
- título↔conteúdo alinhados, 0 cruzados, 0 órfãos (antes: 3 cruzados, 135 órfãos).
91
- - Violações de `projects/` e do registry tornam-se impossíveis, não improváveis.
92
- - O índice de memória defasado passa a se anunciar em vez de responder errado calado.
93
- - Contribuidores externos clonam e o codegraph indexa o repo certo, sem editar nada.
94
-
95
- **Negativas / Trade-offs**:
96
- - `npm i forjajs` agora compila/baixa um módulo nativo (`better-sqlite3`): instalação mais lenta
97
- e sujeita a prebuilds por plataforma. É o preço de o produto funcionar.
98
- - O hook `PostToolUse` acrescenta poucos segundos a cada edição de `registry.mjs` ou `package.json`.
99
- - Guardrails têm escape hatch (`FORJA_GUARD=0`, `FORJA_HOOK_TEST=0`). Um guard sem escape vira
100
- um guard contornado por caminhos piores.
101
- - `.claude/skills/` entra em `files[]`, aumentando o tarball.
102
-
103
- ## Rastreamento
104
- - Implementação: `.mcp.json`, `package.json`, `.claude/settings.json`,
105
- `scripts/sync-universal-memory.js`, `scripts/hook-guard-paths.mjs`, `scripts/hook-post-edit.mjs`,
106
- `scripts/hook-session-start.mjs`, `.claude/agents/release-auditor.md`,
107
- `.claude/skills/new-adr/`, `.claude/skills/new-command/`
108
- - Testes: `test/hooks.test.js`, `test/memory-index.test.js`
109
- - ADRs relacionadas: ADR-0009 (economia de tokens — a corrupção do FTS a invalidava na prática),
110
- ADR-0017 (codegraph no harness), ADR-0018 (ferramentas de processo),
111
- ADR-0019 (workspace separado), ADR-0020 (forja core CLI única)
1
+ # ADR-0021: Guardrails de harness e dependência de runtime explícita
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-09
5
+ - **Autor(es)**: Allan Pablo
6
+ - **Tags**: harness, hooks, npm, memory, governance
7
+
8
+ ## Contexto
9
+
10
+ Três falhas silenciosas foram encontradas com o framework já publicado como `forjajs` no npm.
11
+ As três compartilham a mesma natureza: **erram sem avisar**. Nenhuma quebrava um teste,
12
+ nenhuma aparecia no `git status`, e todas produziam trabalho errado com aparência de trabalho certo.
13
+
14
+ 1. **`.mcp.json` com path absoluto obsoleto.** O codegraph era iniciado com
15
+ `-p /home/apk/.../2-Projeto-Agents/projects/forja`, uma cópia parada no commit `282c265`
16
+ (anterior ao ADR-0020). Consequência: `bin/forja.mjs` e `lib/core/` — o core inteiro que o
17
+ `CLAUDE.md` manda todo agente usar — eram invisíveis ao índice. Qualquer `codegraph_explore`
18
+ respondia sobre código morto, com confiança. O path também era versionado, quebrando para
19
+ qualquer outro contribuidor.
20
+
21
+ 2. **`better-sqlite3` como `devDependency`.** Dez scripts sob `files[]` a importam
22
+ estaticamente, e o pacote declarava zero `dependencies`. Numa instalação limpa
23
+ (`npm i -g forjajs`), `query:universal`, `sync:universal`, `context:smart`, `agent:route`,
24
+ `memory:compress` e `project:dashboard` estouravam com `ERR_MODULE_NOT_FOUND`. O `forja`
25
+ sem argumentos funcionava — o help não carrega os scripts — o que mascarava a quebra.
26
+
27
+ 3. **Regras de repositório existiam só como prosa.** `projects/` é declarado off-limits no
28
+ `CLAUDE.md`, e a invariante do ADR-0020 ("comando novo = entrada no registry") era validada
29
+ apenas no pre-commit via lefthook, que é opt-in. Ambas dependiam de a IA lembrar. Uma regra
30
+ que depende de memória não é uma regra; é uma sugestão.
31
+
32
+ 4. **Índice FTS5 cruzado com o conteúdo errado.** `sync-universal-memory.js` obtinha o id do nó
33
+ recém-gravado via `result.lastInsertRowid || SELECT id ...`. Num `INSERT ... ON CONFLICT DO
34
+ UPDATE` que *atualiza*, o SQLite não redefine `lastInsertRowid` — mantém o id do último INSERT
35
+ da conexão. Sendo truthy, o fallback nunca disparava. Toda execução com um insert seguido de
36
+ updates gravava o conteúdo de um documento sob o `node_id` de outro. Efeito medido: o ADR-0021
37
+ indexado com o corpo de "Harnesses: Hermes e GSD"; `query:universal "registry"` não encontrava
38
+ o ADR-0020; 135 linhas órfãs acumuladas. Como `query:universal` é o **primeiro passo** da
39
+ economia de tokens do ADR-0009, o framework vinha alimentando os agentes com o documento
40
+ errado — sem erro, sem log, sem sintoma.
41
+
42
+ ## Decisão
43
+
44
+ Mover a aplicação das regras do texto para o harness, e a verificação da publicação da leitura
45
+ para a execução.
46
+
47
+ - **`.mcp.json` sem `-p`.** Em modo MCP o codegraph resolve o projeto pelo `rootUri` do cliente.
48
+ Remover o path elimina a classe inteira de erro em vez de corrigir uma instância.
49
+ - **`better-sqlite3` em `dependencies`.** É dependência de runtime; era só declaração errada.
50
+ - **`PreToolUse` → `scripts/hook-guard-paths.mjs`.** Bloqueia escrita em `projects/` e
51
+ `docs/archive/` com exit 2, devolvendo o motivo e a alternativa. Falha aberta.
52
+ - **`PostToolUse` → `scripts/hook-post-edit.mjs`.** Ao editar `lib/core/registry.mjs` ou
53
+ `package.json`, roda `test/forja-core.test.js` na hora. A quebra chega junto da edição que
54
+ a causou, não commits depois.
55
+ - **`SessionStart` resiliente e honesto.** Todo acesso a SQLite passa a ser lazy — o hook
56
+ degradava para stack trace sem `node_modules`. Além disso, passa a avisar quando `memory/`
57
+ mudou depois do último `sync:universal`: índice defasado é a versão local do problema (1).
58
+ - **`RETURNING id` no upsert de `memory_nodes`.** Devolve a linha realmente afetada, inserida ou
59
+ atualizada, eliminando a dependência de `lastInsertRowid`. O sync passa a purgar linhas órfãs
60
+ do `search_idx` ao final, e o `title` volta a ser atualizado no conflito.
61
+ - **Subagent `release-auditor`.** Audita o pacote instalando o tarball de verdade e exercitando
62
+ comandos reais. Proibido aprovar por leitura de código. Exige árvore git limpa antes e depois:
63
+ `npm publish` empacota o **disco**, não o commit, e sua aprovação é perecível. A v1.1.1 saiu
64
+ publicada com `otplib` e `qrcode` em `dependencies` — instalados na árvore de trabalho para
65
+ gerar o código OTP do 2FA, nunca commitados, nunca importados por linha alguma do projeto.
66
+ A auditoria havia passado minutos antes, sobre um disco que deixou de existir.
67
+ - **Skills `new-adr` e `new-command`.** Os dois rituais do repo viram etapas executáveis.
68
+
69
+ ## Alternativas consideradas
70
+
71
+ - **Path relativo (`-p .`) no `.mcp.json`** — rejeitada porque ainda depende do `cwd` do processo
72
+ do servidor, que não é contratual. Omitir a flag delega ao protocolo, que é.
73
+ - **`better-sqlite3` como `optionalDependency` com degradação** — rejeitada porque a memória
74
+ hierárquica com FTS5 é a proposta central do Forja, não um extra. Um `forjajs` sem memória
75
+ não é uma instalação degradada; é uma instalação errada.
76
+ - **Manter as regras no `CLAUDE.md` e confiar na leitura do agente** — rejeitada por evidência:
77
+ as regras já estavam escritas e ainda assim o índice ficou apontando para a árvore errada por
78
+ mais de uma semana.
79
+ - **Rodar a suíte inteira no `PostToolUse`** — rejeitada por custo. O gate é `forja-core.test.js`,
80
+ um arquivo, poucos segundos. Um hook lento é um hook que alguém desliga.
81
+ - **Reconstruir o `search_idx` do zero a cada sync** — rejeitada porque esconderia a causa. O
82
+ índice ficaria correto sem que o upsert deixasse de devolver o id errado, e o próximo consumidor
83
+ de `lastInsertRowid` reencontraria o mesmo bug.
84
+
85
+ ## Consequências
86
+
87
+ **Positivas**:
88
+ - O pacote publicado passa a funcionar numa instalação limpa — verificado via `npm pack` + install.
89
+ - `query:universal` volta a devolver o documento que casou com a busca. Medido: 709 pares
90
+ título↔conteúdo alinhados, 0 cruzados, 0 órfãos (antes: 3 cruzados, 135 órfãos).
91
+ - Violações de `projects/` e do registry tornam-se impossíveis, não improváveis.
92
+ - O índice de memória defasado passa a se anunciar em vez de responder errado calado.
93
+ - Contribuidores externos clonam e o codegraph indexa o repo certo, sem editar nada.
94
+
95
+ **Negativas / Trade-offs**:
96
+ - `npm i forjajs` agora compila/baixa um módulo nativo (`better-sqlite3`): instalação mais lenta
97
+ e sujeita a prebuilds por plataforma. É o preço de o produto funcionar.
98
+ - O hook `PostToolUse` acrescenta poucos segundos a cada edição de `registry.mjs` ou `package.json`.
99
+ - Guardrails têm escape hatch (`FORJA_GUARD=0`, `FORJA_HOOK_TEST=0`). Um guard sem escape vira
100
+ um guard contornado por caminhos piores.
101
+ - `.claude/skills/` entra em `files[]`, aumentando o tarball.
102
+
103
+ ## Rastreamento
104
+ - Implementação: `.mcp.json`, `package.json`, `.claude/settings.json`,
105
+ `scripts/sync-universal-memory.js`, `scripts/hook-guard-paths.mjs`, `scripts/hook-post-edit.mjs`,
106
+ `scripts/hook-session-start.mjs`, `.claude/agents/release-auditor.md`,
107
+ `.claude/skills/new-adr/`, `.claude/skills/new-command/`
108
+ - Testes: `test/hooks.test.js`, `test/memory-index.test.js`
109
+ - ADRs relacionadas: ADR-0009 (economia de tokens — a corrupção do FTS a invalidava na prática),
110
+ ADR-0017 (codegraph no harness), ADR-0018 (ferramentas de processo),
111
+ ADR-0019 (workspace separado), ADR-0020 (forja core CLI única)
@@ -1,101 +1,101 @@
1
- # ADR-0022: Congelar o dashboard web
2
-
3
- - **Status**: accepted
4
- - **Data**: 2026-07-09
5
- - **Autor(es)**: apk
6
- - **Tags**: dashboard, cli, release, security, sdd
7
-
8
- ## Contexto
9
-
10
- O dashboard web (`dashboard/`, SPEC-002) foi implementado por inteiro: 15 rotas Fastify,
11
- 12 telas React, 68 testes verdes, bundle de 190KB gzip. Entrou no repositório no commit
12
- `b732e08` ("Forja v1.1 — release público inicial", 2026-07-06) e **nunca recebeu uma única
13
- iteração** nos 12 commits seguintes. Não foi abandonado após uso — nasceu sem uso.
14
-
15
- Três problemas concretos motivaram a decisão:
16
-
17
- 1. **Bug de release já publicado.** O `files[]` do `package.json` nunca incluiu `dashboard/`,
18
- mas incluía `docs/dashboard.md`, e o `package.json` publicado trazia o script
19
- `"dashboard": "cd dashboard && npm start"`. O `README.md` documentava o comando. Resultado:
20
- quem instalou o `forja` v1.1.2 do npm recebeu a documentação e o comando, mas não o código.
21
- O comando quebra. O `release-auditor` não pegou porque valida o que os binários importam,
22
- não o que a documentação promete.
23
-
24
- 2. **Segunda fonte de verdade para comandos, já divergente.** O ADR-0020 estabeleceu que todo
25
- comando de processo passa pelo core (`bin/forja.mjs` + `lib/core/registry.mjs`), com gates
26
- transversais e auditoria em `.context/forja-runs.jsonl`. O dashboard mantém sua própria
27
- `COMMAND_ALLOWLIST` hard-coded (decisão D4 da SPEC-002, por razões legítimas de segurança).
28
- Na auditoria de 2026-07-09: o registry tem 41 comandos, a allowlist expõe 11, e
29
- **`context:build` existe na allowlist mas não no registry** — executa via
30
- `node scripts/dev.mjs context:build`, contornando os gates e a trilha de auditoria do core.
31
- Um comando disparado pelo botão do dashboard não aparece na auditoria.
32
-
33
- 3. **A documentação pública descrevia errado a superfície.** O `README.md` chamava o dashboard
34
- de "visão opcional read-only". Ele expõe `POST /api/workflow/:project/run/:role` (dispara
35
- execução de papéis), além de mutações em status de specs, notas de projeto e comandos.
36
- A auditoria de RCE prevista na T12 da SPEC-002 nunca foi executada, e teria coberto apenas
37
- `/api/commands` — as rotas `workflow` e `stacks` sequer existiam quando aquela task foi escrita.
38
-
39
- ## Decisão
40
-
41
- **Congelar o dashboard.** O código permanece em `dashboard/`, versionado e com os testes
42
- passando, mas deixa de ser superfície pública e de ser tratado como parte do produto:
43
-
44
- - `docs/dashboard.md` e `specs/agent-dashboard/` saem do `files[]` do pacote npm.
45
- - Os cinco scripts `dashboard*` saem do `package.json` do root (o `package.json` é publicado
46
- inteiro; não há como ter script "só local").
47
- - `README.md` e `DOC-MAP.md` deixam de prometer o dashboard ao usuário do npm.
48
- - SPEC-002 passa a `abandoned`. O status `parked` não existe no `spec-cli`
49
- (`draft|review|approved|implementing|done|abandoned`), e `abandoned` é o único que não mente.
50
-
51
- **Não unificar `registry` ↔ `allowlist` agora.** Era o caminho tecnicamente correto se o
52
- dashboard tivesse futuro. Sem consumidor, seria infraestrutura elegante sustentando código
53
- que ninguém roda. O `context:build` fantasma deixa de causar dano ao ser congelado junto.
54
-
55
- ## Alternativas consideradas
56
-
57
- - **Arquivar de vez** (mover para `docs/archive/`, fechar a spec como wontfix) — rejeitada
58
- porque descarta 69 arquivos funcionais e testados por uma decisão reversível. O custo de
59
- manter o código parado no repo é próximo de zero, uma vez removido das superfícies públicas.
60
- - **Reviver: derivar a allowlist do registry** (campo `exposedToDashboard` + schema de args,
61
- publicar `dashboard/` no `files[]`, auditar `workflow`/`stacks`) — rejeitada *por ora*
62
- porque o dashboard nunca teve um usuário. Construir a infraestrutura antes da demanda inverte
63
- a ordem. Continua sendo o caminho certo **se** a demanda aparecer; ver "Condições de retomada".
64
- - **Manter como está** — rejeitada porque deixa um comando quebrado publicado no npm e um
65
- bypass da auditoria do ADR-0020 em pé.
66
-
67
- ## Consequências
68
-
69
- **Positivas**:
70
- - O pacote npm para de prometer um comando que não funciona.
71
- - Some a segunda fonte de verdade para comandos; o `bin/forja.mjs` volta a ser a única.
72
- - O bypass de auditoria do `context:build` deixa de ser alcançável.
73
- - A documentação pública passa a descrever a realidade (CLI-first, sem front).
74
- - Zero manutenção contínua: o código congelado não drifta porque não é superfície.
75
-
76
- **Negativas / Trade-offs**:
77
- - 69 arquivos funcionais ficam parados no repositório. É dívida visível, mas inerte.
78
- - Quem clonar o repo vê uma pasta `dashboard/` sem entrada óbvia; mitigado por
79
- `dashboard/README.md` explicando o estado e como subir manualmente.
80
- - Se a demanda por uma interface visual voltar, parte do trabalho de reconciliação
81
- (rotas novas × allowlist × registry) terá crescido no intervalo.
82
-
83
- ## Condições de retomada
84
-
85
- Descongelar exige, nesta ordem:
86
-
87
- 1. Um usuário real e um caso de uso que o CLI não atenda. Sem isso, não retomar.
88
- 2. Derivar a allowlist do registry — comando novo entra em `lib/core/registry.mjs` com
89
- `exposedToDashboard: true` e schema de args declarado. Preserva a garantia do D4
90
- (nada dinâmico, nada de regex, tudo em código) e mata a classe de bugs de sincronização.
91
- 3. Auditoria de segurança das rotas mutáveis, com escopo explícito em `/api/commands`,
92
- `/api/workflow/:project/run/:role` e `/api/stacks` — não apenas a primeira, como previa a T12.
93
- 4. Incluir `dashboard/` no `files[]` **antes** de voltar a documentá-lo publicamente.
94
-
95
- ## Rastreamento
96
-
97
- - Implementação congelada: `dashboard/` (15 rotas, 12 telas, 68 testes)
98
- - Spec: `specs/agent-dashboard/` (status `abandoned`)
99
- - Docs: `docs/dashboard.md` (mantido no repo, fora do tarball)
100
- - ADRs relacionadas: ADR-0020 (core CLI única — cuja fronteira o dashboard violava),
101
- ADR-0021 (guardrails de harness)
1
+ # ADR-0022: Congelar o dashboard web
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-07-09
5
+ - **Autor(es)**: apk
6
+ - **Tags**: dashboard, cli, release, security, sdd
7
+
8
+ ## Contexto
9
+
10
+ O dashboard web (`dashboard/`, SPEC-002) foi implementado por inteiro: 15 rotas Fastify,
11
+ 12 telas React, 68 testes verdes, bundle de 190KB gzip. Entrou no repositório no commit
12
+ `b732e08` ("Forja v1.1 — release público inicial", 2026-07-06) e **nunca recebeu uma única
13
+ iteração** nos 12 commits seguintes. Não foi abandonado após uso — nasceu sem uso.
14
+
15
+ Três problemas concretos motivaram a decisão:
16
+
17
+ 1. **Bug de release já publicado.** O `files[]` do `package.json` nunca incluiu `dashboard/`,
18
+ mas incluía `docs/dashboard.md`, e o `package.json` publicado trazia o script
19
+ `"dashboard": "cd dashboard && npm start"`. O `README.md` documentava o comando. Resultado:
20
+ quem instalou o `forja` v1.1.2 do npm recebeu a documentação e o comando, mas não o código.
21
+ O comando quebra. O `release-auditor` não pegou porque valida o que os binários importam,
22
+ não o que a documentação promete.
23
+
24
+ 2. **Segunda fonte de verdade para comandos, já divergente.** O ADR-0020 estabeleceu que todo
25
+ comando de processo passa pelo core (`bin/forja.mjs` + `lib/core/registry.mjs`), com gates
26
+ transversais e auditoria em `.context/forja-runs.jsonl`. O dashboard mantém sua própria
27
+ `COMMAND_ALLOWLIST` hard-coded (decisão D4 da SPEC-002, por razões legítimas de segurança).
28
+ Na auditoria de 2026-07-09: o registry tem 41 comandos, a allowlist expõe 11, e
29
+ **`context:build` existe na allowlist mas não no registry** — executa via
30
+ `node scripts/dev.mjs context:build`, contornando os gates e a trilha de auditoria do core.
31
+ Um comando disparado pelo botão do dashboard não aparece na auditoria.
32
+
33
+ 3. **A documentação pública descrevia errado a superfície.** O `README.md` chamava o dashboard
34
+ de "visão opcional read-only". Ele expõe `POST /api/workflow/:project/run/:role` (dispara
35
+ execução de papéis), além de mutações em status de specs, notas de projeto e comandos.
36
+ A auditoria de RCE prevista na T12 da SPEC-002 nunca foi executada, e teria coberto apenas
37
+ `/api/commands` — as rotas `workflow` e `stacks` sequer existiam quando aquela task foi escrita.
38
+
39
+ ## Decisão
40
+
41
+ **Congelar o dashboard.** O código permanece em `dashboard/`, versionado e com os testes
42
+ passando, mas deixa de ser superfície pública e de ser tratado como parte do produto:
43
+
44
+ - `docs/dashboard.md` e `specs/agent-dashboard/` saem do `files[]` do pacote npm.
45
+ - Os cinco scripts `dashboard*` saem do `package.json` do root (o `package.json` é publicado
46
+ inteiro; não há como ter script "só local").
47
+ - `README.md` e `DOC-MAP.md` deixam de prometer o dashboard ao usuário do npm.
48
+ - SPEC-002 passa a `abandoned`. O status `parked` não existe no `spec-cli`
49
+ (`draft|review|approved|implementing|done|abandoned`), e `abandoned` é o único que não mente.
50
+
51
+ **Não unificar `registry` ↔ `allowlist` agora.** Era o caminho tecnicamente correto se o
52
+ dashboard tivesse futuro. Sem consumidor, seria infraestrutura elegante sustentando código
53
+ que ninguém roda. O `context:build` fantasma deixa de causar dano ao ser congelado junto.
54
+
55
+ ## Alternativas consideradas
56
+
57
+ - **Arquivar de vez** (mover para `docs/archive/`, fechar a spec como wontfix) — rejeitada
58
+ porque descarta 69 arquivos funcionais e testados por uma decisão reversível. O custo de
59
+ manter o código parado no repo é próximo de zero, uma vez removido das superfícies públicas.
60
+ - **Reviver: derivar a allowlist do registry** (campo `exposedToDashboard` + schema de args,
61
+ publicar `dashboard/` no `files[]`, auditar `workflow`/`stacks`) — rejeitada *por ora*
62
+ porque o dashboard nunca teve um usuário. Construir a infraestrutura antes da demanda inverte
63
+ a ordem. Continua sendo o caminho certo **se** a demanda aparecer; ver "Condições de retomada".
64
+ - **Manter como está** — rejeitada porque deixa um comando quebrado publicado no npm e um
65
+ bypass da auditoria do ADR-0020 em pé.
66
+
67
+ ## Consequências
68
+
69
+ **Positivas**:
70
+ - O pacote npm para de prometer um comando que não funciona.
71
+ - Some a segunda fonte de verdade para comandos; o `bin/forja.mjs` volta a ser a única.
72
+ - O bypass de auditoria do `context:build` deixa de ser alcançável.
73
+ - A documentação pública passa a descrever a realidade (CLI-first, sem front).
74
+ - Zero manutenção contínua: o código congelado não drifta porque não é superfície.
75
+
76
+ **Negativas / Trade-offs**:
77
+ - 69 arquivos funcionais ficam parados no repositório. É dívida visível, mas inerte.
78
+ - Quem clonar o repo vê uma pasta `dashboard/` sem entrada óbvia; mitigado por
79
+ `dashboard/README.md` explicando o estado e como subir manualmente.
80
+ - Se a demanda por uma interface visual voltar, parte do trabalho de reconciliação
81
+ (rotas novas × allowlist × registry) terá crescido no intervalo.
82
+
83
+ ## Condições de retomada
84
+
85
+ Descongelar exige, nesta ordem:
86
+
87
+ 1. Um usuário real e um caso de uso que o CLI não atenda. Sem isso, não retomar.
88
+ 2. Derivar a allowlist do registry — comando novo entra em `lib/core/registry.mjs` com
89
+ `exposedToDashboard: true` e schema de args declarado. Preserva a garantia do D4
90
+ (nada dinâmico, nada de regex, tudo em código) e mata a classe de bugs de sincronização.
91
+ 3. Auditoria de segurança das rotas mutáveis, com escopo explícito em `/api/commands`,
92
+ `/api/workflow/:project/run/:role` e `/api/stacks` — não apenas a primeira, como previa a T12.
93
+ 4. Incluir `dashboard/` no `files[]` **antes** de voltar a documentá-lo publicamente.
94
+
95
+ ## Rastreamento
96
+
97
+ - Implementação congelada: `dashboard/` (15 rotas, 12 telas, 68 testes)
98
+ - Spec: `specs/agent-dashboard/` (status `abandoned`)
99
+ - Docs: `docs/dashboard.md` (mantido no repo, fora do tarball)
100
+ - ADRs relacionadas: ADR-0020 (core CLI única — cuja fronteira o dashboard violava),
101
+ ADR-0021 (guardrails de harness)