forjajs 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/.claude/agents/context-engineer.md +25 -25
  2. package/.claude/agents/governance.md +55 -55
  3. package/.claude/agents/marketing.md +24 -24
  4. package/.claude/agents/orchestrator.md +31 -31
  5. package/.claude/agents/product.md +26 -26
  6. package/.claude/agents/release-auditor.md +68 -59
  7. package/.claude/agents/sdd-architect.md +34 -34
  8. package/.claude/settings.json +76 -76
  9. package/.claude/skills/new-adr/SKILL.md +61 -61
  10. package/.claude/skills/new-command/SKILL.md +67 -67
  11. package/.gemini-instructions.md +87 -87
  12. package/.github/copilot-instructions.md +87 -87
  13. package/.memoryrc.json +104 -104
  14. package/.openai-instructions.md +87 -87
  15. package/AGENTS.md +134 -134
  16. package/CHANGELOG.md +566 -550
  17. package/CONTRIBUTING.md +32 -32
  18. package/DOC-MAP.md +65 -60
  19. package/LICENSE +21 -21
  20. package/README.md +358 -317
  21. package/README.pt-BR.md +345 -323
  22. package/boilerplates/01-api-rest/README.md +336 -336
  23. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -41
  24. package/boilerplates/02-saas-starter/.env.example +25 -25
  25. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -190
  26. package/boilerplates/02-saas-starter/INFO.md +252 -252
  27. package/boilerplates/02-saas-starter/QUICK_START.md +194 -194
  28. package/boilerplates/02-saas-starter/README.md +305 -305
  29. package/boilerplates/02-saas-starter/START-HERE.md +259 -259
  30. package/boilerplates/02-saas-starter/backend/package.json +87 -87
  31. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -27
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -3
  33. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -6
  34. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -23
  35. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -26
  36. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -26
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -46
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -25
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -145
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -30
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -24
  42. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -19
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -42
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -13
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -67
  46. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -52
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -36
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -16
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -13
  50. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -34
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -40
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -36
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -13
  54. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -91
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -42
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -14
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -13
  58. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -48
  59. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -28
  60. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -42
  61. package/boilerplates/02-saas-starter/docker-compose.yml +34 -34
  62. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -227
  63. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -141
  64. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -133
  65. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -45
  66. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -223
  67. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -240
  68. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -239
  69. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -195
  70. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -63
  71. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -232
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -186
  73. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -85
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -262
  75. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -137
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -176
  77. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -100
  78. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -81
  79. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -97
  80. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -57
  81. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -90
  82. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -54
  83. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -50
  84. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -185
  85. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -75
  86. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -599
  87. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -322
  88. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -463
  89. package/boilerplates/03-ecommerce-starter/README.md +465 -465
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -121
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -15
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -56
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -16
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -71
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -12
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -48
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -12
  98. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -51
  99. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -8
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -8
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -8
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -8
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -10
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -8
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -34
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -47
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -66
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -78
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -14
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -112
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -32
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -11
  113. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -31
  114. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -12
  115. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -23
  116. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -42
  117. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -128
  118. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -53
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -55
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -31
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -25
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -45
  123. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -62
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -62
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -124
  126. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -253
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -319
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -133
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -227
  130. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -210
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -233
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -210
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -168
  134. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -260
  135. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -223
  136. package/boilerplates/04-microservices-starter/.env.example +43 -43
  137. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -609
  138. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -512
  139. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -246
  140. package/boilerplates/04-microservices-starter/INDEX.md +377 -377
  141. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -456
  142. package/boilerplates/04-microservices-starter/README.md +466 -466
  143. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -386
  144. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -14
  145. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -29
  146. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -9
  147. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -45
  148. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -114
  149. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -9
  150. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -20
  151. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -14
  152. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -42
  153. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -7
  154. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -9
  155. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -130
  156. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -21
  157. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -159
  158. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -19
  159. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -18
  160. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -21
  161. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -14
  162. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -25
  163. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -7
  164. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -9
  165. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -160
  166. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -10
  167. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -92
  168. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -20
  169. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -14
  170. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -25
  171. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -7
  172. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -9
  173. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -122
  174. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -10
  175. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -161
  176. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -20
  177. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -15
  178. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -84
  179. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -12
  180. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -4
  181. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -152
  182. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -54
  183. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -20
  184. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -41
  185. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -164
  186. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -171
  187. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -89
  188. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -102
  189. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -44
  190. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -106
  191. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -76
  192. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -247
  193. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -293
  194. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -108
  195. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -333
  196. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -121
  197. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -308
  198. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -120
  199. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -216
  200. package/boilerplates/04-microservices-starter/package.json +21 -21
  201. package/boilerplates/05-monorepo-starter/.env.example +1 -1
  202. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -193
  203. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -481
  204. package/boilerplates/05-monorepo-starter/Dockerfile +35 -35
  205. package/boilerplates/05-monorepo-starter/README.md +318 -318
  206. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -43
  207. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -36
  208. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -28
  209. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -21
  210. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -44
  211. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -17
  212. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -48
  213. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -24
  214. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -39
  215. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -25
  216. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -22
  217. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -85
  218. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -66
  219. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -58
  220. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -86
  221. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -58
  222. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -81
  223. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -63
  224. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -81
  225. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -56
  226. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -99
  227. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -58
  228. package/boilerplates/05-monorepo-starter/package.json +30 -30
  229. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -15
  230. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -28
  231. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -53
  232. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -40
  233. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -32
  234. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -5
  235. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -11
  236. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -17
  237. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -13
  238. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -28
  239. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -23
  240. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -48
  241. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -51
  242. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -13
  243. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -123
  244. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -35
  245. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -28
  246. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -49
  247. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -12
  248. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -79
  249. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -24
  250. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -28
  251. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -29
  252. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -15
  253. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -78
  254. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -25
  255. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -1
  256. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -30
  257. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -39
  258. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -15
  259. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -47
  260. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -51
  261. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -19
  262. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -10
  263. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -24
  264. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -13
  265. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -34
  266. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -35
  267. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -28
  268. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -28
  269. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -15
  270. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -31
  271. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -3
  272. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -7
  273. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -7
  274. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -14
  275. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -35
  276. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -17
  277. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -18
  278. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -38
  279. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -33
  280. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -32
  281. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -41
  282. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -46
  283. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -7
  284. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -8
  285. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -30
  286. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -17
  287. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -45
  288. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -4
  289. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -3
  290. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -30
  291. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -48
  292. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -44
  293. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -8
  294. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -23
  295. package/boilerplates/05-monorepo-starter/turbo.json +35 -35
  296. package/boilerplates/06-clean-arch/README.md +48 -48
  297. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +71 -71
  298. package/boilerplates/06-clean-arch/backend/package.json +43 -43
  299. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -20
  300. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -10
  301. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -47
  302. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -28
  303. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -30
  304. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -36
  305. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -85
  306. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -17
  307. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -24
  308. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -57
  309. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -28
  310. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -31
  311. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -30
  312. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -20
  313. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -43
  314. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -11
  315. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -32
  316. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -46
  317. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -16
  318. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -43
  319. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -39
  320. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -23
  321. package/boilerplates/README.md +427 -427
  322. package/design-md/BRIEF-TEMPLATE.md +47 -47
  323. package/design-md/INDEX.md +35 -35
  324. package/design-md/MATRIX.md +24 -24
  325. package/design-md/PLAYBOOK.md +35 -35
  326. package/design-md/examples/agent-console-brief.md +48 -48
  327. package/dist/apps/dashboard/app/dashboard-client.jsx +10 -10
  328. package/dist/apps/server/src/main.d.ts +3 -2
  329. package/dist/apps/server/src/main.js +8 -6
  330. package/dist/bin/create-memory-nest-kit.js +17 -17
  331. package/dist/bin/forja.js +22 -5
  332. package/dist/bin/init-project.js +38 -38
  333. package/dist/lib/audit.js +7 -7
  334. package/dist/lib/context-builder.js +32 -32
  335. package/dist/lib/core/doc-graph.js +6 -4
  336. package/dist/lib/core/registry.d.ts +64 -0
  337. package/dist/lib/core/registry.js +65 -0
  338. package/dist/lib/core/release.d.ts +63 -0
  339. package/dist/lib/core/release.js +5 -1
  340. package/dist/lib/generators/memory-generator.js +700 -698
  341. package/dist/lib/generators/nest-generator.js +398 -398
  342. package/dist/lib/generators/readme-generator.js +180 -180
  343. package/dist/lib/governance-report.js +39 -39
  344. package/dist/lib/project-upgrade.js +1 -1
  345. package/dist/lib/workspace.d.ts +7 -0
  346. package/dist/lib/workspace.js +63 -34
  347. package/dist/packages/adapter-git/src/index.d.ts +2 -0
  348. package/dist/packages/adapter-git/src/index.js +22 -1
  349. package/dist/packages/adapter-sqlite/src/index.js +12 -12
  350. package/dist/packages/contracts/src/index.d.ts +1 -1
  351. package/dist/packages/llm/src/index.d.ts +43 -0
  352. package/dist/packages/llm/src/index.js +108 -0
  353. package/dist/packages/plugin-docker/src/index.d.ts +3 -0
  354. package/dist/packages/plugin-docker/src/index.js +13 -0
  355. package/dist/packages/plugin-github/src/index.d.ts +3 -0
  356. package/dist/packages/plugin-github/src/index.js +13 -0
  357. package/dist/packages/sandbox/src/index.d.ts +2 -0
  358. package/dist/packages/sandbox/src/index.js +10 -0
  359. package/dist/scripts/agent-harness.js +66 -64
  360. package/dist/scripts/agent-router.js +20 -20
  361. package/dist/scripts/build-smart-context.js +22 -22
  362. package/dist/scripts/compress-memory.js +8 -8
  363. package/dist/scripts/context-benchmark.d.ts +2 -0
  364. package/dist/scripts/context-benchmark.js +39 -0
  365. package/dist/scripts/context-ops.js +29 -29
  366. package/dist/scripts/demo-autonomy.d.ts +15 -0
  367. package/dist/scripts/demo-autonomy.js +200 -0
  368. package/dist/scripts/demo-workspace.d.ts +6 -0
  369. package/dist/scripts/demo-workspace.js +101 -0
  370. package/dist/scripts/dev.js +13 -13
  371. package/dist/scripts/extract-global-knowledge.js +5 -5
  372. package/dist/scripts/generate-dashboard.js +11 -11
  373. package/dist/scripts/llm-fit.d.ts +1 -0
  374. package/dist/scripts/llm-fit.js +131 -0
  375. package/dist/scripts/memory-schema.js +48 -48
  376. package/dist/scripts/query-universal-memory.js +13 -13
  377. package/dist/scripts/sprint-manager.js +39 -39
  378. package/dist/scripts/sync-universal-memory.js +63 -50
  379. package/docs/2x/CLI-CAPABILITIES.md +35 -35
  380. package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -132
  381. package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -53
  382. package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -54
  383. package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -38
  384. package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
  385. package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
  386. package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
  387. package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
  388. package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
  389. package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -39
  390. package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -42
  391. package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -35
  392. package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -31
  393. package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -55
  394. package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -60
  395. package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -64
  396. package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -51
  397. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -63
  398. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -136
  399. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -279
  400. package/docs/agent-harnesses.md +149 -149
  401. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -109
  402. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -273
  403. package/docs/archive/CHECKLIST-FINAL.md +295 -295
  404. package/docs/archive/FASE2-SUMMARY.md +263 -263
  405. package/docs/archive/FASE3-PROGRESS.md +355 -355
  406. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -476
  407. package/docs/archive/INDICE-MASTER.md +282 -282
  408. package/docs/archive/PROJETO-COMPLETO.md +363 -363
  409. package/docs/archive/README-REFINAMENTO.md +293 -293
  410. package/docs/archive/REFERENCIA-RAPIDA.md +324 -324
  411. package/docs/archive/REFINAMENTO-v1.0.md +565 -565
  412. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -223
  413. package/docs/archive/START-HERE.md +319 -319
  414. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -268
  415. package/docs/archive/examples/v1/AGENTS.md +10 -10
  416. package/docs/archive/examples/v1/README.md +36 -36
  417. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -9
  418. package/docs/archive/examples/v1/backend/nest-cli.json +4 -4
  419. package/docs/archive/examples/v1/backend/package.json +42 -42
  420. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -12
  421. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -10
  422. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -8
  423. package/docs/archive/examples/v1/backend/src/main.ts +10 -10
  424. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -24
  425. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -4
  426. package/docs/archive/examples/v1/backend/tsconfig.json +17 -17
  427. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -5
  428. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -9
  429. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -12
  430. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -10
  431. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -3
  432. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -6
  433. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -3
  434. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -3
  435. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -10
  436. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -3
  437. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -3
  438. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -5
  439. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -6
  440. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -3
  441. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -3
  442. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -3
  443. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -3
  444. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -3
  445. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -3
  446. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -3
  447. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -3
  448. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -10
  449. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -3
  450. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -9
  451. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -19
  452. package/docs/archive/examples/v2/.memoryrc.json +8 -8
  453. package/docs/archive/examples/v2/AGENTS.md +16 -16
  454. package/docs/archive/examples/v2/README.md +35 -35
  455. package/docs/archive/examples/v2/agents/README.md +3 -3
  456. package/docs/archive/examples/v2/agents/backend-nest.md +9 -9
  457. package/docs/archive/examples/v2/agents/dba.md +4 -4
  458. package/docs/archive/examples/v2/agents/frontend.md +4 -4
  459. package/docs/archive/examples/v2/agents/orchestrator.md +9 -9
  460. package/docs/archive/examples/v2/agents/reviewer.md +6 -6
  461. package/docs/archive/examples/v2/agents/security.md +4 -4
  462. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -9
  463. package/docs/archive/examples/v2/backend/nest-cli.json +4 -4
  464. package/docs/archive/examples/v2/backend/package.json +42 -42
  465. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -12
  466. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -10
  467. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -8
  468. package/docs/archive/examples/v2/backend/src/main.ts +10 -10
  469. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -24
  470. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -4
  471. package/docs/archive/examples/v2/backend/tsconfig.json +17 -17
  472. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -15
  473. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -12
  474. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -14
  475. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -9
  476. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -12
  477. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -3
  478. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -6
  479. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -3
  480. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -3
  481. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -10
  482. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -3
  483. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -3
  484. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -5
  485. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -6
  486. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -3
  487. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -3
  488. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -3
  489. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -3
  490. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -3
  491. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -3
  492. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -3
  493. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -3
  494. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -10
  495. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -3
  496. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -8
  497. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -19
  498. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -4
  499. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -9
  500. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -10
  501. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -15
  502. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -3
  503. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -3
  504. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -6
  505. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -9
  506. package/docs/archive/examples/v2/memory/README.md +8 -8
  507. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -12
  508. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -21
  509. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -10
  510. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -25
  511. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -31
  512. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -9
  513. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -8
  514. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -7
  515. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -10
  516. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -1486
  517. package/docs/capacidades-externas.md +86 -86
  518. package/docs/cli-first-operacao.md +74 -74
  519. package/docs/dev-workflow.md +421 -421
  520. package/docs/examples.md +546 -546
  521. package/docs/fluxo.md +103 -103
  522. package/docs/glossary.md +453 -453
  523. package/docs/init-project.md +457 -457
  524. package/docs/llm-fit-loop.md +41 -0
  525. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -1014
  526. package/docs/modos-de-operacao.md +52 -0
  527. package/docs/personas/architect/README.md +333 -333
  528. package/docs/personas/developer/README.md +371 -371
  529. package/docs/personas/executive/README.md +172 -172
  530. package/docs/personas/qa/README.md +350 -350
  531. package/docs/processo-projeto.md +138 -138
  532. package/docs/produto/factsheet-marketing.md +151 -0
  533. package/docs/produto/roteiro-demo.md +47 -0
  534. package/docs/publishing.md +377 -377
  535. package/docs/quick-reference.md +409 -409
  536. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -95
  537. package/docs/structure.md +360 -360
  538. package/docs/token-optimization.md +502 -502
  539. package/docs/vision/FORJA-2.0-VISION.md +72 -72
  540. package/memory/00-global/mission.md +15 -15
  541. package/memory/00-global/shared-knowledge.md +8 -8
  542. package/memory/00-global/standards.md +47 -47
  543. package/memory/10-product/personas.md +21 -21
  544. package/memory/10-product/vision.md +27 -27
  545. package/memory/30-projects/README.md +15 -15
  546. package/memory/40-delivery/backlog.md +15 -15
  547. package/memory/40-delivery/current-sprint.md +23 -26
  548. package/memory/50-orchestration/gsd-harness.md +55 -55
  549. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -15
  550. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -22
  551. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -16
  552. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -28
  553. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -15
  554. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -22
  555. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -16
  556. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -16
  557. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -21
  558. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -28
  559. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -22
  560. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -27
  561. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -21
  562. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -16
  563. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -14
  564. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -23
  565. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -15
  566. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -21
  567. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -27
  568. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -21
  569. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -23
  570. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -23
  571. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -24
  572. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -23
  573. package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -41
  574. package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -23
  575. package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -22
  576. package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
  577. package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -30
  578. package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -29
  579. package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -29
  580. package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -22
  581. package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -25
  582. package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -23
  583. package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -23
  584. package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -21
  585. package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
  586. package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
  587. package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
  588. package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
  589. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -38
  590. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -25
  591. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -31
  592. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -27
  593. package/memory/90-decisions/0005-handoff-7-campos.md +32 -32
  594. package/memory/90-decisions/0006-docs-por-persona.md +23 -23
  595. package/memory/90-decisions/0007-sdd-pipeline.md +33 -33
  596. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -36
  597. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -43
  598. package/memory/90-decisions/0010-banco-postgres.md +30 -30
  599. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -19
  600. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -64
  601. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -40
  602. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -46
  603. package/memory/90-decisions/0019-workspace-separado.md +45 -45
  604. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -45
  605. package/memory/90-decisions/0021-guardrails-de-harness.md +111 -111
  606. package/memory/90-decisions/0022-congelar-dashboard-web.md +101 -101
  607. package/memory/90-decisions/0023-doctor-como-gate-do-nucleo.md +114 -114
  608. package/memory/90-decisions/0024-gate-do-tarball.md +103 -103
  609. package/memory/90-decisions/0025-coerencia-da-documentacao.md +105 -105
  610. package/memory/90-decisions/0026-migracao-typescript-runtime-duplo.md +66 -66
  611. package/memory/90-decisions/0027-clean-arch-calibrada.md +127 -127
  612. package/memory/90-decisions/0028-governanca-visivel.md +84 -84
  613. package/memory/90-decisions/0029-gate-do-projeto-gerado.md +59 -59
  614. package/memory/90-decisions/0030-projeto-gerado-herda-os-gates.md +53 -53
  615. package/memory/90-decisions/0031-motor-de-orquestracao.md +55 -55
  616. package/memory/90-decisions/0032-superficies-do-projeto-usam-cwd.md +63 -63
  617. package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -64
  618. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -29
  619. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -23
  620. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -30
  621. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -28
  622. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -28
  623. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -31
  624. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -32
  625. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -32
  626. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -29
  627. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -16
  628. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -19
  629. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -19
  630. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -18
  631. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -19
  632. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -18
  633. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -18
  634. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -18
  635. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -18
  636. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -15
  637. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -16
  638. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -15
  639. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -16
  640. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -16
  641. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -15
  642. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -15
  643. package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -17
  644. package/memory/90-decisions/0060-runtime-persistence-port.md +17 -17
  645. package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -16
  646. package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -17
  647. package/memory/90-decisions/0063-events-persistent-e2e.md +19 -19
  648. package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -20
  649. package/memory/90-decisions/0065-context-graph-source-cache.md +20 -20
  650. package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -16
  651. package/memory/90-decisions/0067-graph-sync-capability.md +17 -17
  652. package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -17
  653. package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
  654. package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
  655. package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
  656. package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
  657. package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
  658. package/memory/90-decisions/0074-llm-fit-loop-cli-adapters.md +51 -0
  659. package/memory/90-decisions/0075-workspace-demo-isolado.md +43 -0
  660. package/memory/90-decisions/0076-modos-embedded-e-studio.md +43 -0
  661. package/memory/90-decisions/_template.md +28 -28
  662. package/package.json +157 -140
  663. package/prompts/context-engineer-agent.md +19 -19
  664. package/prompts/governance-agent.md +16 -16
  665. package/prompts/marketing-agent.md +13 -13
  666. package/prompts/orchestrator-agent.md +18 -18
  667. package/prompts/product-agent.md +13 -13
  668. package/prompts/sdd-architect-agent.md +20 -20
  669. package/specs/README.md +70 -70
  670. package/specs/_templates/plan.md +43 -43
  671. package/specs/_templates/spec.md +43 -43
  672. package/specs/_templates/tasks.md +32 -32
  673. package/specs/clean-arch-boilerplate/plan.md +137 -137
  674. package/specs/clean-arch-boilerplate/spec.md +121 -121
  675. package/specs/clean-arch-boilerplate/tasks.md +70 -70
  676. package/specs/cli-first-operacao/plan.md +53 -53
  677. package/specs/cli-first-operacao/spec.md +53 -53
  678. package/specs/cli-first-operacao/tasks.md +53 -53
  679. package/specs/code-context/spec.md +56 -56
  680. package/specs/coerencia-do-sistema/plan.md +155 -155
  681. package/specs/coerencia-do-sistema/spec.md +123 -123
  682. package/specs/coerencia-do-sistema/tasks.md +115 -115
  683. package/specs/dev-token-assets-db/plan.md +71 -71
  684. package/specs/dev-token-assets-db/spec.md +58 -58
  685. package/specs/dev-token-assets-db/tasks.md +58 -58
  686. package/specs/doctor-do-nucleo/plan.md +165 -165
  687. package/specs/doctor-do-nucleo/spec.md +139 -139
  688. package/specs/doctor-do-nucleo/tasks.md +172 -172
  689. package/specs/forja-core/spec.md +71 -71
  690. package/specs/gates/spec.md +63 -63
  691. package/specs/governanca-visivel/plan.md +122 -122
  692. package/specs/governanca-visivel/spec.md +112 -112
  693. package/specs/governanca-visivel/tasks.md +60 -60
  694. package/specs/harness-codegraph/spec.md +71 -71
  695. package/specs/memory-audit/spec.md +54 -54
  696. package/specs/orchestrate/spec.md +108 -108
  697. package/specs/orchestration-coherent/spec.md +95 -95
  698. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -61
  699. package/specs/project-smoke/spec.md +96 -96
  700. package/specs/project-upgrade/spec.md +58 -58
  701. package/specs/reestruturacao-forja-v2/plan.md +95 -95
  702. package/specs/reestruturacao-forja-v2/spec.md +74 -74
  703. package/specs/reestruturacao-forja-v2/tasks.md +113 -113
  704. package/specs/release-auditor-health/plan.md +88 -0
  705. package/specs/release-auditor-health/spec.md +82 -0
  706. package/specs/release-auditor-health/tasks.md +72 -0
  707. package/specs/release-gate/plan.md +174 -174
  708. package/specs/release-gate/spec.md +122 -122
  709. package/specs/release-gate/tasks.md +183 -183
  710. package/specs/ts-migration/plan.md +200 -200
  711. package/specs/ts-migration/spec.md +119 -119
  712. package/specs/ts-migration/tasks.md +110 -110
@@ -1,47 +1,47 @@
1
- # Design Brief
2
-
3
- - **Feature/superficie**: <ex: dashboard operacional, agent console, docs>
4
- - **Persona principal**: <quem usa e em que contexto>
5
- - **Objetivo da UI**: <decisao/acao que a tela precisa facilitar>
6
- - **Referencia primaria**: <marca/pasta em design-md + motivo>
7
- - **Referencias secundarias**: <opcional>
8
- - **Densidade**: baixa | media | alta
9
- - **Tom visual**: utilitario | premium | editorial | tecnico | colaborativo
10
-
11
- ## Principios aplicados
12
-
13
- - <principio 1 vindo da referencia>
14
- - <principio 2>
15
- - <principio 3>
16
-
17
- ## Tokens visuais
18
-
19
- - **Cores**: <paleta funcional, nao apenas estetica>
20
- - **Tipografia**: <escala, peso, uso em headings/body/labels>
21
- - **Espacamento**: <ritmo e grid>
22
- - **Raios/bordas/sombras**: <restricoes>
23
- - **Iconografia**: <familia e regras de uso>
24
-
25
- ## Componentes esperados
26
-
27
- - <componente 1>
28
- - <componente 2>
29
- - <componente 3>
30
-
31
- ## Estados obrigatorios
32
-
33
- - [ ] Carregando
34
- - [ ] Vazio
35
- - [ ] Erro
36
- - [ ] Sucesso
37
- - [ ] Permissao/sem acesso, se aplicavel
38
- - [ ] Responsivo mobile, se aplicavel
39
-
40
- ## Criterios de aceite visual
41
-
42
- - [ ] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
43
- - [ ] Texto nao quebra nem sobrepoe em mobile e desktop.
44
- - [ ] A hierarquia deixa clara a proxima acao do usuario.
45
- - [ ] Estados obrigatorios existem e sao coerentes.
46
- - [ ] A UI pode ser validada por screenshot ou checklist objetivo.
47
-
1
+ # Design Brief
2
+
3
+ - **Feature/superficie**: <ex: dashboard operacional, agent console, docs>
4
+ - **Persona principal**: <quem usa e em que contexto>
5
+ - **Objetivo da UI**: <decisao/acao que a tela precisa facilitar>
6
+ - **Referencia primaria**: <marca/pasta em design-md + motivo>
7
+ - **Referencias secundarias**: <opcional>
8
+ - **Densidade**: baixa | media | alta
9
+ - **Tom visual**: utilitario | premium | editorial | tecnico | colaborativo
10
+
11
+ ## Principios aplicados
12
+
13
+ - <principio 1 vindo da referencia>
14
+ - <principio 2>
15
+ - <principio 3>
16
+
17
+ ## Tokens visuais
18
+
19
+ - **Cores**: <paleta funcional, nao apenas estetica>
20
+ - **Tipografia**: <escala, peso, uso em headings/body/labels>
21
+ - **Espacamento**: <ritmo e grid>
22
+ - **Raios/bordas/sombras**: <restricoes>
23
+ - **Iconografia**: <familia e regras de uso>
24
+
25
+ ## Componentes esperados
26
+
27
+ - <componente 1>
28
+ - <componente 2>
29
+ - <componente 3>
30
+
31
+ ## Estados obrigatorios
32
+
33
+ - [ ] Carregando
34
+ - [ ] Vazio
35
+ - [ ] Erro
36
+ - [ ] Sucesso
37
+ - [ ] Permissao/sem acesso, se aplicavel
38
+ - [ ] Responsivo mobile, se aplicavel
39
+
40
+ ## Criterios de aceite visual
41
+
42
+ - [ ] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
43
+ - [ ] Texto nao quebra nem sobrepoe em mobile e desktop.
44
+ - [ ] A hierarquia deixa clara a proxima acao do usuario.
45
+ - [ ] Estados obrigatorios existem e sao coerentes.
46
+ - [ ] A UI pode ser validada por screenshot ou checklist objetivo.
47
+
@@ -1,35 +1,35 @@
1
- # Biblioteca de Design (design-md)
2
-
3
- Camada operacional de design do fluxo GSD: garante que toda feature com impacto
4
- visual passe por **referência escolhida → brief preenchido → gate validado**,
5
- em vez de "faz uma UI aí".
6
-
7
- ## Como funciona
8
-
9
- 1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
10
- superfícies (agent console, dashboard, docs, landing…) para nomes de
11
- referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
12
- compartilhado** entre agentes — apontam para produtos publicamente
13
- conhecidos, não para cópias locais.
14
- 2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
15
- para features com impacto visual (9 campos, incluindo estados e critérios
16
- de aceite visual).
17
- 3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
18
- incompleto; `gsd:check` puxa esse gate quando há brief.
19
-
20
- ```bash
21
- npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
22
- npm run design:check -- <caminho-do-brief.md> # gate de completude
23
- ```
24
-
25
- Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
26
- Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
27
-
28
- ## Cache local de referências (opcional)
29
-
30
- Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
31
- mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
32
- O harness degrada graciosamente sem eles: `design:select` indica "sem cache
33
- local" e o agente usa o conhecimento público da referência.
34
-
35
- > Nunca copie identidade visual proprietária — referência é direção, não clone.
1
+ # Biblioteca de Design (design-md)
2
+
3
+ Camada operacional de design do fluxo GSD: garante que toda feature com impacto
4
+ visual passe por **referência escolhida → brief preenchido → gate validado**,
5
+ em vez de "faz uma UI aí".
6
+
7
+ ## Como funciona
8
+
9
+ 1. **Escolha a referência** por superfície: [MATRIX.md](./MATRIX.md) mapeia
10
+ superfícies (agent console, dashboard, docs, landing…) para nomes de
11
+ referência (`linear.app`, `stripe`, `vercel`…). Os nomes são **vocabulário
12
+ compartilhado** entre agentes — apontam para produtos publicamente
13
+ conhecidos, não para cópias locais.
14
+ 2. **Preencha o brief**: [BRIEF-TEMPLATE.md](./BRIEF-TEMPLATE.md) é obrigatório
15
+ para features com impacto visual (9 campos, incluindo estados e critérios
16
+ de aceite visual).
17
+ 3. **Valide antes do handoff**: `forja design:check <brief.md>` reprova brief
18
+ incompleto; `gsd:check` puxa esse gate quando há brief.
19
+
20
+ ```bash
21
+ npm run design:select -- agent-console tecnico # sugere referências pela MATRIX
22
+ npm run design:check -- <caminho-do-brief.md> # gate de completude
23
+ ```
24
+
25
+ Regras de uso por agentes e checklist de handoff visual: [PLAYBOOK.md](./PLAYBOOK.md).
26
+ Exemplo de brief preenchido: [examples/agent-console-brief.md](./examples/agent-console-brief.md).
27
+
28
+ ## Cache local de referências (opcional)
29
+
30
+ Detalhes de cada sistema de design (tokens, componentes, padrões) podem ser
31
+ mantidos como cache local em `design-md/<nome>/README.md` + `design.manifest.json`.
32
+ O harness degrada graciosamente sem eles: `design:select` indica "sem cache
33
+ local" e o agente usa o conhecimento público da referência.
34
+
35
+ > Nunca copie identidade visual proprietária — referência é direção, não clone.
@@ -1,24 +1,24 @@
1
- # Matriz de Referencias design-md
2
-
3
- Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
4
-
5
- | Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
6
- |---|---|---|---|
7
- | Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
8
- | Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
9
- | Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
10
- | SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
11
- | Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
12
- | Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
13
- | IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
14
- | Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
15
- | Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
16
- | Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
17
-
18
- ## Heuristica rapida
19
-
20
- - Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
21
- - Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
22
- - Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
23
- - Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
24
-
1
+ # Matriz de Referencias design-md
2
+
3
+ Use esta matriz para escolher referencias por tipo de superficie. Ela nao substitui o julgamento do designer/agente; ela reduz escolhas aleatorias.
4
+
5
+ | Superficie | Primarias recomendadas | Secundarias uteis | Evitar |
6
+ |---|---|---|---|
7
+ | Agent console / ops | linear.app, cursor, raycast | sentry, posthog, claude | visual de landing ou excesso decorativo |
8
+ | Dashboard executivo | stripe, linear.app, posthog | airbnb, sentry, supabase | cards gigantes sem densidade informacional |
9
+ | Docs / developer portal | mintlify, stripe, vercel | resend, supabase, hashicorp | layouts promocionais que escondem exemplos |
10
+ | SaaS operacional / CRM | linear.app, intercom, airtable | clay, notion, zapier | paleta de uma cor so e baixa densidade |
11
+ | Landing de produto tecnico | vercel, stripe, resend | cursor, x.ai, cohere | hero abstrato sem produto real |
12
+ | Ferramenta colaborativa | figma, miro, notion | cal, airtable, intercom | navegacao escondida ou comandos ambiguos |
13
+ | IA / agent workflow | claude, cursor, x.ai | mistral.ai, together.ai, cohere | magia visual sem rastreabilidade de execucao |
14
+ | Fintech / trust | wise, revolut, coinbase | stripe, kraken | linguagem visual agressiva sem confianca |
15
+ | Premium / marca forte | apple, bmw, ferrari | tesla, lamborghini, spacex | copiar identidade visual proprietaria |
16
+ | Observabilidade / incidentes | sentry, posthog, datadog-style local se existir | linear.app, stripe | esconder erros em UI decorativa |
17
+
18
+ ## Heuristica rapida
19
+
20
+ - Se a tela sera usada muitas vezes por dia, escolha referencias de produtividade: `linear.app`, `raycast`, `cursor`.
21
+ - Se a tela precisa ensinar ou vender uma API, escolha docs/devtools: `mintlify`, `stripe`, `vercel`.
22
+ - Se a tela precisa passar confianca, escolha sistemas com clareza financeira/operacional: `wise`, `stripe`, `sentry`.
23
+ - Se a tela e para agentes, sempre inclua rastreabilidade: fila, status, logs, handoffs e criterio de aceite visivel.
24
+
@@ -1,35 +1,35 @@
1
- # Design Playbook para Agentes
2
-
3
- Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
4
-
5
- ## Quando usar
6
-
7
- - Antes de criar uma tela nova, componente critico, dashboard ou landing.
8
- - Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
9
- - Antes de merge/release, quando Governance precisa auditar fidelidade visual.
10
-
11
- ## Fluxo minimo
12
-
13
- 1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
14
- 2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
15
- 3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
16
- 4. Anexe o brief ao handoff de implementacao.
17
- 5. Governance valida com `npm run design:check -- <brief.md>`.
18
-
19
- ## Regras para agentes
20
-
21
- - Nunca copie marca, logo, texto proprietario ou identidade visual completa.
22
- - Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
23
- - Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
24
- - Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
25
- - Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
26
-
27
- ## Checklist de handoff visual
28
-
29
- - Superficie e persona estao definidos.
30
- - Referencia primaria tem justificativa clara.
31
- - Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
32
- - Componentes esperados foram listados.
33
- - Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
34
- - Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
35
-
1
+ # Design Playbook para Agentes
2
+
3
+ Este playbook transforma `design-md/` em entrada operacional para Product, Frontend, SDD Architect e Governance. A pasta de marcas continua sendo biblioteca de referencia; este arquivo define como escolher, aplicar e auditar uma direcao visual sem depender de memoria solta.
4
+
5
+ ## Quando usar
6
+
7
+ - Antes de criar uma tela nova, componente critico, dashboard ou landing.
8
+ - Durante `spec.md`, quando a experiencia visual influencia conversao, confianca ou produtividade.
9
+ - Antes de merge/release, quando Governance precisa auditar fidelidade visual.
10
+
11
+ ## Fluxo minimo
12
+
13
+ 1. Defina a superficie: `dashboard`, `docs`, `landing`, `tool`, `mobile`, `checkout`, `agent-console`.
14
+ 2. Escolha 1 referencia primaria e ate 2 secundarias em `MATRIX.md`.
15
+ 3. Preencha `BRIEF-TEMPLATE.md` para o contexto da feature.
16
+ 4. Anexe o brief ao handoff de implementacao.
17
+ 5. Governance valida com `npm run design:check -- <brief.md>`.
18
+
19
+ ## Regras para agentes
20
+
21
+ - Nunca copie marca, logo, texto proprietario ou identidade visual completa.
22
+ - Use referencias como principios: densidade, ritmo, hierarquia, tom, navegacao, estados e padroes de interacao.
23
+ - Para SaaS, CRM, ops e dashboards: priorize legibilidade, densidade organizada e estados claros.
24
+ - Para landing: a primeira dobra deve comunicar objeto/oferta real, nao apenas estilo abstrato.
25
+ - Para ferramentas de agente: prefira affordances explicitas, logs verificaveis, controles previsiveis e feedback de estado.
26
+
27
+ ## Checklist de handoff visual
28
+
29
+ - Superficie e persona estao definidos.
30
+ - Referencia primaria tem justificativa clara.
31
+ - Tokens visuais foram definidos: cor, tipografia, raio, espacamento, densidade.
32
+ - Componentes esperados foram listados.
33
+ - Estados obrigatorios foram listados: vazio, carregando, erro, sucesso, permissao negada quando aplicavel.
34
+ - Criterios de aceite visual sao verificaveis por screenshot ou revisao objetiva.
35
+
@@ -1,48 +1,48 @@
1
- # Design Brief
2
-
3
- - **Feature/superficie**: agent console operacional
4
- - **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
5
- - **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
6
- - **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
7
- - **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
8
- - **Densidade**: alta
9
- - **Tom visual**: tecnico
10
-
11
- ## Principios aplicados
12
-
13
- - Navegacao lateral previsivel com conteudo principal orientado a tarefas.
14
- - Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
15
- - Cada item acionavel mostra dono, criterio de aceite e proximo passo.
16
-
17
- ## Tokens visuais
18
-
19
- - **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
20
- - **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
21
- - **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
22
- - **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
23
- - **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
24
-
25
- ## Componentes esperados
26
-
27
- - Lista de handoffs com status e filtros.
28
- - Painel de detalhe com os 7 campos do ADR-0005.
29
- - Log de eventos e comandos sugeridos.
30
- - Indicadores de saude de contexto, design e spec.
31
-
32
- ## Estados obrigatorios
33
-
34
- - [x] Carregando
35
- - [x] Vazio
36
- - [x] Erro
37
- - [x] Sucesso
38
- - [x] Permissao/sem acesso, se aplicavel
39
- - [x] Responsivo mobile, se aplicavel
40
-
41
- ## Criterios de aceite visual
42
-
43
- - [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
44
- - [x] Texto nao quebra nem sobrepoe em mobile e desktop.
45
- - [x] A hierarquia deixa clara a proxima acao do usuario.
46
- - [x] Estados obrigatorios existem e sao coerentes.
47
- - [x] A UI pode ser validada por screenshot ou checklist objetivo.
48
-
1
+ # Design Brief
2
+
3
+ - **Feature/superficie**: agent console operacional
4
+ - **Persona principal**: desenvolvedor ou coordenador que acompanha handoffs, contexto e status de agentes durante uma sprint.
5
+ - **Objetivo da UI**: reduzir ambiguidade operacional mostrando fila, dono, aceite, status e proximo comando verificavel.
6
+ - **Referencia primaria**: linear.app, pela densidade organizada, hierarquia clara e foco em produtividade diaria.
7
+ - **Referencias secundarias**: cursor para contexto de IA; sentry para tratamento de estados e incidentes.
8
+ - **Densidade**: alta
9
+ - **Tom visual**: tecnico
10
+
11
+ ## Principios aplicados
12
+
13
+ - Navegacao lateral previsivel com conteudo principal orientado a tarefas.
14
+ - Estados de trabalho sempre visiveis: aberto, em andamento, bloqueado, concluido.
15
+ - Cada item acionavel mostra dono, criterio de aceite e proximo passo.
16
+
17
+ ## Tokens visuais
18
+
19
+ - **Cores**: neutros claros para fundo, texto de alto contraste, acentos funcionais para status.
20
+ - **Tipografia**: escala compacta, labels menores, headings restritos ao contexto da tela.
21
+ - **Espacamento**: grid de 8px, alta densidade sem sobreposicao.
22
+ - **Raios/bordas/sombras**: raio ate 8px, bordas sutis, sombras apenas para overlays.
23
+ - **Iconografia**: lucide ou equivalente, sempre com tooltip para acoes ambiguas.
24
+
25
+ ## Componentes esperados
26
+
27
+ - Lista de handoffs com status e filtros.
28
+ - Painel de detalhe com os 7 campos do ADR-0005.
29
+ - Log de eventos e comandos sugeridos.
30
+ - Indicadores de saude de contexto, design e spec.
31
+
32
+ ## Estados obrigatorios
33
+
34
+ - [x] Carregando
35
+ - [x] Vazio
36
+ - [x] Erro
37
+ - [x] Sucesso
38
+ - [x] Permissao/sem acesso, se aplicavel
39
+ - [x] Responsivo mobile, se aplicavel
40
+
41
+ ## Criterios de aceite visual
42
+
43
+ - [x] A referencia primaria e reconhecivel pelos principios, sem copia literal de marca.
44
+ - [x] Texto nao quebra nem sobrepoe em mobile e desktop.
45
+ - [x] A hierarquia deixa clara a proxima acao do usuario.
46
+ - [x] Estados obrigatorios existem e sao coerentes.
47
+ - [x] A UI pode ser validada por screenshot ou checklist objetivo.
48
+
@@ -39,16 +39,16 @@ export default function DashboardClient() {
39
39
  }
40
40
  }
41
41
  const metrics = snapshot.data?.metrics;
42
- return <>
43
- <header className="header"><div><p className="eyebrow">FORJAJS 2.0</p><h1>Control Plane</h1><p className="muted">Autonomia supervisionada, evidência e execução auditável.</p></div><button onClick={() => void snapshot.refetch()} disabled={snapshot.isFetching}>{snapshot.isFetching ? 'Atualizando…' : 'Atualizar'}</button></header>
44
- {(error !== undefined || snapshot.error !== null) && <div className="alert" role="alert">{error ?? 'Control Plane indisponível'}</div>}
45
- <section className="grid" aria-label="Métricas operacionais"><Metric label="Execuções" value={metrics?.runCount ?? 0}/><Metric label="Taxa de sucesso" value={`${((metrics?.successRate ?? 0) * 100).toFixed(1)}%`}/><Metric label="Tokens de entrada" value={metrics?.totalInputTokens ?? 0}/><Metric label="Observações" value={metrics?.observationCount ?? 0}/></section>
46
- <section className="panel"><div className="panel-title"><h2>GraphLoop</h2><span className="muted">nós com origem no backend</span></div><div className="graph-controls"><input aria-label="ID do nó de impacto" value={impactOrigin} onChange={(event) => setImpactOrigin(event.target.value)} placeholder="ID do nó para impacto"/><button onClick={() => void impact.refetch()} disabled={impactOrigin.trim().length === 0}>Calcular impacto</button></div><div className="graph-grid">{snapshot.data?.graphNodes.slice(0, 12).map((node) => <span key={node.id} className="node"><strong>{node.label}</strong><small>{node.type} · {node.status}</small></span>)}</div>{impact.data !== undefined && <pre className="impact">{JSON.stringify(impact.data, null, 2)}</pre>}</section>
47
- <section className="panel"><div className="panel-title"><h2>Approvals</h2><span className="muted">identidade configurada no servidor</span></div>{snapshot.data?.approvals.length === 0 && <p className="muted">Nenhuma aprovação registrada.</p>}<ul className="events">{snapshot.data?.approvals.map((approval) => <li key={approval.id}><span className="dot"/><span><strong>{approval.decision ?? 'pending'}</strong> · {approval.action}<small>{approval.impact}</small></span>{approval.decision === undefined && <span className="actions"><button onClick={() => void decideApproval(approval.id, 'approved')}>Aprovar</button><button onClick={() => void decideApproval(approval.id, 'rejected')}>Rejeitar</button></span>}</li>)}</ul></section>
48
- <section className="panel"><div className="panel-title"><h2>Atividade recente</h2><span className="muted">{snapshot.isFetching ? 'sincronizando' : 'estado remoto'}</span></div>
49
- {snapshot.data?.observations.length === 0 && <p className="muted">Nenhuma observação registrada.</p>}
50
- <ul className="events">{snapshot.data?.observations.slice(-8).reverse().map((observation) => <li key={observation.id}><span className={`dot ${observation.outcome}`}/><span><strong>{observation.outcome}</strong> · {observation.capabilityId ?? 'operação do Control Plane'}<small>{observation.traceId}</small></span>{observation.runId !== undefined && <span className="actions"><button onClick={() => void execute(`/executions/${observation.runId}/pause`)}>Pausar</button><button onClick={() => void execute(`/executions/${observation.runId}/cancel`)}>Cancelar</button></span>}</li>)}</ul>
51
- </section>
42
+ return <>
43
+ <header className="header"><div><p className="eyebrow">FORJAJS 2.0</p><h1>Control Plane</h1><p className="muted">Autonomia supervisionada, evidência e execução auditável.</p></div><button onClick={() => void snapshot.refetch()} disabled={snapshot.isFetching}>{snapshot.isFetching ? 'Atualizando…' : 'Atualizar'}</button></header>
44
+ {(error !== undefined || snapshot.error !== null) && <div className="alert" role="alert">{error ?? 'Control Plane indisponível'}</div>}
45
+ <section className="grid" aria-label="Métricas operacionais"><Metric label="Execuções" value={metrics?.runCount ?? 0}/><Metric label="Taxa de sucesso" value={`${((metrics?.successRate ?? 0) * 100).toFixed(1)}%`}/><Metric label="Tokens de entrada" value={metrics?.totalInputTokens ?? 0}/><Metric label="Observações" value={metrics?.observationCount ?? 0}/></section>
46
+ <section className="panel"><div className="panel-title"><h2>GraphLoop</h2><span className="muted">nós com origem no backend</span></div><div className="graph-controls"><input aria-label="ID do nó de impacto" value={impactOrigin} onChange={(event) => setImpactOrigin(event.target.value)} placeholder="ID do nó para impacto"/><button onClick={() => void impact.refetch()} disabled={impactOrigin.trim().length === 0}>Calcular impacto</button></div><div className="graph-grid">{snapshot.data?.graphNodes.slice(0, 12).map((node) => <span key={node.id} className="node"><strong>{node.label}</strong><small>{node.type} · {node.status}</small></span>)}</div>{impact.data !== undefined && <pre className="impact">{JSON.stringify(impact.data, null, 2)}</pre>}</section>
47
+ <section className="panel"><div className="panel-title"><h2>Approvals</h2><span className="muted">identidade configurada no servidor</span></div>{snapshot.data?.approvals.length === 0 && <p className="muted">Nenhuma aprovação registrada.</p>}<ul className="events">{snapshot.data?.approvals.map((approval) => <li key={approval.id}><span className="dot"/><span><strong>{approval.decision ?? 'pending'}</strong> · {approval.action}<small>{approval.impact}</small></span>{approval.decision === undefined && <span className="actions"><button onClick={() => void decideApproval(approval.id, 'approved')}>Aprovar</button><button onClick={() => void decideApproval(approval.id, 'rejected')}>Rejeitar</button></span>}</li>)}</ul></section>
48
+ <section className="panel"><div className="panel-title"><h2>Atividade recente</h2><span className="muted">{snapshot.isFetching ? 'sincronizando' : 'estado remoto'}</span></div>
49
+ {snapshot.data?.observations.length === 0 && <p className="muted">Nenhuma observação registrada.</p>}
50
+ <ul className="events">{snapshot.data?.observations.slice(-8).reverse().map((observation) => <li key={observation.id}><span className={`dot ${observation.outcome}`}/><span><strong>{observation.outcome}</strong> · {observation.capabilityId ?? 'operação do Control Plane'}<small>{observation.traceId}</small></span>{observation.runId !== undefined && <span className="actions"><button onClick={() => void execute(`/executions/${observation.runId}/pause`)}>Pausar</button><button onClick={() => void execute(`/executions/${observation.runId}/cancel`)}>Cancelar</button></span>}</li>)}</ul>
51
+ </section>
52
52
  </>;
53
53
  }
54
54
  async function loadSnapshot() {
@@ -2,8 +2,9 @@ import 'reflect-metadata';
2
2
  import { CapabilityRegistry } from '../../../packages/core/src/index.ts';
3
3
  import { PolicyEngine } from '../../../packages/policy/src/index.ts';
4
4
  import { McpServer } from '../../../packages/mcp/src/index.ts';
5
- import { ControlPlane } from '../../../packages/observability/src/index.ts';
5
+ import { ControlPlane, type ObservationStore } from '../../../packages/observability/src/index.ts';
6
6
  import { ApprovalLedger } from '../../../packages/policy/src/index.ts';
7
+ import { type OrchestrationStore } from '../../../packages/orchestration/src/index.ts';
7
8
  import { InMemoryEventStream, type LocalAuthenticator } from '../../../packages/adapter-nest/src/index.ts';
8
9
  import { GraphLoop } from '../../../packages/graph/src/index.ts';
9
10
  import { ContextEngine } from '../../../packages/context/src/index.ts';
@@ -13,5 +14,5 @@ export declare function createDefaultCapabilityRegistry(root?: string, cwd?: str
13
14
  export declare function createDefaultMcp(registry?: CapabilityRegistry, policy?: PolicyEngine, graph?: GraphLoop, audit?: import('../../../packages/mcp/src/index.ts').McpAuditSink, context?: ContextEngine): McpServer;
14
15
  export declare function createDefaultPolicy(): PolicyEngine;
15
16
  export declare function createLocalAuthenticator(token?: string | undefined): LocalAuthenticator | undefined;
16
- export declare function createDefaultControlPlane(eventStream: InMemoryEventStream, registry?: CapabilityRegistry, policy?: PolicyEngine, persistence?: RuntimePersistence, approvals?: ApprovalLedger, events?: EventBus, graph?: GraphLoop, context?: ContextEngine): ControlPlane;
17
+ export declare function createDefaultControlPlane(eventStream: InMemoryEventStream, registry?: CapabilityRegistry, policy?: PolicyEngine, persistence?: RuntimePersistence, approvals?: ApprovalLedger, events?: EventBus, graph?: GraphLoop, context?: ContextEngine, orchestrationStore?: OrchestrationStore, observationStore?: ObservationStore): ControlPlane;
17
18
  export declare function bootstrap(port?: number): Promise<import("@nestjs/common").INestApplication<any>>;
@@ -8,7 +8,7 @@ import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
8
8
  import { CapabilityRegistry } from "../../../packages/core/src/index.js";
9
9
  import { PolicyEngine } from "../../../packages/policy/src/index.js";
10
10
  import { McpServer } from "../../../packages/mcp/src/index.js";
11
- import { ControlPlane } from "../../../packages/observability/src/index.js";
11
+ import { ControlPlane, InMemoryObservationStore, ObservabilityRecorder } from "../../../packages/observability/src/index.js";
12
12
  import { ApprovalLedger } from "../../../packages/policy/src/index.js";
13
13
  import { HandoffEngine, InMemoryOrchestrationStore, SprintEngine, TaskEngine } from "../../../packages/orchestration/src/index.js";
14
14
  import { validateTokenBudget } from "../../../packages/contracts/src/index.js";
@@ -18,7 +18,7 @@ import { RuntimeEngine } from "../../../packages/runtime/src/index.js";
18
18
  import { GraphExecutionMemory, GraphLoop } from "../../../packages/graph/src/index.js";
19
19
  import { ContextEngine, GraphContextSource } from "../../../packages/context/src/index.js";
20
20
  import { SqliteContextCache, SqliteGraphStore, SqliteMigrationRunner, SqliteRuntimePersistence } from "../../../packages/adapter-sqlite/src/index.js";
21
- import { SqliteApprovalStore, SqliteMcpAuditSink } from "../../../packages/adapter-sqlite/src/index.js";
21
+ import { SqliteApprovalStore, SqliteMcpAuditSink, SqliteObservationStore, SqliteOrchestrationStore } from "../../../packages/adapter-sqlite/src/index.js";
22
22
  import { EventBus } from "../../../packages/events/src/index.js";
23
23
  import { SqliteEventStore } from "../../../packages/adapter-sqlite/src/index.js";
24
24
  import { getWorkspaceDbDir, getWorkspaceDbPath } from "../../../lib/workspace.js";
@@ -114,13 +114,13 @@ function runtimeInput(input) {
114
114
  return { objective: input.objective, agent, budget, steps, sprintId: typeof input.sprintId === 'string' ? input.sprintId : undefined, taskId: typeof input.taskId === 'string' ? input.taskId : undefined, correlationId: typeof input.correlationId === 'string' ? input.correlationId : undefined };
115
115
  }
116
116
  function isRecord(value) { return typeof value === 'object' && value !== null; }
117
- export function createDefaultControlPlane(eventStream, registry = createDefaultCapabilityRegistry(), policy = createDefaultPolicy(), persistence, approvals = new ApprovalLedger(), events, graph, context) {
118
- const store = new InMemoryOrchestrationStore();
117
+ export function createDefaultControlPlane(eventStream, registry = createDefaultCapabilityRegistry(), policy = createDefaultPolicy(), persistence, approvals = new ApprovalLedger(), events, graph, context, orchestrationStore = new InMemoryOrchestrationStore(), observationStore = new InMemoryObservationStore()) {
118
+ const store = orchestrationStore;
119
119
  const sprintEngine = new SprintEngine(store);
120
120
  const taskEngine = new TaskEngine(store, sprintEngine);
121
121
  const handoffEngine = new HandoffEngine(store);
122
122
  const runtime = new DefaultRuntimeApplication(registry, policy, persistence, graph, context);
123
- return new ControlPlane(undefined, {
123
+ return new ControlPlane(new ObservabilityRecorder(observationStore), {
124
124
  runtime: { start: (input) => runtime.start(input), get: (input) => runtime.get(input), execute: (input) => runtime.execute(input), pause: (input) => runtime.pause(input), resume: (input) => runtime.resume(input), cancel: (input) => runtime.cancel(input) },
125
125
  sprint: { create: (input) => sprintEngine.create(input), start: (id) => sprintEngine.start(id), pause: (id) => sprintEngine.pause(id) },
126
126
  task: { create: (input) => taskEngine.create(input), start: (id) => taskEngine.start(id), block: (id) => taskEngine.block(id) },
@@ -141,10 +141,12 @@ export async function bootstrap(port = Number(process.env.FORJA_PORT ?? 3000)) {
141
141
  const mcpAudit = new SqliteMcpAuditSink(runtimeDatabase);
142
142
  const events = new EventBus(new SqliteEventStore(runtimeDatabase));
143
143
  const graph = new GraphLoop(new SqliteGraphStore(runtimeDatabase));
144
+ const orchestrationStore = new SqliteOrchestrationStore(runtimeDatabase);
145
+ const observationStore = new SqliteObservationStore(runtimeDatabase);
144
146
  registerGraphSyncCapability(registry, graph, new GitGraphDocumentSource(process.env.FORJA_GRAPH_ROOT ?? process.cwd(), new SpawnCommandRunner()));
145
147
  const context = new ContextEngine({ graph: new GraphContextSource({ searchContext: (objective) => graph.contextRecords(objective) }), cache: new SqliteContextCache(runtimeDatabase) });
146
148
  const mcp = createDefaultMcp(registry, policy, graph, mcpAudit, context);
147
- const app = await NestFactory.create(AppModule.register({ mcp, eventStream, authenticator: createLocalAuthenticator(), controlPlane: createDefaultControlPlane(eventStream, registry, policy, runtimePersistence, approvals, events, graph, context) }));
149
+ const app = await NestFactory.create(AppModule.register({ mcp, eventStream, authenticator: createLocalAuthenticator(), controlPlane: createDefaultControlPlane(eventStream, registry, policy, runtimePersistence, approvals, events, graph, context, orchestrationStore, observationStore) }));
148
150
  const config = new DocumentBuilder().setTitle('ForjaJS 2.0 API').setDescription('Local-first agent control plane').setVersion('2.0.0').build();
149
151
  SwaggerModule.setup('docs', app, SwaggerModule.createDocument(app, config));
150
152
  await app.listen(port, '127.0.0.1');
@@ -24,23 +24,23 @@ const __dirname = path.dirname(__filename);
24
24
  const args = process.argv.slice(2);
25
25
  const showHelp = args.includes('--help') || args.includes('-h');
26
26
  if (showHelp) {
27
- console.log(`
28
- create-memory-nest-kit v0.6.0
29
-
30
- Uso:
31
- create-memory-nest-kit [diretorio] [opcoes]
32
-
33
- Opcoes:
34
- --force Sobrescreve arquivos existentes
35
- --only-memory Gera apenas estrutura de memoria/agents/skills
36
- --no-gitkeep Nao cria .gitkeep em diretorios vazios
37
- --no-validate Pula validacao apos geracao
38
- -h, --help Mostra esta ajuda
39
-
40
- Exemplos:
41
- node bin/create-memory-nest-kit.js meu-projeto
42
- node bin/create-memory-nest-kit.js meu-projeto --force
43
- node bin/create-memory-nest-kit.js meu-projeto --only-memory
27
+ console.log(`
28
+ create-memory-nest-kit v0.6.0
29
+
30
+ Uso:
31
+ create-memory-nest-kit [diretorio] [opcoes]
32
+
33
+ Opcoes:
34
+ --force Sobrescreve arquivos existentes
35
+ --only-memory Gera apenas estrutura de memoria/agents/skills
36
+ --no-gitkeep Nao cria .gitkeep em diretorios vazios
37
+ --no-validate Pula validacao apos geracao
38
+ -h, --help Mostra esta ajuda
39
+
40
+ Exemplos:
41
+ node bin/create-memory-nest-kit.js meu-projeto
42
+ node bin/create-memory-nest-kit.js meu-projeto --force
43
+ node bin/create-memory-nest-kit.js meu-projeto --only-memory
44
44
  `);
45
45
  process.exit(0);
46
46
  }
package/dist/bin/forja.js CHANGED
@@ -25,6 +25,7 @@ import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
25
25
  import { McpServer } from "../packages/mcp/src/index.js";
26
26
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
27
27
  const root = path.resolve(__dirname, '..');
28
+ const STUDIO_COMMANDS = new Set(['workspace:init', 'project:new', 'project:list', 'project:upgrade', 'workspace:project:check', 'init:project', 'demo:workspace']);
28
29
  function printHelp() {
29
30
  console.log('Forja — core executivo (ADR-0020)');
30
31
  console.log('Uso: forja <comando> [args]\n');
@@ -122,6 +123,13 @@ function jsonFlag(args) {
122
123
  function withoutFlag(args, flag) {
123
124
  return args.filter((arg) => arg !== flag);
124
125
  }
126
+ // Prompts podem conter dados do projeto. A execução recebe o texto, mas a trilha de auditoria só prova
127
+ // que um prompt foi enviado; nunca preserva seu conteúdo.
128
+ function auditArgs(command, args) {
129
+ if (command !== 'llm:run')
130
+ return args;
131
+ return args.map((arg, index) => args[index - 1] === '--prompt' ? '<redacted>' : arg);
132
+ }
125
133
  function printExecutionResult(result, json) {
126
134
  if (json) {
127
135
  console.log(JSON.stringify(result));
@@ -235,12 +243,17 @@ async function runMcpStdio() {
235
243
  if (line.trim().length === 0)
236
244
  return;
237
245
  let request;
246
+ let id = null;
238
247
  try {
239
248
  request = JSON.parse(line);
240
- const id = request.id ?? null;
249
+ id = request.id ?? null;
250
+ if (request.method === 'notifications/initialized')
251
+ return;
252
+ if (request.method === 'notifications/cancelled')
253
+ return;
241
254
  let result;
242
255
  if (request.method === 'initialize')
243
- result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: '2.0.1' } };
256
+ result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: '2.0.3' } };
244
257
  else if (request.method === 'tools/list')
245
258
  result = { tools: mcp.listTools() };
246
259
  else if (request.method === 'resources/list')
@@ -254,7 +267,7 @@ async function runMcpStdio() {
254
267
  process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, result })}\n`);
255
268
  }
256
269
  catch (error) {
257
- process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32000, message: error instanceof Error ? error.message : 'MCP request failed' } })}\n`);
270
+ process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, error: { code: -32000, message: error instanceof Error ? error.message : 'MCP request failed' } })}\n`);
258
271
  }
259
272
  };
260
273
  let buffer = '';
@@ -280,6 +293,10 @@ if (!name || name === 'help' || name === '--help' || name === '-h') {
280
293
  printHelp();
281
294
  process.exit(0);
282
295
  }
296
+ // O pacote instalado dentro de um projeto opera o próprio cwd. Operações que administram vários
297
+ // projetos permanecem no studio global; FORJA_MODE/FORJA_WORKSPACE sempre vencem a inferência.
298
+ if (STUDIO_COMMANDS.has(name) && !process.env.FORJA_MODE && !process.env.FORJA_WORKSPACE)
299
+ process.env.FORJA_MODE = 'studio';
283
300
  if (name === 'capabilities:list' || name === 'capabilities:describe' || name === 'capability:execute') {
284
301
  process.exit(await runCapabilityCommand(name, rest));
285
302
  }
@@ -304,7 +321,7 @@ if (gateErrors.length) {
304
321
  audit({
305
322
  ts: new Date().toISOString(),
306
323
  cmd: name,
307
- args: rest,
324
+ args: auditArgs(name, rest),
308
325
  exitCode: 1,
309
326
  durationMs: 0,
310
327
  gate: 'blocked',
@@ -342,7 +359,7 @@ const exitCode = result.status ?? 1;
342
359
  audit({
343
360
  ts: new Date().toISOString(),
344
361
  cmd: name,
345
- args: rest,
362
+ args: auditArgs(name, rest),
346
363
  exitCode,
347
364
  durationMs: Date.now() - started,
348
365
  });