forjajs 4.1.2 → 5.0.1
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.
- package/.claude/settings.json +2 -2
- package/.gemini-instructions.md +1 -1
- package/.github/copilot-instructions.md +1 -1
- package/.openai-instructions.md +1 -1
- package/CHANGELOG.md +139 -0
- package/DOC-MAP.md +2 -2
- package/README.md +62 -10
- package/README.pt-BR.md +46 -7
- package/boilerplates/01-api-rest/README.md +1 -1
- package/boilerplates/06-clean-arch/README.md +5 -3
- package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
- package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
- package/boilerplates/06-clean-arch/backend/package.json +22 -24
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
- package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
- package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
- package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
- package/boilerplates/README.md +24 -44
- package/dist/apps/cli/src/index.js +6 -6
- package/dist/apps/dashboard/next.config.d.mts +5 -5
- package/dist/apps/server/src/app.module.js +1 -1
- package/dist/apps/server/src/forja-nest.module.js +1 -1
- package/dist/apps/server/src/index.js +1 -1
- package/dist/apps/server/src/main.js +20 -20
- package/dist/apps/worker/src/main.js +4 -4
- package/dist/bin/create-memory-nest-kit.js +5 -5
- package/dist/bin/forja.js +28 -14
- package/dist/bin/init-project.d.ts +4 -9
- package/dist/bin/init-project.js +126 -182
- package/dist/lib/audit.js +1 -1
- package/dist/lib/context-builder.d.ts +6 -1
- package/dist/lib/context-builder.js +21 -12
- package/dist/lib/core/architecture-gate.js +2 -4
- package/dist/lib/core/checks.d.ts +1 -1
- package/dist/lib/core/drift-gate.js +2 -4
- package/dist/lib/core/gates.js +5 -5
- package/dist/lib/core/health.d.ts +0 -1
- package/dist/lib/core/health.js +33 -7
- package/dist/lib/core/journey.d.ts +30 -0
- package/dist/lib/core/journey.js +142 -0
- package/dist/lib/core/model-pricing.js +3 -5
- package/dist/lib/core/project-smoke.d.ts +6 -2
- package/dist/lib/core/project-smoke.js +60 -61
- package/dist/lib/core/registry.d.ts +1 -12
- package/dist/lib/core/registry.js +42 -32
- package/dist/lib/core/release.d.ts +1 -1
- package/dist/lib/core/release.js +31 -3
- package/dist/lib/core/risk-collect.js +4 -4
- package/dist/lib/drift-sentinel.js +1 -1
- package/dist/lib/generators/memory-generator.d.ts +30 -30
- package/dist/lib/generators/memory-generator.js +19 -8
- package/dist/lib/generators/nest-generator.js +192 -275
- package/dist/lib/generators/readme-generator.js +1 -1
- package/dist/lib/governance-report.js +4 -4
- package/dist/lib/handoffs-index.d.ts +16 -2
- package/dist/lib/handoffs-index.js +32 -5
- package/dist/lib/llm/session.js +1 -1
- package/dist/lib/llm/validation.js +1 -1
- package/dist/lib/memory-audit.js +1 -1
- package/dist/lib/paths.d.ts +39 -0
- package/dist/lib/paths.js +73 -0
- package/dist/lib/project-upgrade.d.ts +0 -4
- package/dist/lib/project-upgrade.js +19 -1
- package/dist/lib/project-wiring.d.ts +54 -0
- package/dist/lib/project-wiring.js +391 -0
- package/dist/lib/status-model.js +18 -7
- package/dist/lib/templates.d.ts +24 -0
- package/dist/lib/templates.js +77 -0
- package/dist/lib/validators/structure-validator.js +0 -1
- package/dist/lib/workspace.d.ts +7 -0
- package/dist/lib/workspace.js +20 -2
- package/dist/packages/adapter-git/src/index.js +2 -2
- package/dist/packages/context/src/index.js +1 -1
- package/dist/packages/core/src/index.js +1 -1
- package/dist/packages/evals/src/index.js +1 -1
- package/dist/packages/events/src/index.js +1 -1
- package/dist/packages/graph/src/index.js +1 -1
- package/dist/packages/mcp/src/index.d.ts +1 -1
- package/dist/packages/observability/src/index.js +1 -1
- package/dist/packages/orchestration/src/index.js +1 -1
- package/dist/packages/planner/src/index.js +1 -1
- package/dist/packages/policy/src/index.js +1 -1
- package/dist/packages/runtime/src/index.js +1 -1
- package/dist/packages/sandbox/src/index.js +1 -1
- package/dist/packages/validator/src/index.js +1 -1
- package/dist/scripts/adr.js +4 -4
- package/dist/scripts/agent-harness.js +30 -23
- package/dist/scripts/agent-router.js +22 -5
- package/dist/scripts/agent.js +5 -5
- package/dist/scripts/architecture.js +6 -6
- package/dist/scripts/audit-query.js +1 -1
- package/dist/scripts/audit-sync.js +1 -1
- package/dist/scripts/build-smart-context.d.ts +19 -1
- package/dist/scripts/build-smart-context.js +84 -68
- package/dist/scripts/check-standards.js +8 -3
- package/dist/scripts/code-context.js +1 -1
- package/dist/scripts/compress-memory.js +3 -2
- package/dist/scripts/compress-project-memory.js +2 -2
- package/dist/scripts/context-ops.js +13 -5
- package/dist/scripts/cost-economy.js +4 -4
- package/dist/scripts/demo-autonomy.js +11 -11
- package/dist/scripts/demo-workspace.js +12 -4
- package/dist/scripts/dev.js +8 -7
- package/dist/scripts/drift-check.js +5 -5
- package/dist/scripts/engineer.js +11 -11
- package/dist/scripts/evidence.js +4 -4
- package/dist/scripts/extract-global-knowledge.js +6 -4
- package/dist/scripts/forja-setup.js +2 -1
- package/dist/scripts/forja-status.js +5 -4
- package/dist/scripts/gates.js +1 -1
- package/dist/scripts/generate-dashboard.js +6 -4
- package/dist/scripts/governance-dashboard.js +2 -2
- package/dist/scripts/hook-session-start.js +11 -10
- package/dist/scripts/hook-user-prompt.js +3 -2
- package/dist/scripts/incident.js +4 -4
- package/dist/scripts/llm-fit.js +11 -11
- package/dist/scripts/memory-audit.js +1 -1
- package/dist/scripts/memory-schema.js +3 -2
- package/dist/scripts/orchestrate.js +4 -5
- package/dist/scripts/project-smoke.js +13 -2
- package/dist/scripts/project-templates.d.ts +1 -0
- package/dist/scripts/project-templates.js +20 -0
- package/dist/scripts/project-upgrade.d.ts +13 -0
- package/dist/scripts/project-upgrade.js +110 -40
- package/dist/scripts/project-wire.d.ts +8 -0
- package/dist/scripts/project-wire.js +55 -0
- package/dist/scripts/provenance.js +3 -3
- package/dist/scripts/query-universal-memory.js +7 -4
- package/dist/scripts/release-check.js +1 -1
- package/dist/scripts/risk.js +4 -4
- package/dist/scripts/simulate.js +9 -9
- package/dist/scripts/spec-cli.d.ts +1 -0
- package/dist/scripts/spec-cli.js +25 -5
- package/dist/scripts/sprint-manager.js +4 -3
- package/dist/scripts/sync-universal-memory.js +22 -15
- package/dist/scripts/token-benchmark.js +4 -3
- package/dist/scripts/token-economy.js +4 -3
- package/dist/scripts/tools-doctor.d.ts +1 -1
- package/dist/scripts/tools-doctor.js +25 -3
- package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
- package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
- package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
- package/docs/glossary.md +4 -4
- package/docs/init-project.md +88 -444
- package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
- package/docs/modos-de-operacao.md +1 -1
- package/docs/processo-projeto.md +14 -11
- package/docs/produto/roteiro-demo.md +15 -18
- package/docs/publishing.md +5 -0
- package/docs/quick-reference.md +15 -23
- package/docs/structure.md +16 -30
- package/lib/core/model-pricing.json +19 -0
- package/memory/30-projects/README.md +1 -1
- package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
- package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
- package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
- package/memory/90-decisions/0088-templates-validados.md +55 -0
- package/package.json +26 -26
- package/templates/project/AGENTS.md +75 -0
- package/templates/project/CLAUDE.md +9 -0
- package/templates/project/agents/context-engineer.md +15 -0
- package/templates/project/agents/governance.md +15 -0
- package/templates/project/agents/marketing.md +15 -0
- package/templates/project/agents/orchestrator.md +15 -0
- package/templates/project/agents/product.md +15 -0
- package/templates/project/agents/sdd-architect.md +15 -0
- package/dist/lib/multi-ai-instructions.d.ts +0 -28
- package/dist/lib/multi-ai-instructions.js +0 -83
package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts
CHANGED
|
@@ -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
|
package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts
CHANGED
|
@@ -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,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:
|
package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts
CHANGED
|
@@ -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
|
|
@@ -1,16 +1,30 @@
|
|
|
1
1
|
{
|
|
2
2
|
"compilerOptions": {
|
|
3
|
-
"module": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
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
|
-
"
|
|
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": [
|
|
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
|
|
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
|
}
|
package/boilerplates/README.md
CHANGED
|
@@ -1,6 +1,14 @@
|
|
|
1
1
|
# 🏗️ Boilerplates - Casos de Uso Profissionais
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
152
|
+
### 1. Criar o projeto e escolher a referência
|
|
166
153
|
```bash
|
|
167
|
-
#
|
|
168
|
-
|
|
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
|
-
├── .
|
|
236
|
-
|
|
237
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
4
|
-
import { CapabilityRegistry, } from
|
|
5
|
-
import { PolicyEngine } from
|
|
6
|
-
import { COMMANDS, resolveScript } from
|
|
7
|
-
import { GraphIndexer } from
|
|
8
|
-
import { parseArgv, argvFor, makeValidator } from
|
|
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
|
|
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
|
|
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
|
|
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
|
|
9
|
-
import { PolicyEngine } from
|
|
10
|
-
import { McpServer } from
|
|
11
|
-
import { ControlPlane, InMemoryObservationStore, ObservabilityRecorder } from
|
|
12
|
-
import { ApprovalLedger } from
|
|
13
|
-
import { HandoffEngine, InMemoryOrchestrationStore, SprintEngine, TaskEngine } from
|
|
14
|
-
import { validateTokenBudget } from
|
|
15
|
-
import { createBearerAuthenticator, InMemoryEventStream } from
|
|
16
|
-
import { AppModule } from
|
|
17
|
-
import { RuntimeEngine } from
|
|
18
|
-
import { GraphExecutionMemory, GraphLoop } from
|
|
19
|
-
import { ContextEngine, GraphContextSource } from
|
|
20
|
-
import { SqliteContextCache, SqliteGraphStore, SqliteMigrationRunner, SqliteRuntimePersistence } from
|
|
21
|
-
import { SqliteApprovalStore, SqliteMcpAuditSink, SqliteObservationStore, SqliteOrchestrationStore } from
|
|
22
|
-
import { EventBus } from
|
|
23
|
-
import { SqliteEventStore } from
|
|
24
|
-
import { getWorkspaceDbDir, getWorkspaceDbPath } from
|
|
25
|
-
import { createLegacyCliRunner, registerCliCapabilities } from
|
|
26
|
-
import { registerGraphSyncCapability } from
|
|
27
|
-
import { GitGraphDocumentSource, SpawnCommandRunner } from
|
|
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
|
|
2
|
-
import { EventBus } from
|
|
3
|
-
import { Scheduler } from
|
|
4
|
-
import { InMemoryObservationStore, ObservabilityRecorder } from
|
|
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
|
|
17
|
-
import { generateNestStructure } from
|
|
18
|
-
import { generateReadme } from
|
|
19
|
-
import { validateProjectStructure, printValidationReport } from
|
|
20
|
-
import { ensureDir, logSuccess, logError } from
|
|
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
|
|
19
|
-
import { getWorkspaceInfo, getWorkspaceContextDir } from
|
|
20
|
-
import { capabilityIdForCommand, createCliCapabilityRuntime, executeCliCapability, parseLegacyCommandInput, } from
|
|
21
|
-
import { GitGraphDocumentSource, SpawnCommandRunner } from
|
|
22
|
-
import { GraphLoop } from
|
|
23
|
-
import { SqliteGraphStore, SqliteMigrationRunner } from
|
|
24
|
-
import { getWorkspaceDbDir, getWorkspaceDbPath } from
|
|
25
|
-
import { McpServer } from
|
|
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 =
|
|
28
|
-
|
|
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
|
-
|
|
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(
|
|
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:
|
|
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(
|
|
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.
|
|
3
|
+
* bin/init-project.ts — gerador de projeto do workspace, chamado por `forja project:new`.
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
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 {};
|