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
@@ -7,186 +7,186 @@ import { writeFileSafe } from "../utils/file-helpers.js";
7
7
  * Factory para README dinâmico
8
8
  */
9
9
  function createReadmeContent(projectName) {
10
- return `# ${projectName}
11
-
12
- Scaffold gerado por **create-memory-nest-kit v0.5.0**
13
-
14
- ## 🎯 Estrutura
15
-
16
- Este projeto segue uma arquitetura modular com:
17
-
18
- - **memory/** — Hierarquia de documentação centralizada
19
- - 00-global/ — Missão, padrões, contexto
20
- - 10-product/ — Visão, personas, regras
21
- - 20-architecture/ — Design do sistema
22
- - 30-domains/ — Bounded contexts (auth, billing, etc)
23
- - 40-delivery/ — Roadmap e sprints
24
- - 50-orchestration/ — Topologia de agentes, handoffs
25
- - 60-runs/ — Log de execução
26
- - 70-summaries/ — Resumos compactados
27
- - 80-data/ — Schema e queries
28
- - 90-decisions/ — ADRs
29
-
30
- - **agents/** — Definição de agentes especializados
31
- - **skills/** — Capacidades reutilizáveis
32
- - **prompts/** — Instruções por contexto
33
- - **backend/** — API NestJS (se gerado)
34
-
35
- ## 🚀 Quick Start
36
-
37
- ### 1. Explorar a Memória
38
-
39
- \`\`\`bash
40
- # Ler a missão do projeto
41
- cat memory/00-global/mission.md
42
-
43
- # Ler padrões globais
44
- cat memory/00-global/standards.md
45
-
46
- # Ler arquitetura
47
- cat memory/20-architecture/system-overview.md
48
- \`\`\`
49
-
50
- ### 2. Construir Contexto
51
-
52
- \`\`\`bash
53
- # Gerar um context pack com os arquivos prioritários
54
- node scripts/build-context-pack.mjs
55
-
56
- # Arquivo gerado em .context/context-pack.md
57
- \`\`\`
58
-
59
- ### 3. Executar Backend (opcional)
60
-
61
- \`\`\`bash
62
- cd backend
63
-
64
- # Instalar dependências
65
- npm install
66
-
67
- # Rodar em desenvolvimento
68
- npm run start:dev
69
-
70
- # Executar testes
71
- npm test
72
-
73
- # Verificar saúde da API
74
- curl http://localhost:3000/api/health
75
- \`\`\`
76
-
77
- ## 📝 Fluxo de Trabalho Multiagente
78
-
79
- ### Orquestrador
80
- - Recebe tarefa
81
- - Decompõe em subtarefas independentes
82
- - Atribui ownership por arquivo
83
-
84
- ### Workers
85
- - Executam subtarefas isoladas
86
- - Entregam: alterações, testes, riscos
87
- - Registram handoff em memory/50-orchestration/handoffs/
88
-
89
- ### Reviewer
90
- - Valida qualidade, segurança, cobertura
91
- - Aprova ou rejeita
92
-
93
- ### Consolidação
94
- - Integrar handoffs
95
- - Atualizar resumos em memory/70-summaries/
96
-
97
- ## 🔄 Protocolo de Handoff
98
-
99
- Cada handoff deve incluir:
100
-
101
- - **Contexto**: O que foi feito e por quê?
102
- - **Alterações**: Lista de arquivos modificados
103
- - **Riscos**: Potenciais problemas ou edge cases
104
- - **Pendências**: O que não foi concluído
105
- - **Próximo Passo**: Quem assume e o quê fazer
106
-
107
- Exemplo:
108
- \`\`\`bash
109
- node ../scripts/append-handoff.mjs agente-a agente-b "Título da entrega"
110
- \`\`\`
111
-
112
- ## 🗄️ Banco de Dados (SQLite)
113
-
114
- A estrutura de memória é indexada em SQLite para busca rápida:
115
-
116
- \`\`\`bash
117
- # Inicializar banco
118
- cd backend && npm run memory:db:init
119
-
120
- # Sincronizar com markdown
121
- npm run memory:db:sync
122
-
123
- # Consultar por termo
124
- npm run memory:db:query -- "auth"
125
- \`\`\`
126
-
127
- ## 📊 Dashboard Operacional
128
-
129
- Após iniciar o backend:
130
-
131
- \`\`\`bash
132
- # Abrir em navegador
133
- open http://localhost:3000/ops
134
- \`\`\`
135
-
136
- Mostra:
137
- - Status dos agentes
138
- - Progresso de tarefas
139
- - Últimos handoffs
140
-
141
- ## 🛠️ Scripts Utilitários
142
-
143
- | Script | O que faz |
144
- |--------|-----------|
145
- | \`build-context-pack.mjs\` | Monta pack de contexto prioritário |
146
- | \`append-handoff.mjs\` | Cria novo arquivo de handoff |
147
- | \`memory-vacuum.mjs\` | Arquiva logs > 30 dias |
148
- | \`memory-watcher.mjs\` | Auto-sync de markdown → SQLite |
149
- | \`check-memory-maps.mjs\` | Gate: os mapas (context.md) não citam código morto. Rode no CI |
150
-
151
- ## 📚 Documentação Importante
152
-
153
- - **memory/00-global/context-policy.md** — Política de janelas de contexto
154
- - **memory/00-global/agent-contract.md** — Contrato entre agentes
155
- - **memory/50-orchestration/handoff-protocol.md** — Protocolo formal de handoff
156
- - **prompts/project-prompt-base.md** — Instruções base para agentes
157
- - **AGENTS.md** — Definição de papéis e responsabilidades
158
-
159
- ## 🎯 Próximos Passos
160
-
161
- 1. ✅ Preencher memory/10-product/vision.md
162
- 2. ✅ Preencher memory/20-architecture/* com detalhes do seu sistema
163
- 3. ✅ Criar ADRs em memory/90-decisions/
164
- 4. ✅ Adicionar domínios em memory/30-domains/
165
- 5. ✅ Kickoff do primeiro sprint
166
- 6. ✅ Registrar primeiros handoffs
167
-
168
- ## 🤝 Contribuindo
169
-
170
- ### Padrões
171
- - Documentação em **pt-BR**
172
- - Decisões explícitas em ADR
173
- - Toda mudança registra impacto e rollback
174
-
175
- ### Validação
176
- \`\`\`bash
177
- # Verificar integridade de estrutura
178
- npm run project:check
179
-
180
- # Gerar dashboard de progresso
181
- npm run project:dashboard
182
- \`\`\`
183
-
184
- ---
185
-
186
- **Gerado em**: ${new Date().toISOString()}
187
-
188
- **Versão**: v0.5.0
189
-
10
+ return `# ${projectName}
11
+
12
+ Scaffold gerado por **create-memory-nest-kit v0.5.0**
13
+
14
+ ## 🎯 Estrutura
15
+
16
+ Este projeto segue uma arquitetura modular com:
17
+
18
+ - **memory/** — Hierarquia de documentação centralizada
19
+ - 00-global/ — Missão, padrões, contexto
20
+ - 10-product/ — Visão, personas, regras
21
+ - 20-architecture/ — Design do sistema
22
+ - 30-domains/ — Bounded contexts (auth, billing, etc)
23
+ - 40-delivery/ — Roadmap e sprints
24
+ - 50-orchestration/ — Topologia de agentes, handoffs
25
+ - 60-runs/ — Log de execução
26
+ - 70-summaries/ — Resumos compactados
27
+ - 80-data/ — Schema e queries
28
+ - 90-decisions/ — ADRs
29
+
30
+ - **agents/** — Definição de agentes especializados
31
+ - **skills/** — Capacidades reutilizáveis
32
+ - **prompts/** — Instruções por contexto
33
+ - **backend/** — API NestJS (se gerado)
34
+
35
+ ## 🚀 Quick Start
36
+
37
+ ### 1. Explorar a Memória
38
+
39
+ \`\`\`bash
40
+ # Ler a missão do projeto
41
+ cat memory/00-global/mission.md
42
+
43
+ # Ler padrões globais
44
+ cat memory/00-global/standards.md
45
+
46
+ # Ler arquitetura
47
+ cat memory/20-architecture/system-overview.md
48
+ \`\`\`
49
+
50
+ ### 2. Construir Contexto
51
+
52
+ \`\`\`bash
53
+ # Gerar um context pack com os arquivos prioritários
54
+ node scripts/build-context-pack.mjs
55
+
56
+ # Arquivo gerado em .context/context-pack.md
57
+ \`\`\`
58
+
59
+ ### 3. Executar Backend (opcional)
60
+
61
+ \`\`\`bash
62
+ cd backend
63
+
64
+ # Instalar dependências
65
+ npm install
66
+
67
+ # Rodar em desenvolvimento
68
+ npm run start:dev
69
+
70
+ # Executar testes
71
+ npm test
72
+
73
+ # Verificar saúde da API
74
+ curl http://localhost:3000/api/health
75
+ \`\`\`
76
+
77
+ ## 📝 Fluxo de Trabalho Multiagente
78
+
79
+ ### Orquestrador
80
+ - Recebe tarefa
81
+ - Decompõe em subtarefas independentes
82
+ - Atribui ownership por arquivo
83
+
84
+ ### Workers
85
+ - Executam subtarefas isoladas
86
+ - Entregam: alterações, testes, riscos
87
+ - Registram handoff em memory/50-orchestration/handoffs/
88
+
89
+ ### Reviewer
90
+ - Valida qualidade, segurança, cobertura
91
+ - Aprova ou rejeita
92
+
93
+ ### Consolidação
94
+ - Integrar handoffs
95
+ - Atualizar resumos em memory/70-summaries/
96
+
97
+ ## 🔄 Protocolo de Handoff
98
+
99
+ Cada handoff deve incluir:
100
+
101
+ - **Contexto**: O que foi feito e por quê?
102
+ - **Alterações**: Lista de arquivos modificados
103
+ - **Riscos**: Potenciais problemas ou edge cases
104
+ - **Pendências**: O que não foi concluído
105
+ - **Próximo Passo**: Quem assume e o quê fazer
106
+
107
+ Exemplo:
108
+ \`\`\`bash
109
+ node ../scripts/append-handoff.mjs agente-a agente-b "Título da entrega"
110
+ \`\`\`
111
+
112
+ ## 🗄️ Banco de Dados (SQLite)
113
+
114
+ A estrutura de memória é indexada em SQLite para busca rápida:
115
+
116
+ \`\`\`bash
117
+ # Inicializar banco
118
+ cd backend && npm run memory:db:init
119
+
120
+ # Sincronizar com markdown
121
+ npm run memory:db:sync
122
+
123
+ # Consultar por termo
124
+ npm run memory:db:query -- "auth"
125
+ \`\`\`
126
+
127
+ ## 📊 Dashboard Operacional
128
+
129
+ Após iniciar o backend:
130
+
131
+ \`\`\`bash
132
+ # Abrir em navegador
133
+ open http://localhost:3000/ops
134
+ \`\`\`
135
+
136
+ Mostra:
137
+ - Status dos agentes
138
+ - Progresso de tarefas
139
+ - Últimos handoffs
140
+
141
+ ## 🛠️ Scripts Utilitários
142
+
143
+ | Script | O que faz |
144
+ |--------|-----------|
145
+ | \`build-context-pack.mjs\` | Monta pack de contexto prioritário |
146
+ | \`append-handoff.mjs\` | Cria novo arquivo de handoff |
147
+ | \`memory-vacuum.mjs\` | Arquiva logs > 30 dias |
148
+ | \`memory-watcher.mjs\` | Auto-sync de markdown → SQLite |
149
+ | \`check-memory-maps.mjs\` | Gate: os mapas (context.md) não citam código morto. Rode no CI |
150
+
151
+ ## 📚 Documentação Importante
152
+
153
+ - **memory/00-global/context-policy.md** — Política de janelas de contexto
154
+ - **memory/00-global/agent-contract.md** — Contrato entre agentes
155
+ - **memory/50-orchestration/handoff-protocol.md** — Protocolo formal de handoff
156
+ - **prompts/project-prompt-base.md** — Instruções base para agentes
157
+ - **AGENTS.md** — Definição de papéis e responsabilidades
158
+
159
+ ## 🎯 Próximos Passos
160
+
161
+ 1. ✅ Preencher memory/10-product/vision.md
162
+ 2. ✅ Preencher memory/20-architecture/* com detalhes do seu sistema
163
+ 3. ✅ Criar ADRs em memory/90-decisions/
164
+ 4. ✅ Adicionar domínios em memory/30-domains/
165
+ 5. ✅ Kickoff do primeiro sprint
166
+ 6. ✅ Registrar primeiros handoffs
167
+
168
+ ## 🤝 Contribuindo
169
+
170
+ ### Padrões
171
+ - Documentação em **pt-BR**
172
+ - Decisões explícitas em ADR
173
+ - Toda mudança registra impacto e rollback
174
+
175
+ ### Validação
176
+ \`\`\`bash
177
+ # Verificar integridade de estrutura
178
+ npm run project:check
179
+
180
+ # Gerar dashboard de progresso
181
+ npm run project:dashboard
182
+ \`\`\`
183
+
184
+ ---
185
+
186
+ **Gerado em**: ${new Date().toISOString()}
187
+
188
+ **Versão**: v0.5.0
189
+
190
190
  `;
191
191
  }
192
192
  /**
@@ -125,46 +125,46 @@ export function renderHtml(d) {
125
125
  const specRows = d.specs.map((s) => `<tr><td class="slug">${esc(s.slug)}</td>${stageCell(s.spec)}${stageCell(s.plan)}${stageCell(s.tasks)}</tr>`).join('');
126
126
  const audit = d.audit;
127
127
  const auditBlock = audit && audit.total
128
- ? `<div class="ametrics"><div><b>${audit.total}</b><span>runs auditados</span></div><div><b>${audit.fails}</b><span>reprovações</span></div></div>
129
- <table class="board"><thead><tr><th>comando</th><th>runs</th><th>falhas</th><th>média</th></tr></thead><tbody>
130
- ${audit.byCmd.slice(0, 8).map((c) => `<tr><td class="slug">${esc(c.cmd)}</td><td class="num">${c.runs}</td><td class="num ${c.fails ? 'bad' : ''}">${c.fails}</td><td class="num">${c.avgMs ?? '—'}ms</td></tr>`).join('')}
128
+ ? `<div class="ametrics"><div><b>${audit.total}</b><span>runs auditados</span></div><div><b>${audit.fails}</b><span>reprovações</span></div></div>
129
+ <table class="board"><thead><tr><th>comando</th><th>runs</th><th>falhas</th><th>média</th></tr></thead><tbody>
130
+ ${audit.byCmd.slice(0, 8).map((c) => `<tr><td class="slug">${esc(c.cmd)}</td><td class="num">${c.runs}</td><td class="num ${c.fails ? 'bad' : ''}">${c.fails}</td><td class="num">${c.avgMs ?? '—'}ms</td></tr>`).join('')}
131
131
  </tbody></table>`
132
132
  : `<p class="empty">Sem atividade registrada ainda. A trilha nasce em <code>.context/forja-runs.jsonl</code> conforme você usa o <code>forja</code>. Rode <code>forja audit:sync</code>.</p>`;
133
- return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Forja · Governança</title><style>
134
- :root{--bg:#eceef1;--panel:#fff;--panel2:#f5f6f9;--line:#dcdfe6;--ink:#191d24;--dim:#59626f;--faint:#8b93a0;--ember:#cf5a12;--good:#2b8a3e;--goodbg:#e5f3e8;--warn:#9a6a10;--warnbg:#f6ecd6;--crit:#c22f2f;--critbg:#f6dede;--mono:ui-monospace,"SF Mono",Menlo,monospace;--sans:system-ui,-apple-system,sans-serif}
135
- @media(prefers-color-scheme:dark){:root{--bg:#101318;--panel:#181c22;--panel2:#1e232b;--line:#2a303a;--ink:#e6e9ee;--dim:#98a1ad;--faint:#69727e;--ember:#ff7a3c;--good:#46b45a;--goodbg:#16301c;--warn:#d1a02a;--warnbg:#302713;--crit:#f0564a;--critbg:#331917}}
136
- *{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.5}
137
- .wrap{max-width:1000px;margin:0 auto;padding:30px 20px 60px}
138
- header{display:flex;align-items:baseline;gap:14px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:18px}
139
- .mark{font-family:var(--mono);font-weight:600;font-size:23px}.mark b{color:var(--ember)}
140
- .sub{color:var(--dim);font-size:13px}.gen{margin-left:auto;color:var(--faint);font-family:var(--mono);font-size:11.5px}
141
- .metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:1px;background:var(--line);border:1px solid var(--line);border-radius:12px;overflow:hidden;margin:22px 0 34px}
142
- .metrics div{background:var(--panel);padding:14px 16px}.metrics b{font-family:var(--mono);font-size:25px;font-weight:600}.metrics span{display:block;color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.05em;margin-top:2px}
143
- h2{font-size:19px;margin:34px 0 4px;letter-spacing:-.2px}.eye{font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.12em;color:var(--ember)}
144
- .lede{color:var(--dim);font-size:13.5px;margin:0 0 18px}
145
- .gates{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
146
- .gate{background:var(--panel);border:1px solid var(--line);border-radius:13px;overflow:hidden}
147
- .gh{display:flex;align-items:center;gap:8px;padding:13px 15px 10px;border-bottom:1px solid var(--line)}
148
- .gn{font-family:var(--mono);font-weight:600;font-size:14px}.gs{margin-left:auto;font-family:var(--mono);font-size:10px;font-weight:700;letter-spacing:.05em}
149
- .gate.pass .gs{color:var(--good)}.gate.fail .gs{color:var(--crit)}.gate.unknown .gs{color:var(--faint)}
150
- .gc{font-family:var(--mono);font-size:11px;color:var(--faint);padding:8px 15px 2px}
151
- .gate ul{list-style:none;margin:0;padding:6px 8px 10px}.gate li{display:flex;align-items:center;gap:8px;padding:5px 7px;font-size:12.5px}
152
- .cid{font-family:var(--mono);font-size:12px}.sev{margin-left:auto;font-family:var(--mono);font-size:9px;font-weight:700;padding:2px 6px;border-radius:5px;text-transform:uppercase}
153
- .sev.critical{color:var(--crit);background:var(--critbg)}.sev.warn{color:var(--warn);background:var(--warnbg)}
154
- .board{width:100%;border-collapse:collapse;background:var(--panel);border:1px solid var(--line);border-radius:12px;overflow:hidden}
155
- .board th,.board td{text-align:left;padding:10px 15px;border-bottom:1px solid var(--line);font-size:13px}
156
- .board thead th{font-family:var(--mono);font-size:10.5px;text-transform:uppercase;letter-spacing:.07em;color:var(--faint);background:var(--panel2)}
157
- .board tbody tr:last-child td{border-bottom:none}.slug{font-family:var(--mono);font-size:12.5px}.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums}.num.bad{color:var(--crit)}
158
- .st{font-family:var(--mono);font-size:11px;font-weight:600}.st.done{color:var(--good)}.st.approved{color:#2f6f9e}.st.abandoned{color:var(--faint);text-decoration:line-through}.st.na{color:var(--faint)}
159
- .ametrics{display:flex;gap:24px;margin-bottom:14px}.ametrics b{font-family:var(--mono);font-size:22px}.ametrics span{color:var(--dim);font-size:12px;margin-left:6px}
160
- .empty{color:var(--dim);font-size:13.5px;background:var(--panel);border:1px dashed var(--line);border-radius:12px;padding:18px}code{font-family:var(--mono);font-size:.9em}
161
- footer{margin-top:40px;padding-top:18px;border-top:1px solid var(--line);color:var(--faint);font-size:12px;display:flex;flex-wrap:wrap;gap:6px 16px}
162
- </style></head><body><div class="wrap">
163
- <header><span class="mark">for<b>j</b>a</span><span class="sub">painel de governança</span><span class="gen">gerado ${esc(d.generatedAt.slice(0, 16).replace('T', ' '))}</span></header>
164
- <div class="metrics"><div><b>${d.metrics.commands}</b><span>comandos</span></div><div><b>${d.metrics.specs}</b><span>specs</span></div><div><b>${d.metrics.adrs}</b><span>ADRs</span></div></div>
165
- <div class="eye">o motor</div><h2>Gates de invariante</h2><p class="lede">Estado do último run de cada gate na auditoria — sem reexecutar.</p><div class="gates">${gateCards}</div>
166
- <div class="eye">o processo</div><h2>Pipeline SDD</h2><p class="lede">O estado real das features, do <code>spec:check</code>.</p><table class="board"><thead><tr><th>feature</th><th>spec</th><th>plan</th><th>tasks</th></tr></thead><tbody>${specRows}</tbody></table>
167
- <div class="eye">a atividade</div><h2>Auditoria</h2><p class="lede">A trilha <code>.context/forja-runs.jsonl</code>, consultável.</p>${auditBlock}
168
- <footer><span>Artefato <b>gerado</b>, não servido — leitura, nunca execução (ADR-0022).</span><span style="margin-left:auto" class="slug">forja governance:dashboard</span></footer>
133
+ return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Forja · Governança</title><style>
134
+ :root{--bg:#eceef1;--panel:#fff;--panel2:#f5f6f9;--line:#dcdfe6;--ink:#191d24;--dim:#59626f;--faint:#8b93a0;--ember:#cf5a12;--good:#2b8a3e;--goodbg:#e5f3e8;--warn:#9a6a10;--warnbg:#f6ecd6;--crit:#c22f2f;--critbg:#f6dede;--mono:ui-monospace,"SF Mono",Menlo,monospace;--sans:system-ui,-apple-system,sans-serif}
135
+ @media(prefers-color-scheme:dark){:root{--bg:#101318;--panel:#181c22;--panel2:#1e232b;--line:#2a303a;--ink:#e6e9ee;--dim:#98a1ad;--faint:#69727e;--ember:#ff7a3c;--good:#46b45a;--goodbg:#16301c;--warn:#d1a02a;--warnbg:#302713;--crit:#f0564a;--critbg:#331917}}
136
+ *{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.5}
137
+ .wrap{max-width:1000px;margin:0 auto;padding:30px 20px 60px}
138
+ header{display:flex;align-items:baseline;gap:14px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:18px}
139
+ .mark{font-family:var(--mono);font-weight:600;font-size:23px}.mark b{color:var(--ember)}
140
+ .sub{color:var(--dim);font-size:13px}.gen{margin-left:auto;color:var(--faint);font-family:var(--mono);font-size:11.5px}
141
+ .metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:1px;background:var(--line);border:1px solid var(--line);border-radius:12px;overflow:hidden;margin:22px 0 34px}
142
+ .metrics div{background:var(--panel);padding:14px 16px}.metrics b{font-family:var(--mono);font-size:25px;font-weight:600}.metrics span{display:block;color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.05em;margin-top:2px}
143
+ h2{font-size:19px;margin:34px 0 4px;letter-spacing:-.2px}.eye{font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.12em;color:var(--ember)}
144
+ .lede{color:var(--dim);font-size:13.5px;margin:0 0 18px}
145
+ .gates{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
146
+ .gate{background:var(--panel);border:1px solid var(--line);border-radius:13px;overflow:hidden}
147
+ .gh{display:flex;align-items:center;gap:8px;padding:13px 15px 10px;border-bottom:1px solid var(--line)}
148
+ .gn{font-family:var(--mono);font-weight:600;font-size:14px}.gs{margin-left:auto;font-family:var(--mono);font-size:10px;font-weight:700;letter-spacing:.05em}
149
+ .gate.pass .gs{color:var(--good)}.gate.fail .gs{color:var(--crit)}.gate.unknown .gs{color:var(--faint)}
150
+ .gc{font-family:var(--mono);font-size:11px;color:var(--faint);padding:8px 15px 2px}
151
+ .gate ul{list-style:none;margin:0;padding:6px 8px 10px}.gate li{display:flex;align-items:center;gap:8px;padding:5px 7px;font-size:12.5px}
152
+ .cid{font-family:var(--mono);font-size:12px}.sev{margin-left:auto;font-family:var(--mono);font-size:9px;font-weight:700;padding:2px 6px;border-radius:5px;text-transform:uppercase}
153
+ .sev.critical{color:var(--crit);background:var(--critbg)}.sev.warn{color:var(--warn);background:var(--warnbg)}
154
+ .board{width:100%;border-collapse:collapse;background:var(--panel);border:1px solid var(--line);border-radius:12px;overflow:hidden}
155
+ .board th,.board td{text-align:left;padding:10px 15px;border-bottom:1px solid var(--line);font-size:13px}
156
+ .board thead th{font-family:var(--mono);font-size:10.5px;text-transform:uppercase;letter-spacing:.07em;color:var(--faint);background:var(--panel2)}
157
+ .board tbody tr:last-child td{border-bottom:none}.slug{font-family:var(--mono);font-size:12.5px}.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums}.num.bad{color:var(--crit)}
158
+ .st{font-family:var(--mono);font-size:11px;font-weight:600}.st.done{color:var(--good)}.st.approved{color:#2f6f9e}.st.abandoned{color:var(--faint);text-decoration:line-through}.st.na{color:var(--faint)}
159
+ .ametrics{display:flex;gap:24px;margin-bottom:14px}.ametrics b{font-family:var(--mono);font-size:22px}.ametrics span{color:var(--dim);font-size:12px;margin-left:6px}
160
+ .empty{color:var(--dim);font-size:13.5px;background:var(--panel);border:1px dashed var(--line);border-radius:12px;padding:18px}code{font-family:var(--mono);font-size:.9em}
161
+ footer{margin-top:40px;padding-top:18px;border-top:1px solid var(--line);color:var(--faint);font-size:12px;display:flex;flex-wrap:wrap;gap:6px 16px}
162
+ </style></head><body><div class="wrap">
163
+ <header><span class="mark">for<b>j</b>a</span><span class="sub">painel de governança</span><span class="gen">gerado ${esc(d.generatedAt.slice(0, 16).replace('T', ' '))}</span></header>
164
+ <div class="metrics"><div><b>${d.metrics.commands}</b><span>comandos</span></div><div><b>${d.metrics.specs}</b><span>specs</span></div><div><b>${d.metrics.adrs}</b><span>ADRs</span></div></div>
165
+ <div class="eye">o motor</div><h2>Gates de invariante</h2><p class="lede">Estado do último run de cada gate na auditoria — sem reexecutar.</p><div class="gates">${gateCards}</div>
166
+ <div class="eye">o processo</div><h2>Pipeline SDD</h2><p class="lede">O estado real das features, do <code>spec:check</code>.</p><table class="board"><thead><tr><th>feature</th><th>spec</th><th>plan</th><th>tasks</th></tr></thead><tbody>${specRows}</tbody></table>
167
+ <div class="eye">a atividade</div><h2>Auditoria</h2><p class="lede">A trilha <code>.context/forja-runs.jsonl</code>, consultável.</p>${auditBlock}
168
+ <footer><span>Artefato <b>gerado</b>, não servido — leitura, nunca execução (ADR-0022).</span><span style="margin-left:auto" class="slug">forja governance:dashboard</span></footer>
169
169
  </div></body></html>`;
170
170
  }
@@ -148,32 +148,32 @@ export function initWorkspace() {
148
148
  // Cria README de convenção no workspace
149
149
  const readmePath = path.join(root, 'README.md');
150
150
  if (!fs.existsSync(readmePath)) {
151
- fs.writeFileSync(readmePath, `# Forja Workspace
152
-
153
- Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
154
-
155
- ## Estrutura
156
-
157
- - \`projects/\` — projetos gerados pelo Forja.
158
- - \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
159
- - \`memory/30-projects/\` — fichas dos projetos.
160
- - \`specs/\` — specs de produto.
161
- - \`.context/\` — runbooks GSD de produto.
162
-
163
- ## Configuração
164
-
165
- O caminho do workspace é resolvido por prioridade:
166
-
167
- 1. Variável \`FORJA_WORKSPACE\`
168
- 2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
169
- 3. Padrão: \`~/forja-workspace\`
170
-
171
- ## Comandos úteis
172
-
173
- - \`npm run dev -- workspace:init\` — recria estrutura base.
174
- - \`npm run dev -- project:new <nome>\` — cria novo projeto.
175
- - \`npm run dev -- project:list\` — lista projetos.
176
- - \`npm run dev -- project:check <nome>\` — valida padrões.
151
+ fs.writeFileSync(readmePath, `# Forja Workspace
152
+
153
+ Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
154
+
155
+ ## Estrutura
156
+
157
+ - \`projects/\` — projetos gerados pelo Forja.
158
+ - \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
159
+ - \`memory/30-projects/\` — fichas dos projetos.
160
+ - \`specs/\` — specs de produto.
161
+ - \`.context/\` — runbooks GSD de produto.
162
+
163
+ ## Configuração
164
+
165
+ O caminho do workspace é resolvido por prioridade:
166
+
167
+ 1. Variável \`FORJA_WORKSPACE\`
168
+ 2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
169
+ 3. Padrão: \`~/forja-workspace\`
170
+
171
+ ## Comandos úteis
172
+
173
+ - \`npm run dev -- workspace:init\` — recria estrutura base.
174
+ - \`npm run dev -- project:new <nome>\` — cria novo projeto.
175
+ - \`npm run dev -- project:list\` — lista projetos.
176
+ - \`npm run dev -- project:check <nome>\` — valida padrões.
177
177
  `, 'utf8');
178
178
  }
179
179
  // Cria .forjarc.json local apenas se não houver config global
@@ -184,9 +184,9 @@ O caminho do workspace é resolvido por prioridade:
184
184
  // Cria README em 30-projects
185
185
  const projectsMemoryReadme = path.join(getWorkspaceProjectsMemoryDir(), 'README.md');
186
186
  if (!fs.existsSync(projectsMemoryReadme)) {
187
- fs.writeFileSync(projectsMemoryReadme, `# Projetos do Workspace
188
-
189
- Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
187
+ fs.writeFileSync(projectsMemoryReadme, `# Projetos do Workspace
188
+
189
+ Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
190
190
  `, 'utf8');
191
191
  }
192
192
  return root;
@@ -1,5 +1,5 @@
1
1
  import type { DeterministicDocument, GraphDocumentSource } from '../../graph/src/index.ts';
2
- import type { ISO8601 } from '../../contracts/src/index.ts';
2
+ import { type ISO8601 } from '../../contracts/src/index.ts';
3
3
  import type { SandboxBackend, SandboxCommandResult, SandboxDiffData, SandboxValidation } from '../../sandbox/src/index.ts';
4
4
  import type { SandboxCommand, SandboxSession } from '../../contracts/src/index.ts';
5
5
  export interface CommandRunner {
@@ -2,6 +2,7 @@ import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { spawnSync } from 'node:child_process';
4
4
  import { graphDocumentId } from "../../graph/src/index.js";
5
+ import { isPathWithinRoot } from "../../contracts/src/index.js";
5
6
  export class SpawnCommandRunner {
6
7
  run(command) {
7
8
  const started = Date.now();
@@ -27,7 +28,7 @@ export class GitGraphDocumentSource {
27
28
  if (!isIndexable(relative))
28
29
  continue;
29
30
  const absolute = path.join(this.root, relative);
30
- if (!isWithinRoot(this.root, absolute))
31
+ if (!isPathWithinRoot(this.root, absolute))
31
32
  continue;
32
33
  try {
33
34
  const content = fs.readFileSync(absolute, 'utf8');
@@ -45,13 +46,17 @@ function isIndexable(relative) {
45
46
  return false;
46
47
  return /\.(?:ts|tsx|js|jsx|mjs|cjs|json|md|yaml|yml)$/.test(relative);
47
48
  }
48
- function isWithinRoot(root, candidate) {
49
- const relative = path.relative(root, candidate);
50
- return relative.length === 0 || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
51
- }
49
+ /**
50
+ * `HOME`/`USERPROFILE` (SPEC-038 achado real): sem eles, `npm` não consegue resolver seu diretório
51
+ * de config/cache e trava indefinidamente em vez de falhar rápido — reproduzido rodando
52
+ * `forja simulate` com `--command "npm test"` contra este próprio repositório. Nenhum dos dois é
53
+ * segredo (são só um path de diretório), então passá-los adiante não viola o teste
54
+ * "runner não herda secrets do ambiente por padrão" (`test/adapter-git.test.js`) — esse teste
55
+ * cobre uma env var arbitrária do processo host, não este allowlist fixo.
56
+ */
52
57
  function sandboxEnvironment(overrides) {
53
58
  const inherited = {};
54
- for (const key of ['PATH', 'NODE_PATH', 'SystemRoot', 'TMPDIR', 'TMP', 'TEMP']) {
59
+ for (const key of ['PATH', 'NODE_PATH', 'SystemRoot', 'TMPDIR', 'TMP', 'TEMP', 'HOME', 'USERPROFILE']) {
55
60
  const value = process.env[key];
56
61
  if (value !== undefined)
57
62
  inherited[key] = value;
@@ -7,7 +7,17 @@ export interface HttpRequest {
7
7
  readonly body?: unknown;
8
8
  readonly headers: Readonly<Record<string, string | undefined>>;
9
9
  readonly correlationId?: string;
10
+ /** `req.socket.remoteAddress` (or equivalent) of the caller, when known. Used to fail closed to
11
+ * loopback-only access when no authenticator is configured — see `isLoopbackAddress`. */
12
+ readonly remoteAddress?: string;
10
13
  }
14
+ /**
15
+ * True for 127.0.0.0/8 and ::1 (with the common ::ffff:-mapped IPv4 form normalized first).
16
+ * `address === undefined` returns false — "unknown" is not "trusted" — but callers that only have
17
+ * a real remote address for genuine network connections (never for direct in-process calls) may
18
+ * choose to treat a missing address as trusted at the call site; this helper stays strict.
19
+ */
20
+ export declare function isLoopbackAddress(address: string | undefined): boolean;
11
21
  export interface HttpResponse {
12
22
  readonly status: number;
13
23
  readonly headers: Readonly<Record<string, string>>;
@@ -50,6 +60,15 @@ export declare class ForjaNestAdapter {
50
60
  private readonly controlPlane?;
51
61
  constructor(mcp: McpServer, stream?: EventStream, authenticator?: LocalAuthenticator, controlPlane?: ControlPlanePort);
52
62
  handle(request: HttpRequest): Promise<HttpResponse>;
63
+ /**
64
+ * Fails closed when no authenticator is configured: previously this meant "allow everyone", which
65
+ * left any request that reached the process (e.g. a container-network or port-forward hop) fully
66
+ * unauthenticated. Now it means "loopback callers only". `remoteAddress` being unset (rather than
67
+ * a real non-loopback address) is treated as an internal/direct call — e.g. dispatched in-process,
68
+ * not received over an actual socket — and stays trusted; a genuine HTTP layer always supplies it
69
+ * (see ForjaLocalAuthGuard, which reads it straight off the raw socket).
70
+ */
71
+ private isAuthenticated;
53
72
  subscribeSse(listener: (event: SseEvent) => void): () => void;
54
73
  modules(): readonly NestModuleDefinition[];
55
74
  openApi(): OpenApiDocument;