forjajs 4.1.1 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +125 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/specs-index.d.ts +1 -0
  77. package/dist/lib/specs-index.js +22 -3
  78. package/dist/lib/status-model.js +24 -8
  79. package/dist/lib/templates.d.ts +24 -0
  80. package/dist/lib/templates.js +77 -0
  81. package/dist/lib/validators/structure-validator.js +0 -1
  82. package/dist/lib/workspace.d.ts +7 -0
  83. package/dist/lib/workspace.js +33 -3
  84. package/dist/packages/adapter-git/src/index.js +2 -2
  85. package/dist/packages/context/src/index.js +1 -1
  86. package/dist/packages/core/src/index.js +1 -1
  87. package/dist/packages/evals/src/index.js +1 -1
  88. package/dist/packages/events/src/index.js +1 -1
  89. package/dist/packages/graph/src/index.js +1 -1
  90. package/dist/packages/mcp/src/index.d.ts +1 -1
  91. package/dist/packages/observability/src/index.js +1 -1
  92. package/dist/packages/orchestration/src/index.js +1 -1
  93. package/dist/packages/planner/src/index.js +1 -1
  94. package/dist/packages/policy/src/index.js +1 -1
  95. package/dist/packages/runtime/src/index.js +1 -1
  96. package/dist/packages/sandbox/src/index.js +1 -1
  97. package/dist/packages/validator/src/index.js +1 -1
  98. package/dist/scripts/adr.js +4 -4
  99. package/dist/scripts/agent-harness.js +30 -23
  100. package/dist/scripts/agent-router.js +22 -5
  101. package/dist/scripts/agent.js +5 -5
  102. package/dist/scripts/architecture.js +6 -6
  103. package/dist/scripts/audit-query.js +1 -1
  104. package/dist/scripts/audit-sync.js +1 -1
  105. package/dist/scripts/build-smart-context.d.ts +19 -1
  106. package/dist/scripts/build-smart-context.js +84 -68
  107. package/dist/scripts/check-standards.js +8 -3
  108. package/dist/scripts/code-context.js +1 -1
  109. package/dist/scripts/compress-memory.js +3 -2
  110. package/dist/scripts/compress-project-memory.js +2 -2
  111. package/dist/scripts/context-ops.js +13 -5
  112. package/dist/scripts/cost-economy.js +4 -4
  113. package/dist/scripts/demo-autonomy.js +11 -11
  114. package/dist/scripts/demo-workspace.js +12 -4
  115. package/dist/scripts/dev.js +8 -7
  116. package/dist/scripts/drift-check.js +5 -5
  117. package/dist/scripts/engineer.js +11 -11
  118. package/dist/scripts/evidence.js +4 -4
  119. package/dist/scripts/extract-global-knowledge.js +6 -4
  120. package/dist/scripts/forja-setup.js +2 -1
  121. package/dist/scripts/forja-status.d.ts +1 -1
  122. package/dist/scripts/forja-status.js +31 -3
  123. package/dist/scripts/gates.js +1 -1
  124. package/dist/scripts/generate-dashboard.js +6 -4
  125. package/dist/scripts/governance-dashboard.js +2 -2
  126. package/dist/scripts/hook-session-start.js +18 -9
  127. package/dist/scripts/hook-user-prompt.js +3 -2
  128. package/dist/scripts/incident.js +4 -4
  129. package/dist/scripts/llm-fit.js +11 -11
  130. package/dist/scripts/memory-audit.js +1 -1
  131. package/dist/scripts/memory-schema.js +3 -2
  132. package/dist/scripts/orchestrate.js +4 -5
  133. package/dist/scripts/project-smoke.js +13 -2
  134. package/dist/scripts/project-templates.d.ts +1 -0
  135. package/dist/scripts/project-templates.js +20 -0
  136. package/dist/scripts/project-upgrade.d.ts +13 -0
  137. package/dist/scripts/project-upgrade.js +107 -40
  138. package/dist/scripts/project-wire.d.ts +8 -0
  139. package/dist/scripts/project-wire.js +55 -0
  140. package/dist/scripts/provenance.js +3 -3
  141. package/dist/scripts/query-universal-memory.js +7 -4
  142. package/dist/scripts/release-check.js +1 -1
  143. package/dist/scripts/risk.js +4 -4
  144. package/dist/scripts/simulate.js +9 -9
  145. package/dist/scripts/spec-cli.d.ts +1 -0
  146. package/dist/scripts/spec-cli.js +25 -5
  147. package/dist/scripts/sprint-manager.js +21 -8
  148. package/dist/scripts/sync-universal-memory.js +50 -27
  149. package/dist/scripts/token-benchmark.js +4 -3
  150. package/dist/scripts/token-economy.js +4 -3
  151. package/dist/scripts/tools-doctor.d.ts +1 -1
  152. package/dist/scripts/tools-doctor.js +25 -3
  153. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  154. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  155. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  156. package/docs/glossary.md +4 -4
  157. package/docs/init-project.md +88 -444
  158. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  159. package/docs/modos-de-operacao.md +1 -1
  160. package/docs/processo-projeto.md +14 -11
  161. package/docs/produto/roteiro-demo.md +15 -18
  162. package/docs/publishing.md +5 -0
  163. package/docs/quick-reference.md +15 -23
  164. package/docs/structure.md +16 -30
  165. package/lib/core/model-pricing.json +19 -0
  166. package/memory/30-projects/README.md +1 -1
  167. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  168. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  169. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  170. package/memory/90-decisions/0088-templates-validados.md +55 -0
  171. package/package.json +25 -25
  172. package/templates/project/AGENTS.md +75 -0
  173. package/templates/project/CLAUDE.md +9 -0
  174. package/templates/project/agents/context-engineer.md +15 -0
  175. package/templates/project/agents/governance.md +15 -0
  176. package/templates/project/agents/marketing.md +15 -0
  177. package/templates/project/agents/orchestrator.md +15 -0
  178. package/templates/project/agents/product.md +15 -0
  179. package/templates/project/agents/sdd-architect.md +15 -0
  180. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  181. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -1,9 +1,9 @@
1
1
  import { Inject, Injectable } from '@nestjs/common';
2
2
  import { randomUUID } from 'node:crypto';
3
- import { Order, OrderLine } from '../domain/order.entity';
4
- import { Money } from '../domain/money.vo';
5
- import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
6
- import { Result } from '../../../shared/result';
3
+ import { Order, OrderLine } from '../domain/order.entity.js';
4
+ import { Money } from '../domain/money.vo.js';
5
+ import { ORDER_REPOSITORY, type OrderRepository } from '../domain/order.repository.js';
6
+ import { Result } from '../../../shared/result.js';
7
7
 
8
8
  /**
9
9
  * Contratos de entrada/saída — tipados e legíveis. Um agente entende o que o use-case faz pela
@@ -1,6 +1,6 @@
1
1
  import { Inject, Injectable } from '@nestjs/common';
2
- import { ORDER_REPOSITORY, OrderRepository } from '../domain/order.repository';
3
- import { Result } from '../../../shared/result';
2
+ import { ORDER_REPOSITORY, type OrderRepository } from '../domain/order.repository.js';
3
+ import { Result } from '../../../shared/result.js';
4
4
 
5
5
  export interface ShipOrderInput {
6
6
  orderId: string;
@@ -1,6 +1,6 @@
1
- import { Result } from '../../../shared/result';
2
- import { Money } from './money.vo';
3
- import { OrderStatus } from './order-status.vo';
1
+ import { Result } from '../../../shared/result.js';
2
+ import { Money } from './money.vo.js';
3
+ import { OrderStatus } from './order-status.vo.js';
4
4
 
5
5
  /**
6
6
  * Order — o agregado. **Toda invariante de negócio mora aqui**, em TypeScript puro:
@@ -1,4 +1,4 @@
1
- import { Order } from './order.entity';
1
+ import { Order } from './order.entity.js';
2
2
 
3
3
  /**
4
4
  * OrderRepository — a **PORTA** (Clean Architecture / Hexagonal). É uma `interface` no domínio: o
@@ -1,11 +1,11 @@
1
1
  import { Injectable } from '@nestjs/common';
2
2
  import { InjectRepository } from '@nestjs/typeorm';
3
3
  import { Repository } from 'typeorm';
4
- import { Order, OrderLine } from '../domain/order.entity';
5
- import { Money } from '../domain/money.vo';
6
- import { OrderStatus, OrderStatusValue } from '../domain/order-status.vo';
7
- import { OrderRepository } from '../domain/order.repository';
8
- import { OrderOrmEntity } from './order.orm-entity';
4
+ import { Order, OrderLine } from '../domain/order.entity.js';
5
+ import { Money } from '../domain/money.vo.js';
6
+ import { OrderStatus, OrderStatusValue } from '../domain/order-status.vo.js';
7
+ import { OrderRepository } from '../domain/order.repository.js';
8
+ import { OrderOrmEntity } from './order.orm-entity.js';
9
9
 
10
10
  /**
11
11
  * O ADAPTER: implementa a porta `OrderRepository` do domínio usando TypeORM. É o único lugar que
@@ -1,11 +1,11 @@
1
1
  import { Module } from '@nestjs/common';
2
2
  import { TypeOrmModule } from '@nestjs/typeorm';
3
- import { ORDER_REPOSITORY } from './domain/order.repository';
4
- import { OrderOrmEntity } from './infrastructure/order.orm-entity';
5
- import { TypeOrmOrderRepository } from './infrastructure/typeorm-order.repository';
6
- import { PlaceOrderUseCase } from './application/place-order.usecase';
7
- import { ShipOrderUseCase } from './application/ship-order.usecase';
8
- import { OrdersController } from './presentation/orders.controller';
3
+ import { ORDER_REPOSITORY } from './domain/order.repository.js';
4
+ import { OrderOrmEntity } from './infrastructure/order.orm-entity.js';
5
+ import { TypeOrmOrderRepository } from './infrastructure/typeorm-order.repository.js';
6
+ import { PlaceOrderUseCase } from './application/place-order.usecase.js';
7
+ import { ShipOrderUseCase } from './application/ship-order.usecase.js';
8
+ import { OrdersController } from './presentation/orders.controller.js';
9
9
 
10
10
  /**
11
11
  * O módulo é onde a **inversão de dependência** acontece, numa linha:
@@ -1,7 +1,7 @@
1
1
  import { BadRequestException, Body, Controller, Param, Post } from '@nestjs/common';
2
- import { PlaceOrderUseCase } from '../application/place-order.usecase';
3
- import { ShipOrderUseCase } from '../application/ship-order.usecase';
4
- import { PlaceOrderHttpDto } from './orders.http.dto';
2
+ import { PlaceOrderUseCase } from '../application/place-order.usecase.js';
3
+ import { ShipOrderUseCase } from '../application/ship-order.usecase.js';
4
+ import { PlaceOrderHttpDto } from './orders.http.dto.js';
5
5
 
6
6
  /**
7
7
  * O controller é FINO. Ele traduz HTTP↔use-case e converte falha de domínio em erro HTTP — nada
@@ -2,7 +2,7 @@ import { Body, Controller, Get, Param, Post } from '@nestjs/common';
2
2
  import { InjectRepository } from '@nestjs/typeorm';
3
3
  import { Repository } from 'typeorm';
4
4
  import { IsInt, IsPositive, IsString } from 'class-validator';
5
- import { Product } from './product.entity';
5
+ import { Product } from './product.entity.js';
6
6
 
7
7
  class CreateProductDto {
8
8
  @IsString()
@@ -1,7 +1,7 @@
1
1
  import { Module } from '@nestjs/common';
2
2
  import { TypeOrmModule } from '@nestjs/typeorm';
3
- import { Product } from './product.entity';
4
- import { ProductsController } from './products.controller';
3
+ import { Product } from './product.entity.js';
4
+ import { ProductsController } from './products.controller.js';
5
5
 
6
6
  /** CRUD enxuto: só o controller e a entity. Sem providers de porta/adapter — não há o que inverter. */
7
7
  @Module({
@@ -1,5 +1,5 @@
1
- import { Order } from '../../src/modules/orders/domain/order.entity';
2
- import { Money } from '../../src/modules/orders/domain/money.vo';
1
+ import { Order } from '../../src/modules/orders/domain/order.entity.js';
2
+ import { Money } from '../../src/modules/orders/domain/money.vo.js';
3
3
 
4
4
  /**
5
5
  * A prova concreta do isolamento (AC-8): estes testes exercem a **regra de negócio** instanciando
@@ -0,0 +1,15 @@
1
+ {
2
+ "extends": "./tsconfig.json",
3
+ "compilerOptions": {
4
+ "rootDir": "./src"
5
+ },
6
+ "include": [
7
+ "src"
8
+ ],
9
+ "exclude": [
10
+ "node_modules",
11
+ "test",
12
+ "dist",
13
+ "**/*spec.ts"
14
+ ]
15
+ }
@@ -1,16 +1,30 @@
1
1
  {
2
2
  "compilerOptions": {
3
- "module": "commonjs",
4
- "target": "es2022",
5
- "moduleResolution": "node",
6
- "experimentalDecorators": true,
7
- "emitDecoratorMetadata": true,
8
- "declaration": false,
9
- "strict": true,
10
- "skipLibCheck": true,
3
+ "module": "nodenext",
4
+ "moduleResolution": "nodenext",
5
+ "resolvePackageJsonExports": true,
11
6
  "esModuleInterop": true,
7
+ "isolatedModules": true,
8
+ "declaration": false,
9
+ "removeComments": true,
10
+ "emitDecoratorMetadata": true,
11
+ "experimentalDecorators": true,
12
+ "allowSyntheticDefaultImports": true,
13
+ "target": "ES2023",
14
+ "sourceMap": true,
12
15
  "outDir": "./dist",
13
- "baseUrl": "./"
16
+ "rootDir": ".",
17
+ "incremental": true,
18
+ "skipLibCheck": true,
19
+ "strict": true,
20
+ "strictPropertyInitialization": false,
21
+ "types": [
22
+ "vitest/globals",
23
+ "node"
24
+ ]
14
25
  },
15
- "include": ["src/**/*", "test/**/*"]
26
+ "include": [
27
+ "src/**/*",
28
+ "test/**/*"
29
+ ]
16
30
  }
@@ -0,0 +1,11 @@
1
+ import { defineConfig } from 'vitest/config';
2
+ import tsconfigPaths from 'vite-tsconfig-paths';
3
+
4
+ export default defineConfig({
5
+ plugins: [tsconfigPaths()],
6
+ test: {
7
+ globals: true,
8
+ root: './',
9
+ include: ['src/**/*.spec.ts', 'test/**/*.spec.ts'],
10
+ },
11
+ });
@@ -6,10 +6,10 @@
6
6
  "path": "boilerplates/06-clean-arch",
7
7
  "readme": "boilerplates/06-clean-arch/README.md",
8
8
  "stack": [
9
- "NestJS",
10
- "TypeScript",
9
+ "NestJS 12",
11
10
  "TypeORM",
12
- "Postgres"
11
+ "Postgres",
12
+ "Vitest"
13
13
  ],
14
14
  "useCases": [
15
15
  "Domínio com regra de negócio",
@@ -21,7 +21,7 @@
21
21
  "npm install",
22
22
  "npm run start:dev",
23
23
  "npm test",
24
- "npm run test:e2e"
24
+ "npm run lint"
25
25
  ],
26
26
  "gates": [
27
27
  "npm test",
@@ -39,5 +39,6 @@
39
39
  "dist",
40
40
  "coverage"
41
41
  ]
42
- }
42
+ },
43
+ "template": true
43
44
  }
@@ -1,6 +1,14 @@
1
1
  # 🏗️ Boilerplates - Casos de Uso Profissionais
2
2
 
3
- Exemplos prontos para produção usando **create-memory-nest-kit**.
3
+ Arquiteturas que acompanham o Forja. Há dois tipos:
4
+
5
+ - **Templates validados** — `forja project:new <nome> --template <template>` cria o projeto a partir
6
+ deles. "Validado" é uma promessa cobrada no CI: o backend instala, compila, passa nos testes e no
7
+ lint (`forja project:smoke --full --template <template>`).
8
+ - **Referência** — arquiteturas para a IA e o time consultarem e adaptarem; ainda sem essa validação.
9
+
10
+ `forja project:templates` mostra qual é qual. Todos estão indexados no catálogo
11
+ (`forja catalog:assets`, `forja query:universal "<stack>"`).
4
12
 
5
13
  Cada boilerplate é um projeto completo com:
6
14
  - ✅ Estrutura hierárquica de memória
@@ -18,7 +26,7 @@ Cada boilerplate é um projeto completo com:
18
26
  **Para**: APIs RESTful simples, microserviços, backends genéricos
19
27
 
20
28
  ```bash
21
- node ../bin/init-project.js meu-projeto --template api-rest
29
+ forja project:new meu-projeto # e use boilerplates/01-api-rest/ como arquitetura de referência
22
30
  ```
23
31
 
24
32
  **Inclui**:
@@ -39,7 +47,7 @@ node ../bin/init-project.js meu-projeto --template api-rest
39
47
  **Para**: Aplicações multi-tenant, subscriptions, billing
40
48
 
41
49
  ```bash
42
- node ../bin/init-project.js meu-projeto --template saas
50
+ forja project:new meu-projeto # e use boilerplates/02-saas-starter/ como arquitetura de referência
43
51
  ```
44
52
 
45
53
  **Inclui**:
@@ -60,7 +68,7 @@ node ../bin/init-project.js meu-projeto --template saas
60
68
  **Para**: Lojas online, marketplaces, checkout
61
69
 
62
70
  ```bash
63
- node ../bin/init-project.js meu-projeto --template ecommerce
71
+ forja project:new meu-projeto # e use boilerplates/03-ecommerce-starter/ como arquitetura de referência
64
72
  ```
65
73
 
66
74
  **Inclui**:
@@ -81,7 +89,7 @@ node ../bin/init-project.js meu-projeto --template ecommerce
81
89
  **Para**: Arquiteturas distribuídas, orquestração
82
90
 
83
91
  ```bash
84
- node ../bin/init-project.js meu-projeto --template microservices
92
+ forja project:new meu-projeto # e use boilerplates/04-microservices-starter/ como arquitetura de referência
85
93
  ```
86
94
 
87
95
  **Inclui**:
@@ -102,7 +110,7 @@ node ../bin/init-project.js meu-projeto --template microservices
102
110
  **Para**: Monorepositórios, full-stack em um só lugar
103
111
 
104
112
  ```bash
105
- node ../bin/init-project.js meu-projeto --template monorepo
113
+ forja project:new meu-projeto # e use boilerplates/05-monorepo-starter/ como arquitetura de referência
106
114
  ```
107
115
 
108
116
  **Inclui**:
@@ -123,7 +131,7 @@ node ../bin/init-project.js meu-projeto --template monorepo
123
131
  **Para**: Produtos com regra de negócio de verdade — DDD por camadas, sem cerimônia
124
132
 
125
133
  ```bash
126
- node ../bin/init-project.js meu-projeto --template clean-arch
134
+ forja project:new meu-projeto --template clean-arch # template validado (NestJS 12, Vitest)
127
135
  ```
128
136
 
129
137
  **Inclui**:
@@ -139,36 +147,12 @@ node ../bin/init-project.js meu-projeto --template clean-arch
139
147
 
140
148
  ---
141
149
 
142
- ### 📊 6. Dashboard Admin
143
- **Para**: Painel administrativo, gestão interna
144
-
145
- ```bash
146
- node ../bin/init-project.js meu-projeto --template dashboard-admin
147
- ```
148
-
149
- **Inclui**:
150
- - RBAC avançado
151
- - Dashboard com gráficos
152
- - Gestão de usuários
153
- - Auditoria e logs
154
- - Relatórios
155
- - Dark mode
156
-
157
- **Use quando**: Construir admin interno, painel gerencial
158
-
159
- [Abrir 📂](./06-dashboard-admin)
160
-
161
- ---
162
-
163
150
  ## 🚀 Quick Start
164
151
 
165
- ### 1. Escolher Template
152
+ ### 1. Criar o projeto e escolher a referência
166
153
  ```bash
167
- # Listar templates disponíveis
168
- node ../bin/init-project.js --list-templates
169
-
170
- # Escolha um:
171
- node ../bin/init-project.js meu-api --template api-rest
154
+ forja project:templates # templates validados × referências
155
+ forja project:new meu-api --template clean-arch
172
156
  ```
173
157
 
174
158
  ### 2. Setup
@@ -232,11 +216,9 @@ template/
232
216
  │ ├── scripts/ ← Automação
233
217
  │ └── docker-compose.yml ← Infrastructure
234
218
  │
235
- ├── .ia-instructions/ ← Instruções para IAs
236
- │ ├── copilot.md
237
- │ ├── claude.md
238
- │ ├── gemini.md
239
- │ └── codex.md
219
+ ├── AGENTS.md, CLAUDE.md ← Instruções para IAs (lidas nativamente)
220
+ ├── .claude/ ← hooks e sub-agents do Claude Code
221
+ ├── .mcp.json ← servidor MCP do Forja
240
222
  │
241
223
  ├── README.md ← Documentação
242
224
  ├── .env.example ← Exemplo de config
@@ -291,14 +273,12 @@ cat backend/src/modules/products/
291
273
 
292
274
  ## 🤖 Usar com IAs
293
275
 
294
- Cada boilerplate inclui instruções para Copilot, Claude, Gemini e Codex:
276
+ O projeto criado pelo `forja project:new` já sai conectado: Codex, Copilot e Gemini leem o
277
+ `AGENTS.md`; o Claude Code lê o `CLAUDE.md` e roda os hooks do Forja ao abrir a sessão.
295
278
 
296
279
  ```bash
297
280
  cd meu-projeto
298
- cat .ia-instructions/copilot.md # Para Copilot
299
- cat .ia-instructions/claude.md # Para Claude
300
- cat .ia-instructions/gemini.md # Para Gemini
301
- cat .ia-instructions/codex.md # Para Codex
281
+ forja project:wire --check # confirma instruções, hooks, sub-agents e MCP
302
282
  ```
303
283
 
304
284
  ---
@@ -1,11 +1,11 @@
1
1
  import { randomUUID } from 'node:crypto';
2
2
  import { spawnSync } from 'node:child_process';
3
- import { CONTRACT_VERSION, } from "../../../packages/contracts/src/index.js";
4
- import { CapabilityRegistry, } from "../../../packages/core/src/index.js";
5
- import { PolicyEngine } from "../../../packages/policy/src/index.js";
6
- import { COMMANDS, resolveScript } from "../../../lib/core/registry.js";
7
- import { GraphIndexer } from "../../../packages/graph/src/index.js";
8
- import { parseArgv, argvFor, makeValidator } from "./params.js";
3
+ import { CONTRACT_VERSION, } from '../../../packages/contracts/src/index.js';
4
+ import { CapabilityRegistry, } from '../../../packages/core/src/index.js';
5
+ import { PolicyEngine } from '../../../packages/policy/src/index.js';
6
+ import { COMMANDS, resolveScript } from '../../../lib/core/registry.js';
7
+ import { GraphIndexer } from '../../../packages/graph/src/index.js';
8
+ import { parseArgv, argvFor, makeValidator } from './params.js';
9
9
  export function createLegacyCliRunner(root, cwd = process.cwd()) {
10
10
  return (command, args) => {
11
11
  const definition = COMMANDS[command];
@@ -1,6 +1,6 @@
1
+ declare const nextConfig: {
2
+ reactStrictMode: boolean;
3
+ output: string;
4
+ outputFileTracingRoot: string;
5
+ };
1
6
  export default nextConfig;
2
- declare namespace nextConfig {
3
- let reactStrictMode: boolean;
4
- let output: string;
5
- let outputFileTracingRoot: string;
6
- }
@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
6
6
  };
7
7
  var AppModule_1;
8
8
  import { Module } from '@nestjs/common';
9
- import { ForjaNestModule } from "./forja-nest.module.js";
9
+ import { ForjaNestModule } from './forja-nest.module.js';
10
10
  let AppModule = AppModule_1 = class AppModule {
11
11
  static register(options) { return { module: AppModule_1, imports: [ForjaNestModule.register(options)] }; }
12
12
  };
@@ -13,7 +13,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
13
13
  var ForjaNestModule_1;
14
14
  import { Controller, Get, Global, Inject, Injectable, Module, Optional, Post, Req, Res, Sse, UnauthorizedException, UseGuards } from '@nestjs/common';
15
15
  import { Observable as RxObservable } from 'rxjs';
16
- import { ForjaNestAdapter, isLoopbackAddress } from "../../../packages/adapter-nest/src/index.js";
16
+ import { ForjaNestAdapter, isLoopbackAddress } from '../../../packages/adapter-nest/src/index.js';
17
17
  export const FORJA_MCP = Symbol('FORJA_MCP');
18
18
  export const FORJA_EVENT_STREAM = Symbol('FORJA_EVENT_STREAM');
19
19
  export const FORJA_AUTHENTICATOR = Symbol('FORJA_AUTHENTICATOR');
@@ -1,4 +1,4 @@
1
- import { ForjaNestAdapter } from "../../../packages/adapter-nest/src/index.js";
1
+ import { ForjaNestAdapter } from '../../../packages/adapter-nest/src/index.js';
2
2
  export class ForjaServerApplication {
3
3
  http;
4
4
  constructor(options) { this.http = new ForjaNestAdapter(options.mcp, options.eventStream, options.authenticator, options.controlPlane); }
@@ -5,26 +5,26 @@ import { fileURLToPath } from 'node:url';
5
5
  import Database from 'better-sqlite3';
6
6
  import { NestFactory } from '@nestjs/core';
7
7
  import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
8
- import { CapabilityRegistry } from "../../../packages/core/src/index.js";
9
- import { PolicyEngine } from "../../../packages/policy/src/index.js";
10
- import { McpServer } from "../../../packages/mcp/src/index.js";
11
- import { ControlPlane, InMemoryObservationStore, ObservabilityRecorder } from "../../../packages/observability/src/index.js";
12
- import { ApprovalLedger } from "../../../packages/policy/src/index.js";
13
- import { HandoffEngine, InMemoryOrchestrationStore, SprintEngine, TaskEngine } from "../../../packages/orchestration/src/index.js";
14
- import { validateTokenBudget } from "../../../packages/contracts/src/index.js";
15
- import { createBearerAuthenticator, InMemoryEventStream } from "../../../packages/adapter-nest/src/index.js";
16
- import { AppModule } from "./app.module.js";
17
- import { RuntimeEngine } from "../../../packages/runtime/src/index.js";
18
- import { GraphExecutionMemory, GraphLoop } from "../../../packages/graph/src/index.js";
19
- import { ContextEngine, GraphContextSource } from "../../../packages/context/src/index.js";
20
- import { SqliteContextCache, SqliteGraphStore, SqliteMigrationRunner, SqliteRuntimePersistence } from "../../../packages/adapter-sqlite/src/index.js";
21
- import { SqliteApprovalStore, SqliteMcpAuditSink, SqliteObservationStore, SqliteOrchestrationStore } from "../../../packages/adapter-sqlite/src/index.js";
22
- import { EventBus } from "../../../packages/events/src/index.js";
23
- import { SqliteEventStore } from "../../../packages/adapter-sqlite/src/index.js";
24
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../../../lib/workspace.js";
25
- import { createLegacyCliRunner, registerCliCapabilities } from "../../cli/src/index.js";
26
- import { registerGraphSyncCapability } from "../../cli/src/index.js";
27
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../../../packages/adapter-git/src/index.js";
8
+ import { CapabilityRegistry } from '../../../packages/core/src/index.js';
9
+ import { PolicyEngine } from '../../../packages/policy/src/index.js';
10
+ import { McpServer } from '../../../packages/mcp/src/index.js';
11
+ import { ControlPlane, InMemoryObservationStore, ObservabilityRecorder } from '../../../packages/observability/src/index.js';
12
+ import { ApprovalLedger } from '../../../packages/policy/src/index.js';
13
+ import { HandoffEngine, InMemoryOrchestrationStore, SprintEngine, TaskEngine } from '../../../packages/orchestration/src/index.js';
14
+ import { validateTokenBudget } from '../../../packages/contracts/src/index.js';
15
+ import { createBearerAuthenticator, InMemoryEventStream } from '../../../packages/adapter-nest/src/index.js';
16
+ import { AppModule } from './app.module.js';
17
+ import { RuntimeEngine } from '../../../packages/runtime/src/index.js';
18
+ import { GraphExecutionMemory, GraphLoop } from '../../../packages/graph/src/index.js';
19
+ import { ContextEngine, GraphContextSource } from '../../../packages/context/src/index.js';
20
+ import { SqliteContextCache, SqliteGraphStore, SqliteMigrationRunner, SqliteRuntimePersistence } from '../../../packages/adapter-sqlite/src/index.js';
21
+ import { SqliteApprovalStore, SqliteMcpAuditSink, SqliteObservationStore, SqliteOrchestrationStore } from '../../../packages/adapter-sqlite/src/index.js';
22
+ import { EventBus } from '../../../packages/events/src/index.js';
23
+ import { SqliteEventStore } from '../../../packages/adapter-sqlite/src/index.js';
24
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../../../lib/workspace.js';
25
+ import { createLegacyCliRunner, registerCliCapabilities } from '../../cli/src/index.js';
26
+ import { registerGraphSyncCapability } from '../../cli/src/index.js';
27
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../../../packages/adapter-git/src/index.js';
28
28
  const serverRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
29
29
  export function createDefaultCapabilityRegistry(root = serverRoot, cwd = process.cwd()) {
30
30
  const registry = new CapabilityRegistry();
@@ -1,7 +1,7 @@
1
- import { EvaluationEngine } from "../../../packages/evals/src/index.js";
2
- import { EventBus } from "../../../packages/events/src/index.js";
3
- import { Scheduler } from "../../../packages/scheduler/src/index.js";
4
- import { InMemoryObservationStore, ObservabilityRecorder } from "../../../packages/observability/src/index.js";
1
+ import { EvaluationEngine } from '../../../packages/evals/src/index.js';
2
+ import { EventBus } from '../../../packages/events/src/index.js';
3
+ import { Scheduler } from '../../../packages/scheduler/src/index.js';
4
+ import { InMemoryObservationStore, ObservabilityRecorder } from '../../../packages/observability/src/index.js';
5
5
  export function createWorkerRuntime() {
6
6
  const observations = new InMemoryObservationStore();
7
7
  const events = new EventBus();
@@ -13,11 +13,11 @@
13
13
  import path from 'node:path';
14
14
  import process from 'node:process';
15
15
  import { fileURLToPath } from 'node:url';
16
- import { generateMemoryStructure } from "../lib/generators/memory-generator.js";
17
- import { generateNestStructure } from "../lib/generators/nest-generator.js";
18
- import { generateReadme } from "../lib/generators/readme-generator.js";
19
- import { validateProjectStructure, printValidationReport } from "../lib/validators/structure-validator.js";
20
- import { ensureDir, logSuccess, logError } from "../lib/utils/file-helpers.js";
16
+ import { generateMemoryStructure } from '../lib/generators/memory-generator.js';
17
+ import { generateNestStructure } from '../lib/generators/nest-generator.js';
18
+ import { generateReadme } from '../lib/generators/readme-generator.js';
19
+ import { validateProjectStructure, printValidationReport } from '../lib/validators/structure-validator.js';
20
+ import { ensureDir, logSuccess, logError } from '../lib/utils/file-helpers.js';
21
21
  const __filename = fileURLToPath(import.meta.url);
22
22
  const __dirname = path.dirname(__filename);
23
23
  // Parse arguments
package/dist/bin/forja.js CHANGED
@@ -15,17 +15,25 @@ import path from 'node:path';
15
15
  import { spawnSync } from 'node:child_process';
16
16
  import { fileURLToPath } from 'node:url';
17
17
  import Database from 'better-sqlite3';
18
- import { COMMANDS, DOMAINS, resolveScript } from "../lib/core/registry.js";
19
- import { getWorkspaceInfo, getWorkspaceContextDir } from "../lib/workspace.js";
20
- import { capabilityIdForCommand, createCliCapabilityRuntime, executeCliCapability, parseLegacyCommandInput, } from "../apps/cli/src/index.js";
21
- import { GitGraphDocumentSource, SpawnCommandRunner } from "../packages/adapter-git/src/index.js";
22
- import { GraphLoop } from "../packages/graph/src/index.js";
23
- import { SqliteGraphStore, SqliteMigrationRunner } from "../packages/adapter-sqlite/src/index.js";
24
- import { getWorkspaceDbDir, getWorkspaceDbPath } from "../lib/workspace.js";
25
- import { McpServer } from "../packages/mcp/src/index.js";
18
+ import { COMMANDS, DOMAINS, resolveScript } from '../lib/core/registry.js';
19
+ import { getWorkspaceInfo, getWorkspaceContextDir } from '../lib/workspace.js';
20
+ import { capabilityIdForCommand, createCliCapabilityRuntime, executeCliCapability, parseLegacyCommandInput, } from '../apps/cli/src/index.js';
21
+ import { GitGraphDocumentSource, SpawnCommandRunner } from '../packages/adapter-git/src/index.js';
22
+ import { GraphLoop } from '../packages/graph/src/index.js';
23
+ import { SqliteGraphStore, SqliteMigrationRunner } from '../packages/adapter-sqlite/src/index.js';
24
+ import { getWorkspaceDbDir, getWorkspaceDbPath } from '../lib/workspace.js';
25
+ import { McpServer } from '../packages/mcp/src/index.js';
26
+ import { pkgRoot, codeRoot } from '../lib/paths.js';
26
27
  const __dirname = path.dirname(fileURLToPath(import.meta.url));
27
- const root = path.resolve(__dirname, '..');
28
- const STUDIO_COMMANDS = new Set(['workspace:init', 'project:new', 'project:list', 'project:upgrade', 'workspace:project:check', 'init:project', 'demo:workspace']);
28
+ const root = pkgRoot;
29
+ // Versão real do pacote — o MCP anunciava '2.0.3' cravado desde a v2.
30
+ const FORJA_VERSION = (() => { try {
31
+ return JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8')).version;
32
+ }
33
+ catch {
34
+ return '0.0.0';
35
+ } })();
36
+ const STUDIO_COMMANDS = new Set(['workspace:init', 'project:new', 'project:list', 'project:upgrade', 'workspace:project:check', 'demo:workspace']);
29
37
  // SPEC-043: `forja help` mostra só o núcleo (`tier: 'core'`); `forja help --all` mantém a lista
30
38
  // completa de antes. O detalhe por comando vive em `printCommandHelp`.
31
39
  function printHelp(all = false) {
@@ -207,10 +215,16 @@ function runGates(cmd) {
207
215
  * `docs/contrato-saida-cli.md`.
208
216
  */
209
217
  // Auditoria nunca bloqueia o comando (NFR da SPEC-025).
218
+ // Hooks rodam a cada prompt da IA: auditá-los afogaria a trilha. Sem workspace não há onde auditar —
219
+ // antes caía em `<pacote>/.context`, ou seja, dentro de node_modules no pacote instalado.
210
220
  function audit(entry) {
221
+ if (String(entry.cmd).startsWith('hook:'))
222
+ return;
211
223
  try {
212
224
  const info = getWorkspaceInfo();
213
- const dir = info.exists ? getWorkspaceContextDir() : path.join(root, '.context');
225
+ if (!info.exists)
226
+ return;
227
+ const dir = getWorkspaceContextDir();
214
228
  fs.mkdirSync(dir, { recursive: true });
215
229
  fs.appendFileSync(path.join(dir, 'forja-runs.jsonl'), JSON.stringify(entry) + '\n', 'utf8');
216
230
  }
@@ -224,7 +238,7 @@ function runLegacyCaptured(command, args) {
224
238
  return { exitCode: 127, stdout: '', stderr: `Comando legado não encontrado: ${command}` };
225
239
  let result;
226
240
  if (cmd.node) {
227
- const script = resolveScript(root, cmd.node);
241
+ const script = resolveScript(codeRoot, cmd.node);
228
242
  result = spawnSync('node', [script, ...(cmd.args || []), ...args], {
229
243
  cwd: process.cwd(),
230
244
  encoding: 'utf8',
@@ -440,7 +454,7 @@ async function runMcpStdio() {
440
454
  return;
441
455
  let result;
442
456
  if (request.method === 'initialize')
443
- result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: '2.0.3' } };
457
+ result = { protocolVersion: '2025-06-18', capabilities: { tools: {}, resources: {} }, serverInfo: { name: 'forja', version: FORJA_VERSION } };
444
458
  else if (request.method === 'tools/list')
445
459
  result = { tools: mcp.listTools() };
446
460
  else if (request.method === 'resources/list')
@@ -560,7 +574,7 @@ let result;
560
574
  // DENTRO do pacote (bug da v1.6.1). Scripts do framework não dependem de cwd: resolvem seus paths
561
575
  // por __dirname (repo) ou pelo workspace (absoluto).
562
576
  if (cmd.node) {
563
- const script = resolveScript(root, cmd.node);
577
+ const script = resolveScript(codeRoot, cmd.node);
564
578
  result = spawnSync('node', [script, ...(cmd.args || []), ...rest], {
565
579
  cwd: process.cwd(),
566
580
  stdio: 'inherit',
@@ -1,14 +1,9 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * init-project.js
3
+ * bin/init-project.ts — gerador de projeto do workspace, chamado por `forja project:new`.
4
4
  *
5
- * Comando universal para inicializar novo projeto com agentes orquestrados.
6
- * Puxa configuração de Copilot, Claude, Gemini, Codex e outros.
7
- *
8
- * Uso:
9
- * node bin/init-project.js meu-projeto
10
- * node bin/init-project.js meu-projeto --ai copilot,claude,gemini
11
- * node bin/init-project.js meu-projeto --skip-backend
12
- * node bin/init-project.js --interactive
5
+ * Gera memória + agentes (create-memory-nest-kit), backend NestJS opcional, design-md, e conecta o
6
+ * projeto à inteligência do Forja (lib/project-wiring.ts). Termina com exit 1 se algo essencial
7
+ * falhou — o resumo final lista cada pendência.
13
8
  */
14
9
  export {};