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
@@ -2,17 +2,15 @@
2
2
  * Memory Generator - Gera estrutura completa de memória hierárquica
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
  * Template de arquivos da estrutura de memória
11
9
  * Organizado por categorias para facilitar manutenção
12
10
  */
13
11
  const memoryTemplates = {
14
- // === GLOBAL (00-global) ===
15
- 'memory/README.md': `# Memoria do Projeto
12
+ // === GLOBAL (00-global) ===
13
+ 'memory/README.md': `# Memoria do Projeto
16
14
 
17
15
  Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
18
16
 
@@ -21,8 +19,7 @@ Esta estrutura foi desenhada para reduzir perda de contexto em projetos grandes.
21
19
  - Trabalhar com memoria em camadas + handoff incremental.
22
20
  - Registrar decisoes, resumos e execucoes para continuidade.
23
21
  `,
24
-
25
- 'memory/00-global/mission.md': `# Missao do Projeto
22
+ 'memory/00-global/mission.md': `# Missao do Projeto
26
23
 
27
24
  Construir software com clareza arquitetural, seguranca by-default e entrega continua.
28
25
 
@@ -32,8 +29,7 @@ Construir software com clareza arquitetural, seguranca by-default e entrega cont
32
29
  - Qualidade e seguranca desde o inicio
33
30
  - Documentacao viva
34
31
  `,
35
-
36
- 'memory/00-global/standards.md': `# Padroes Globais
32
+ 'memory/00-global/standards.md': `# Padroes Globais
37
33
 
38
34
  ## Idioma
39
35
  - Toda comunicacao e documentacao em **pt-BR**.
@@ -46,8 +42,7 @@ Construir software com clareza arquitetural, seguranca by-default e entrega cont
46
42
  - Cada mudanca deve registrar impacto, risco e rollback.
47
43
  - Priorizar padroes reutilizaveis.
48
44
  `,
49
-
50
- 'memory/00-global/context-policy.md': `# Politica de Contexto Longo
45
+ 'memory/00-global/context-policy.md': `# Politica de Contexto Longo
51
46
 
52
47
  ## Objetivo
53
48
  Permitir trabalho em larga escala sem depender de janela unica gigantesca.
@@ -70,8 +65,7 @@ Se houver esgotamento de cota ou necessidade de mudar de IA:
70
65
  Esta estrutura **nao aumenta** limite nativo do modelo.
71
66
  Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
72
67
  `,
73
-
74
- 'memory/00-global/agent-contract.md': `# Contrato de Agentes
68
+ 'memory/00-global/agent-contract.md': `# Contrato de Agentes
75
69
 
76
70
  ## Orquestrador
77
71
  - Decompõe trabalho em subtarefas independentes.
@@ -87,8 +81,7 @@ Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
87
81
  - Verifica regressao, seguranca e cobertura de testes.
88
82
  - Bloqueia merge se encontrar risco critico.
89
83
  `,
90
-
91
- 'memory/00-global/context-index.md': `# Indice de Contexto
84
+ 'memory/00-global/context-index.md': `# Indice de Contexto
92
85
 
93
86
  ## Ordem de Leitura
94
87
  1. memory/00-global/mission.md
@@ -101,43 +94,36 @@ Ela reduz perda de memoria por segmentacao, resumo e continuidade operacional.
101
94
  8. memory/90-decisions/ADR-*.md
102
95
  9. memory/70-summaries/*
103
96
  `,
104
-
105
- // === PRODUCT (10-product) ===
106
- 'memory/10-product/vision.md': `# Visao de Produto
97
+ // === PRODUCT (10-product) ===
98
+ 'memory/10-product/vision.md': `# Visao de Produto
107
99
 
108
100
  Descreva objetivo, publico-alvo, problema e proposta de valor.
109
101
  `,
110
-
111
- 'memory/10-product/personas.md': `# Personas
102
+ 'memory/10-product/personas.md': `# Personas
112
103
 
113
104
  Liste personas e dores principais.
114
105
  `,
115
-
116
- 'memory/10-product/business-rules.md': `# Regras de Negocio
106
+ 'memory/10-product/business-rules.md': `# Regras de Negocio
117
107
 
118
108
  Documente regras imutaveis e validacoes criticas.
119
109
  `,
120
-
121
- 'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
110
+ 'memory/10-product/nfrs.md': `# Requisitos Nao Funcionais
122
111
 
123
112
  - Performance
124
113
  - Seguranca
125
114
  - Observabilidade
126
115
  - Escalabilidade
127
116
  `,
128
-
129
- // === ARCHITECTURE (20-architecture) ===
130
- 'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
117
+ // === ARCHITECTURE (20-architecture) ===
118
+ 'memory/20-architecture/system-overview.md': `# Visao Geral da Arquitetura
131
119
 
132
120
  Descreva contexto, fronteiras e integracoes principais.
133
121
  `,
134
-
135
- 'memory/20-architecture/frontend.md': `# Frontend
122
+ 'memory/20-architecture/frontend.md': `# Frontend
136
123
 
137
124
  Defina padroes de componentizacao, acessibilidade e performance.
138
125
  `,
139
-
140
- 'memory/20-architecture/backend.md': `# Backend
126
+ 'memory/20-architecture/backend.md': `# Backend
141
127
 
142
128
  ## Diretriz principal
143
129
  - Backend em **NestJS** por padrao.
@@ -148,65 +134,54 @@ Defina padroes de componentizacao, acessibilidade e performance.
148
134
  - Servicos com regras de negocio
149
135
  - Repositorios/integradores isolados
150
136
  `,
151
-
152
- 'memory/20-architecture/data.md': `# Dados
137
+ 'memory/20-architecture/data.md': `# Dados
153
138
 
154
139
  Descreva entidades, relacionamentos e politicas de retencao.
155
140
  `,
156
-
157
- 'memory/20-architecture/security.md': `# Seguranca
141
+ 'memory/20-architecture/security.md': `# Seguranca
158
142
 
159
143
  - Principio do menor privilegio
160
144
  - Segredos fora do codigo
161
145
  - Validacao de entrada em todas as rotas
162
146
  - Logs sem dados sensiveis
163
147
  `,
164
-
165
- 'memory/20-architecture/observability.md': `# Observabilidade
148
+ 'memory/20-architecture/observability.md': `# Observabilidade
166
149
 
167
150
  - Logs estruturados
168
151
  - Metricas e tracing
169
152
  - Alertas por SLO
170
153
  `,
171
-
172
- // === DOMAINS (30-domains) ===
173
- 'memory/30-domains/auth/context.md': `# Contexto de Auth
154
+ // === DOMAINS (30-domains) ===
155
+ 'memory/30-domains/auth/context.md': `# Contexto de Auth
174
156
 
175
157
  Defina escopo funcional de autenticacao/autorizacao.
176
158
  `,
177
-
178
- 'memory/30-domains/auth/rules.md': `# Regras de Auth
159
+ 'memory/30-domains/auth/rules.md': `# Regras de Auth
179
160
 
180
161
  Liste regras e restricoes de seguranca.
181
162
  `,
182
-
183
- 'memory/30-domains/auth/api.md': `# API de Auth
163
+ 'memory/30-domains/auth/api.md': `# API de Auth
184
164
 
185
165
  Documente endpoints, payloads e erros.
186
166
  `,
187
-
188
- 'memory/30-domains/billing/context.md': `# Contexto de Billing
167
+ 'memory/30-domains/billing/context.md': `# Contexto de Billing
189
168
 
190
169
  Defina cobranca, ciclo e integracoes.
191
170
  `,
192
-
193
- 'memory/30-domains/billing/rules.md': `# Regras de Billing
171
+ 'memory/30-domains/billing/rules.md': `# Regras de Billing
194
172
 
195
173
  Descreva calculos, status e excecoes.
196
174
  `,
197
-
198
- 'memory/30-domains/billing/api.md': `# API de Billing
175
+ 'memory/30-domains/billing/api.md': `# API de Billing
199
176
 
200
177
  Documente endpoints e regras de idempotencia.
201
178
  `,
202
-
203
- // === DELIVERY (40-delivery) ===
204
- 'memory/40-delivery/roadmap.md': `# Roadmap
179
+ // === DELIVERY (40-delivery) ===
180
+ 'memory/40-delivery/roadmap.md': `# Roadmap
205
181
 
206
182
  Mapeie entregas por trimestre/sprint.
207
183
  `,
208
-
209
- 'memory/40-delivery/current-sprint.md': `# Sprint Atual
184
+ 'memory/40-delivery/current-sprint.md': `# Sprint Atual
210
185
 
211
186
  ## Objetivos
212
187
  -
@@ -217,14 +192,12 @@ Mapeie entregas por trimestre/sprint.
217
192
  ## Riscos
218
193
  -
219
194
  `,
220
-
221
- 'memory/40-delivery/backlog.md': `# Backlog
195
+ 'memory/40-delivery/backlog.md': `# Backlog
222
196
 
223
197
  Liste itens priorizados com contexto minimo.
224
198
  `,
225
-
226
- // === ORCHESTRATION (50-orchestration) ===
227
- 'memory/50-orchestration/topology.md': `# Topologia Multiagente
199
+ // === ORCHESTRATION (50-orchestration) ===
200
+ 'memory/50-orchestration/topology.md': `# Topologia Multiagente
228
201
 
229
202
  ## Papeis
230
203
  - Orquestrador
@@ -240,8 +213,7 @@ Liste itens priorizados com contexto minimo.
240
213
  3. Handoffs sao registrados.
241
214
  4. Reviewer valida e aprova.
242
215
  `,
243
-
244
- 'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
216
+ 'memory/50-orchestration/routing.md': `# Roteamento de Tarefas
245
217
 
246
218
  ## Regras de roteamento
247
219
  - API e dominio server-side -> backend-nest
@@ -252,8 +224,7 @@ Liste itens priorizados com contexto minimo.
252
224
  ## Critico
253
225
  Subtarefas devem ter dono unico por arquivo para evitar conflito.
254
226
  `,
255
-
256
- 'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
227
+ 'memory/50-orchestration/handoff-protocol.md': `# Protocolo de Handoff
257
228
 
258
229
  Cada handoff deve conter:
259
230
  - contexto minimo
@@ -262,8 +233,7 @@ Cada handoff deve conter:
262
233
  - riscos e pontos abertos
263
234
  - proximos passos objetivos
264
235
  `,
265
-
266
- 'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
236
+ 'memory/50-orchestration/parallel-playbook.md': `# Playbook de Paralelizacao
267
237
 
268
238
  ## Quando paralelizar
269
239
  - Subtarefas independentes por dominio.
@@ -273,35 +243,30 @@ Cada handoff deve conter:
273
243
  - Mudanca bloqueante para a proxima etapa.
274
244
  - Refactor altamente acoplado no mesmo modulo.
275
245
  `,
276
-
277
- 'memory/50-orchestration/handoffs/README.md': `# Handoffs
246
+ 'memory/50-orchestration/handoffs/README.md': `# Handoffs
278
247
 
279
248
  Registre cada transicao em arquivos markdown com timestamp.
280
249
  Exemplo: 2026-04-18T12-30_worker-backend_para_reviewer.md
281
250
  `,
282
-
283
- // === RUNS (60-runs) ===
284
- 'memory/60-runs/README.md': `# Runs
251
+ // === RUNS (60-runs) ===
252
+ 'memory/60-runs/README.md': `# Runs
285
253
 
286
254
  Log de execucao por ciclo/sprint.
287
255
  `,
288
-
289
- // === SUMMARIES (70-summaries) ===
290
- 'memory/70-summaries/global-summary.md': `# Resumo Global
256
+ // === SUMMARIES (70-summaries) ===
257
+ 'memory/70-summaries/global-summary.md': `# Resumo Global
291
258
 
292
259
  Atualize a cada marco importante com:
293
260
  - estado atual
294
261
  - decisoes novas
295
262
  - riscos ativos
296
263
  `,
297
-
298
- 'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
264
+ 'memory/70-summaries/domain-summary.md': `# Resumo por Dominio
299
265
 
300
266
  Mantenha resumos curtos por dominio para carregamento rapido de contexto.
301
267
  `,
302
-
303
- // === DATA (80-data) ===
304
- 'memory/80-data/memory-db.md': `# Memory DB (SQLite)
268
+ // === DATA (80-data) ===
269
+ 'memory/80-data/memory-db.md': `# Memory DB (SQLite)
305
270
 
306
271
  ## Objetivo
307
272
  Armazenar indice operacional da documentacao para busca e continuidade de contexto.
@@ -317,9 +282,8 @@ Armazenar indice operacional da documentacao para busca e continuidade de contex
317
282
  2. Rodar sincronizacao
318
283
  3. Consultar contexto por texto ou tipo
319
284
  `,
320
-
321
- // === DECISIONS (90-decisions) ===
322
- 'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
285
+ // === DECISIONS (90-decisions) ===
286
+ 'memory/90-decisions/ADR-0001-template.md': `# ADR-0001: Titulo da Decisao
323
287
 
324
288
  ## Contexto
325
289
 
@@ -330,17 +294,15 @@ Armazenar indice operacional da documentacao para busca e continuidade de contex
330
294
  ## Alternativas consideradas
331
295
  `,
332
296
  };
333
-
334
297
  /**
335
298
  * Gera estrutura de agentes
336
299
  */
337
300
  const agentTemplates = {
338
- 'agents/README.md': `# Agents
301
+ 'agents/README.md': `# Agents
339
302
 
340
303
  Agentes especializados para dividir trabalho em paralelo.
341
304
  `,
342
-
343
- 'agents/orchestrator.md': `# Agent: Orchestrator
305
+ 'agents/orchestrator.md': `# Agent: Orchestrator
344
306
 
345
307
  ## Responsabilidade
346
308
  Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
@@ -350,8 +312,7 @@ Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
350
312
  - distribuicao por agentes
351
313
  - consolidacao de handoffs
352
314
  `,
353
-
354
- 'agents/backend-nest.md': `# Agent: Backend NestJS
315
+ 'agents/backend-nest.md': `# Agent: Backend NestJS
355
316
 
356
317
  ## Escopo
357
318
  - modulos, controllers, services, dto, guard, pipe
@@ -361,26 +322,22 @@ Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
361
322
  - NestJS por padrao
362
323
  - validacao de entrada obrigatoria
363
324
  `,
364
-
365
- 'agents/frontend.md': `# Agent: Frontend
325
+ 'agents/frontend.md': `# Agent: Frontend
366
326
 
367
327
  ## Escopo
368
328
  - componentes, acessibilidade, performance, UX
369
329
  `,
370
-
371
- 'agents/dba.md': `# Agent: DBA
330
+ 'agents/dba.md': `# Agent: DBA
372
331
 
373
332
  ## Escopo
374
333
  - modelagem, indices, migracoes, tuning de query
375
334
  `,
376
-
377
- 'agents/security.md': `# Agent: Security
335
+ 'agents/security.md': `# Agent: Security
378
336
 
379
337
  ## Escopo
380
338
  - threat modeling, hardening, authz/authn, secrets, auditoria
381
339
  `,
382
-
383
- 'agents/reviewer.md': `# Agent: Reviewer
340
+ 'agents/reviewer.md': `# Agent: Reviewer
384
341
 
385
342
  ## Escopo
386
343
  - regressao funcional
@@ -388,12 +345,11 @@ Planejamento, decomposicao de tarefas, atribuicao de ownership e consolidacao.
388
345
  - cobertura de testes
389
346
  `,
390
347
  };
391
-
392
348
  /**
393
349
  * Gera estrutura de skills
394
350
  */
395
351
  const skillTemplates = {
396
- 'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
352
+ 'skills/triage-task/SKILL.md': `# Skill: Triage de Tarefa
397
353
 
398
354
  ## Objetivo
399
355
  Classificar demanda em: rapido, medio, complexo.
@@ -404,8 +360,7 @@ Classificar demanda em: rapido, medio, complexo.
404
360
  - owner sugerido
405
361
  - fatias de execucao
406
362
  `,
407
-
408
- 'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
363
+ 'skills/context-compaction/SKILL.md': `# Skill: Compactacao de Contexto
409
364
 
410
365
  ## Objetivo
411
366
  Gerar resumo operacional sem perder decisoes chave.
@@ -415,8 +370,7 @@ Gerar resumo operacional sem perder decisoes chave.
415
370
  - remover redundancia
416
371
  - preservar links para fontes internas
417
372
  `,
418
-
419
- 'skills/handoff/SKILL.md': `# Skill: Handoff
373
+ 'skills/handoff/SKILL.md': `# Skill: Handoff
420
374
 
421
375
  ## Template
422
376
  - contexto
@@ -425,8 +379,7 @@ Gerar resumo operacional sem perder decisoes chave.
425
379
  - pendencias
426
380
  - proximo agente
427
381
  `,
428
-
429
- 'skills/nest-api/SKILL.md': `# Skill: Nest API
382
+ 'skills/nest-api/SKILL.md': `# Skill: Nest API
430
383
 
431
384
  ## Checklist
432
385
  - modulo criado
@@ -434,8 +387,7 @@ Gerar resumo operacional sem perder decisoes chave.
434
387
  - controller + service
435
388
  - testes
436
389
  `,
437
-
438
- 'skills/self-healing/SKILL.md': `# Skill: Auto-Diagnóstico (Self-Healing)
390
+ 'skills/self-healing/SKILL.md': `# Skill: Auto-Diagnóstico (Self-Healing)
439
391
 
440
392
  ## Objetivo
441
393
  Resolver falhas de build, testes ou tipos sem intervenção humana.
@@ -446,8 +398,7 @@ Resolver falhas de build, testes ou tipos sem intervenção humana.
446
398
  3. Consultar documentação interna ou padrões do projeto.
447
399
  4. Propor correção mínima e rodar validação novamente.
448
400
  `,
449
-
450
- 'skills/validate-handoff/SKILL.md': `# Skill: Validação e Review de Segurança (Gatekeeper)
401
+ 'skills/validate-handoff/SKILL.md': `# Skill: Validação e Review de Segurança (Gatekeeper)
451
402
 
452
403
  ## Objetivo
453
404
  Atuar como Gatekeeper final para garantir que nenhum código inseguro ou incompleto entre no pipeline.
@@ -467,8 +418,7 @@ Antes de aceitar um handoff, o Reviewer deve validar:
467
418
  - [ ] Aprovado (Status: \`done\` no DB)
468
419
  - [ ] Rejeitado (Status: \`blocked\` + pendências listadas)
469
420
  `,
470
-
471
- 'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
421
+ 'skills/ui-fidelity/SKILL.md': `# Skill: Fidelidade Visual
472
422
 
473
423
  ## Objetivo
474
424
  Garantir que a UI segue padrões de elite.
@@ -478,8 +428,7 @@ Garantir que a UI segue padrões de elite.
478
428
  2. Comparar o código gerado com os padrões de espaçamento, tipografia e cores da referência.
479
429
  3. Ajustar CSS/Componentes para atingir qualidade visual de nível mundial.
480
430
  `,
481
-
482
- 'skills/reasoning-protocol/SKILL.md': `# Skill: Raciocínio Estruturado (Chain-of-Thought)
431
+ 'skills/reasoning-protocol/SKILL.md': `# Skill: Raciocínio Estruturado (Chain-of-Thought)
483
432
 
484
433
  ## Objetivo
485
434
  Reduzir erros de implementação através de análise lógica explícita.
@@ -492,8 +441,7 @@ Antes de qualquer código ou plano de ação, preencha o bloco \`## Raciocínio
492
441
  3. **Alternativas**: Existe mais de uma forma de fazer? Por que escolhi esta?
493
442
  4. **Plano de Ataque**: Passo-a-passo lógico da implementação.
494
443
  `,
495
-
496
- 'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
444
+ 'skills/llm-provider-routing/SKILL.md': `# Skill: Roteamento de LLM Providers
497
445
 
498
446
  ## Objetivo
499
447
  Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico fornecedor.
@@ -517,8 +465,7 @@ Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico forne
517
465
  4. Rodar um teste pequeno antes de delegar sprint inteira.
518
466
  5. Registrar handoff Hermes quando a troca impactar entrega.
519
467
  `,
520
-
521
- 'skills/MANIFEST.json': `{
468
+ 'skills/MANIFEST.json': `{
522
469
  "version": "0.5.0",
523
470
  "skills": [
524
471
  { "id": "triage", "path": "skills/triage-task/SKILL.md", "description": "Classificação de tarefas" },
@@ -534,12 +481,11 @@ Selecionar e configurar uma LLM por papel sem amarrar o projeto a um unico forne
534
481
  }
535
482
  `,
536
483
  };
537
-
538
484
  /**
539
485
  * Gera estrutura de prompts
540
486
  */
541
487
  const promptTemplates = {
542
- 'prompts/project-prompt-base.md': `# Prompt Base do Projeto
488
+ 'prompts/project-prompt-base.md': `# Prompt Base do Projeto
543
489
 
544
490
  Voce e um agente de engenharia sênior neste repositorio.
545
491
 
@@ -562,8 +508,7 @@ Regras:
562
508
  - **OBRIGATÓRIO**: Usar a skill \`reasoning\` e preencher o bloco \`## Raciocínio Estruturado\` antes de cada resposta técnica.
563
509
  - entregar: raciocínio, entendimento, plano, implementacao, validacao e proximos passos
564
510
  `,
565
-
566
- 'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
511
+ 'prompts/multi-agent-orchestrator.md': `# Prompt Orquestrador Multiagente
567
512
 
568
513
  Atue como orquestrador. Divida o trabalho em subtarefas independentes, com ownership por arquivo.
569
514
 
@@ -576,8 +521,7 @@ Para cada subtarefa, entregue:
576
521
 
577
522
  No final, consolide os handoffs em ordem cronologica.
578
523
  `,
579
-
580
- 'prompts/worker-task-template.md': `# Prompt Worker
524
+ 'prompts/worker-task-template.md': `# Prompt Worker
581
525
 
582
526
  Voce recebeu uma subtarefa.
583
527
 
@@ -590,12 +534,11 @@ Responda com:
590
534
  6. Riscos e pendencias
591
535
  `,
592
536
  };
593
-
594
537
  /**
595
538
  * Gera arquivos de configuração globais
596
539
  */
597
540
  const configTemplates = {
598
- 'AGENTS.md': `# AGENTS
541
+ 'AGENTS.md': `# AGENTS
599
542
 
600
543
  ## Linguagem
601
544
  - Sempre responder e documentar em **pt-BR**.
@@ -612,8 +555,7 @@ const configTemplates = {
612
555
  - Seguir hierarchy em /memory
613
556
  - Registrar handoff e resumo ao fim de cada entrega relevante
614
557
  `,
615
-
616
- '.memoryrc.json': `{
558
+ '.memoryrc.json': `{
617
559
  "strategy": "hierarchical",
618
560
  "maxContextHint": "1M+ por segmentacao e resumo incremental",
619
561
  "handoffDir": "memory/50-orchestration/handoffs",
@@ -623,8 +565,7 @@ const configTemplates = {
623
565
  "backendDefault": "nestjs"
624
566
  }
625
567
  `,
626
-
627
- '.gitignore': `node_modules
568
+ '.gitignore': `node_modules
628
569
  dist
629
570
  .env
630
571
  .DS_Store
@@ -632,12 +573,11 @@ coverage
632
573
  .context
633
574
  `,
634
575
  };
635
-
636
576
  /**
637
577
  * Gera scripts utilitários
638
578
  */
639
579
  const scriptTemplates = {
640
- 'scripts/build-context-pack.mjs': `import fs from 'node:fs';
580
+ 'scripts/build-context-pack.mjs': `import fs from 'node:fs';
641
581
  import path from 'node:path';
642
582
  import { fileURLToPath } from 'node:url';
643
583
 
@@ -669,8 +609,7 @@ for (const rel of priorityFiles) {
669
609
  fs.writeFileSync(outFile, content, 'utf8');
670
610
  console.log('Context pack gerado em: ' + outFile);
671
611
  `,
672
-
673
- 'scripts/append-handoff.mjs': `import fs from 'node:fs';
612
+ 'scripts/append-handoff.mjs': `import fs from 'node:fs';
674
613
  import path from 'node:path';
675
614
  import { fileURLToPath } from 'node:url';
676
615
 
@@ -696,8 +635,7 @@ const template = '# Handoff: ' + from + ' -> ' + to + '\\n\\n'
696
635
  fs.writeFileSync(file, template, 'utf8');
697
636
  console.log('Handoff criado: ' + file);
698
637
  `,
699
-
700
- 'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
638
+ 'scripts/lib/skill-loader.mjs': `import fs from 'node:fs';
701
639
  import path from 'node:path';
702
640
  import { fileURLToPath } from 'node:url';
703
641
 
@@ -717,8 +655,7 @@ export function getSkill(id) {
717
655
  return skills.find(s => s.id === id);
718
656
  }
719
657
  `,
720
-
721
- 'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
658
+ 'scripts/memory-vacuum.mjs': `import fs from 'node:fs';
722
659
  import path from 'node:path';
723
660
  import { fileURLToPath } from 'node:url';
724
661
 
@@ -755,8 +692,7 @@ if (archived > 0) {
755
692
  console.log('Vacuum: ' + archived + ' runs movidas para archive/');
756
693
  }
757
694
  `,
758
-
759
- 'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
695
+ 'scripts/memory-watcher.mjs': `import { watch } from 'node:fs';
760
696
  import { exec } from 'node:child_process';
761
697
  import path from 'node:path';
762
698
  import { fileURLToPath } from 'node:url';
@@ -787,58 +723,51 @@ watchDirs.forEach(dir => {
787
723
  });
788
724
  `,
789
725
  };
790
-
791
726
  /**
792
727
  * Retorna todos os templates combinados
793
728
  */
794
729
  export function getAllMemoryTemplates() {
795
- return {
796
- ...memoryTemplates,
797
- ...agentTemplates,
798
- ...skillTemplates,
799
- ...promptTemplates,
800
- ...configTemplates,
801
- ...scriptTemplates,
802
- };
730
+ return {
731
+ ...memoryTemplates,
732
+ ...agentTemplates,
733
+ ...skillTemplates,
734
+ ...promptTemplates,
735
+ ...configTemplates,
736
+ ...scriptTemplates,
737
+ };
803
738
  }
804
-
805
739
  /**
806
740
  * Escreve a estrutura completa de memória
807
741
  * @param {string} baseDir - Diretório base para geração
808
742
  * @param {Object} options - Opções (force, noGitkeep)
809
743
  */
810
744
  export function generateMemoryStructure(baseDir, options = {}) {
811
- const allTemplates = getAllMemoryTemplates();
812
-
813
- // Escrever todos os arquivos
814
- for (const [relativePath, content] of Object.entries(allTemplates)) {
815
- writeFileSafe(path.join(baseDir, relativePath), content, options);
816
- }
817
-
818
- // Criar diretórios vazios
819
- const emptyDirs = [
820
- 'memory/30-domains/shared',
821
- 'memory/90-decisions/archive',
822
- 'docs',
823
- 'scripts/lib',
824
- '.memory/sqlite',
825
- '.context',
826
- ];
827
-
828
- for (const relDir of emptyDirs) {
829
- const abs = path.join(baseDir, relDir);
830
- ensureDir(abs);
831
- maybeGitkeep(abs, options);
832
- }
833
-
834
- return {
835
- success: true,
836
- filesWritten: Object.keys(allTemplates).length,
837
- emptyDirsCreated: emptyDirs.length,
838
- };
745
+ const allTemplates = getAllMemoryTemplates();
746
+ // Escrever todos os arquivos
747
+ for (const [relativePath, content] of Object.entries(allTemplates)) {
748
+ writeFileSafe(path.join(baseDir, relativePath), content, options);
749
+ }
750
+ // Criar diretórios vazios
751
+ const emptyDirs = [
752
+ 'memory/30-domains/shared',
753
+ 'memory/90-decisions/archive',
754
+ 'docs',
755
+ 'scripts/lib',
756
+ '.memory/sqlite',
757
+ '.context',
758
+ ];
759
+ for (const relDir of emptyDirs) {
760
+ const abs = path.join(baseDir, relDir);
761
+ ensureDir(abs);
762
+ maybeGitkeep(abs, options);
763
+ }
764
+ return {
765
+ success: true,
766
+ filesWritten: Object.keys(allTemplates).length,
767
+ emptyDirsCreated: emptyDirs.length,
768
+ };
839
769
  }
840
-
841
770
  export default {
842
- generateMemoryStructure,
843
- getAllMemoryTemplates,
771
+ generateMemoryStructure,
772
+ getAllMemoryTemplates,
844
773
  };
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Gera estrutura completa do NestJS backend
3
+ * @param {string} baseDir - Diretório base
4
+ * @param {string} projectName - Nome do projeto
5
+ * @param {Object} options - Opções (force, noGitkeep)
6
+ */
7
+ export function generateNestStructure(baseDir: string, projectName: string, options?: any): {
8
+ success: boolean;
9
+ filesWritten: number;
10
+ emptyDirsCreated: number;
11
+ };
12
+ declare namespace _default {
13
+ export { generateNestStructure };
14
+ }
15
+ export default _default;