forjajs 1.1.6 → 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 +62 -0
- package/README.en.md +33 -5
- package/README.md +35 -4
- package/boilerplates/06-clean-arch/README.md +48 -0
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
- package/boilerplates/06-clean-arch/backend/package.json +43 -0
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
- package/boilerplates/README.md +20 -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/docs/personas/architect/README.md +4 -4
- package/docs/personas/developer/README.md +3 -3
- package/docs/personas/qa/README.md +3 -3
- package/docs/quick-reference.md +9 -9
- package/docs/structure.md +3 -3
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
- package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
- package/memory/90-decisions/0028-governanca-visivel.md +84 -0
- package/package.json +60 -56
- package/specs/clean-arch-boilerplate/plan.md +137 -0
- package/specs/clean-arch-boilerplate/spec.md +121 -0
- package/specs/clean-arch-boilerplate/tasks.md +70 -0
- package/specs/coerencia-do-sistema/plan.md +155 -0
- package/specs/coerencia-do-sistema/spec.md +15 -14
- package/specs/coerencia-do-sistema/tasks.md +115 -0
- 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 +199 -0
- package/specs/ts-migration/spec.md +119 -0
- package/specs/ts-migration/tasks.md +110 -0
- 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 -138
- package/lib/core/health.mjs +0 -475
- package/lib/core/registry.mjs +0 -289
- package/lib/core/release.mjs +0 -452
- 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 -578
- 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 -463
- 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 -75
- 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 -260
- 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/lib/core/release.mjs
DELETED
|
@@ -1,452 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* lib/core/release.mjs — o gate do tarball.
|
|
3
|
-
*
|
|
4
|
-
* Guarda a fronteira que `health.mjs` não vê: **o repositório mente sobre o pacote**. No repo tudo
|
|
5
|
-
* resolve — `node_modules` tem as devDeps, todo arquivo está presente, o `cwd` é a raiz. Nada disso
|
|
6
|
-
* vale para quem roda `npm i -g forjajs`. Essa fronteira já cedeu três vezes (SPEC-010):
|
|
7
|
-
*
|
|
8
|
-
* ADR-0021 `better-sqlite3` como devDependency → dez comandos com ERR_MODULE_NOT_FOUND na
|
|
9
|
-
* instalação limpa. O `forja` sem argumentos funcionava, o que mascarava a quebra.
|
|
10
|
-
* v1.1.1 `otplib` e `qrcode` publicados sem jamais existirem no git — `npm publish` empacota o
|
|
11
|
-
* disco, não o commit.
|
|
12
|
-
* v1.1.3 `docs/dashboard.md` e o script publicados sem a pasta `dashboard/`.
|
|
13
|
-
*
|
|
14
|
-
* O princípio que organiza tudo aqui: **grep não prova ausência; instalação prova.** Por isso o
|
|
15
|
-
* gate empacota e instala de verdade, e por isso ele é lento — e tudo bem ser lento, porque roda
|
|
16
|
-
* antes de publicar, não a cada commit.
|
|
17
|
-
*
|
|
18
|
-
* O runner é o de `checks.mjs`, o mesmo do doctor. Uma máquina, duas fronteiras.
|
|
19
|
-
*/
|
|
20
|
-
|
|
21
|
-
import { execFileSync } from 'node:child_process';
|
|
22
|
-
import fs from 'node:fs';
|
|
23
|
-
import os from 'node:os';
|
|
24
|
-
import path from 'node:path';
|
|
25
|
-
import { fileURLToPath } from 'node:url';
|
|
26
|
-
|
|
27
|
-
import { runChecks as run, worstStatus, stripTemplateLiterals } from './checks.mjs';
|
|
28
|
-
import { COMMANDS } from './registry.mjs';
|
|
29
|
-
|
|
30
|
-
export { worstStatus };
|
|
31
|
-
|
|
32
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
33
|
-
const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
|
|
34
|
-
|
|
35
|
-
/** Assinaturas de tarball quebrado. Exit code não serve — ver `smokeCommands`. */
|
|
36
|
-
const LOADER_ERRORS = /ERR_MODULE_NOT_FOUND|ERR_DLOPEN_FAILED|Cannot find module|ERR_PACKAGE_PATH_NOT_EXPORTED/;
|
|
37
|
-
|
|
38
|
-
function git(args, cwd = repoRoot) {
|
|
39
|
-
return execFileSync('git', args, { cwd, encoding: 'utf8' });
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
/**
|
|
43
|
-
* Empacota o repo e instala o tarball num diretório temporário isolado.
|
|
44
|
-
*
|
|
45
|
-
* Isolamento importa: um gate que enxerga o `node_modules` do repo mente verde. É justamente o
|
|
46
|
-
* `NODE_PATH` herdado e o `node_modules` vizinho que fariam um `import` quebrado resolver mesmo
|
|
47
|
-
* assim — e a quebra só apareceria na máquina do usuário.
|
|
48
|
-
*
|
|
49
|
-
* Limpa o temporário **sempre**, inclusive quando o callback lança.
|
|
50
|
-
*
|
|
51
|
-
* @param {(ctx: { pkgDir: string, installDir: string }) => Promise<T>|T} fn
|
|
52
|
-
* @returns {Promise<T>}
|
|
53
|
-
*/
|
|
54
|
-
export async function withCleanInstall(fn, { root = repoRoot } = {}) {
|
|
55
|
-
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'forja-release-'));
|
|
56
|
-
|
|
57
|
-
// Isolamento de verdade — e ele vaza por onde não se espera.
|
|
58
|
-
//
|
|
59
|
-
// `NODE_PATH` é o óbvio. O traiçoeiro é o `npm_config_*`: quando o gate roda de dentro de um
|
|
60
|
-
// script npm (e o `prepublishOnly` é exatamente isso), o npm injeta dezenas dessas variáveis no
|
|
61
|
-
// ambiente. Elas carregam o `local_prefix` do repo e, sob `npm publish --dry-run`, um
|
|
62
|
-
// `npm_config_dry_run=true` que faz o `npm install` interno não instalar nada.
|
|
63
|
-
//
|
|
64
|
-
// Sem esta limpeza, o gate passa localmente e quebra justamente no `prepublishOnly` — o único
|
|
65
|
-
// lugar onde ele precisa funcionar.
|
|
66
|
-
const env = { ...process.env };
|
|
67
|
-
delete env.NODE_PATH;
|
|
68
|
-
for (const key of Object.keys(env)) {
|
|
69
|
-
if (key.startsWith('npm_')) delete env[key];
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
const npm = (args, cwd) => {
|
|
73
|
-
try {
|
|
74
|
-
return execFileSync('npm', args, { cwd, encoding: 'utf8', env, stdio: 'pipe' });
|
|
75
|
-
} catch (err) {
|
|
76
|
-
// Engolir o stderr aqui cega o diagnóstico exatamente quando ele importa.
|
|
77
|
-
const saida = `${err.stdout || ''}${err.stderr || ''}`.trim();
|
|
78
|
-
throw new Error(`npm ${args[0]} falhou em ${cwd}:\n${saida || err.message}`);
|
|
79
|
-
}
|
|
80
|
-
};
|
|
81
|
-
|
|
82
|
-
try {
|
|
83
|
-
const tgz = npm(['pack', '--silent', '--pack-destination', dir], root)
|
|
84
|
-
.trim()
|
|
85
|
-
.split('\n')
|
|
86
|
-
.pop();
|
|
87
|
-
|
|
88
|
-
npm(['init', '-y'], dir);
|
|
89
|
-
npm(['install', path.join(dir, tgz)], dir);
|
|
90
|
-
|
|
91
|
-
const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
|
|
92
|
-
const pkgDir = path.join(dir, 'node_modules', pkg.name);
|
|
93
|
-
|
|
94
|
-
return await fn({ pkgDir, installDir: dir });
|
|
95
|
-
} finally {
|
|
96
|
-
fs.rmSync(dir, { recursive: true, force: true });
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
// ---------------------------------------------------------------------------
|
|
101
|
-
// Checks
|
|
102
|
-
// ---------------------------------------------------------------------------
|
|
103
|
-
|
|
104
|
-
/**
|
|
105
|
-
* A falha da v1.1.1, e a única que nenhuma instalação pega: `npm publish` empacota o **disco**, não
|
|
106
|
-
* o commit. Um `npm install` casual entre a auditoria e o publish reescreve o `package.json`, e foi
|
|
107
|
-
* assim que `otplib` e `qrcode` chegaram ao npm sem jamais existirem no git.
|
|
108
|
-
*
|
|
109
|
-
* Severidade depende do modo: sob `--publish` é fatal; em dev é aviso — um gate que reprova todo
|
|
110
|
-
* desenvolvimento local é um gate que se contorna (a lição que o CI nos deu na SPEC-009).
|
|
111
|
-
*/
|
|
112
|
-
const treeClean = {
|
|
113
|
-
id: 'tree-clean',
|
|
114
|
-
title: 'árvore limpa (o tarball é o commit)',
|
|
115
|
-
severity: 'critical',
|
|
116
|
-
probe(env) {
|
|
117
|
-
let dirty;
|
|
118
|
-
try {
|
|
119
|
-
dirty = git(['status', '--short'], env.root).trim();
|
|
120
|
-
} catch {
|
|
121
|
-
return { status: 'skipped', detail: 'fora de um repositório git', fix: null };
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
if (!dirty) return { status: 'ok', detail: 'nada não commitado', fix: null };
|
|
125
|
-
|
|
126
|
-
const n = dirty.split('\n').length;
|
|
127
|
-
const detalhe = `${n} arquivo(s) não commitado(s) — o tarball não corresponde a nenhum commit`;
|
|
128
|
-
|
|
129
|
-
return env.publish
|
|
130
|
-
? { status: 'fail', detail: `${detalhe}. npm publish empacota o disco, não o commit`, fix: 'git commit' }
|
|
131
|
-
: { status: 'warn', detail: `${detalhe}. Ok para smoke; não para publicar`, fix: null };
|
|
132
|
-
},
|
|
133
|
-
};
|
|
134
|
-
|
|
135
|
-
/** Se o pacote não instala, todo o resto é irrelevante — daí todos dependerem deste. */
|
|
136
|
-
const install = {
|
|
137
|
-
id: 'install',
|
|
138
|
-
title: 'o pacote instala do zero',
|
|
139
|
-
severity: 'critical',
|
|
140
|
-
probe(env) {
|
|
141
|
-
return env.pkgDir && env.fs.existsSync(env.pkgDir)
|
|
142
|
-
? { status: 'ok', detail: `instalado em ${path.basename(env.installDir)}`, fix: null }
|
|
143
|
-
: { status: 'fail', detail: 'o tarball não instalou', fix: 'npm pack && npm i <tgz> — investigue o erro' };
|
|
144
|
-
},
|
|
145
|
-
};
|
|
146
|
-
|
|
147
|
-
/**
|
|
148
|
-
* Todo comando anunciado pelo registry precisa existir no tarball. É o bug da v1.1.3, generalizado:
|
|
149
|
-
* `npm run dashboard` era publicado, a pasta `dashboard/` não.
|
|
150
|
-
*/
|
|
151
|
-
const registryScripts = {
|
|
152
|
-
id: 'registry-scripts',
|
|
153
|
-
title: 'todo comando do registry existe no tarball',
|
|
154
|
-
severity: 'critical',
|
|
155
|
-
dependsOn: 'install',
|
|
156
|
-
probe(env) {
|
|
157
|
-
const faltando = [];
|
|
158
|
-
let total = 0;
|
|
159
|
-
|
|
160
|
-
for (const [name, def] of Object.entries(env.registry)) {
|
|
161
|
-
const rel = def.node || def.script;
|
|
162
|
-
if (!rel) continue;
|
|
163
|
-
total += 1;
|
|
164
|
-
if (!env.fs.existsSync(path.join(env.pkgDir, rel))) faltando.push(`${name} → ${rel}`);
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
if (faltando.length) {
|
|
168
|
-
return {
|
|
169
|
-
status: 'fail',
|
|
170
|
-
detail: `${faltando.length} comando(s) sem script no tarball: ${faltando.join(', ')}`,
|
|
171
|
-
fix: 'adicione o path ao files[] do package.json',
|
|
172
|
-
};
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
return { status: 'ok', detail: `${total}/${total} comandos com script presente`, fix: null };
|
|
176
|
-
},
|
|
177
|
-
};
|
|
178
|
-
|
|
179
|
-
/**
|
|
180
|
-
* O **código executável** do pacote — `bin/`, `lib/`, `scripts/`. Nada mais.
|
|
181
|
-
*
|
|
182
|
-
* `boilerplates/` também é publicado e também é `.js`, mas é **conteúdo**: templates copiados para
|
|
183
|
-
* o projeto gerado. O `next.config.js` de um boilerplate importa `next` — que é dependência do
|
|
184
|
-
* projeto do usuário, não do Forja. Varrer essas pastas faz o gate exigir `npm i -S next` no
|
|
185
|
-
* framework, o que é absurdo (observado na primeira execução real do gate).
|
|
186
|
-
*
|
|
187
|
-
* Mesmo princípio de `stripTemplateLiterals`, um nível acima: o que o Forja *escreve* não é o que
|
|
188
|
-
* o Forja *executa*.
|
|
189
|
-
*/
|
|
190
|
-
const CODE_DIRS = ['bin', 'lib', 'scripts'];
|
|
191
|
-
|
|
192
|
-
function publishedSources(env) {
|
|
193
|
-
const out = [];
|
|
194
|
-
|
|
195
|
-
for (const dir of CODE_DIRS) {
|
|
196
|
-
const full = path.join(env.pkgDir, dir);
|
|
197
|
-
if (env.fs.existsSync(full)) walkDir(env, full, out);
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
return out;
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
function walkDir(env, dir, out) {
|
|
204
|
-
let entries;
|
|
205
|
-
try {
|
|
206
|
-
entries = env.fs.readdirSync(dir);
|
|
207
|
-
} catch {
|
|
208
|
-
return;
|
|
209
|
-
}
|
|
210
|
-
for (const entry of entries) {
|
|
211
|
-
const p = path.join(dir, entry);
|
|
212
|
-
let st;
|
|
213
|
-
try {
|
|
214
|
-
st = env.fs.statSync(p);
|
|
215
|
-
} catch {
|
|
216
|
-
continue;
|
|
217
|
-
}
|
|
218
|
-
if (st.isDirectory()) {
|
|
219
|
-
if (entry !== 'node_modules') walkDir(env, p, out);
|
|
220
|
-
} else if (/\.(mjs|js)$/.test(entry)) {
|
|
221
|
-
out.push(p);
|
|
222
|
-
}
|
|
223
|
-
}
|
|
224
|
-
}
|
|
225
|
-
|
|
226
|
-
const IMPORT_RE = /(?:^|\s)(?:import|export)[^'"]*?from\s*['"]([^'"]+)['"]|(?:^|\s)import\s*['"]([^'"]+)['"]/gm;
|
|
227
|
-
|
|
228
|
-
function importsOf(env, file) {
|
|
229
|
-
const src = stripTemplateLiterals(env.fs.readFileSync(file, 'utf8'));
|
|
230
|
-
const out = [];
|
|
231
|
-
for (const m of src.matchAll(IMPORT_RE)) out.push(m[1] || m[2]);
|
|
232
|
-
return out;
|
|
233
|
-
}
|
|
234
|
-
|
|
235
|
-
/** Pacote npm (não builtin, não relativo). `@scope/x/sub` → `@scope/x`. */
|
|
236
|
-
function packageName(specifier) {
|
|
237
|
-
if (!specifier || specifier.startsWith('.') || specifier.startsWith('/')) return null;
|
|
238
|
-
if (specifier.startsWith('node:')) return null;
|
|
239
|
-
const parts = specifier.split('/');
|
|
240
|
-
return specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0];
|
|
241
|
-
}
|
|
242
|
-
|
|
243
|
-
/** Import relativo que não resolve dentro do tarball = arquivo fora do `files[]` (bug da v1.1.3). */
|
|
244
|
-
const importsResolve = {
|
|
245
|
-
id: 'imports-resolve',
|
|
246
|
-
title: 'imports relativos resolvem dentro do tarball',
|
|
247
|
-
severity: 'critical',
|
|
248
|
-
dependsOn: 'install',
|
|
249
|
-
probe(env) {
|
|
250
|
-
const quebrados = [];
|
|
251
|
-
|
|
252
|
-
for (const file of publishedSources(env)) {
|
|
253
|
-
for (const spec of importsOf(env, file)) {
|
|
254
|
-
if (!spec?.startsWith('.')) continue;
|
|
255
|
-
const alvo = path.resolve(path.dirname(file), spec);
|
|
256
|
-
const existe = env.fs.existsSync(alvo)
|
|
257
|
-
|| ['.js', '.mjs', '.json'].some((ext) => env.fs.existsSync(alvo + ext));
|
|
258
|
-
if (!existe) quebrados.push(`${path.relative(env.pkgDir, file)} → ${spec}`);
|
|
259
|
-
}
|
|
260
|
-
}
|
|
261
|
-
|
|
262
|
-
if (quebrados.length) {
|
|
263
|
-
return {
|
|
264
|
-
status: 'fail',
|
|
265
|
-
detail: `${quebrados.length} import(s) sem destino no tarball: ${quebrados.slice(0, 3).join('; ')}`,
|
|
266
|
-
fix: 'adicione o arquivo ao files[] do package.json',
|
|
267
|
-
};
|
|
268
|
-
}
|
|
269
|
-
|
|
270
|
-
return { status: 'ok', detail: 'todo import relativo resolve', fix: null };
|
|
271
|
-
},
|
|
272
|
-
};
|
|
273
|
-
|
|
274
|
-
/** O bug do ADR-0021 §2: importado por script publicado, mas declarado como devDependency. */
|
|
275
|
-
const depsDeclared = {
|
|
276
|
-
id: 'deps-declared',
|
|
277
|
-
title: 'todo import externo está em dependencies',
|
|
278
|
-
severity: 'critical',
|
|
279
|
-
dependsOn: 'install',
|
|
280
|
-
probe(env) {
|
|
281
|
-
const pkg = JSON.parse(env.fs.readFileSync(path.join(env.pkgDir, 'package.json'), 'utf8'));
|
|
282
|
-
const deps = new Set(Object.keys(pkg.dependencies || {}));
|
|
283
|
-
const faltando = new Map();
|
|
284
|
-
|
|
285
|
-
for (const file of publishedSources(env)) {
|
|
286
|
-
for (const spec of importsOf(env, file)) {
|
|
287
|
-
const nome = packageName(spec);
|
|
288
|
-
if (!nome || deps.has(nome)) continue;
|
|
289
|
-
faltando.set(nome, path.relative(env.pkgDir, file));
|
|
290
|
-
}
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
if (faltando.size) {
|
|
294
|
-
const lista = [...faltando].map(([n, f]) => `${n} (${f})`).join(', ');
|
|
295
|
-
return {
|
|
296
|
-
status: 'fail',
|
|
297
|
-
detail: `importado pelo pacote mas não declarado em dependencies: ${lista}`,
|
|
298
|
-
fix: `npm i -S ${[...faltando.keys()].join(' ')}`,
|
|
299
|
-
};
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
return { status: 'ok', detail: `${deps.size} dependência(s), todas importadas por alguém`, fix: null };
|
|
303
|
-
},
|
|
304
|
-
};
|
|
305
|
-
|
|
306
|
-
/** Peso morto viaja no tarball de todo usuário. Incomoda; não quebra — por isso `warn` (D7). */
|
|
307
|
-
const depsUnused = {
|
|
308
|
-
id: 'deps-unused',
|
|
309
|
-
title: 'nenhuma dependency é peso morto',
|
|
310
|
-
severity: 'warn',
|
|
311
|
-
dependsOn: 'install',
|
|
312
|
-
probe(env) {
|
|
313
|
-
const pkg = JSON.parse(env.fs.readFileSync(path.join(env.pkgDir, 'package.json'), 'utf8'));
|
|
314
|
-
const deps = Object.keys(pkg.dependencies || {});
|
|
315
|
-
const usados = new Set();
|
|
316
|
-
|
|
317
|
-
for (const file of publishedSources(env)) {
|
|
318
|
-
for (const spec of importsOf(env, file)) {
|
|
319
|
-
const nome = packageName(spec);
|
|
320
|
-
if (nome) usados.add(nome);
|
|
321
|
-
}
|
|
322
|
-
}
|
|
323
|
-
|
|
324
|
-
const ociosos = deps.filter((d) => !usados.has(d));
|
|
325
|
-
if (ociosos.length) {
|
|
326
|
-
return {
|
|
327
|
-
status: 'warn',
|
|
328
|
-
detail: `declarada(s) e nunca importada(s): ${ociosos.join(', ')} — todo usuário baixa isso`,
|
|
329
|
-
fix: `npm rm ${ociosos.join(' ')}`,
|
|
330
|
-
};
|
|
331
|
-
}
|
|
332
|
-
|
|
333
|
-
return { status: 'ok', detail: 'nenhuma dependência ociosa', fix: null };
|
|
334
|
-
},
|
|
335
|
-
};
|
|
336
|
-
|
|
337
|
-
/**
|
|
338
|
-
* O check mais importante, e o mais fácil de errar.
|
|
339
|
-
*
|
|
340
|
-
* **Executar, não listar.** O `forja` sem argumentos passa mesmo com tudo quebrado — o help não
|
|
341
|
-
* carrega os scripts. Foi assim que a quebra do ADR-0021 §2 se escondeu: o help funcionava, e dez
|
|
342
|
-
* comandos estavam mortos.
|
|
343
|
-
*
|
|
344
|
-
* **Reprovar por stderr, nunca por exit code.** Numa instalação limpa não há workspace nem
|
|
345
|
-
* `universal.db`; `query:universal` sai com código ≠ 0 *legitimamente*, e isso é o pacote
|
|
346
|
-
* funcionando. O que denuncia tarball quebrado é a assinatura do carregamento. Reprovar por exit
|
|
347
|
-
* code reprovaria um pacote saudável — a mesma armadilha do `memory-db` na SPEC-009, um nível
|
|
348
|
-
* acima.
|
|
349
|
-
*/
|
|
350
|
-
const smokeCommands = {
|
|
351
|
-
id: 'smoke-commands',
|
|
352
|
-
title: 'os comandos executam de verdade',
|
|
353
|
-
severity: 'critical',
|
|
354
|
-
dependsOn: 'install',
|
|
355
|
-
probe(env) {
|
|
356
|
-
const bin = path.join(env.pkgDir, 'bin', 'forja.mjs');
|
|
357
|
-
const quebrados = [];
|
|
358
|
-
|
|
359
|
-
for (const args of env.smokeCommands) {
|
|
360
|
-
const res = env.spawn(process.execPath, [bin, ...args], { cwd: env.installDir });
|
|
361
|
-
const saida = `${res.stdout || ''}${res.stderr || ''}`;
|
|
362
|
-
if (LOADER_ERRORS.test(saida)) {
|
|
363
|
-
const causa = saida.match(LOADER_ERRORS)[0];
|
|
364
|
-
quebrados.push(`${args[0] || '(help)'}: ${causa}`);
|
|
365
|
-
}
|
|
366
|
-
}
|
|
367
|
-
|
|
368
|
-
if (quebrados.length) {
|
|
369
|
-
return {
|
|
370
|
-
status: 'fail',
|
|
371
|
-
detail: `comando(s) não carregam na instalação limpa: ${quebrados.join('; ')}`,
|
|
372
|
-
fix: 'verifique files[] e dependencies — o repo resolve, o tarball não',
|
|
373
|
-
};
|
|
374
|
-
}
|
|
375
|
-
|
|
376
|
-
return {
|
|
377
|
-
status: 'ok',
|
|
378
|
-
detail: `${env.smokeCommands.length} comando(s) executam sem erro de carregamento`,
|
|
379
|
-
fix: null,
|
|
380
|
-
};
|
|
381
|
-
},
|
|
382
|
-
};
|
|
383
|
-
|
|
384
|
-
/** @type {import('./checks.mjs').Check[]} */
|
|
385
|
-
export const RELEASE_CHECKS = [
|
|
386
|
-
treeClean,
|
|
387
|
-
install,
|
|
388
|
-
registryScripts,
|
|
389
|
-
smokeCommands,
|
|
390
|
-
importsResolve,
|
|
391
|
-
depsDeclared,
|
|
392
|
-
depsUnused,
|
|
393
|
-
];
|
|
394
|
-
|
|
395
|
-
/** Comandos sem efeito colateral. `tools:doctor` e `code:status` só leem; o help não prova nada sozinho. */
|
|
396
|
-
const DEFAULT_SMOKE = [[], ['tools:doctor'], ['code:status'], ['query:universal', 'teste']];
|
|
397
|
-
|
|
398
|
-
export function defaultEnv(overrides = {}) {
|
|
399
|
-
return {
|
|
400
|
-
root: repoRoot,
|
|
401
|
-
fs,
|
|
402
|
-
registry: COMMANDS,
|
|
403
|
-
smokeCommands: DEFAULT_SMOKE,
|
|
404
|
-
publish: false,
|
|
405
|
-
spawn: (cmd, args, opts) => {
|
|
406
|
-
try {
|
|
407
|
-
return {
|
|
408
|
-
stdout: execFileSync(cmd, args, { encoding: 'utf8', stdio: 'pipe', ...opts }),
|
|
409
|
-
stderr: '',
|
|
410
|
-
};
|
|
411
|
-
} catch (err) {
|
|
412
|
-
return { stdout: err.stdout || '', stderr: err.stderr || String(err) };
|
|
413
|
-
}
|
|
414
|
-
},
|
|
415
|
-
...overrides,
|
|
416
|
-
};
|
|
417
|
-
}
|
|
418
|
-
|
|
419
|
-
/**
|
|
420
|
-
* Roda o gate completo: empacota, instala isolado, checa, limpa.
|
|
421
|
-
*
|
|
422
|
-
* A aprovação é **perecível** — vale para o disco naquele instante. Por isso a árvore é reconferida
|
|
423
|
-
* ao final: um `npm install` entre o check e o publish invalida tudo, e foi exatamente essa a causa
|
|
424
|
-
* da v1.1.1.
|
|
425
|
-
*/
|
|
426
|
-
export async function runReleaseChecks({ publish = false, env: overrides = {} } = {}) {
|
|
427
|
-
const base = defaultEnv({ publish, ...overrides });
|
|
428
|
-
|
|
429
|
-
const arvoreAntes = git(['status', '--short'], base.root);
|
|
430
|
-
|
|
431
|
-
const results = await withCleanInstall(
|
|
432
|
-
({ pkgDir, installDir }) => run({
|
|
433
|
-
checks: RELEASE_CHECKS,
|
|
434
|
-
env: { ...base, pkgDir, installDir },
|
|
435
|
-
}),
|
|
436
|
-
{ root: base.root }
|
|
437
|
-
);
|
|
438
|
-
|
|
439
|
-
const arvoreDepois = git(['status', '--short'], base.root);
|
|
440
|
-
if (arvoreAntes !== arvoreDepois) {
|
|
441
|
-
results.push({
|
|
442
|
-
id: 'tree-stable',
|
|
443
|
-
title: 'a árvore não mudou durante a auditoria',
|
|
444
|
-
severity: 'critical',
|
|
445
|
-
status: 'fail',
|
|
446
|
-
detail: 'o disco mudou enquanto o gate rodava — este parecer está vencido',
|
|
447
|
-
fix: 'rode o gate de novo com a árvore parada',
|
|
448
|
-
});
|
|
449
|
-
}
|
|
450
|
-
|
|
451
|
-
return results;
|
|
452
|
-
}
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* code-intel — camada de code intelligence sobre o codegraph (ADR-0017).
|
|
4
|
-
*
|
|
5
|
-
* Auto-contido: depende apenas do binario `codegraph` no PATH. Se ausente,
|
|
6
|
-
* degrada graciosamente (avisa e segue) — nunca trava o fluxo.
|
|
7
|
-
*
|
|
8
|
-
* Comandos:
|
|
9
|
-
* check Valida indice (worktree + freshness)
|
|
10
|
-
* impact <simbolo> [d] Chamadores e blast radius de um simbolo
|
|
11
|
-
*
|
|
12
|
-
* Emitido por forja/init-project.js. Veja docs do framework para o GSD completo.
|
|
13
|
-
*/
|
|
14
|
-
|
|
15
|
-
import { spawnSync } from 'node:child_process';
|
|
16
|
-
|
|
17
|
-
function runCodegraph(args) {
|
|
18
|
-
const result = spawnSync('codegraph', args, { encoding: 'utf8' });
|
|
19
|
-
if (result.error && result.error.code === 'ENOENT') return { missing: true };
|
|
20
|
-
return {
|
|
21
|
-
missing: false,
|
|
22
|
-
status: result.status ?? 1,
|
|
23
|
-
stdout: (result.stdout || '').trim(),
|
|
24
|
-
stderr: (result.stderr || '').trim(),
|
|
25
|
-
};
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
function codegraphStatus() {
|
|
29
|
-
const res = runCodegraph(['status', '--json']);
|
|
30
|
-
if (res.missing) return { missing: true };
|
|
31
|
-
let data = null;
|
|
32
|
-
try {
|
|
33
|
-
data = JSON.parse(res.stdout);
|
|
34
|
-
} catch {
|
|
35
|
-
return { missing: false, parseError: true, raw: res.stdout || res.stderr };
|
|
36
|
-
}
|
|
37
|
-
const pending = data.pendingChanges || {};
|
|
38
|
-
const pendingTotal = (pending.added || 0) + (pending.modified || 0) + (pending.removed || 0);
|
|
39
|
-
return {
|
|
40
|
-
missing: false,
|
|
41
|
-
initialized: Boolean(data.initialized),
|
|
42
|
-
worktreeMismatch: data.worktreeMismatch || null,
|
|
43
|
-
fileCount: data.fileCount || 0,
|
|
44
|
-
pendingTotal,
|
|
45
|
-
reindexRecommended: Boolean(data.index && data.index.reindexRecommended),
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
function fail(msg) {
|
|
50
|
-
console.error(msg);
|
|
51
|
-
process.exit(1);
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
function cmdCheck() {
|
|
55
|
-
const s = codegraphStatus();
|
|
56
|
-
if (s.missing) {
|
|
57
|
-
console.log('Codegraph nao instalado no PATH. Code intelligence ignorado.');
|
|
58
|
-
console.log('Instale com: npm i -g @codegraph/cli');
|
|
59
|
-
process.exit(0);
|
|
60
|
-
}
|
|
61
|
-
if (s.parseError) {
|
|
62
|
-
console.log('Codegraph respondeu, mas status --json nao pode ser lido.');
|
|
63
|
-
fail(s.raw || 'sem saida');
|
|
64
|
-
}
|
|
65
|
-
const lines = [];
|
|
66
|
-
let blocking = false;
|
|
67
|
-
if (!s.initialized) {
|
|
68
|
-
blocking = true;
|
|
69
|
-
lines.push('FAIL indice ausente: rode `npm run code:index`.');
|
|
70
|
-
} else {
|
|
71
|
-
lines.push(`OK indice inicializado (${s.fileCount} arquivos).`);
|
|
72
|
-
}
|
|
73
|
-
if (s.worktreeMismatch) {
|
|
74
|
-
blocking = true;
|
|
75
|
-
lines.push(`FAIL indice de outro worktree: ${s.worktreeMismatch}. Rode \`codegraph init -i\`.`);
|
|
76
|
-
} else if (s.initialized) {
|
|
77
|
-
lines.push('OK indice pertence a este worktree.');
|
|
78
|
-
}
|
|
79
|
-
if (s.pendingTotal > 0 || s.reindexRecommended) {
|
|
80
|
-
lines.push(`WARN indice defasado (${s.pendingTotal} pend.). Rode \`npm run code:sync\`.`);
|
|
81
|
-
} else if (s.initialized) {
|
|
82
|
-
lines.push('OK indice em dia.');
|
|
83
|
-
}
|
|
84
|
-
console.log('Codegraph check:\n');
|
|
85
|
-
for (const line of lines) console.log(line);
|
|
86
|
-
if (blocking) fail('\nResultado: gate de code intelligence reprovado.');
|
|
87
|
-
console.log('\nResultado: code intelligence confiavel.');
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
function cmdImpact(symbol, depthArg) {
|
|
91
|
-
if (!symbol) fail('Uso: code-intel impact <simbolo> [profundidade]');
|
|
92
|
-
const probe = runCodegraph(['status', '--json']);
|
|
93
|
-
if (probe.missing) {
|
|
94
|
-
console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
|
|
95
|
-
console.log(`Fallback manual: grep -rn "${symbol}" . e leia os chamadores.`);
|
|
96
|
-
process.exit(0);
|
|
97
|
-
}
|
|
98
|
-
const depth = String(parseInt(depthArg, 10) || 2);
|
|
99
|
-
console.log(`Mapa de impacto: ${symbol} (profundidade ${depth})\n`);
|
|
100
|
-
const impact = runCodegraph(['impact', symbol, '-d', depth]);
|
|
101
|
-
if (impact.stdout) console.log(impact.stdout);
|
|
102
|
-
const callers = runCodegraph(['callers', symbol]);
|
|
103
|
-
if (callers.stdout) {
|
|
104
|
-
console.log('\n--- Chamadores diretos ---');
|
|
105
|
-
console.log(callers.stdout);
|
|
106
|
-
}
|
|
107
|
-
if (!impact.stdout && !callers.stdout) {
|
|
108
|
-
console.log('Nenhum no encontrado. Confirme o nome ou rode `npm run code:sync`.');
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
const [cmd, ...rest] = process.argv.slice(2);
|
|
113
|
-
switch (cmd) {
|
|
114
|
-
case 'check': cmdCheck(); break;
|
|
115
|
-
case 'impact': cmdImpact(rest[0], rest[1]); break;
|
|
116
|
-
default:
|
|
117
|
-
console.log('Uso: node scripts/code-intel.mjs <check|impact> [args]');
|
|
118
|
-
process.exit(cmd ? 1 : 0);
|
|
119
|
-
}
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
import fs from 'node:fs';
|
|
2
|
-
import path from 'node:path';
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Funções utilitárias compartilhadas para geração de arquivos
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
export function ensureDir(dirPath) {
|
|
9
|
-
fs.mkdirSync(dirPath, { recursive: true });
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
export function writeFileSafe(filePath, content, options = {}) {
|
|
13
|
-
const { force = false } = options;
|
|
14
|
-
if (fs.existsSync(filePath) && !force) {
|
|
15
|
-
throw new Error(`Arquivo ja existe: ${filePath}. Use --force para sobrescrever.`);
|
|
16
|
-
}
|
|
17
|
-
ensureDir(path.dirname(filePath));
|
|
18
|
-
fs.writeFileSync(filePath, content, 'utf8');
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
export function maybeGitkeep(dirPath, options = {}) {
|
|
22
|
-
const { noGitkeep = false } = options;
|
|
23
|
-
if (noGitkeep) return;
|
|
24
|
-
const keepFile = path.join(dirPath, '.gitkeep');
|
|
25
|
-
if (!fs.existsSync(keepFile)) {
|
|
26
|
-
fs.writeFileSync(keepFile, '', 'utf8');
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
export function log(message) {
|
|
31
|
-
console.log(message);
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
export function logError(message) {
|
|
35
|
-
console.error(`❌ ${message}`);
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
export function logSuccess(message) {
|
|
39
|
-
console.log(`✅ ${message}`);
|
|
40
|
-
}
|