forjajs 1.2.0 → 1.3.1

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 +41 -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
@@ -2,17 +2,15 @@
2
2
  * Nest Generator - Gera estrutura completa NestJS
3
3
  * Extraído de create-memory-nest-kit.js para modularização
4
4
  */
5
-
6
5
  import path from 'node:path';
7
6
  import { writeFileSafe, ensureDir, maybeGitkeep } from '../utils/file-helpers.js';
8
-
9
7
  /**
10
8
  * Factory de templates NestJS dinâmicos
11
9
  * Recebe projectName para interpolar em package.json
12
10
  */
13
11
  function createNestTemplates(projectName) {
14
- return {
15
- 'backend/package.json': `{
12
+ return {
13
+ 'backend/package.json': `{
16
14
  "name": "${projectName}-api",
17
15
  "version": "0.1.0",
18
16
  "private": true,
@@ -72,14 +70,12 @@ function createNestTemplates(projectName) {
72
70
  }
73
71
  }
74
72
  `,
75
-
76
- 'backend/nest-cli.json': `{
73
+ 'backend/nest-cli.json': `{
77
74
  "collection": "@nestjs/schematics",
78
75
  "sourceRoot": "src"
79
76
  }
80
77
  `,
81
-
82
- 'backend/tsconfig.json': `{
78
+ 'backend/tsconfig.json': `{
83
79
  "compilerOptions": {
84
80
  "module": "commonjs",
85
81
  "declaration": true,
@@ -97,14 +93,12 @@ function createNestTemplates(projectName) {
97
93
  }
98
94
  }
99
95
  `,
100
-
101
- 'backend/tsconfig.build.json': `{
96
+ 'backend/tsconfig.build.json': `{
102
97
  "extends": "./tsconfig.json",
103
98
  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
104
99
  }
105
100
  `,
106
-
107
- 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
101
+ 'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
108
102
  import { AppModule } from './app.module';
109
103
 
110
104
  async function bootstrap(): Promise<void> {
@@ -115,8 +109,7 @@ async function bootstrap(): Promise<void> {
115
109
 
116
110
  void bootstrap();
117
111
  `,
118
-
119
- 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
112
+ 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
120
113
  import { AppController } from "./app.controller";
121
114
  import { AppService } from "./app.service";
122
115
  import { OpsModule } from "./modules/ops/ops.module";
@@ -128,8 +121,7 @@ import { OpsModule } from "./modules/ops/ops.module";
128
121
  })
129
122
  export class AppModule {}
130
123
  `,
131
-
132
- 'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
124
+ 'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
133
125
  import { AppService } from './app.service';
134
126
 
135
127
  @Controller()
@@ -142,8 +134,7 @@ export class AppController {
142
134
  }
143
135
  }
144
136
  `,
145
-
146
- 'backend/src/app.service.ts': `import { Injectable } from '@nestjs/common';
137
+ 'backend/src/app.service.ts': `import { Injectable } from '@nestjs/common';
147
138
 
148
139
  @Injectable()
149
140
  export class AppService {
@@ -152,8 +143,7 @@ export class AppService {
152
143
  }
153
144
  }
154
145
  `,
155
-
156
- 'backend/src/modules/ops/ops.service.ts': `import { Injectable } from '@nestjs/common';
146
+ 'backend/src/modules/ops/ops.service.ts': `import { Injectable } from '@nestjs/common';
157
147
  import * as Database from 'better-sqlite3';
158
148
  import * as path from 'node:path';
159
149
 
@@ -175,8 +165,7 @@ export class OpsService {
175
165
  }
176
166
  }
177
167
  `,
178
-
179
- 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
168
+ 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
180
169
  import { OpsService } from './ops.service';
181
170
 
182
171
  @Controller('ops')
@@ -266,8 +255,7 @@ export class OpsController {
266
255
  }
267
256
  }
268
257
  `,
269
-
270
- 'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
258
+ 'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
271
259
  import { OpsController } from './ops.controller';
272
260
  import { OpsService } from './ops.service';
273
261
 
@@ -277,8 +265,7 @@ import { OpsService } from './ops.service';
277
265
  })
278
266
  export class OpsModule {}
279
267
  `,
280
-
281
- 'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
268
+ 'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
282
269
  import { AppController } from './app.controller';
283
270
  import { AppService } from './app.service';
284
271
 
@@ -299,8 +286,7 @@ describe('AppController', () => {
299
286
  });
300
287
  });
301
288
  `,
302
-
303
- 'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
289
+ 'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
304
290
  import { INestApplication } from '@nestjs/common';
305
291
  import request from 'supertest';
306
292
  import { AppModule } from '../src/app.module';
@@ -325,8 +311,7 @@ describe('AppController (e2e)', () => {
325
311
  });
326
312
  });
327
313
  `,
328
-
329
- 'backend/jest-e2e.json': `{
314
+ 'backend/jest-e2e.json': `{
330
315
  "moduleFileExtensions": ["js", "json", "ts"],
331
316
  "rootDir": ".",
332
317
  "testEnvironment": "node",
@@ -336,8 +321,7 @@ describe('AppController (e2e)', () => {
336
321
  }
337
322
  }
338
323
  `,
339
-
340
- 'backend/.eslintrc.json': `{
324
+ 'backend/.eslintrc.json': `{
341
325
  "parser": "@typescript-eslint/parser",
342
326
  "parserOptions": {
343
327
  "project": "tsconfig.json",
@@ -359,8 +343,7 @@ describe('AppController (e2e)', () => {
359
343
  }
360
344
  }
361
345
  `,
362
-
363
- 'backend/.prettierrc': `{
346
+ 'backend/.prettierrc': `{
364
347
  "singleQuote": true,
365
348
  "trailingComma": "all",
366
349
  "semi": true,
@@ -368,14 +351,13 @@ describe('AppController (e2e)', () => {
368
351
  "arrowParens": "always"
369
352
  }
370
353
  `,
371
- };
354
+ };
372
355
  }
373
-
374
356
  /**
375
357
  * Templates dos scripts de banco de dados (estáticos)
376
358
  */
377
359
  const databaseScriptTemplates = {
378
- 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
360
+ 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
379
361
  PRAGMA foreign_keys = ON;
380
362
 
381
363
  CREATE TABLE IF NOT EXISTS documents (
@@ -450,7 +432,6 @@ CREATE TABLE IF NOT EXISTS agent_sessions (
450
432
  );
451
433
  `,
452
434
  };
453
-
454
435
  /**
455
436
  * Gera estrutura completa do NestJS backend
456
437
  * @param {string} baseDir - Diretório base
@@ -458,39 +439,34 @@ CREATE TABLE IF NOT EXISTS agent_sessions (
458
439
  * @param {Object} options - Opções (force, noGitkeep)
459
440
  */
460
441
  export function generateNestStructure(baseDir, projectName, options = {}) {
461
- const dynamicTemplates = createNestTemplates(projectName);
462
- const allTemplates = { ...dynamicTemplates, ...databaseScriptTemplates };
463
-
464
- // Escrever todos os arquivos
465
- for (const [relativePath, content] of Object.entries(allTemplates)) {
466
- writeFileSafe(path.join(baseDir, relativePath), content, options);
467
- }
468
-
469
- // Criar diretórios vazios estruturados
470
- const emptyDirs = [
471
- 'backend/src/common',
472
- 'backend/src/common/decorators',
473
- 'backend/src/common/filters',
474
- 'backend/src/common/guards',
475
- 'backend/src/common/interceptors',
476
- 'backend/src/common/pipes',
477
- 'backend/src/database',
478
- 'backend/test/fixtures',
479
- ];
480
-
481
- for (const relDir of emptyDirs) {
482
- const abs = path.join(baseDir, relDir);
483
- ensureDir(abs);
484
- maybeGitkeep(abs, options);
485
- }
486
-
487
- return {
488
- success: true,
489
- filesWritten: Object.keys(allTemplates).length,
490
- emptyDirsCreated: emptyDirs.length,
491
- };
442
+ const dynamicTemplates = createNestTemplates(projectName);
443
+ const allTemplates = { ...dynamicTemplates, ...databaseScriptTemplates };
444
+ // Escrever todos os arquivos
445
+ for (const [relativePath, content] of Object.entries(allTemplates)) {
446
+ writeFileSafe(path.join(baseDir, relativePath), content, options);
447
+ }
448
+ // Criar diretórios vazios estruturados
449
+ const emptyDirs = [
450
+ 'backend/src/common',
451
+ 'backend/src/common/decorators',
452
+ 'backend/src/common/filters',
453
+ 'backend/src/common/guards',
454
+ 'backend/src/common/interceptors',
455
+ 'backend/src/common/pipes',
456
+ 'backend/src/database',
457
+ 'backend/test/fixtures',
458
+ ];
459
+ for (const relDir of emptyDirs) {
460
+ const abs = path.join(baseDir, relDir);
461
+ ensureDir(abs);
462
+ maybeGitkeep(abs, options);
463
+ }
464
+ return {
465
+ success: true,
466
+ filesWritten: Object.keys(allTemplates).length,
467
+ emptyDirsCreated: emptyDirs.length,
468
+ };
492
469
  }
493
-
494
470
  export default {
495
- generateNestStructure,
471
+ generateNestStructure,
496
472
  };
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Escreve README.md para o projeto
3
+ * @param {string} baseDir - Diretório base
4
+ * @param {string} projectName - Nome do projeto
5
+ * @param {Object} options - Opções (force)
6
+ */
7
+ export function generateReadme(baseDir: string, projectName: string, options?: any): {
8
+ success: boolean;
9
+ path: string;
10
+ size: number;
11
+ };
12
+ declare namespace _default {
13
+ export { generateReadme };
14
+ }
15
+ export default _default;
@@ -1,15 +1,13 @@
1
1
  /**
2
2
  * README Generator - Gera README.md para novo projeto
3
3
  */
4
-
5
4
  import path from 'node:path';
6
5
  import { writeFileSafe } from '../utils/file-helpers.js';
7
-
8
6
  /**
9
7
  * Factory para README dinâmico
10
8
  */
11
9
  function createReadmeContent(projectName) {
12
- return `# ${projectName}
10
+ return `# ${projectName}
13
11
 
14
12
  Scaffold gerado por **create-memory-nest-kit v0.5.0**
15
13
 
@@ -190,7 +188,6 @@ npm run project:dashboard
190
188
 
191
189
  `;
192
190
  }
193
-
194
191
  /**
195
192
  * Escreve README.md para o projeto
196
193
  * @param {string} baseDir - Diretório base
@@ -198,16 +195,14 @@ npm run project:dashboard
198
195
  * @param {Object} options - Opções (force)
199
196
  */
200
197
  export function generateReadme(baseDir, projectName, options = {}) {
201
- const content = createReadmeContent(projectName);
202
- writeFileSafe(path.join(baseDir, 'README.md'), content, options);
203
-
204
- return {
205
- success: true,
206
- path: path.join(baseDir, 'README.md'),
207
- size: content.length,
208
- };
198
+ const content = createReadmeContent(projectName);
199
+ writeFileSafe(path.join(baseDir, 'README.md'), content, options);
200
+ return {
201
+ success: true,
202
+ path: path.join(baseDir, 'README.md'),
203
+ size: content.length,
204
+ };
209
205
  }
210
-
211
206
  export default {
212
- generateReadme,
207
+ generateReadme,
213
208
  };
@@ -0,0 +1,49 @@
1
+ /**
2
+ * lib/governance-report.mjs — coleta o estado de governança e renderiza um painel HTML estático
3
+ * (SPEC-014).
4
+ *
5
+ * É a resposta correta ao ADR-0022: o dashboard antigo era um *servidor* com rotas que executavam
6
+ * processos (o passivo que o congelou). Este é um **artefato** — lê specs, ADRs, o registry e a
7
+ * trilha de auditoria, e devolve uma string HTML self-contained. **Não executa nada**: o estado dos
8
+ * gates vem do último exit registrado na auditoria (D4), não de reexecutar o gate.
9
+ *
10
+ * `collect` é puro (env injetável) e degrada quando falta dado (repo sem runs, sem workspace db).
11
+ */
12
+ import fs from 'node:fs';
13
+ /** @param {{ root?: string, fs?: typeof fs }} [env] */
14
+ export declare function collect(env?: {
15
+ root?: string;
16
+ fs?: typeof fs;
17
+ }): Promise<{
18
+ generatedAt: string;
19
+ metrics: {
20
+ commands: number;
21
+ specs: number;
22
+ adrs: any;
23
+ };
24
+ gates: {
25
+ name: string;
26
+ cmd: string;
27
+ adr: string;
28
+ state: string;
29
+ checks: {
30
+ id: string;
31
+ severity: string;
32
+ }[];
33
+ }[];
34
+ specs: {
35
+ slug: string;
36
+ spec: any;
37
+ plan: any;
38
+ tasks: any;
39
+ }[];
40
+ audit: {
41
+ total: any;
42
+ fails: any;
43
+ byCmd: any;
44
+ slowest: any;
45
+ recent: any;
46
+ } | null;
47
+ }>;
48
+ /** @param {Awaited<ReturnType<typeof collect>>} d */
49
+ export declare function renderHtml(d: any): string;
@@ -0,0 +1,170 @@
1
+ /**
2
+ * lib/governance-report.mjs — coleta o estado de governança e renderiza um painel HTML estático
3
+ * (SPEC-014).
4
+ *
5
+ * É a resposta correta ao ADR-0022: o dashboard antigo era um *servidor* com rotas que executavam
6
+ * processos (o passivo que o congelou). Este é um **artefato** — lê specs, ADRs, o registry e a
7
+ * trilha de auditoria, e devolve uma string HTML self-contained. **Não executa nada**: o estado dos
8
+ * gates vem do último exit registrado na auditoria (D4), não de reexecutar o gate.
9
+ *
10
+ * `collect` é puro (env injetável) e degrada quando falta dado (repo sem runs, sem workspace db).
11
+ */
12
+ import fs from 'node:fs';
13
+ import path from 'node:path';
14
+ import { fileURLToPath } from 'node:url';
15
+ import { COMMANDS } from "./core/registry.js";
16
+ import { auditSummary, lastExit, defaultEnv as auditEnv } from "./audit.js";
17
+ const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
18
+ const STATUS_RE = /-\s*\*\*Status\*\*:\s*([a-z]+)/i;
19
+ const NUCLEO = ['native-abi', 'memory-db', 'memory-fresh', 'workspace', 'node-engines', 'runtime-deps', 'mcp-json'];
20
+ const DOC = ['docs-commands', 'commands-documented', 'docs-links'];
21
+ function readStatus(env, file) {
22
+ try {
23
+ const m = env.fs.readFileSync(file, 'utf8').match(STATUS_RE);
24
+ return m ? m[1].toLowerCase() : null;
25
+ }
26
+ catch {
27
+ return null;
28
+ }
29
+ }
30
+ function collectSpecs(env) {
31
+ const dir = path.join(env.root, 'specs');
32
+ let entries = [];
33
+ try {
34
+ entries = env.fs.readdirSync(dir);
35
+ }
36
+ catch {
37
+ return [];
38
+ }
39
+ const out = [];
40
+ for (const slug of entries) {
41
+ if (slug.startsWith('_') || slug.startsWith('.'))
42
+ continue;
43
+ const spec = readStatus(env, path.join(dir, slug, 'spec.md'));
44
+ if (!spec)
45
+ continue;
46
+ out.push({
47
+ slug,
48
+ spec,
49
+ plan: readStatus(env, path.join(dir, slug, 'plan.md')),
50
+ tasks: readStatus(env, path.join(dir, slug, 'tasks.md')),
51
+ });
52
+ }
53
+ return out;
54
+ }
55
+ function countAdrs(env) {
56
+ try {
57
+ return env.fs
58
+ .readdirSync(path.join(env.root, 'memory', '90-decisions'))
59
+ .filter((f) => /^\d{4}-.*\.md$/.test(f)).length;
60
+ }
61
+ catch {
62
+ return 0;
63
+ }
64
+ }
65
+ async function collectGates(env) {
66
+ // Importa os catálogos como dados. Cada check: { id, title, severity }.
67
+ const [{ CHECKS }, { RELEASE_CHECKS }] = await Promise.all([
68
+ import("./core/health.js"),
69
+ import("./core/release.js"),
70
+ ]);
71
+ const pick = (ids) => CHECKS.filter((c) => ids.includes(c.id)).map((c) => ({ id: c.id, severity: c.severity }));
72
+ // Estado = último exit do comando na auditoria (não reexecuta — D4). Degrada para "?" sem audit.
73
+ const exitOf = async (cmd) => {
74
+ try {
75
+ const r = await lastExit(auditEnv(), cmd);
76
+ return r ? (r.exitCode === 0 ? 'pass' : 'fail') : 'unknown';
77
+ }
78
+ catch {
79
+ return 'unknown';
80
+ }
81
+ };
82
+ return [
83
+ { name: 'núcleo', cmd: 'tools:doctor', adr: 'ADR-0023', state: await exitOf('tools:doctor'), checks: pick(NUCLEO) },
84
+ { name: 'documentação', cmd: 'tools:doctor', adr: 'ADR-0025', state: await exitOf('tools:doctor'), checks: pick(DOC) },
85
+ { name: 'tarball', cmd: 'release:check', adr: 'ADR-0024', state: await exitOf('release:check'), checks: RELEASE_CHECKS.map((c) => ({ id: c.id, severity: c.severity })) },
86
+ ];
87
+ }
88
+ async function collectAudit() {
89
+ try {
90
+ return await auditSummary(auditEnv());
91
+ }
92
+ catch {
93
+ return null; // sem workspace/db — o painel mostra "sem atividade", não quebra (AC-5/AC-6)
94
+ }
95
+ }
96
+ /** @param {{ root?: string, fs?: typeof fs }} [env] */
97
+ export async function collect(env = {}) {
98
+ const e = { root: env.root ?? repoRoot, fs: env.fs ?? fs };
99
+ const specs = collectSpecs(e);
100
+ const adrs = countAdrs(e);
101
+ return {
102
+ generatedAt: new Date().toISOString(),
103
+ metrics: { commands: Object.keys(COMMANDS).length, specs: specs.length, adrs },
104
+ gates: await collectGates(e),
105
+ specs,
106
+ audit: await collectAudit(),
107
+ };
108
+ }
109
+ // ---------------------------------------------------------------------------
110
+ // render — string HTML self-contained (CSS inline, zero asset externo)
111
+ // ---------------------------------------------------------------------------
112
+ const esc = (s) => String(s).replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
113
+ function stageCell(v) {
114
+ if (!v || v === null)
115
+ return '<td class="st na">—</td>';
116
+ return `<td class="st ${esc(v)}">${esc(v)}</td>`;
117
+ }
118
+ /** @param {Awaited<ReturnType<typeof collect>>} d */
119
+ export function renderHtml(d) {
120
+ const gateCards = d.gates.map((g) => {
121
+ const state = g.state === 'pass' ? 'PASS' : g.state === 'fail' ? 'FAIL' : '—';
122
+ const checks = g.checks.map((c) => `<li><span class="cid">${esc(c.id)}</span><span class="sev ${esc(c.severity)}">${esc(c.severity)}</span></li>`).join('');
123
+ return `<div class="gate ${esc(g.state)}"><div class="gh"><span class="gn">${esc(g.name)}</span><span class="gs">${state}</span></div><div class="gc">${esc(g.cmd)} · ${esc(g.adr)}</div><ul>${checks}</ul></div>`;
124
+ }).join('');
125
+ const specRows = d.specs.map((s) => `<tr><td class="slug">${esc(s.slug)}</td>${stageCell(s.spec)}${stageCell(s.plan)}${stageCell(s.tasks)}</tr>`).join('');
126
+ const audit = d.audit;
127
+ const auditBlock = audit && audit.total
128
+ ? `<div class="ametrics"><div><b>${audit.total}</b><span>runs auditados</span></div><div><b>${audit.fails}</b><span>reprovações</span></div></div>
129
+ <table class="board"><thead><tr><th>comando</th><th>runs</th><th>falhas</th><th>média</th></tr></thead><tbody>
130
+ ${audit.byCmd.slice(0, 8).map((c) => `<tr><td class="slug">${esc(c.cmd)}</td><td class="num">${c.runs}</td><td class="num ${c.fails ? 'bad' : ''}">${c.fails}</td><td class="num">${c.avgMs ?? '—'}ms</td></tr>`).join('')}
131
+ </tbody></table>`
132
+ : `<p class="empty">Sem atividade registrada ainda. A trilha nasce em <code>.context/forja-runs.jsonl</code> conforme você usa o <code>forja</code>. Rode <code>forja audit:sync</code>.</p>`;
133
+ return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Forja · Governança</title><style>
134
+ :root{--bg:#eceef1;--panel:#fff;--panel2:#f5f6f9;--line:#dcdfe6;--ink:#191d24;--dim:#59626f;--faint:#8b93a0;--ember:#cf5a12;--good:#2b8a3e;--goodbg:#e5f3e8;--warn:#9a6a10;--warnbg:#f6ecd6;--crit:#c22f2f;--critbg:#f6dede;--mono:ui-monospace,"SF Mono",Menlo,monospace;--sans:system-ui,-apple-system,sans-serif}
135
+ @media(prefers-color-scheme:dark){:root{--bg:#101318;--panel:#181c22;--panel2:#1e232b;--line:#2a303a;--ink:#e6e9ee;--dim:#98a1ad;--faint:#69727e;--ember:#ff7a3c;--good:#46b45a;--goodbg:#16301c;--warn:#d1a02a;--warnbg:#302713;--crit:#f0564a;--critbg:#331917}}
136
+ *{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.5}
137
+ .wrap{max-width:1000px;margin:0 auto;padding:30px 20px 60px}
138
+ header{display:flex;align-items:baseline;gap:14px;flex-wrap:wrap;border-bottom:1px solid var(--line);padding-bottom:18px}
139
+ .mark{font-family:var(--mono);font-weight:600;font-size:23px}.mark b{color:var(--ember)}
140
+ .sub{color:var(--dim);font-size:13px}.gen{margin-left:auto;color:var(--faint);font-family:var(--mono);font-size:11.5px}
141
+ .metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:1px;background:var(--line);border:1px solid var(--line);border-radius:12px;overflow:hidden;margin:22px 0 34px}
142
+ .metrics div{background:var(--panel);padding:14px 16px}.metrics b{font-family:var(--mono);font-size:25px;font-weight:600}.metrics span{display:block;color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.05em;margin-top:2px}
143
+ h2{font-size:19px;margin:34px 0 4px;letter-spacing:-.2px}.eye{font-family:var(--mono);font-size:11px;text-transform:uppercase;letter-spacing:.12em;color:var(--ember)}
144
+ .lede{color:var(--dim);font-size:13.5px;margin:0 0 18px}
145
+ .gates{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
146
+ .gate{background:var(--panel);border:1px solid var(--line);border-radius:13px;overflow:hidden}
147
+ .gh{display:flex;align-items:center;gap:8px;padding:13px 15px 10px;border-bottom:1px solid var(--line)}
148
+ .gn{font-family:var(--mono);font-weight:600;font-size:14px}.gs{margin-left:auto;font-family:var(--mono);font-size:10px;font-weight:700;letter-spacing:.05em}
149
+ .gate.pass .gs{color:var(--good)}.gate.fail .gs{color:var(--crit)}.gate.unknown .gs{color:var(--faint)}
150
+ .gc{font-family:var(--mono);font-size:11px;color:var(--faint);padding:8px 15px 2px}
151
+ .gate ul{list-style:none;margin:0;padding:6px 8px 10px}.gate li{display:flex;align-items:center;gap:8px;padding:5px 7px;font-size:12.5px}
152
+ .cid{font-family:var(--mono);font-size:12px}.sev{margin-left:auto;font-family:var(--mono);font-size:9px;font-weight:700;padding:2px 6px;border-radius:5px;text-transform:uppercase}
153
+ .sev.critical{color:var(--crit);background:var(--critbg)}.sev.warn{color:var(--warn);background:var(--warnbg)}
154
+ .board{width:100%;border-collapse:collapse;background:var(--panel);border:1px solid var(--line);border-radius:12px;overflow:hidden}
155
+ .board th,.board td{text-align:left;padding:10px 15px;border-bottom:1px solid var(--line);font-size:13px}
156
+ .board thead th{font-family:var(--mono);font-size:10.5px;text-transform:uppercase;letter-spacing:.07em;color:var(--faint);background:var(--panel2)}
157
+ .board tbody tr:last-child td{border-bottom:none}.slug{font-family:var(--mono);font-size:12.5px}.num{font-family:var(--mono);text-align:right;font-variant-numeric:tabular-nums}.num.bad{color:var(--crit)}
158
+ .st{font-family:var(--mono);font-size:11px;font-weight:600}.st.done{color:var(--good)}.st.approved{color:#2f6f9e}.st.abandoned{color:var(--faint);text-decoration:line-through}.st.na{color:var(--faint)}
159
+ .ametrics{display:flex;gap:24px;margin-bottom:14px}.ametrics b{font-family:var(--mono);font-size:22px}.ametrics span{color:var(--dim);font-size:12px;margin-left:6px}
160
+ .empty{color:var(--dim);font-size:13.5px;background:var(--panel);border:1px dashed var(--line);border-radius:12px;padding:18px}code{font-family:var(--mono);font-size:.9em}
161
+ footer{margin-top:40px;padding-top:18px;border-top:1px solid var(--line);color:var(--faint);font-size:12px;display:flex;flex-wrap:wrap;gap:6px 16px}
162
+ </style></head><body><div class="wrap">
163
+ <header><span class="mark">for<b>j</b>a</span><span class="sub">painel de governança</span><span class="gen">gerado ${esc(d.generatedAt.slice(0, 16).replace('T', ' '))}</span></header>
164
+ <div class="metrics"><div><b>${d.metrics.commands}</b><span>comandos</span></div><div><b>${d.metrics.specs}</b><span>specs</span></div><div><b>${d.metrics.adrs}</b><span>ADRs</span></div></div>
165
+ <div class="eye">o motor</div><h2>Gates de invariante</h2><p class="lede">Estado do último run de cada gate na auditoria — sem reexecutar.</p><div class="gates">${gateCards}</div>
166
+ <div class="eye">o processo</div><h2>Pipeline SDD</h2><p class="lede">O estado real das features, do <code>spec:check</code>.</p><table class="board"><thead><tr><th>feature</th><th>spec</th><th>plan</th><th>tasks</th></tr></thead><tbody>${specRows}</tbody></table>
167
+ <div class="eye">a atividade</div><h2>Auditoria</h2><p class="lede">A trilha <code>.context/forja-runs.jsonl</code>, consultável.</p>${auditBlock}
168
+ <footer><span>Artefato <b>gerado</b>, não servido — leitura, nunca execução (ADR-0022).</span><span style="margin-left:auto" class="slug">forja governance:dashboard</span></footer>
169
+ </div></body></html>`;
170
+ }
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,126 @@
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
+ import { spawnSync } from 'node:child_process';
15
+ function runCodegraph(args) {
16
+ const result = spawnSync('codegraph', args, { encoding: 'utf8' });
17
+ if (result.error && /** @type {any} */ (result.error).code === 'ENOENT')
18
+ return { missing: true };
19
+ return {
20
+ missing: false,
21
+ status: result.status ?? 1,
22
+ stdout: (result.stdout || '').trim(),
23
+ stderr: (result.stderr || '').trim(),
24
+ };
25
+ }
26
+ function codegraphStatus() {
27
+ const res = runCodegraph(['status', '--json']);
28
+ if (res.missing)
29
+ return { missing: true };
30
+ let data = null;
31
+ try {
32
+ data = JSON.parse(/** @type {string} */ (res.stdout));
33
+ }
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
+ function fail(msg) {
49
+ console.error(msg);
50
+ process.exit(1);
51
+ }
52
+ function cmdCheck() {
53
+ const s = codegraphStatus();
54
+ if (s.missing) {
55
+ console.log('Codegraph nao instalado no PATH. Code intelligence ignorado.');
56
+ console.log('Instale com: npm i -g @codegraph/cli');
57
+ process.exit(0);
58
+ }
59
+ if (s.parseError) {
60
+ console.log('Codegraph respondeu, mas status --json nao pode ser lido.');
61
+ fail(s.raw || 'sem saida');
62
+ }
63
+ const lines = [];
64
+ let blocking = false;
65
+ if (!s.initialized) {
66
+ blocking = true;
67
+ lines.push('FAIL indice ausente: rode `npm run code:index`.');
68
+ }
69
+ else {
70
+ lines.push(`OK indice inicializado (${s.fileCount} arquivos).`);
71
+ }
72
+ if (s.worktreeMismatch) {
73
+ blocking = true;
74
+ lines.push(`FAIL indice de outro worktree: ${s.worktreeMismatch}. Rode \`codegraph init -i\`.`);
75
+ }
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
+ }
82
+ else if (s.initialized) {
83
+ lines.push('OK indice em dia.');
84
+ }
85
+ console.log('Codegraph check:\n');
86
+ for (const line of lines)
87
+ console.log(line);
88
+ if (blocking)
89
+ fail('\nResultado: gate de code intelligence reprovado.');
90
+ console.log('\nResultado: code intelligence confiavel.');
91
+ }
92
+ function cmdImpact(symbol, depthArg) {
93
+ if (!symbol)
94
+ fail('Uso: code-intel impact <simbolo> [profundidade]');
95
+ const probe = runCodegraph(['status', '--json']);
96
+ if (probe.missing) {
97
+ console.log('Codegraph nao instalado. Sem mapa de impacto automatico.');
98
+ console.log(`Fallback manual: grep -rn "${symbol}" . e leia os chamadores.`);
99
+ process.exit(0);
100
+ }
101
+ const depth = String(parseInt(depthArg, 10) || 2);
102
+ console.log(`Mapa de impacto: ${symbol} (profundidade ${depth})\n`);
103
+ const impact = runCodegraph(['impact', symbol, '-d', depth]);
104
+ if (impact.stdout)
105
+ console.log(impact.stdout);
106
+ const callers = runCodegraph(['callers', symbol]);
107
+ if (callers.stdout) {
108
+ console.log('\n--- Chamadores diretos ---');
109
+ console.log(callers.stdout);
110
+ }
111
+ if (!impact.stdout && !callers.stdout) {
112
+ console.log('Nenhum no encontrado. Confirme o nome ou rode `npm run code:sync`.');
113
+ }
114
+ }
115
+ const [cmd, ...rest] = process.argv.slice(2);
116
+ switch (cmd) {
117
+ case 'check':
118
+ cmdCheck();
119
+ break;
120
+ case 'impact':
121
+ cmdImpact(rest[0], rest[1]);
122
+ break;
123
+ default:
124
+ console.log('Uso: node scripts/code-intel.mjs <check|impact> [args]');
125
+ process.exit(cmd ? 1 : 0);
126
+ }