forjajs 2.0.4 β†’ 4.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 (825) hide show
  1. package/.claude/agents/context-engineer.md +19 -25
  2. package/.claude/agents/governance.md +19 -55
  3. package/.claude/agents/marketing.md +19 -24
  4. package/.claude/agents/orchestrator.md +19 -31
  5. package/.claude/agents/product.md +19 -26
  6. package/.claude/agents/release-auditor.md +50 -50
  7. package/.claude/agents/sdd-architect.md +19 -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 +93 -87
  12. package/.github/copilot-instructions.md +93 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +93 -87
  15. package/AGENTS.md +137 -134
  16. package/CHANGELOG.md +656 -555
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +68 -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 +17 -1
  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/release.js +3 -0
  353. package/dist/lib/core/risk-collect.d.ts +19 -0
  354. package/dist/lib/core/risk-collect.js +173 -0
  355. package/dist/lib/drift-sentinel.d.ts +59 -0
  356. package/dist/lib/drift-sentinel.js +126 -0
  357. package/dist/lib/generators/memory-generator.js +691 -691
  358. package/dist/lib/generators/nest-generator.js +412 -398
  359. package/dist/lib/generators/readme-generator.js +180 -180
  360. package/dist/lib/governance-report.js +39 -39
  361. package/dist/lib/llm/codex-output.d.ts +12 -0
  362. package/dist/lib/llm/codex-output.js +56 -0
  363. package/dist/lib/llm/context.d.ts +5 -0
  364. package/dist/lib/llm/context.js +17 -0
  365. package/dist/lib/llm/session.d.ts +18 -0
  366. package/dist/lib/llm/session.js +34 -0
  367. package/dist/lib/llm/validation.d.ts +37 -0
  368. package/dist/lib/llm/validation.js +88 -0
  369. package/dist/lib/workspace.js +29 -29
  370. package/dist/packages/adapter-git/src/index.d.ts +1 -1
  371. package/dist/packages/adapter-git/src/index.js +11 -6
  372. package/dist/packages/adapter-nest/src/index.d.ts +19 -0
  373. package/dist/packages/adapter-nest/src/index.js +26 -1
  374. package/dist/packages/adapter-sqlite/src/index.d.ts +27 -1
  375. package/dist/packages/adapter-sqlite/src/index.js +61 -12
  376. package/dist/packages/contracts/src/index.d.ts +33 -0
  377. package/dist/packages/contracts/src/index.js +13 -0
  378. package/dist/packages/core/src/index.d.ts +12 -0
  379. package/dist/packages/core/src/index.js +29 -0
  380. package/dist/packages/engineering/architecture/src/index.d.ts +76 -0
  381. package/dist/packages/engineering/architecture/src/index.js +131 -0
  382. package/dist/packages/engineering/evidence/src/index.d.ts +41 -0
  383. package/dist/packages/engineering/evidence/src/index.js +31 -0
  384. package/dist/packages/engineering/identity/src/index.d.ts +57 -0
  385. package/dist/packages/engineering/identity/src/index.js +88 -0
  386. package/dist/packages/engineering/monitoring/src/index.d.ts +37 -0
  387. package/dist/packages/engineering/monitoring/src/index.js +40 -0
  388. package/dist/packages/engineering/provenance/src/index.d.ts +25 -0
  389. package/dist/packages/engineering/provenance/src/index.js +21 -0
  390. package/dist/packages/engineering/risk/src/index.d.ts +89 -0
  391. package/dist/packages/engineering/risk/src/index.js +120 -0
  392. package/dist/packages/evals/src/index.js +6 -0
  393. package/dist/packages/graph/src/index.d.ts +23 -1
  394. package/dist/packages/graph/src/index.js +88 -15
  395. package/dist/packages/llm/src/index.d.ts +8 -1
  396. package/dist/packages/llm/src/index.js +64 -7
  397. package/dist/packages/mcp/src/index.js +27 -8
  398. package/dist/packages/orchestration/src/index.d.ts +11 -1
  399. package/dist/packages/orchestration/src/index.js +34 -7
  400. package/dist/packages/policy/src/index.d.ts +40 -0
  401. package/dist/packages/policy/src/index.js +39 -4
  402. package/dist/packages/runtime/src/index.js +3 -0
  403. package/dist/packages/sandbox/src/index.d.ts +47 -0
  404. package/dist/packages/sandbox/src/index.js +59 -0
  405. package/dist/packages/validator/src/index.d.ts +8 -0
  406. package/dist/packages/validator/src/index.js +21 -6
  407. package/dist/scripts/adr.d.ts +17 -0
  408. package/dist/scripts/adr.js +152 -0
  409. package/dist/scripts/agent-harness.js +72 -64
  410. package/dist/scripts/agent-router.js +20 -20
  411. package/dist/scripts/agent.d.ts +27 -0
  412. package/dist/scripts/agent.js +249 -0
  413. package/dist/scripts/architecture.d.ts +16 -0
  414. package/dist/scripts/architecture.js +186 -0
  415. package/dist/scripts/build-smart-context.js +22 -22
  416. package/dist/scripts/compress-memory.js +8 -8
  417. package/dist/scripts/context-ops.js +29 -29
  418. package/dist/scripts/cost-economy.d.ts +2 -0
  419. package/dist/scripts/cost-economy.js +79 -0
  420. package/dist/scripts/demo-autonomy.js +13 -6
  421. package/dist/scripts/dev.js +13 -13
  422. package/dist/scripts/drift-check.d.ts +17 -0
  423. package/dist/scripts/drift-check.js +63 -0
  424. package/dist/scripts/engineer.d.ts +20 -0
  425. package/dist/scripts/engineer.js +208 -0
  426. package/dist/scripts/evidence.d.ts +12 -0
  427. package/dist/scripts/evidence.js +55 -0
  428. package/dist/scripts/extract-global-knowledge.js +5 -5
  429. package/dist/scripts/gates.d.ts +6 -2
  430. package/dist/scripts/gates.js +14 -4
  431. package/dist/scripts/generate-dashboard.js +11 -11
  432. package/dist/scripts/incident.d.ts +19 -0
  433. package/dist/scripts/incident.js +103 -0
  434. package/dist/scripts/llm-fit.js +85 -9
  435. package/dist/scripts/memory-schema.js +48 -48
  436. package/dist/scripts/provenance.d.ts +14 -0
  437. package/dist/scripts/provenance.js +114 -0
  438. package/dist/scripts/query-universal-memory.js +13 -13
  439. package/dist/scripts/risk.d.ts +15 -0
  440. package/dist/scripts/risk.js +81 -0
  441. package/dist/scripts/simulate.d.ts +20 -0
  442. package/dist/scripts/simulate.js +150 -0
  443. package/dist/scripts/sprint-manager.js +39 -39
  444. package/dist/scripts/sync-universal-memory.js +44 -44
  445. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  446. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -40
  447. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  448. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  449. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  450. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -40
  451. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -26
  452. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -28
  453. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -22
  454. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -25
  455. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  456. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  457. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  458. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  459. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  460. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  461. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  462. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  463. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  464. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  465. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  466. package/docs/agent-harnesses.md +149 -149
  467. package/docs/agent-operating-contract.md +26 -0
  468. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  469. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  470. package/docs/architecture/FORJA-3-ENGINEERING-INTELLIGENCE-ARCHITECTURE.md +442 -0
  471. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  472. package/docs/archive/FASE2-SUMMARY.md +263 -263
  473. package/docs/archive/FASE3-PROGRESS.md +355 -355
  474. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  475. package/docs/archive/INDICE-MASTER.md +282 -282
  476. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  477. package/docs/archive/README-REFINAMENTO.md +293 -293
  478. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  479. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  480. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  481. package/docs/archive/START-HERE.md +319 -319
  482. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  483. package/docs/archive/examples/v1/AGENTS.md +10 -10
  484. package/docs/archive/examples/v1/README.md +36 -36
  485. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  486. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  487. package/docs/archive/examples/v1/backend/package.json +42 -42
  488. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  489. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  490. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  491. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  492. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  493. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  494. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  495. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  496. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  497. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  498. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  499. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  500. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  501. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  502. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  503. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  504. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  505. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  506. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  507. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  508. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  509. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  510. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  511. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  512. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  513. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  514. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  515. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  516. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  517. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  518. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  519. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  520. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  521. package/docs/archive/examples/v2/AGENTS.md +16 -16
  522. package/docs/archive/examples/v2/README.md +35 -35
  523. package/docs/archive/examples/v2/agents/README.md +3 -3
  524. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  525. package/docs/archive/examples/v2/agents/dba.md +4 -4
  526. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  527. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  528. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  529. package/docs/archive/examples/v2/agents/security.md +4 -4
  530. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  531. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  532. package/docs/archive/examples/v2/backend/package.json +42 -42
  533. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  534. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  535. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  536. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  537. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  538. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  539. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  540. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  541. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  542. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  543. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  544. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  545. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  546. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  547. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  548. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  549. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  550. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  551. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  552. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  553. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  554. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  555. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  556. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  557. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  558. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  559. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  560. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  561. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  562. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  563. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  564. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  565. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  566. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  567. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  568. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  569. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  570. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  571. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  572. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  573. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  574. package/docs/archive/examples/v2/memory/README.md +8 -8
  575. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  576. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  577. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  578. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  579. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  580. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  581. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  582. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  583. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  584. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  585. package/docs/capacidades-externas.md +86 -86
  586. package/docs/cli-first-operacao.md +74 -74
  587. package/docs/dev-workflow.md +421 -421
  588. package/docs/examples.md +546 -546
  589. package/docs/fluxo.md +103 -103
  590. package/docs/glossary.md +453 -453
  591. package/docs/init-project.md +457 -457
  592. package/docs/llm-evolution.md +51 -0
  593. package/docs/llm-fit-loop.md +134 -5
  594. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  595. package/docs/personas/architect/README.md +333 -333
  596. package/docs/personas/developer/README.md +371 -371
  597. package/docs/personas/executive/README.md +172 -172
  598. package/docs/personas/qa/README.md +350 -350
  599. package/docs/processo-projeto.md +138 -138
  600. package/docs/publishing.md +49 -377
  601. package/docs/quick-reference.md +409 -409
  602. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  603. package/docs/structure.md +360 -360
  604. package/docs/token-optimization.md +502 -502
  605. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  606. package/memory/00-global/mission.md +15 -15
  607. package/memory/00-global/shared-knowledge.md +8 -8
  608. package/memory/00-global/standards.md +47 -47
  609. package/memory/10-product/personas.md +21 -21
  610. package/memory/10-product/vision.md +27 -27
  611. package/memory/30-projects/README.md +15 -15
  612. package/memory/40-delivery/backlog.md +15 -15
  613. package/memory/40-delivery/current-sprint.md +20 -20
  614. package/memory/50-orchestration/gsd-harness.md +55 -55
  615. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  616. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  617. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  618. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  619. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  620. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  621. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  622. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  623. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  624. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  625. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  626. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  627. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  628. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  629. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  630. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  631. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  632. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  633. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  634. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  635. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  636. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  637. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  638. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  639. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  640. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  641. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  642. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -16
  643. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  644. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  645. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  646. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  647. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  648. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  649. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  650. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  651. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -14
  652. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -15
  653. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -13
  654. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -11
  655. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  656. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  657. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  658. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  659. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  660. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  661. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  662. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  663. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  664. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  665. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  666. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  667. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  668. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  669. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  670. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  671. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  672. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  673. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  674. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  675. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  676. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  677. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  678. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  679. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  680. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  681. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  682. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  683. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  684. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  685. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  686. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  687. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  688. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  689. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  690. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  691. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  692. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  693. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  694. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  695. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  696. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  697. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  698. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  699. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  700. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  701. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  702. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  703. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  704. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  705. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  706. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  707. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  708. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  709. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  710. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  711. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  712. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  713. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  714. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  715. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  716. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  717. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  718. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  719. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -16
  720. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -11
  721. package/memory/90-decisions/0071-server-persistence-composition.md +12 -12
  722. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -9
  723. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -17
  724. package/memory/90-decisions/0077-cost-aware-autonomy-budget.md +95 -0
  725. package/memory/90-decisions/0078-forjajs-3-engineering-control-plane.md +116 -0
  726. package/memory/90-decisions/0079-autonomous-maintenance-readiness.md +102 -0
  727. package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
  728. package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
  729. package/memory/90-decisions/_template.md +28 -28
  730. package/package.json +159 -157
  731. package/prompts/context-engineer-agent.md +13 -19
  732. package/prompts/governance-agent.md +13 -16
  733. package/prompts/marketing-agent.md +13 -13
  734. package/prompts/orchestrator-agent.md +13 -18
  735. package/prompts/product-agent.md +13 -13
  736. package/prompts/sdd-architect-agent.md +13 -20
  737. package/skills/MANIFEST.json +10 -0
  738. package/skills/llm-provider-routing/SKILL.md +18 -0
  739. package/specs/README.md +70 -70
  740. package/specs/_templates/plan.md +50 -43
  741. package/specs/_templates/spec.md +50 -43
  742. package/specs/_templates/tasks.md +39 -32
  743. package/specs/agent-identity-reputation/plan.md +133 -0
  744. package/specs/agent-identity-reputation/spec.md +125 -0
  745. package/specs/agent-identity-reputation/tasks.md +51 -0
  746. package/specs/agent-instructions-v4/plan.md +8 -0
  747. package/specs/agent-instructions-v4/spec.md +21 -0
  748. package/specs/agent-instructions-v4/tasks.md +12 -0
  749. package/specs/agent-runtime-monitoring/plan.md +78 -0
  750. package/specs/agent-runtime-monitoring/spec.md +92 -0
  751. package/specs/agent-runtime-monitoring/tasks.md +39 -0
  752. package/specs/ai-code-provenance/plan.md +71 -0
  753. package/specs/ai-code-provenance/spec.md +97 -0
  754. package/specs/ai-code-provenance/tasks.md +39 -0
  755. package/specs/architecture-constitution/plan.md +110 -0
  756. package/specs/architecture-constitution/spec.md +114 -0
  757. package/specs/architecture-constitution/tasks.md +58 -0
  758. package/specs/change-risk-engine/plan.md +130 -0
  759. package/specs/change-risk-engine/spec.md +119 -0
  760. package/specs/change-risk-engine/tasks.md +72 -0
  761. package/specs/clean-arch-boilerplate/plan.md +137 -137
  762. package/specs/clean-arch-boilerplate/spec.md +121 -121
  763. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  764. package/specs/cli-first-operacao/plan.md +53 -53
  765. package/specs/cli-first-operacao/spec.md +53 -53
  766. package/specs/cli-first-operacao/tasks.md +53 -53
  767. package/specs/code-context/spec.md +56 -56
  768. package/specs/coerencia-do-sistema/plan.md +155 -155
  769. package/specs/coerencia-do-sistema/spec.md +123 -123
  770. package/specs/coerencia-do-sistema/tasks.md +115 -115
  771. package/specs/cost-aware-autonomy-budget/spec.md +102 -0
  772. package/specs/dev-token-assets-db/plan.md +71 -71
  773. package/specs/dev-token-assets-db/spec.md +58 -58
  774. package/specs/dev-token-assets-db/tasks.md +58 -58
  775. package/specs/doctor-do-nucleo/plan.md +165 -165
  776. package/specs/doctor-do-nucleo/spec.md +139 -139
  777. package/specs/doctor-do-nucleo/tasks.md +172 -172
  778. package/specs/drift-sentinel/spec.md +117 -0
  779. package/specs/engineer-facade-extension/plan.md +71 -0
  780. package/specs/engineer-facade-extension/spec.md +98 -0
  781. package/specs/engineer-facade-extension/tasks.md +36 -0
  782. package/specs/engineering-evidence-ledger/plan.md +121 -0
  783. package/specs/engineering-evidence-ledger/spec.md +90 -0
  784. package/specs/engineering-evidence-ledger/tasks.md +54 -0
  785. package/specs/engineering-graph-extensions/plan.md +92 -0
  786. package/specs/engineering-graph-extensions/spec.md +101 -0
  787. package/specs/engineering-graph-extensions/tasks.md +60 -0
  788. package/specs/engineering-intelligence/spec.md +177 -0
  789. package/specs/forja-core/spec.md +71 -71
  790. package/specs/gates/spec.md +63 -63
  791. package/specs/governanca-visivel/plan.md +122 -122
  792. package/specs/governanca-visivel/spec.md +112 -112
  793. package/specs/governanca-visivel/tasks.md +60 -60
  794. package/specs/harness-codegraph/spec.md +71 -71
  795. package/specs/learning-loop-incidents/plan.md +59 -0
  796. package/specs/learning-loop-incidents/spec.md +93 -0
  797. package/specs/learning-loop-incidents/tasks.md +36 -0
  798. package/specs/llm-integration-v2/plan.md +55 -0
  799. package/specs/llm-integration-v2/spec.md +61 -0
  800. package/specs/llm-integration-v2/tasks.md +28 -0
  801. package/specs/llm-resume-validation/plan.md +50 -0
  802. package/specs/llm-resume-validation/spec.md +35 -0
  803. package/specs/llm-resume-validation/tasks.md +19 -0
  804. package/specs/memory-audit/spec.md +54 -54
  805. package/specs/orchestrate/spec.md +108 -108
  806. package/specs/orchestration-coherent/spec.md +95 -95
  807. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  808. package/specs/predictive-change-simulation/plan.md +109 -0
  809. package/specs/predictive-change-simulation/spec.md +107 -0
  810. package/specs/predictive-change-simulation/tasks.md +41 -0
  811. package/specs/project-smoke/spec.md +96 -96
  812. package/specs/project-upgrade/spec.md +58 -58
  813. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  814. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  815. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  816. package/specs/release-auditor-health/spec.md +23 -23
  817. package/specs/release-gate/plan.md +174 -174
  818. package/specs/release-gate/spec.md +122 -122
  819. package/specs/release-gate/tasks.md +183 -183
  820. package/specs/smart-agent-routing/plan.md +55 -0
  821. package/specs/smart-agent-routing/spec.md +85 -0
  822. package/specs/smart-agent-routing/tasks.md +26 -0
  823. package/specs/ts-migration/plan.md +200 -200
  824. package/specs/ts-migration/spec.md +119 -119
  825. package/specs/ts-migration/tasks.md +110 -110
@@ -10,456 +10,456 @@ import { writeFileSafe, ensureDir, maybeGitkeep } from "../utils/file-helpers.js
10
10
  */
11
11
  const memoryTemplates = {
12
12
  // === GLOBAL (00-global) ===
13
- 'memory/README.md': `# Memoria do Projeto
14
-
15
- Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
16
-
17
- ## Principio
18
- - Nao depender de um unico contexto gigante.
19
- - Trabalhar com memoria em camadas + handoff incremental.
20
- - Registrar decisoes, resumos e execucoes para continuidade.
21
- `,
22
- 'memory/00-global/mission.md': `# Missao do Projeto
23
-
24
- Construir software com clareza arquitetural, seguranca by-default e entrega continua.
25
-
26
- ## Principios
27
- - Simplicidade primeiro
28
- - Decisoes explicitas em ADR
29
- - Qualidade e seguranca desde o inicio
30
- - Documentacao viva
31
- `,
32
- 'memory/00-global/standards.md': `# Padroes Globais
33
-
34
- ## Idioma
35
- - Toda comunicacao e documentacao em **pt-BR**.
36
-
37
- ## Backend
38
- - API criada em **NestJS** por padrao.
39
- - Arquitetura modular por dominio.
40
-
41
- ## Qualidade
42
- - Cada mudanca deve registrar impacto, risco e rollback.
43
- - Priorizar padroes reutilizaveis.
44
- `,
45
- 'memory/00-global/context-policy.md': `# Politica de Contexto Longo
46
-
47
- ## Objetivo
48
- Permitir trabalho em larga escala sem depender de janela unica gigantesca.
49
-
50
- ## Regras
51
- - Usar contexto em camadas: global -> dominio -> tarefa -> diff.
52
- - Antes de cada tarefa: carregar apenas arquivos necessarios.
53
- - A cada entrega: gerar resumo curto em memory/70-summaries.
54
- - Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
55
-
56
- ## πŸ”„ Protocolo de Recuperacao (Engine Switch)
57
- Se houver esgotamento de cota ou necessidade de mudar de IA:
58
- 1. Localize o arquivo \`.ia-instructions/models.json\`.
59
- 2. Identifique o proximo motor na \`fallback_chain\`.
60
- 3. Carregue as instrucoes do novo motor.
61
- 4. Forneca o conteΓΊdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
62
- 5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
63
-
64
- ## Nota importante
65
- Esta estrutura **nao aumenta** limite nativo do modelo.
66
- Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
67
- `,
68
- 'memory/00-global/agent-contract.md': `# Contrato de Agentes
69
-
70
- ## Orquestrador
71
- - DecompΓ΅e trabalho em subtarefas independentes.
72
- - Define dono por escopo de arquivo.
73
- - Consolida handoffs e conflitos.
74
-
75
- ## Workers
76
- - Implementam subtarefas com escopo claro.
77
- - Nao alteram areas de outros agentes sem alinhamento.
78
- - Entregam: alteracoes, riscos, testes e pendencias.
79
-
80
- ## Reviewer
81
- - Verifica regressao, seguranca e cobertura de testes.
82
- - Bloqueia merge se encontrar risco critico.
83
- `,
84
- 'memory/00-global/context-index.md': `# Indice de Contexto
85
-
86
- ## Ordem de Leitura
87
- 1. memory/00-global/mission.md
88
- 2. memory/00-global/standards.md
89
- 3. memory/00-global/context-policy.md
90
- 4. memory/10-product/*
91
- 5. memory/20-architecture/*
92
- 6. memory/30-domains/<dominio>/*
93
- 7. memory/40-delivery/current-sprint.md
94
- 8. memory/90-decisions/ADR-*.md
95
- 9. memory/70-summaries/*
13
+ 'memory/README.md': `# Memoria do Projeto
14
+
15
+ Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
16
+
17
+ ## Principio
18
+ - Nao depender de um unico contexto gigante.
19
+ - Trabalhar com memoria em camadas + handoff incremental.
20
+ - Registrar decisoes, resumos e execucoes para continuidade.
21
+ `,
22
+ 'memory/00-global/mission.md': `# Missao do Projeto
23
+
24
+ Construir software com clareza arquitetural, seguranca by-default e entrega continua.
25
+
26
+ ## Principios
27
+ - Simplicidade primeiro
28
+ - Decisoes explicitas em ADR
29
+ - Qualidade e seguranca desde o inicio
30
+ - Documentacao viva
31
+ `,
32
+ 'memory/00-global/standards.md': `# Padroes Globais
33
+
34
+ ## Idioma
35
+ - Toda comunicacao e documentacao em **pt-BR**.
36
+
37
+ ## Backend
38
+ - API criada em **NestJS** por padrao.
39
+ - Arquitetura modular por dominio.
40
+
41
+ ## Qualidade
42
+ - Cada mudanca deve registrar impacto, risco e rollback.
43
+ - Priorizar padroes reutilizaveis.
44
+ `,
45
+ 'memory/00-global/context-policy.md': `# Politica de Contexto Longo
46
+
47
+ ## Objetivo
48
+ Permitir trabalho em larga escala sem depender de janela unica gigantesca.
49
+
50
+ ## Regras
51
+ - Usar contexto em camadas: global -> dominio -> tarefa -> diff.
52
+ - Antes de cada tarefa: carregar apenas arquivos necessarios.
53
+ - A cada entrega: gerar resumo curto em memory/70-summaries.
54
+ - Em mudancas grandes: registrar handoff em memory/50-orchestration/handoffs.
55
+
56
+ ## πŸ”„ Protocolo de Recuperacao (Engine Switch)
57
+ Se houver esgotamento de cota ou necessidade de mudar de IA:
58
+ 1. Localize o arquivo \`.ia-instructions/models.json\`.
59
+ 2. Identifique o proximo motor na \`fallback_chain\`.
60
+ 3. Carregue as instrucoes do novo motor.
61
+ 4. Forneca o conteΓΊdo de \`.context/context-pack.md\` + o ultimo arquivo em \`memory/50-orchestration/handoffs/\`.
62
+ 5. O novo motor assumira o trabalho a partir do ponto exato da ultima entrega.
63
+
64
+ ## Nota importante
65
+ Esta estrutura **nao aumenta** limite nativo do modelo.
66
+ Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
67
+ `,
68
+ 'memory/00-global/agent-contract.md': `# Contrato de Agentes
69
+
70
+ ## Orquestrador
71
+ - DecompΓ΅e trabalho em subtarefas independentes.
72
+ - Define dono por escopo de arquivo.
73
+ - Consolida handoffs e conflitos.
74
+
75
+ ## Workers
76
+ - Implementam subtarefas com escopo claro.
77
+ - Nao alteram areas de outros agentes sem alinhamento.
78
+ - Entregam: alteracoes, riscos, testes e pendencias.
79
+
80
+ ## Reviewer
81
+ - Verifica regressao, seguranca e cobertura de testes.
82
+ - Bloqueia merge se encontrar risco critico.
83
+ `,
84
+ 'memory/00-global/context-index.md': `# Indice de Contexto
85
+
86
+ ## Ordem de Leitura
87
+ 1. memory/00-global/mission.md
88
+ 2. memory/00-global/standards.md
89
+ 3. memory/00-global/context-policy.md
90
+ 4. memory/10-product/*
91
+ 5. memory/20-architecture/*
92
+ 6. memory/30-domains/<dominio>/*
93
+ 7. memory/40-delivery/current-sprint.md
94
+ 8. memory/90-decisions/ADR-*.md
95
+ 9. memory/70-summaries/*
96
96
  `,
97
97
  // === PRODUCT (10-product) ===
98
- 'memory/10-product/vision.md': `# Visao de Produto
99
-
100
- Descreva objetivo, publico-alvo, problema e proposta de valor.
98
+ 'memory/10-product/vision.md': `# Visao de Produto
99
+
100
+ Descreva objetivo, publico-alvo, problema e proposta de valor.
101
101
  `,
102
- 'memory/10-product/personas.md': `# Personas
103
-
104
- Liste personas e dores principais.
102
+ 'memory/10-product/personas.md': `# Personas
103
+
104
+ Liste personas e dores principais.
105
105
  `,
106
- 'memory/10-product/business-rules.md': `# Regras de Negocio
107
-
108
- Documente regras imutaveis e validacoes criticas.
106
+ 'memory/10-product/business-rules.md': `# Regras de Negocio
107
+
108
+ Documente regras imutaveis e validacoes criticas.
109
109
  `,
110
- 'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
111
-
112
- - Performance
113
- - Seguranca
114
- - Observabilidade
115
- - Escalabilidade
110
+ 'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
111
+
112
+ - Performance
113
+ - Seguranca
114
+ - Observabilidade
115
+ - Escalabilidade
116
116
  `,
117
117
  // === ARCHITECTURE (20-architecture) ===
118
- 'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
119
-
120
- Descreva contexto, fronteiras e integracoes principais.
121
- `,
122
- 'memory/20-architecture/frontend.md': `# Frontend
123
-
124
- Defina padroes de componentizacao, acessibilidade e performance.
125
- `,
126
- 'memory/20-architecture/backend.md': `# Backend
127
-
128
- ## Diretriz principal
129
- - Backend em **NestJS** por padrao.
130
-
131
- ## Estrutura sugerida
132
- - Modulos por dominio
133
- - DTO + validacao
134
- - Servicos com regras de negocio
135
- - Repositorios/integradores isolados
136
- `,
137
- 'memory/20-architecture/data.md': `# Dados
138
-
139
- Descreva entidades, relacionamentos e politicas de retencao.
140
- `,
141
- 'memory/20-architecture/security.md': `# Seguranca
142
-
143
- - Principio do menor privilegio
144
- - Segredos fora do codigo
145
- - Validacao de entrada em todas as rotas
146
- - Logs sem dados sensiveis
147
- `,
148
- 'memory/20-architecture/observability.md': `# Observabilidade
149
-
150
- - Logs estruturados
151
- - Metricas e tracing
152
- - Alertas por SLO
118
+ 'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
119
+
120
+ Descreva contexto, fronteiras e integracoes principais.
121
+ `,
122
+ 'memory/20-architecture/frontend.md': `# Frontend
123
+
124
+ Defina padroes de componentizacao, acessibilidade e performance.
125
+ `,
126
+ 'memory/20-architecture/backend.md': `# Backend
127
+
128
+ ## Diretriz principal
129
+ - Backend em **NestJS** por padrao.
130
+
131
+ ## Estrutura sugerida
132
+ - Modulos por dominio
133
+ - DTO + validacao
134
+ - Servicos com regras de negocio
135
+ - Repositorios/integradores isolados
136
+ `,
137
+ 'memory/20-architecture/data.md': `# Dados
138
+
139
+ Descreva entidades, relacionamentos e politicas de retencao.
140
+ `,
141
+ 'memory/20-architecture/security.md': `# Seguranca
142
+
143
+ - Principio do menor privilegio
144
+ - Segredos fora do codigo
145
+ - Validacao de entrada em todas as rotas
146
+ - Logs sem dados sensiveis
147
+ `,
148
+ 'memory/20-architecture/observability.md': `# Observabilidade
149
+
150
+ - Logs estruturados
151
+ - Metricas e tracing
152
+ - Alertas por SLO
153
153
  `,
154
154
  // === DOMAINS (30-domains) ===
155
- 'memory/30-domains/auth/context.md': `# Contexto de Auth
156
-
157
- Defina escopo funcional de autenticacao/autorizacao.
155
+ 'memory/30-domains/auth/context.md': `# Contexto de Auth
156
+
157
+ Defina escopo funcional de autenticacao/autorizacao.
158
158
  `,
159
- 'memory/30-domains/auth/rules.md': `# Regras de Auth
160
-
161
- Liste regras e restricoes de seguranca.
159
+ 'memory/30-domains/auth/rules.md': `# Regras de Auth
160
+
161
+ Liste regras e restricoes de seguranca.
162
162
  `,
163
- 'memory/30-domains/auth/api.md': `# API de Auth
164
-
165
- Documente endpoints, payloads e erros.
163
+ 'memory/30-domains/auth/api.md': `# API de Auth
164
+
165
+ Documente endpoints, payloads e erros.
166
166
  `,
167
- 'memory/30-domains/billing/context.md': `# Contexto de Billing
168
-
169
- Defina cobranca, ciclo e integracoes.
167
+ 'memory/30-domains/billing/context.md': `# Contexto de Billing
168
+
169
+ Defina cobranca, ciclo e integracoes.
170
170
  `,
171
- 'memory/30-domains/billing/rules.md': `# Regras de Billing
172
-
173
- Descreva calculos, status e excecoes.
171
+ 'memory/30-domains/billing/rules.md': `# Regras de Billing
172
+
173
+ Descreva calculos, status e excecoes.
174
174
  `,
175
- 'memory/30-domains/billing/api.md': `# API de Billing
176
-
177
- Documente endpoints e regras de idempotencia.
175
+ 'memory/30-domains/billing/api.md': `# API de Billing
176
+
177
+ Documente endpoints e regras de idempotencia.
178
178
  `,
179
179
  // === DELIVERY (40-delivery) ===
180
- 'memory/40-delivery/roadmap.md': `# Roadmap
181
-
182
- Mapeie entregas por trimestre/sprint.
183
- `,
184
- 'memory/40-delivery/current-sprint.md': `# Sprint Atual
185
-
186
- ## Objetivos
187
- -
188
-
189
- ## Itens
190
- -
191
-
192
- ## Riscos
193
- -
194
- `,
195
- 'memory/40-delivery/backlog.md': `# Backlog
196
-
197
- Liste itens priorizados com contexto minimo.
180
+ 'memory/40-delivery/roadmap.md': `# Roadmap
181
+
182
+ Mapeie entregas por trimestre/sprint.
183
+ `,
184
+ 'memory/40-delivery/current-sprint.md': `# Sprint Atual
185
+
186
+ ## Objetivos
187
+ -
188
+
189
+ ## Itens
190
+ -
191
+
192
+ ## Riscos
193
+ -
194
+ `,
195
+ 'memory/40-delivery/backlog.md': `# Backlog
196
+
197
+ Liste itens priorizados com contexto minimo.
198
198
  `,
199
199
  // === ORCHESTRATION (50-orchestration) ===
200
- 'memory/50-orchestration/topology.md': `# Topologia Multiagente
201
-
202
- ## Papeis
203
- - Orquestrador
204
- - Worker Backend (NestJS)
205
- - Worker Frontend
206
- - Worker DBA
207
- - Worker Security
208
- - Reviewer
209
-
210
- ## Fluxo
211
- 1. Orquestrador cria plano e fatia trabalho.
212
- 2. Workers executam em paralelo com escopo isolado.
213
- 3. Handoffs sao registrados.
214
- 4. Reviewer valida e aprova.
215
- `,
216
- 'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
217
-
218
- ## Regras de roteamento
219
- - API e dominio server-side -> backend-nest
220
- - Schema/migracao/query -> dba
221
- - Auth, hardening, segredos -> security
222
- - UX/componentes -> frontend
223
-
224
- ## Critico
225
- Subtarefas devem ter dono unico por arquivo para evitar conflito.
226
- `,
227
- 'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
228
-
229
- Cada handoff deve conter:
230
- - contexto minimo
231
- - alteracoes realizadas
232
- - arquivos tocados
233
- - riscos e pontos abertos
234
- - proximos passos objetivos
235
- `,
236
- 'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
237
-
238
- ## Quando paralelizar
239
- - Subtarefas independentes por dominio.
240
- - Escopo de escrita sem sobreposicao.
241
-
242
- ## Quando nao paralelizar
243
- - Mudanca bloqueante para a proxima etapa.
244
- - Refactor altamente acoplado no mesmo modulo.
245
- `,
246
- 'memory/50-orchestration/handoffs/README.md': `# Handoffs
247
-
248
- Registre cada transicao em arquivos markdown com timestamp.
249
- Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
200
+ 'memory/50-orchestration/topology.md': `# Topologia Multiagente
201
+
202
+ ## Papeis
203
+ - Orquestrador
204
+ - Worker Backend (NestJS)
205
+ - Worker Frontend
206
+ - Worker DBA
207
+ - Worker Security
208
+ - Reviewer
209
+
210
+ ## Fluxo
211
+ 1. Orquestrador cria plano e fatia trabalho.
212
+ 2. Workers executam em paralelo com escopo isolado.
213
+ 3. Handoffs sao registrados.
214
+ 4. Reviewer valida e aprova.
215
+ `,
216
+ 'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
217
+
218
+ ## Regras de roteamento
219
+ - API e dominio server-side -> backend-nest
220
+ - Schema/migracao/query -> dba
221
+ - Auth, hardening, segredos -> security
222
+ - UX/componentes -> frontend
223
+
224
+ ## Critico
225
+ Subtarefas devem ter dono unico por arquivo para evitar conflito.
226
+ `,
227
+ 'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
228
+
229
+ Cada handoff deve conter:
230
+ - contexto minimo
231
+ - alteracoes realizadas
232
+ - arquivos tocados
233
+ - riscos e pontos abertos
234
+ - proximos passos objetivos
235
+ `,
236
+ 'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
237
+
238
+ ## Quando paralelizar
239
+ - Subtarefas independentes por dominio.
240
+ - Escopo de escrita sem sobreposicao.
241
+
242
+ ## Quando nao paralelizar
243
+ - Mudanca bloqueante para a proxima etapa.
244
+ - Refactor altamente acoplado no mesmo modulo.
245
+ `,
246
+ 'memory/50-orchestration/handoffs/README.md': `# Handoffs
247
+
248
+ Registre cada transicao em arquivos markdown com timestamp.
249
+ Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
250
250
  `,
251
251
  // === RUNS (60-runs) ===
252
- 'memory/60-runs/README.md': `# Runs
253
-
254
- Log de execucao por ciclo/sprint.
252
+ 'memory/60-runs/README.md': `# Runs
253
+
254
+ Log de execucao por ciclo/sprint.
255
255
  `,
256
256
  // === SUMMARIES (70-summaries) ===
257
- 'memory/70-summaries/global-summary.md': `# Resumo Global
258
-
259
- Atualize a cada marco importante com:
260
- - estado atual
261
- - decisoes novas
262
- - riscos ativos
257
+ 'memory/70-summaries/global-summary.md': `# Resumo Global
258
+
259
+ Atualize a cada marco importante com:
260
+ - estado atual
261
+ - decisoes novas
262
+ - riscos ativos
263
263
  `,
264
- 'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
265
-
266
- Mantenha resumos curtos por dominio para carregamento rapido de contexto.
264
+ 'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
265
+
266
+ Mantenha resumos curtos por dominio para carregamento rapido de contexto.
267
267
  `,
268
268
  // === DATA (80-data) ===
269
- 'memory/80-data/memory-db.md': `# Memory DB (SQLite)
270
-
271
- ## Objetivo
272
- Armazenar indice operacional da documentacao para busca e continuidade de contexto.
273
-
274
- ## Fonte da verdade
275
- - Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
276
-
277
- ## Banco
278
- - SQLite em .memory/sqlite/context.db
279
-
280
- ## Fluxo
281
- 1. Atualizar markdown
282
- 2. Rodar sincronizacao
283
- 3. Consultar contexto por texto ou tipo
269
+ 'memory/80-data/memory-db.md': `# Memory DB (SQLite)
270
+
271
+ ## Objetivo
272
+ Armazenar indice operacional da documentacao para busca e continuidade de contexto.
273
+
274
+ ## Fonte da verdade
275
+ - Arquivos Markdown em memory/, docs/, agents/, skills/, prompts/
276
+
277
+ ## Banco
278
+ - SQLite em .memory/sqlite/context.db
279
+
280
+ ## Fluxo
281
+ 1. Atualizar markdown
282
+ 2. Rodar sincronizacao
283
+ 3. Consultar contexto por texto ou tipo
284
284
  `,
285
285
  // === DECISIONS (90-decisions) ===
286
- 'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
287
-
288
- ## Contexto
289
-
290
- ## Decisao
291
-
292
- ## Consequencias
293
-
294
- ## Alternativas consideradas
286
+ 'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
287
+
288
+ ## Contexto
289
+
290
+ ## Decisao
291
+
292
+ ## Consequencias
293
+
294
+ ## Alternativas consideradas
295
295
  `,
296
296
  };
297
297
  /**
298
298
  * Gera estrutura de agentes
299
299
  */
300
300
  const agentTemplates = {
301
- 'agents/README.md': `# Agents
302
-
303
- Agentes especializados para dividir trabalho em paralelo.
304
- `,
305
- 'agents/orchestrator.md': `# Agent: Orchestrator
306
-
307
- ## Responsabilidade
308
- Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
309
-
310
- ## Entrega minima
311
- - plano objetivo
312
- - distribuicao por agentes
313
- - consolidacao de handoffs
314
- `,
315
- 'agents/backend-nest.md': `# Agent: Backend NestJS
316
-
317
- ## Escopo
318
- - modulos, controllers, services, dto, guard, pipe
319
- - testes unitarios e e2e da API
320
-
321
- ## Padrao
322
- - NestJS por padrao
323
- - validacao de entrada obrigatoria
324
- `,
325
- 'agents/frontend.md': `# Agent: Frontend
326
-
327
- ## Escopo
328
- - componentes, acessibilidade, performance, UX
329
- `,
330
- 'agents/dba.md': `# Agent: DBA
331
-
332
- ## Escopo
333
- - modelagem, indices, migracoes, tuning de query
334
- `,
335
- 'agents/security.md': `# Agent: Security
336
-
337
- ## Escopo
338
- - threat modeling, hardening, authz/authn, secrets, auditoria
339
- `,
340
- 'agents/reviewer.md': `# Agent: Reviewer
341
-
342
- ## Escopo
343
- - regressao funcional
344
- - riscos de seguranca
345
- - cobertura de testes
301
+ 'agents/README.md': `# Agents
302
+
303
+ Agentes especializados para dividir trabalho em paralelo.
304
+ `,
305
+ 'agents/orchestrator.md': `# Agent: Orchestrator
306
+
307
+ ## Responsabilidade
308
+ Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
309
+
310
+ ## Entrega minima
311
+ - plano objetivo
312
+ - distribuicao por agentes
313
+ - consolidacao de handoffs
314
+ `,
315
+ 'agents/backend-nest.md': `# Agent: Backend NestJS
316
+
317
+ ## Escopo
318
+ - modulos, controllers, services, dto, guard, pipe
319
+ - testes unitarios e e2e da API
320
+
321
+ ## Padrao
322
+ - NestJS por padrao
323
+ - validacao de entrada obrigatoria
324
+ `,
325
+ 'agents/frontend.md': `# Agent: Frontend
326
+
327
+ ## Escopo
328
+ - componentes, acessibilidade, performance, UX
329
+ `,
330
+ 'agents/dba.md': `# Agent: DBA
331
+
332
+ ## Escopo
333
+ - modelagem, indices, migracoes, tuning de query
334
+ `,
335
+ 'agents/security.md': `# Agent: Security
336
+
337
+ ## Escopo
338
+ - threat modeling, hardening, authz/authn, secrets, auditoria
339
+ `,
340
+ 'agents/reviewer.md': `# Agent: Reviewer
341
+
342
+ ## Escopo
343
+ - regressao funcional
344
+ - riscos de seguranca
345
+ - cobertura de testes
346
346
  `,
347
347
  };
348
348
  /**
349
349
  * Gera estrutura de skills
350
350
  */
351
351
  const skillTemplates = {
352
- 'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
353
-
354
- ## Objetivo
355
- Classificar demanda em: rapido, medio, complexo.
356
-
357
- ## Saida
358
- - resumo
359
- - risco
360
- - owner sugerido
361
- - fatias de execucao
362
- `,
363
- 'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
364
-
365
- ## Objetivo
366
- Gerar resumo operacional sem perder decisoes chave.
367
-
368
- ## Regras
369
- - manter fatos verificaveis
370
- - remover redundancia
371
- - preservar links para fontes internas
372
- `,
373
- 'skills/handoff/SKILL.md': `# Skill: Handoff
374
-
375
- ## Template
376
- - contexto
377
- - alteracoes
378
- - riscos
379
- - pendencias
380
- - proximo agente
381
- `,
382
- 'skills/nest-api/SKILL.md': `# Skill: Nest API
383
-
384
- ## Checklist
385
- - modulo criado
386
- - dto com validacao
387
- - controller + service
388
- - testes
389
- `,
390
- 'skills/self-healing/SKILL.md': `# Skill: Auto-DiagnΓ³stico (Self-Healing)
391
-
392
- ## Objetivo
393
- Resolver falhas de build, testes ou tipos sem intervenΓ§Γ£o humana.
394
-
395
- ## Fluxo
396
- 1. Analisar a stack trace completa do erro.
397
- 2. Identificar se Γ©: erro de sintaxe, falta de dependΓͺncia, erro de tipo ou lΓ³gica.
398
- 3. Consultar documentaΓ§Γ£o interna ou padrΓ΅es do projeto.
399
- 4. Propor correΓ§Γ£o mΓ­nima e rodar validaΓ§Γ£o novamente.
400
- `,
401
- 'skills/validate-handoff/SKILL.md': `# Skill: ValidaΓ§Γ£o e Review de SeguranΓ§a (Gatekeeper)
402
-
403
- ## Objetivo
404
- Atuar como Gatekeeper final para garantir que nenhum cΓ³digo inseguro ou incompleto entre no pipeline.
405
-
406
- ## Protocolo de Review (ObrigatΓ³rio)
407
- Antes de aceitar um handoff, o Reviewer deve validar:
408
-
409
- 1. **Compliance de RaciocΓ­nio**: O Worker preencheu o bloco \`## RaciocΓ­nio Estruturado\`? (Se nΓ£o, rejeite imediatamente).
410
- 2. **Scan de SeguranΓ§a**:
411
- - HΓ‘ logs sensΓ­veis (PII, tokens) sendo impressos?
412
- - As validaΓ§Γ΅es de input estΓ£o no DTO?
413
- 3. **VerificaΓ§Γ£o de Handoff**:
414
- - Os arquivos listados no handoff condizem com o diff real?
415
- - Existem pendΓͺncias (riscos) nΓ£o documentadas?
416
-
417
- ## SaΓ­da do Reviewer
418
- - [ ] Aprovado (Status: \`done\` no DB)
419
- - [ ] Rejeitado (Status: \`blocked\` + pendΓͺncias listadas)
420
- `,
421
- 'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
422
-
423
- ## Objetivo
424
- Garantir que a UI segue padrΓ΅es de elite.
425
-
426
- ## InstruΓ§Γ£o
427
- 1. Consultar a biblioteca \`design-md/\` para inspiraΓ§Γ£o de marca/padrΓ£o.
428
- 2. Comparar o cΓ³digo gerado com os padrΓ΅es de espaΓ§amento, tipografia e cores da referΓͺncia.
429
- 3. Ajustar CSS/Componentes para atingir qualidade visual de nΓ­vel mundial.
430
- `,
431
- 'skills/reasoning-protocol/SKILL.md': `# Skill: RaciocΓ­nio Estruturado (Chain-of-Thought)
432
-
433
- ## Objetivo
434
- Reduzir erros de implementaΓ§Γ£o atravΓ©s de anΓ‘lise lΓ³gica explΓ­cita.
435
-
436
- ## Protocolo ObrigatΓ³rio
437
- Antes de qualquer cΓ³digo ou plano de aΓ§Γ£o, preencha o bloco \`## RaciocΓ­nio Estruturado\`:
438
-
439
- 1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
440
- 2. **Restriçáes**: Quais arquivos NÃO posso tocar? Quais padráes devo seguir?
441
- 3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
442
- 4. **Plano de Ataque**: Passo-a-passo lΓ³gico da implementaΓ§Γ£o.
443
- `,
444
- 'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
445
-
446
- ## Objetivo
352
+ 'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
353
+
354
+ ## Objetivo
355
+ Classificar demanda em: rapido, medio, complexo.
356
+
357
+ ## Saida
358
+ - resumo
359
+ - risco
360
+ - owner sugerido
361
+ - fatias de execucao
362
+ `,
363
+ 'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
364
+
365
+ ## Objetivo
366
+ Gerar resumo operacional sem perder decisoes chave.
367
+
368
+ ## Regras
369
+ - manter fatos verificaveis
370
+ - remover redundancia
371
+ - preservar links para fontes internas
372
+ `,
373
+ 'skills/handoff/SKILL.md': `# Skill: Handoff
374
+
375
+ ## Template
376
+ - contexto
377
+ - alteracoes
378
+ - riscos
379
+ - pendencias
380
+ - proximo agente
381
+ `,
382
+ 'skills/nest-api/SKILL.md': `# Skill: Nest API
383
+
384
+ ## Checklist
385
+ - modulo criado
386
+ - dto com validacao
387
+ - controller + service
388
+ - testes
389
+ `,
390
+ 'skills/self-healing/SKILL.md': `# Skill: Auto-DiagnΓ³stico (Self-Healing)
391
+
392
+ ## Objetivo
393
+ Resolver falhas de build, testes ou tipos sem intervenΓ§Γ£o humana.
394
+
395
+ ## Fluxo
396
+ 1. Analisar a stack trace completa do erro.
397
+ 2. Identificar se Γ©: erro de sintaxe, falta de dependΓͺncia, erro de tipo ou lΓ³gica.
398
+ 3. Consultar documentaΓ§Γ£o interna ou padrΓ΅es do projeto.
399
+ 4. Propor correΓ§Γ£o mΓ­nima e rodar validaΓ§Γ£o novamente.
400
+ `,
401
+ 'skills/validate-handoff/SKILL.md': `# Skill: ValidaΓ§Γ£o e Review de SeguranΓ§a (Gatekeeper)
402
+
403
+ ## Objetivo
404
+ Atuar como Gatekeeper final para garantir que nenhum cΓ³digo inseguro ou incompleto entre no pipeline.
405
+
406
+ ## Protocolo de Review (ObrigatΓ³rio)
407
+ Antes de aceitar um handoff, o Reviewer deve validar:
408
+
409
+ 1. **Compliance de RaciocΓ­nio**: O Worker preencheu o bloco \`## RaciocΓ­nio Estruturado\`? (Se nΓ£o, rejeite imediatamente).
410
+ 2. **Scan de SeguranΓ§a**:
411
+ - HΓ‘ logs sensΓ­veis (PII, tokens) sendo impressos?
412
+ - As validaΓ§Γ΅es de input estΓ£o no DTO?
413
+ 3. **VerificaΓ§Γ£o de Handoff**:
414
+ - Os arquivos listados no handoff condizem com o diff real?
415
+ - Existem pendΓͺncias (riscos) nΓ£o documentadas?
416
+
417
+ ## SaΓ­da do Reviewer
418
+ - [ ] Aprovado (Status: \`done\` no DB)
419
+ - [ ] Rejeitado (Status: \`blocked\` + pendΓͺncias listadas)
420
+ `,
421
+ 'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
422
+
423
+ ## Objetivo
424
+ Garantir que a UI segue padrΓ΅es de elite.
425
+
426
+ ## InstruΓ§Γ£o
427
+ 1. Consultar a biblioteca \`design-md/\` para inspiraΓ§Γ£o de marca/padrΓ£o.
428
+ 2. Comparar o cΓ³digo gerado com os padrΓ΅es de espaΓ§amento, tipografia e cores da referΓͺncia.
429
+ 3. Ajustar CSS/Componentes para atingir qualidade visual de nΓ­vel mundial.
430
+ `,
431
+ 'skills/reasoning-protocol/SKILL.md': `# Skill: RaciocΓ­nio Estruturado (Chain-of-Thought)
432
+
433
+ ## Objetivo
434
+ Reduzir erros de implementaΓ§Γ£o atravΓ©s de anΓ‘lise lΓ³gica explΓ­cita.
435
+
436
+ ## Protocolo ObrigatΓ³rio
437
+ Antes de qualquer cΓ³digo ou plano de aΓ§Γ£o, preencha o bloco \`## RaciocΓ­nio Estruturado\`:
438
+
439
+ 1. **Entendimento**: O que foi pedido e qual o impacto no sistema?
440
+ 2. **Restriçáes**: Quais arquivos NÃO posso tocar? Quais padráes devo seguir?
441
+ 3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
442
+ 4. **Plano de Ataque**: Passo-a-passo lΓ³gico da implementaΓ§Γ£o.
443
+ `,
444
+ 'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
445
+
446
+ ## Objetivo
447
447
  Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor, usando o ciclo verificΓ‘vel do Forja.
448
-
449
- ## Quando usar
450
- - O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
451
- - Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
452
- - Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
453
-
454
- ## Regras
455
- - Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
456
- - Usar \`manual\` quando o provider nao tiver CLI local confiavel.
448
+
449
+ ## Quando usar
450
+ - O usuario pedir DeepSeek, MiniMax, Mistral, Qwen, Ollama, OpenRouter, Together, Groq, xAI, Cohere, Perplexity ou outro provider.
451
+ - Um papel precisar trocar de modelo por custo, cota, latencia, contexto, privacidade ou qualidade.
452
+ - Uma CLI/API externa precisar entrar no fluxo de handoffs sem alterar o SDD.
453
+
454
+ ## Regras
455
+ - Preferir providers locais para tarefas sensiveis quando o modelo disponivel for suficiente.
456
+ - Usar \`manual\` quando o provider nao tiver CLI local confiavel.
457
457
  - Registrar perfis no workspace em \`.context/llm-profiles.json\` com \`provider\`, \`model\`, \`command\`, \`commandArgs\`, \`roles\`, \`taskTypes\`, \`privacy\` e \`enabled\`.
458
- - Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
459
- - Nao colocar API keys em memoria, specs, handoffs ou logs.
460
-
461
- ## Checklist
462
- 1. Identificar papel e tipo de tarefa.
458
+ - Nao assumir que uma CLI existe: validar o binario ou documentar o comando esperado.
459
+ - Nao colocar API keys em memoria, specs, handoffs ou logs.
460
+
461
+ ## Checklist
462
+ 1. Identificar papel e tipo de tarefa.
463
463
  2. Inicializar ou revisar os perfis com \`forja llm:profiles:init\`.
464
464
  3. Preencher \`command\` com um ΓΊnico executΓ‘vel e \`commandArgs\` para argumentos fixos; nunca use shell ou grave credenciais.
465
465
  4. Rodar \`forja llm:probe <perfil>\` antes de delegar uma sprint inteira.
@@ -467,306 +467,306 @@ Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico forne
467
467
  6. Executar \`forja llm:run --profile <perfil> --task <arquivo>\` e avaliar com \`forja llm:eval --scope model --id <provider:model>\`.
468
468
  7. Registrar handoff Hermes quando a troca impactar entrega.
469
469
  `,
470
- 'skills/MANIFEST.json': `{
471
- "version": "0.5.0",
472
- "skills": [
473
- { "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "ClassificaΓ§Γ£o de tarefas" },
474
- { "id": "compaction", "path": "skills/context-compaction/SKILL.md", "description": "CompactaΓ§Γ£o de memΓ³ria" },
475
- { "id": "handoff", "path": "skills/handoff/SKILL.md", "description": "Protocolo de transiΓ§Γ£o" },
476
- { "id": "nest-api", "path": "skills/nest-api/SKILL.md", "description": "GeraΓ§Γ£o de endpoints NestJS" },
477
- { "id": "self-healing", "path": "skills/self-healing/SKILL.md", "description": "ResoluΓ§Γ£o autΓ΄noma de erros" },
478
- { "id": "validate-handoff", "path": "skills/validate-handoff/SKILL.md", "description": "Checklist de qualidade de handoff" },
479
- { "id": "ui-fidelity", "path": "skills/ui-fidelity/SKILL.md", "description": "Auditoria estΓ©tica de UI" },
480
- { "id": "reasoning", "path": "skills/reasoning-protocol/SKILL.md", "description": "Protocolo de raciocΓ­nio lΓ³gico" },
481
- { "id": "llm-provider-routing", "path": "skills/llm-provider-routing/SKILL.md", "description": "Roteamento multi-LLM por papel" }
482
- ]
483
- }
470
+ 'skills/MANIFEST.json': `{
471
+ "version": "0.5.0",
472
+ "skills": [
473
+ { "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "ClassificaΓ§Γ£o de tarefas" },
474
+ { "id": "compaction", "path": "skills/context-compaction/SKILL.md", "description": "CompactaΓ§Γ£o de memΓ³ria" },
475
+ { "id": "handoff", "path": "skills/handoff/SKILL.md", "description": "Protocolo de transiΓ§Γ£o" },
476
+ { "id": "nest-api", "path": "skills/nest-api/SKILL.md", "description": "GeraΓ§Γ£o de endpoints NestJS" },
477
+ { "id": "self-healing", "path": "skills/self-healing/SKILL.md", "description": "ResoluΓ§Γ£o autΓ΄noma de erros" },
478
+ { "id": "validate-handoff", "path": "skills/validate-handoff/SKILL.md", "description": "Checklist de qualidade de handoff" },
479
+ { "id": "ui-fidelity", "path": "skills/ui-fidelity/SKILL.md", "description": "Auditoria estΓ©tica de UI" },
480
+ { "id": "reasoning", "path": "skills/reasoning-protocol/SKILL.md", "description": "Protocolo de raciocΓ­nio lΓ³gico" },
481
+ { "id": "llm-provider-routing", "path": "skills/llm-provider-routing/SKILL.md", "description": "Roteamento multi-LLM por papel" }
482
+ ]
483
+ }
484
484
  `,
485
485
  };
486
486
  /**
487
487
  * Gera estrutura de prompts
488
488
  */
489
489
  const promptTemplates = {
490
- 'prompts/project-prompt-base.md': `# Prompt Base do Projeto
491
-
492
- Voce e um agente de engenharia sΓͺnior neste repositorio.
493
-
494
- Prioridade de contexto:
495
- 1. memory/00-global/mission.md
496
- 2. memory/00-global/standards.md
497
- 3. memory/00-global/context-policy.md
498
- 4. memory/10-product/*
499
- 5. memory/20-architecture/*
500
- 6. memory/30-domains/<dominio>/*
501
- 7. memory/40-delivery/current-sprint.md
502
- 8. memory/90-decisions/ADR-*.md
503
- 9. memory/70-summaries/*
504
-
505
- Regras:
506
- - comunicacao em pt-BR
507
- - API em NestJS por padrao
508
- - nao contradizer ADR sem sinalizar
509
- - explicitar suposicoes
510
- - **OBRIGATΓ“RIO**: Usar a skill \`reasoning\` e preencher o bloco \`## RaciocΓ­nio Estruturado\` antes de cada resposta tΓ©cnica.
511
- - entregar: raciocΓ­nio, entendimento, plano, implementacao, validacao e proximos passos
512
- `,
513
- 'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
514
-
515
- Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
516
-
517
- Para cada subtarefa, entregue:
518
- - objetivo
519
- - escopo de escrita
520
- - criterio de pronto
521
- - risco principal
522
- - agente dono
523
-
524
- No final, consolide os handoffs em ordem cronologica.
525
- `,
526
- 'prompts/worker-task-template.md': `# Prompt Worker
527
-
528
- Voce recebeu uma subtarefa.
529
-
530
- Responda com:
531
- 1. **RaciocΓ­nio Estruturado** (Uso obrigatΓ³rio da skill \`reasoning\`)
532
- 2. Entendimento
533
- 3. Implementacao realizada
534
- 4. Arquivos alterados
535
- 5. Validacao/testes
536
- 6. Riscos e pendencias
490
+ 'prompts/project-prompt-base.md': `# Prompt Base do Projeto
491
+
492
+ Voce e um agente de engenharia sΓͺnior neste repositorio.
493
+
494
+ Prioridade de contexto:
495
+ 1. memory/00-global/mission.md
496
+ 2. memory/00-global/standards.md
497
+ 3. memory/00-global/context-policy.md
498
+ 4. memory/10-product/*
499
+ 5. memory/20-architecture/*
500
+ 6. memory/30-domains/<dominio>/*
501
+ 7. memory/40-delivery/current-sprint.md
502
+ 8. memory/90-decisions/ADR-*.md
503
+ 9. memory/70-summaries/*
504
+
505
+ Regras:
506
+ - comunicacao em pt-BR
507
+ - API em NestJS por padrao
508
+ - nao contradizer ADR sem sinalizar
509
+ - explicitar suposicoes
510
+ - **OBRIGATΓ“RIO**: Usar a skill \`reasoning\` e preencher o bloco \`## RaciocΓ­nio Estruturado\` antes de cada resposta tΓ©cnica.
511
+ - entregar: raciocΓ­nio, entendimento, plano, implementacao, validacao e proximos passos
512
+ `,
513
+ 'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
514
+
515
+ Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
516
+
517
+ Para cada subtarefa, entregue:
518
+ - objetivo
519
+ - escopo de escrita
520
+ - criterio de pronto
521
+ - risco principal
522
+ - agente dono
523
+
524
+ No final, consolide os handoffs em ordem cronologica.
525
+ `,
526
+ 'prompts/worker-task-template.md': `# Prompt Worker
527
+
528
+ Voce recebeu uma subtarefa.
529
+
530
+ Responda com:
531
+ 1. **RaciocΓ­nio Estruturado** (Uso obrigatΓ³rio da skill \`reasoning\`)
532
+ 2. Entendimento
533
+ 3. Implementacao realizada
534
+ 4. Arquivos alterados
535
+ 5. Validacao/testes
536
+ 6. Riscos e pendencias
537
537
  `,
538
538
  };
539
539
  /**
540
540
  * Gera arquivos de configuraΓ§Γ£o globais
541
541
  */
542
542
  const configTemplates = {
543
- 'AGENTS.md': `# AGENTS
544
-
545
- ## Linguagem
546
- - Sempre responder e documentar em **pt-BR**.
547
-
548
- ## Stack
549
- - API padrao do projeto: **NestJS**.
550
-
551
- ## Modo multiagente
552
- - Orquestrador decompΓ΅e tarefas
553
- - Workers executam em paralelo por ownership
554
- - Reviewer valida riscos
555
-
556
- ## Memoria
557
- - Seguir hierarchy em /memory
558
- - Registrar handoff e resumo ao fim de cada entrega relevante
559
- `,
560
- '.memoryrc.json': `{
561
- "strategy": "hierarchical",
562
- "maxContextHint": "1M+ por segmentacao e resumo incremental",
563
- "handoffDir": "memory/50-orchestration/handoffs",
564
- "summaryDir": "memory/70-summaries",
565
- "sqlitePath": ".memory/sqlite/context.db",
566
- "language": "pt-BR",
567
- "backendDefault": "nestjs"
568
- }
569
- `,
570
- '.gitignore': `node_modules
571
- dist
572
- .env
573
- .DS_Store
574
- coverage
575
- .context
543
+ 'AGENTS.md': `# AGENTS
544
+
545
+ ## Linguagem
546
+ - Sempre responder e documentar em **pt-BR**.
547
+
548
+ ## Stack
549
+ - API padrao do projeto: **NestJS**.
550
+
551
+ ## Modo multiagente
552
+ - Orquestrador decompΓ΅e tarefas
553
+ - Workers executam em paralelo por ownership
554
+ - Reviewer valida riscos
555
+
556
+ ## Memoria
557
+ - Seguir hierarchy em /memory
558
+ - Registrar handoff e resumo ao fim de cada entrega relevante
559
+ `,
560
+ '.memoryrc.json': `{
561
+ "strategy": "hierarchical",
562
+ "maxContextHint": "1M+ por segmentacao e resumo incremental",
563
+ "handoffDir": "memory/50-orchestration/handoffs",
564
+ "summaryDir": "memory/70-summaries",
565
+ "sqlitePath": ".memory/sqlite/context.db",
566
+ "language": "pt-BR",
567
+ "backendDefault": "nestjs"
568
+ }
569
+ `,
570
+ '.gitignore': `node_modules
571
+ dist
572
+ .env
573
+ .DS_Store
574
+ coverage
575
+ .context
576
576
  `,
577
577
  };
578
578
  /**
579
579
  * Gera scripts utilitΓ‘rios
580
580
  */
581
581
  const scriptTemplates = {
582
- 'scripts/build-context-pack.mjs': `import fs from 'node:fs';
583
- import path from 'node:path';
584
- import { fileURLToPath } from 'node:url';
585
-
586
- const __filename = fileURLToPath(import.meta.url);
587
- const __dirname = path.dirname(__filename);
588
- const root = path.resolve(__dirname, '..');
589
- const outputDir = path.join(root, '.context');
590
- const outFile = path.join(outputDir, 'context-pack.md');
591
-
592
- const priorityFiles = [
593
- 'memory/00-global/mission.md',
594
- 'memory/00-global/standards.md',
595
- 'memory/00-global/context-policy.md',
596
- 'memory/20-architecture/backend.md',
597
- 'memory/40-delivery/current-sprint.md',
598
- 'memory/70-summaries/global-summary.md'
599
- ];
600
-
601
- fs.mkdirSync(outputDir, { recursive: true });
602
- let content = '# Context Pack\\n\\n';
603
-
604
- for (const rel of priorityFiles) {
605
- const abs = path.join(root, rel);
606
- if (!fs.existsSync(abs)) continue;
607
- const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
608
- content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
609
- }
610
-
611
- fs.writeFileSync(outFile, content, 'utf8');
612
- console.log('Context pack gerado em: ' + outFile);
613
- `,
614
- 'scripts/append-handoff.mjs': `import fs from 'node:fs';
615
- import path from 'node:path';
616
- import { fileURLToPath } from 'node:url';
617
-
618
- const __filename = fileURLToPath(import.meta.url);
619
- const __dirname = path.dirname(__filename);
620
- const root = path.resolve(__dirname, '..');
621
-
622
- const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
623
- const dir = path.join(root, 'memory/50-orchestration/handoffs');
624
- fs.mkdirSync(dir, { recursive: true });
625
-
626
- const stamp = new Date().toISOString().replace(/[:]/g, '-');
627
- const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
628
-
629
- const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
630
- + '## Titulo\\n' + title + '\\n\\n'
631
- + '## Contexto\\n-\\n\\n'
632
- + '## Alteracoes\\n-\\n\\n'
633
- + '## Riscos\\n-\\n\\n'
634
- + '## Pendencias\\n-\\n\\n'
635
- + '## Proximo passo\\n-\\n';
636
-
637
- fs.writeFileSync(file, template, 'utf8');
638
- console.log('Handoff criado: ' + file);
639
- `,
640
- 'scripts/check-memory-maps.mjs': `import fs from 'node:fs';
641
- import path from 'node:path';
642
- import { fileURLToPath } from 'node:url';
643
-
644
- // Gate herdado do Forja (ADR-0030): os mapas de memoria (context.md) nao mentem sobre o codigo.
645
- // Self-contained, zero dependencia. Rode no CI: node scripts/check-memory-maps.mjs
646
- const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
647
- const domainsDir = path.join(root, 'memory/30-domains');
648
- const modulesDir = path.join(root, 'backend/src/modules');
649
- const BT = String.fromCharCode(96);
650
- const CODE_REF = new RegExp(BT + '([a-z][a-zA-Z0-9/._-]*/[a-zA-Z0-9/._-]*[.]ts)' + BT, 'g');
651
-
652
- function dirs(p) {
653
- try { return fs.readdirSync(p).filter((e) => fs.statSync(path.join(p, e)).isDirectory()); }
654
- catch { return []; }
655
- }
656
- function resolves(domain, ref) {
657
- const bases = [path.join(modulesDir, domain), path.join(root, 'backend'), root];
658
- return bases.some((b) => fs.existsSync(path.join(b, ref)));
659
- }
660
-
661
- let dangling = 0;
662
- const domains = dirs(domainsDir);
663
- for (const d of domains) {
664
- let src;
665
- try { src = fs.readFileSync(path.join(domainsDir, d, 'context.md'), 'utf8'); }
666
- catch { continue; }
667
- const refs = [...new Set([...src.matchAll(CODE_REF)].map((m) => m[1]))];
668
- const bad = refs.filter((r) => !resolves(d, r));
669
- if (bad.length) { dangling += bad.length; console.log('x ' + d + ': ' + bad.join(', ') + ' -- o mapa aponta, o arquivo nao existe'); }
670
- else { console.log('ok ' + d + ' -- ' + refs.length + ' referencia(s)'); }
671
- }
672
- const mapped = new Set(domains);
673
- for (const m of dirs(modulesDir)) {
674
- if (!mapped.has(m)) console.log('! modulo ' + m + ' sem context.md -- economia de token perdida');
675
- }
676
- if (dangling) {
677
- console.log('');
678
- console.log('REPROVADO -- ' + dangling + ' referencia(s) pendurada(s). Corrija o context.md ou o path.');
679
- process.exit(1);
680
- }
681
- console.log('');
682
- console.log('OK -- os mapas de memoria batem com o codigo.');
683
- `,
684
- 'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
685
- import path from 'node:path';
686
- import { fileURLToPath } from 'node:url';
687
-
688
- const __filename = fileURLToPath(import.meta.url);
689
- const __dirname = path.dirname(__filename);
690
- const root = path.resolve(__dirname, '..', '..');
691
-
692
- export function loadSkills() {
693
- const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
694
- if (!fs.existsSync(manifestPath)) return [];
695
- const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
696
- return manifest.skills;
697
- }
698
-
699
- export function getSkill(id) {
700
- const skills = loadSkills();
701
- return skills.find(s => s.id === id);
702
- }
703
- `,
704
- 'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
705
- import path from 'node:path';
706
- import { fileURLToPath } from 'node:url';
707
-
708
- const __filename = fileURLToPath(import.meta.url);
709
- const __dirname = path.dirname(__filename);
710
- const root = path.resolve(__dirname, '..');
711
- const runsDir = path.join(root, 'memory/60-runs');
712
- const archiveDir = path.join(runsDir, 'archive');
713
-
714
- const TTL_DAYS = 30;
715
- const now = Date.now();
716
-
717
- if (!fs.existsSync(runsDir)) process.exit(0);
718
- if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
719
-
720
- const entries = fs.readdirSync(runsDir, { withFileTypes: true });
721
-
722
- let archived = 0;
723
- for (const entry of entries) {
724
- if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
725
-
726
- const abs = path.join(runsDir, entry.name);
727
- const stats = fs.statSync(abs);
728
- const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
729
-
730
- if (ageDays > TTL_DAYS) {
731
- const dest = path.join(archiveDir, entry.name);
732
- fs.renameSync(abs, dest);
733
- archived++;
734
- }
735
- }
736
-
737
- if (archived > 0) {
738
- console.log('Vacuum: ' + archived + ' runs movidas para archive/');
739
- }
740
- `,
741
- 'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
742
- import { exec } from 'node:child_process';
743
- import path from 'node:path';
744
- import { fileURLToPath } from 'node:url';
745
-
746
- const __filename = fileURLToPath(import.meta.url);
747
- const __dirname = path.dirname(__filename);
748
- const root = path.resolve(__dirname, '..');
749
-
750
- const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
751
- let timeout = null;
752
-
753
- console.log('πŸ‘€ Memory Watcher iniciado...');
754
-
755
- watchDirs.forEach(dir => {
756
- const absDir = path.join(root, dir);
757
- watch(absDir, { recursive: true }, (eventType, filename) => {
758
- if (filename && filename.endsWith('.md')) {
759
- if (timeout) clearTimeout(timeout);
760
- timeout = setTimeout(() => {
761
- console.log('πŸ”„ MudanΓ§a detectada em: ' + filename + '. Sincronizando SQLite...');
762
- exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
763
- if (err) console.error('❌ Erro no sync: ' + err.message);
764
- else console.log('βœ… SQLite sincronizado.');
765
- });
766
- }, 1000);
767
- }
768
- });
769
- });
582
+ 'scripts/build-context-pack.mjs': `import fs from 'node:fs';
583
+ import path from 'node:path';
584
+ import { fileURLToPath } from 'node:url';
585
+
586
+ const __filename = fileURLToPath(import.meta.url);
587
+ const __dirname = path.dirname(__filename);
588
+ const root = path.resolve(__dirname, '..');
589
+ const outputDir = path.join(root, '.context');
590
+ const outFile = path.join(outputDir, 'context-pack.md');
591
+
592
+ const priorityFiles = [
593
+ 'memory/00-global/mission.md',
594
+ 'memory/00-global/standards.md',
595
+ 'memory/00-global/context-policy.md',
596
+ 'memory/20-architecture/backend.md',
597
+ 'memory/40-delivery/current-sprint.md',
598
+ 'memory/70-summaries/global-summary.md'
599
+ ];
600
+
601
+ fs.mkdirSync(outputDir, { recursive: true });
602
+ let content = '# Context Pack\\n\\n';
603
+
604
+ for (const rel of priorityFiles) {
605
+ const abs = path.join(root, rel);
606
+ if (!fs.existsSync(abs)) continue;
607
+ const raw = fs.readFileSync(abs, 'utf8').slice(0, 6000);
608
+ content += '## ' + rel + '\\n\\n' + raw + '\\n\\n';
609
+ }
610
+
611
+ fs.writeFileSync(outFile, content, 'utf8');
612
+ console.log('Context pack gerado em: ' + outFile);
613
+ `,
614
+ 'scripts/append-handoff.mjs': `import fs from 'node:fs';
615
+ import path from 'node:path';
616
+ import { fileURLToPath } from 'node:url';
617
+
618
+ const __filename = fileURLToPath(import.meta.url);
619
+ const __dirname = path.dirname(__filename);
620
+ const root = path.resolve(__dirname, '..');
621
+
622
+ const [from = 'agente-a', to = 'agente-b', title = 'handoff'] = process.argv.slice(2);
623
+ const dir = path.join(root, 'memory/50-orchestration/handoffs');
624
+ fs.mkdirSync(dir, { recursive: true });
625
+
626
+ const stamp = new Date().toISOString().replace(/[:]/g, '-');
627
+ const file = path.join(dir, stamp + '_' + from + '_para_' + to + '.md');
628
+
629
+ const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
630
+ + '## Titulo\\n' + title + '\\n\\n'
631
+ + '## Contexto\\n-\\n\\n'
632
+ + '## Alteracoes\\n-\\n\\n'
633
+ + '## Riscos\\n-\\n\\n'
634
+ + '## Pendencias\\n-\\n\\n'
635
+ + '## Proximo passo\\n-\\n';
636
+
637
+ fs.writeFileSync(file, template, 'utf8');
638
+ console.log('Handoff criado: ' + file);
639
+ `,
640
+ 'scripts/check-memory-maps.mjs': `import fs from 'node:fs';
641
+ import path from 'node:path';
642
+ import { fileURLToPath } from 'node:url';
643
+
644
+ // Gate herdado do Forja (ADR-0030): os mapas de memoria (context.md) nao mentem sobre o codigo.
645
+ // Self-contained, zero dependencia. Rode no CI: node scripts/check-memory-maps.mjs
646
+ const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
647
+ const domainsDir = path.join(root, 'memory/30-domains');
648
+ const modulesDir = path.join(root, 'backend/src/modules');
649
+ const BT = String.fromCharCode(96);
650
+ const CODE_REF = new RegExp(BT + '([a-z][a-zA-Z0-9/._-]*/[a-zA-Z0-9/._-]*[.]ts)' + BT, 'g');
651
+
652
+ function dirs(p) {
653
+ try { return fs.readdirSync(p).filter((e) => fs.statSync(path.join(p, e)).isDirectory()); }
654
+ catch { return []; }
655
+ }
656
+ function resolves(domain, ref) {
657
+ const bases = [path.join(modulesDir, domain), path.join(root, 'backend'), root];
658
+ return bases.some((b) => fs.existsSync(path.join(b, ref)));
659
+ }
660
+
661
+ let dangling = 0;
662
+ const domains = dirs(domainsDir);
663
+ for (const d of domains) {
664
+ let src;
665
+ try { src = fs.readFileSync(path.join(domainsDir, d, 'context.md'), 'utf8'); }
666
+ catch { continue; }
667
+ const refs = [...new Set([...src.matchAll(CODE_REF)].map((m) => m[1]))];
668
+ const bad = refs.filter((r) => !resolves(d, r));
669
+ if (bad.length) { dangling += bad.length; console.log('x ' + d + ': ' + bad.join(', ') + ' -- o mapa aponta, o arquivo nao existe'); }
670
+ else { console.log('ok ' + d + ' -- ' + refs.length + ' referencia(s)'); }
671
+ }
672
+ const mapped = new Set(domains);
673
+ for (const m of dirs(modulesDir)) {
674
+ if (!mapped.has(m)) console.log('! modulo ' + m + ' sem context.md -- economia de token perdida');
675
+ }
676
+ if (dangling) {
677
+ console.log('');
678
+ console.log('REPROVADO -- ' + dangling + ' referencia(s) pendurada(s). Corrija o context.md ou o path.');
679
+ process.exit(1);
680
+ }
681
+ console.log('');
682
+ console.log('OK -- os mapas de memoria batem com o codigo.');
683
+ `,
684
+ 'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
685
+ import path from 'node:path';
686
+ import { fileURLToPath } from 'node:url';
687
+
688
+ const __filename = fileURLToPath(import.meta.url);
689
+ const __dirname = path.dirname(__filename);
690
+ const root = path.resolve(__dirname, '..', '..');
691
+
692
+ export function loadSkills() {
693
+ const manifestPath = path.join(root, 'skills', 'MANIFEST.json');
694
+ if (!fs.existsSync(manifestPath)) return [];
695
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
696
+ return manifest.skills;
697
+ }
698
+
699
+ export function getSkill(id) {
700
+ const skills = loadSkills();
701
+ return skills.find(s => s.id === id);
702
+ }
703
+ `,
704
+ 'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
705
+ import path from 'node:path';
706
+ import { fileURLToPath } from 'node:url';
707
+
708
+ const __filename = fileURLToPath(import.meta.url);
709
+ const __dirname = path.dirname(__filename);
710
+ const root = path.resolve(__dirname, '..');
711
+ const runsDir = path.join(root, 'memory/60-runs');
712
+ const archiveDir = path.join(runsDir, 'archive');
713
+
714
+ const TTL_DAYS = 30;
715
+ const now = Date.now();
716
+
717
+ if (!fs.existsSync(runsDir)) process.exit(0);
718
+ if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
719
+
720
+ const entries = fs.readdirSync(runsDir, { withFileTypes: true });
721
+
722
+ let archived = 0;
723
+ for (const entry of entries) {
724
+ if (entry.name === 'README.md' || entry.name === 'archive' || entry.name === '.gitkeep') continue;
725
+
726
+ const abs = path.join(runsDir, entry.name);
727
+ const stats = fs.statSync(abs);
728
+ const ageDays = (now - stats.mtimeMs) / (1000 * 60 * 60 * 24);
729
+
730
+ if (ageDays > TTL_DAYS) {
731
+ const dest = path.join(archiveDir, entry.name);
732
+ fs.renameSync(abs, dest);
733
+ archived++;
734
+ }
735
+ }
736
+
737
+ if (archived > 0) {
738
+ console.log('Vacuum: ' + archived + ' runs movidas para archive/');
739
+ }
740
+ `,
741
+ 'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
742
+ import { exec } from 'node:child_process';
743
+ import path from 'node:path';
744
+ import { fileURLToPath } from 'node:url';
745
+
746
+ const __filename = fileURLToPath(import.meta.url);
747
+ const __dirname = path.dirname(__filename);
748
+ const root = path.resolve(__dirname, '..');
749
+
750
+ const watchDirs = ['memory', 'agents', 'skills', 'prompts', 'docs'];
751
+ let timeout = null;
752
+
753
+ console.log('πŸ‘€ Memory Watcher iniciado...');
754
+
755
+ watchDirs.forEach(dir => {
756
+ const absDir = path.join(root, dir);
757
+ watch(absDir, { recursive: true }, (eventType, filename) => {
758
+ if (filename && filename.endsWith('.md')) {
759
+ if (timeout) clearTimeout(timeout);
760
+ timeout = setTimeout(() => {
761
+ console.log('πŸ”„ MudanΓ§a detectada em: ' + filename + '. Sincronizando SQLite...');
762
+ exec('npm run memory:db:sync', { cwd: path.join(root, 'backend') }, (err, stdout) => {
763
+ if (err) console.error('❌ Erro no sync: ' + err.message);
764
+ else console.log('βœ… SQLite sincronizado.');
765
+ });
766
+ }, 1000);
767
+ }
768
+ });
769
+ });
770
770
  `,
771
771
  };
772
772
  /**