forjajs 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +25 -0
  3. package/README.en.md +5 -0
  4. package/README.md +5 -0
  5. package/dist/bin/create-memory-nest-kit.d.ts +2 -0
  6. package/dist/bin/create-memory-nest-kit.js +110 -0
  7. package/dist/bin/forja.d.ts +13 -0
  8. package/dist/bin/forja.js +136 -0
  9. package/dist/bin/init-project.d.ts +2 -0
  10. package/dist/bin/init-project.js +516 -0
  11. package/dist/lib/audit.d.ts +67 -0
  12. package/dist/lib/audit.js +143 -0
  13. package/dist/lib/context-builder.d.ts +58 -0
  14. package/dist/lib/context-builder.js +233 -0
  15. package/dist/lib/core/checks.d.ts +91 -0
  16. package/dist/lib/core/checks.js +119 -0
  17. package/dist/lib/core/doc-graph.d.ts +60 -0
  18. package/dist/lib/core/doc-graph.js +235 -0
  19. package/dist/lib/core/health.d.ts +103 -0
  20. package/dist/lib/core/health.js +538 -0
  21. package/dist/lib/core/registry.d.ts +296 -0
  22. package/dist/lib/core/registry.js +317 -0
  23. package/dist/lib/core/release.d.ts +334 -0
  24. package/dist/lib/core/release.js +465 -0
  25. package/dist/lib/generators/memory-generator.d.ts +83 -0
  26. package/{lib → dist/lib}/generators/memory-generator.js +107 -178
  27. package/dist/lib/generators/nest-generator.d.ts +15 -0
  28. package/{lib → dist/lib}/generators/nest-generator.js +47 -71
  29. package/dist/lib/generators/readme-generator.d.ts +15 -0
  30. package/{lib → dist/lib}/generators/readme-generator.js +9 -14
  31. package/dist/lib/governance-report.d.ts +49 -0
  32. package/dist/lib/governance-report.js +170 -0
  33. package/dist/lib/templates/harness/code-intel.d.mts +2 -0
  34. package/dist/lib/templates/harness/code-intel.mjs +126 -0
  35. package/dist/lib/utils/file-helpers.d.ts +9 -0
  36. package/dist/lib/utils/file-helpers.js +34 -0
  37. package/dist/lib/validators/structure-validator.d.ts +48 -0
  38. package/dist/lib/validators/structure-validator.js +232 -0
  39. package/dist/lib/workspace.d.ts +40 -0
  40. package/dist/lib/workspace.js +174 -0
  41. package/dist/scripts/agent-harness.d.ts +2 -0
  42. package/dist/scripts/agent-harness.js +556 -0
  43. package/dist/scripts/agent-router.d.ts +30 -0
  44. package/dist/scripts/agent-router.js +208 -0
  45. package/dist/scripts/audit-query.d.ts +2 -0
  46. package/dist/scripts/audit-query.js +43 -0
  47. package/dist/scripts/audit-sync.d.ts +2 -0
  48. package/dist/scripts/audit-sync.js +19 -0
  49. package/dist/scripts/build-smart-context.d.ts +1 -0
  50. package/dist/scripts/build-smart-context.js +75 -0
  51. package/dist/scripts/check-standards.d.ts +1 -0
  52. package/dist/scripts/check-standards.js +87 -0
  53. package/dist/scripts/compress-memory.d.ts +16 -0
  54. package/dist/scripts/compress-memory.js +157 -0
  55. package/dist/scripts/compress-project-memory.d.ts +1 -0
  56. package/dist/scripts/compress-project-memory.js +48 -0
  57. package/dist/scripts/context-ops.d.ts +2 -0
  58. package/dist/scripts/context-ops.js +464 -0
  59. package/dist/scripts/dev.d.ts +96 -0
  60. package/dist/scripts/dev.js +312 -0
  61. package/dist/scripts/extract-global-knowledge.d.ts +1 -0
  62. package/dist/scripts/extract-global-knowledge.js +43 -0
  63. package/dist/scripts/generate-dashboard.d.ts +1 -0
  64. package/dist/scripts/generate-dashboard.js +48 -0
  65. package/dist/scripts/governance-dashboard.d.ts +2 -0
  66. package/dist/scripts/governance-dashboard.js +36 -0
  67. package/dist/scripts/hook-guard-paths.d.ts +17 -0
  68. package/dist/scripts/hook-guard-paths.js +68 -0
  69. package/dist/scripts/hook-post-edit.d.ts +20 -0
  70. package/dist/scripts/hook-post-edit.js +70 -0
  71. package/dist/scripts/hook-session-start.d.ts +17 -0
  72. package/dist/scripts/hook-session-start.js +108 -0
  73. package/dist/scripts/hook-user-prompt.d.ts +22 -0
  74. package/dist/scripts/hook-user-prompt.js +193 -0
  75. package/dist/scripts/memory-schema.d.ts +6 -0
  76. package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
  77. package/dist/scripts/query-universal-memory.d.ts +1 -0
  78. package/dist/scripts/query-universal-memory.js +44 -0
  79. package/dist/scripts/release-check.d.ts +14 -0
  80. package/dist/scripts/release-check.js +48 -0
  81. package/dist/scripts/spec-cli.d.ts +29 -0
  82. package/dist/scripts/spec-cli.js +261 -0
  83. package/dist/scripts/sprint-manager.d.ts +1 -0
  84. package/dist/scripts/sprint-manager.js +187 -0
  85. package/dist/scripts/sync-universal-memory.d.ts +1 -0
  86. package/dist/scripts/sync-universal-memory.js +277 -0
  87. package/dist/scripts/token-benchmark.d.ts +20 -0
  88. package/dist/scripts/token-benchmark.js +181 -0
  89. package/dist/scripts/tools-doctor.d.ts +20 -0
  90. package/dist/scripts/tools-doctor.js +120 -0
  91. package/memory/90-decisions/0028-governanca-visivel.md +84 -0
  92. package/package.json +54 -56
  93. package/specs/governanca-visivel/plan.md +122 -0
  94. package/specs/governanca-visivel/spec.md +112 -0
  95. package/specs/governanca-visivel/tasks.md +60 -0
  96. package/specs/ts-migration/plan.md +24 -13
  97. package/bin/create-memory-nest-kit.js +0 -125
  98. package/bin/forja.mjs +0 -143
  99. package/bin/init-project.js +0 -612
  100. package/lib/context-builder.js +0 -257
  101. package/lib/core/checks.mjs +0 -155
  102. package/lib/core/doc-graph.mjs +0 -231
  103. package/lib/core/health.mjs +0 -577
  104. package/lib/core/registry.mjs +0 -312
  105. package/lib/core/release.mjs +0 -492
  106. package/lib/templates/harness/code-intel.mjs +0 -119
  107. package/lib/templates/harness/mcp.json +0 -10
  108. package/lib/utils/file-helpers.js +0 -40
  109. package/lib/validators/structure-validator.js +0 -253
  110. package/lib/workspace.mjs +0 -213
  111. package/scripts/agent-harness.mjs +0 -580
  112. package/scripts/agent-router.mjs +0 -189
  113. package/scripts/build-smart-context.js +0 -87
  114. package/scripts/check-standards.js +0 -98
  115. package/scripts/compress-memory.mjs +0 -198
  116. package/scripts/compress-project-memory.js +0 -58
  117. package/scripts/context-ops.mjs +0 -466
  118. package/scripts/dev.mjs +0 -349
  119. package/scripts/extract-global-knowledge.js +0 -52
  120. package/scripts/generate-dashboard.js +0 -59
  121. package/scripts/hook-guard-paths.mjs +0 -76
  122. package/scripts/hook-post-edit.mjs +0 -79
  123. package/scripts/hook-session-start.mjs +0 -104
  124. package/scripts/hook-user-prompt.mjs +0 -185
  125. package/scripts/pre-commit.sh +0 -102
  126. package/scripts/query-universal-memory.js +0 -50
  127. package/scripts/release-check.mjs +0 -56
  128. package/scripts/spec-cli.mjs +0 -261
  129. package/scripts/sprint-manager.js +0 -200
  130. package/scripts/sync-universal-memory.js +0 -286
  131. package/scripts/token-benchmark.mjs +0 -203
  132. package/scripts/tools-doctor.mjs +0 -132
@@ -0,0 +1,516 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * init-project.js
4
+ *
5
+ * Comando universal para inicializar novo projeto com agentes orquestrados.
6
+ * Puxa configuração de Copilot, Claude, Gemini, Codex e outros.
7
+ *
8
+ * Uso:
9
+ * node bin/init-project.js meu-projeto
10
+ * node bin/init-project.js meu-projeto --ai copilot,claude,gemini
11
+ * node bin/init-project.js meu-projeto --skip-backend
12
+ * node bin/init-project.js --interactive
13
+ */
14
+ import fs from 'node:fs';
15
+ import path from 'node:path';
16
+ import process from 'node:process';
17
+ import { execSync } from 'node:child_process';
18
+ import { fileURLToPath } from 'node:url';
19
+ import { getWorkspaceRoot, getProjectsDir, resolveProject, initWorkspace, getWorkspaceProjectsMemoryDir, assertOutsideFrameworkRepo, } from "../lib/workspace.js";
20
+ const __filename = fileURLToPath(import.meta.url);
21
+ const __dirname = path.dirname(__filename);
22
+ const kitRoot = path.resolve(__dirname, '..');
23
+ // ============================================================================
24
+ // CONFIGURAÇÃO
25
+ // ============================================================================
26
+ const DEFAULT_AI_AGENTS = ['copilot', 'claude', 'gemini', 'codex'];
27
+ // Conteúdo canônico único (ADR-0020): toda IA recebe a mesma explicação da
28
+ // estrutura Forja; só o cabeçalho muda. CLAUDE.md do framework NÃO é copiado —
29
+ // ele descreve o repo do motor, não o projeto gerado.
30
+ const CANONICAL_INSTRUCTIONS = '.gemini-instructions.md';
31
+ const AI_LABELS = {
32
+ copilot: 'GitHub Copilot',
33
+ claude: 'Claude',
34
+ gemini: 'Gemini',
35
+ codex: 'OpenAI Codex',
36
+ };
37
+ const SETUP_CHECKLIST = [
38
+ '00-git-init',
39
+ '01-generate-structure',
40
+ '01b-copy-design-library',
41
+ '01c-emit-harness',
42
+ '02-copy-instructions',
43
+ '03-install-backend',
44
+ '04-init-memory-db',
45
+ '05-build-context-pack',
46
+ '06-universal-memory-sync',
47
+ '07-show-next-steps',
48
+ ];
49
+ // ============================================================================
50
+ // HELPERS
51
+ // ============================================================================
52
+ function log(msg, level = 'info') {
53
+ const prefix = {
54
+ info: '📌',
55
+ success: '✅',
56
+ warn: '⚠️',
57
+ error: '❌',
58
+ step: '🔄',
59
+ done: '✨',
60
+ }[level] || '→';
61
+ console.log(`${prefix} ${msg}`);
62
+ }
63
+ function logSection(title) {
64
+ console.log(`\n${'═'.repeat(80)}`);
65
+ console.log(` ${title}`);
66
+ console.log(`${'═'.repeat(80)}\n`);
67
+ }
68
+ function execCmd(cmd, opts = {}) {
69
+ try {
70
+ return execSync(cmd, {
71
+ stdio: opts.quiet ? 'pipe' : 'inherit',
72
+ ...opts
73
+ });
74
+ }
75
+ catch (err) {
76
+ if (!opts.ignoreError) {
77
+ log(`Comando falhou: ${cmd}`, 'error');
78
+ throw err;
79
+ }
80
+ }
81
+ }
82
+ function ensureDir(dir) {
83
+ if (!fs.existsSync(dir)) {
84
+ fs.mkdirSync(dir, { recursive: true });
85
+ }
86
+ }
87
+ function copyFile(src, dest) {
88
+ const content = fs.readFileSync(src, 'utf-8');
89
+ fs.writeFileSync(dest, content, 'utf-8');
90
+ }
91
+ function copyFileIfExists(src, dest) {
92
+ if (fs.existsSync(src)) {
93
+ copyFile(src, dest);
94
+ return true;
95
+ }
96
+ return false;
97
+ }
98
+ function copyDir(src, dest) {
99
+ ensureDir(dest);
100
+ const entries = fs.readdirSync(src, { withFileTypes: true });
101
+ for (const entry of entries) {
102
+ const srcPath = path.join(src, entry.name);
103
+ const destPath = path.join(dest, entry.name);
104
+ if (entry.isDirectory()) {
105
+ copyDir(srcPath, destPath);
106
+ }
107
+ else {
108
+ fs.copyFileSync(srcPath, destPath);
109
+ }
110
+ }
111
+ }
112
+ // ============================================================================
113
+ // PARSEARGS
114
+ // ============================================================================
115
+ function parseArgs() {
116
+ const args = process.argv.slice(2);
117
+ const opts = {
118
+ interactive: args.includes('--interactive'),
119
+ skipBackend: args.includes('--skip-backend'),
120
+ skipDb: args.includes('--skip-db'),
121
+ skipGit: args.includes('--skip-git'),
122
+ skipDesign: args.includes('--skip-design'),
123
+ ai: DEFAULT_AI_AGENTS,
124
+ verbose: args.includes('--verbose'),
125
+ };
126
+ // Parse --ai flag
127
+ const aiIdx = args.findIndex(a => a === '--ai');
128
+ if (aiIdx >= 0 && aiIdx + 1 < args.length) {
129
+ opts.ai = args[aiIdx + 1].split(',').map(s => s.trim());
130
+ }
131
+ // Project name (primeiro arg sem --)
132
+ const projectName = args.find(a => !a.startsWith('--'));
133
+ // Projetos de produto vivem obrigatoriamente no workspace externo.
134
+ // init-project nao aceita mais path customizado para evitar poluicao do repo do framework.
135
+ const projectDir = projectName ? resolveProject(projectName) : null;
136
+ return { projectName, projectPath: projectDir, opts };
137
+ }
138
+ // ============================================================================
139
+ // SETUP STEPS
140
+ // ============================================================================
141
+ async function step00GitInit(projectDir, opts) {
142
+ if (opts.skipGit)
143
+ return;
144
+ log('Preparando diretório...', 'step');
145
+ ensureDir(projectDir);
146
+ // Se for um sub-projeto dentro do repo principal, talvez não queira git init
147
+ // Mas se for independente, git init faz sentido.
148
+ // Como o usuário quer ignorar a pasta projects/, podemos opcionalmente dar git init.
149
+ if (!fs.existsSync(path.join(projectDir, '.git'))) {
150
+ try {
151
+ execCmd(`cd "${projectDir}" && git init`, { quiet: true });
152
+ // Criar .gitignore se não existir
153
+ const gitignore = path.join(projectDir, '.gitignore');
154
+ if (!fs.existsSync(gitignore)) {
155
+ fs.writeFileSync(gitignore, `node_modules/\n.env\n.env.local\ndist/\n.DS_Store\n.context/\n.memory/\n`);
156
+ }
157
+ log('Git repository inicializado no projeto', 'success');
158
+ }
159
+ catch (e) {
160
+ log('Aviso: falha ao rodar git init (talvez diretório já em repo git)', 'warn');
161
+ }
162
+ }
163
+ }
164
+ async function step01GenerateStructure(projectDir, opts) {
165
+ log('Gerando estrutura de agentes e memória...', 'step');
166
+ // Verifica se já existe código (ex: backend) para decidir se usa --only-memory
167
+ const hasBackend = fs.existsSync(path.join(projectDir, 'backend')) || fs.existsSync(path.join(projectDir, 'package.json'));
168
+ const onlyMemory = hasBackend ? '--only-memory' : '';
169
+ const cmd = opts.skipBackend
170
+ ? `node "${path.join(kitRoot, 'bin/create-memory-nest-kit.js')}" "${projectDir}" --only-memory --force`
171
+ : `node "${path.join(kitRoot, 'bin/create-memory-nest-kit.js')}" "${projectDir}" ${onlyMemory} --force`;
172
+ try {
173
+ execCmd(cmd);
174
+ log('Estrutura gerada com sucesso', 'success');
175
+ // Adicionar camadas extras de escalonamento e growth
176
+ addScalingLayers(projectDir);
177
+ }
178
+ catch (err) {
179
+ log('Erro ao gerar estrutura', 'error');
180
+ throw err;
181
+ }
182
+ }
183
+ function addScalingLayers(projectDir) {
184
+ const memoryDir = path.join(projectDir, 'memory');
185
+ const layers = {
186
+ '10-product/growth/vision.md': '# Estratégia de Growth\n\nDescreva como o produto irá crescer e atrair novos usuários.',
187
+ '10-product/scaling/strategy.md': '# Estratégia de Escalonamento de Produto\n\nDescreva como o produto irá suportar o aumento de carga e usuários.',
188
+ '20-architecture/scaling-patterns.md': '# Padrões de Escalonamento Arquitetural\n\n- Cache\n- Filas\n- Microsserviços\n- Otimização de Queries',
189
+ };
190
+ for (const [rel, content] of Object.entries(layers)) {
191
+ const abs = path.join(memoryDir, rel);
192
+ ensureDir(path.dirname(abs));
193
+ if (!fs.existsSync(abs)) {
194
+ fs.writeFileSync(abs, content, 'utf8');
195
+ }
196
+ }
197
+ log('Camadas de Growth e Scaling adicionadas', 'success');
198
+ }
199
+ async function step01bCopyDesignLibrary(projectDir, opts) {
200
+ if (opts.skipDesign) {
201
+ log('Skipping design library copy (--skip-design)', 'warn');
202
+ return;
203
+ }
204
+ const srcDesignDir = path.join(kitRoot, 'design-md');
205
+ const destDesignDir = path.join(projectDir, 'design-md');
206
+ if (!fs.existsSync(srcDesignDir)) {
207
+ log('Biblioteca de design não encontrada no kit root', 'warn');
208
+ return;
209
+ }
210
+ log('Copiando biblioteca de referências de design (design-md)...', 'step');
211
+ try {
212
+ copyDir(srcDesignDir, destDesignDir);
213
+ log('Biblioteca design-md copiada para o projeto', 'success');
214
+ }
215
+ catch (err) {
216
+ log('Erro ao copiar biblioteca de design', 'error');
217
+ if (opts.verbose)
218
+ console.error(err);
219
+ }
220
+ }
221
+ // Camada de code intelligence + ferramentas de processo (ADR-0017, ADR-0018).
222
+ // Cada projeto gerado herda codegraph (MCP) + scripts code:* + tools:doctor,
223
+ // de forma auto-contida (so dependem do binario codegraph, opcional).
224
+ const HARNESS_SCRIPTS = {
225
+ 'code:index': 'codegraph init',
226
+ 'code:sync': 'codegraph sync',
227
+ 'code:status': 'codegraph status',
228
+ 'code:query': 'codegraph query',
229
+ 'code:check': 'node scripts/code-intel.mjs check',
230
+ 'code:impact': 'node scripts/code-intel.mjs impact',
231
+ 'tools:doctor': 'node scripts/tools-doctor.mjs',
232
+ };
233
+ async function step01cEmitHarness(projectDir, opts) {
234
+ log('Emitindo harness de code intelligence (codegraph + tools)...', 'step');
235
+ // 1. .mcp.json (codegraph) — aditivo, nao sobrescreve config existente
236
+ const mcpDest = path.join(projectDir, '.mcp.json');
237
+ const mcpSrc = path.join(kitRoot, 'lib/templates/harness/mcp.json');
238
+ if (!fs.existsSync(mcpDest)) {
239
+ copyFileIfExists(mcpSrc, mcpDest);
240
+ }
241
+ // 2. scripts auto-contidos
242
+ const scriptsDir = path.join(projectDir, 'scripts');
243
+ ensureDir(scriptsDir);
244
+ copyFileIfExists(path.join(kitRoot, 'lib/templates/harness/code-intel.mjs'), path.join(scriptsDir, 'code-intel.mjs'));
245
+ copyFileIfExists(path.join(kitRoot, 'scripts/tools-doctor.mjs'), path.join(scriptsDir, 'tools-doctor.mjs'));
246
+ // 3. merge dos scripts no package.json (cria minimo se ausente)
247
+ const pkgPath = path.join(projectDir, 'package.json');
248
+ let pkg;
249
+ if (fs.existsSync(pkgPath)) {
250
+ try {
251
+ pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
252
+ }
253
+ catch {
254
+ log('package.json ilegivel; harness scripts nao injetados', 'warn');
255
+ return;
256
+ }
257
+ }
258
+ else {
259
+ pkg = { name: path.basename(projectDir), version: '0.1.0', type: 'module', scripts: {} };
260
+ }
261
+ pkg.scripts = pkg.scripts || {};
262
+ for (const [key, value] of Object.entries(HARNESS_SCRIPTS)) {
263
+ if (!pkg.scripts[key])
264
+ pkg.scripts[key] = value;
265
+ }
266
+ fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
267
+ log('Harness emitido: .mcp.json + code:* + tools:doctor', 'success');
268
+ }
269
+ async function step02CopyInstructions(projectDir, opts) {
270
+ log('Copiando instruções para IAs...', 'step');
271
+ const instructionsDir = path.join(projectDir, '.ia-instructions');
272
+ ensureDir(instructionsDir);
273
+ const canonicalPath = path.join(kitRoot, CANONICAL_INSTRUCTIONS);
274
+ let canonical = null;
275
+ if (fs.existsSync(canonicalPath)) {
276
+ canonical = fs.readFileSync(canonicalPath, 'utf8');
277
+ }
278
+ let copied = 0;
279
+ for (const ai of opts.ai) {
280
+ const label = AI_LABELS[ai];
281
+ if (!label || !canonical) {
282
+ log(`${ai.toUpperCase()}: não encontrado`, 'warn');
283
+ continue;
284
+ }
285
+ const others = Object.entries(AI_LABELS)
286
+ .filter(([key]) => key !== ai)
287
+ .map(([, name]) => name);
288
+ const content = canonical
289
+ .replace(/^# Instruções para .+ — Forja$/m, `# Instruções para ${label} — Forja`)
290
+ .replace(/^> Guia para .+ multi-IA por design\.$/m, `> Guia para ${label} operar a Forja. O conteúdo é o mesmo para ${others.slice(0, -1).join(', ')} e ${others.at(-1)} — a Forja é multi-IA por design.`);
291
+ fs.writeFileSync(path.join(instructionsDir, `${ai}.md`), content, 'utf8');
292
+ log(`${ai.toUpperCase()}: ✓`, 'success');
293
+ copied++;
294
+ }
295
+ // Criar INDEX
296
+ const indexContent = `# IA Assistants Configuration
297
+
298
+ Este diretório contém instruções específicas para cada IA assistant.
299
+
300
+ ## Gestão de Cotas & Alternância
301
+ Para trocar de IA (ex: se acabar a cota), use o arquivo [models.json](./models.json) para identificar o próximo motor na fila de fallback.
302
+
303
+ ## IAs Configuradas
304
+
305
+ ${opts.ai.map(ai => `- [${ai.toUpperCase()}](./${ai}.md)`).join('\n')}
306
+ `;
307
+ fs.writeFileSync(path.join(instructionsDir, 'README.md'), indexContent);
308
+ // Criar models.json para interoperabilidade
309
+ const modelsJson = {
310
+ active_engine: opts.ai[0] || 'copilot',
311
+ fallback_chain: opts.ai,
312
+ engines: opts.ai.reduce((acc, ai) => {
313
+ acc[ai] = {
314
+ name: ai.toUpperCase(),
315
+ instruction_file: `.ia-instructions/${ai}.md`,
316
+ status: "ready"
317
+ };
318
+ return acc;
319
+ }, {})
320
+ };
321
+ fs.writeFileSync(path.join(instructionsDir, 'models.json'), JSON.stringify(modelsJson, null, 2));
322
+ log(`${copied} instruções copiadas para .ia-instructions/`, 'success');
323
+ }
324
+ async function step03InstallBackend(projectDir, opts) {
325
+ if (opts.skipBackend) {
326
+ log('Skipping backend install (--skip-backend)', 'warn');
327
+ return;
328
+ }
329
+ const backendDir = path.join(projectDir, 'backend');
330
+ if (!fs.existsSync(backendDir)) {
331
+ log('Backend directory não encontrado', 'warn');
332
+ return;
333
+ }
334
+ log('Instalando dependências do backend...', 'step');
335
+ try {
336
+ execCmd(`cd "${backendDir}" && npm install --quiet`, { quiet: true });
337
+ log('npm install concluído', 'success');
338
+ }
339
+ catch (err) {
340
+ log('Erro ao rodar npm install', 'error');
341
+ if (!opts.verbose) {
342
+ log('Use --verbose para mais detalhes', 'warn');
343
+ }
344
+ // Não falha o setup inteiro
345
+ }
346
+ }
347
+ async function step04InitMemoryDb(projectDir, opts) {
348
+ if (opts.skipDb || opts.skipBackend) {
349
+ log('Skipping DB init', 'warn');
350
+ return;
351
+ }
352
+ const backendDir = path.join(projectDir, 'backend');
353
+ const scriptPath = path.join(backendDir, 'scripts/memory-db-init.mjs');
354
+ if (!fs.existsSync(scriptPath)) {
355
+ log('Script de init DB não encontrado', 'warn');
356
+ return;
357
+ }
358
+ log('Inicializando banco de dados SQLite...', 'step');
359
+ try {
360
+ execCmd(`cd "${backendDir}" && npm run memory:db:init 2>/dev/null`, { quiet: true, ignoreError: true });
361
+ log('SQLite inicializado em .memory/sqlite/context.db', 'success');
362
+ }
363
+ catch (err) {
364
+ log('Erro ao inicializar DB', 'warn');
365
+ }
366
+ }
367
+ async function step05BuildContextPack(projectDir, opts) {
368
+ const scriptsDir = path.join(projectDir, 'scripts');
369
+ const scriptPath = path.join(scriptsDir, 'build-context-pack.mjs');
370
+ if (!fs.existsSync(scriptPath)) {
371
+ log('Script context-pack não encontrado', 'warn');
372
+ return;
373
+ }
374
+ log('Construindo context pack...', 'step');
375
+ try {
376
+ execCmd(`cd "${projectDir}" && node scripts/build-context-pack.mjs 2>/dev/null`, { quiet: true, ignoreError: true });
377
+ log('Context pack criado em .context/context-pack.md', 'success');
378
+ }
379
+ catch (err) {
380
+ log('Erro ao criar context pack', 'warn');
381
+ }
382
+ }
383
+ async function step06UniversalMemorySync(projectDir, opts) {
384
+ log('Sincronizando com Memória Universal...', 'step');
385
+ const projectName = path.basename(projectDir);
386
+ const rootMemoryDir = getWorkspaceProjectsMemoryDir();
387
+ ensureDir(rootMemoryDir);
388
+ const projectInfoFile = path.join(rootMemoryDir, `${projectName}.md`);
389
+ const content = `# Projeto: ${projectName}\n\n- **Status**: Ativo\n- **Diretório**: ${projectDir}\n- **Workspace**: ${getWorkspaceRoot()}\n- **Criado em**: ${new Date().toISOString()}\n\n## Descrição\n(Descreva o projeto aqui)\n`;
390
+ if (!fs.existsSync(projectInfoFile)) {
391
+ fs.writeFileSync(projectInfoFile, content, 'utf8');
392
+ }
393
+ log(`Projeto ${projectName} registrado na Memória Universal do workspace`, 'success');
394
+ }
395
+ async function step07ShowNextSteps(projectDir, opts) {
396
+ const relPath = path.relative(process.cwd(), projectDir) || '.';
397
+ logSection('✨ SETUP COMPLETO!');
398
+ console.log(`📁 Projeto criado em: ${relPath}\n`);
399
+ console.log('📚 Próximos Passos:\n');
400
+ console.log(` 1. Entrar no projeto:`);
401
+ console.log(` cd ${relPath}\n`);
402
+ console.log(` 2. Ver estrutura de memória:`);
403
+ console.log(` ls -la memory/\n`);
404
+ console.log(` 3. Carregar instruções para IA:`);
405
+ console.log(` cat .ia-instructions/copilot.md`);
406
+ console.log(` cat .ia-instructions/claude.md\n`);
407
+ if (!opts.skipBackend) {
408
+ console.log(` 4. Iniciar backend em dev mode:`);
409
+ console.log(` cd backend && npm run start:dev\n`);
410
+ console.log(` 5. Rodar testes:`);
411
+ console.log(` cd backend && npm test\n`);
412
+ }
413
+ console.log(` 6. Atualizar documentação em memory/\n`);
414
+ console.log(` 7. Sincronizar contexto com BD:`);
415
+ console.log(` cd backend && npm run memory:db:sync\n`);
416
+ console.log(` 8. Limpar memória antiga (Vacuum):`);
417
+ console.log(` node scripts/memory-vacuum.mjs\n`);
418
+ console.log(` 9. Consultar contexto:`);
419
+ console.log(` cd backend && npm run memory:db:query -- "search" "auth" 10\n`);
420
+ console.log('📖 Recursos:');
421
+ console.log(` • Documentação: cat memory/README.md`);
422
+ console.log(` • Agentes: cat AGENTS.md`);
423
+ console.log(` • Decisões: cat memory/90-decisions/ADR-*.md\n`);
424
+ console.log('🤖 Instruções para IAs:');
425
+ for (const ai of opts.ai) {
426
+ const aiFile = path.join(relPath, `.ia-instructions/${ai}.md`);
427
+ console.log(` • ${ai.toUpperCase()}: .ia-instructions/${ai}.md`);
428
+ }
429
+ console.log('\n🚀 Tudo pronto! Comece a codificar!\n');
430
+ }
431
+ // ============================================================================
432
+ // MAIN
433
+ // ============================================================================
434
+ async function main() {
435
+ const { projectName, projectPath, opts } = parseArgs();
436
+ if (!projectName && !opts.interactive) {
437
+ console.log(`
438
+ init-project v0.6.0 (Workspace separado)
439
+
440
+ Cria projetos de produto no workspace Forja (padrão: ~/forja-workspace/projects).
441
+ O repositório do framework permanece isolado.
442
+
443
+ Uso: node bin/init-project.js <project-name> [opções]
444
+
445
+ Opções:
446
+ --ai <list> IAs para configurar (padrão: copilot,claude,gemini,codex)
447
+ --skip-backend Pula instalação do backend NestJS
448
+ --skip-db Pula inicialização do SQLite
449
+ --skip-git Pula inicialização do Git
450
+ --skip-design Pula cópia da biblioteca design-md
451
+ --interactive Modo interativo
452
+ --verbose Output detalhado
453
+
454
+ Workspace:
455
+ O caminho é resolvido por prioridade:
456
+ 1. Variável de ambiente FORJA_WORKSPACE
457
+ 2. Campo workspaceRoot em ~/.forjarc.json
458
+ 3. Padrão: ~/forja-workspace
459
+
460
+ Exemplos:
461
+ node bin/init-project.js meu-projeto
462
+ node bin/init-project.js meu-projeto --ai copilot,claude
463
+ node bin/init-project.js meu-projeto --skip-backend
464
+ node bin/init-project.js --interactive
465
+ `);
466
+ process.exit(0);
467
+ }
468
+ let target = projectName;
469
+ // Interactive mode
470
+ if (opts.interactive || !projectName) {
471
+ logSection('🎯 Modo Interativo');
472
+ // Simular input (em produção, usar package como prompt ou readline)
473
+ target = projectName || 'meu-projeto';
474
+ log(`Projeto: ${target}`, 'info');
475
+ log(`IAs: ${opts.ai.join(', ')}`, 'info');
476
+ }
477
+ // Garante workspace pronto
478
+ initWorkspace();
479
+ const projectDir = projectPath || resolveProject(target);
480
+ assertOutsideFrameworkRepo(projectDir, 'init-project');
481
+ logSection('🚀 Inicializando Novo Projeto com Agentes Orquestrados');
482
+ log(`Workspace ativo: ${getWorkspaceRoot()}`, 'info');
483
+ log(`Projeto: ${projectDir}`, 'info');
484
+ try {
485
+ // Executar checklist de setup
486
+ for (const step of SETUP_CHECKLIST) {
487
+ if (step === '00-git-init')
488
+ await step00GitInit(projectDir, opts);
489
+ else if (step === '01-generate-structure')
490
+ await step01GenerateStructure(projectDir, opts);
491
+ else if (step === '01b-copy-design-library')
492
+ await step01bCopyDesignLibrary(projectDir, opts);
493
+ else if (step === '01c-emit-harness')
494
+ await step01cEmitHarness(projectDir, opts);
495
+ else if (step === '02-copy-instructions')
496
+ await step02CopyInstructions(projectDir, opts);
497
+ else if (step === '03-install-backend')
498
+ await step03InstallBackend(projectDir, opts);
499
+ else if (step === '04-init-memory-db')
500
+ await step04InitMemoryDb(projectDir, opts);
501
+ else if (step === '05-build-context-pack')
502
+ await step05BuildContextPack(projectDir, opts);
503
+ else if (step === '06-universal-memory-sync')
504
+ await step06UniversalMemorySync(projectDir, opts);
505
+ else if (step === '07-show-next-steps')
506
+ await step07ShowNextSteps(projectDir, opts);
507
+ }
508
+ log('Init completo!', 'done');
509
+ process.exit(0);
510
+ }
511
+ catch (err) {
512
+ console.error('\n❌ Erro durante setup:', err.message);
513
+ process.exit(1);
514
+ }
515
+ }
516
+ main();
@@ -0,0 +1,67 @@
1
+ /**
2
+ * lib/audit.mjs — a trilha de auditoria como dado consultável (SPEC-014).
3
+ *
4
+ * O core grava toda execução em `.context/forja-runs.jsonl` (ADR-0020): `{ts, cmd, args, exitCode,
5
+ * durationMs}`, uma linha por run. É o dado mais rico de governança do framework — e era write-only.
6
+ *
7
+ * Aqui ele vira consultável, sem deixar de ser resiliente: o `.jsonl` continua a **fonte de
8
+ * verdade** append-only (sobrevive ao banco morto, ADR-0021); a tabela `audit_runs` é uma
9
+ * **projeção reconstruível** por `syncAudit`. Idempotência por `line_hash` (hash do conteúdo da
10
+ * linha): re-sincronizar não duplica, e truncar/reescrever o log não corrompe a tabela.
11
+ *
12
+ * Puro e com `env` injetável — os testes rodam sobre um jsonl de fixture, sem tocar o workspace.
13
+ */
14
+ import fs from 'node:fs';
15
+ /** @typedef {{ ts: string, cmd: string, args: string[], exitCode: number, durationMs: number }} Run */
16
+ /** @returns {{ fs: typeof fs, dbPath: string, jsonlPath: string }} */
17
+ export declare function defaultEnv(overrides?: {}): {
18
+ fs: typeof fs;
19
+ dbPath: string;
20
+ jsonlPath: string;
21
+ };
22
+ /**
23
+ * Ingere o `.jsonl` na tabela `audit_runs`. Idempotente (INSERT OR IGNORE por line_hash).
24
+ * Linha malformada é pulada — um log corrompido no meio não impede o resto.
25
+ *
26
+ * @returns {Promise<{ ingested: number, total: number, skipped: number }>}
27
+ */
28
+ export declare function syncAudit(env?: {
29
+ fs: typeof fs;
30
+ dbPath: string;
31
+ jsonlPath: string;
32
+ }): Promise<{
33
+ ingested: number;
34
+ total: any;
35
+ skipped: number;
36
+ }>;
37
+ /**
38
+ * Consulta estruturada. `{ since, cmd, gate, failed }`.
39
+ * @returns {Promise<Run[]>}
40
+ */
41
+ export declare function queryAudit(env?: {
42
+ fs: typeof fs;
43
+ dbPath: string;
44
+ jsonlPath: string;
45
+ }, opts?: {
46
+ since?: string;
47
+ cmd?: string;
48
+ failed?: boolean;
49
+ gate?: string;
50
+ }): Promise<any>;
51
+ /**
52
+ * Resumo para o painel: total, falhas, por comando, mais lentos, recentes.
53
+ * @returns {Promise<{ total, fails, byCmd, slowest, recent }>}
54
+ */
55
+ export declare function auditSummary(env?: {
56
+ fs: typeof fs;
57
+ dbPath: string;
58
+ jsonlPath: string;
59
+ }): Promise<{
60
+ total: any;
61
+ fails: any;
62
+ byCmd: any;
63
+ slowest: any;
64
+ recent: any;
65
+ }>;
66
+ /** Último exit code de um comando (para o painel mostrar o estado sem reexecutar — D4). */
67
+ export declare function lastExit(env: any, cmd: any): Promise<any>;