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/context-builder.js
DELETED
|
@@ -1,257 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Context Builder - API Reutilizável para Construção de Contexto Inteligente
|
|
3
|
-
*
|
|
4
|
-
* Suporta 3 modos de contexto:
|
|
5
|
-
* - 'global': Apenas contexto global (mission, standards, decisões recentes)
|
|
6
|
-
* - 'domain': Contexto de domínio específico + globais
|
|
7
|
-
* - 'task': Contexto orientado a tarefa + domain + globais (mais compacto)
|
|
8
|
-
*
|
|
9
|
-
* Usa SQLite FTS5 para busca eficiente e cache local para reutilização.
|
|
10
|
-
*/
|
|
11
|
-
|
|
12
|
-
import fs from 'node:fs';
|
|
13
|
-
import path from 'node:path';
|
|
14
|
-
import Database from 'better-sqlite3';
|
|
15
|
-
import { getDbPath, ensureSchema } from '../scripts/memory-schema.mjs';
|
|
16
|
-
|
|
17
|
-
export class ContextBuilder {
|
|
18
|
-
constructor(projectPath, dbPath) {
|
|
19
|
-
this.projectPath = projectPath;
|
|
20
|
-
this.dbPath = dbPath;
|
|
21
|
-
this.db = null;
|
|
22
|
-
this.cache = new Map();
|
|
23
|
-
this.maxCacheSize = 50; // MB
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* Abrir conexão com banco de dados (readonly)
|
|
28
|
-
*/
|
|
29
|
-
connect() {
|
|
30
|
-
if (this.db) return;
|
|
31
|
-
|
|
32
|
-
if (!fs.existsSync(this.dbPath)) {
|
|
33
|
-
throw new Error(`Database not found: ${this.dbPath}`);
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
this.db = new Database(this.dbPath, { readonly: true });
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* Fechar conexão
|
|
41
|
-
*/
|
|
42
|
-
close() {
|
|
43
|
-
if (this.db) {
|
|
44
|
-
this.db.close();
|
|
45
|
-
this.db = null;
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
/**
|
|
50
|
-
* Construir contexto no modo especificado
|
|
51
|
-
*
|
|
52
|
-
* @param {string} mode - 'global', 'domain', 'task'
|
|
53
|
-
* @param {string} project - Nome do projeto
|
|
54
|
-
* @param {string} keyword - Palavra-chave para busca (modo 'task')
|
|
55
|
-
* @returns {string} Conteúdo do contexto em markdown
|
|
56
|
-
*/
|
|
57
|
-
build(mode, project, keyword = '') {
|
|
58
|
-
this.connect();
|
|
59
|
-
|
|
60
|
-
const started = Date.now();
|
|
61
|
-
const nodes = [];
|
|
62
|
-
const seenPaths = new Set();
|
|
63
|
-
|
|
64
|
-
// 1. Contexto global obrigatório
|
|
65
|
-
const globalNodes = this._getGlobalNodes();
|
|
66
|
-
nodes.push(...globalNodes);
|
|
67
|
-
|
|
68
|
-
// 2. Contexto específico por modo
|
|
69
|
-
if (mode === 'domain' || mode === 'task') {
|
|
70
|
-
const domainNodes = this._getDomainNodes(project);
|
|
71
|
-
nodes.push(...domainNodes);
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
if (mode === 'task' && keyword) {
|
|
75
|
-
const taskNodes = this._getTaskNodes(project, keyword);
|
|
76
|
-
nodes.push(...taskNodes);
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
// 3. Gerar markdown deduplicado
|
|
80
|
-
let context = this._generateMarkdown(mode, project, keyword, nodes, seenPaths);
|
|
81
|
-
const duration = Date.now() - started;
|
|
82
|
-
|
|
83
|
-
// 4. Adicionar footer com metadata
|
|
84
|
-
const footer = `\n\n---\n\n## 📊 Context Metadata\n\n` +
|
|
85
|
-
`- **Mode**: ${mode}\n` +
|
|
86
|
-
`- **Project**: ${project}\n` +
|
|
87
|
-
`- **Keyword**: ${keyword || 'none'}\n` +
|
|
88
|
-
`- **Generated**: ${new Date().toISOString()}\n` +
|
|
89
|
-
`- **Duration**: ${duration}ms\n` +
|
|
90
|
-
`- **Files**: ${seenPaths.size}\n` +
|
|
91
|
-
`- **Size**: ${Math.round(context.length / 1024)}KB\n`;
|
|
92
|
-
|
|
93
|
-
return context + footer;
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
/**
|
|
97
|
-
* Obter contexto global (mission, standards, padrões)
|
|
98
|
-
*/
|
|
99
|
-
_getGlobalNodes() {
|
|
100
|
-
try {
|
|
101
|
-
const stmt = this.db.prepare(`
|
|
102
|
-
SELECT title, content, path FROM memory_nodes
|
|
103
|
-
WHERE project_id IS NULL
|
|
104
|
-
AND (
|
|
105
|
-
path LIKE '%mission.md'
|
|
106
|
-
OR path LIKE '%standards.md'
|
|
107
|
-
OR path LIKE '%ADR-%'
|
|
108
|
-
)
|
|
109
|
-
ORDER BY updated_at DESC
|
|
110
|
-
LIMIT 10
|
|
111
|
-
`);
|
|
112
|
-
return stmt.all() || [];
|
|
113
|
-
} catch (e) {
|
|
114
|
-
console.warn('⚠️ No global nodes found:', e.message);
|
|
115
|
-
return [];
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
/**
|
|
120
|
-
* Obter contexto de domínio (vision, design, rules do projeto)
|
|
121
|
-
*/
|
|
122
|
-
_getDomainNodes(project) {
|
|
123
|
-
try {
|
|
124
|
-
const stmt = this.db.prepare(`
|
|
125
|
-
SELECT DISTINCT n.title, n.content, n.path
|
|
126
|
-
FROM memory_nodes n
|
|
127
|
-
JOIN projects p ON p.id = n.project_id
|
|
128
|
-
WHERE p.name = ?
|
|
129
|
-
AND (
|
|
130
|
-
n.path LIKE '%vision.md'
|
|
131
|
-
OR n.path LIKE '%design%'
|
|
132
|
-
OR n.path LIKE '%rules.md'
|
|
133
|
-
OR n.path LIKE '%summary%'
|
|
134
|
-
)
|
|
135
|
-
ORDER BY n.updated_at DESC
|
|
136
|
-
LIMIT 15
|
|
137
|
-
`);
|
|
138
|
-
return stmt.all(project) || [];
|
|
139
|
-
} catch (e) {
|
|
140
|
-
console.warn(`⚠️ No domain nodes found for ${project}:`, e.message);
|
|
141
|
-
return [];
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
/**
|
|
146
|
-
* Obter contexto orientado a tarefa (busca por FTS5)
|
|
147
|
-
*/
|
|
148
|
-
_getTaskNodes(project, keyword) {
|
|
149
|
-
try {
|
|
150
|
-
const stmt = this.db.prepare(`
|
|
151
|
-
SELECT DISTINCT n.title, n.content, n.path
|
|
152
|
-
FROM memory_nodes n
|
|
153
|
-
JOIN projects p ON p.id = n.project_id
|
|
154
|
-
LEFT JOIN search_idx s ON s.node_id = n.id
|
|
155
|
-
WHERE p.name = ?
|
|
156
|
-
AND (n.content LIKE ? OR s.content MATCH ?)
|
|
157
|
-
ORDER BY n.updated_at DESC
|
|
158
|
-
LIMIT 20
|
|
159
|
-
`);
|
|
160
|
-
const pattern = `%${keyword}%`;
|
|
161
|
-
return stmt.all(project, pattern, keyword) || [];
|
|
162
|
-
} catch (e) {
|
|
163
|
-
console.warn(`⚠️ No task nodes found for "${keyword}":`, e.message);
|
|
164
|
-
return [];
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
/**
|
|
169
|
-
* Gerar markdown deduplicado
|
|
170
|
-
*/
|
|
171
|
-
_generateMarkdown(mode, project, keyword, nodes, seenPaths) {
|
|
172
|
-
let md = `# CONTEXT PACK: ${project.toUpperCase()}\n\n`;
|
|
173
|
-
md += `**Mode**: \`${mode}\`\n`;
|
|
174
|
-
if (keyword) md += `**Search**: \`${keyword}\`\n`;
|
|
175
|
-
md += `\n`;
|
|
176
|
-
|
|
177
|
-
for (const node of nodes) {
|
|
178
|
-
if (seenPaths.has(node.path)) continue;
|
|
179
|
-
seenPaths.add(node.path);
|
|
180
|
-
|
|
181
|
-
md += `## 📄 ${node.title}\n`;
|
|
182
|
-
md += `**Path**: \`${node.path}\`\n\n`;
|
|
183
|
-
md += `${node.content}\n\n`;
|
|
184
|
-
md += `---\n\n`;
|
|
185
|
-
}
|
|
186
|
-
|
|
187
|
-
return md;
|
|
188
|
-
}
|
|
189
|
-
|
|
190
|
-
/**
|
|
191
|
-
* Salvar contexto em arquivo
|
|
192
|
-
*/
|
|
193
|
-
save(content, outputPath) {
|
|
194
|
-
const dir = path.dirname(outputPath);
|
|
195
|
-
if (!fs.existsSync(dir)) {
|
|
196
|
-
fs.mkdirSync(dir, { recursive: true });
|
|
197
|
-
}
|
|
198
|
-
fs.writeFileSync(outputPath, content, 'utf8');
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
/**
|
|
202
|
-
* Estatísticas de contexto
|
|
203
|
-
*/
|
|
204
|
-
stats(mode, project, keyword = '') {
|
|
205
|
-
const content = this.build(mode, project, keyword);
|
|
206
|
-
const lines = content.split('\n').length;
|
|
207
|
-
const tokens = Math.round(content.length / 4); // Aproximação simples
|
|
208
|
-
|
|
209
|
-
return {
|
|
210
|
-
mode,
|
|
211
|
-
project,
|
|
212
|
-
keyword,
|
|
213
|
-
bytes: content.length,
|
|
214
|
-
lines,
|
|
215
|
-
tokens,
|
|
216
|
-
estimatedCost: (tokens * 0.00001).toFixed(4), // Assumindo $0.00001 por token
|
|
217
|
-
};
|
|
218
|
-
}
|
|
219
|
-
}
|
|
220
|
-
|
|
221
|
-
/**
|
|
222
|
-
* Modo CLI - Executar via node scripts/context-builder.mjs
|
|
223
|
-
*/
|
|
224
|
-
if (import.meta.url === `file://${process.argv[1]}`) {
|
|
225
|
-
const [mode, project, keyword] = process.argv.slice(2);
|
|
226
|
-
|
|
227
|
-
if (!mode || !project) {
|
|
228
|
-
console.error('Usage: node context-builder.mjs <mode> <project> [keyword]');
|
|
229
|
-
console.error('Modes: global, domain, task');
|
|
230
|
-
process.exit(1);
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
ensureSchema({ silent: true });
|
|
234
|
-
const dbPath = getDbPath();
|
|
235
|
-
const builder = new ContextBuilder(process.cwd(), dbPath);
|
|
236
|
-
|
|
237
|
-
try {
|
|
238
|
-
console.log(`🔨 Building ${mode} context for ${project}...`);
|
|
239
|
-
const content = builder.build(mode, project, keyword);
|
|
240
|
-
const stats = builder.stats(mode, project, keyword);
|
|
241
|
-
|
|
242
|
-
const outDir = path.join(process.cwd(), '.context');
|
|
243
|
-
const outFile = path.join(outDir, `context-${mode}.md`);
|
|
244
|
-
|
|
245
|
-
builder.save(content, outFile);
|
|
246
|
-
|
|
247
|
-
console.log(`✅ Context saved: ${outFile}`);
|
|
248
|
-
console.log(`📊 Stats:`, stats);
|
|
249
|
-
} catch (e) {
|
|
250
|
-
console.error('❌ Error:', e.message);
|
|
251
|
-
process.exit(1);
|
|
252
|
-
} finally {
|
|
253
|
-
builder.close();
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
|
|
257
|
-
export default ContextBuilder;
|
package/lib/core/checks.mjs
DELETED
|
@@ -1,138 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* lib/core/checks.mjs — o runner de checks. Sem opinião sobre o que se checa.
|
|
3
|
-
*
|
|
4
|
-
* Máquina compartilhada por dois catálogos, cada um guardando uma fronteira:
|
|
5
|
-
*
|
|
6
|
-
* health.mjs o núcleo — o que impede o framework de trabalhar aqui (SPEC-009, ADR-0023)
|
|
7
|
-
* release.mjs o tarball — o que impede o pacote de funcionar na máquina de quem instala (SPEC-010)
|
|
8
|
-
*
|
|
9
|
-
* O runner foi extraído, e não copiado, de propósito: duas máquinas iguais divergem com o tempo, e
|
|
10
|
-
* divergência entre superfícies que deveriam concordar é exatamente o defeito que a SPEC-009
|
|
11
|
-
* existiu para matar (o doctor e o hook diziam coisas diferentes sobre a mesma memória).
|
|
12
|
-
*
|
|
13
|
-
* Dois princípios, que valem para qualquer check novo em qualquer catálogo:
|
|
14
|
-
*
|
|
15
|
-
* 1. **Nunca colapsar causas distintas num booleano.** Um probe classifica a causa e devolve a
|
|
16
|
-
* correção *dela*. O bug que originou tudo isso era um `catch { return null }` que engolia três
|
|
17
|
-
* causas e prescrevia a correção de uma.
|
|
18
|
-
* 2. **Uma causa, uma linha vermelha.** Check cuja dependência falhou é `skipped`, não `fail` —
|
|
19
|
-
* senão uma raiz vira três erros vermelhos e o operador não sabe qual perseguir.
|
|
20
|
-
*/
|
|
21
|
-
|
|
22
|
-
/** @typedef {'critical'|'warn'} Severity */
|
|
23
|
-
/** @typedef {'runtime'|'repo'} Scope */
|
|
24
|
-
/** @typedef {'ok'|'warn'|'fail'|'skipped'} Status */
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* @typedef {object} Check
|
|
28
|
-
* @property {string} id
|
|
29
|
-
* @property {string} title
|
|
30
|
-
* @property {Severity} severity `critical` trava o gate; `warn` informa.
|
|
31
|
-
* @property {Scope=} scope Filtro opcional do runner.
|
|
32
|
-
* @property {string=} dependsOn Id de outro check. Se ele não passar, este vira `skipped`.
|
|
33
|
-
* @property {(env: object) => Promise<Probe>|Probe} probe
|
|
34
|
-
*/
|
|
35
|
-
|
|
36
|
-
/**
|
|
37
|
-
* @typedef {object} Probe
|
|
38
|
-
* @property {Status} status
|
|
39
|
-
* @property {string} detail O que foi observado, em uma linha.
|
|
40
|
-
* @property {string|null=} fix Comando exato que corrige. `null` quando não há o que corrigir.
|
|
41
|
-
*/
|
|
42
|
-
|
|
43
|
-
/** @typedef {{ id, title, severity: Severity, scope: Scope, status: Status, detail: string, fix: string|null }} Result */
|
|
44
|
-
|
|
45
|
-
const SEVERITY_FALLBACK = 'critical';
|
|
46
|
-
|
|
47
|
-
/**
|
|
48
|
-
* Um probe que estoura é pior que probe nenhum: derrubaria o diagnóstico justamente no ambiente
|
|
49
|
-
* quebrado que ele existe para diagnosticar. O runner blinda cada um e segue para o próximo.
|
|
50
|
-
*/
|
|
51
|
-
async function runProbe(check, env) {
|
|
52
|
-
try {
|
|
53
|
-
const probe = await check.probe(env);
|
|
54
|
-
return {
|
|
55
|
-
status: probe.status,
|
|
56
|
-
detail: probe.detail,
|
|
57
|
-
fix: probe.fix ?? null,
|
|
58
|
-
};
|
|
59
|
-
} catch (err) {
|
|
60
|
-
return {
|
|
61
|
-
status: 'fail',
|
|
62
|
-
detail: `probe falhou: ${err?.message || err}`,
|
|
63
|
-
fix: null,
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
/**
|
|
69
|
-
* Executa os checks na ordem declarada.
|
|
70
|
-
*
|
|
71
|
-
* @param {{ checks: Check[], scope?: Scope|'all', env?: object }} opts
|
|
72
|
-
* @returns {Promise<Result[]>}
|
|
73
|
-
*/
|
|
74
|
-
export async function runChecks({ checks, scope = 'all', env = {} }) {
|
|
75
|
-
const selected = checks.filter((c) => scope === 'all' || c.scope === scope);
|
|
76
|
-
const statusById = new Map();
|
|
77
|
-
const results = [];
|
|
78
|
-
|
|
79
|
-
for (const check of selected) {
|
|
80
|
-
const base = {
|
|
81
|
-
id: check.id,
|
|
82
|
-
title: check.title,
|
|
83
|
-
severity: check.severity || SEVERITY_FALLBACK,
|
|
84
|
-
scope: check.scope,
|
|
85
|
-
};
|
|
86
|
-
|
|
87
|
-
// Cascata: sem a dependência de pé, este probe não tem o que observar. Propaga por cadeia, não
|
|
88
|
-
// só um nível — `skipped` conta como "não verificado" para quem depende dele.
|
|
89
|
-
const depStatus = check.dependsOn ? statusById.get(check.dependsOn) : null;
|
|
90
|
-
if (depStatus === 'fail' || depStatus === 'skipped') {
|
|
91
|
-
const motivo = depStatus === 'fail' ? 'que falhou' : 'que não foi verificado';
|
|
92
|
-
results.push({
|
|
93
|
-
...base,
|
|
94
|
-
status: 'skipped',
|
|
95
|
-
detail: `não verificado: depende de "${check.dependsOn}", ${motivo}`,
|
|
96
|
-
fix: null,
|
|
97
|
-
});
|
|
98
|
-
statusById.set(check.id, 'skipped');
|
|
99
|
-
continue;
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
const probe = await runProbe(check, env);
|
|
103
|
-
statusById.set(check.id, probe.status);
|
|
104
|
-
results.push({ ...base, ...probe });
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
return results;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* Veredito agregado. Só `critical` reprova — um gate que trava por aquilo que não impede trabalho
|
|
112
|
-
* é um gate que se aprende a ignorar, e aí ele para de proteger do que importa.
|
|
113
|
-
*
|
|
114
|
-
* @param {Result[]} results
|
|
115
|
-
* @returns {'ok'|'warn'|'fail'}
|
|
116
|
-
*/
|
|
117
|
-
export function worstStatus(results) {
|
|
118
|
-
let seenWarn = false;
|
|
119
|
-
|
|
120
|
-
for (const r of results) {
|
|
121
|
-
if (r.status === 'fail' && r.severity === 'critical') return 'fail';
|
|
122
|
-
if (r.status === 'fail' || r.status === 'warn') seenWarn = true;
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
return seenWarn ? 'warn' : 'ok';
|
|
126
|
-
}
|
|
127
|
-
|
|
128
|
-
/**
|
|
129
|
-
* Remove template literals do fonte antes de qualquer análise estática de `import`.
|
|
130
|
-
*
|
|
131
|
-
* Os geradores do Forja *escrevem* código NestJS dentro de crases — `import { Module } from
|
|
132
|
-
* '@nestjs/common'` é texto que eles emitem, não dependência que eles usam. Contá-lo faz o check
|
|
133
|
-
* acusar `@nestjs/core` como dependência não declarada e `./app.module` como import quebrado.
|
|
134
|
-
* Observado em campo ao auditar o tarball da 1.1.3.
|
|
135
|
-
*/
|
|
136
|
-
export function stripTemplateLiterals(source) {
|
|
137
|
-
return source.replace(/`(?:\\.|[^`\\])*`/gs, '``');
|
|
138
|
-
}
|