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,70 @@
1
+ # Capacidades externas integradas
2
+
3
+ TrΓͺs produtos open-source foram alocados ao `2-projeto-agents` como capacidades de
4
+ primeira classe (ver [ADR-0016](../memory/90-decisions/0016-integracao-capacidades-externas.md)).
5
+ Antigamente viviam em `projects/`; agora estΓ£o no workspace Forja
6
+ (`~/forja-workspace`, configurΓ‘vel β€” ver [ADR-0019](../memory/90-decisions/0019-workspace-separado.md)).
7
+ Aqui ficam sΓ³ a fiaΓ§Γ£o e o modo de uso.
8
+
9
+ ## 1. codegraph β€” anΓ‘lise de cΓ³digo (MCP)
10
+
11
+ Grafo de cΓ³digo semΓ’ntico, 100% local. Registrado como **servidor MCP** no repo
12
+ (`.mcp.json`) e disponΓ­vel no PATH (`~/.local/bin/codegraph`).
13
+
14
+ **Ferramentas MCP** (aparecem automaticamente em sessΓ΅es Claude Code neste repo):
15
+ - `codegraph_explore` β€” sΓ­mbolos relevantes + call paths de uma Γ‘rea, num disparo sΓ³.
16
+ - `codegraph_node` β€” fonte de um sΓ­mbolo + trilha de callers/callees, ou leitura de arquivo.
17
+
18
+ **CLI / npm scripts:**
19
+ ```bash
20
+ npm run code:index # codegraph init β€” constrΓ³i o Γ­ndice inicial (respeita .gitignore)
21
+ npm run code:sync # sincroniza mudanΓ§as desde o ΓΊltimo Γ­ndice
22
+ npm run code:status # status e estatΓ­sticas do Γ­ndice
23
+ npm run code:query "<termo>" # busca sΓ­mbolos
24
+ codegraph explore "<query>" # exploraΓ§Γ£o ad-hoc
25
+ codegraph callers <sΓ­mbolo> # quem chama um sΓ­mbolo
26
+ ```
27
+
28
+ O Γ­ndice fica em `.codegraph/` (jΓ‘ coberto por `.gitignore` do projeto, se necessΓ‘rio).
29
+
30
+ ## 2. harness β€” orquestraΓ§Γ£o de times de agentes (plugin)
31
+
32
+ Plugin do Claude Code (`harness@harness-marketplace`, instalado e habilitado) que
33
+ transforma uma descriΓ§Γ£o de domΓ­nio em um time de agentes + skills, a partir de 6
34
+ padrΓ΅es: Pipeline, Fan-out/Fan-in, Expert Pool, Producer-Reviewer, Supervisor,
35
+ Hierarchical Delegation.
36
+
37
+ **Uso:** numa sessΓ£o Claude Code, peΓ§a _"build a harness for this project"_ (ou
38
+ _"configure um harness para X"_) e ele gera `.claude/agents/` e `.claude/skills/`
39
+ adequados ao domΓ­nio.
40
+
41
+ **GestΓ£o:**
42
+ ```bash
43
+ claude plugin list # confirmar harness habilitado
44
+ claude plugin marketplace list # confirmar marketplace local
45
+ claude plugin update harness@harness-marketplace
46
+ ```
47
+
48
+ Complementa o sistema de orquestraΓ§Γ£o nativo do framework (AGENTS.md, handoffs,
49
+ `scripts/agent-router.mjs`): harness ajuda a *desenhar* novos times; o framework
50
+ *opera* os handoffs.
51
+
52
+ ## 3. ai-engineering-from-scratch β€” base de conhecimento (referΓͺncia)
53
+
54
+ CurrΓ­culo de AI engineering: 503 liΓ§Γ΅es, 20 fases, 4 linguagens (Python, TypeScript,
55
+ Rust, Julia). Material de referΓͺncia para fundamentar decisΓ΅es tΓ©cnicas de IA do
56
+ framework. NΓ£o hΓ‘ instalaΓ§Γ£o β€” consultar diretamente:
57
+
58
+ - `projects/ai-engineering-from-scratch-main/ROADMAP.md` β€” Γ­ndice das 20 fases.
59
+ - `projects/ai-engineering-from-scratch-main/phases/` β€” liΓ§Γ΅es por fase.
60
+ - `projects/ai-engineering-from-scratch-main/glossary/` β€” glossΓ‘rio.
61
+
62
+ ## ReinstalaΓ§Γ£o
63
+
64
+ Se `projects/` for limpo, recriar a fiaΓ§Γ£o:
65
+ ```bash
66
+ ln -sf "$PWD/projects/codegraph-linux-x64/bin/codegraph" ~/.local/bin/codegraph
67
+ claude mcp add codegraph --scope project -- codegraph serve --mcp
68
+ claude plugin marketplace add "$PWD/projects/harness-main"
69
+ claude plugin install harness@harness-marketplace
70
+ ```
@@ -0,0 +1,74 @@
1
+ # Operacao CLI-First
2
+
3
+ Este framework deve ser operado primeiro por linha de comando. O dashboard web fica como artefato legado/opcional de consulta; nao e gate de entrega, sprint, handoff ou governanca.
4
+
5
+ ## Ciclo Diario
6
+
7
+ ```bash
8
+ npm run sprint:status
9
+ npm run dev -- context:build task <slug> "<palavras-chave>"
10
+ npm run gsd:plan -- <slug> "<objetivo>"
11
+ npm run gsd:handoff -- spec <slug>
12
+ npm run spec:check -- <slug>
13
+ npm run gsd:handoff -- plan <slug>
14
+ npm run gsd:handoff -- implement <slug>
15
+ npm run gsd:check -- <slug>
16
+ npm test
17
+ npm run project:check
18
+ ```
19
+
20
+ ## Sprints
21
+
22
+ No repositorio raiz:
23
+
24
+ ```bash
25
+ npm run sprint:start
26
+ npm run sprint:status
27
+ npm run sprint:complete
28
+ ```
29
+
30
+ Em um projeto do workspace (`~/forja-workspace/projects/<NomeDoProjeto>`):
31
+
32
+ ```bash
33
+ npm run sprint:start -- NomeDoProjeto
34
+ npm run sprint:status -- NomeDoProjeto
35
+ npm run sprint:complete -- NomeDoProjeto
36
+ ```
37
+
38
+ O backlog pode estar em checklist com secao `## Alta Prioridade` ou em tabela RICE. Quando houver tabela RICE, entram na sprint os itens `P0` e `P1` mais bem posicionados.
39
+
40
+ ## SDD + GSD
41
+
42
+ Use SDD para decidir o que sera entregue e GSD para controlar a execucao.
43
+
44
+ 1. Product cria ou completa `specs/<slug>/spec.md`.
45
+ 2. SDD Architect cria `plan.md`, `tasks.md` e ADRs quando houver decisao estrutural.
46
+ 3. Orchestrator registra cada passagem com `gsd:handoff`.
47
+ 4. Worker implementa somente os arquivos do ownership definido.
48
+ 5. Governance roda `gsd:check`, `spec:check`, testes e `project:check`.
49
+
50
+ ## Handoffs Hermes
51
+
52
+ Todo handoff precisa dos 7 campos da ADR-0005:
53
+
54
+ ```bash
55
+ npm run hermes:handoff -- '{"from":"orchestrator","to":"product","intent":"spec","context":"specs/<slug>","acceptance":"spec aprovada com AC testaveis","constraints":"pt-BR; sem codigo nesta fase","return":"orchestrator"}'
56
+ ```
57
+
58
+ Para o fluxo padrao, prefira os atalhos:
59
+
60
+ ```bash
61
+ npm run gsd:handoff -- spec <slug>
62
+ npm run gsd:handoff -- plan <slug>
63
+ npm run gsd:handoff -- implement <slug>
64
+ npm run gsd:handoff -- review <slug>
65
+ ```
66
+
67
+ ## Quando Usar Design/Web
68
+
69
+ Use `design:select` e `design:check` apenas se a tarefa tiver impacto visual real. Em tarefas CLI-only, `gsd:check` nao exige brief visual.
70
+
71
+ ```bash
72
+ npm run design:select -- agent-console tecnico
73
+ npm run design:check -- design-md/examples/agent-console-brief.md
74
+ ```
@@ -0,0 +1,102 @@
1
+ # Dashboard
2
+
3
+ Painel web local para monitorar specs, handoffs e tokens do framework, e disparar comandos da CLI canΓ΄nica.
4
+
5
+ - **LocalizaΓ§Γ£o**: `dashboard/`
6
+ - **Bind**: `127.0.0.1` (nunca expΓ΅e a rede β€” kill criterion da SPEC-002)
7
+ - **Porta default**: `7777` (override via `DASHBOARD_PORT`)
8
+
9
+ ## Subir
10
+
11
+ ```bash
12
+ # Primeira vez β€” instala backend + frontend
13
+ npm run dashboard:install
14
+
15
+ # Build do frontend
16
+ npm run dashboard:web:build
17
+
18
+ # Sobe servidor (serve SPA + API)
19
+ npm run dashboard
20
+ # β†’ http://127.0.0.1:7777
21
+ ```
22
+
23
+ Modo dev (HMR no frontend, backend separado):
24
+
25
+ ```bash
26
+ # terminal 1 β€” API
27
+ npm run dashboard
28
+ # terminal 2 β€” Vite com proxy /api β†’ 7777
29
+ npm run dashboard:web:dev
30
+ # β†’ http://127.0.0.1:5173
31
+ ```
32
+
33
+ ## Telas
34
+
35
+ | Rota | O quΓͺ | Fonte |
36
+ |---|---|---|
37
+ | `/` (Briefing) | Textarea β†’ POST `/api/briefing` β†’ `spec.md` em status `draft` | parser heurΓ­stico (D5) |
38
+ | `/specs` | Tabela com status colorido + drawer com spec/plan/tasks | `specs/*/` |
39
+ | `/handoffs` | Kanban 3 colunas com botΓ΅es de transiΓ§Γ£o | `universal.db.handoffs` |
40
+ | `/tokens` | Linha 30d por projeto, totais agregados | `.context/*` + `60-runs/*.json` |
41
+ | `/commands` | 5 botΓ΅es com painel SSE ao vivo | allowlist hard-coded |
42
+ | `/projects` | Cards com badges (specs, handoffs, commit, memΓ³ria) | `projects/*` + git + SQLite |
43
+
44
+ Polling 30s em todas as telas (pausa quando aba nΓ£o-visΓ­vel).
45
+
46
+ ## Allowlist de comandos (ADR-0009 + plan Β§4 D4)
47
+
48
+ Hard-coded em `dashboard/server/lib/allowlist.mjs`. Qualquer outro nome β†’ `403`.
49
+
50
+ | Nome | Comando |
51
+ |---|---|
52
+ | `spec:check` | `node scripts/spec-cli.mjs check` |
53
+ | `sync:universal` | `node scripts/sync-universal-memory.js` |
54
+ | `memory:vacuum` | `node scripts/compress-memory.mjs` |
55
+ | `project:check` | `node scripts/check-standards.js` |
56
+ | `sprint:status` | `node scripts/sprint-manager.js status` |
57
+
58
+ Para adicionar comando novo: edite a constante, adicione teste, documente aqui β€” exige PR e revisΓ£o.
59
+
60
+ ## Endpoints (API)
61
+
62
+ ```
63
+ GET /api/health
64
+ GET /api/specs
65
+ GET /api/specs/:slug
66
+ GET /api/handoffs?status=&to=&from=&spec=&limit=
67
+ GET /api/handoffs/:id
68
+ POST /api/handoffs/:id/transition body { to }
69
+ GET /api/projects
70
+ GET /api/tokens?project=&days=30
71
+ GET /api/commands
72
+ POST /api/commands/:name SSE
73
+ POST /api/briefing body { brief, slug, projectHint? }
74
+ ```
75
+
76
+ ## Troubleshooting
77
+
78
+ **`EADDRINUSE: 7777`** β€” outra instΓ’ncia jΓ‘ estΓ‘ rodando. Mate com `lsof -ti:7777 | xargs kill` ou use `DASHBOARD_PORT=7778 npm run dashboard`.
79
+
80
+ **`/api/handoffs` retorna `[]` no primeiro acesso** β€” `universal.db` ainda nΓ£o foi criado. Rode `node scripts/agent-router.mjs schema` ou abra qualquer handoff via `agent-router append`.
81
+
82
+ **SPA mostra placeholder em vez das telas** β€” `dashboard/web/dist/` nΓ£o existe. Rode `npm run dashboard:web:build`.
83
+
84
+ **Briefing recusa slug** β€” kebab-case, 2-64 caracteres, comeΓ§ando com letra/dΓ­gito. Use o auto-slug do form.
85
+
86
+ **SSE corta no meio** β€” alguns proxies bufferizam SSE. Mantenha o dashboard em `127.0.0.1` direto, sem reverse proxy.
87
+
88
+ ## SeguranΓ§a
89
+
90
+ - Bind exclusivo em `127.0.0.1` (nΓ£o hΓ‘ flag para abrir para rede β€” proposital)
91
+ - Allowlist literal em cΓ³digo (nΓ£o config) β€” ADR-0009 D4
92
+ - `spawn` sem `shell: true`; sem interpolaΓ§Γ£o de args do body
93
+ - `POST /api/briefing` valida slug com regex e bloqueia conflito de spec existente
94
+ - `POST /api/handoffs/:id/transition` aceita sΓ³ `in_progress | done | cancelled`
95
+ - 95% das telas sΓ£o read-only; mutaΓ§Γ£o sΓ³ via shell-out para a CLI canΓ΄nica
96
+
97
+ ## Limites conhecidos (v1)
98
+
99
+ - Briefing usa heurΓ­stica simples β€” nΓ£o LLM (D5). Sucesso depende do briefing seguir padrΓ£o "Hoje…", "Queremos…", "Como X, quero Y, para que Z".
100
+ - Tokens sΓ£o estimativa por `chars/4`, nΓ£o consumo real da API.
101
+ - Polling 30s; sem WebSocket.
102
+ - Sem auth, sem multi-usuΓ‘rio (intencional β€” kill criterion).
@@ -0,0 +1,421 @@
1
+ # πŸ› οΈ DEV WORKFLOW - Guia de Desenvolvimento Unificado
2
+
3
+ **Status:** Fase 4 - Desenvolvimento Ágil
4
+ **Objetivo:** Unifcar CLI commands, pre-commit validation, health checks, e automatizaΓ§Γ£o
5
+
6
+ ---
7
+
8
+ ## πŸ“‹ VisΓ£o Geral
9
+
10
+ Esta fase cria uma interface unificada para todos os comandos de desenvolvimento, reduzindo complexidade e erros.
11
+
12
+ ```
13
+ npm run dev -- <command> [args]
14
+ ```
15
+
16
+ ---
17
+
18
+ ## 🎯 Comandos Disponíveis
19
+
20
+ ### 1. `context:build` β€” Gerar Contexto Inteligente
21
+
22
+ **Uso:**
23
+ ```bash
24
+ npm run dev -- context:build <mode> <project> [keyword]
25
+ ```
26
+
27
+ **Modos:**
28
+ - `global` β€” Mission + standards + ADRs (~2KB, 500 tokens)
29
+ - `domain` β€” Vision + design + rules (~20KB, 5K tokens)
30
+ - `task` β€” Searchable context + domain (~30KB, 8K tokens)
31
+
32
+ **Exemplos:**
33
+ ```bash
34
+ # Para novo dev (quick overview)
35
+ npm run dev -- context:build global my-project
36
+
37
+ # Para feature development
38
+ npm run dev -- context:build domain my-project
39
+
40
+ # Para debugging especΓ­fico
41
+ npm run dev -- context:build task my-project "payment auth bug"
42
+ ```
43
+
44
+ **Output:**
45
+ - Arquivo: `.context/context-{mode}.md`
46
+ - Metrics: bytes, tokens, estimated cost
47
+
48
+ ---
49
+
50
+ ### 2. `memory:vacuum` β€” Comprimir MemΓ³ria
51
+
52
+ **Uso:**
53
+ ```bash
54
+ npm run dev -- memory:vacuum
55
+ ```
56
+
57
+ **O que faz:**
58
+ - Archive runs > 30 dias β†’ `.memory/archive/`
59
+ - Remove Γ­ndices vazios
60
+ - SQLite VACUUM otimizado
61
+
62
+ **Output:**
63
+ ```
64
+ πŸ“¦ Compression Report
65
+ Before: 2.10 MB
66
+ After: 1.20 MB
67
+ Saved: 0.90 MB (43%)
68
+ ✨ Database within limits
69
+ ```
70
+
71
+ ---
72
+
73
+ ### 3. `memory:sync` β€” Sincronizar Índices
74
+
75
+ **Uso:**
76
+ ```bash
77
+ npm run dev -- memory:sync [project]
78
+ ```
79
+
80
+ **O que faz:**
81
+ - Rebuild FTS5 Γ­ndices
82
+ - Atualiza search weights
83
+ - Limpa stale entries
84
+
85
+ ---
86
+
87
+ ### 4. `project:health` β€” ValidaΓ§Γ£o de SaΓΊde
88
+
89
+ **Uso:**
90
+ ```bash
91
+ npm run dev -- project:health
92
+ ```
93
+
94
+ **Checa:**
95
+ - βœ… Estrutura de diretΓ³rios
96
+ - βœ… Arquivos de configuraΓ§Γ£o
97
+ - βœ… PermissΓ΅es
98
+ - βœ… Database status
99
+ - βœ… Dependencies
100
+
101
+ **Output:**
102
+ ```
103
+ πŸ“ Checking structure...
104
+ βœ… lib/
105
+ βœ… scripts/
106
+ βœ… docs/
107
+ ...
108
+
109
+ βœ… Project health: GOOD
110
+ ```
111
+
112
+ ---
113
+
114
+ ### 5. `project:init` β€” Inicializar Novo Projeto
115
+
116
+ **Uso:**
117
+ ```bash
118
+ npm run dev -- project:init <project-name> [flags]
119
+ ```
120
+
121
+ **Flags:**
122
+ - `--force` β€” Sobrescrever existente
123
+ - `--only-memory` β€” Apenas estrutura de memΓ³ria
124
+ - `--no-gitkeep` β€” Sem .gitkeep em dirs vazios
125
+
126
+ **Exemplo:**
127
+ ```bash
128
+ npm run dev -- project:init awesome-app
129
+ npm run dev -- project:init awesome-app --force
130
+ ```
131
+
132
+ ---
133
+
134
+ ## πŸ”— Pre-Commit Hook
135
+
136
+ **InstalaΓ§Γ£o:**
137
+ ```bash
138
+ cp scripts/pre-commit.sh .git/hooks/pre-commit
139
+ chmod +x .git/hooks/pre-commit
140
+ ```
141
+
142
+ **ValidaΓ§Γ΅es AutomΓ‘ticas:**
143
+ 1. πŸ” Scan for secrets (password, api_key, token)
144
+ 2. πŸ” Check console.log statements
145
+ 3. 🧹 Lint & auto-fix staged files
146
+ 4. πŸ§ͺ Run tests
147
+ 5. πŸ“„ Validate documentation
148
+
149
+ **Bypass (emergΓͺncia):**
150
+ ```bash
151
+ git commit --no-verify
152
+ ```
153
+
154
+ ---
155
+
156
+ ## πŸ₯ Project Health Check
157
+
158
+ **Estrutura validada:**
159
+ ```
160
+ βœ… lib/ (generators, validators, utils)
161
+ βœ… scripts/ (CLI, build, compress)
162
+ βœ… docs/ (documentation)
163
+ βœ… memory/ (project knowledge)
164
+ βœ… agents/ (agent definitions)
165
+ βœ… skills/ (capabilities)
166
+ βœ… prompts/ (instructions)
167
+ ```
168
+
169
+ **Config validada:**
170
+ ```
171
+ βœ… .memoryrc.json (token economy config)
172
+ βœ… package.json (dependencies, scripts)
173
+ βœ… .gitignore (security)
174
+ ```
175
+
176
+ **Key files:**
177
+ ```
178
+ βœ… bin/create-memory-nest-kit.js (generator orchestrator)
179
+ βœ… lib/context-builder.js (context API)
180
+ ```
181
+
182
+ ---
183
+
184
+ ## πŸ“… AutomatizaΓ§Γ£o Schedule
185
+
186
+ ### Memory Vacuum Cron (DiΓ‘rio)
187
+
188
+ **Via Cron Job (Linux/Mac):**
189
+ ```bash
190
+ # Edit crontab
191
+ crontab -e
192
+
193
+ # Add (roda 2h da manhΓ£ todo dia)
194
+ 0 2 * * * cd /path/to/project && npm run dev -- memory:vacuum >> logs/cron.log 2>&1
195
+ ```
196
+
197
+ **Via Windows Task Scheduler:**
198
+ ```batch
199
+ # PowerShell
200
+ $action = New-ScheduledTaskAction -Execute "cmd.exe" `
201
+ -Argument "/c cd C:\path\to\project && npm run dev -- memory:vacuum"
202
+ $trigger = New-ScheduledTaskTrigger -Daily -At 2am
203
+ Register-ScheduledTask -TaskName "ProjectMemoryVacuum" -Action $action -Trigger $trigger
204
+ ```
205
+
206
+ **Via PM2 (Recomendado):**
207
+ ```bash
208
+ npm install -g pm2
209
+
210
+ # Criar ecosystem.config.js
211
+ cat > ecosystem.config.js << 'EOF'
212
+ module.exports = {
213
+ apps: [{
214
+ name: 'memory-vacuum',
215
+ script: 'npm',
216
+ args: 'run dev -- memory:vacuum',
217
+ cron_restart: '0 2 * * *' // 2h da manhΓ£
218
+ }]
219
+ };
220
+ EOF
221
+
222
+ pm2 start ecosystem.config.js
223
+ ```
224
+
225
+ ---
226
+
227
+ ## πŸš€ Workflow TΓ­pico
228
+
229
+ ### InΓ­cio de Dia
230
+
231
+ ```bash
232
+ # 1. Verificar saΓΊde do projeto
233
+ npm run dev -- project:health
234
+
235
+ # 2. Gerar contexto (se iniciando feature nova)
236
+ npm run dev -- context:build domain my-project
237
+ ```
238
+
239
+ ### Durante Desenvolvimento
240
+
241
+ ```bash
242
+ # 1. Fazer alteraΓ§Γ΅es
243
+ vim src/features/auth.ts
244
+
245
+ # 2. Commit automΓ‘tico roda validaΓ§Γ΅es:
246
+ # - Lint (auto-fix)
247
+ # - Tests
248
+ # - No secrets check
249
+ git commit -m "feat: auth implementation"
250
+ ```
251
+
252
+ ### Fim de Semana
253
+
254
+ ```bash
255
+ # 1. Executar manually (ou via cron):
256
+ npm run dev -- memory:vacuum
257
+
258
+ # 2. Verificar novamente
259
+ npm run dev -- project:health
260
+ ```
261
+
262
+ ---
263
+
264
+ ## πŸ”§ ConfiguraΓ§Γ£o Customizada
265
+
266
+ ### Via .memoryrc.json
267
+
268
+ ```json
269
+ {
270
+ "compression": {
271
+ "archiveAge": 30, // dias
272
+ "maxDbSize": 50, // MB
273
+ "vacuumInterval": 86400000 // ms (1 dia)
274
+ },
275
+ "devWorkflow": {
276
+ "preCommitStrict": true,
277
+ "autofixOnCommit": true,
278
+ "requireTests": true,
279
+ "requireCoverage": 80
280
+ }
281
+ }
282
+ ```
283
+
284
+ ### Via Environment Variables
285
+
286
+ ```bash
287
+ # Skip tests
288
+ SKIP_TESTS=1 git commit -m "..."
289
+
290
+ # Dry run
291
+ DRY_RUN=1 npm run dev -- memory:vacuum
292
+
293
+ # Debug mode
294
+ DEBUG=1 npm run dev -- project:health
295
+ ```
296
+
297
+ ---
298
+
299
+ ## πŸ“Š Health Check Output Example
300
+
301
+ ```
302
+ πŸ₯ Running project health checks...
303
+
304
+ πŸ“ Checking structure...
305
+ βœ… lib/
306
+ βœ… scripts/
307
+ βœ… docs/
308
+ βœ… memory/
309
+ βœ… agents/
310
+ βœ… skills/
311
+ βœ… prompts/
312
+
313
+ βš™οΈ Checking config...
314
+ βœ… .memoryrc.json
315
+ βœ… package.json
316
+
317
+ πŸ“„ Checking key files...
318
+ βœ… bin/create-memory-nest-kit.js
319
+ βœ… lib/context-builder.js
320
+
321
+ πŸ—„οΈ Checking database...
322
+ βœ… ~/forja-workspace/memory/sqlite/universal.db
323
+
324
+ ════════════════════════════════════════════════
325
+ βœ… Project health: GOOD
326
+ ════════════════════════════════════════════════
327
+ ```
328
+
329
+ ---
330
+
331
+ ## ⚑ CLI Shortcuts
332
+
333
+ **Adicionar ao shell (`.bashrc` ou `.zshrc`):**
334
+
335
+ ```bash
336
+ # Quick health check
337
+ alias dev-health='npm run dev -- project:health'
338
+
339
+ # Quick context
340
+ alias dev-ctx='npm run dev -- context:build'
341
+
342
+ # Quick vacuum
343
+ alias dev-vac='npm run dev -- memory:vacuum'
344
+
345
+ # Quick init
346
+ alias dev-init='npm run dev -- project:init'
347
+ ```
348
+
349
+ **Uso:**
350
+ ```bash
351
+ dev-health
352
+ dev-ctx task my-project "feature"
353
+ dev-vac
354
+ dev-init awesome-app
355
+ ```
356
+
357
+ ---
358
+
359
+ ## πŸ“‹ Checklist Pre-Deployment
360
+
361
+ - [ ] `npm run dev -- project:health` βœ…
362
+ - [ ] `npm run dev -- memory:vacuum` βœ…
363
+ - [ ] All tests passing: `npm test`
364
+ - [ ] Coverage > 80%: `npm run test:cov`
365
+ - [ ] No console.log in production code
366
+ - [ ] Docs updated: `git diff --name-only | grep .md`
367
+ - [ ] Commit message follows convention: `feat:` / `fix:` / `docs:`
368
+ - [ ] Pre-commit hook passed automatically
369
+
370
+ ---
371
+
372
+ ## πŸ› Troubleshooting
373
+
374
+ ### Pre-commit hook nΓ£o roda
375
+
376
+ ```bash
377
+ # Verificar permissΓ΅es
378
+ ls -la .git/hooks/pre-commit
379
+
380
+ # Se nΓ£o tem permissΓ£o:
381
+ chmod +x .git/hooks/pre-commit
382
+ ```
383
+
384
+ ### Health check falha
385
+
386
+ ```bash
387
+ # Rodar com debug
388
+ DEBUG=1 npm run dev -- project:health
389
+
390
+ # Checar diretΓ³rio especΓ­fico
391
+ ls -la lib/
392
+ ls -la scripts/
393
+ ```
394
+
395
+ ### Memory vacuum muito lento
396
+
397
+ ```bash
398
+ # Checar tamanho do DB
399
+ du -sh .memory/sqlite/context.db
400
+
401
+ # Manual cleanup (backup first!)
402
+ cp .memory/sqlite/context.db .memory/sqlite/context.db.backup
403
+ sqlite3 .memory/sqlite/context.db "VACUUM;"
404
+ ```
405
+
406
+ ---
407
+
408
+ ## πŸ”— ReferΓͺncia RΓ‘pida
409
+
410
+ | Comando | Uso | Output |
411
+ |---------|-----|--------|
412
+ | `context:build` | Gerar contexto | `.context/context-*.md` |
413
+ | `memory:vacuum` | Comprimir | RelatΓ³rio de economia |
414
+ | `memory:sync` | Atualizar Γ­ndices | Status de sync |
415
+ | `project:health` | Validar projeto | RelatΓ³rio de saΓΊde |
416
+ | `project:init` | Novo projeto | Projeto inicializado |
417
+
418
+ ---
419
+
420
+ **PrΓ³xima Fase**: Testes de integraΓ§Γ£o com projeto exemplo
421
+ **Status**: Fase 4 - CLI Unificada 100% βœ