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.
Files changed (132) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +25 -0
  3. package/README.en.md +5 -0
  4. package/README.md +5 -0
  5. package/dist/bin/create-memory-nest-kit.d.ts +2 -0
  6. package/dist/bin/create-memory-nest-kit.js +110 -0
  7. package/dist/bin/forja.d.ts +13 -0
  8. package/dist/bin/forja.js +136 -0
  9. package/dist/bin/init-project.d.ts +2 -0
  10. package/dist/bin/init-project.js +516 -0
  11. package/dist/lib/audit.d.ts +67 -0
  12. package/dist/lib/audit.js +143 -0
  13. package/dist/lib/context-builder.d.ts +58 -0
  14. package/dist/lib/context-builder.js +233 -0
  15. package/dist/lib/core/checks.d.ts +91 -0
  16. package/dist/lib/core/checks.js +119 -0
  17. package/dist/lib/core/doc-graph.d.ts +60 -0
  18. package/dist/lib/core/doc-graph.js +235 -0
  19. package/dist/lib/core/health.d.ts +103 -0
  20. package/dist/lib/core/health.js +538 -0
  21. package/dist/lib/core/registry.d.ts +296 -0
  22. package/dist/lib/core/registry.js +317 -0
  23. package/dist/lib/core/release.d.ts +334 -0
  24. package/dist/lib/core/release.js +465 -0
  25. package/dist/lib/generators/memory-generator.d.ts +83 -0
  26. package/{lib → dist/lib}/generators/memory-generator.js +107 -178
  27. package/dist/lib/generators/nest-generator.d.ts +15 -0
  28. package/{lib → dist/lib}/generators/nest-generator.js +47 -71
  29. package/dist/lib/generators/readme-generator.d.ts +15 -0
  30. package/{lib → dist/lib}/generators/readme-generator.js +9 -14
  31. package/dist/lib/governance-report.d.ts +49 -0
  32. package/dist/lib/governance-report.js +170 -0
  33. package/dist/lib/templates/harness/code-intel.d.mts +2 -0
  34. package/dist/lib/templates/harness/code-intel.mjs +126 -0
  35. package/dist/lib/utils/file-helpers.d.ts +9 -0
  36. package/dist/lib/utils/file-helpers.js +34 -0
  37. package/dist/lib/validators/structure-validator.d.ts +48 -0
  38. package/dist/lib/validators/structure-validator.js +232 -0
  39. package/dist/lib/workspace.d.ts +40 -0
  40. package/dist/lib/workspace.js +174 -0
  41. package/dist/scripts/agent-harness.d.ts +2 -0
  42. package/dist/scripts/agent-harness.js +556 -0
  43. package/dist/scripts/agent-router.d.ts +30 -0
  44. package/dist/scripts/agent-router.js +208 -0
  45. package/dist/scripts/audit-query.d.ts +2 -0
  46. package/dist/scripts/audit-query.js +43 -0
  47. package/dist/scripts/audit-sync.d.ts +2 -0
  48. package/dist/scripts/audit-sync.js +19 -0
  49. package/dist/scripts/build-smart-context.d.ts +1 -0
  50. package/dist/scripts/build-smart-context.js +75 -0
  51. package/dist/scripts/check-standards.d.ts +1 -0
  52. package/dist/scripts/check-standards.js +87 -0
  53. package/dist/scripts/compress-memory.d.ts +16 -0
  54. package/dist/scripts/compress-memory.js +157 -0
  55. package/dist/scripts/compress-project-memory.d.ts +1 -0
  56. package/dist/scripts/compress-project-memory.js +48 -0
  57. package/dist/scripts/context-ops.d.ts +2 -0
  58. package/dist/scripts/context-ops.js +464 -0
  59. package/dist/scripts/dev.d.ts +96 -0
  60. package/dist/scripts/dev.js +312 -0
  61. package/dist/scripts/extract-global-knowledge.d.ts +1 -0
  62. package/dist/scripts/extract-global-knowledge.js +43 -0
  63. package/dist/scripts/generate-dashboard.d.ts +1 -0
  64. package/dist/scripts/generate-dashboard.js +48 -0
  65. package/dist/scripts/governance-dashboard.d.ts +2 -0
  66. package/dist/scripts/governance-dashboard.js +36 -0
  67. package/dist/scripts/hook-guard-paths.d.ts +17 -0
  68. package/dist/scripts/hook-guard-paths.js +68 -0
  69. package/dist/scripts/hook-post-edit.d.ts +20 -0
  70. package/dist/scripts/hook-post-edit.js +70 -0
  71. package/dist/scripts/hook-session-start.d.ts +17 -0
  72. package/dist/scripts/hook-session-start.js +108 -0
  73. package/dist/scripts/hook-user-prompt.d.ts +22 -0
  74. package/dist/scripts/hook-user-prompt.js +193 -0
  75. package/dist/scripts/memory-schema.d.ts +6 -0
  76. package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
  77. package/dist/scripts/query-universal-memory.d.ts +1 -0
  78. package/dist/scripts/query-universal-memory.js +44 -0
  79. package/dist/scripts/release-check.d.ts +14 -0
  80. package/dist/scripts/release-check.js +48 -0
  81. package/dist/scripts/spec-cli.d.ts +29 -0
  82. package/dist/scripts/spec-cli.js +261 -0
  83. package/dist/scripts/sprint-manager.d.ts +1 -0
  84. package/dist/scripts/sprint-manager.js +187 -0
  85. package/dist/scripts/sync-universal-memory.d.ts +1 -0
  86. package/dist/scripts/sync-universal-memory.js +277 -0
  87. package/dist/scripts/token-benchmark.d.ts +20 -0
  88. package/dist/scripts/token-benchmark.js +181 -0
  89. package/dist/scripts/tools-doctor.d.ts +20 -0
  90. package/dist/scripts/tools-doctor.js +120 -0
  91. package/memory/90-decisions/0028-governanca-visivel.md +84 -0
  92. package/package.json +54 -56
  93. package/specs/governanca-visivel/plan.md +122 -0
  94. package/specs/governanca-visivel/spec.md +112 -0
  95. package/specs/governanca-visivel/tasks.md +60 -0
  96. package/specs/ts-migration/plan.md +24 -13
  97. package/bin/create-memory-nest-kit.js +0 -125
  98. package/bin/forja.mjs +0 -143
  99. package/bin/init-project.js +0 -612
  100. package/lib/context-builder.js +0 -257
  101. package/lib/core/checks.mjs +0 -155
  102. package/lib/core/doc-graph.mjs +0 -231
  103. package/lib/core/health.mjs +0 -577
  104. package/lib/core/registry.mjs +0 -312
  105. package/lib/core/release.mjs +0 -492
  106. package/lib/templates/harness/code-intel.mjs +0 -119
  107. package/lib/templates/harness/mcp.json +0 -10
  108. package/lib/utils/file-helpers.js +0 -40
  109. package/lib/validators/structure-validator.js +0 -253
  110. package/lib/workspace.mjs +0 -213
  111. package/scripts/agent-harness.mjs +0 -580
  112. package/scripts/agent-router.mjs +0 -189
  113. package/scripts/build-smart-context.js +0 -87
  114. package/scripts/check-standards.js +0 -98
  115. package/scripts/compress-memory.mjs +0 -198
  116. package/scripts/compress-project-memory.js +0 -58
  117. package/scripts/context-ops.mjs +0 -466
  118. package/scripts/dev.mjs +0 -349
  119. package/scripts/extract-global-knowledge.js +0 -52
  120. package/scripts/generate-dashboard.js +0 -59
  121. package/scripts/hook-guard-paths.mjs +0 -76
  122. package/scripts/hook-post-edit.mjs +0 -79
  123. package/scripts/hook-session-start.mjs +0 -104
  124. package/scripts/hook-user-prompt.mjs +0 -185
  125. package/scripts/pre-commit.sh +0 -102
  126. package/scripts/query-universal-memory.js +0 -50
  127. package/scripts/release-check.mjs +0 -56
  128. package/scripts/spec-cli.mjs +0 -261
  129. package/scripts/sprint-manager.js +0 -200
  130. package/scripts/sync-universal-memory.js +0 -286
  131. package/scripts/token-benchmark.mjs +0 -203
  132. package/scripts/tools-doctor.mjs +0 -132
@@ -6,7 +6,7 @@
6
6
  "hooks": [
7
7
  {
8
8
  "type": "command",
9
- "command": "node $CLAUDE_PROJECT_DIR/scripts/hook-session-start.mjs",
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.mjs",
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.mjs",
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.mjs",
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.mjs *)",
54
- "Bash(node scripts/spec-cli.mjs *)",
55
- "Bash(node scripts/agent-router.mjs *)",
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,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -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);
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};