forjajs 5.0.1 → 5.3.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 (268) hide show
  1. package/CHANGELOG.md +114 -2
  2. package/README.md +40 -5
  3. package/README.pt-BR.md +42 -4
  4. package/boilerplates/02-saas-starter/README.md +58 -293
  5. package/boilerplates/02-saas-starter/backend/.env.example +13 -0
  6. package/boilerplates/02-saas-starter/backend/.oxlintrc.json +8 -0
  7. package/boilerplates/02-saas-starter/backend/nest-cli.json +6 -0
  8. package/boilerplates/02-saas-starter/backend/package.json +32 -73
  9. package/boilerplates/02-saas-starter/backend/src/app.module.ts +16 -16
  10. package/boilerplates/02-saas-starter/backend/src/billing/adapters/http/billing.controller.ts +55 -0
  11. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/orm-entities.ts +28 -0
  12. package/boilerplates/02-saas-starter/backend/src/billing/adapters/persistence/typeorm-billing.repository.ts +46 -0
  13. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.spec.ts +58 -0
  14. package/boilerplates/02-saas-starter/backend/src/billing/application/billing.service.ts +68 -0
  15. package/boilerplates/02-saas-starter/backend/src/billing/billing.module.ts +11 -0
  16. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.spec.ts +23 -0
  17. package/boilerplates/02-saas-starter/backend/src/billing/domain/plan.ts +36 -0
  18. package/boilerplates/02-saas-starter/backend/src/billing/domain/ports.ts +27 -0
  19. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.spec.ts +28 -0
  20. package/boilerplates/02-saas-starter/backend/src/billing/domain/subscription.ts +47 -0
  21. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/auth.dto.ts +22 -0
  22. package/boilerplates/02-saas-starter/backend/src/identity/adapters/http/identity.controller.ts +59 -0
  23. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/orm-entities.ts +25 -0
  24. package/boilerplates/02-saas-starter/backend/src/identity/adapters/persistence/typeorm-identity.repository.ts +47 -0
  25. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.spec.ts +72 -0
  26. package/boilerplates/02-saas-starter/backend/src/identity/application/auth.service.ts +63 -0
  27. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.spec.ts +19 -0
  28. package/boilerplates/02-saas-starter/backend/src/identity/domain/model.ts +42 -0
  29. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.spec.ts +17 -0
  30. package/boilerplates/02-saas-starter/backend/src/identity/domain/password.ts +26 -0
  31. package/boilerplates/02-saas-starter/backend/src/identity/identity.module.ts +12 -0
  32. package/boilerplates/02-saas-starter/backend/src/main.ts +19 -19
  33. package/boilerplates/02-saas-starter/backend/src/platform/auth/jwt-auth.guard.ts +17 -0
  34. package/boilerplates/02-saas-starter/backend/src/platform/auth/principal.ts +22 -0
  35. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.spec.ts +23 -0
  36. package/boilerplates/02-saas-starter/backend/src/platform/auth/roles.guard.ts +20 -0
  37. package/boilerplates/02-saas-starter/backend/src/platform/auth/token.service.ts +54 -0
  38. package/boilerplates/02-saas-starter/backend/src/platform/config.spec.ts +18 -0
  39. package/boilerplates/02-saas-starter/backend/src/platform/config.ts +33 -0
  40. package/boilerplates/02-saas-starter/backend/src/platform/platform.module.ts +14 -0
  41. package/boilerplates/02-saas-starter/backend/tsconfig.build.json +6 -0
  42. package/boilerplates/02-saas-starter/backend/tsconfig.json +16 -21
  43. package/boilerplates/02-saas-starter/backend/vitest.config.ts +7 -0
  44. package/boilerplates/02-saas-starter/boilerplate.manifest.json +19 -14
  45. package/boilerplates/02-saas-starter/docker-compose.yml +10 -24
  46. package/boilerplates/02-saas-starter/memory/30-domains/billing/context.md +15 -132
  47. package/boilerplates/02-saas-starter/memory/30-domains/identity/context.md +20 -0
  48. package/boilerplates/README.md +9 -10
  49. package/dist/apps/cli/src/index.d.ts +0 -1
  50. package/dist/apps/cli/src/index.js +43 -32
  51. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +34 -1
  52. package/dist/apps/dashboard/app/api/forja/capabilities.d.ts +26 -0
  53. package/dist/apps/dashboard/app/api/forja/capabilities.js +39 -0
  54. package/dist/apps/dashboard/app/dashboard-client.jsx +607 -42
  55. package/dist/apps/server/src/forja-nest.module.d.ts +6 -0
  56. package/dist/apps/server/src/forja-nest.module.js +55 -0
  57. package/dist/apps/server/src/main.d.ts +21 -4
  58. package/dist/apps/server/src/main.js +79 -57
  59. package/dist/apps/server/src/task-planning-service.d.ts +29 -0
  60. package/dist/apps/server/src/task-planning-service.js +195 -0
  61. package/dist/apps/server/src/task-runtime-coordinator.d.ts +57 -0
  62. package/dist/apps/server/src/task-runtime-coordinator.js +229 -0
  63. package/dist/bin/forja.js +3 -2
  64. package/dist/bin/init-project.js +1 -0
  65. package/dist/lib/agent-evals.d.ts +138 -0
  66. package/dist/lib/agent-evals.js +349 -0
  67. package/dist/lib/cli-output.js +14 -2
  68. package/dist/lib/code-context.d.ts +33 -5
  69. package/dist/lib/code-context.js +70 -5
  70. package/dist/lib/context-builder.d.ts +49 -4
  71. package/dist/lib/context-builder.js +114 -47
  72. package/dist/lib/core/coverage-gate.d.ts +59 -0
  73. package/dist/lib/core/coverage-gate.js +58 -0
  74. package/dist/lib/core/doc-graph.d.ts +38 -0
  75. package/dist/lib/core/doc-graph.js +83 -0
  76. package/dist/lib/core/health.js +286 -5
  77. package/dist/lib/core/journey.js +36 -0
  78. package/dist/lib/core/registry.js +81 -6
  79. package/dist/lib/docs-reference.d.ts +35 -0
  80. package/dist/lib/docs-reference.js +57 -0
  81. package/dist/lib/generators/memory-generator.d.ts +0 -11
  82. package/dist/lib/generators/memory-generator.js +5 -161
  83. package/dist/lib/generators/readme-generator.js +1 -1
  84. package/dist/lib/llm/json-output.d.ts +14 -0
  85. package/dist/lib/llm/json-output.js +77 -0
  86. package/dist/lib/project-wiring.d.ts +8 -0
  87. package/dist/lib/project-wiring.js +79 -3
  88. package/dist/lib/session-memory.d.ts +38 -0
  89. package/dist/lib/session-memory.js +206 -0
  90. package/dist/lib/spec-trace.d.ts +46 -0
  91. package/dist/lib/spec-trace.js +184 -0
  92. package/dist/lib/validators/structure-validator.js +0 -1
  93. package/dist/packages/adapter-nest/src/index.d.ts +2 -1
  94. package/dist/packages/adapter-nest/src/index.js +59 -1
  95. package/dist/packages/adapter-sqlite/src/index.d.ts +15 -1
  96. package/dist/packages/adapter-sqlite/src/index.js +61 -1
  97. package/dist/packages/context/src/index.d.ts +2 -0
  98. package/dist/packages/context/src/index.js +36 -15
  99. package/dist/packages/contracts/src/index.d.ts +64 -0
  100. package/dist/packages/core/src/index.d.ts +9 -1
  101. package/dist/packages/core/src/index.js +28 -3
  102. package/dist/packages/graph/src/index.js +14 -5
  103. package/dist/packages/llm/src/index.js +12 -2
  104. package/dist/packages/mcp/src/index.d.ts +8 -0
  105. package/dist/packages/mcp/src/index.js +12 -1
  106. package/dist/packages/observability/src/index.d.ts +11 -0
  107. package/dist/packages/observability/src/index.js +3 -0
  108. package/dist/packages/orchestration/src/index.d.ts +15 -1
  109. package/dist/packages/orchestration/src/index.js +127 -21
  110. package/dist/packages/planner/src/index.d.ts +7 -1
  111. package/dist/packages/planner/src/index.js +67 -10
  112. package/dist/packages/planner/src/proposal-store.d.ts +30 -0
  113. package/dist/packages/planner/src/proposal-store.js +109 -0
  114. package/dist/packages/policy/src/index.d.ts +9 -16
  115. package/dist/packages/policy/src/index.js +114 -31
  116. package/dist/packages/runtime/src/index.d.ts +16 -2
  117. package/dist/packages/runtime/src/index.js +176 -61
  118. package/dist/scripts/build-smart-context.d.ts +2 -0
  119. package/dist/scripts/build-smart-context.js +12 -3
  120. package/dist/scripts/code-context.d.ts +3 -1
  121. package/dist/scripts/code-context.js +13 -3
  122. package/dist/scripts/coverage-gate.d.ts +2 -0
  123. package/dist/scripts/coverage-gate.js +101 -0
  124. package/dist/scripts/eval-agents.d.ts +11 -0
  125. package/dist/scripts/eval-agents.js +96 -0
  126. package/dist/scripts/gen-commands-doc.d.ts +2 -0
  127. package/dist/scripts/gen-commands-doc.js +18 -0
  128. package/dist/scripts/hook-session-memory.d.ts +9 -0
  129. package/dist/scripts/hook-session-memory.js +20 -0
  130. package/dist/scripts/hook-session-start.js +34 -0
  131. package/dist/scripts/llm-fit.js +23 -1
  132. package/dist/scripts/spec-trace.d.ts +10 -0
  133. package/dist/scripts/spec-trace.js +73 -0
  134. package/dist/scripts/sync-universal-memory.js +69 -4
  135. package/dist/scripts/token-benchmark.d.ts +33 -1
  136. package/dist/scripts/token-benchmark.js +179 -5
  137. package/dist/scripts/token-economy.js +3 -1
  138. package/dist/scripts/tools-doctor.d.ts +16 -1
  139. package/dist/scripts/tools-doctor.js +58 -17
  140. package/docs/commands.md +155 -0
  141. package/docs/fluxo.md +11 -7
  142. package/docs/init-project.md +3 -1
  143. package/docs/llm-fit-loop.md +36 -0
  144. package/docs/manual-operacional-cli-sdd-gsd.md +3 -2
  145. package/docs/produto/factsheet-marketing.md +7 -5
  146. package/docs/produto/roteiro-demo.md +14 -5
  147. package/docs/quick-reference.md +3 -3
  148. package/docs/token-optimization.md +10 -6
  149. package/memory/90-decisions/0088-templates-validados.md +3 -0
  150. package/memory/90-decisions/0089-skills-do-projeto.md +51 -0
  151. package/memory/90-decisions/0090-adapters-de-agente-somente-leitura.md +47 -0
  152. package/memory/90-decisions/0091-memoria-de-sessao-por-hooks.md +40 -0
  153. package/memory/90-decisions/0092-criterios-de-aceite-ligados-a-testes.md +37 -0
  154. package/memory/90-decisions/0093-avaliacoes-com-agentes-reais.md +40 -0
  155. package/package.json +4 -2
  156. package/specs/avaliacoes-de-agentes/spec.md +52 -0
  157. package/specs/criterios-ligados-a-testes/spec.md +42 -0
  158. package/specs/memoria-de-sessao/spec.md +48 -0
  159. package/specs/skills-do-projeto/plan.md +40 -0
  160. package/specs/skills-do-projeto/spec.md +63 -0
  161. package/specs/skills-do-projeto/tasks.md +27 -0
  162. package/specs/v6-agent-runtime-portable/spec.md +83 -0
  163. package/specs/v6-core-consolidation/spec.md +70 -0
  164. package/specs/v6-docs-drift/spec.md +85 -0
  165. package/specs/v6-quality-gates/spec.md +99 -0
  166. package/specs/v6-token-economy/spec.md +84 -0
  167. package/templates/evals/agents/adr.json +25 -0
  168. package/templates/evals/agents/memoria.json +32 -0
  169. package/templates/evals/agents/proxima-acao.json +29 -0
  170. package/templates/evals/agents/spec-nova.json +26 -0
  171. package/templates/evals/agents/teste-do-criterio.json +29 -0
  172. package/templates/project/AGENTS.md +16 -0
  173. package/templates/project/CLAUDE.md +3 -2
  174. package/templates/project/agents/context-engineer.md +3 -0
  175. package/templates/project/agents/governance.md +3 -0
  176. package/templates/project/agents/marketing.md +3 -0
  177. package/templates/project/agents/orchestrator.md +3 -0
  178. package/templates/project/agents/product.md +3 -0
  179. package/templates/project/agents/sdd-architect.md +3 -0
  180. package/templates/project/skills/README.md +14 -0
  181. package/templates/project/skills/accessibility-review/SKILL.md +89 -0
  182. package/templates/project/skills/api-design/SKILL.md +77 -0
  183. package/templates/project/skills/architecture-decision-record/SKILL.md +92 -0
  184. package/templates/project/skills/backlog-slicing/SKILL.md +82 -0
  185. package/templates/project/skills/bounded-context-mapping/SKILL.md +88 -0
  186. package/templates/project/skills/ci-pipeline-review/SKILL.md +83 -0
  187. package/templates/project/skills/commit-message/SKILL.md +143 -0
  188. package/templates/project/skills/data-migrations/SKILL.md +88 -0
  189. package/templates/project/skills/dependency-upgrade/SKILL.md +75 -0
  190. package/templates/project/skills/docker-compose-review/SKILL.md +85 -0
  191. package/templates/project/skills/domain-modeling/SKILL.md +120 -0
  192. package/templates/project/skills/event-storming/SKILL.md +95 -0
  193. package/templates/project/skills/executive-writing/SKILL.md +99 -0
  194. package/templates/project/skills/frontend-architecture/SKILL.md +97 -0
  195. package/templates/project/skills/incident-postmortem/SKILL.md +93 -0
  196. package/templates/project/skills/lgpd-compliance/SKILL.md +108 -0
  197. package/templates/project/skills/llm-provider-routing/SKILL.md +18 -0
  198. package/templates/project/skills/observability/SKILL.md +93 -0
  199. package/templates/project/skills/product-evaluation/SKILL.md +130 -0
  200. package/templates/project/skills/prompt-spec/SKILL.md +83 -0
  201. package/templates/project/skills/pull-request/SKILL.md +101 -0
  202. package/templates/project/skills/query-performance/SKILL.md +83 -0
  203. package/templates/project/skills/release-checklist/SKILL.md +106 -0
  204. package/templates/project/skills/release-notes/SKILL.md +87 -0
  205. package/templates/project/skills/requirements-elicitation/SKILL.md +127 -0
  206. package/templates/project/skills/requirements-gathering/SKILL.md +134 -0
  207. package/templates/project/skills/technical-spike/SKILL.md +101 -0
  208. package/templates/project/skills/testing/SKILL.md +109 -0
  209. package/templates/project/skills/threat-modeling/SKILL.md +87 -0
  210. package/templates/project/skills/ts-async-patterns/SKILL.md +101 -0
  211. package/templates/project/skills/ts-code-review/SKILL.md +121 -0
  212. package/templates/project/skills/ts-module-layout/SKILL.md +104 -0
  213. package/templates/project/skills/ts-testing/SKILL.md +89 -0
  214. package/templates/project/skills/web-performance/SKILL.md +72 -0
  215. package/boilerplates/02-saas-starter/.env.example +0 -25
  216. package/boilerplates/02-saas-starter/CHECKLIST-CRIACAO.md +0 -190
  217. package/boilerplates/02-saas-starter/INFO.md +0 -252
  218. package/boilerplates/02-saas-starter/QUICK_START.md +0 -194
  219. package/boilerplates/02-saas-starter/START-HERE.md +0 -259
  220. package/boilerplates/02-saas-starter/backend/src/common/decorators/roles.decorator.ts +0 -3
  221. package/boilerplates/02-saas-starter/backend/src/common/decorators/tenant.decorator.ts +0 -6
  222. package/boilerplates/02-saas-starter/backend/src/common/middleware/roles.guard.ts +0 -23
  223. package/boilerplates/02-saas-starter/backend/src/config/database.ts +0 -26
  224. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.controller.ts +0 -46
  225. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.module.ts +0 -25
  226. package/boilerplates/02-saas-starter/backend/src/modules/auth/auth.service.ts +0 -145
  227. package/boilerplates/02-saas-starter/backend/src/modules/auth/dto/auth.dto.ts +0 -30
  228. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/jwt.strategy.ts +0 -24
  229. package/boilerplates/02-saas-starter/backend/src/modules/auth/strategies/local.strategy.ts +0 -19
  230. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.controller.ts +0 -42
  231. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.module.ts +0 -13
  232. package/boilerplates/02-saas-starter/backend/src/modules/billing/billing.service.ts +0 -67
  233. package/boilerplates/02-saas-starter/backend/src/modules/billing/entities/invoice.entity.ts +0 -52
  234. package/boilerplates/02-saas-starter/backend/src/modules/organizations/entities/organization.entity.ts +0 -36
  235. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.controller.ts +0 -16
  236. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.module.ts +0 -13
  237. package/boilerplates/02-saas-starter/backend/src/modules/organizations/organizations.service.ts +0 -34
  238. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/entities/subscription.entity.ts +0 -40
  239. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.controller.ts +0 -36
  240. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.module.ts +0 -13
  241. package/boilerplates/02-saas-starter/backend/src/modules/subscriptions/subscriptions.service.ts +0 -91
  242. package/boilerplates/02-saas-starter/backend/src/modules/users/entities/user.entity.ts +0 -42
  243. package/boilerplates/02-saas-starter/backend/src/modules/users/users.controller.ts +0 -14
  244. package/boilerplates/02-saas-starter/backend/src/modules/users/users.module.ts +0 -13
  245. package/boilerplates/02-saas-starter/backend/src/modules/users/users.service.ts +0 -48
  246. package/boilerplates/02-saas-starter/memory/00-global/agent-contract.md +0 -227
  247. package/boilerplates/02-saas-starter/memory/00-global/context-policy.md +0 -141
  248. package/boilerplates/02-saas-starter/memory/00-global/index.md +0 -133
  249. package/boilerplates/02-saas-starter/memory/00-global/mission.md +0 -45
  250. package/boilerplates/02-saas-starter/memory/00-global/patterns.md +0 -223
  251. package/boilerplates/02-saas-starter/memory/10-product/business-rules.md +0 -240
  252. package/boilerplates/02-saas-starter/memory/10-product/nfrs.md +0 -239
  253. package/boilerplates/02-saas-starter/memory/10-product/personas.md +0 -195
  254. package/boilerplates/02-saas-starter/memory/10-product/vision.md +0 -63
  255. package/boilerplates/02-saas-starter/memory/20-architecture/overview.md +0 -232
  256. package/boilerplates/02-saas-starter/memory/30-domains/auth/api.md +0 -186
  257. package/boilerplates/02-saas-starter/memory/30-domains/auth/context.md +0 -85
  258. package/boilerplates/02-saas-starter/memory/30-domains/billing/api.md +0 -262
  259. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/api.md +0 -176
  260. package/boilerplates/02-saas-starter/memory/30-domains/subscriptions/context.md +0 -100
  261. package/boilerplates/02-saas-starter/memory/40-delivery/backlog.md +0 -81
  262. package/boilerplates/02-saas-starter/memory/40-delivery/roadmap.md +0 -97
  263. package/boilerplates/02-saas-starter/memory/40-delivery/sprint-atual.md +0 -57
  264. package/boilerplates/02-saas-starter/memory/50-orchestration/topology.md +0 -90
  265. package/boilerplates/02-saas-starter/memory/60-runs/index.md +0 -54
  266. package/boilerplates/02-saas-starter/memory/70-summaries/global.md +0 -50
  267. package/boilerplates/02-saas-starter/memory/80-data/schema.md +0 -185
  268. package/boilerplates/02-saas-starter/memory/90-decisions/adr-template.md +0 -75
@@ -1,42 +0,0 @@
1
- import { Entity, PrimaryGeneratedColumn, Column, CreateDateColumn, UpdateDateColumn, Index } from 'typeorm';
2
-
3
- @Entity('users')
4
- @Index(['tenantId', 'email'])
5
- @Index(['tenantId', 'status'])
6
- export class User {
7
- @PrimaryGeneratedColumn('uuid')
8
- id: string;
9
-
10
- @Column('uuid')
11
- tenantId: string;
12
-
13
- @Column()
14
- email: string;
15
-
16
- @Column()
17
- passwordHash: string;
18
-
19
- @Column({ nullable: true })
20
- firstName: string;
21
-
22
- @Column({ nullable: true })
23
- lastName: string;
24
-
25
- @Column('simple-array', { default: 'member' })
26
- roles: string[];
27
-
28
- @Column({ default: 'active' })
29
- status: string;
30
-
31
- @Column({ nullable: true })
32
- emailVerifiedAt: Date;
33
-
34
- @CreateDateColumn()
35
- createdAt: Date;
36
-
37
- @UpdateDateColumn()
38
- updatedAt: Date;
39
-
40
- @Column({ nullable: true })
41
- deletedAt: Date;
42
- }
@@ -1,14 +0,0 @@
1
- import { Controller, Get, UseGuards } from '@nestjs/common';
2
- import { AuthGuard } from '@nestjs/passport';
3
- import { UsersService } from './users.service';
4
-
5
- @Controller('users')
6
- @UseGuards(AuthGuard('jwt'))
7
- export class UsersController {
8
- constructor(private usersService: UsersService) {}
9
-
10
- @Get()
11
- async list(@Body() req: any) {
12
- return { data: await this.usersService.list(req.user.tenantId) };
13
- }
14
- }
@@ -1,13 +0,0 @@
1
- import { Module } from '@nestjs/common';
2
- import { TypeOrmModule } from '@nestjs/typeorm';
3
- import { User } from './entities/user.entity';
4
- import { UsersService } from './users.service';
5
- import { UsersController } from './users.controller';
6
-
7
- @Module({
8
- imports: [TypeOrmModule.forFeature([User])],
9
- controllers: [UsersController],
10
- providers: [UsersService],
11
- exports: [UsersService],
12
- })
13
- export class UsersModule {}
@@ -1,48 +0,0 @@
1
- import { Injectable } from '@nestjs/common';
2
- import { InjectRepository } from '@nestjs/typeorm';
3
- import { Repository } from 'typeorm';
4
- import { User } from './entities/user.entity';
5
-
6
- @Injectable()
7
- export class UsersService {
8
- constructor(
9
- @InjectRepository(User)
10
- private userRepository: Repository<User>,
11
- ) {}
12
-
13
- async findById(id: string, tenantId: string) {
14
- return this.userRepository.findOne({
15
- where: { id, tenantId },
16
- });
17
- }
18
-
19
- async findByEmail(email: string, tenantId: string) {
20
- return this.userRepository.findOne({
21
- where: { email, tenantId },
22
- });
23
- }
24
-
25
- async create(tenantId: string, email: string, passwordHash: string) {
26
- const user = this.userRepository.create({
27
- tenantId,
28
- email,
29
- passwordHash,
30
- roles: ['member'],
31
- });
32
- return this.userRepository.save(user);
33
- }
34
-
35
- async updateRoles(id: string, tenantId: string, roles: string[]) {
36
- await this.userRepository.update(
37
- { id, tenantId },
38
- { roles },
39
- );
40
- return this.findById(id, tenantId);
41
- }
42
-
43
- async list(tenantId: string) {
44
- return this.userRepository.find({
45
- where: { tenantId },
46
- });
47
- }
48
- }
@@ -1,227 +0,0 @@
1
- # Contrato de Agentes
2
-
3
- ## 1. Ciclo de Vida de um Agente
4
-
5
- ### Setup
6
- ```
7
- Agent recebe tarefa → Lê context (30-domains + 20-architecture)
8
- → Valida pré-requisitos → Inicia execução
9
- ```
10
-
11
- **Checklist:**
12
- - [ ] Contexto de domínio lido
13
- - [ ] Dependências resolvidas
14
- - [ ] Ambiente preparado
15
- - [ ] Plano de execução documentado
16
-
17
- ### Execução
18
- ```
19
- Implementa feature → Testa localmente → Registra progresso
20
- → Documenta handoff
21
- ```
22
-
23
- **Invariantes:**
24
- - Nunca quebrar testes existentes
25
- - Sempre atualizar 60-runs/ com status
26
- - Validar tenant isolation em toda operação
27
- - Incluir error handling para todos os paths
28
-
29
- ### Conclusion
30
- ```
31
- Feature completa → Run registrado em 60-runs/
32
- → Summary atualizado em 70-summaries/ → Handoff criado
33
- ```
34
-
35
- **Deliverables:**
36
- - Código funcional com testes
37
- - Run document completo
38
- - ADR se decisão arquitetural
39
- - Next steps claros
40
-
41
- ## 2. Responsabilidades por Agente
42
-
43
- ### Setup Agent
44
- **Entrada**: Nenhuma (configuração inicial)
45
- **Saída**: Environment pronto, schemas criados, seed data
46
-
47
- **Checklist:**
48
- - [ ] PostgreSQL rodando (docker-compose)
49
- - [ ] Migrations executadas
50
- - [ ] .env configurado
51
- - [ ] Redis funcional
52
- - [ ] Seed data inserido
53
-
54
- **Não faz**: Implementar features, apenas prepare infrastructure
55
-
56
- ---
57
-
58
- ### Auth Agent
59
- **Entrada**: Setup Agent completo
60
- **Saída**: Módulo auth com JWT, login, signup
61
-
62
- **Responsabilidades:**
63
- - Implementar JWT strategy
64
- - Validar credenciais
65
- - Gerenciar refresh tokens
66
- - Registrar eventos de auth
67
-
68
- **Não faz**: Gerenciar roles (vê Users Agent)
69
-
70
- ---
71
-
72
- ### Subscriptions Agent
73
- **Entrada**: Auth Agent + Users Agent
74
- **Saída**: Gerenciamento de planos e upgrades
75
-
76
- **Responsabilidades:**
77
- - Crud de subscriptions
78
- - Validar transições de plano
79
- - Registrar eventos de negócio
80
- - Integrar com billing
81
-
82
- **Não faz**: Processar pagamentos (vê Billing Agent)
83
-
84
- ---
85
-
86
- ### Billing Agent
87
- **Entrada**: Subscriptions Agent
88
- **Saída**: Mock payment gateway, invoices
89
-
90
- **Responsabilidades:**
91
- - Processar pagamentos (mock Stripe)
92
- - Gerar invoices
93
- - Registrar transações
94
- - Webhook handlers
95
-
96
- **Não faz**: Validar planos (vê Subscriptions)
97
-
98
- ---
99
-
100
- ### Organizations Agent
101
- **Entrada**: Setup Agent
102
- **Saída**: Multi-tenant structure, org management
103
-
104
- **Responsabilidades:**
105
- - CRUD de organizations
106
- - Tenant isolation validation
107
- - Invite members
108
- - Org settings
109
-
110
- **Não faz**: Auth (vê Auth Agent), roles (vê Users Agent)
111
-
112
- ---
113
-
114
- ### Users Agent
115
- **Entrada**: Auth Agent + Organizations Agent
116
- **Saída**: User management com RBAC
117
-
118
- **Responsabilidades:**
119
- - CRUD de users
120
- - Atribuir roles
121
- - Gerenciar permissions
122
- - Audit logging
123
-
124
- **Não faz**: Autenticação (vê Auth Agent)
125
-
126
- ---
127
-
128
- ### Analytics Agent
129
- **Entrada**: Todos agentes com eventos registrados
130
- **Saída**: Métricas e insights
131
-
132
- **Responsabilidades:**
133
- - Agregar eventos
134
- - Calcular churn rate
135
- - MRR tracking
136
- - Dashboard data
137
-
138
- **Não faz**: Implementar eventos (cada agente registra seu próprio)
139
-
140
- ## 3. Contrato de Entrada/Saída
141
-
142
- Cada agente declara:
143
-
144
- ```markdown
145
- ## Agent: Subscriptions Agent
146
-
147
- ### Entrada Obrigatória
148
- - [ ] Auth Agent concluído
149
- - [ ] Users Agent concluído
150
- - [ ] PostgreSQL + Redis rodando
151
- - [ ] Environment: memory/30-domains/subscriptions/context.md
152
-
153
- ### Saída Entregue
154
- - [ ] POST /api/subscriptions (create)
155
- - [ ] GET /api/subscriptions/:id (read)
156
- - [ ] PUT /api/subscriptions/:id (update plan)
157
- - [ ] Testes E2E passando
158
- - [ ] Run document em 60-runs/
159
-
160
- ### Erro = Bloqueador
161
- Se alguma entrada não estiver pronta, registrar em:
162
- - memory/40-delivery/backlog.md (como bloqueador)
163
- - Não prosseguir (avoid broken dependencies)
164
- ```
165
-
166
- ## 4. Handoff Protocol
167
-
168
- Quando agente completa, cria `50-orchestration/handoffs/{timestamp}-{agent}-{next-agent}.md`:
169
-
170
- ```markdown
171
- # Handoff: Auth Agent → Subscriptions Agent
172
- **Timestamp**: 2024-01-15 14:30:00
173
- **Status**: ✅ Ready
174
-
175
- ## O que foi entregue
176
- - ✅ JWT auth funcional
177
- - ✅ Login/signup endpoints
178
- - ✅ User entity com roles
179
- - ✅ All E2E tests passing
180
-
181
- ## Estado atual do código
182
- - Branch: feature/auth
183
- - Tests: 42 passing, 0 failing
184
- - Coverage: 89%
185
-
186
- ## Dependências resolvidas
187
- - [ ] JWT config (✅ done)
188
- - [ ] User schema (✅ done)
189
- - [ ] Password hashing (✅ done)
190
-
191
- ## Próximo agente deve
192
- 1. Cherry-pick User entity changes
193
- 2. Implementar subscription CRUD
194
- 3. Testar isolamento de tenant
195
- 4. Criar handoff para Billing Agent
196
-
197
- ## Issues conhecidas
198
- - None
199
-
200
- ## Prioridade
201
- 🔴 Critical | 🟡 High | 🟢 Medium | ⚪ Low
202
- ```
203
-
204
- ## 5. Error Recovery
205
-
206
- **Se agente falha:**
207
- 1. Registrar erro em 60-runs/{timestamp}-ERROR.md
208
- 2. Rollback de changes (não quebra main)
209
- 3. Criação de ADR explicando causa
210
- 4. Reatribuir com contexto do erro
211
-
212
- **Se dependência não disponível:**
213
- 1. Registrar em 40-delivery/backlog.md como bloqueador
214
- 2. Não prosseguir (falhar rápido)
215
- 3. Notificar responsável da dependência
216
-
217
- ## 6. Qualidade de Código
218
-
219
- Todo agent output deve passar:
220
- - [ ] TypeScript strict mode (no `any`)
221
- - [ ] ESLint + Prettier
222
- - [ ] Unit tests (>80% coverage)
223
- - [ ] E2E tests para happy paths
224
- - [ ] No breaking changes em existing APIs
225
- - [ ] Documentado em memory/
226
-
227
- **Violação = Pull request rejection**
@@ -1,141 +0,0 @@
1
- # Política de Contexto & Gestão de Memória
2
-
3
- ## 1. Estrutura de Níveis
4
-
5
- A memória está organizada em 10 níveis que crescem em especificidade:
6
-
7
- | Nível | Escopo | Uso |
8
- |-------|--------|-----|
9
- | 00 | Global | Mission, patterns, policies |
10
- | 10 | Product | Visão, personas, regras |
11
- | 20 | Architecture | Decisões técnicas |
12
- | 30 | Domains | Context por domínio de negócio |
13
- | 40 | Delivery | Roadmap, sprints |
14
- | 50 | Orchestration | Topologia de agents |
15
- | 60 | Runs | Logs de execução |
16
- | 70 | Summaries | Sínteses executivas |
17
- | 80 | Data | Schemas, migrations |
18
- | 90 | Decisions | ADRs (Architecture Decision Records) |
19
-
20
- ## 2. Fluxo de Leitura de Context
21
-
22
- **Ordem de prioridade** para agente decidir ação:
23
- 1. Domínio específico (30-domains/X/)
24
- 2. Architecture decisão (20-architecture/)
25
- 3. Padrões globais (00-global/patterns.md)
26
- 4. Regras de produto (10-product/business-rules.md)
27
-
28
- **Exemplo**: Para implementar "upgrade de subscription":
29
- 1. Ler `30-domains/subscriptions/context.md` (o que é upgrade aqui)
30
- 2. Ler `30-domains/billing/context.md` (impacto no billing)
31
- 3. Ler `20-architecture/backend.md` (padrão de implementação)
32
- 4. Aplicar padrão de service/controller de `patterns.md`
33
-
34
- ## 3. Gestão de Estado em Runs
35
-
36
- Cada execução de agente registra:
37
-
38
- ```
39
- 60-runs/
40
- ├── 2024-01-15-auth-setup.md
41
- ├── 2024-01-15-subscription-endpoint.md
42
- └── index.md (lista de todas as runs)
43
- ```
44
-
45
- **Formato de run:**
46
- ```markdown
47
- # Auth Setup - 2024-01-15 10:30:00
48
-
49
- ## Agente
50
- Setup Agent
51
-
52
- ## Tarefa
53
- Inicializar módulo de autenticação
54
-
55
- ## Output
56
- - ✅ JWT config criado
57
- - ✅ Local strategy implementada
58
- - ✅ Login endpoint funcional
59
-
60
- ## Issues
61
- - Nenhum
62
-
63
- ## Próximos passos
64
- - Implementar refresh token
65
- ```
66
-
67
- ## 4. Atualização de Summaries
68
-
69
- **Global summary** (`70-summaries/global.md`):
70
- - Atualizado diariamente
71
- - Lista funcionalidades implementadas
72
- - Identifica bloqueadores
73
-
74
- **Domain summaries** (`70-summaries/{domain}.md`):
75
- - Atualizado quando módulo completa feature
76
- - Estado de cada endpoint
77
- - Issues conhecidas
78
-
79
- ## 5. Versionamento de Memória
80
-
81
- Quando política muda:
82
- 1. Criar ADR em `90-decisions/adr-YYYYMMDD-{titulo}.md`
83
- 2. Atualizar arquivo afetado com timestamp
84
- 3. Registrar em `90-decisions/index.md`
85
-
86
- **Exemplo de ADR:**
87
- ```
88
- # ADR-20240115-001: JWT expiry strategy
89
-
90
- ## Context
91
- Tokens devem expirar, mas user experience deve ser suave
92
-
93
- ## Decision
94
- - Access token: 15 minutos
95
- - Refresh token: 7 dias
96
- - Silent refresh em background
97
-
98
- ## Consequences
99
- - Melhor segurança, mais chamadas à API
100
- - Melhor UX com refresh automático
101
- ```
102
-
103
- ## 6. Quem Atualiza Cada Seção
104
-
105
- | Seção | Quem |
106
- |-------|-----|
107
- | 00-global | Tech lead, architect |
108
- | 10-product | Product manager, PO |
109
- | 20-architecture | Tech lead |
110
- | 30-domains | Agentes de domínio |
111
- | 40-delivery | Scrum master, tech lead |
112
- | 50-orchestration | Tech lead, setup agent |
113
- | 60-runs | Cada agente após execução |
114
- | 70-summaries | Summary agent (rotina diária) |
115
- | 80-data | Data agent, migrations |
116
- | 90-decisions | Tech lead, architect |
117
-
118
- ## 7. Context Freshness
119
-
120
- **Staleness rules:**
121
- - Padrões (00-global): OK até 3 meses sem atualização
122
- - Domain context (30-domains): AVISO se > 1 sprint
123
- - Runs (60-runs): OBRIGATÓRIO após cada execução
124
- - Summaries: AVISO se > 1 dia
125
- - Decisions: Nunca ficam obsoletos (imutáveis)
126
-
127
- ## 8. Limpeza de Contexto
128
-
129
- Trimestral:
130
- 1. Arquivar runs antigas (60-runs → 60-runs/archive/)
131
- 2. Consolidar learnings em 70-summaries
132
- 3. Atualizar ADRs obsoletos
133
- 4. Verificar alinhamento de 10-product com 30-domains
134
-
135
- ## 9. Conflitos de Contexto
136
-
137
- Se dois documentos dizem coisas diferentes:
138
- 1. Ordem de precedência: Decisão > Domain > Architecture > Pattern
139
- 2. ADR mais recente vence
140
- 3. Registrar conflito em `90-decisions/conflicts.md`
141
- 4. Resolver em pair programming ou architecture review
@@ -1,133 +0,0 @@
1
- # Índice de Memória - SaaS Starter
2
-
3
- ## Navegação Rápida
4
-
5
- ### 00-Global (Políticas & Princípios)
6
- - **[mission.md](./mission.md)** — Visão, objetivos, papéis de agentes
7
- - **[patterns.md](./patterns.md)** — Code patterns, conventions, testing
8
- - **[context-policy.md](./context-policy.md)** — Gestão de níveis, freshness, limpeza
9
- - **[agent-contract.md](./agent-contract.md)** — Ciclo de vida, responsabilidades, handoffs
10
- - **[index.md](./index.md)** — Este arquivo
11
-
12
- ### 10-Product (Visão & Regras)
13
- - **vision.md** — Proposta de valor, diferencial
14
- - **personas.md** — Buyer persona, user scenarios
15
- - **business-rules.md** — Rules engine, compliance
16
- - **nfrs.md** — Performance, scalability, security requirements
17
-
18
- ### 20-Architecture (Decisões Técnicas)
19
- - **overview.md** — Diagrama de arquitetura, stack
20
- - **frontend.md** — Stack frontend, componentes, state
21
- - **backend.md** — NestJS, modules, database strategy
22
- - **data.md** — PostgreSQL schema, indexing strategy
23
- - **security.md** — JWT, RBAC, encryption, PII
24
- - **observability.md** — Logging, metrics, tracing
25
-
26
- ### 30-Domains (Domínios de Negócio)
27
- - **auth/context.md** — O que é auth aqui, fluxo
28
- - **auth/api.md** — Endpoints, contratos, errors
29
- - **subscriptions/context.md** — Planos, transições, regras
30
- - **subscriptions/api.md** — Endpoints de subscriptions
31
- - **billing/context.md** — Pagamentos, invoices, refunds
32
- - **billing/api.md** — Endpoints de billing
33
-
34
- ### 40-Delivery (Roadmap & Sprints)
35
- - **roadmap.md** — 6+ months vision
36
- - **sprint-atual.md** — Sprint atual, tasks, burndown
37
- - **backlog.md** — Product backlog, priorização
38
-
39
- ### 50-Orchestration (Topologia de Agents)
40
- - **topology.md** — Quais agents, quando, em que ordem
41
- - **routing.md** — Como agentes se descobrem
42
- - **handoff-protocol.md** — Formato, timing, escalation
43
- - **playbook-paralelo.md** — Como executar 2+ agents em paralelo
44
- - **handoffs/ directory** — Histórico de handoffs
45
-
46
- ### 60-Runs (Logs de Execução)
47
- - **index.md** — Lista de todas as runs
48
- - **YYYY-MM-DD-agent-task.md** — Run log individual
49
- - **YYYY-MM-DD-ERROR.md** — Logs de erro
50
-
51
- ### 70-Summaries (Sínteses Executivas)
52
- - **global.md** — Status geral, funcionalidades implementadas, bloqueadores
53
- - **auth.md** — Status módulo auth, endpoints ready
54
- - **subscriptions.md** — Status subscriptions, issues
55
- - **billing.md** — Status billing, payment gateway
56
-
57
- ### 80-Data (Schemas & Migrations)
58
- - **schema.md** — Entidades PostgreSQL, relationships
59
- - **migrations/ directory** — Histórico de migrations
60
- - **seeds/ directory** — Seed data
61
-
62
- ### 90-Decisions (ADRs - Architecture Decision Records)
63
- - **adr-template.md** — Template para novas decisões
64
- - **adr-YYYYMMDD-*.md** — Decisões arquiteturais
65
- - **index.md** — Índice de ADRs
66
- - **conflicts.md** — Conflitos e resoluções
67
-
68
- ## Fluxo de Leitura por Cenário
69
-
70
- ### Cenário 1: Novo agente começa tarefa
71
- 1. Ler level 30 (domain específico)
72
- 2. Ler level 20 (architecture)
73
- 3. Ler level 00 (patterns)
74
- 4. Verificar 40-delivery para status
75
- 5. Executar tarefa
76
- 6. Documentar em 60-runs
77
-
78
- ### Cenário 2: Debug de issue
79
- 1. Procurar em 60-runs (problema similar?)
80
- 2. Verificar ADR em 90-decisions (decisão relevante?)
81
- 3. Consultar domain context em 30-domains
82
- 4. Criar ADR se nova decisão necessária
83
-
84
- ### Cenário 3: Atualizar visão de produto
85
- 1. Editar 10-product/
86
- 2. Criar ADR em 90-decisions
87
- 3. Registrar em 70-summaries/global.md
88
-
89
- ### Cenário 4: Escalação de bloqueador
90
- 1. Documentar issue em 60-runs/ERROR.md
91
- 2. Registrar dependência em 40-delivery/backlog.md
92
- 3. Criar ADR se decisão necessária
93
- 4. Notificar responsável
94
-
95
- ## Queries Rápidas
96
-
97
- **"Qual é o status do auth module?"**
98
- → Ler `70-summaries/auth.md`
99
-
100
- **"Como implementar novo endpoint?"**
101
- → Ler `00-global/patterns.md` + `20-architecture/backend.md`
102
-
103
- **"Qual é o próximo agente?"**
104
- → Ler `40-delivery/sprint-atual.md` + `50-orchestration/topology.md`
105
-
106
- **"Por que escolhemos PostgreSQL?"**
107
- → Buscar ADR em `90-decisions/`
108
-
109
- **"O que significa tenant isolation?"**
110
- → Ler `20-architecture/security.md` + `30-domains/auth/context.md`
111
-
112
- **"Como fazer handoff?"**
113
- → Ler `50-orchestration/handoff-protocol.md` (template em `agent-contract.md`)
114
-
115
- ## Atualização Frequência
116
-
117
- | Nível | Frequência | Responsável |
118
- |-------|-----------|-------------|
119
- | 00 | Trimestral | Tech lead |
120
- | 10 | Mensal | Product |
121
- | 20 | Conforme necessário | Tech lead |
122
- | 30 | Cada agente concluindo | Agentes |
123
- | 40 | Semanal | Scrum master |
124
- | 50 | Cada handoff | Agente completando |
125
- | 60 | Cada execução | Agente executando |
126
- | 70 | Diário | Summary agent |
127
- | 80 | Com migrations | Data agent |
128
- | 90 | Decisões imutáveis | Tech lead |
129
-
130
- ## Last Updated
131
- - **Date**: 2024-01-15
132
- - **By**: SaaS Starter Scaffold
133
- - **Next Review**: 2024-02-15
@@ -1,45 +0,0 @@
1
- # Missão do Projeto SaaS Starter
2
-
3
- ## Visão Geral
4
-
5
- Fornecer uma plataforma SaaS multi-tenant, escalável e pronta para produção que:
6
-
7
- 1. **Autenticação & Autorização**: JWT-based com RBAC (roles: owner, admin, member)
8
- 2. **Subscription Management**: Planos (free, pro, enterprise) com gerenciamento automático
9
- 3. **Billing & Payments**: Integração mock com sistemas de pagamento (Stripe-like)
10
- 4. **Multi-Tenancy**: Isolamento seguro de dados por organização
11
- 5. **Observabilidade**: Logs estruturados e métricas para decisões operacionais
12
-
13
- ## Princípios Fundamentais
14
-
15
- | Princípio | Descrição |
16
- |-----------|-----------|
17
- | **Multi-Tenant First** | Cada organização é isolada em camada de data e contexto |
18
- | **Security by Default** | JWT + Rate limiting + Input validation em todas as rotas |
19
- | **Scalability Ready** | Arquitetura preparada para PostgreSQL + Redis |
20
- | **Developer Experience** | NestJS + TypeScript com tipagem forte e injeção de dependências |
21
- | **Testabilidade** | Testes E2E para fluxos críticos (auth, subscriptions, billing) |
22
-
23
- ## Objetivos Imediatos
24
-
25
- 1. Gerar scaffold completo com módulos SaaS funcionais
26
- 2. Fornecer exemplos de endpoints para Auth, Subscriptions e Billing
27
- 3. Documentar fluxos de signup, subscription upgrade, e pagamento
28
- 4. Incluir testes E2E para os fluxos críticos
29
- 5. Docker-compose com PostgreSQL + Redis preconfigurado
30
-
31
- ## Papéis de Agentes
32
-
33
- | Agente | Responsabilidade |
34
- |--------|-----------------|
35
- | **Setup Agent** | Inicializar projeto, criar schemas, seedar dados |
36
- | **Auth Agent** | Validar JWT, gerenciar permissões RBAC |
37
- | **Subscription Agent** | Gerenciar planos e upgrades |
38
- | **Billing Agent** | Processar pagamentos (mock) e gerar invoices |
39
- | **Analytics Agent** | Rastrear eventos de negócio e métricas |
40
-
41
- ## Status
42
-
43
- - ✅ Estrutura de memória criada
44
- - ✅ Backend NestJS inicializado
45
- - 🚀 Pronto para integração de agents