forjajs 4.1.2 → 5.0.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 (178) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +109 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/status-model.js +18 -7
  77. package/dist/lib/templates.d.ts +24 -0
  78. package/dist/lib/templates.js +77 -0
  79. package/dist/lib/validators/structure-validator.js +0 -1
  80. package/dist/lib/workspace.d.ts +7 -0
  81. package/dist/lib/workspace.js +20 -2
  82. package/dist/packages/adapter-git/src/index.js +2 -2
  83. package/dist/packages/context/src/index.js +1 -1
  84. package/dist/packages/core/src/index.js +1 -1
  85. package/dist/packages/evals/src/index.js +1 -1
  86. package/dist/packages/events/src/index.js +1 -1
  87. package/dist/packages/graph/src/index.js +1 -1
  88. package/dist/packages/mcp/src/index.d.ts +1 -1
  89. package/dist/packages/observability/src/index.js +1 -1
  90. package/dist/packages/orchestration/src/index.js +1 -1
  91. package/dist/packages/planner/src/index.js +1 -1
  92. package/dist/packages/policy/src/index.js +1 -1
  93. package/dist/packages/runtime/src/index.js +1 -1
  94. package/dist/packages/sandbox/src/index.js +1 -1
  95. package/dist/packages/validator/src/index.js +1 -1
  96. package/dist/scripts/adr.js +4 -4
  97. package/dist/scripts/agent-harness.js +30 -23
  98. package/dist/scripts/agent-router.js +22 -5
  99. package/dist/scripts/agent.js +5 -5
  100. package/dist/scripts/architecture.js +6 -6
  101. package/dist/scripts/audit-query.js +1 -1
  102. package/dist/scripts/audit-sync.js +1 -1
  103. package/dist/scripts/build-smart-context.d.ts +19 -1
  104. package/dist/scripts/build-smart-context.js +84 -68
  105. package/dist/scripts/check-standards.js +8 -3
  106. package/dist/scripts/code-context.js +1 -1
  107. package/dist/scripts/compress-memory.js +3 -2
  108. package/dist/scripts/compress-project-memory.js +2 -2
  109. package/dist/scripts/context-ops.js +13 -5
  110. package/dist/scripts/cost-economy.js +4 -4
  111. package/dist/scripts/demo-autonomy.js +11 -11
  112. package/dist/scripts/demo-workspace.js +12 -4
  113. package/dist/scripts/dev.js +8 -7
  114. package/dist/scripts/drift-check.js +5 -5
  115. package/dist/scripts/engineer.js +11 -11
  116. package/dist/scripts/evidence.js +4 -4
  117. package/dist/scripts/extract-global-knowledge.js +6 -4
  118. package/dist/scripts/forja-setup.js +2 -1
  119. package/dist/scripts/forja-status.js +5 -4
  120. package/dist/scripts/gates.js +1 -1
  121. package/dist/scripts/generate-dashboard.js +6 -4
  122. package/dist/scripts/governance-dashboard.js +2 -2
  123. package/dist/scripts/hook-session-start.js +11 -10
  124. package/dist/scripts/hook-user-prompt.js +3 -2
  125. package/dist/scripts/incident.js +4 -4
  126. package/dist/scripts/llm-fit.js +11 -11
  127. package/dist/scripts/memory-audit.js +1 -1
  128. package/dist/scripts/memory-schema.js +3 -2
  129. package/dist/scripts/orchestrate.js +4 -5
  130. package/dist/scripts/project-smoke.js +13 -2
  131. package/dist/scripts/project-templates.d.ts +1 -0
  132. package/dist/scripts/project-templates.js +20 -0
  133. package/dist/scripts/project-upgrade.d.ts +13 -0
  134. package/dist/scripts/project-upgrade.js +107 -40
  135. package/dist/scripts/project-wire.d.ts +8 -0
  136. package/dist/scripts/project-wire.js +55 -0
  137. package/dist/scripts/provenance.js +3 -3
  138. package/dist/scripts/query-universal-memory.js +7 -4
  139. package/dist/scripts/release-check.js +1 -1
  140. package/dist/scripts/risk.js +4 -4
  141. package/dist/scripts/simulate.js +9 -9
  142. package/dist/scripts/spec-cli.d.ts +1 -0
  143. package/dist/scripts/spec-cli.js +25 -5
  144. package/dist/scripts/sprint-manager.js +4 -3
  145. package/dist/scripts/sync-universal-memory.js +22 -15
  146. package/dist/scripts/token-benchmark.js +4 -3
  147. package/dist/scripts/token-economy.js +4 -3
  148. package/dist/scripts/tools-doctor.d.ts +1 -1
  149. package/dist/scripts/tools-doctor.js +25 -3
  150. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  151. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  152. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  153. package/docs/glossary.md +4 -4
  154. package/docs/init-project.md +88 -444
  155. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  156. package/docs/modos-de-operacao.md +1 -1
  157. package/docs/processo-projeto.md +14 -11
  158. package/docs/produto/roteiro-demo.md +15 -18
  159. package/docs/publishing.md +5 -0
  160. package/docs/quick-reference.md +15 -23
  161. package/docs/structure.md +16 -30
  162. package/lib/core/model-pricing.json +19 -0
  163. package/memory/30-projects/README.md +1 -1
  164. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  165. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  166. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  167. package/memory/90-decisions/0088-templates-validados.md +55 -0
  168. package/package.json +25 -25
  169. package/templates/project/AGENTS.md +75 -0
  170. package/templates/project/CLAUDE.md +9 -0
  171. package/templates/project/agents/context-engineer.md +15 -0
  172. package/templates/project/agents/governance.md +15 -0
  173. package/templates/project/agents/marketing.md +15 -0
  174. package/templates/project/agents/orchestrator.md +15 -0
  175. package/templates/project/agents/product.md +15 -0
  176. package/templates/project/agents/sdd-architect.md +15 -0
  177. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  178. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -1,39 +1,37 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * init-project.js
3
+ * bin/init-project.ts — gerador de projeto do workspace, chamado por `forja project:new`.
4
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
5
+ * Gera memória + agentes (create-memory-nest-kit), backend NestJS opcional, design-md, e conecta o
6
+ * projeto à inteligência do Forja (lib/project-wiring.ts). Termina com exit 1 se algo essencial
7
+ * falhou — o resumo final lista cada pendência.
13
8
  */
14
9
  import fs from 'node:fs';
15
10
  import path from 'node:path';
16
11
  import process from 'node:process';
17
12
  import { execSync } from 'node:child_process';
18
13
  import { fileURLToPath } from 'node:url';
19
- import { writeAiInstructions } from "../lib/multi-ai-instructions.js";
20
- import { getWorkspaceRoot, resolveProject, initWorkspace, getWorkspaceProjectsMemoryDir, assertOutsideFrameworkRepo, } from "../lib/workspace.js";
14
+ import { wireProject, checkProjectWiring } from '../lib/project-wiring.js';
15
+ import { COMMANDS } from '../lib/core/registry.js';
16
+ import { resolveTemplate, applyTemplate } from '../lib/templates.js';
17
+ import { getWorkspaceRoot, resolveProject, initWorkspace, getWorkspaceProjectsMemoryDir, assertOutsideFrameworkRepo, } from '../lib/workspace.js';
18
+ import { pkgRoot, script } from '../lib/paths.js';
21
19
  const __filename = fileURLToPath(import.meta.url);
22
20
  const __dirname = path.dirname(__filename);
23
- const kitRoot = path.resolve(__dirname, '..');
21
+ // kitRoot = assets do pacote (design-md, templates, instruções); o gerador é código → script().
22
+ const kitRoot = pkgRoot;
23
+ const memoryKit = script('bin/create-memory-nest-kit');
24
24
  // ============================================================================
25
25
  // CONFIGURAÇÃO
26
26
  // ============================================================================
27
27
  const DEFAULT_AI_AGENTS = ['copilot', 'claude', 'gemini', 'codex'];
28
- // Conteúdo canônico único (ADR-0020): toda IA recebe a mesma explicação da estrutura Forja; só o
29
- // cabeçalho muda. A escrita vive em lib/multi-ai-instructions.ts (SPEC-047) e é compartilhada com
30
- // o project:smoke. CLAUDE.md do framework NÃO é copiado — ele descreve o motor, não o gerado.
28
+ // IAs suportadas e a conexão de cada uma: lib/project-wiring.ts (ADR-0086).
31
29
  const SETUP_CHECKLIST = [
32
30
  '00-git-init',
33
31
  '01-generate-structure',
32
+ '01t-apply-template',
34
33
  '01b-copy-design-library',
35
- '01c-emit-harness',
36
- '02-copy-instructions',
34
+ '02-wire-intelligence',
37
35
  '03-install-backend',
38
36
  '04-init-memory-db',
39
37
  '05-build-context-pack',
@@ -43,6 +41,13 @@ const SETUP_CHECKLIST = [
43
41
  // ============================================================================
44
42
  // HELPERS
45
43
  // ============================================================================
44
+ // Pendências do setup: `warn` aparece no resumo final; `fail` faz o processo sair com 1. Antes, todo
45
+ // problema virava um log e o setup terminava com "Tudo pronto!" e exit 0 mesmo sem instruções de IA.
46
+ const ISSUES = [];
47
+ function issue(level, msg) {
48
+ ISSUES.push({ level, msg });
49
+ log(msg, level === 'fail' ? 'error' : 'warn');
50
+ }
46
51
  function log(msg, level = 'info') {
47
52
  const prefix = {
48
53
  info: '📌',
@@ -78,17 +83,6 @@ function ensureDir(dir) {
78
83
  fs.mkdirSync(dir, { recursive: true });
79
84
  }
80
85
  }
81
- function copyFile(src, dest) {
82
- const content = fs.readFileSync(src, 'utf-8');
83
- fs.writeFileSync(dest, content, 'utf-8');
84
- }
85
- function copyFileIfExists(src, dest) {
86
- if (fs.existsSync(src)) {
87
- copyFile(src, dest);
88
- return true;
89
- }
90
- return false;
91
- }
92
86
  function copyDir(src, dest) {
93
87
  ensureDir(dest);
94
88
  const entries = fs.readdirSync(src, { withFileTypes: true });
@@ -109,21 +103,39 @@ function copyDir(src, dest) {
109
103
  function parseArgs() {
110
104
  const args = process.argv.slice(2);
111
105
  const opts = {
112
- interactive: args.includes('--interactive'),
113
106
  skipBackend: args.includes('--skip-backend'),
114
107
  skipDb: args.includes('--skip-db'),
115
108
  skipGit: args.includes('--skip-git'),
116
109
  skipDesign: args.includes('--skip-design'),
117
110
  ai: DEFAULT_AI_AGENTS,
118
111
  verbose: args.includes('--verbose'),
112
+ template: null,
119
113
  };
114
+ // --template <boilerplate>: resolvido antes de criar qualquer arquivo — template inexistente ou
115
+ // não validado falha aqui, sem deixar um projeto pela metade.
116
+ const tplIdx = args.indexOf('--template');
117
+ if (tplIdx >= 0) {
118
+ const name = args[tplIdx + 1];
119
+ if (!name || name.startsWith('--')) {
120
+ console.error('--template exige um nome (veja: forja project:templates)');
121
+ process.exit(1);
122
+ }
123
+ try {
124
+ opts.template = resolveTemplate(name);
125
+ }
126
+ catch (e) {
127
+ console.error(`❌ ${e.message}`);
128
+ process.exit(1);
129
+ }
130
+ }
120
131
  // Parse --ai flag
121
132
  const aiIdx = args.findIndex(a => a === '--ai');
122
133
  if (aiIdx >= 0 && aiIdx + 1 < args.length) {
123
134
  opts.ai = args[aiIdx + 1].split(',').map(s => s.trim());
124
135
  }
125
- // Project name (primeiro arg sem --)
126
- const projectName = args.find(a => !a.startsWith('--'));
136
+ // Project name (primeiro arg que não é flag nem valor de flag)
137
+ const flagValues = new Set(['--ai', '--template'].filter((f) => args.includes(f)).map((f) => args[args.indexOf(f) + 1]));
138
+ const projectName = args.find(a => !a.startsWith('--') && !flagValues.has(a));
127
139
  // Projetos de produto vivem obrigatoriamente no workspace externo.
128
140
  // init-project nao aceita mais path customizado para evitar poluicao do repo do framework.
129
141
  const projectDir = projectName ? resolveProject(projectName) : null;
@@ -159,10 +171,11 @@ async function step01GenerateStructure(projectDir, opts) {
159
171
  log('Gerando estrutura de agentes e memória...', 'step');
160
172
  // Verifica se já existe código (ex: backend) para decidir se usa --only-memory
161
173
  const hasBackend = fs.existsSync(path.join(projectDir, 'backend')) || fs.existsSync(path.join(projectDir, 'package.json'));
162
- const onlyMemory = hasBackend ? '--only-memory' : '';
174
+ // Com template, o backend vem do boilerplate: o gerador entrega só memória e agentes.
175
+ const onlyMemory = hasBackend || opts.template ? '--only-memory' : '';
163
176
  const cmd = opts.skipBackend
164
- ? `node "${path.join(kitRoot, 'bin/create-memory-nest-kit.js')}" "${projectDir}" --only-memory --force`
165
- : `node "${path.join(kitRoot, 'bin/create-memory-nest-kit.js')}" "${projectDir}" ${onlyMemory} --force`;
177
+ ? `node "${memoryKit}" "${projectDir}" --only-memory --force`
178
+ : `node "${memoryKit}" "${projectDir}" ${onlyMemory} --force`;
166
179
  try {
167
180
  execCmd(cmd);
168
181
  log('Estrutura gerada com sucesso', 'success');
@@ -190,6 +203,18 @@ function addScalingLayers(projectDir) {
190
203
  }
191
204
  log('Camadas de Growth e Scaling adicionadas', 'success');
192
205
  }
206
+ async function step01tApplyTemplate(projectDir, opts) {
207
+ if (!opts.template)
208
+ return;
209
+ log(`Aplicando o template ${opts.template.name}...`, 'step');
210
+ try {
211
+ const copied = applyTemplate(projectDir, opts.template);
212
+ log(`${copied.length} arquivo(s) do template aplicados (código e memória do boilerplate prevalecem)`, 'success');
213
+ }
214
+ catch (err) {
215
+ issue('fail', `Falha ao aplicar o template ${opts.template.name}: ${err.message}`);
216
+ }
217
+ }
193
218
  async function step01bCopyDesignLibrary(projectDir, opts) {
194
219
  if (opts.skipDesign) {
195
220
  log('Skipping design library copy (--skip-design)', 'warn');
@@ -198,7 +223,7 @@ async function step01bCopyDesignLibrary(projectDir, opts) {
198
223
  const srcDesignDir = path.join(kitRoot, 'design-md');
199
224
  const destDesignDir = path.join(projectDir, 'design-md');
200
225
  if (!fs.existsSync(srcDesignDir)) {
201
- log('Biblioteca de design não encontrada no kit root', 'warn');
226
+ issue('fail', `Biblioteca de design não encontrada em ${srcDesignDir}`);
202
227
  return;
203
228
  }
204
229
  log('Copiando biblioteca de referências de design (design-md)...', 'step');
@@ -207,68 +232,22 @@ async function step01bCopyDesignLibrary(projectDir, opts) {
207
232
  log('Biblioteca design-md copiada para o projeto', 'success');
208
233
  }
209
234
  catch (err) {
210
- log('Erro ao copiar biblioteca de design', 'error');
211
- if (opts.verbose)
212
- console.error(err);
235
+ issue('fail', `Erro ao copiar biblioteca de design: ${err.message}`);
213
236
  }
214
237
  }
215
- // Camada de code intelligence + ferramentas de processo (ADR-0017, ADR-0018).
216
- // Cada projeto gerado herda codegraph (MCP) + scripts code:* + tools:doctor,
217
- // de forma auto-contida (so dependem do binario codegraph, opcional).
218
- const HARNESS_SCRIPTS = {
219
- 'code:index': 'codegraph init',
220
- 'code:sync': 'codegraph sync',
221
- 'code:status': 'codegraph status',
222
- 'code:query': 'codegraph query',
223
- 'code:check': 'node scripts/code-intel.mjs check',
224
- 'code:impact': 'node scripts/code-intel.mjs impact',
225
- 'tools:doctor': 'node scripts/tools-doctor.mjs',
226
- };
227
- async function step01cEmitHarness(projectDir, opts) {
228
- log('Emitindo harness de code intelligence (codegraph + tools)...', 'step');
229
- // 1. .mcp.json (codegraph) — aditivo, nao sobrescreve config existente
230
- const mcpDest = path.join(projectDir, '.mcp.json');
231
- const mcpSrc = path.join(kitRoot, 'lib/templates/harness/mcp.json');
232
- if (!fs.existsSync(mcpDest)) {
233
- copyFileIfExists(mcpSrc, mcpDest);
234
- }
235
- // 2. scripts auto-contidos
236
- const scriptsDir = path.join(projectDir, 'scripts');
237
- ensureDir(scriptsDir);
238
- copyFileIfExists(path.join(kitRoot, 'lib/templates/harness/code-intel.mjs'), path.join(scriptsDir, 'code-intel.mjs'));
239
- copyFileIfExists(path.join(kitRoot, 'scripts/tools-doctor.mjs'), path.join(scriptsDir, 'tools-doctor.mjs'));
240
- // 3. merge dos scripts no package.json (cria minimo se ausente)
241
- const pkgPath = path.join(projectDir, 'package.json');
242
- let pkg;
243
- if (fs.existsSync(pkgPath)) {
244
- try {
245
- pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
246
- }
247
- catch {
248
- log('package.json ilegivel; harness scripts nao injetados', 'warn');
249
- return;
250
- }
251
- }
252
- else {
253
- pkg = { name: path.basename(projectDir), version: '0.1.0', type: 'module', scripts: {} };
238
+ // Liga o projeto à inteligência do Forja (ADR-0086): AGENTS.md/CLAUDE.md/GEMINI.md nativos, hooks,
239
+ // sub-agents, MCP e scripts que chamam o `forja`. A mesma função serve ao `project:wire` e ao
240
+ // `project:upgrade`; a verificação em seguida é a mesma do `project:wire --check`.
241
+ async function step02WireIntelligence(projectDir, opts) {
242
+ log('Conectando o projeto à inteligência do Forja...', 'step');
243
+ const changes = wireProject(projectDir, { ai: opts.ai });
244
+ log(`${changes.filter((c) => c.action !== 'unchanged').length} arquivo(s) de conexão escritos (IAs: ${opts.ai.join(', ')})`, 'success');
245
+ for (const c of checkProjectWiring(projectDir, { commands: COMMANDS, ai: opts.ai })) {
246
+ if (c.status === 'fail')
247
+ issue('fail', `conexão ${c.id}: ${c.detail}`);
248
+ else if (c.status === 'warn')
249
+ issue('warn', `conexão ${c.id}: ${c.detail}`);
254
250
  }
255
- pkg.scripts = pkg.scripts || {};
256
- for (const [key, value] of Object.entries(HARNESS_SCRIPTS)) {
257
- if (!pkg.scripts[key])
258
- pkg.scripts[key] = value;
259
- }
260
- fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
261
- log('Harness emitido: .mcp.json + code:* + tools:doctor', 'success');
262
- }
263
- async function step02CopyInstructions(projectDir, opts) {
264
- log('Copiando instruções para IAs...', 'step');
265
- // A lógica vive em lib/multi-ai-instructions.ts (SPEC-047) — compartilhada com o project:smoke.
266
- const { written, skipped } = writeAiInstructions(projectDir, opts.ai, { kitRoot });
267
- for (const ai of written)
268
- log(`${String(ai).toUpperCase()}: ✓`, 'success');
269
- for (const ai of skipped)
270
- log(`${String(ai).toUpperCase()}: não encontrado`, 'warn');
271
- log(`${written.length} instruções copiadas para .ia-instructions/`, 'success');
272
251
  }
273
252
  async function step03InstallBackend(projectDir, opts) {
274
253
  if (opts.skipBackend) {
@@ -286,31 +265,25 @@ async function step03InstallBackend(projectDir, opts) {
286
265
  log('npm install concluído', 'success');
287
266
  }
288
267
  catch (err) {
289
- log('Erro ao rodar npm install', 'error');
290
- if (!opts.verbose) {
291
- log('Use --verbose para mais detalhes', 'warn');
292
- }
293
- // Não falha o setup inteiro
268
+ // Não derruba o setup (rede/registry podem estar fora), mas aparece no resumo.
269
+ issue('warn', `npm install do backend falhou — rode depois: cd backend && npm install${opts.verbose ? '' : ' (detalhes: --verbose)'}`);
294
270
  }
295
271
  }
272
+ // O projeto nasce indexado: `forja status` diz "memória indexada: sim" e `context:smart` já responde.
296
273
  async function step04InitMemoryDb(projectDir, opts) {
297
- if (opts.skipDb || opts.skipBackend) {
298
- log('Skipping DB init', 'warn');
274
+ if (opts.skipDb) {
275
+ log('Indexação da memória pulada (--skip-db)', 'warn');
299
276
  return;
300
277
  }
301
- const backendDir = path.join(projectDir, 'backend');
302
- const scriptPath = path.join(backendDir, 'scripts/memory-db-init.mjs');
303
- if (!fs.existsSync(scriptPath)) {
304
- log('Script de init DB não encontrado', 'warn');
305
- return;
306
- }
307
- log('Inicializando banco de dados SQLite...', 'step');
278
+ log('Indexando a memória do projeto (forja sync:universal)...', 'step');
279
+ const env = { ...process.env, FORJA_MODE: 'embedded' };
280
+ delete env.FORJA_WORKSPACE;
308
281
  try {
309
- execCmd(`cd "${backendDir}" && npm run memory:db:init 2>/dev/null`, { quiet: true, ignoreError: true });
310
- log('SQLite inicializado em .memory/sqlite/context.db', 'success');
282
+ execSync(`node "${script('scripts/sync-universal-memory')}"`, { cwd: projectDir, env, stdio: opts.verbose ? 'inherit' : 'pipe' });
283
+ log('Memória indexada em memory/sqlite/universal.db', 'success');
311
284
  }
312
285
  catch (err) {
313
- log('Erro ao inicializar DB', 'warn');
286
+ issue('warn', `Indexação da memória falhou — rode depois: forja sync:universal (${String(err.message).split('\n')[0]})`);
314
287
  }
315
288
  }
316
289
  async function step05BuildContextPack(projectDir, opts) {
@@ -343,86 +316,56 @@ async function step06UniversalMemorySync(projectDir, opts) {
343
316
  }
344
317
  async function step07ShowNextSteps(projectDir, opts) {
345
318
  const relPath = path.relative(process.cwd(), projectDir) || '.';
346
- logSection('✨ SETUP COMPLETO!');
347
- console.log(`📁 Projeto criado em: ${relPath}\n`);
348
- console.log('📚 Próximos Passos:\n');
349
- console.log(` 1. Entrar no projeto:`);
350
- console.log(` cd ${relPath}\n`);
351
- console.log(` 2. Ver estrutura de memória:`);
352
- console.log(` ls -la memory/\n`);
353
- console.log(` 3. Carregar instruções para IA:`);
354
- console.log(` cat .ia-instructions/copilot.md`);
355
- console.log(` cat .ia-instructions/claude.md\n`);
356
- if (!opts.skipBackend) {
357
- console.log(` 4. Iniciar backend em dev mode:`);
358
- console.log(` cd backend && npm run start:dev\n`);
359
- console.log(` 5. Rodar testes:`);
360
- console.log(` cd backend && npm test\n`);
361
- }
362
- console.log(` 6. Atualizar documentação em memory/\n`);
363
- console.log(` 7. Sincronizar contexto com BD:`);
364
- console.log(` cd backend && npm run memory:db:sync\n`);
365
- console.log(` 8. Limpar memória antiga (Vacuum):`);
366
- console.log(` node scripts/memory-vacuum.mjs\n`);
367
- console.log(` 9. Consultar contexto:`);
368
- console.log(` cd backend && npm run memory:db:query -- "search" "auth" 10\n`);
369
- console.log('📖 Recursos:');
370
- console.log(` • Documentação: cat memory/README.md`);
371
- console.log(` • Agentes: cat AGENTS.md`);
372
- console.log(` • Decisões: cat memory/90-decisions/ADR-*.md\n`);
373
- console.log('🤖 Instruções para IAs:');
374
- for (const ai of opts.ai) {
375
- const aiFile = path.join(relPath, `.ia-instructions/${ai}.md`);
376
- console.log(` • ${ai.toUpperCase()}: .ia-instructions/${ai}.md`);
377
- }
378
- console.log('\n🚀 Tudo pronto! Comece a codificar!\n');
319
+ const fails = ISSUES.filter((i) => i.level === 'fail');
320
+ const warns = ISSUES.filter((i) => i.level === 'warn');
321
+ logSection(fails.length ? '❌ SETUP INCOMPLETO' : warns.length ? '⚠️ SETUP CONCLUÍDO COM PENDÊNCIAS' : '✨ SETUP COMPLETO!');
322
+ console.log(`📁 Projeto: ${relPath}\n`);
323
+ if (ISSUES.length) {
324
+ console.log('Pendências:');
325
+ for (const i of ISSUES)
326
+ console.log(` ${i.level === 'fail' ? '✗' : '!'} ${i.msg}`);
327
+ console.log('');
328
+ }
329
+ console.log('Próximos passos:\n');
330
+ console.log(` cd ${relPath}`);
331
+ console.log(' forja status # estado do projeto');
332
+ console.log(' forja project:wire --check # IA, hooks e MCP conectados');
333
+ console.log(' forja spec:new <feature> # primeira feature');
334
+ if (!opts.skipBackend)
335
+ console.log(' cd backend && npm run start:dev');
336
+ console.log('');
337
+ console.log(`IAs conectadas: ${opts.ai.join(', ')} — instruções em AGENTS.md${opts.ai.includes('claude') ? ' e CLAUDE.md' : ''}.`);
379
338
  }
380
339
  // ============================================================================
381
340
  // MAIN
382
341
  // ============================================================================
383
342
  async function main() {
384
343
  const { projectName, projectPath, opts } = parseArgs();
385
- if (!projectName && !opts.interactive) {
344
+ if (!projectName) {
386
345
  console.log(`
387
- init-project v0.6.0 (Workspace separado)
388
-
389
- Cria projetos de produto no workspace Forja (padrão: ~/forja-workspace/projects).
390
- O repositório do framework permanece isolado.
346
+ Uso: forja project:new <nome> [-- opções]
391
347
 
392
- Uso: node bin/init-project.js <project-name> [opções]
348
+ Cria um projeto no workspace Forja (padrão: ~/forja-workspace/projects) já conectado à IA.
393
349
 
394
350
  Opções:
395
- --ai <list> IAs para configurar (padrão: copilot,claude,gemini,codex)
396
- --skip-backend Pula instalação do backend NestJS
397
- --skip-db Pula inicialização do SQLite
398
- --skip-git Pula inicialização do Git
399
- --skip-design Pula cópia da biblioteca design-md
400
- --interactive Modo interativo
401
- --verbose Output detalhado
351
+ --ai <lista> IAs a conectar (padrão: copilot,claude,gemini,codex)
352
+ --template <nome> Parte de um boilerplate validado (veja: forja project:templates)
353
+ --skip-backend Não gera nem instala o backend NestJS
354
+ --skip-db Não indexa a memória do projeto
355
+ --skip-git Não inicializa o Git
356
+ --skip-design Não copia a biblioteca design-md
357
+ --verbose Saída detalhada
402
358
 
403
- Workspace:
404
- O caminho é resolvido por prioridade:
405
- 1. Variável de ambiente FORJA_WORKSPACE
406
- 2. Campo workspaceRoot em ~/.forjarc.json
407
- 3. Padrão: ~/forja-workspace
359
+ Workspace: FORJA_WORKSPACE → workspaceRoot em ~/.forjarc.json → ~/forja-workspace
408
360
 
409
361
  Exemplos:
410
- node bin/init-project.js meu-projeto
411
- node bin/init-project.js meu-projeto --ai copilot,claude
412
- node bin/init-project.js meu-projeto --skip-backend
413
- node bin/init-project.js --interactive
362
+ forja project:new meu-app
363
+ forja project:new meu-app -- --ai claude,codex --skip-backend
364
+ forja project:new pedidos -- --template clean-arch
414
365
  `);
415
- process.exit(0);
416
- }
417
- let target = projectName;
418
- // Interactive mode
419
- if (opts.interactive || !projectName) {
420
- logSection('🎯 Modo Interativo');
421
- // Simular input (em produção, usar package como prompt ou readline)
422
- target = projectName || 'meu-projeto';
423
- log(`Projeto: ${target}`, 'info');
424
- log(`IAs: ${opts.ai.join(', ')}`, 'info');
366
+ process.exit(projectName === undefined && process.argv.length > 2 ? 1 : 0);
425
367
  }
368
+ const target = projectName;
426
369
  // Garante workspace pronto
427
370
  initWorkspace();
428
371
  const projectDir = projectPath || resolveProject(target);
@@ -437,12 +380,12 @@ Exemplos:
437
380
  await step00GitInit(projectDir, opts);
438
381
  else if (step === '01-generate-structure')
439
382
  await step01GenerateStructure(projectDir, opts);
383
+ else if (step === '01t-apply-template')
384
+ await step01tApplyTemplate(projectDir, opts);
440
385
  else if (step === '01b-copy-design-library')
441
386
  await step01bCopyDesignLibrary(projectDir, opts);
442
- else if (step === '01c-emit-harness')
443
- await step01cEmitHarness(projectDir, opts);
444
- else if (step === '02-copy-instructions')
445
- await step02CopyInstructions(projectDir, opts);
387
+ else if (step === '02-wire-intelligence')
388
+ await step02WireIntelligence(projectDir, opts);
446
389
  else if (step === '03-install-backend')
447
390
  await step03InstallBackend(projectDir, opts);
448
391
  else if (step === '04-init-memory-db')
@@ -454,8 +397,9 @@ Exemplos:
454
397
  else if (step === '07-show-next-steps')
455
398
  await step07ShowNextSteps(projectDir, opts);
456
399
  }
457
- log('Init completo!', 'done');
458
- process.exit(0);
400
+ const failed = ISSUES.some((i) => i.level === 'fail');
401
+ log(failed ? 'Init terminou com falhas.' : 'Init completo!', failed ? 'error' : 'done');
402
+ process.exit(failed ? 1 : 0);
459
403
  }
460
404
  catch (err) {
461
405
  console.error('\n❌ Erro durante setup:', err.message);
package/dist/lib/audit.js CHANGED
@@ -13,7 +13,7 @@
13
13
  */
14
14
  import fs from 'node:fs';
15
15
  import { createHash } from 'node:crypto';
16
- import { getWorkspaceDbPath, getWorkspaceContextDir } from "./workspace.js";
16
+ import { getWorkspaceDbPath, getWorkspaceContextDir } from './workspace.js';
17
17
  /** @typedef {{ ts: string, cmd: string, args: string[], exitCode: number, durationMs: number }} Run */
18
18
  /** @returns {{ fs: typeof fs, dbPath: string, jsonlPath: string }} */
19
19
  export function defaultEnv(overrides = {}) {
@@ -8,6 +8,11 @@
8
8
  *
9
9
  * Usa SQLite FTS5 para busca eficiente e cache local para reutilização.
10
10
  */
11
+ /**
12
+ * Termo livre → consulta FTS5 segura: cada palavra vira frase entre aspas. Sem isto, `pix-qr` ou
13
+ * `auth:jwt` são sintaxe FTS inválida e a query inteira lança — e o modo task voltava vazio.
14
+ */
15
+ export declare function ftsQuery(keyword: string): string;
11
16
  export declare class ContextBuilder {
12
17
  projectPath: string;
13
18
  dbPath: string;
@@ -35,7 +40,7 @@ export declare class ContextBuilder {
35
40
  /**
36
41
  * Obter contexto global (mission, standards, padrões)
37
42
  */
38
- _getGlobalNodes(): any;
43
+ _getGlobalNodes(project?: string): any;
39
44
  /**
40
45
  * Obter contexto de domínio (vision, design, rules do projeto)
41
46
  */
@@ -11,7 +11,15 @@
11
11
  import fs from 'node:fs';
12
12
  import path from 'node:path';
13
13
  import Database from 'better-sqlite3';
14
- import { getDbPath, ensureSchema } from "../scripts/memory-schema.js";
14
+ import { getDbPath, ensureSchema } from '../scripts/memory-schema.js';
15
+ /**
16
+ * Termo livre → consulta FTS5 segura: cada palavra vira frase entre aspas. Sem isto, `pix-qr` ou
17
+ * `auth:jwt` são sintaxe FTS inválida e a query inteira lança — e o modo task voltava vazio.
18
+ */
19
+ export function ftsQuery(keyword) {
20
+ const terms = String(keyword).split(/\s+/).filter(Boolean).map((t) => `"${t.replace(/"/g, '""')}"`);
21
+ return terms.join(' ') || '""';
22
+ }
15
23
  export class ContextBuilder {
16
24
  projectPath;
17
25
  dbPath;
@@ -59,7 +67,7 @@ export class ContextBuilder {
59
67
  const nodes = [];
60
68
  const seenPaths = new Set();
61
69
  // 1. Contexto global obrigatório
62
- const globalNodes = this._getGlobalNodes();
70
+ const globalNodes = this._getGlobalNodes(project);
63
71
  nodes.push(...globalNodes);
64
72
  // 2. Contexto específico por modo
65
73
  if (mode === 'domain' || mode === 'task') {
@@ -87,11 +95,13 @@ export class ContextBuilder {
87
95
  /**
88
96
  * Obter contexto global (mission, standards, padrões)
89
97
  */
90
- _getGlobalNodes() {
98
+ _getGlobalNodes(project = '') {
91
99
  try {
100
+ // Globais do workspace (project_id NULL) + fundação do próprio projeto: no modo embedded a
101
+ // missão, os padrões e as ADRs vivem no projeto, não num nível global separado.
92
102
  const stmt = this.db.prepare(`
93
- SELECT title, content, path FROM memory_nodes
94
- WHERE project_id IS NULL
103
+ SELECT title, content, path FROM memory_nodes
104
+ WHERE (project_id IS NULL OR project_id = (SELECT id FROM projects WHERE name = ?))
95
105
  AND (
96
106
  path LIKE '%mission.md'
97
107
  OR path LIKE '%standards.md'
@@ -100,7 +110,7 @@ export class ContextBuilder {
100
110
  ORDER BY updated_at DESC
101
111
  LIMIT 10
102
112
  `);
103
- return stmt.all() || [];
113
+ return stmt.all(project) || [];
104
114
  }
105
115
  catch (e) {
106
116
  console.warn('⚠️ No global nodes found:', e.message);
@@ -139,17 +149,16 @@ export class ContextBuilder {
139
149
  _getTaskNodes(project, keyword) {
140
150
  try {
141
151
  const stmt = this.db.prepare(`
142
- SELECT DISTINCT n.title, n.content, n.path
152
+ SELECT DISTINCT n.title, n.content, n.path
143
153
  FROM memory_nodes n
144
154
  JOIN projects p ON p.id = n.project_id
145
- LEFT JOIN search_idx s ON s.node_id = n.id
146
- WHERE p.name = ?
147
- AND (n.content LIKE ? OR s.content MATCH ?)
155
+ WHERE p.name = ?
156
+ AND (n.content LIKE ? OR n.id IN (SELECT node_id FROM search_idx WHERE search_idx MATCH ?))
148
157
  ORDER BY n.updated_at DESC
149
158
  LIMIT 20
150
159
  `);
151
160
  const pattern = `%${keyword}%`;
152
- return stmt.all(project, pattern, keyword) || [];
161
+ return stmt.all(project, pattern, ftsQuery(keyword)) || [];
153
162
  }
154
163
  catch (e) {
155
164
  console.warn(`⚠️ No task nodes found for "${keyword}":`, e.message);
@@ -210,7 +219,7 @@ export class ContextBuilder {
210
219
  if (import.meta.url === `file://${process.argv[1]}`) {
211
220
  const [mode, project, keyword] = process.argv.slice(2);
212
221
  if (!mode || !project) {
213
- console.error('Usage: node context-builder.mjs <mode> <project> [keyword]');
222
+ console.error('Uso: forja context:smart [--mode global|domain|task] [--task <termo>]');
214
223
  console.error('Modes: global, domain, task');
215
224
  process.exit(1);
216
225
  }
@@ -16,11 +16,9 @@
16
16
  * invitation to review, so (unlike drift) it's allowed to escalate `check:all`'s verdict to `fail`.
17
17
  */
18
18
  import { spawnSync } from 'node:child_process';
19
- import path from 'node:path';
20
19
  import { fileURLToPath } from 'node:url';
21
- import { resolveScript } from "./registry.js";
20
+ import { script as resolveFrameworkScript } from '../paths.js';
22
21
  const __filename = fileURLToPath(import.meta.url);
23
- const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
24
22
  const ID = 'architecture-check';
25
23
  const TITLE = 'architecture:check — o código respeita a Constitution compilada (SPEC-033, opt-in)';
26
24
  /** Cada violação imprime sua própria linha de severidade (ver cmdCheck em scripts/architecture.ts)
@@ -30,7 +28,7 @@ function violationCountFrom(stdout) {
30
28
  }
31
29
  /** Roda `architecture:check` num subprocesso e traduz o resultado num `Result` de gate. */
32
30
  export async function runArchitectureGate() {
33
- const script = resolveScript(repoRoot, 'scripts/architecture.ts');
31
+ const script = resolveFrameworkScript('scripts/architecture');
34
32
  const result = spawnSync('node', [script, 'check'], { cwd: process.cwd(), encoding: 'utf8' });
35
33
  const stdout = result.stdout ?? '';
36
34
  if (result.error !== undefined || (result.status !== 0 && result.status !== 1)) {
@@ -79,7 +79,7 @@ export declare function runChecks({ checks, scope, env }: {
79
79
  * @param {Result[]} results
80
80
  * @returns {'ok'|'warn'|'fail'}
81
81
  */
82
- export declare function worstStatus(results: any): "ok" | "warn" | "fail";
82
+ export declare function worstStatus(results: any): "fail" | "ok" | "warn";
83
83
  /**
84
84
  * Remove template literals do fonte antes de qualquer análise estática de `import`.
85
85
  *
@@ -14,11 +14,9 @@
14
14
  * corrige ou bloqueia sozinho).
15
15
  */
16
16
  import { spawnSync } from 'node:child_process';
17
- import path from 'node:path';
18
17
  import { fileURLToPath } from 'node:url';
19
- import { resolveScript } from "./registry.js";
18
+ import { script as resolveFrameworkScript } from '../paths.js';
20
19
  const __filename = fileURLToPath(import.meta.url);
21
- const repoRoot = path.resolve(path.dirname(__filename), '..', '..');
22
20
  const ID = 'drift-check';
23
21
  const TITLE = 'drift:check — o verified continua verdade (SPEC-030, opt-in)';
24
22
  function driftCountFrom(stdout) {
@@ -26,7 +24,7 @@ function driftCountFrom(stdout) {
26
24
  }
27
25
  /** Roda `drift:check` num subprocesso e traduz o resultado num `Result` de gate. */
28
26
  export async function runDriftGate() {
29
- const script = resolveScript(repoRoot, 'scripts/drift-check.ts');
27
+ const script = resolveFrameworkScript('scripts/drift-check');
30
28
  const result = spawnSync('node', [script], { cwd: process.cwd(), encoding: 'utf8' });
31
29
  const stdout = result.stdout ?? '';
32
30
  // exit 0 = sem drift, exit 1 = drift detectado (ambos "o comando rodou"); qualquer outro código —
@@ -8,11 +8,11 @@
8
8
  * Este módulo **compõe** os runners que já existem — não reimplementa nenhum check. Uma máquina que
9
9
  * chama as outras máquinas, e reduz tudo a um `worstStatus`.
10
10
  */
11
- import { runChecks as runHealthChecks, worstStatus } from "./health.js";
12
- import { runProjectSmoke } from "./project-smoke.js";
13
- import { runReleaseChecks } from "./release.js";
14
- import { runDriftGate } from "./drift-gate.js";
15
- import { runArchitectureGate } from "./architecture-gate.js";
11
+ import { runChecks as runHealthChecks, worstStatus } from './health.js';
12
+ import { runProjectSmoke } from './project-smoke.js';
13
+ import { runReleaseChecks } from './release.js';
14
+ import { runDriftGate } from './drift-gate.js';
15
+ import { runArchitectureGate } from './architecture-gate.js';
16
16
  /**
17
17
  * Roda os gates aplicáveis ao framework e devolve os resultados agrupados por gate.
18
18
  *