forjajs 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (558) hide show
  1. package/.claude/agents/context-engineer.md +25 -0
  2. package/.claude/agents/governance.md +32 -0
  3. package/.claude/agents/marketing.md +24 -0
  4. package/.claude/agents/orchestrator.md +31 -0
  5. package/.claude/agents/product.md +26 -0
  6. package/.claude/agents/sdd-architect.md +34 -0
  7. package/.claude/settings.json +41 -0
  8. package/.gemini-instructions.md +87 -0
  9. package/.github/copilot-instructions.md +87 -0
  10. package/.memoryrc.json +104 -0
  11. package/.openai-instructions.md +87 -0
  12. package/AGENTS.md +132 -0
  13. package/CHANGELOG.md +106 -0
  14. package/CONTRIBUTING.md +32 -0
  15. package/DOC-MAP.md +65 -0
  16. package/LICENSE +21 -0
  17. package/README.md +260 -0
  18. package/bin/create-memory-nest-kit.js +125 -0
  19. package/bin/forja.mjs +143 -0
  20. package/bin/init-project.js +612 -0
  21. package/boilerplates/01-api-rest/README.md +336 -0
  22. package/boilerplates/01-api-rest/boilerplate.manifest.json +41 -0
  23. package/boilerplates/02-saas-starter/.env.example +25 -0
  24. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +190 -0
  25. package/boilerplates/02-saas-starter/INFO.md +252 -0
  26. package/boilerplates/02-saas-starter/QUICK_START.md +194 -0
  27. package/boilerplates/02-saas-starter/README.md +305 -0
  28. package/boilerplates/02-saas-starter/START-HERE.md +259 -0
  29. package/boilerplates/02-saas-starter/backend/package.json +87 -0
  30. package/boilerplates/02-saas-starter/backend/src/app.module.ts +27 -0
  31. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +3 -0
  32. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +6 -0
  33. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +23 -0
  34. package/boilerplates/02-saas-starter/backend/src/config/database.ts +26 -0
  35. package/boilerplates/02-saas-starter/backend/src/main.ts +26 -0
  36. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +46 -0
  37. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +25 -0
  38. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +145 -0
  39. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +30 -0
  40. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +24 -0
  41. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +19 -0
  42. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +42 -0
  43. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +13 -0
  44. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +67 -0
  45. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +52 -0
  46. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +36 -0
  47. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +16 -0
  48. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +13 -0
  49. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +34 -0
  50. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +40 -0
  51. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +36 -0
  52. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +13 -0
  53. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +91 -0
  54. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +42 -0
  55. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +14 -0
  56. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +13 -0
  57. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +48 -0
  58. package/boilerplates/02-saas-starter/backend/tsconfig.json +28 -0
  59. package/boilerplates/02-saas-starter/boilerplate.manifest.json +42 -0
  60. package/boilerplates/02-saas-starter/docker-compose.yml +34 -0
  61. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +227 -0
  62. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +141 -0
  63. package/boilerplates/02-saas-starter/memory/00-global/index.md +133 -0
  64. package/boilerplates/02-saas-starter/memory/00-global/mission.md +45 -0
  65. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +223 -0
  66. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +240 -0
  67. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +239 -0
  68. package/boilerplates/02-saas-starter/memory/10-product/personas.md +195 -0
  69. package/boilerplates/02-saas-starter/memory/10-product/vision.md +63 -0
  70. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +232 -0
  71. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +186 -0
  72. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +85 -0
  73. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +262 -0
  74. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +137 -0
  75. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +176 -0
  76. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +100 -0
  77. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +81 -0
  78. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +97 -0
  79. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +57 -0
  80. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +90 -0
  81. package/boilerplates/02-saas-starter/memory/60-runs/index.md +54 -0
  82. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +50 -0
  83. package/boilerplates/02-saas-starter/memory/80-data/schema.md +185 -0
  84. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +75 -0
  85. package/boilerplates/03-ecommerce-starter/FLOW_EXEMPLOS.md +599 -0
  86. package/boilerplates/03-ecommerce-starter/GUIA_RAPIDO.md +322 -0
  87. package/boilerplates/03-ecommerce-starter/MANIFEST.md +463 -0
  88. package/boilerplates/03-ecommerce-starter/README.md +465 -0
  89. package/boilerplates/03-ecommerce-starter/agents/.gitkeep +0 -0
  90. package/boilerplates/03-ecommerce-starter/backend/.env.example +121 -0
  91. package/boilerplates/03-ecommerce-starter/backend/Dockerfile +15 -0
  92. package/boilerplates/03-ecommerce-starter/backend/docker-compose.yml +56 -0
  93. package/boilerplates/03-ecommerce-starter/backend/jest.config.js +16 -0
  94. package/boilerplates/03-ecommerce-starter/backend/package.json +71 -0
  95. package/boilerplates/03-ecommerce-starter/backend/src/app.controller.ts +12 -0
  96. package/boilerplates/03-ecommerce-starter/backend/src/app.module.ts +48 -0
  97. package/boilerplates/03-ecommerce-starter/backend/src/app.service.ts +12 -0
  98. package/boilerplates/03-ecommerce-starter/backend/src/common/.gitkeep +0 -0
  99. package/boilerplates/03-ecommerce-starter/backend/src/main.ts +51 -0
  100. package/boilerplates/03-ecommerce-starter/backend/src/modules/auth/auth.module.ts +8 -0
  101. package/boilerplates/03-ecommerce-starter/backend/src/modules/cart/cart.module.ts +8 -0
  102. package/boilerplates/03-ecommerce-starter/backend/src/modules/coupons/coupons.module.ts +8 -0
  103. package/boilerplates/03-ecommerce-starter/backend/src/modules/inventory/inventory.module.ts +8 -0
  104. package/boilerplates/03-ecommerce-starter/backend/src/modules/orders/orders.module.ts +10 -0
  105. package/boilerplates/03-ecommerce-starter/backend/src/modules/payments/payments.module.ts +8 -0
  106. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/dto/create-product.dto.ts +34 -0
  107. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/category.entity.ts +47 -0
  108. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/entities/product.entity.ts +66 -0
  109. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.controller.ts +78 -0
  110. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.module.ts +14 -0
  111. package/boilerplates/03-ecommerce-starter/backend/src/modules/products/products.service.ts +112 -0
  112. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/entities/review.entity.ts +32 -0
  113. package/boilerplates/03-ecommerce-starter/backend/src/modules/reviews/reviews.module.ts +11 -0
  114. package/boilerplates/03-ecommerce-starter/backend/test/health.e2e-spec.ts +31 -0
  115. package/boilerplates/03-ecommerce-starter/backend/test/jest-e2e.json +12 -0
  116. package/boilerplates/03-ecommerce-starter/backend/tsconfig.json +23 -0
  117. package/boilerplates/03-ecommerce-starter/boilerplate.manifest.json +42 -0
  118. package/boilerplates/03-ecommerce-starter/boilerplate.md +128 -0
  119. package/boilerplates/03-ecommerce-starter/memory/00-global/agent-contract.md +53 -0
  120. package/boilerplates/03-ecommerce-starter/memory/00-global/context-index.md +55 -0
  121. package/boilerplates/03-ecommerce-starter/memory/00-global/context-policy.md +31 -0
  122. package/boilerplates/03-ecommerce-starter/memory/00-global/mission.md +25 -0
  123. package/boilerplates/03-ecommerce-starter/memory/00-global/standards.md +45 -0
  124. package/boilerplates/03-ecommerce-starter/memory/10-product/business-rules.md +62 -0
  125. package/boilerplates/03-ecommerce-starter/memory/10-product/nfrs.md +62 -0
  126. package/boilerplates/03-ecommerce-starter/memory/10-product/vision.md +124 -0
  127. package/boilerplates/03-ecommerce-starter/memory/20-architecture/backend.md +253 -0
  128. package/boilerplates/03-ecommerce-starter/memory/20-architecture/observability.md +319 -0
  129. package/boilerplates/03-ecommerce-starter/memory/20-architecture/overview.md +133 -0
  130. package/boilerplates/03-ecommerce-starter/memory/20-architecture/security.md +227 -0
  131. package/boilerplates/03-ecommerce-starter/memory/30-domains/catalog/context.md +210 -0
  132. package/boilerplates/03-ecommerce-starter/memory/30-domains/inventory/context.md +233 -0
  133. package/boilerplates/03-ecommerce-starter/memory/30-domains/orders/context.md +210 -0
  134. package/boilerplates/03-ecommerce-starter/memory/30-domains/payments/context.md +168 -0
  135. package/boilerplates/03-ecommerce-starter/memory/40-delivery/.gitkeep +0 -0
  136. package/boilerplates/03-ecommerce-starter/memory/50-orchestration/.gitkeep +0 -0
  137. package/boilerplates/03-ecommerce-starter/memory/60-runs/.gitkeep +0 -0
  138. package/boilerplates/03-ecommerce-starter/memory/70-summaries/.gitkeep +0 -0
  139. package/boilerplates/03-ecommerce-starter/memory/80-data/.gitkeep +0 -0
  140. package/boilerplates/03-ecommerce-starter/memory/80-data/sqlite.md +260 -0
  141. package/boilerplates/03-ecommerce-starter/memory/90-decisions/.gitkeep +0 -0
  142. package/boilerplates/03-ecommerce-starter/memory/90-decisions/ADR-TEMPLATE.md +223 -0
  143. package/boilerplates/03-ecommerce-starter/prompts/.gitkeep +0 -0
  144. package/boilerplates/03-ecommerce-starter/skills/.gitkeep +0 -0
  145. package/boilerplates/04-microservices-starter/.env.example +43 -0
  146. package/boilerplates/04-microservices-starter/API-EXAMPLES.md +609 -0
  147. package/boilerplates/04-microservices-starter/ARCHITECTURE.md +512 -0
  148. package/boilerplates/04-microservices-starter/GETTING-STARTED.md +246 -0
  149. package/boilerplates/04-microservices-starter/INDEX.md +377 -0
  150. package/boilerplates/04-microservices-starter/MANIFEST.md +456 -0
  151. package/boilerplates/04-microservices-starter/README.md +466 -0
  152. package/boilerplates/04-microservices-starter/SUMMARY.md +386 -0
  153. package/boilerplates/04-microservices-starter/backend/api-gateway/Dockerfile +14 -0
  154. package/boilerplates/04-microservices-starter/backend/api-gateway/package.json +29 -0
  155. package/boilerplates/04-microservices-starter/backend/api-gateway/src/app.module.ts +9 -0
  156. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.controller.ts +45 -0
  157. package/boilerplates/04-microservices-starter/backend/api-gateway/src/gateway.service.ts +114 -0
  158. package/boilerplates/04-microservices-starter/backend/api-gateway/src/main.ts +9 -0
  159. package/boilerplates/04-microservices-starter/backend/api-gateway/test/.gitkeep +0 -0
  160. package/boilerplates/04-microservices-starter/backend/api-gateway/tsconfig.json +20 -0
  161. package/boilerplates/04-microservices-starter/backend/services/auth-service/Dockerfile +14 -0
  162. package/boilerplates/04-microservices-starter/backend/services/auth-service/package.json +42 -0
  163. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/app.module.ts +7 -0
  164. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/main.ts +9 -0
  165. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.controller.ts +130 -0
  166. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.module.ts +21 -0
  167. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/auth.service.ts +159 -0
  168. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/jwt.strategy.ts +19 -0
  169. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/auth/local.strategy.ts +18 -0
  170. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/notification/.gitkeep +0 -0
  171. package/boilerplates/04-microservices-starter/backend/services/auth-service/src/modules/user/.gitkeep +0 -0
  172. package/boilerplates/04-microservices-starter/backend/services/auth-service/test/.gitkeep +0 -0
  173. package/boilerplates/04-microservices-starter/backend/services/auth-service/tsconfig.json +21 -0
  174. package/boilerplates/04-microservices-starter/backend/services/notification-service/Dockerfile +14 -0
  175. package/boilerplates/04-microservices-starter/backend/services/notification-service/package.json +25 -0
  176. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/app.module.ts +7 -0
  177. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/main.ts +9 -0
  178. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/auth/.gitkeep +0 -0
  179. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.controller.ts +160 -0
  180. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.module.ts +10 -0
  181. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/notification/notification.service.ts +92 -0
  182. package/boilerplates/04-microservices-starter/backend/services/notification-service/src/modules/user/.gitkeep +0 -0
  183. package/boilerplates/04-microservices-starter/backend/services/notification-service/test/.gitkeep +0 -0
  184. package/boilerplates/04-microservices-starter/backend/services/notification-service/tsconfig.json +20 -0
  185. package/boilerplates/04-microservices-starter/backend/services/user-service/Dockerfile +14 -0
  186. package/boilerplates/04-microservices-starter/backend/services/user-service/package.json +25 -0
  187. package/boilerplates/04-microservices-starter/backend/services/user-service/src/app.module.ts +7 -0
  188. package/boilerplates/04-microservices-starter/backend/services/user-service/src/main.ts +9 -0
  189. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/auth/.gitkeep +0 -0
  190. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/notification/.gitkeep +0 -0
  191. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.controller.ts +122 -0
  192. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.module.ts +10 -0
  193. package/boilerplates/04-microservices-starter/backend/services/user-service/src/modules/user/user.service.ts +161 -0
  194. package/boilerplates/04-microservices-starter/backend/services/user-service/test/.gitkeep +0 -0
  195. package/boilerplates/04-microservices-starter/backend/services/user-service/tsconfig.json +20 -0
  196. package/boilerplates/04-microservices-starter/backend/shared/package.json +15 -0
  197. package/boilerplates/04-microservices-starter/backend/shared/src/constants/index.ts +84 -0
  198. package/boilerplates/04-microservices-starter/backend/shared/src/decorators/index.ts +12 -0
  199. package/boilerplates/04-microservices-starter/backend/shared/src/index.ts +4 -0
  200. package/boilerplates/04-microservices-starter/backend/shared/src/interfaces/index.ts +152 -0
  201. package/boilerplates/04-microservices-starter/backend/shared/src/types/.gitkeep +0 -0
  202. package/boilerplates/04-microservices-starter/backend/shared/src/utils/index.ts +54 -0
  203. package/boilerplates/04-microservices-starter/backend/shared/tsconfig.json +20 -0
  204. package/boilerplates/04-microservices-starter/boilerplate.manifest.json +41 -0
  205. package/boilerplates/04-microservices-starter/docker-compose.yml +164 -0
  206. package/boilerplates/04-microservices-starter/memory/00-global/agent-contract.md +171 -0
  207. package/boilerplates/04-microservices-starter/memory/00-global/context-policy.md +89 -0
  208. package/boilerplates/04-microservices-starter/memory/00-global/index.md +102 -0
  209. package/boilerplates/04-microservices-starter/memory/00-global/mission.md +44 -0
  210. package/boilerplates/04-microservices-starter/memory/00-global/patterns.md +106 -0
  211. package/boilerplates/04-microservices-starter/memory/10-product/vision.md +76 -0
  212. package/boilerplates/04-microservices-starter/memory/20-architecture/overview.md +247 -0
  213. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/api.md +293 -0
  214. package/boilerplates/04-microservices-starter/memory/30-domains/auth-service/context.md +108 -0
  215. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/api.md +333 -0
  216. package/boilerplates/04-microservices-starter/memory/30-domains/notification-service/context.md +121 -0
  217. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/api.md +308 -0
  218. package/boilerplates/04-microservices-starter/memory/30-domains/user-service/context.md +120 -0
  219. package/boilerplates/04-microservices-starter/memory/40-delivery/.gitkeep +0 -0
  220. package/boilerplates/04-microservices-starter/memory/50-orchestration/topology.md +216 -0
  221. package/boilerplates/04-microservices-starter/memory/60-runs/.gitkeep +0 -0
  222. package/boilerplates/04-microservices-starter/memory/70-summaries/.gitkeep +0 -0
  223. package/boilerplates/04-microservices-starter/memory/80-data/.gitkeep +0 -0
  224. package/boilerplates/04-microservices-starter/memory/90-decisions/.gitkeep +0 -0
  225. package/boilerplates/04-microservices-starter/package.json +21 -0
  226. package/boilerplates/05-monorepo-starter/.env.example +1 -0
  227. package/boilerplates/05-monorepo-starter/BOILERPLATE_SUMMARY.md +193 -0
  228. package/boilerplates/05-monorepo-starter/DEVELOPMENT.md +481 -0
  229. package/boilerplates/05-monorepo-starter/Dockerfile +35 -0
  230. package/boilerplates/05-monorepo-starter/README.md +318 -0
  231. package/boilerplates/05-monorepo-starter/boilerplate.manifest.json +43 -0
  232. package/boilerplates/05-monorepo-starter/docker-compose.yml +36 -0
  233. package/boilerplates/05-monorepo-starter/memory/00-global/agent-contract.md +28 -0
  234. package/boilerplates/05-monorepo-starter/memory/00-global/context-policy.md +21 -0
  235. package/boilerplates/05-monorepo-starter/memory/00-global/index.md +44 -0
  236. package/boilerplates/05-monorepo-starter/memory/00-global/mission.md +17 -0
  237. package/boilerplates/05-monorepo-starter/memory/00-global/patterns.md +48 -0
  238. package/boilerplates/05-monorepo-starter/memory/10-product/business-rules.md +24 -0
  239. package/boilerplates/05-monorepo-starter/memory/10-product/nfrs.md +39 -0
  240. package/boilerplates/05-monorepo-starter/memory/10-product/personas.md +25 -0
  241. package/boilerplates/05-monorepo-starter/memory/10-product/vision.md +22 -0
  242. package/boilerplates/05-monorepo-starter/memory/20-architecture/backend.md +85 -0
  243. package/boilerplates/05-monorepo-starter/memory/20-architecture/data.md +66 -0
  244. package/boilerplates/05-monorepo-starter/memory/20-architecture/frontend.md +58 -0
  245. package/boilerplates/05-monorepo-starter/memory/20-architecture/overview.md +86 -0
  246. package/boilerplates/05-monorepo-starter/memory/20-architecture/security.md +58 -0
  247. package/boilerplates/05-monorepo-starter/memory/30-domains/order/api.md +81 -0
  248. package/boilerplates/05-monorepo-starter/memory/30-domains/order/context.md +63 -0
  249. package/boilerplates/05-monorepo-starter/memory/30-domains/product/api.md +81 -0
  250. package/boilerplates/05-monorepo-starter/memory/30-domains/product/context.md +56 -0
  251. package/boilerplates/05-monorepo-starter/memory/30-domains/user/api.md +99 -0
  252. package/boilerplates/05-monorepo-starter/memory/30-domains/user/context.md +58 -0
  253. package/boilerplates/05-monorepo-starter/memory/40-delivery/.gitkeep +0 -0
  254. package/boilerplates/05-monorepo-starter/memory/50-orchestration/.gitkeep +0 -0
  255. package/boilerplates/05-monorepo-starter/memory/60-runs/.gitkeep +0 -0
  256. package/boilerplates/05-monorepo-starter/memory/70-summaries/.gitkeep +0 -0
  257. package/boilerplates/05-monorepo-starter/memory/80-data/.gitkeep +0 -0
  258. package/boilerplates/05-monorepo-starter/memory/90-decisions/.gitkeep +0 -0
  259. package/boilerplates/05-monorepo-starter/package.json +30 -0
  260. package/boilerplates/05-monorepo-starter/packages/apps/backend/.env.example +15 -0
  261. package/boilerplates/05-monorepo-starter/packages/apps/backend/README.md +28 -0
  262. package/boilerplates/05-monorepo-starter/packages/apps/backend/package.json +53 -0
  263. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/app.module.ts +40 -0
  264. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/exceptions/global.exception.ts +32 -0
  265. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.guard.ts +5 -0
  266. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/jwt.strategy.ts +11 -0
  267. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/guards/roles.guard.ts +17 -0
  268. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/common/health.controller.ts +13 -0
  269. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/main.ts +28 -0
  270. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/dto/index.ts +23 -0
  271. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/entities/order.entity.ts +48 -0
  272. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.controller.ts +51 -0
  273. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.module.ts +13 -0
  274. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/orders/orders.service.ts +123 -0
  275. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/dto/index.ts +35 -0
  276. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/entities/product.entity.ts +28 -0
  277. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.controller.ts +49 -0
  278. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.module.ts +12 -0
  279. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/products/products.service.ts +79 -0
  280. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/dto/index.ts +24 -0
  281. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/entities/user.entity.ts +28 -0
  282. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.controller.ts +29 -0
  283. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.module.ts +15 -0
  284. package/boilerplates/05-monorepo-starter/packages/apps/backend/src/modules/users/users.service.ts +78 -0
  285. package/boilerplates/05-monorepo-starter/packages/apps/backend/tsconfig.json +25 -0
  286. package/boilerplates/05-monorepo-starter/packages/apps/frontend/.env.example +1 -0
  287. package/boilerplates/05-monorepo-starter/packages/apps/frontend/README.md +30 -0
  288. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/dashboard/page.tsx +39 -0
  289. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/layout.tsx +15 -0
  290. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/page.tsx +47 -0
  291. package/boilerplates/05-monorepo-starter/packages/apps/frontend/app/products/page.tsx +51 -0
  292. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/features/product-card.tsx +19 -0
  293. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/footer.tsx +10 -0
  294. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/header.tsx +24 -0
  295. package/boilerplates/05-monorepo-starter/packages/apps/frontend/components/layout/layout.tsx +13 -0
  296. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/api-client.ts +34 -0
  297. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/auth.ts +35 -0
  298. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/orders.ts +28 -0
  299. package/boilerplates/05-monorepo-starter/packages/apps/frontend/lib/products.ts +28 -0
  300. package/boilerplates/05-monorepo-starter/packages/apps/frontend/next.config.js +15 -0
  301. package/boilerplates/05-monorepo-starter/packages/apps/frontend/package.json +31 -0
  302. package/boilerplates/05-monorepo-starter/packages/apps/frontend/postcss.config.js +3 -0
  303. package/boilerplates/05-monorepo-starter/packages/apps/frontend/styles/globals.css +7 -0
  304. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tailwind.config.js +7 -0
  305. package/boilerplates/05-monorepo-starter/packages/apps/frontend/tsconfig.json +14 -0
  306. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/README.md +35 -0
  307. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/package.json +17 -0
  308. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/common.ts +18 -0
  309. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/order.ts +38 -0
  310. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/product.ts +33 -0
  311. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/api/user.ts +32 -0
  312. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/domain/index.ts +41 -0
  313. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/errors/index.ts +46 -0
  314. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/src/index.ts +7 -0
  315. package/boilerplates/05-monorepo-starter/packages/packages/shared-types/tsconfig.json +8 -0
  316. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/README.md +30 -0
  317. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/package.json +17 -0
  318. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/constants/index.ts +45 -0
  319. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/index.ts +4 -0
  320. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/index.ts +3 -0
  321. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/math.ts +30 -0
  322. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/utils/string.ts +48 -0
  323. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/src/validators/index.ts +44 -0
  324. package/boilerplates/05-monorepo-starter/packages/packages/shared-utils/tsconfig.json +8 -0
  325. package/boilerplates/05-monorepo-starter/tsconfig.json +23 -0
  326. package/boilerplates/05-monorepo-starter/turbo.json +35 -0
  327. package/boilerplates/README.md +407 -0
  328. package/design-md/BRIEF-TEMPLATE.md +47 -0
  329. package/design-md/INDEX.md +35 -0
  330. package/design-md/MATRIX.md +24 -0
  331. package/design-md/PLAYBOOK.md +35 -0
  332. package/design-md/examples/agent-console-brief.md +48 -0
  333. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +63 -0
  334. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +136 -0
  335. package/docs/GUIA-ONBOARDING-PROJETO.md +279 -0
  336. package/docs/agent-harnesses.md +122 -0
  337. package/docs/archive/CHECKLIST-FINAL.md +295 -0
  338. package/docs/archive/FASE2-SUMMARY.md +263 -0
  339. package/docs/archive/FASE3-PROGRESS.md +355 -0
  340. package/docs/archive/IMPLEMENTACAO-FASE1.md +476 -0
  341. package/docs/archive/INDICE-MASTER.md +282 -0
  342. package/docs/archive/PROJETO-COMPLETO.md +363 -0
  343. package/docs/archive/README-REFINAMENTO.md +293 -0
  344. package/docs/archive/REFERENCIA-RAPIDA.md +324 -0
  345. package/docs/archive/REFINAMENTO-v1.0.md +565 -0
  346. package/docs/archive/RELATORIO-TESTES-INTEGRACAO.md +223 -0
  347. package/docs/archive/START-HERE.md +319 -0
  348. package/docs/archive/SUMARIO-EXECUTIVO.md +268 -0
  349. package/docs/archive/examples/v1/AGENTS.md +10 -0
  350. package/docs/archive/examples/v1/README.md +36 -0
  351. package/docs/archive/examples/v1/backend/jest-e2e.json +9 -0
  352. package/docs/archive/examples/v1/backend/nest-cli.json +4 -0
  353. package/docs/archive/examples/v1/backend/package.json +42 -0
  354. package/docs/archive/examples/v1/backend/src/app.controller.ts +12 -0
  355. package/docs/archive/examples/v1/backend/src/app.module.ts +10 -0
  356. package/docs/archive/examples/v1/backend/src/app.service.ts +8 -0
  357. package/docs/archive/examples/v1/backend/src/main.ts +10 -0
  358. package/docs/archive/examples/v1/backend/test/app.e2e-spec.ts +24 -0
  359. package/docs/archive/examples/v1/backend/tsconfig.build.json +4 -0
  360. package/docs/archive/examples/v1/backend/tsconfig.json +17 -0
  361. package/docs/archive/examples/v1/docs/.gitkeep +0 -0
  362. package/docs/archive/examples/v1/memory/00-global/glossary.md +5 -0
  363. package/docs/archive/examples/v1/memory/00-global/mission.md +9 -0
  364. package/docs/archive/examples/v1/memory/00-global/standards.md +12 -0
  365. package/docs/archive/examples/v1/memory/00-global/tooling.md +10 -0
  366. package/docs/archive/examples/v1/memory/10-product/business-rules.md +3 -0
  367. package/docs/archive/examples/v1/memory/10-product/nfrs.md +6 -0
  368. package/docs/archive/examples/v1/memory/10-product/personas.md +3 -0
  369. package/docs/archive/examples/v1/memory/10-product/vision.md +3 -0
  370. package/docs/archive/examples/v1/memory/20-architecture/backend.md +10 -0
  371. package/docs/archive/examples/v1/memory/20-architecture/data.md +3 -0
  372. package/docs/archive/examples/v1/memory/20-architecture/frontend.md +3 -0
  373. package/docs/archive/examples/v1/memory/20-architecture/observability.md +5 -0
  374. package/docs/archive/examples/v1/memory/20-architecture/security.md +6 -0
  375. package/docs/archive/examples/v1/memory/20-architecture/system-overview.md +3 -0
  376. package/docs/archive/examples/v1/memory/30-domains/auth/api.md +3 -0
  377. package/docs/archive/examples/v1/memory/30-domains/auth/context.md +3 -0
  378. package/docs/archive/examples/v1/memory/30-domains/auth/rules.md +3 -0
  379. package/docs/archive/examples/v1/memory/30-domains/billing/api.md +3 -0
  380. package/docs/archive/examples/v1/memory/30-domains/billing/context.md +3 -0
  381. package/docs/archive/examples/v1/memory/30-domains/billing/rules.md +3 -0
  382. package/docs/archive/examples/v1/memory/30-domains/shared/.gitkeep +0 -0
  383. package/docs/archive/examples/v1/memory/40-delivery/backlog.md +3 -0
  384. package/docs/archive/examples/v1/memory/40-delivery/current-sprint.md +10 -0
  385. package/docs/archive/examples/v1/memory/40-delivery/roadmap.md +3 -0
  386. package/docs/archive/examples/v1/memory/90-decisions/ADR-0001-template.md +9 -0
  387. package/docs/archive/examples/v1/memory/90-decisions/archive/.gitkeep +0 -0
  388. package/docs/archive/examples/v1/prompts/project-prompt-base.md +19 -0
  389. package/docs/archive/examples/v1/scripts/.gitkeep +0 -0
  390. package/docs/archive/examples/v2/.memoryrc.json +8 -0
  391. package/docs/archive/examples/v2/AGENTS.md +16 -0
  392. package/docs/archive/examples/v2/README.md +35 -0
  393. package/docs/archive/examples/v2/agents/README.md +3 -0
  394. package/docs/archive/examples/v2/agents/backend-nest.md +9 -0
  395. package/docs/archive/examples/v2/agents/dba.md +4 -0
  396. package/docs/archive/examples/v2/agents/frontend.md +4 -0
  397. package/docs/archive/examples/v2/agents/orchestrator.md +9 -0
  398. package/docs/archive/examples/v2/agents/reviewer.md +6 -0
  399. package/docs/archive/examples/v2/agents/security.md +4 -0
  400. package/docs/archive/examples/v2/backend/jest-e2e.json +9 -0
  401. package/docs/archive/examples/v2/backend/nest-cli.json +4 -0
  402. package/docs/archive/examples/v2/backend/package.json +42 -0
  403. package/docs/archive/examples/v2/backend/src/app.controller.ts +12 -0
  404. package/docs/archive/examples/v2/backend/src/app.module.ts +10 -0
  405. package/docs/archive/examples/v2/backend/src/app.service.ts +8 -0
  406. package/docs/archive/examples/v2/backend/src/main.ts +10 -0
  407. package/docs/archive/examples/v2/backend/test/app.e2e-spec.ts +24 -0
  408. package/docs/archive/examples/v2/backend/tsconfig.build.json +4 -0
  409. package/docs/archive/examples/v2/backend/tsconfig.json +17 -0
  410. package/docs/archive/examples/v2/docs/.gitkeep +0 -0
  411. package/docs/archive/examples/v2/memory/00-global/agent-contract.md +15 -0
  412. package/docs/archive/examples/v2/memory/00-global/context-index.md +12 -0
  413. package/docs/archive/examples/v2/memory/00-global/context-policy.md +14 -0
  414. package/docs/archive/examples/v2/memory/00-global/mission.md +9 -0
  415. package/docs/archive/examples/v2/memory/00-global/standards.md +12 -0
  416. package/docs/archive/examples/v2/memory/10-product/business-rules.md +3 -0
  417. package/docs/archive/examples/v2/memory/10-product/nfrs.md +6 -0
  418. package/docs/archive/examples/v2/memory/10-product/personas.md +3 -0
  419. package/docs/archive/examples/v2/memory/10-product/vision.md +3 -0
  420. package/docs/archive/examples/v2/memory/20-architecture/backend.md +10 -0
  421. package/docs/archive/examples/v2/memory/20-architecture/data.md +3 -0
  422. package/docs/archive/examples/v2/memory/20-architecture/frontend.md +3 -0
  423. package/docs/archive/examples/v2/memory/20-architecture/observability.md +5 -0
  424. package/docs/archive/examples/v2/memory/20-architecture/security.md +6 -0
  425. package/docs/archive/examples/v2/memory/20-architecture/system-overview.md +3 -0
  426. package/docs/archive/examples/v2/memory/30-domains/auth/api.md +3 -0
  427. package/docs/archive/examples/v2/memory/30-domains/auth/context.md +3 -0
  428. package/docs/archive/examples/v2/memory/30-domains/auth/rules.md +3 -0
  429. package/docs/archive/examples/v2/memory/30-domains/billing/api.md +3 -0
  430. package/docs/archive/examples/v2/memory/30-domains/billing/context.md +3 -0
  431. package/docs/archive/examples/v2/memory/30-domains/billing/rules.md +3 -0
  432. package/docs/archive/examples/v2/memory/30-domains/shared/.gitkeep +0 -0
  433. package/docs/archive/examples/v2/memory/40-delivery/backlog.md +3 -0
  434. package/docs/archive/examples/v2/memory/40-delivery/current-sprint.md +10 -0
  435. package/docs/archive/examples/v2/memory/40-delivery/roadmap.md +3 -0
  436. package/docs/archive/examples/v2/memory/50-orchestration/handoff-protocol.md +8 -0
  437. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/2026-04-18T18-40-10.517Z_orchestrator_para_backend-nest.md +19 -0
  438. package/docs/archive/examples/v2/memory/50-orchestration/handoffs/README.md +4 -0
  439. package/docs/archive/examples/v2/memory/50-orchestration/parallel-playbook.md +9 -0
  440. package/docs/archive/examples/v2/memory/50-orchestration/routing.md +10 -0
  441. package/docs/archive/examples/v2/memory/50-orchestration/topology.md +15 -0
  442. package/docs/archive/examples/v2/memory/60-runs/README.md +3 -0
  443. package/docs/archive/examples/v2/memory/70-summaries/domain-summary.md +3 -0
  444. package/docs/archive/examples/v2/memory/70-summaries/global-summary.md +6 -0
  445. package/docs/archive/examples/v2/memory/90-decisions/ADR-0001-template.md +9 -0
  446. package/docs/archive/examples/v2/memory/90-decisions/archive/.gitkeep +0 -0
  447. package/docs/archive/examples/v2/memory/README.md +8 -0
  448. package/docs/archive/examples/v2/prompts/multi-agent-orchestrator.md +12 -0
  449. package/docs/archive/examples/v2/prompts/project-prompt-base.md +21 -0
  450. package/docs/archive/examples/v2/prompts/worker-task-template.md +10 -0
  451. package/docs/archive/examples/v2/scripts/.gitkeep +0 -0
  452. package/docs/archive/examples/v2/scripts/append-handoff.mjs +25 -0
  453. package/docs/archive/examples/v2/scripts/build-context-pack.mjs +31 -0
  454. package/docs/archive/examples/v2/skills/context-compaction/SKILL.md +9 -0
  455. package/docs/archive/examples/v2/skills/handoff/SKILL.md +8 -0
  456. package/docs/archive/examples/v2/skills/nest-api/SKILL.md +7 -0
  457. package/docs/archive/examples/v2/skills/triage-task/SKILL.md +10 -0
  458. package/docs/archive/legacy-bin/create-memory-nest-kit-monolith.js +1486 -0
  459. package/docs/capacidades-externas.md +70 -0
  460. package/docs/cli-first-operacao.md +74 -0
  461. package/docs/dashboard.md +102 -0
  462. package/docs/dev-workflow.md +421 -0
  463. package/docs/examples.md +546 -0
  464. package/docs/fluxo.md +103 -0
  465. package/docs/glossary.md +453 -0
  466. package/docs/init-project.md +457 -0
  467. package/docs/manual-operacional-cli-sdd-gsd.md +1014 -0
  468. package/docs/personas/architect/README.md +333 -0
  469. package/docs/personas/developer/README.md +371 -0
  470. package/docs/personas/executive/README.md +172 -0
  471. package/docs/personas/qa/README.md +350 -0
  472. package/docs/processo-projeto.md +138 -0
  473. package/docs/publishing.md +377 -0
  474. package/docs/quick-reference.md +409 -0
  475. package/docs/structure.md +360 -0
  476. package/docs/token-optimization.md +494 -0
  477. package/lib/context-builder.js +257 -0
  478. package/lib/core/registry.mjs +284 -0
  479. package/lib/generators/memory-generator.js +844 -0
  480. package/lib/generators/nest-generator.js +496 -0
  481. package/lib/generators/readme-generator.js +213 -0
  482. package/lib/templates/harness/code-intel.mjs +119 -0
  483. package/lib/templates/harness/mcp.json +10 -0
  484. package/lib/utils/file-helpers.js +40 -0
  485. package/lib/validators/structure-validator.js +253 -0
  486. package/lib/workspace.mjs +213 -0
  487. package/memory/00-global/mission.md +15 -0
  488. package/memory/00-global/shared-knowledge.md +8 -0
  489. package/memory/00-global/standards.md +47 -0
  490. package/memory/10-product/personas.md +21 -0
  491. package/memory/10-product/vision.md +27 -0
  492. package/memory/30-projects/README.md +15 -0
  493. package/memory/40-delivery/backlog.md +15 -0
  494. package/memory/40-delivery/current-sprint.md +21 -0
  495. package/memory/50-orchestration/gsd-harness.md +55 -0
  496. package/memory/90-decisions/0001-memoria-hierarquica.md +38 -0
  497. package/memory/90-decisions/0002-sqlite-fts5-busca.md +25 -0
  498. package/memory/90-decisions/0003-smart-context-3-modos.md +31 -0
  499. package/memory/90-decisions/0004-validacao-obrigatoria-nest.md +27 -0
  500. package/memory/90-decisions/0005-handoff-7-campos.md +32 -0
  501. package/memory/90-decisions/0006-docs-por-persona.md +23 -0
  502. package/memory/90-decisions/0007-sdd-pipeline.md +33 -0
  503. package/memory/90-decisions/0008-sub-agents-claude-handoff-sqlite.md +36 -0
  504. package/memory/90-decisions/0009-claude-hooks-token-economy.md +43 -0
  505. package/memory/90-decisions/0010-banco-postgres.md +30 -0
  506. package/memory/90-decisions/0011-adrs-de-produto-realocadas.md +19 -0
  507. package/memory/90-decisions/0016-integracao-capacidades-externas.md +64 -0
  508. package/memory/90-decisions/0017-codegraph-no-harness-gsd.md +40 -0
  509. package/memory/90-decisions/0018-ferramentas-de-processo.md +46 -0
  510. package/memory/90-decisions/0019-workspace-separado.md +45 -0
  511. package/memory/90-decisions/0020-forja-core-cli-unica.md +45 -0
  512. package/memory/90-decisions/_template.md +28 -0
  513. package/package.json +107 -0
  514. package/prompts/context-engineer-agent.md +19 -0
  515. package/prompts/governance-agent.md +15 -0
  516. package/prompts/marketing-agent.md +13 -0
  517. package/prompts/orchestrator-agent.md +18 -0
  518. package/prompts/product-agent.md +13 -0
  519. package/prompts/sdd-architect-agent.md +20 -0
  520. package/scripts/agent-harness.mjs +578 -0
  521. package/scripts/agent-router.mjs +189 -0
  522. package/scripts/build-smart-context.js +87 -0
  523. package/scripts/check-standards.js +98 -0
  524. package/scripts/compress-memory.mjs +198 -0
  525. package/scripts/compress-project-memory.js +58 -0
  526. package/scripts/context-ops.mjs +463 -0
  527. package/scripts/dev.mjs +349 -0
  528. package/scripts/extract-global-knowledge.js +52 -0
  529. package/scripts/generate-dashboard.js +59 -0
  530. package/scripts/hook-session-start.mjs +70 -0
  531. package/scripts/hook-user-prompt.mjs +185 -0
  532. package/scripts/memory-schema.mjs +68 -0
  533. package/scripts/pre-commit.sh +102 -0
  534. package/scripts/query-universal-memory.js +50 -0
  535. package/scripts/spec-cli.mjs +193 -0
  536. package/scripts/sprint-manager.js +200 -0
  537. package/scripts/sync-universal-memory.js +278 -0
  538. package/scripts/token-benchmark.mjs +203 -0
  539. package/scripts/tools-doctor.mjs +77 -0
  540. package/specs/README.md +70 -0
  541. package/specs/_templates/plan.md +43 -0
  542. package/specs/_templates/spec.md +43 -0
  543. package/specs/_templates/tasks.md +32 -0
  544. package/specs/agent-dashboard/plan.md +165 -0
  545. package/specs/agent-dashboard/spec.md +89 -0
  546. package/specs/agent-dashboard/tasks.md +168 -0
  547. package/specs/cli-first-operacao/plan.md +53 -0
  548. package/specs/cli-first-operacao/spec.md +53 -0
  549. package/specs/cli-first-operacao/tasks.md +53 -0
  550. package/specs/dev-token-assets-db/plan.md +71 -0
  551. package/specs/dev-token-assets-db/spec.md +58 -0
  552. package/specs/dev-token-assets-db/tasks.md +58 -0
  553. package/specs/forja-core/spec.md +71 -0
  554. package/specs/harness-codegraph/spec.md +71 -0
  555. package/specs/pipeline-sdd-e-orquestracao/spec.md +61 -0
  556. package/specs/reestruturacao-forja-v2/plan.md +95 -0
  557. package/specs/reestruturacao-forja-v2/spec.md +70 -0
  558. package/specs/reestruturacao-forja-v2/tasks.md +113 -0
@@ -0,0 +1,168 @@
1
+ # Tasks: agent-dashboard
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Criado em**: 2026-05-11
6
+
7
+ Decomposição em 12 tasks. Estimativas: P=≤2h, M=2-6h, G=6h+. Ordem reflete execução padrão; T2-T9 podem rodar em paralelo após T1.
8
+
9
+ ---
10
+
11
+ ## T1 — Bootstrap do projeto `dashboard/`
12
+ - **Owner**: Worker
13
+ - **Estimativa**: P
14
+ - **Depende de**: —
15
+ - **Paths**: `dashboard/package.json`, `dashboard/server/index.mjs`, `dashboard/.gitignore`, `package.json` (root)
16
+ - **Done quando**:
17
+ - [ ] `dashboard/package.json` com fastify, @fastify/static, @fastify/cors, better-sqlite3
18
+ - [ ] `dashboard/server/index.mjs` sobe Fastify em 127.0.0.1:7777 com `GET /api/health` → `{ok:true}`
19
+ - [ ] Root `package.json` ganha script `"dashboard": "cd dashboard && npm start"`
20
+ - [ ] `.gitignore` ignora `dashboard/node_modules`, `dashboard/web/dist`
21
+ - [ ] `npm run dashboard` sobe sem erro
22
+
23
+ ## T2 — Allowlist + util de spawn seguro
24
+ - **Owner**: Worker
25
+ - **Estimativa**: P
26
+ - **Depende de**: T1
27
+ - **Paths**: `dashboard/server/lib/allowlist.mjs`, `dashboard/server/lib/run-command.mjs`
28
+ - **Done quando**:
29
+ - [ ] `allowlist.mjs` exporta `COMMAND_ALLOWLIST` exato como no plan §4
30
+ - [ ] `run-command.mjs` valida nome, faz `spawn` sem `shell: true`
31
+ - [ ] Teste: comando fora da allowlist → throw `CommandNotAllowed`
32
+ - [ ] Teste: comando válido devolve stream readable de stdout
33
+
34
+ ## T3 — Rota Specs (read-only)
35
+ - **Owner**: Worker
36
+ - **Estimativa**: P
37
+ - **Depende de**: T1
38
+ - **Paths**: `dashboard/server/routes/specs.mjs`
39
+ - **Done quando**:
40
+ - [ ] `GET /api/specs` lê `specs/*/spec.md`, retorna array conforme contrato §4
41
+ - [ ] `GET /api/specs/:slug` devolve conteúdo cru de spec/plan/tasks
42
+ - [ ] Teste de integração com fixture: 2 specs fake → 2 itens
43
+
44
+ ## T4 — Rota Handoffs com transição
45
+ - **Owner**: Worker
46
+ - **Estimativa**: M
47
+ - **Depende de**: T1
48
+ - **Paths**: `dashboard/server/routes/handoffs.mjs`
49
+ - **Done quando**:
50
+ - [ ] `GET /api/handoffs?status=&to=` consulta `universal.db.handoffs`
51
+ - [ ] `POST /api/handoffs/:id/transition` valida `to ∈ {in_progress,done,cancelled}` e shell-out para `agent-router.mjs`
52
+ - [ ] Teste: transição inválida → 400; válida → 200 + status atualizado
53
+
54
+ ## T5 — Rota Projects
55
+ - **Owner**: Worker
56
+ - **Estimativa**: P
57
+ - **Depende de**: T1
58
+ - **Paths**: `dashboard/server/routes/projects.mjs`
59
+ - **Done quando**:
60
+ - [ ] `GET /api/projects` lê `projects/*`, cruza com SQLite por slug
61
+ - [ ] `last_commit` via `git -C` (null se não-git)
62
+ - [ ] `memory_bytes` = `du -sb` de `projects/<name>/memory/`
63
+
64
+ ## T6 — Rota Tokens (estimador)
65
+ - **Owner**: Worker
66
+ - **Estimativa**: M
67
+ - **Depende de**: T1
68
+ - **Paths**: `dashboard/server/routes/tokens.mjs`, `dashboard/server/lib/token-estimator.mjs`
69
+ - **Done quando**:
70
+ - [ ] `token-estimator.mjs` calcula chars/4 sobre `.context/*` e `memory/60-runs/*.json` agregado por dia
71
+ - [ ] `GET /api/tokens?project=&days=30` devolve série temporal
72
+ - [ ] Resposta < 500ms p95 com 10 projetos (kill criterion §8)
73
+ - [ ] Cada datapoint rotulado como "estimativa"
74
+
75
+ ## T7 — Rota Commands com SSE
76
+ - **Owner**: Worker
77
+ - **Estimativa**: M
78
+ - **Depende de**: T2
79
+ - **Paths**: `dashboard/server/routes/commands.mjs`
80
+ - **Done quando**:
81
+ - [ ] `POST /api/commands/:name` valida allowlist, abre SSE
82
+ - [ ] Eventos `stdout`, `stderr`, `exit` (com código)
83
+ - [ ] Fora da allowlist → 403 `{error:"command not allowlisted"}`
84
+ - [ ] E2E: dispara `spec:check` e recebe ≥1 evento `stdout` + `exit:0`
85
+
86
+ ## T8 — Rota Briefing → spec
87
+ - **Owner**: Worker
88
+ - **Estimativa**: M
89
+ - **Depende de**: T2
90
+ - **Paths**: `dashboard/server/routes/briefing.mjs`, `dashboard/server/lib/briefing-parser.mjs`
91
+ - **Done quando**:
92
+ - [ ] Parser: split parágrafos, detecta keywords (`problema`, `queremos`, `para que <persona>`, `como <persona>`), preenche seções 1-3
93
+ - [ ] `POST /api/briefing` valida `slug` kebab-case, cria via `spec-cli.mjs new`, sobrescreve seções 1-3
94
+ - [ ] Status fica em `draft` (nunca `approved` automático)
95
+ - [ ] Teste com 3 briefings de exemplo: cada um produz spec parseável
96
+
97
+ ## T9 — Frontend bootstrap (Vite + Tailwind + shadcn)
98
+ - **Owner**: Worker
99
+ - **Estimativa**: M
100
+ - **Depende de**: T1
101
+ - **Paths**: `dashboard/web/`
102
+ - **Done quando**:
103
+ - [ ] `dashboard/web/` com Vite + React + Tailwind
104
+ - [ ] shadcn instalado, 3-4 componentes copiados (button, card, badge, dialog)
105
+ - [ ] Layout base: sidebar com 6 links (Briefing, Specs, Handoffs, Tokens, Comandos, Projetos)
106
+ - [ ] `vite build` < 500KB gzipped (NFR)
107
+ - [ ] `npm run dashboard` serve `dist/` via @fastify/static
108
+
109
+ ## T10 — Telas Specs + Handoffs + Projetos
110
+ - **Owner**: Worker
111
+ - **Estimativa**: G
112
+ - **Depende de**: T3, T4, T5, T9
113
+ - **Paths**: `dashboard/web/src/pages/{Specs,Handoffs,Projects}.tsx`
114
+ - **Done quando**:
115
+ - [ ] Specs: tabela com status colorido + drawer com spec/plan/tasks markdown renderizado
116
+ - [ ] Handoffs: 3 colunas kanban com botão de transição
117
+ - [ ] Projetos: cards com badges (specs, handoffs, último commit, memória)
118
+ - [ ] Polling 30s em cada tela
119
+
120
+ ## T11 — Telas Tokens + Comandos + Briefing
121
+ - **Owner**: Worker
122
+ - **Estimativa**: G
123
+ - **Depende de**: T6, T7, T8, T9
124
+ - **Paths**: `dashboard/web/src/pages/{Tokens,Commands,Briefing}.tsx`
125
+ - **Done quando**:
126
+ - [ ] Tokens: gráfico de linha (Recharts) 30d com toggle de projeto
127
+ - [ ] Comandos: 5 botões, painel lateral com stdout/stderr ao vivo via EventSource
128
+ - [ ] Briefing: textarea ≥10 linhas + select de projeto + botão "Gerar spec" → redireciona para `/specs/<slug>`
129
+
130
+ ## T12 — Documentação + handoff de governance
131
+ - **Owner**: Worker → Governance
132
+ - **Estimativa**: P
133
+ - **Depende de**: T10, T11
134
+ - **Paths**: `docs/dashboard.md`, `DOC-MAP.md`, `CHANGELOG.md`
135
+ - **Done quando**:
136
+ - [ ] `docs/dashboard.md` cobre: como subir, porta, allowlist, troubleshooting
137
+ - [ ] `DOC-MAP.md` ganha entrada para o dashboard
138
+ - [ ] `CHANGELOG.md` ganha entrada `[Unreleased]`
139
+ - [ ] Handoff `worker → governance` aberto via `agent-router append`
140
+ - [ ] `npm test` e `npm run spec:check` ambos verdes
141
+
142
+ ---
143
+
144
+ ## Caminho crítico
145
+
146
+ ```
147
+ T1 ─┬─ T2 ─┬─ T7 ─┐
148
+ ├─ T3 ─┤ │
149
+ ├─ T4 ─┤ ├─ T10 ─┐
150
+ ├─ T5 ─┤ │ ├─ T12
151
+ ├─ T6 ─┤ ├─ T11 ─┘
152
+ ├─ T9 ─┘ │
153
+ └─ T2 → T8 ───┘
154
+ ```
155
+
156
+ T1 destrava todas. T10 espera rotas read-only + frontend base. T11 espera rotas mutáveis + frontend base. T12 fecha com Governance.
157
+
158
+ ## Handoffs sugeridos
159
+
160
+ Quando T1 concluir:
161
+ ```bash
162
+ node scripts/agent-router.mjs append '{"from":"sdd-architect","to":"worker","intent":"implement","context":"specs/agent-dashboard/plan.md §2-§5; tasks.md T2-T9 destravadas","acceptance":"rotas /api/* respondem com schema do plan §4; testes verdes","constraints":"allowlist hard-coded; bind 127.0.0.1; sem shell:true","return":"PR + handoff para governance","spec_slug":"agent-dashboard"}'
163
+ ```
164
+
165
+ Antes do merge (após T11):
166
+ ```bash
167
+ node scripts/agent-router.mjs append '{"from":"worker","to":"governance","intent":"review","context":"PR agent-dashboard; rotas + 5 telas + allowlist","acceptance":"project:check verde, spec:check verde, auditoria de RCE na rota /api/commands","constraints":"bloquear merge se allowlist contornável","return":"veredicto APROVADO ou findings","spec_slug":"agent-dashboard"}'
168
+ ```
@@ -0,0 +1,53 @@
1
+ # Plan: cli-first-operacao
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-06-02
6
+
7
+ ## 1. Abordagem tecnica
8
+ Manter o dashboard existente como opcional e mover a operacao principal para comandos. Corrigir o gerenciador de sprint para funcionar no repositorio raiz, aceitar backlog RICE e expor encerramento de sprint no `package.json`. Ajustar GSD para nao exigir design em fluxo sem UI.
9
+
10
+ ## 2. Modulos afetados
11
+ | Caminho | Mudanca | Risco |
12
+ |---|---|---|
13
+ | `scripts/sprint-manager.js` | default para raiz e suporte a tabela RICE | M |
14
+ | `scripts/agent-harness.mjs` | `gsd:check` aceita CLI-only sem brief visual | B |
15
+ | `scripts/dev.mjs` | saida textual mais limpa | B |
16
+ | `scripts/check-standards.js` | `project:check` valida root sem argumento | B |
17
+ | `package.json` | novos aliases de operacao | B |
18
+ | `README.md`, `AGENTS.md`, `docs/*` | documentar CLI-first | B |
19
+
20
+ ## 3. Fluxo
21
+ ```
22
+ sprint:start/status
23
+ -> context:build
24
+ -> gsd:plan
25
+ -> gsd:handoff spec/plan/implement/review
26
+ -> gsd:check
27
+ -> project:check
28
+ ```
29
+
30
+ ## 4. Contratos
31
+ - `npm run sprint:start [projeto]`
32
+ - `npm run sprint:status [projeto]`
33
+ - `npm run sprint:complete [projeto]`
34
+ - `npm run gsd:check -- <slug> [brief.md]`
35
+
36
+ Sem `brief.md`, o check considera design como nao aplicavel.
37
+
38
+ ## 5. Decisoes
39
+ **D1**: Nao remover o dashboard agora. Ele fica legado/opcional para evitar quebra de scripts e preservar historico.
40
+
41
+ **D2**: Backlog RICE nao e modificado ao iniciar sprint. A sprint recebe uma selecao operacional dos P0/P1.
42
+
43
+ ## 6. Dependencias
44
+ - Sem novos pacotes.
45
+ - Sem migracao de banco.
46
+
47
+ ## 7. Rollout
48
+ - Documentacao atualizada no README, AGENTS e guia CLI-first.
49
+ - Testes de CLI executados localmente.
50
+
51
+ ## 8. Sinais de fracasso
52
+ - Operador ainda precisar abrir web para acompanhar sprint.
53
+ - `gsd:check` bloquear tarefa CLI-only por ausencia de brief visual.
@@ -0,0 +1,53 @@
1
+ # Spec: cli-first-operacao
2
+
3
+ - **ID**: SPEC-CLI-FIRST-001
4
+ - **Status**: done
5
+ - **Owner**: orchestrator
6
+ - **Criado em**: 2026-06-02
7
+ - **Sprint alvo**: refinamento-cli-2026-06
8
+ - **ADRs relacionadas**: ADR-0005, ADR-0007, ADR-0008
9
+
10
+ ## 1. Problema
11
+ O projeto tinha forte presenca de dashboard/web e referencias visuais na entrada operacional. Isso poluia a operacao diaria e desviava o uso do objetivo principal: orquestracao, SDD, GSD, sprints e handoffs por comandos.
12
+
13
+ ## 2. Proposta de valor
14
+ Operar o framework pelo terminal com sprints, contexto, specs, handoffs, checks e governanca em uma trilha curta e repetivel.
15
+
16
+ ## 3. User stories
17
+ - **Como** operador do framework, **quero** acompanhar sprints pelo CLI, **para que** eu nao dependa da web para saber o proximo passo.
18
+ - **Como** Orchestrator, **quero** registrar handoffs GSD pelo CLI, **para que** SDD e governanca tenham rastreabilidade.
19
+ - **Como** Governance, **quero** validar entregas CLI-only sem brief visual, **para que** design nao bloqueie trabalho sem UI.
20
+
21
+ ## 4. Criterios de aceite
22
+ - [x] AC-1: `npm run sprint:start/status/complete` funciona no repositorio raiz sem argumento de projeto.
23
+ - [x] AC-2: backlog em tabela RICE gera sprint com itens P0/P1.
24
+ - [x] AC-3: `gsd:check` nao exige brief visual quando a entrega e CLI-only.
25
+ - [x] AC-4: README, AGENTS e docs apontam CLI-first como caminho operacional principal.
26
+ - [x] AC-5: dashboard/web permanece opcional/legado, nao gate operacional.
27
+ - [x] AC-6: `npm run project:check` valida o framework raiz quando chamado sem projeto.
28
+
29
+ ## 5. Escopo
30
+ **Dentro**:
31
+ - Scripts de sprint e GSD.
32
+ - Check de governanca do projeto raiz.
33
+ - Documentacao de operacao CLI-first.
34
+ - Reducao de ruido visual no CLI principal.
35
+
36
+ **Fora**:
37
+ - Remover fisicamente o dashboard.
38
+ - Reescrever frontend.
39
+ - Alterar SQLite ou schema de handoffs.
40
+
41
+ ## 6. NFRs / restricoes
42
+ - Compatibilidade: manter comandos existentes.
43
+ - Operabilidade: saida de terminal simples, sem depender de browser.
44
+ - Governanca: preservar ADR-0005 e fluxo SDD.
45
+
46
+ ## 7. Riscos e mitigacao
47
+ | Risco | Probabilidade | Impacto | Mitigacao |
48
+ |---|---|---|---|
49
+ | Usuarios ainda abrirem dashboard por habito | M | B | README e AGENTS priorizam CLI-first |
50
+ | Sprint duplicar itens de backlog RICE | B | B | Tabela RICE nao e removida; sprint vira selecao operacional |
51
+
52
+ ## 8. Metricas de sucesso
53
+ Em 30 dias, 90% das execucoes de sprint e handoff devem ser feitas por CLI, com `gsd:check` e `project:check` usados antes de entrega.
@@ -0,0 +1,53 @@
1
+ # Tasks: cli-first-operacao
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: done
6
+ - **Criado em**: 2026-06-02
7
+
8
+ ## T1 - Corrigir sprint CLI
9
+ - **Owner**: Worker
10
+ - **Estimativa**: P
11
+ - **Depende de**: -
12
+ - **Paths**: `scripts/sprint-manager.js`, `package.json`
13
+ - **Done quando**:
14
+ - [x] sprint funciona no repositorio raiz sem projeto
15
+ - [x] backlog RICE P0/P1 gera itens de sprint
16
+ - [x] `sprint:complete` esta exposto no npm
17
+
18
+ ## T2 - Ajustar GSD CLI-only
19
+ - **Owner**: Worker
20
+ - **Estimativa**: P
21
+ - **Depende de**: T1
22
+ - **Paths**: `scripts/agent-harness.mjs`
23
+ - **Done quando**:
24
+ - [x] `gsd:check <slug>` nao falha por ausencia de brief visual
25
+
26
+ ## T3 - Reduzir ruido do CLI
27
+ - **Owner**: Worker
28
+ - **Estimativa**: P
29
+ - **Depende de**: -
30
+ - **Paths**: `scripts/dev.mjs`
31
+ - **Done quando**:
32
+ - [x] help e checks usam texto simples
33
+
34
+ ## T4 - Documentar operacao
35
+ - **Owner**: Orchestrator
36
+ - **Estimativa**: P
37
+ - **Depende de**: T1, T2
38
+ - **Paths**: `README.md`, `AGENTS.md`, `docs/cli-first-operacao.md`, `docs/quick-reference.md`, `memory/50-orchestration/gsd-harness.md`
39
+ - **Done quando**:
40
+ - [x] CLI-first e caminho principal documentado
41
+ - [x] dashboard descrito como opcional/legado
42
+
43
+ ## T5 - Corrigir gate de governanca raiz
44
+ - **Owner**: Governance
45
+ - **Estimativa**: P
46
+ - **Depende de**: T4
47
+ - **Paths**: `scripts/check-standards.js`
48
+ - **Done quando**:
49
+ - [x] `npm run project:check` valida o framework raiz sem exigir nome de projeto
50
+ - [x] saida usa texto simples
51
+
52
+ ## Handoffs entre agentes
53
+ Fluxo aplicavel: Product -> SDD Architect -> Worker -> Governance via `npm run gsd:handoff -- <fase> cli-first-operacao`.
@@ -0,0 +1,71 @@
1
+ # Plan: dev-token-assets-db
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Status**: approved
5
+ - **Criado em**: 2026-06-02
6
+
7
+ ## 1. Abordagem tecnica
8
+ Adicionar comandos CLI pequenos e aditivos. `context-ops.mjs` gera artefatos compactos e mede token budget. `memory-schema.mjs` cria tabelas auxiliares no SQLite sem alterar contratos existentes. O catalogo de boilerplates/design e derivado dos arquivos atuais, evitando manutencao manual inicial.
9
+
10
+ ## 2. Modulos afetados
11
+ | Caminho | Mudanca | Risco |
12
+ |---|---|---|
13
+ | `scripts/context-ops.mjs` | novo CLI para budget, sprint pack, brief e catalogo | M |
14
+ | `scripts/memory-schema.mjs` | novo schema auxiliar SQLite | M |
15
+ | `package.json` | expor scripts operacionais | B |
16
+ | `docs/manual-operacional-cli-sdd-gsd.md` | orientar nova rotina | B |
17
+ | `.context/` | novos artefatos gerados | B |
18
+
19
+ ## 3. Fluxo
20
+ ```text
21
+ context:sprint
22
+ -> le sprint, specs, handoffs, ADRs
23
+ -> gera .context/sprint-pack.md
24
+ -> registra context_run no SQLite
25
+
26
+ agent:brief <role> <slug>
27
+ -> le spec/plan/tasks/runbook/handoffs
28
+ -> gera .context/agent-brief-<role>-<slug>.md
29
+
30
+ context:budget <slug|arquivo>
31
+ -> estima tokens
32
+ -> compara com limite
33
+ -> falha se exceder
34
+
35
+ catalog:assets
36
+ -> varre boilerplates/design-md
37
+ -> gera .context/asset-catalog.md
38
+ -> popula asset_catalog
39
+ ```
40
+
41
+ ## 4. Contratos
42
+ ```bash
43
+ npm run memory:schema
44
+ npm run context:budget -- <slug|arquivo> [limite]
45
+ npm run context:sprint
46
+ npm run agent:brief -- <role> <slug>
47
+ npm run catalog:assets
48
+ npm run token:benchmark
49
+ ```
50
+
51
+ ## 5. Decisoes
52
+ **D1**: Usar SQLite relacional auxiliar em vez de embeddings nesta fase. Motivo: menor complexidade e sem dependencia externa.
53
+
54
+ **D2**: Catalogo gerado, nao escrito manualmente. Motivo: reduz drift.
55
+
56
+ **D3**: Budget por estimativa simples `chars / 4`. Motivo: suficiente para gate operacional e sem dependencia de tokenizer.
57
+
58
+ ## 6. Dependencias
59
+ - `better-sqlite3`, ja existente.
60
+ - Sem rede e sem pacotes novos.
61
+
62
+ ## 7. Rollout
63
+ - Criar schema auxiliar.
64
+ - Gerar sprint pack e asset catalog.
65
+ - Rodar budget nos novos artefatos.
66
+ - Atualizar manual.
67
+
68
+ ## 8. Sinais de fracasso
69
+ - Context pack ultrapassar 8k tokens sem motivo.
70
+ - Agent brief repetir spec inteira.
71
+ - Catalogo exigir manutencao manual constante.
@@ -0,0 +1,58 @@
1
+ # Spec: dev-token-assets-db
2
+
3
+ - **ID**: SPEC-DEV-TOKEN-ASSETS-001
4
+ - **Status**: done
5
+ - **Owner**: orchestrator
6
+ - **Criado em**: 2026-06-02
7
+ - **Sprint alvo**: refinamento-cli-2026-06
8
+ - **ADRs relacionadas**: ADR-0003, ADR-0005, ADR-0007, ADR-0008, ADR-0009
9
+
10
+ ## 1. Problema
11
+ O framework ja possui SDD, GSD, memoria SQLite, boilerplates e design-md, mas ainda consome contexto demais porque nao ha gate de budget por tarefa, resumo compacto por sprint, brief de agente ou catalogo operacional dos assets. Boilerplates e design system tambem existem como arquivos soltos, sem indice consultavel no banco.
12
+
13
+ ## 2. Proposta de valor
14
+ Transformar contexto, boilerplates, referencias de design e metadados de specs em ativos operacionais compactos, consultaveis por CLI e armazenaveis no SQLite, reduzindo tokens e aumentando velocidade de desenvolvimento.
15
+
16
+ ## 3. User stories
17
+ - **Como** Orchestrator, **quero** gerar um sprint pack compacto, **para que** qualquer agente comece com contexto minimo suficiente.
18
+ - **Como** Worker, **quero** receber um agent brief por papel e feature, **para que** eu nao precise carregar spec/plan/tasks inteiros sempre.
19
+ - **Como** Governance, **quero** bloquear contextos acima do budget, **para que** a operacao nao desperdice tokens.
20
+ - **Como** Architect, **quero** catalogar boilerplates e referencias de design, **para que** a escolha de base tecnica/visual seja rastreavel.
21
+ - **Como** operador do framework, **quero** metadados no SQLite, **para que** memoria, specs e assets sejam consultaveis sem varrer o repositorio inteiro.
22
+
23
+ ## 4. Criterios de aceite
24
+ - [x] AC-1: `npm run context:budget -- <slug|arquivo>` estima tokens e falha acima do limite.
25
+ - [x] AC-2: `npm run context:sprint` gera `.context/sprint-pack.md`.
26
+ - [x] AC-3: `npm run agent:brief -- <role> <slug>` gera brief compacto por papel.
27
+ - [x] AC-4: `npm run catalog:assets` gera catalogo de boilerplates/design-md.
28
+ - [x] AC-5: `npm run memory:schema` cria tabelas auxiliares para summaries, context runs e asset catalog.
29
+ - [x] AC-6: boilerplates tem manifests padronizados com stack, casos de uso, comandos e gates.
30
+ - [x] AC-7: design-md tem tokens/padroes normalizados por superficie.
31
+ - [x] AC-8: `sync:universal` popula tabelas auxiliares automaticamente.
32
+
33
+ ## 5. Escopo
34
+ **Dentro**:
35
+ - CLI para budget, sprint pack, agent brief e catalogo.
36
+ - Schema auxiliar SQLite para armazenamento melhor.
37
+ - Documentacao operacional da estrategia.
38
+
39
+ **Fora**:
40
+ - Reescrever todos os boilerplates nesta primeira tranche.
41
+ - Migrar dashboard web.
42
+ - Implementar embeddings vetoriais.
43
+
44
+ ## 6. NFRs / restricoes
45
+ - Compatibilidade: manter scripts existentes.
46
+ - Token economy: contextos operacionais devem ficar abaixo de 8k tokens por padrao.
47
+ - Banco: tabelas novas devem ser aditivas, sem quebrar `memory_nodes` ou `handoffs`.
48
+ - Operacao: tudo deve rodar por CLI.
49
+
50
+ ## 7. Riscos e mitigacao
51
+ | Risco | Probabilidade | Impacto | Mitigacao |
52
+ |---|---|---|---|
53
+ | Catalogo virar mais uma fonte duplicada | M | M | Gerar via CLI a partir dos arquivos reais |
54
+ | Budget bloquear contexto necessario | M | B | Permitir limite customizado por argumento |
55
+ | Schema auxiliar ficar desssincronizado | M | M | Planejar AC-8 para integrar ao sync |
56
+
57
+ ## 8. Metricas de sucesso
58
+ Em 30 dias, reduzir em pelo menos 40% o tamanho medio do contexto inicial por tarefa e manter `context:budget` verde em entregas novas.
@@ -0,0 +1,58 @@
1
+ # Tasks: dev-token-assets-db
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: done
6
+ - **Criado em**: 2026-06-02
7
+
8
+ ## T1 - Schema auxiliar de memoria
9
+ - **Owner**: Worker
10
+ - **Estimativa**: P
11
+ - **Depende de**: -
12
+ - **Paths**: `scripts/memory-schema.mjs`
13
+ - **Done quando**:
14
+ - [x] cria `spec_summaries`
15
+ - [x] cria `context_runs`
16
+ - [x] cria `asset_catalog`
17
+
18
+ ## T2 - Operacoes de contexto/token
19
+ - **Owner**: Worker
20
+ - **Estimativa**: M
21
+ - **Depende de**: T1
22
+ - **Paths**: `scripts/context-ops.mjs`, `package.json`
23
+ - **Done quando**:
24
+ - [x] `context:budget` mede tokens
25
+ - [x] `context:sprint` gera sprint pack
26
+ - [x] `agent:brief` gera brief por papel/slug
27
+ - [x] `catalog:assets` cataloga boilerplates/design-md
28
+ - [x] `token:benchmark` esta exposto
29
+
30
+ ## T3 - Melhorar boilerplates
31
+ - **Owner**: SDD Architect
32
+ - **Estimativa**: M
33
+ - **Depende de**: T2
34
+ - **Paths**: `boilerplates/**`
35
+ - **Done quando**:
36
+ - [x] cada boilerplate tem manifesto padrao
37
+ - [x] cada manifesto descreve stack, comandos, gates, tokens e casos de uso
38
+
39
+ ## T4 - Melhorar design system
40
+ - **Owner**: SDD Architect
41
+ - **Estimativa**: M
42
+ - **Depende de**: T2
43
+ - **Paths**: `design-md/**`
44
+ - **Done quando**:
45
+ - [x] referencias tem metadados normalizados por superficie
46
+ - [x] tokens visuais recomendados ficam consultaveis pelo catalogo
47
+
48
+ ## T5 - Integrar sync do banco
49
+ - **Owner**: Worker
50
+ - **Estimativa**: M
51
+ - **Depende de**: T1, T2
52
+ - **Paths**: `scripts/sync-universal-memory.js`
53
+ - **Done quando**:
54
+ - [x] sync popula tabelas auxiliares sem comando separado
55
+ - [x] schema continua aditivo e compativel
56
+
57
+ ## Handoffs entre agentes
58
+ Use `npm run gsd:handoff -- implement dev-token-assets-db` para primeira tranche e `npm run gsd:handoff -- review dev-token-assets-db` antes de governanca.
@@ -0,0 +1,71 @@
1
+ # Spec: forja-core
2
+
3
+ - **ID**: SPEC-025
4
+ - **Status**: done
5
+ - **Owner**: framework-team
6
+ - **Criado em**: 2026-07-06
7
+ - **Sprint alvo**: core-2026-07
8
+ - **ADRs relacionadas**: ADR-0020 (core CLI única), ADR-0019 (workspace separado), ADR-0005 (handoff 7 campos), ADR-0017 (codegraph no GSD)
9
+
10
+ ## 1. Problema
11
+ O Forja se apresenta como framework de orquestração, mas os comandos não passam por um núcleo comum. Hoje existem **três dispatchers paralelos**:
12
+
13
+ 1. `scripts/agent-harness.mjs` — workspace, GSD, design, code intelligence (com gates próprios).
14
+ 2. `scripts/dev.mjs` — context, memória, project:health (registry próprio, duplica `design:*`/`gsd:*`).
15
+ 3. `package.json` — ~40 scripts npm apontando direto para 15+ scripts soltos (`spec-cli`, `sprint-manager`, `sync-universal-memory`, `context-ops`, …), inclusive com a chave `project:check` **duplicada** (a primeira definição é silenciosamente descartada pelo npm).
16
+
17
+ Consequências mensuráveis:
18
+ - Nenhuma trilha de auditoria unificada: não dá para responder "quais comandos rodaram nesta feature?" sem grep em N lugares.
19
+ - Gates aplicados de forma desigual: `gsd:check` valida codegraph, mas `spec:tasks` e `sprint:start` não validam nada do processo.
20
+ - O workspace (ADR-0019) é resolvido por alguns comandos e ignorado por outros — um comando de produto pode rodar sem workspace e falhar tarde ou agir no lugar errado.
21
+ - Projetos gerados não são registrados em lugar nenhum: `project:new` cria a pasta e termina; a ficha em `memory/30-projects/` depende de disciplina manual.
22
+
23
+ ## 2. Proposta de valor
24
+ Uma **CLI única `forja`** (bin/forja.mjs) vira o core executivo do framework: todo comando passa por um registry declarativo, com gates transversais (workspace, processo) e **trilha de auditoria** append-only. Projetos passam pelo core no nascimento (registro automático de ficha no workspace). Os dispatchers existentes viram implementação interna — nada é reescrito, tudo é roteado.
25
+
26
+ ## 3. User stories
27
+ - **Como** operador do Forja, **quero** rodar `forja <comando>` (ou `npm run <alias>`) e ter um único ponto de entrada com help agrupado por domínio, **para que** eu não precise decorar qual script implementa o quê.
28
+ - **Como** governance, **quero** que toda execução de comando seja registrada em `.context/forja-runs.jsonl` (comando, args, exit code, duração), **para que** o review de uma feature tenha trilha de auditoria do processo.
29
+ - **Como** operador, **quero** que comandos de produto falhem cedo e com instrução clara quando o workspace não existe, **para que** nada rode no lugar errado (ADR-0019).
30
+ - **Como** orchestrator, **quero** que `project:new` registre automaticamente a ficha do projeto em `memory/30-projects/` do workspace, **para que** todo projeto nasça rastreado pelo core.
31
+
32
+ ## 4. Critérios de aceite (Definition of Done)
33
+ - [ ] AC-1: `node bin/forja.mjs` (sem args) lista todos os comandos agrupados por domínio; `forja <cmd> --help` ou comando desconhecido orienta com exit ≠ 0 no caso de erro.
34
+ - [ ] AC-2: existe `lib/core/registry.mjs` declarativo: cada comando tem domínio, descrição, alvo (script/binário) e gates; teste automatizado garante que todo script referenciado existe.
35
+ - [ ] AC-3: toda execução via core gera uma linha JSON em `<workspace>/.context/forja-runs.jsonl` (fallback: `.context/` do repo quando não há workspace) com ts, cmd, args, exitCode e durationMs.
36
+ - [ ] AC-4: comandos marcados com gate `workspace` falham cedo com mensagem "rode forja workspace:init" quando o workspace não existe.
37
+ - [ ] AC-5: os scripts npm do `package.json` roteiam pelo core (`node bin/forja.mjs <cmd>`); a chave duplicada `project:check` é eliminada; `forja` entra em `"bin"` do pacote.
38
+ - [ ] AC-6: `project:new` bem-sucedido grava/atualiza ficha do projeto em `<workspace>/memory/30-projects/<nome>.md`.
39
+ - [ ] AC-7: `npm test` cobre registry, help, comando desconhecido e gate de workspace; suíte existente continua verde.
40
+
41
+ ## 5. Escopo
42
+ **Dentro**:
43
+ - `bin/forja.mjs` (dispatcher), `lib/core/registry.mjs` (registry + gates)
44
+ - `package.json`: bin `forja`, rewire dos scripts, remoção da duplicata
45
+ - `scripts/agent-harness.mjs`: ficha automática no `project:new`
46
+ - `test/forja-core.test.js`
47
+ - README/DOC-MAP: documentar o core como ponto de entrada
48
+
49
+ **Fora** (explícito, evita scope creep):
50
+ - Reescrever `dev.mjs`, `spec-cli.mjs`, `sprint-manager.js` etc. — continuam como implementação; `dev.mjs` fica como alias legado documentado
51
+ - Embutir a CLI `forja` nos projetos gerados (`lib/generators/`) — fase 2, spec própria
52
+ - Dashboard (`dashboard:*`) — front opcional, fora do processo
53
+ - Gravar auditoria no SQLite (JSONL primeiro; promoção a tabela é evolução futura)
54
+
55
+ ## 6. NFRs / restrições
56
+ - Zero dependências novas (Node stdlib apenas).
57
+ - Overhead do roteamento imperceptível (< 100ms além do script alvo).
58
+ - Degradação graciosa: auditoria nunca bloqueia o comando (falha de escrita = warning).
59
+ - Compatibilidade: todos os aliases npm atuais continuam funcionando com a mesma semântica.
60
+ - pt-BR em toda saída de CLI.
61
+
62
+ ## 7. Riscos e mitigação
63
+ | Risco | Probabilidade | Impacto | Mitigação |
64
+ |---|---|---|---|
65
+ | Duplo spawn (npm → forja → script) mascarar exit codes | B | A | Propagar `status` do filho sempre; testes de exit code |
66
+ | Registry divergir dos scripts reais | M | M | Teste de integridade (todo alvo existe no disco) |
67
+ | Gate de workspace bloquear fluxo legítimo do framework | M | M | Gate só em comandos de domínio de produto; framework roda sem workspace |
68
+ | JSONL de auditoria crescer sem limite | B | B | Arquivo em `.context/` (gitignored); rotação futura via `memory:compress` |
69
+
70
+ ## 8. Métricas de sucesso
71
+ 30 dias após o release: (a) 100% dos comandos de processo listados no help do core; (b) `forja-runs.jsonl` presente e usado em pelo menos um review de governance; (c) zero projetos criados sem ficha em `30-projects/`.
@@ -0,0 +1,71 @@
1
+ # Spec: harness-codegraph
2
+
3
+ - **ID**: SPEC-024
4
+ - **Status**: done
5
+ - **Owner**: framework-team
6
+ - **Criado em**: 2026-06-27
7
+ - **Sprint alvo**: harness-2026-06
8
+ - **ADRs relacionadas**: ADR-0017 (codegraph no harness GSD), ADR-0018 (ferramentas de processo)
9
+
10
+ ## 1. Problema
11
+ O harness GSD/Hermes está sólido (10 gates, handoffs de 7 campos), mas três furos impedem que ele seja a base confiável dos próximos projetos:
12
+
13
+ 1. **Codegraph é uma integração pendurada.** Está instalado (`~/.local/bin/codegraph`), com MCP em `.mcp.json` e scripts `code:*`, mas **nenhum gate do GSD e nenhum papel o usa**. O Worker recebe "implemente `tasks.md`" sem nunca consultar o blast radius de um símbolo antes de editar.
14
+ 2. **O índice codegraph apontava para o worktree errado** (`2-Projeto-Agents` pai em vez de `projects/forja`), retornando símbolos da árvore errada — silenciosamente.
15
+ 3. **O gerador (`bin/init-project.js` + `lib/generators/`) não emite nada disso.** Projetos novos não herdam `.mcp.json`, scripts `code:*`, o `agent-harness.mjs` nem os gates GSD. A estrutura morre no framework-raiz.
16
+
17
+ Mede-se hoje a dor pela ausência: zero consultas codegraph nos handoffs registrados, zero gates de código, e `codegraph status` emitindo warning de worktree.
18
+
19
+ ## 2. Proposta de valor
20
+ O codegraph vira **passo verificável do fluxo GSD** (mapa de impacto antes de implementar, freshness no gate de governança), e todo projeto gerado herda o harness completo — codegraph, `code:*`, GSD e ferramentas de processo — sem configuração manual.
21
+
22
+ ## 3. User stories
23
+ - **Como** SDD Architect, **quero** rodar `code:impact <símbolo>` para ver chamadores e blast radius, **para que** o `plan.md` liste módulos afetados com evidência, não chute
24
+ - **Como** Worker, **quero** que o runbook GSD me obrigue a mapear impacto antes de editar, **para que** eu não quebre chamadores fora do escopo
25
+ - **Como** Governance, **quero** que `gsd:check` falhe se o índice codegraph estiver no worktree errado ou defasado, **para que** consultas de código sejam confiáveis no review
26
+ - **Como** usuário gerando projeto novo, **quero** que `init-project` já entregue `.mcp.json` + `code:*` + GSD, **para que** o novo projeto nasça com o harness completo
27
+ - **Como** Governance, **quero** um `tools:doctor` que detecta ferramentas de processo (codegraph, gitleaks, ast-grep, lefthook), **para que** eu saiba o que está disponível antes de exigir um gate
28
+
29
+ ## 4. Critérios de aceite (Definition of Done)
30
+ - [x] AC-1: `npm run code:check` valida que o índice codegraph existe, pertence a este worktree e não está defasado; exit≠0 caso contrário
31
+ - [x] AC-2: `npm run code:impact <símbolo>` retorna chamadores + arquivos afetados (via codegraph), com fallback claro se o binário não existir
32
+ - [x] AC-3: o runbook gerado por `gsd:plan` inclui um gate "Mapa de impacto (codegraph)" entre Contexto e Plano
33
+ - [x] AC-4: `gsd:check` inclui um gate de freshness/worktree do codegraph (não-bloqueante se codegraph ausente, bloqueante se índice for de outro worktree)
34
+ - [x] AC-5: `init-project` emite no projeto gerado: `.mcp.json` (codegraph), scripts `code:*` e `gsd:*` no `package.json`, e `scripts/agent-harness.mjs`
35
+ - [x] AC-6: `npm run tools:doctor` lista status (instalado/ausente) de codegraph, gitleaks, ast-grep, lefthook, markdownlint
36
+ - [x] AC-7: sub-agents `sdd-architect` e `governance` (+ prompts) instruem uso de codegraph; docs (`AGENTS.md`, `agent-harnesses.md`, `gsd-harness.md`, manual) atualizadas
37
+ - [x] AC-8: `npm test` cobre `code:check`/`code:impact`/`tools:doctor` com degradação graciosa quando binários ausentes
38
+
39
+ ## 5. Escopo
40
+ **Dentro**:
41
+ - `scripts/agent-harness.mjs`: comandos `code:impact`, `code:check`
42
+ - `scripts/tools-doctor.mjs`: doctor de ferramentas de processo
43
+ - `package.json`: scripts `code:impact`, `code:check`, `tools:doctor`
44
+ - Template do runbook GSD + lógica do `gsd:check`
45
+ - `bin/init-project.js` / `lib/generators/`: emissão do harness no projeto gerado
46
+ - `.claude/agents/` + `prompts/` (sdd-architect, governance)
47
+ - Docs: `AGENTS.md`, `docs/agent-harnesses.md`, `memory/50-orchestration/gsd-harness.md`, manual
48
+ - ADR-0017 e ADR-0018
49
+
50
+ **Fora** (explícito, evita scope creep):
51
+ - Reescrever o codegraph ou criar índice próprio (usamos o binário externo)
52
+ - Instalar automaticamente gitleaks/ast-grep/lefthook (apenas detectar + documentar)
53
+ - Tornar design:check obrigatório em fluxo CLI-only (mantém ADR vigente)
54
+ - Mexer em `projects/` (apps reais, off-limits)
55
+
56
+ ## 6. NFRs / restrições
57
+ - Degradação graciosa: nenhum comando novo pode quebrar o fluxo quando codegraph/ferramentas externas não estão instaladas — deve avisar e seguir
58
+ - Determinístico: `code:check`/`tools:doctor` não dependem de rede
59
+ - Compatibilidade: não quebra `init-project.js` para quem não usa codegraph; `.mcp.json` é aditivo
60
+ - pt-BR em toda saída de CLI
61
+
62
+ ## 7. Riscos e mitigação
63
+ | Risco | Probabilidade | Impacto | Mitigação |
64
+ |---|---|---|---|
65
+ | codegraph ausente no ambiente do usuário | M | M | `code:*` degrada com aviso; gate não-bloqueante quando binário falta |
66
+ | Falso bloqueio por índice "defasado" | M | A | Heurística por mtime + warning de worktree do próprio codegraph, nunca por hash de cada arquivo |
67
+ | Gerador inchar projetos que não querem codegraph | B | M | `.mcp.json` e gates são aditivos e documentados como opcionais |
68
+ | Acoplar harness a versão específica do codegraph CLI | M | M | Usar só `init/status/sync` + MCP; parsear saída de forma tolerante |
69
+
70
+ ## 8. Métricas de sucesso
71
+ 30 dias após o release: (a) 100% dos projetos novos gerados saem com `.mcp.json` + `code:*` + GSD; (b) `gsd:check` passando inclui o gate codegraph; (c) pelo menos os papéis Architect/Worker referenciam `code:impact` nos handoffs de implementação registrados no SQLite.