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.
Files changed (172) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +62 -0
  3. package/README.en.md +33 -5
  4. package/README.md +35 -4
  5. package/boilerplates/06-clean-arch/README.md +48 -0
  6. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
  7. package/boilerplates/06-clean-arch/backend/package.json +43 -0
  8. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
  9. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
  10. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
  11. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
  12. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
  13. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
  14. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
  15. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
  21. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
  22. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
  24. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
  26. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
  27. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
  28. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
  29. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
  30. package/boilerplates/README.md +20 -0
  31. package/dist/bin/create-memory-nest-kit.d.ts +2 -0
  32. package/dist/bin/create-memory-nest-kit.js +110 -0
  33. package/dist/bin/forja.d.ts +13 -0
  34. package/dist/bin/forja.js +136 -0
  35. package/dist/bin/init-project.d.ts +2 -0
  36. package/dist/bin/init-project.js +516 -0
  37. package/dist/lib/audit.d.ts +67 -0
  38. package/dist/lib/audit.js +143 -0
  39. package/dist/lib/context-builder.d.ts +58 -0
  40. package/dist/lib/context-builder.js +233 -0
  41. package/dist/lib/core/checks.d.ts +91 -0
  42. package/dist/lib/core/checks.js +119 -0
  43. package/dist/lib/core/doc-graph.d.ts +60 -0
  44. package/dist/lib/core/doc-graph.js +235 -0
  45. package/dist/lib/core/health.d.ts +103 -0
  46. package/dist/lib/core/health.js +538 -0
  47. package/dist/lib/core/registry.d.ts +296 -0
  48. package/dist/lib/core/registry.js +317 -0
  49. package/dist/lib/core/release.d.ts +334 -0
  50. package/dist/lib/core/release.js +465 -0
  51. package/dist/lib/generators/memory-generator.d.ts +83 -0
  52. package/{lib → dist/lib}/generators/memory-generator.js +107 -178
  53. package/dist/lib/generators/nest-generator.d.ts +15 -0
  54. package/{lib → dist/lib}/generators/nest-generator.js +47 -71
  55. package/dist/lib/generators/readme-generator.d.ts +15 -0
  56. package/{lib → dist/lib}/generators/readme-generator.js +9 -14
  57. package/dist/lib/governance-report.d.ts +49 -0
  58. package/dist/lib/governance-report.js +170 -0
  59. package/dist/lib/templates/harness/code-intel.d.mts +2 -0
  60. package/dist/lib/templates/harness/code-intel.mjs +126 -0
  61. package/dist/lib/utils/file-helpers.d.ts +9 -0
  62. package/dist/lib/utils/file-helpers.js +34 -0
  63. package/dist/lib/validators/structure-validator.d.ts +48 -0
  64. package/dist/lib/validators/structure-validator.js +232 -0
  65. package/dist/lib/workspace.d.ts +40 -0
  66. package/dist/lib/workspace.js +174 -0
  67. package/dist/scripts/agent-harness.d.ts +2 -0
  68. package/dist/scripts/agent-harness.js +556 -0
  69. package/dist/scripts/agent-router.d.ts +30 -0
  70. package/dist/scripts/agent-router.js +208 -0
  71. package/dist/scripts/audit-query.d.ts +2 -0
  72. package/dist/scripts/audit-query.js +43 -0
  73. package/dist/scripts/audit-sync.d.ts +2 -0
  74. package/dist/scripts/audit-sync.js +19 -0
  75. package/dist/scripts/build-smart-context.d.ts +1 -0
  76. package/dist/scripts/build-smart-context.js +75 -0
  77. package/dist/scripts/check-standards.d.ts +1 -0
  78. package/dist/scripts/check-standards.js +87 -0
  79. package/dist/scripts/compress-memory.d.ts +16 -0
  80. package/dist/scripts/compress-memory.js +157 -0
  81. package/dist/scripts/compress-project-memory.d.ts +1 -0
  82. package/dist/scripts/compress-project-memory.js +48 -0
  83. package/dist/scripts/context-ops.d.ts +2 -0
  84. package/dist/scripts/context-ops.js +464 -0
  85. package/dist/scripts/dev.d.ts +96 -0
  86. package/dist/scripts/dev.js +312 -0
  87. package/dist/scripts/extract-global-knowledge.d.ts +1 -0
  88. package/dist/scripts/extract-global-knowledge.js +43 -0
  89. package/dist/scripts/generate-dashboard.d.ts +1 -0
  90. package/dist/scripts/generate-dashboard.js +48 -0
  91. package/dist/scripts/governance-dashboard.d.ts +2 -0
  92. package/dist/scripts/governance-dashboard.js +36 -0
  93. package/dist/scripts/hook-guard-paths.d.ts +17 -0
  94. package/dist/scripts/hook-guard-paths.js +68 -0
  95. package/dist/scripts/hook-post-edit.d.ts +20 -0
  96. package/dist/scripts/hook-post-edit.js +70 -0
  97. package/dist/scripts/hook-session-start.d.ts +17 -0
  98. package/dist/scripts/hook-session-start.js +108 -0
  99. package/dist/scripts/hook-user-prompt.d.ts +22 -0
  100. package/dist/scripts/hook-user-prompt.js +193 -0
  101. package/dist/scripts/memory-schema.d.ts +6 -0
  102. package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
  103. package/dist/scripts/query-universal-memory.d.ts +1 -0
  104. package/dist/scripts/query-universal-memory.js +44 -0
  105. package/dist/scripts/release-check.d.ts +14 -0
  106. package/dist/scripts/release-check.js +48 -0
  107. package/dist/scripts/spec-cli.d.ts +29 -0
  108. package/dist/scripts/spec-cli.js +261 -0
  109. package/dist/scripts/sprint-manager.d.ts +1 -0
  110. package/dist/scripts/sprint-manager.js +187 -0
  111. package/dist/scripts/sync-universal-memory.d.ts +1 -0
  112. package/dist/scripts/sync-universal-memory.js +277 -0
  113. package/dist/scripts/token-benchmark.d.ts +20 -0
  114. package/dist/scripts/token-benchmark.js +181 -0
  115. package/dist/scripts/tools-doctor.d.ts +20 -0
  116. package/dist/scripts/tools-doctor.js +120 -0
  117. package/docs/personas/architect/README.md +4 -4
  118. package/docs/personas/developer/README.md +3 -3
  119. package/docs/personas/qa/README.md +3 -3
  120. package/docs/quick-reference.md +9 -9
  121. package/docs/structure.md +3 -3
  122. package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
  123. package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
  124. package/memory/90-decisions/0028-governanca-visivel.md +84 -0
  125. package/package.json +60 -56
  126. package/specs/clean-arch-boilerplate/plan.md +137 -0
  127. package/specs/clean-arch-boilerplate/spec.md +121 -0
  128. package/specs/clean-arch-boilerplate/tasks.md +70 -0
  129. package/specs/coerencia-do-sistema/plan.md +155 -0
  130. package/specs/coerencia-do-sistema/spec.md +15 -14
  131. package/specs/coerencia-do-sistema/tasks.md +115 -0
  132. package/specs/governanca-visivel/plan.md +122 -0
  133. package/specs/governanca-visivel/spec.md +112 -0
  134. package/specs/governanca-visivel/tasks.md +60 -0
  135. package/specs/ts-migration/plan.md +199 -0
  136. package/specs/ts-migration/spec.md +119 -0
  137. package/specs/ts-migration/tasks.md +110 -0
  138. package/bin/create-memory-nest-kit.js +0 -125
  139. package/bin/forja.mjs +0 -143
  140. package/bin/init-project.js +0 -612
  141. package/lib/context-builder.js +0 -257
  142. package/lib/core/checks.mjs +0 -138
  143. package/lib/core/health.mjs +0 -475
  144. package/lib/core/registry.mjs +0 -289
  145. package/lib/core/release.mjs +0 -452
  146. package/lib/templates/harness/code-intel.mjs +0 -119
  147. package/lib/templates/harness/mcp.json +0 -10
  148. package/lib/utils/file-helpers.js +0 -40
  149. package/lib/validators/structure-validator.js +0 -253
  150. package/lib/workspace.mjs +0 -213
  151. package/scripts/agent-harness.mjs +0 -578
  152. package/scripts/agent-router.mjs +0 -189
  153. package/scripts/build-smart-context.js +0 -87
  154. package/scripts/check-standards.js +0 -98
  155. package/scripts/compress-memory.mjs +0 -198
  156. package/scripts/compress-project-memory.js +0 -58
  157. package/scripts/context-ops.mjs +0 -463
  158. package/scripts/dev.mjs +0 -349
  159. package/scripts/extract-global-knowledge.js +0 -52
  160. package/scripts/generate-dashboard.js +0 -59
  161. package/scripts/hook-guard-paths.mjs +0 -75
  162. package/scripts/hook-post-edit.mjs +0 -79
  163. package/scripts/hook-session-start.mjs +0 -104
  164. package/scripts/hook-user-prompt.mjs +0 -185
  165. package/scripts/pre-commit.sh +0 -102
  166. package/scripts/query-universal-memory.js +0 -50
  167. package/scripts/release-check.mjs +0 -56
  168. package/scripts/spec-cli.mjs +0 -260
  169. package/scripts/sprint-manager.js +0 -200
  170. package/scripts/sync-universal-memory.js +0 -286
  171. package/scripts/token-benchmark.mjs +0 -203
  172. package/scripts/tools-doctor.mjs +0 -132
@@ -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;
@@ -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
- }