forjajs 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.json +7 -7
- package/CHANGELOG.md +25 -0
- package/README.en.md +5 -0
- package/README.md +5 -0
- package/dist/bin/create-memory-nest-kit.d.ts +2 -0
- package/dist/bin/create-memory-nest-kit.js +110 -0
- package/dist/bin/forja.d.ts +13 -0
- package/dist/bin/forja.js +136 -0
- package/dist/bin/init-project.d.ts +2 -0
- package/dist/bin/init-project.js +516 -0
- package/dist/lib/audit.d.ts +67 -0
- package/dist/lib/audit.js +143 -0
- package/dist/lib/context-builder.d.ts +58 -0
- package/dist/lib/context-builder.js +233 -0
- package/dist/lib/core/checks.d.ts +91 -0
- package/dist/lib/core/checks.js +119 -0
- package/dist/lib/core/doc-graph.d.ts +60 -0
- package/dist/lib/core/doc-graph.js +235 -0
- package/dist/lib/core/health.d.ts +103 -0
- package/dist/lib/core/health.js +538 -0
- package/dist/lib/core/registry.d.ts +296 -0
- package/dist/lib/core/registry.js +317 -0
- package/dist/lib/core/release.d.ts +334 -0
- package/dist/lib/core/release.js +465 -0
- package/dist/lib/generators/memory-generator.d.ts +83 -0
- package/{lib → dist/lib}/generators/memory-generator.js +107 -178
- package/dist/lib/generators/nest-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/nest-generator.js +47 -71
- package/dist/lib/generators/readme-generator.d.ts +15 -0
- package/{lib → dist/lib}/generators/readme-generator.js +9 -14
- package/dist/lib/governance-report.d.ts +49 -0
- package/dist/lib/governance-report.js +170 -0
- package/dist/lib/templates/harness/code-intel.d.mts +2 -0
- package/dist/lib/templates/harness/code-intel.mjs +126 -0
- package/dist/lib/utils/file-helpers.d.ts +9 -0
- package/dist/lib/utils/file-helpers.js +34 -0
- package/dist/lib/validators/structure-validator.d.ts +48 -0
- package/dist/lib/validators/structure-validator.js +232 -0
- package/dist/lib/workspace.d.ts +40 -0
- package/dist/lib/workspace.js +174 -0
- package/dist/scripts/agent-harness.d.ts +2 -0
- package/dist/scripts/agent-harness.js +556 -0
- package/dist/scripts/agent-router.d.ts +30 -0
- package/dist/scripts/agent-router.js +208 -0
- package/dist/scripts/audit-query.d.ts +2 -0
- package/dist/scripts/audit-query.js +43 -0
- package/dist/scripts/audit-sync.d.ts +2 -0
- package/dist/scripts/audit-sync.js +19 -0
- package/dist/scripts/build-smart-context.d.ts +1 -0
- package/dist/scripts/build-smart-context.js +75 -0
- package/dist/scripts/check-standards.d.ts +1 -0
- package/dist/scripts/check-standards.js +87 -0
- package/dist/scripts/compress-memory.d.ts +16 -0
- package/dist/scripts/compress-memory.js +157 -0
- package/dist/scripts/compress-project-memory.d.ts +1 -0
- package/dist/scripts/compress-project-memory.js +48 -0
- package/dist/scripts/context-ops.d.ts +2 -0
- package/dist/scripts/context-ops.js +464 -0
- package/dist/scripts/dev.d.ts +96 -0
- package/dist/scripts/dev.js +312 -0
- package/dist/scripts/extract-global-knowledge.d.ts +1 -0
- package/dist/scripts/extract-global-knowledge.js +43 -0
- package/dist/scripts/generate-dashboard.d.ts +1 -0
- package/dist/scripts/generate-dashboard.js +48 -0
- package/dist/scripts/governance-dashboard.d.ts +2 -0
- package/dist/scripts/governance-dashboard.js +36 -0
- package/dist/scripts/hook-guard-paths.d.ts +17 -0
- package/dist/scripts/hook-guard-paths.js +68 -0
- package/dist/scripts/hook-post-edit.d.ts +20 -0
- package/dist/scripts/hook-post-edit.js +70 -0
- package/dist/scripts/hook-session-start.d.ts +17 -0
- package/dist/scripts/hook-session-start.js +108 -0
- package/dist/scripts/hook-user-prompt.d.ts +22 -0
- package/dist/scripts/hook-user-prompt.js +193 -0
- package/dist/scripts/memory-schema.d.ts +6 -0
- package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
- package/dist/scripts/query-universal-memory.d.ts +1 -0
- package/dist/scripts/query-universal-memory.js +44 -0
- package/dist/scripts/release-check.d.ts +14 -0
- package/dist/scripts/release-check.js +48 -0
- package/dist/scripts/spec-cli.d.ts +29 -0
- package/dist/scripts/spec-cli.js +261 -0
- package/dist/scripts/sprint-manager.d.ts +1 -0
- package/dist/scripts/sprint-manager.js +187 -0
- package/dist/scripts/sync-universal-memory.d.ts +1 -0
- package/dist/scripts/sync-universal-memory.js +277 -0
- package/dist/scripts/token-benchmark.d.ts +20 -0
- package/dist/scripts/token-benchmark.js +181 -0
- package/dist/scripts/tools-doctor.d.ts +20 -0
- package/dist/scripts/tools-doctor.js +120 -0
- package/memory/90-decisions/0028-governanca-visivel.md +84 -0
- package/package.json +54 -56
- package/specs/governanca-visivel/plan.md +122 -0
- package/specs/governanca-visivel/spec.md +112 -0
- package/specs/governanca-visivel/tasks.md +60 -0
- package/specs/ts-migration/plan.md +24 -13
- package/bin/create-memory-nest-kit.js +0 -125
- package/bin/forja.mjs +0 -143
- package/bin/init-project.js +0 -612
- package/lib/context-builder.js +0 -257
- package/lib/core/checks.mjs +0 -155
- package/lib/core/doc-graph.mjs +0 -231
- package/lib/core/health.mjs +0 -577
- package/lib/core/registry.mjs +0 -312
- package/lib/core/release.mjs +0 -492
- package/lib/templates/harness/code-intel.mjs +0 -119
- package/lib/templates/harness/mcp.json +0 -10
- package/lib/utils/file-helpers.js +0 -40
- package/lib/validators/structure-validator.js +0 -253
- package/lib/workspace.mjs +0 -213
- package/scripts/agent-harness.mjs +0 -580
- package/scripts/agent-router.mjs +0 -189
- package/scripts/build-smart-context.js +0 -87
- package/scripts/check-standards.js +0 -98
- package/scripts/compress-memory.mjs +0 -198
- package/scripts/compress-project-memory.js +0 -58
- package/scripts/context-ops.mjs +0 -466
- package/scripts/dev.mjs +0 -349
- package/scripts/extract-global-knowledge.js +0 -52
- package/scripts/generate-dashboard.js +0 -59
- package/scripts/hook-guard-paths.mjs +0 -76
- package/scripts/hook-post-edit.mjs +0 -79
- package/scripts/hook-session-start.mjs +0 -104
- package/scripts/hook-user-prompt.mjs +0 -185
- package/scripts/pre-commit.sh +0 -102
- package/scripts/query-universal-memory.js +0 -50
- package/scripts/release-check.mjs +0 -56
- package/scripts/spec-cli.mjs +0 -261
- package/scripts/sprint-manager.js +0 -200
- package/scripts/sync-universal-memory.js +0 -286
- package/scripts/token-benchmark.mjs +0 -203
- package/scripts/tools-doctor.mjs +0 -132
package/.claude/settings.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"hooks": [
|
|
7
7
|
{
|
|
8
8
|
"type": "command",
|
|
9
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.
|
|
9
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.ts",
|
|
10
10
|
"timeout": 5000
|
|
11
11
|
}
|
|
12
12
|
]
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"hooks": [
|
|
18
18
|
{
|
|
19
19
|
"type": "command",
|
|
20
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.
|
|
20
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-user-prompt.ts",
|
|
21
21
|
"timeout": 3000
|
|
22
22
|
}
|
|
23
23
|
]
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"hooks": [
|
|
30
30
|
{
|
|
31
31
|
"type": "command",
|
|
32
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-guard-paths.
|
|
32
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-guard-paths.ts",
|
|
33
33
|
"timeout": 5000
|
|
34
34
|
}
|
|
35
35
|
]
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"hooks": [
|
|
42
42
|
{
|
|
43
43
|
"type": "command",
|
|
44
|
-
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-post-edit.
|
|
44
|
+
"command": "node $CLAUDE_PROJECT_DIR/scripts/hook-post-edit.ts",
|
|
45
45
|
"timeout": 60000
|
|
46
46
|
}
|
|
47
47
|
]
|
|
@@ -50,9 +50,9 @@
|
|
|
50
50
|
},
|
|
51
51
|
"permissions": {
|
|
52
52
|
"allow": [
|
|
53
|
-
"Bash(node bin/forja.
|
|
54
|
-
"Bash(node scripts/spec-cli.
|
|
55
|
-
"Bash(node scripts/agent-router.
|
|
53
|
+
"Bash(node bin/forja.ts *)",
|
|
54
|
+
"Bash(node scripts/spec-cli.ts *)",
|
|
55
|
+
"Bash(node scripts/agent-router.ts *)",
|
|
56
56
|
"Bash(npm run spec:*)",
|
|
57
57
|
"Bash(npm run memory:*)",
|
|
58
58
|
"Bash(npm run sprint:*)",
|
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,31 @@ Histórico consolidado das mudanças estruturais do framework. Para decisões ar
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## [1.3.0] — 2026-07-19 — Governança visível e o núcleo em TypeScript
|
|
8
|
+
|
|
9
|
+
Duas frentes que amadurecem o framework: a governança sai do arquivo que ninguém abre para
|
|
10
|
+
**consultável e visível**, e o motor de invariantes (`lib/core/`) passa a ser **TypeScript de
|
|
11
|
+
verdade**, com o pacote publicando `dist/` compilado.
|
|
12
|
+
|
|
13
|
+
### Adicionado
|
|
14
|
+
- **Auditoria consultável + painel de governança** (SPEC-014, ADR-0028): `audit:sync` projeta o
|
|
15
|
+
`.context/forja-runs.jsonl` na tabela `audit_runs` (idempotente por `line_hash` — o `.jsonl` segue
|
|
16
|
+
sendo a fonte de verdade); `audit:query` filtra a trilha por `--failed`/`--cmd`/`--since`/`--gate`;
|
|
17
|
+
`governance:dashboard` gera um HTML **estático e self-contained** (sem servidor — a lição do
|
|
18
|
+
ADR-0022) com o estado de specs, ADRs, gates e métricas.
|
|
19
|
+
- **`lib/core/` em TypeScript** (SPEC-012 Fase 2, leaf-first): `checks`, `health`, `release`,
|
|
20
|
+
`doc-graph` e `registry` viram `.ts` com `interface Check/Probe/Result` reais. Dev roda `.ts`
|
|
21
|
+
nativo (Node ≥22.6); o publicado embarca `dist/*.js` (Node ≥20).
|
|
22
|
+
|
|
23
|
+
### Alterado
|
|
24
|
+
- **O pacote publica `dist/` compilado** (SPEC-012 Fase 3): `bin`/`files[]` apontam para `dist/`. O
|
|
25
|
+
`release:check` **builda o `dist/` antes de empacotar**, então o tarball provado é exatamente o
|
|
26
|
+
publicado — sem step de build no CI, sem `dist/` no git, sem janela de staleness.
|
|
27
|
+
- **CI**: o job `test` roda em Node 22.x/24.x (a fonte `.ts` exige strip-types ≥22.6). O suporte a
|
|
28
|
+
Node 20 do pacote publicado (que é `dist/*.js`) segue provado pelo job `release-gate`.
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
7
32
|
## [1.2.0] — 2026-07-18 — Boilerplate Clean Architecture, coerência de doc e correções
|
|
8
33
|
|
|
9
34
|
Feature nova (um boilerplate), o terceiro gate de invariante (coerência da documentação), e
|
package/README.en.md
CHANGED
|
@@ -203,6 +203,11 @@ forja project:check # framework standards (pre-commit)
|
|
|
203
203
|
forja tools:doctor # core X-ray; exit 1 if broken
|
|
204
204
|
forja release:check --publish # tarball gate before publishing
|
|
205
205
|
forja project:dashboard # static status report
|
|
206
|
+
|
|
207
|
+
# Governance & audit
|
|
208
|
+
forja audit:sync # project the audit trail into a queryable table
|
|
209
|
+
forja audit:query --failed # query: --failed, --cmd <x>, --since 7d
|
|
210
|
+
forja governance:dashboard # static HTML panel (gates, SDD, audit) — no server
|
|
206
211
|
```
|
|
207
212
|
|
|
208
213
|
## Framework vs workspace separation
|
package/README.md
CHANGED
|
@@ -193,6 +193,11 @@ forja project:check # standards do framework (pre-commit)
|
|
|
193
193
|
forja tools:doctor # raio-x do núcleo; exit 1 se quebrou
|
|
194
194
|
forja release:check --publish # gate do tarball antes de publicar
|
|
195
195
|
forja project:dashboard # relatório estático de status
|
|
196
|
+
|
|
197
|
+
# Governança & auditoria
|
|
198
|
+
forja audit:sync # projeta a trilha de auditoria numa tabela consultável
|
|
199
|
+
forja audit:query --failed # consulta: --failed, --cmd <x>, --since 7d
|
|
200
|
+
forja governance:dashboard # painel HTML estático (gates, SDD, auditoria) — sem servidor
|
|
196
201
|
```
|
|
197
202
|
|
|
198
203
|
## Separação framework × workspace
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* create-memory-nest-kit v0.6.0
|
|
4
|
+
* Orquestrador de geração de projetos com memória hierárquica
|
|
5
|
+
*
|
|
6
|
+
* Refatoração modular:
|
|
7
|
+
* - lib/generators/memory-generator.js
|
|
8
|
+
* - lib/generators/nest-generator.js
|
|
9
|
+
* - lib/generators/readme-generator.js
|
|
10
|
+
* - lib/validators/structure-validator.js
|
|
11
|
+
* - lib/utils/file-helpers.js
|
|
12
|
+
*/
|
|
13
|
+
import path from 'node:path';
|
|
14
|
+
import process from 'node:process';
|
|
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';
|
|
21
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
22
|
+
const __dirname = path.dirname(__filename);
|
|
23
|
+
// Parse arguments
|
|
24
|
+
const args = process.argv.slice(2);
|
|
25
|
+
const showHelp = args.includes('--help') || args.includes('-h');
|
|
26
|
+
if (showHelp) {
|
|
27
|
+
console.log(`
|
|
28
|
+
create-memory-nest-kit v0.6.0
|
|
29
|
+
|
|
30
|
+
Uso:
|
|
31
|
+
create-memory-nest-kit [diretorio] [opcoes]
|
|
32
|
+
|
|
33
|
+
Opcoes:
|
|
34
|
+
--force Sobrescreve arquivos existentes
|
|
35
|
+
--only-memory Gera apenas estrutura de memoria/agents/skills
|
|
36
|
+
--no-gitkeep Nao cria .gitkeep em diretorios vazios
|
|
37
|
+
--no-validate Pula validacao apos geracao
|
|
38
|
+
-h, --help Mostra esta ajuda
|
|
39
|
+
|
|
40
|
+
Exemplos:
|
|
41
|
+
node bin/create-memory-nest-kit.js meu-projeto
|
|
42
|
+
node bin/create-memory-nest-kit.js meu-projeto --force
|
|
43
|
+
node bin/create-memory-nest-kit.js meu-projeto --only-memory
|
|
44
|
+
`);
|
|
45
|
+
process.exit(0);
|
|
46
|
+
}
|
|
47
|
+
const options = {
|
|
48
|
+
force: args.includes('--force'),
|
|
49
|
+
noGitkeep: args.includes('--no-gitkeep'),
|
|
50
|
+
onlyMemory: args.includes('--only-memory'),
|
|
51
|
+
noValidate: args.includes('--no-validate'),
|
|
52
|
+
};
|
|
53
|
+
const rawTarget = args.find((a) => !a.startsWith('-')) || '.';
|
|
54
|
+
const targetDir = path.resolve(process.cwd(), rawTarget);
|
|
55
|
+
const projectName = path.basename(targetDir);
|
|
56
|
+
/**
|
|
57
|
+
* Orquestrador principal
|
|
58
|
+
*/
|
|
59
|
+
async function run() {
|
|
60
|
+
try {
|
|
61
|
+
console.log(`\n📦 create-memory-nest-kit v0.6.0`);
|
|
62
|
+
console.log(`📁 Projeto: ${projectName}`);
|
|
63
|
+
console.log(`📍 Diretório: ${targetDir}\n`);
|
|
64
|
+
// Passo 1: Garantir diretório
|
|
65
|
+
console.log('🔨 Criando estrutura de diretórios...');
|
|
66
|
+
ensureDir(targetDir);
|
|
67
|
+
// Passo 2: Gerar memória
|
|
68
|
+
console.log('📚 Gerando estrutura de memória...');
|
|
69
|
+
const memoryResult = generateMemoryStructure(targetDir, options);
|
|
70
|
+
console.log(` ✅ ${memoryResult.filesWritten} arquivos | ${memoryResult.emptyDirsCreated} diretórios`);
|
|
71
|
+
// Passo 3: Gerar NestJS (se não for --only-memory)
|
|
72
|
+
if (!options.onlyMemory) {
|
|
73
|
+
console.log('🎭 Gerando backend NestJS...');
|
|
74
|
+
const nestResult = generateNestStructure(targetDir, projectName, options);
|
|
75
|
+
console.log(` ✅ ${nestResult.filesWritten} arquivos | ${nestResult.emptyDirsCreated} diretórios`);
|
|
76
|
+
}
|
|
77
|
+
// Passo 4: Gerar README
|
|
78
|
+
console.log('📖 Gerando README.md...');
|
|
79
|
+
const readmeResult = generateReadme(targetDir, projectName, options);
|
|
80
|
+
console.log(` ✅ ${Math.round(readmeResult.size / 1024)}KB`);
|
|
81
|
+
// Passo 5: Validar (se não for --no-validate)
|
|
82
|
+
if (!options.noValidate) {
|
|
83
|
+
console.log('\n🔍 Validando estrutura...');
|
|
84
|
+
const validation = validateProjectStructure(targetDir, { includeNest: !options.onlyMemory });
|
|
85
|
+
printValidationReport(validation);
|
|
86
|
+
if (!validation.isValid) {
|
|
87
|
+
logError('Falhas detectadas na validação');
|
|
88
|
+
process.exit(1);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
// Sucesso!
|
|
92
|
+
logSuccess(`Estrutura v0.6.0 criada com sucesso`);
|
|
93
|
+
console.log(`\n➡️ Próximos passos:`);
|
|
94
|
+
console.log(` 1) cd ${path.relative(process.cwd(), targetDir) || '.'}`);
|
|
95
|
+
console.log(` 2) node scripts/build-context-pack.mjs`);
|
|
96
|
+
if (!options.onlyMemory) {
|
|
97
|
+
console.log(` 3) cd backend && npm install`);
|
|
98
|
+
console.log(` 4) npm run start:dev`);
|
|
99
|
+
}
|
|
100
|
+
console.log('');
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
logError(error.message);
|
|
104
|
+
if (process.env.DEBUG) {
|
|
105
|
+
console.error(error.stack);
|
|
106
|
+
}
|
|
107
|
+
process.exit(1);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
run();
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* bin/forja.mjs — core executivo do Forja (ADR-0020).
|
|
4
|
+
*
|
|
5
|
+
* Ponto de entrada único dos comandos de processo:
|
|
6
|
+
* forja <comando> [args]
|
|
7
|
+
*
|
|
8
|
+
* Responsabilidades transversais:
|
|
9
|
+
* 1. Roteamento via lib/core/registry.mjs (declarativo).
|
|
10
|
+
* 2. Gates antes do alvo (workspace, ADR-0019).
|
|
11
|
+
* 3. Trilha de auditoria append-only em .context/forja-runs.jsonl.
|
|
12
|
+
*/
|
|
13
|
+
export {};
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* bin/forja.mjs — core executivo do Forja (ADR-0020).
|
|
4
|
+
*
|
|
5
|
+
* Ponto de entrada único dos comandos de processo:
|
|
6
|
+
* forja <comando> [args]
|
|
7
|
+
*
|
|
8
|
+
* Responsabilidades transversais:
|
|
9
|
+
* 1. Roteamento via lib/core/registry.mjs (declarativo).
|
|
10
|
+
* 2. Gates antes do alvo (workspace, ADR-0019).
|
|
11
|
+
* 3. Trilha de auditoria append-only em .context/forja-runs.jsonl.
|
|
12
|
+
*/
|
|
13
|
+
import fs from 'node:fs';
|
|
14
|
+
import path from 'node:path';
|
|
15
|
+
import { spawnSync } from 'node:child_process';
|
|
16
|
+
import { fileURLToPath } from 'node:url';
|
|
17
|
+
import { COMMANDS, DOMAINS, resolveScript } from "../lib/core/registry.js";
|
|
18
|
+
import { getWorkspaceInfo, getWorkspaceContextDir } from "../lib/workspace.js";
|
|
19
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
20
|
+
const root = path.resolve(__dirname, '..');
|
|
21
|
+
function printHelp() {
|
|
22
|
+
console.log('Forja — core executivo (ADR-0020)');
|
|
23
|
+
console.log('Uso: forja <comando> [args]\n');
|
|
24
|
+
const byDomain = new Map();
|
|
25
|
+
for (const [name, cmd] of Object.entries(COMMANDS)) {
|
|
26
|
+
if (!byDomain.has(cmd.domain))
|
|
27
|
+
byDomain.set(cmd.domain, []);
|
|
28
|
+
byDomain.get(cmd.domain).push([name, cmd.desc]);
|
|
29
|
+
}
|
|
30
|
+
for (const [domain, label] of Object.entries(DOMAINS)) {
|
|
31
|
+
const entries = byDomain.get(domain);
|
|
32
|
+
if (!entries)
|
|
33
|
+
continue;
|
|
34
|
+
console.log(`${label}:`);
|
|
35
|
+
for (const [name, desc] of entries) {
|
|
36
|
+
console.log(` ${name.padEnd(24)} ${desc}`);
|
|
37
|
+
}
|
|
38
|
+
console.log('');
|
|
39
|
+
}
|
|
40
|
+
console.log('Toda execução é auditada em .context/forja-runs.jsonl (workspace, se existir).');
|
|
41
|
+
}
|
|
42
|
+
function suggest(input) {
|
|
43
|
+
const names = Object.keys(COMMANDS);
|
|
44
|
+
const prefix = input.split(':')[0];
|
|
45
|
+
const near = names.filter((n) => n.startsWith(prefix) || n.includes(input));
|
|
46
|
+
return near.slice(0, 5);
|
|
47
|
+
}
|
|
48
|
+
// Gates transversais (ADR-0020). Retorna lista de erros bloqueantes.
|
|
49
|
+
function runGates(cmd) {
|
|
50
|
+
const errors = [];
|
|
51
|
+
for (const gate of cmd.gates || []) {
|
|
52
|
+
if (gate === 'workspace' || gate === 'workspace-warn') {
|
|
53
|
+
const info = getWorkspaceInfo();
|
|
54
|
+
if (!info.exists) {
|
|
55
|
+
const msg = `Workspace não encontrado em ${info.root} (fonte: ${info.source}).`;
|
|
56
|
+
if (gate === 'workspace') {
|
|
57
|
+
errors.push(`${msg}\n Corrija com: forja workspace:init`);
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
console.error(`Aviso: ${msg} Alguns dados podem cair no repo do framework.`);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return errors;
|
|
66
|
+
}
|
|
67
|
+
// Auditoria nunca bloqueia o comando (NFR da SPEC-025).
|
|
68
|
+
function audit(entry) {
|
|
69
|
+
try {
|
|
70
|
+
const info = getWorkspaceInfo();
|
|
71
|
+
const dir = info.exists ? getWorkspaceContextDir() : path.join(root, '.context');
|
|
72
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
73
|
+
fs.appendFileSync(path.join(dir, 'forja-runs.jsonl'), JSON.stringify(entry) + '\n', 'utf8');
|
|
74
|
+
}
|
|
75
|
+
catch (error) {
|
|
76
|
+
console.error(`Aviso: auditoria indisponível (${error.message}).`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
const [name, ...rest] = process.argv.slice(2);
|
|
80
|
+
if (!name || name === 'help' || name === '--help' || name === '-h') {
|
|
81
|
+
printHelp();
|
|
82
|
+
process.exit(0);
|
|
83
|
+
}
|
|
84
|
+
const cmd = COMMANDS[name];
|
|
85
|
+
if (!cmd) {
|
|
86
|
+
console.error(`Comando desconhecido: ${name}`);
|
|
87
|
+
const near = suggest(name);
|
|
88
|
+
if (near.length) {
|
|
89
|
+
console.error(`Você quis dizer: ${near.join(', ')}?`);
|
|
90
|
+
}
|
|
91
|
+
console.error('Liste tudo com: forja help');
|
|
92
|
+
process.exit(1);
|
|
93
|
+
}
|
|
94
|
+
const gateErrors = runGates(cmd);
|
|
95
|
+
if (gateErrors.length) {
|
|
96
|
+
console.error(`Gate reprovado para ${name}:`);
|
|
97
|
+
for (const err of gateErrors)
|
|
98
|
+
console.error(`- ${err}`);
|
|
99
|
+
audit({
|
|
100
|
+
ts: new Date().toISOString(),
|
|
101
|
+
cmd: name,
|
|
102
|
+
args: rest,
|
|
103
|
+
exitCode: 1,
|
|
104
|
+
durationMs: 0,
|
|
105
|
+
gate: 'blocked',
|
|
106
|
+
});
|
|
107
|
+
process.exit(1);
|
|
108
|
+
}
|
|
109
|
+
const started = Date.now();
|
|
110
|
+
let result;
|
|
111
|
+
if (cmd.node) {
|
|
112
|
+
const script = resolveScript(root, cmd.node);
|
|
113
|
+
result = spawnSync('node', [script, ...(cmd.args || []), ...rest], {
|
|
114
|
+
cwd: root,
|
|
115
|
+
stdio: 'inherit',
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
else {
|
|
119
|
+
result = spawnSync(cmd.bin, [...(cmd.args || []), ...rest], {
|
|
120
|
+
cwd: root,
|
|
121
|
+
stdio: 'inherit',
|
|
122
|
+
});
|
|
123
|
+
if (result.error && /** @type {any} */ (result.error).code === 'ENOENT') {
|
|
124
|
+
console.error(`Binário não encontrado no PATH: ${cmd.bin}. Veja: forja tools:doctor`);
|
|
125
|
+
result.status = 127;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
const exitCode = result.status ?? 1;
|
|
129
|
+
audit({
|
|
130
|
+
ts: new Date().toISOString(),
|
|
131
|
+
cmd: name,
|
|
132
|
+
args: rest,
|
|
133
|
+
exitCode,
|
|
134
|
+
durationMs: Date.now() - started,
|
|
135
|
+
});
|
|
136
|
+
process.exit(exitCode);
|