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
|
@@ -15,17 +15,22 @@
|
|
|
15
15
|
* Diagnostica e prescreve; não conserta. Rodar `npm rebuild` sem consentimento é a classe de
|
|
16
16
|
* risco oposta à que este comando existe para fechar.
|
|
17
17
|
*
|
|
18
|
-
* Uso:
|
|
18
|
+
* Uso: forja tools:doctor
|
|
19
19
|
*/
|
|
20
20
|
import { spawnSync } from 'node:child_process';
|
|
21
|
-
import
|
|
21
|
+
import fs from 'node:fs';
|
|
22
|
+
import path from 'node:path';
|
|
23
|
+
import { runChecks, worstStatus, bucketFor, BUCKET_LABEL } from '../lib/core/health.js';
|
|
24
|
+
import { COMMANDS } from '../lib/core/registry.js';
|
|
25
|
+
import { checkProjectWiring } from '../lib/project-wiring.js';
|
|
26
|
+
import { isInsideFrameworkRepo } from '../lib/workspace.js';
|
|
22
27
|
const TOOLS = [
|
|
23
28
|
{
|
|
24
29
|
name: 'codegraph',
|
|
25
30
|
probe: ['codegraph', ['--version']],
|
|
26
31
|
role: 'Code intelligence: chamadores, blast radius, mapa de impacto (ADR-0017).',
|
|
27
32
|
install: 'npm i -g @codegraph/cli',
|
|
28
|
-
gate: '
|
|
33
|
+
gate: 'forja code:check / code:impact',
|
|
29
34
|
},
|
|
30
35
|
{
|
|
31
36
|
name: 'gitleaks',
|
|
@@ -104,11 +109,28 @@ function printTools() {
|
|
|
104
109
|
console.log(`${installed}/${TOOLS.length} ferramentas disponíveis.`);
|
|
105
110
|
console.log('Ferramentas ausentes apenas desativam seus gates — o fluxo nunca trava por elas.\n');
|
|
106
111
|
}
|
|
112
|
+
/** Num projeto (fora do repo do framework): a IA, os hooks e o MCP estão ligados a ele? */
|
|
113
|
+
function printProject() {
|
|
114
|
+
const cwd = process.cwd();
|
|
115
|
+
if (isInsideFrameworkRepo(cwd) || !fs.existsSync(path.join(cwd, 'AGENTS.md')))
|
|
116
|
+
return null;
|
|
117
|
+
console.log('Projeto — a IA enxerga o Forja aqui? (forja project:wire --check)\n');
|
|
118
|
+
const checks = checkProjectWiring(cwd, { commands: COMMANDS });
|
|
119
|
+
for (const c of checks)
|
|
120
|
+
console.log(`${TAG[c.status]} ${c.id.padEnd(13)} ${c.detail}`);
|
|
121
|
+
console.log('');
|
|
122
|
+
return checks.some((c) => c.status === 'fail') ? 'fail' : checks.some((c) => c.status === 'warn') ? 'warn' : 'ok';
|
|
123
|
+
}
|
|
107
124
|
async function main() {
|
|
108
125
|
console.log('\nForja doctor\n');
|
|
109
126
|
const core = await runChecks();
|
|
110
127
|
printCore(core);
|
|
128
|
+
const project = printProject();
|
|
111
129
|
printTools();
|
|
130
|
+
if (project === 'fail') {
|
|
131
|
+
console.log('Projeto desconectado da IA — corrija com: forja project:wire');
|
|
132
|
+
process.exit(1);
|
|
133
|
+
}
|
|
112
134
|
// Só o núcleo decide o exit code. Ferramenta ausente nunca reprova — o contrato do ADR-0018
|
|
113
135
|
// é preservado à risca.
|
|
114
136
|
const verdict = worstStatus(core);
|
|
@@ -16,7 +16,7 @@ Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
|
|
|
16
16
|
- Rodar sync da memória operacional:
|
|
17
17
|
```bash
|
|
18
18
|
cd backend
|
|
19
|
-
|
|
19
|
+
forja sync:universal
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
### Critério de Pronto (DEV)
|
|
@@ -99,15 +99,14 @@ Se qualquer item for “não”: refinar step antes da execução.
|
|
|
99
99
|
```bash
|
|
100
100
|
cd backend
|
|
101
101
|
npm install
|
|
102
|
-
|
|
103
|
-
npm run memory:db:sync
|
|
102
|
+
forja sync:universal
|
|
104
103
|
```
|
|
105
104
|
|
|
106
105
|
### Consulta de contexto
|
|
107
106
|
```bash
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
107
|
+
forja query:universal "auth" 10
|
|
108
|
+
forja agent:route list
|
|
109
|
+
forja adr:list
|
|
111
110
|
```
|
|
112
111
|
|
|
113
112
|
### Registrar handoff
|
|
@@ -83,9 +83,8 @@ Checagem esperada:
|
|
|
83
83
|
Ainda dentro de `backend/`:
|
|
84
84
|
|
|
85
85
|
```bash
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
npm run memory:db:query -- "search" "contexto" 10
|
|
86
|
+
forja sync:universal
|
|
87
|
+
forja query:universal "contexto" 10
|
|
89
88
|
```
|
|
90
89
|
|
|
91
90
|
O que isso faz:
|
|
@@ -224,12 +223,12 @@ Próximos passos:
|
|
|
224
223
|
1. Sincronizar memória:
|
|
225
224
|
```bash
|
|
226
225
|
cd backend
|
|
227
|
-
|
|
226
|
+
forja sync:universal
|
|
228
227
|
```
|
|
229
228
|
|
|
230
229
|
2. Buscar contexto da tarefa:
|
|
231
230
|
```bash
|
|
232
|
-
|
|
231
|
+
forja query:universal "tema da tarefa" 10
|
|
233
232
|
```
|
|
234
233
|
|
|
235
234
|
3. Executar step
|
|
@@ -242,7 +241,7 @@ npm run memory:db:query -- "search" "tema da tarefa" 10
|
|
|
242
241
|
- Evitar: aplicar seção 7 (questionamento obrigatório).
|
|
243
242
|
|
|
244
243
|
- Erro: esquecer atualização de memória.
|
|
245
|
-
- Evitar: sempre rodar `
|
|
244
|
+
- Evitar: sempre rodar `forja sync:universal` após mudanças relevantes.
|
|
246
245
|
|
|
247
246
|
- Erro: deploy sem rollback claro.
|
|
248
247
|
- Evitar: incluir rollback como item obrigatório no DoD.
|
|
@@ -259,12 +258,11 @@ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
|
|
|
259
258
|
# setup inicial
|
|
260
259
|
cd nome-do-projeto/backend
|
|
261
260
|
npm install
|
|
262
|
-
|
|
263
|
-
npm run memory:db:sync
|
|
261
|
+
forja sync:universal
|
|
264
262
|
npm run start:dev
|
|
265
263
|
|
|
266
264
|
# consultar contexto
|
|
267
|
-
|
|
265
|
+
forja query:universal "auth" 10
|
|
268
266
|
|
|
269
267
|
# registrar handoff (na raiz do projeto)
|
|
270
268
|
cd ..
|
package/docs/glossary.md
CHANGED
|
@@ -128,7 +128,7 @@ No kit: Busca em memory/ via SQLite
|
|
|
128
128
|
CLI que cria novo projeto com toda estrutura. Os projetos vão para o workspace Forja (`~/forja-workspace/projects/<nome>`).
|
|
129
129
|
```
|
|
130
130
|
Comando: npm run project:new meu-projeto
|
|
131
|
-
Arquivos: bin/init-project.
|
|
131
|
+
Arquivos: bin/init-project.ts, bin/create-memory-nest-kit.ts, lib/project-wiring.ts
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
---
|
|
@@ -158,7 +158,7 @@ Esperado: { "status": "ok" }
|
|
|
158
158
|
Estrutura que acelera buscas (SQLite FTS5).
|
|
159
159
|
```
|
|
160
160
|
No kit: memory/ → .memory/sqlite/context.db
|
|
161
|
-
Sync:
|
|
161
|
+
Sync: forja sync:universal
|
|
162
162
|
```
|
|
163
163
|
|
|
164
164
|
---
|
|
@@ -315,8 +315,8 @@ Gerenciar: npm run sprint:start
|
|
|
315
315
|
### SQLite
|
|
316
316
|
Banco de dados leve, em-arquivo.
|
|
317
317
|
```
|
|
318
|
-
No
|
|
319
|
-
|
|
318
|
+
No projeto: memory/sqlite/universal.db (FTS5, fora do git)
|
|
319
|
+
Indexar: forja sync:universal
|
|
320
320
|
```
|
|
321
321
|
|
|
322
322
|
---
|