forjajs 4.1.2 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) 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 +139 -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-upgrade.d.ts +0 -4
  75. package/dist/lib/project-upgrade.js +19 -1
  76. package/dist/lib/project-wiring.d.ts +54 -0
  77. package/dist/lib/project-wiring.js +391 -0
  78. package/dist/lib/status-model.js +18 -7
  79. package/dist/lib/templates.d.ts +24 -0
  80. package/dist/lib/templates.js +77 -0
  81. package/dist/lib/validators/structure-validator.js +0 -1
  82. package/dist/lib/workspace.d.ts +7 -0
  83. package/dist/lib/workspace.js +20 -2
  84. package/dist/packages/adapter-git/src/index.js +2 -2
  85. package/dist/packages/context/src/index.js +1 -1
  86. package/dist/packages/core/src/index.js +1 -1
  87. package/dist/packages/evals/src/index.js +1 -1
  88. package/dist/packages/events/src/index.js +1 -1
  89. package/dist/packages/graph/src/index.js +1 -1
  90. package/dist/packages/mcp/src/index.d.ts +1 -1
  91. package/dist/packages/observability/src/index.js +1 -1
  92. package/dist/packages/orchestration/src/index.js +1 -1
  93. package/dist/packages/planner/src/index.js +1 -1
  94. package/dist/packages/policy/src/index.js +1 -1
  95. package/dist/packages/runtime/src/index.js +1 -1
  96. package/dist/packages/sandbox/src/index.js +1 -1
  97. package/dist/packages/validator/src/index.js +1 -1
  98. package/dist/scripts/adr.js +4 -4
  99. package/dist/scripts/agent-harness.js +30 -23
  100. package/dist/scripts/agent-router.js +22 -5
  101. package/dist/scripts/agent.js +5 -5
  102. package/dist/scripts/architecture.js +6 -6
  103. package/dist/scripts/audit-query.js +1 -1
  104. package/dist/scripts/audit-sync.js +1 -1
  105. package/dist/scripts/build-smart-context.d.ts +19 -1
  106. package/dist/scripts/build-smart-context.js +84 -68
  107. package/dist/scripts/check-standards.js +8 -3
  108. package/dist/scripts/code-context.js +1 -1
  109. package/dist/scripts/compress-memory.js +3 -2
  110. package/dist/scripts/compress-project-memory.js +2 -2
  111. package/dist/scripts/context-ops.js +13 -5
  112. package/dist/scripts/cost-economy.js +4 -4
  113. package/dist/scripts/demo-autonomy.js +11 -11
  114. package/dist/scripts/demo-workspace.js +12 -4
  115. package/dist/scripts/dev.js +8 -7
  116. package/dist/scripts/drift-check.js +5 -5
  117. package/dist/scripts/engineer.js +11 -11
  118. package/dist/scripts/evidence.js +4 -4
  119. package/dist/scripts/extract-global-knowledge.js +6 -4
  120. package/dist/scripts/forja-setup.js +2 -1
  121. package/dist/scripts/forja-status.js +5 -4
  122. package/dist/scripts/gates.js +1 -1
  123. package/dist/scripts/generate-dashboard.js +6 -4
  124. package/dist/scripts/governance-dashboard.js +2 -2
  125. package/dist/scripts/hook-session-start.js +11 -10
  126. package/dist/scripts/hook-user-prompt.js +3 -2
  127. package/dist/scripts/incident.js +4 -4
  128. package/dist/scripts/llm-fit.js +11 -11
  129. package/dist/scripts/memory-audit.js +1 -1
  130. package/dist/scripts/memory-schema.js +3 -2
  131. package/dist/scripts/orchestrate.js +4 -5
  132. package/dist/scripts/project-smoke.js +13 -2
  133. package/dist/scripts/project-templates.d.ts +1 -0
  134. package/dist/scripts/project-templates.js +20 -0
  135. package/dist/scripts/project-upgrade.d.ts +13 -0
  136. package/dist/scripts/project-upgrade.js +110 -40
  137. package/dist/scripts/project-wire.d.ts +8 -0
  138. package/dist/scripts/project-wire.js +55 -0
  139. package/dist/scripts/provenance.js +3 -3
  140. package/dist/scripts/query-universal-memory.js +7 -4
  141. package/dist/scripts/release-check.js +1 -1
  142. package/dist/scripts/risk.js +4 -4
  143. package/dist/scripts/simulate.js +9 -9
  144. package/dist/scripts/spec-cli.d.ts +1 -0
  145. package/dist/scripts/spec-cli.js +25 -5
  146. package/dist/scripts/sprint-manager.js +4 -3
  147. package/dist/scripts/sync-universal-memory.js +22 -15
  148. package/dist/scripts/token-benchmark.js +4 -3
  149. package/dist/scripts/token-economy.js +4 -3
  150. package/dist/scripts/tools-doctor.d.ts +1 -1
  151. package/dist/scripts/tools-doctor.js +25 -3
  152. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  153. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  154. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  155. package/docs/glossary.md +4 -4
  156. package/docs/init-project.md +88 -444
  157. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  158. package/docs/modos-de-operacao.md +1 -1
  159. package/docs/processo-projeto.md +14 -11
  160. package/docs/produto/roteiro-demo.md +15 -18
  161. package/docs/publishing.md +5 -0
  162. package/docs/quick-reference.md +15 -23
  163. package/docs/structure.md +16 -30
  164. package/lib/core/model-pricing.json +19 -0
  165. package/memory/30-projects/README.md +1 -1
  166. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  167. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  168. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  169. package/memory/90-decisions/0088-templates-validados.md +55 -0
  170. package/package.json +26 -26
  171. package/templates/project/AGENTS.md +75 -0
  172. package/templates/project/CLAUDE.md +9 -0
  173. package/templates/project/agents/context-engineer.md +15 -0
  174. package/templates/project/agents/governance.md +15 -0
  175. package/templates/project/agents/marketing.md +15 -0
  176. package/templates/project/agents/orchestrator.md +15 -0
  177. package/templates/project/agents/product.md +15 -0
  178. package/templates/project/agents/sdd-architect.md +15 -0
  179. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  180. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -12,32 +12,29 @@ forja demo:workspace
12
12
  O comando cria `~/forja-demo-workspace` com o projeto fictício `atlas-pay`, uma spec aprovada, plano,
13
13
  tarefas, contexto, três handoffs, três observações e um perfil LLM local desabilitado.
14
14
 
15
- Para abrir o dashboard sobre esse cenário, inicie os dois processos com o mesmo workspace:
15
+ Para abrir o dashboard sobre esse cenário, instale as dependências do app uma vez e suba a API e o
16
+ app com o mesmo workspace (dois terminais):
16
17
 
17
18
  ```bash
18
- FORJA_WORKSPACE=~/forja-demo-workspace npm --prefix dashboard start
19
- FORJA_WORKSPACE=~/forja-demo-workspace npm --prefix dashboard/web run dev
19
+ npm --prefix apps/dashboard install
20
+ FORJA_WORKSPACE=~/forja-demo-workspace npm run dashboard:api # API local em 127.0.0.1:3000
21
+ npm run dashboard:dev # app em http://localhost:3001
20
22
  ```
21
23
 
22
- No Windows PowerShell:
24
+ No Windows PowerShell, defina `$env:FORJA_WORKSPACE = "$HOME\forja-demo-workspace"` antes de `npm run dashboard:api`.
23
25
 
24
- ```powershell
25
- $env:FORJA_WORKSPACE = "$HOME\forja-demo-workspace"
26
- npm --prefix dashboard start
27
- ```
28
-
29
- Abra `http://127.0.0.1:5173`. O dashboard mostra o estado vazio apenas se não estiver recebendo a
30
- variável `FORJA_WORKSPACE` do cenário.
26
+ O dashboard mostra o estado vazio apenas se a API não estiver recebendo a variável `FORJA_WORKSPACE`
27
+ do cenário.
31
28
 
32
29
  ## Sequência de apresentação
33
30
 
34
- 1. Abra **Sistema**: mostra o projeto Atlas Pay, gates e a contagem de handoffs.
35
- 2. Abra **Specs**: apresente problema, critérios de aceite, plano e tarefas aprovados.
36
- 3. Abra **Handoffs**: há dois handoffs concluídos e um em review, todos marcados como demonstração.
37
- 4. Abra **Memória** e **Tokens**: explique que contexto e observações são dados locais e consultáveis.
38
- 5. Abra **Agentes** para mostrar o perfil `demo-ollama`: ele fica desabilitado até existir uma CLI
39
- Ollama local, reforçando que o Forja não inventa disponibilidade de modelo.
40
- 6. Mostre `forja demo:autonomy` separadamente para a prova de sandbox Git, aprovação e promoção real.
31
+ 1. No terminal, `forja status` e `forja next` dentro de `~/forja-demo-workspace/projects/atlas-pay`:
32
+ estado do projeto, spec aprovada, plano, tarefas e a próxima ação com o comando exato.
33
+ 2. `forja project:wire --check`: a IA, os hooks e o MCP estão conectados ao projeto.
34
+ 3. `forja context:smart --mode task --task pix`: o pack mínimo da tarefa, com a contagem de tokens.
35
+ 4. No dashboard (**Control Plane**): **GraphLoop** mostra specs, ADRs e evidências ligadas;
36
+ **Approvals** e **Atividade recente** mostram as decisões e execuções auditadas.
37
+ 5. Mostre `forja demo:autonomy` separadamente para a prova de sandbox Git, aprovação e promoção real.
41
38
 
42
39
  ## Regras de uso
43
40
 
@@ -55,3 +55,8 @@ node_modules, bancos e contextos privados não devem entrar no tarball.
55
55
 
56
56
  A versão 4.0.0 altera costUsd desconhecido de zero para null no JSON de llm:run. As opções de
57
57
  retomada, schema e checks são explícitas. Exemplos em [LLM Fit Loop](llm-fit-loop.md).
58
+
59
+ A versão 5.0.0 exige Node ≥ 22, troca `.ia-instructions/` por instruções nativas e conexão via
60
+ `project:wire`, e remove `init:project` e os aliases `ops:*`. Projetos anteriores migram com
61
+ `forja project:upgrade --apply`. O `release:check` passa a percorrer a jornada inteira do usuário
62
+ no pacote instalado (check `consumer-journey`, ADR-0086).
@@ -56,11 +56,11 @@ npm run project:new meu-projeto -- --ai claude,copilot
56
56
  npm run project:new meu-projeto -- --skip-backend
57
57
  npm run project:new meu-projeto -- --verbose
58
58
 
59
- # Via binário direto (sempre cria no workspace)
60
- node bin/init-project.js meu-projeto
59
+ # Dentro do projeto: conferir a conexão com a IA
60
+ forja project:wire --check
61
61
 
62
62
  # Ajuda
63
- node bin/init-project.js --help
63
+ forja help project:new
64
64
  ```
65
65
 
66
66
  ---
@@ -142,28 +142,20 @@ node scripts/build-context-pack.mjs
142
142
  # Cria: .context/context-pack.md
143
143
  ```
144
144
 
145
- ### Inicializar SQLite
145
+ ### Indexar a memória
146
146
 
147
147
  ```bash
148
- cd backend
149
- npm run memory:db:init
150
- # Cria: .memory/sqlite/context.db
151
- ```
152
-
153
- ### Sincronizar memória
154
-
155
- ```bash
156
- cd backend
157
- npm run memory:db:sync
158
- # Atualiza índices do markdown
148
+ forja sync:universal
149
+ # Indexa memory/, docs/, prompts/ e specs/ em memory/sqlite/universal.db (FTS5)
159
150
  ```
160
151
 
161
152
  ### Consultar
162
153
 
163
154
  ```bash
164
- cd backend
165
- npm run memory:db:query -- "auth"
166
- # Busca "auth" em toda memória
155
+ forja query:universal "auth"
156
+ # Busca "auth" em toda a memória do projeto
157
+ forja context:smart --mode task --task "auth"
158
+ # Pack mínimo da tarefa em .context/smart-context.md
167
159
  ```
168
160
 
169
161
  ### Watcher automático
@@ -370,7 +362,7 @@ logger.error('Auth failed', error); // Erro
370
362
 
371
363
  ```bash
372
364
  # Quick start
373
- node bin/init-project.js meu-app && cd meu-app/backend && npm i && npm run start:dev
365
+ forja project:new meu-app && cd ~/forja-workspace/projects/meu-app/backend && npm run start:dev
374
366
 
375
367
  # Test all
376
368
  npm test && npm run test:e2e && npm run lint
@@ -382,7 +374,7 @@ rm -rf dist/ node_modules/ && npm i && npm run build
382
374
  npm run lint && npm test && npm run build
383
375
 
384
376
  # Memory sync all
385
- node scripts/build-context-pack.mjs && npm run memory:db:sync
377
+ node scripts/build-context-pack.mjs && forja sync:universal
386
378
 
387
379
  # Find TODOs
388
380
  grep -r "TODO\|FIXME" src/
@@ -394,10 +386,10 @@ grep -r "TODO\|FIXME" src/
394
386
 
395
387
  ```bash
396
388
  # 1. Gerar (1 min)
397
- node bin/init-project.js meu-app --force
389
+ forja project:new meu-app
398
390
 
399
- # 2. Instalar (3 min)
400
- cd meu-app/backend && npm i
391
+ # 2. Entrar no backend (o project:new já instala as dependências)
392
+ cd ~/forja-workspace/projects/meu-app/backend
401
393
 
402
394
  # 3. Rodar (1 min)
403
395
  npm run start:dev
package/docs/structure.md CHANGED
@@ -133,11 +133,10 @@ Quando você roda `npm run project:new meu-projeto`, o projeto é criado dentro
133
133
  │ │ └── context-pack.md → Output compactado
134
134
  │ └── package.json
135
135
  │
136
- ├── 📂 .ia-instructions/ [Config por IA]
137
- │ ├── copilot.md → Para Copilot/VSCode
138
- │ ├── claude.md → Para Claude/claude.ai
139
- │ ├── gemini.md → Para Gemini/gemini.ai
140
- │ └── README.md → Guia de instrução
136
+ ├── 📄 AGENTS.md / CLAUDE.md / GEMINI.md [Instruções nativas por IA — bloco forja:begin/end]
137
+ ├── 📂 .claude/ [settings.json com hooks + agents/ (6 papéis)]
138
+ ├── 📄 .mcp.json [servidor MCP do Forja]
139
+ ├── 📂 .forja/models.json [cadeia de fallback entre IAs]
141
140
  │
142
141
  ├── 📂 backend/ [NestJS (se não --skip-backend)]
143
142
  │ ├── 📂 src/
@@ -154,13 +153,6 @@ Quando você roda `npm run project:new meu-projeto`, o projeto é criado dentro
154
153
  │ │ ├── app.module.ts
155
154
  │ │ └── main.ts
156
155
  │ │
157
- │ ├── 📂 scripts/
158
- │ │ ├── memory-db-init.mjs → Criar BD
159
- │ │ ├── memory-db-sync.mjs → Sincronizar memória
160
- │ │ ├── memory-db-query.mjs → Consultar
161
- │ │ └── .sqlite/
162
- │ │ └── context.db → BD principal
163
- │ │
164
156
  │ ├── package.json
165
157
  │ ├── tsconfig.json
166
158
  │ └── nest-cli.json
@@ -240,18 +232,12 @@ node scripts/append-handoff.mjs
240
232
  # → Cria handoff pronto para próximo agente
241
233
  ```
242
234
 
243
- ### `backend/scripts/` - Gerenciar BD
244
- **Use quando**: Sincronizar memória ou consultar índice
235
+ ### Memória indexada - `forja sync:universal`
236
+ **Use quando**: Sincronizar memória ou consultar o índice
245
237
  ```bash
246
- node backend/scripts/memory-db-init.mjs
247
- # → Criar/resetar BD
248
-
249
- node backend/scripts/memory-db-sync.mjs
250
- # → Indexar memory/ em SQLite
251
-
252
- node backend/scripts/memory-db-query.mjs \
253
- --query "SELECT * FROM improvement_items WHERE status='pending'"
254
- # → Consultar rastreamento
238
+ forja sync:universal # indexa memory/, docs/, prompts/, specs/ (memory/sqlite/)
239
+ forja query:universal "pagamentos" # busca FTS5
240
+ forja context:smart --mode task --task pix # pack mínimo da tarefa
255
241
  ```
256
242
 
257
243
  ---
@@ -302,8 +288,8 @@ cat memory/50-orchestration/handoffs/handoff-*.md
302
288
  # Executa prompts de review
303
289
  cat prompts/reviewer-prompt.md
304
290
 
305
- # Atualiza summaries se OK
306
- node backend/scripts/memory-db-sync.mjs
291
+ # Atualiza o índice se OK
292
+ forja sync:universal
307
293
  ```
308
294
 
309
295
  ### 5️⃣ Documentar Run
@@ -335,11 +321,11 @@ Após mudanças importantes:
335
321
  # 1. Adicionar à memória (manual ou via handoff)
336
322
  cat memory/30-domains/auth/context.md
337
323
 
338
- # 2. Sincronizar com BD
339
- node backend/scripts/memory-db-sync.mjs
324
+ # 2. Sincronizar com o índice
325
+ forja sync:universal
340
326
 
341
- # 3. Consultar progresso
342
- node backend/scripts/memory-db-query.mjs --table improvement_items
327
+ # 3. Consultar
328
+ forja query:universal "auth"
343
329
  ```
344
330
 
345
331
  ---
@@ -347,7 +333,7 @@ node backend/scripts/memory-db-query.mjs --table improvement_items
347
333
  ## 🎯 Próximos Passos
348
334
 
349
335
  1. ✅ Entender a estrutura (você está aqui)
350
- 2. Ler `.ia-instructions/copilot.md` (ou claude.md/gemini.md)
336
+ 2. Ler o `AGENTS.md` do projeto (ou abrir a IA nele: as instruções são lidas sozinhas)
351
337
  3. Rodar `node scripts/build-context-pack.mjs`
352
338
  4. Chamar primeiro agente com contexto
353
339
  5. Criar handoff após cada tarefa
@@ -0,0 +1,19 @@
1
+ {
2
+ "version": 1,
3
+ "currency": "USD",
4
+ "prices": {
5
+ "claude:opus": { "inputPer1kUsd": 0.015, "outputPer1kUsd": 0.075, "asOf": "2026-08-31" },
6
+ "claude:sonnet": { "inputPer1kUsd": 0.003, "outputPer1kUsd": 0.015, "asOf": "2026-08-31" },
7
+ "claude:haiku": { "inputPer1kUsd": 0.0008, "outputPer1kUsd": 0.004, "asOf": "2026-08-31" },
8
+ "claude:default": { "inputPer1kUsd": 0.003, "outputPer1kUsd": 0.015, "asOf": "2026-08-31" },
9
+ "codex:gpt-4-turbo": { "inputPer1kUsd": 0.01, "outputPer1kUsd": 0.03, "asOf": "2026-08-31" },
10
+ "codex:gpt-4o": { "inputPer1kUsd": 0.0025, "outputPer1kUsd": 0.01, "asOf": "2026-08-31" },
11
+ "codex:default": { "inputPer1kUsd": 0.0025, "outputPer1kUsd": 0.01, "asOf": "2026-08-31" },
12
+ "gemini-cli:gemini-1.5-pro": { "inputPer1kUsd": 0.00125, "outputPer1kUsd": 0.005, "asOf": "2026-08-31" },
13
+ "gemini-cli:gemini-1.5-flash": { "inputPer1kUsd": 0.000075, "outputPer1kUsd": 0.0003, "asOf": "2026-08-31" },
14
+ "gemini-cli:default": { "inputPer1kUsd": 0.00125, "outputPer1kUsd": 0.005, "asOf": "2026-08-31" },
15
+ "ollama:llama3.3": { "inputPer1kUsd": 0, "outputPer1kUsd": 0, "asOf": "2026-08-31" },
16
+ "openai:gpt-4o": { "inputPer1kUsd": 0.0025, "outputPer1kUsd": 0.01, "asOf": "2026-08-31" },
17
+ "openai:gpt-4-turbo": { "inputPer1kUsd": 0.01, "outputPer1kUsd": 0.03, "asOf": "2026-08-31" }
18
+ }
19
+ }
@@ -1,7 +1,7 @@
1
1
  # memory/30-projects — fichas de projetos (privadas)
2
2
 
3
3
  Este diretório registra os projetos rastreados pela Memória Universal. Cada projeto
4
- gera uma ficha `<nome>.md` (criada por `init-project.js` ou pela sincronização de
4
+ gera uma ficha `<nome>.md` (criada pelo `forja project:new` ou pela sincronização de
5
5
  memória).
6
6
 
7
7
  ## Privacidade
@@ -1,6 +1,6 @@
1
1
  # ADR-0022: Congelar o dashboard web
2
2
 
3
- - **Status**: accepted
3
+ - **Status**: superseded by ADR-0087
4
4
  - **Data**: 2026-07-09
5
5
  - **Autor(es)**: apk
6
6
  - **Tags**: dashboard, cli, release, security, sdd
@@ -0,0 +1,95 @@
1
+ # ADR-0086: Projeto conectado à IA, raízes únicas e a jornada do usuário como gate
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-10-09
5
+ - **Autor(es)**: Allan Pablo / Claude
6
+ - **Tags**: core, generation, release, llm, governance
7
+
8
+ ## Contexto
9
+
10
+ A v4.1.2 passava em 543 testes e no `release:check`, mas a jornada real do usuário estava quebrada.
11
+ Instalando o tarball e usando o Forja como um usuário faria, apareceram problemas em série:
12
+
13
+ - **Raiz errada no pacote instalado.** Vinte scripts calculavam a raiz com `path.resolve(__dirname, '..')`,
14
+ que no pacote publicado aponta para `dist/`. O `project:new` gerava projetos sem instruções de IA,
15
+ sem design-md e sem `.mcp.json`, e mesmo assim terminava com "Tudo pronto!" e exit 0. O `forja setup`
16
+ caía com `Cannot find module`. No checkout, o `project:new` nem rodava, porque `init-project.js`
17
+ estava cravado com `.js`. O `project:smoke` contornava esse ponto, então nenhum teste o exercitava.
18
+ A mesma classe de bug já tinha sido corrigida uma vez (v1.6.1, `spec-cli`), mas só no arquivo afetado.
19
+ - **Projeto desconectado da IA.** As instruções iam para `.ia-instructions/`, pasta que nenhuma IA lê.
20
+ Além disso, eram cópia do texto do *framework*: mandavam usar `npm run query:universal` e
21
+ `scripts/agent-harness.ts`, que não existem no projeto. Não havia `CLAUDE.md`, hooks, sub-agents nem
22
+ MCP do Forja. O `package.json` gerado apontava para `scripts/code-intel.mjs` e
23
+ `scripts/tools-doctor.mjs`, que nunca eram copiados, e o do backend para três `memory-db-*.mjs` que
24
+ nunca existiram.
25
+ - **Inteligência sem ligação.** O `context:smart` prometia os 3 modos da ADR-0003, mas chamava um
26
+ script que ignorava `--mode`. O modo task, no `ContextBuilder`, nunca funcionou: `MATCH` dentro de
27
+ `OR` lança erro no SQLite, e o erro era engolido por um `console.warn`. No modo embedded, o
28
+ `sync:universal` indexava as specs do framework na memória do produto. Handoffs de produto entravam
29
+ como handoffs do framework (o router rodava com `cwd` no pacote), e o `code:impact` dentro de um
30
+ projeto analisava o código do Forja.
31
+
32
+ Os checks de consumidor do release nasceram um por bug e testavam peças isoladas. Nenhum deles cobria
33
+ o que o usuário de fato faz: criar um projeto e trabalhar nele com uma IA.
34
+
35
+ ## Decisão
36
+
37
+ **1. Duas raízes, resolvidas num lugar só (`lib/paths.ts`).** `codeRoot` é onde está o código
38
+ executável: o repo em dev, `dist/` no pacote. `pkgRoot` é onde estão os assets versionados: a raiz do
39
+ pacote nos dois layouts. Scripts são executados com `script()`/`resolveScript()`, que não depende de
40
+ extensão. Nenhum outro módulo calcula raiz a partir de `__dirname`, e `test/paths.test.js` vigia a
41
+ classe inteira (raiz via `__dirname` e extensão cravada em spawn), não um arquivo.
42
+
43
+ **2. Todo projeto nasce conectado (`lib/project-wiring.ts`).** O mesmo módulo escreve e verifica:
44
+
45
+ - `AGENTS.md` com um bloco gerenciado (`<!-- forja:begin/end -->`), lido por Codex, Copilot agent e
46
+ Gemini (via import); `CLAUDE.md`/`GEMINI.md` importam `@AGENTS.md`; o Copilot recebe o bloco em
47
+ `.github/copilot-instructions.md`. O conteúdo vem de `templates/project/` e usa só `forja <comando>`.
48
+ - Claude Code: hooks `SessionStart` → `forja hook:session-start` e `UserPromptSubmit` →
49
+ `forja hook:user-prompt`, protegidos por `command -v forja`; seis sub-agents por papel; permissão
50
+ `Bash(forja *)`.
51
+ - `.mcp.json` com o servidor `forja mcp:start`. O codegraph entra só se o binário existir.
52
+ - `.forja/models.json` com a cadeia de fallback entre IAs, substituindo `.ia-instructions/models.json`.
53
+ - Scripts `code:*`/`tools:doctor` que chamam o `forja`. Scripts mortos de versões antigas são migrados.
54
+ - `memory/sqlite/` e `.context/` no `.gitignore`.
55
+
56
+ O conteúdo do usuário é preservado: o wire reescreve só o bloco gerenciado e só os sub-agents que
57
+ ainda têm a marca `forja:managed`. A verificação (`forja project:wire --check`) também confere que
58
+ todo `forja <cmd>` citado ao usuário existe no registry e que todo `node <arquivo>` dos `package.json`
59
+ aponta para um arquivo real.
60
+
61
+ **3. Superfícies.** `project:new` usa o wire e falha alto (exit 1 e resumo de pendências) quando algo
62
+ essencial não sai. `project:wire` conecta e verifica. `project:upgrade` religa projetos pré-v5 e só
63
+ traz backend para quem já tem um (revisto na 5.0.1: o upgrade nunca toca `backend/`, `frontend/`, `apps/`, `packages/` nem `src/`, nem traz domínios de exemplo — ver #73). `tools:doctor` mostra a conexão quando roda num projeto.
64
+ `hook:session-start` e `hook:user-prompt` entram no registry. Handoffs passam a ser carimbados com o
65
+ projeto de origem, e o briefing e o `next` filtram por ele.
66
+
67
+ **4. A jornada do usuário vira gate (`lib/core/journey.ts`).** Num HOME descartável, a jornada cria o
68
+ workspace e o projeto e percorre, dentro do projeto, wire, status, specs, memória, `context:smart`,
69
+ gates, hooks, MCP e handoff. Cada passo é conferido pelo efeito, não só pelo exit code. Ao final, a
70
+ jornada prova que nenhum arquivo do pacote mudou. Ela roda no `npm test` (contra o fonte) e no
71
+ `release:check` (check `consumer-journey`, contra o pacote instalado). Rodada contra a `main` da 4.1.2,
72
+ reprova no segundo passo.
73
+
74
+ ## Alternativas consideradas
75
+
76
+ - **Corrigir só os scripts quebrados, um por um.** Rejeitada: foi o que se fez na v1.6.1 e na v1.7.0, e
77
+ a classe de bug voltou. Sem um resolvedor único e um teste que vigie a classe, o próximo script novo
78
+ repete o erro.
79
+ - **Manter `.ia-instructions/` e só corrigir o texto.** Rejeitada: nenhuma IA lê essa pasta sozinha.
80
+ Instrução que depende de a IA "ser avisada" de onde está não conecta nada.
81
+ - **Hooks e MCP chamando scripts copiados para o projeto.** Rejeitada: cópias envelhecem e divergem
82
+ (foi assim que `code-intel.mjs` e `tools-doctor.mjs` ficaram para trás). Chamar o `forja` mantém uma
83
+ fonte só, e o `project:upgrade` religa projetos antigos.
84
+ - **Checar a jornada só no CI.** Rejeitada: a jornada leva cerca de 4s. No `npm test` ela pega a
85
+ regressão no mesmo ciclo da edição; no `release:check` ela pega o que só quebra no tarball.
86
+
87
+ ## Consequências
88
+
89
+ - **Breaking:** projetos novos não recebem `.ia-instructions/`; o backend gerado não tem mais
90
+ `memory:db:init` (`memory:db:sync`/`query` chamam o `forja`); `init:project` e os aliases `ops:*`
91
+ saem; `engines` passa a `node >=22`. Migração: `forja project:upgrade --apply`.
92
+ - Hooks e MCP de um projeto exigem `forja` no PATH (`npm i -g forjajs`). Sem ele, a sessão abre
93
+ normalmente e o `project:wire --check` avisa.
94
+ - Comando novo que opere no projeto precisa passar na jornada. Comando que escreva no pacote quando
95
+ executado num projeto reprova em "pacote intocado".
@@ -0,0 +1,35 @@
1
+ # ADR-0087: Remover o dashboard web legado (`dashboard/`)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-10-09
5
+ - **Autor(es)**: Allan Pablo / Claude
6
+ - **Tags**: dashboard, cleanup, release
7
+
8
+ ## Contexto
9
+
10
+ A ADR-0022 congelou o `dashboard/` (Fastify + Vite, SPEC-002): o código ficou versionado, mas fora do
11
+ pacote, à espera de alguém que o retomasse. Desde então, o dashboard ativo passou a ser o
12
+ `apps/dashboard` (Next.js), que consome a API do `apps/server`. O `dashboard/` continuou no repo sem
13
+ ser publicado nem usado. Só aparecia em um teste do servidor legado, no roteiro de demo (que mandava
14
+ subir esse servidor) e em `docs/dashboard.md`. Na prática, eram dois dashboards, e a documentação
15
+ apontava para o que não é distribuído.
16
+
17
+ ## Decisão
18
+
19
+ Remover `dashboard/`, `docs/dashboard.md`, os PNGs de captura na raiz e o teste do servidor legado.
20
+ O dashboard opcional é o `apps/dashboard`: `npm run dashboard:api` (API do `apps/server`, compilada) e
21
+ `npm run dashboard:dev` (app na porta 3001). O roteiro de demo passa a usar a CLI e esse app.
22
+ A ADR-0022 fica `superseded`. A spec `agent-dashboard` permanece como histórico (`abandoned`).
23
+
24
+ ## Alternativas consideradas
25
+
26
+ - **Manter congelado.** Rejeitada: código sem dono e sem uso confunde quem chega (dois dashboards,
27
+ docs que apontam para o errado) e custa manutenção nos checks.
28
+ - **Migrar telas do legado para o `apps/dashboard`.** Fora de escopo da limpeza. Se for preciso, a
29
+ história no git preserva o código.
30
+
31
+ ## Consequências
32
+
33
+ - Quem subia o dashboard legado (`npm --prefix dashboard start`) passa a usar `dashboard:api` e
34
+ `dashboard:dev`.
35
+ - Menos superfície no repo: 71 arquivos e um teste a menos.
@@ -0,0 +1,55 @@
1
+ # ADR-0088: Boilerplates como templates validados (`project:new --template`)
2
+
3
+ - **Status**: accepted
4
+ - **Data**: 2026-10-09
5
+ - **Autor(es)**: Allan Pablo / Claude
6
+ - **Tags**: generation, boilerplates, release, quality
7
+
8
+ ## Contexto
9
+
10
+ O `boilerplates/README.md` prometia `init-project --template api-rest`, mas a flag nunca existiu.
11
+ Testados como estão, nenhum dos seis boilerplates funcionava como ponto de partida:
12
+
13
+ - `01-api-rest` tem só um README.
14
+ - `02-saas` e `03-ecommerce` não instalam: `@nestjs/typeorm@9` com Nest 10 (conflito de peer).
15
+ - `04` (microserviços) e `05` (monorepo turbo) têm topologia própria, com vários pacotes.
16
+ - `06-clean-arch` instala e passa nos testes, mas `npm run build` chama um `nest` que não está nas
17
+ dependências.
18
+
19
+ Na mesma época, o NestJS 12 passou a ser ESM-only, e o `nest new` oficial adotou ESM + `nodenext`,
20
+ Vitest e oxlint. O backend padrão do gerador (CommonJS + Jest) compilava, mas o `npm test` não
21
+ carregava, o lint nunca rodou e o módulo `ops` abria um banco inexistente. O smoke só verificava
22
+ compilação, então nada disso aparecia.
23
+
24
+ ## Decisão
25
+
26
+ 1. **"Template" é um contrato.** Um boilerplate só vira template quando o manifest declara
27
+ `"template": true`. Isso promete que o backend instala, compila, passa nos testes e no lint. O job
28
+ de CI `project-smoke-full` cobra a promessa, e `test/templates.test.js` exige que todo template
29
+ esteja na matriz desse job. Os demais boilerplates seguem como **referência**.
30
+ 2. **`forja project:new <nome> --template <t>`** gera memória e agentes, aplica o boilerplate (código e
31
+ memória específica prevalecem; o README vai para `docs/template.md`), conecta a IA (ADR-0086) e
32
+ registra a origem em `.forja/template.json`. Template desconhecido ou de referência é recusado
33
+ antes de criar qualquer arquivo, com a lista dos disponíveis. `forja project:templates` mostra
34
+ quais são templates e quais são referência.
35
+ 3. **O backend gerado e o 06-clean-arch seguem o `nest new` do NestJS 12:** ESM, Vitest e oxlint.
36
+ Ficam no TypeScript 6 porque o ecossistema de testes ainda não suporta o 7. O painel `/api/ops`
37
+ do backend padrão lê a memória do Forja (specs, handoffs e nós indexados).
38
+ 4. **`project:smoke --full` passa a rodar `test`, `test:e2e` (quando declarado) e `lint`**, além de
39
+ install e build. "Compila" deixou de ser critério de aceite para o projeto gerado.
40
+
41
+ ## Alternativas consideradas
42
+
43
+ - **Migrar os seis boilerplates de uma vez.** Rejeitada para a 5.0: 02 e 03 exigem refazer a camada
44
+ de dados, e 04/05 têm topologia própria. Migrar sem a mesma validação repetiria o problema (promessa
45
+ sem prova). Cada um entra quando passar no `project-smoke-full`.
46
+ - **Copiar o boilerplate sem validar.** Rejeitada: era exatamente o que o README prometia, e o
47
+ resultado seriam projetos que não instalam.
48
+ - **Manter o backend padrão em CommonJS com Nest 11.** Rejeitada: congelaria o projeto gerado numa
49
+ versão antiga. O padrão oficial do Nest 12 é ESM.
50
+
51
+ ## Consequências
52
+
53
+ - `clean-arch` é o primeiro template. Promover outro exige migrá-lo e incluí-lo na matriz do CI.
54
+ - Projetos gerados antes da v5 continuam em CommonJS + Jest. O `project:upgrade` é aditivo e não
55
+ migra o backend existente.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "forjajs",
3
- "version": "4.1.2",
3
+ "version": "5.0.1",
4
4
  "description": "ForjaJS é uma plataforma local-first para memória, contexto, governança e execução supervisionada de agentes de desenvolvimento",
5
5
  "type": "module",
6
6
  "main": "index.js",
@@ -11,6 +11,8 @@
11
11
  },
12
12
  "files": [
13
13
  "dist/",
14
+ "templates/",
15
+ "lib/core/model-pricing.json",
14
16
  "prompts/",
15
17
  "skills/",
16
18
  "boilerplates/",
@@ -31,7 +33,6 @@
31
33
  "DOC-MAP.md",
32
34
  "CHANGELOG.md",
33
35
  "CONTRIBUTING.md",
34
- "!docs/dashboard.md",
35
36
  "!specs/agent-dashboard/"
36
37
  ],
37
38
  "scripts": {
@@ -41,7 +42,6 @@
41
42
  "sync:universal": "node bin/forja.ts sync:universal",
42
43
  "query:universal": "node bin/forja.ts query:universal",
43
44
  "dev": "node scripts/dev.ts",
44
- "init:project": "node bin/forja.ts init:project",
45
45
  "sprint:start": "node bin/forja.ts sprint:start",
46
46
  "sprint:status": "node bin/forja.ts sprint:status",
47
47
  "sprint:complete": "node bin/forja.ts sprint:complete",
@@ -76,10 +76,6 @@
76
76
  "gsd:check": "node bin/forja.ts gsd:check",
77
77
  "design:check": "node bin/forja.ts design:check",
78
78
  "design:select": "node bin/forja.ts design:select",
79
- "ops:plan": "node bin/forja.ts gsd:plan",
80
- "ops:handoff": "node bin/forja.ts gsd:handoff",
81
- "ops:check": "node bin/forja.ts gsd:check",
82
- "ops:sprint": "node bin/forja.ts sprint:status",
83
79
  "code:index": "node bin/forja.ts code:index",
84
80
  "code:sync": "node bin/forja.ts code:sync",
85
81
  "code:status": "node bin/forja.ts code:status",
@@ -88,15 +84,16 @@
88
84
  "code:impact": "node bin/forja.ts code:impact",
89
85
  "tools:doctor": "node bin/forja.ts tools:doctor",
90
86
  "release:check": "node bin/forja.ts release:check",
91
- "dashboard:dev": "npm --prefix apps/dashboard run dev",
87
+ "dashboard:api": "npm run build && node dist/apps/server/src/main.js",
88
+ "dashboard:dev": "npm --prefix apps/dashboard run dev -- -p 3001",
92
89
  "dashboard:build": "npm --prefix apps/dashboard run build",
93
90
  "dashboard:start": "npm --prefix apps/dashboard run start",
94
- "build": "tsc -p tsconfig.build.json",
91
+ "build": "tsc -p tsconfig.build.json && node -e \"for (const f of Object.values(require('./package.json').bin)) require('fs').chmodSync(f, 0o755)\"",
95
92
  "types:check": "tsc --noEmit",
96
93
  "test": "node --test test/*.test.js",
97
- "demo:autonomy": "node scripts/demo-autonomy.ts",
94
+ "demo:autonomy": "node bin/forja.ts demo:autonomy",
98
95
  "demo:workspace": "node bin/forja.ts demo:workspace",
99
- "benchmark:context": "node scripts/context-benchmark.ts",
96
+ "benchmark:context": "node bin/forja.ts benchmark:context",
100
97
  "llm:profiles:init": "node bin/forja.ts llm:profiles:init",
101
98
  "llm:doctor": "node bin/forja.ts llm:doctor",
102
99
  "llm:probe": "node bin/forja.ts llm:probe",
@@ -120,7 +117,7 @@
120
117
  "sdd"
121
118
  ],
122
119
  "engines": {
123
- "node": ">=20"
120
+ "node": ">=22"
124
121
  },
125
122
  "repository": {
126
123
  "type": "git",
@@ -130,7 +127,7 @@
130
127
  "license": "MIT",
131
128
  "dependencies": {
132
129
  "ajv": "^8.20.0",
133
- "better-sqlite3": "^12.11.1"
130
+ "better-sqlite3": "^13.0.3"
134
131
  },
135
132
  "allowScripts": {
136
133
  "better-sqlite3@12.11.1": true
@@ -139,24 +136,27 @@
139
136
  "next": {
140
137
  "postcss": "^8.5.25",
141
138
  "sharp": "^0.35.3"
139
+ },
140
+ "@nestjs/swagger": {
141
+ "typescript": "$typescript"
142
142
  }
143
143
  },
144
144
  "devDependencies": {
145
- "@nestjs/common": "^11.1.28",
146
- "@nestjs/core": "^11.1.28",
147
- "@nestjs/platform-express": "^11.1.28",
148
- "@nestjs/swagger": "^11.4.5",
149
- "@tanstack/react-query": "^5.90.5",
145
+ "@nestjs/common": "^12.1.2",
146
+ "@nestjs/core": "^12.1.2",
147
+ "@nestjs/platform-express": "^12.1.2",
148
+ "@nestjs/swagger": "^12.0.2",
149
+ "@tanstack/react-query": "^5.104.1",
150
150
  "@types/express": "^5.0.6",
151
- "@types/node": "^26.1.1",
152
- "@types/react": "^19.2.2",
153
- "@types/react-dom": "^19.2.2",
154
- "next": "^16.2.12",
155
- "react": "^19.2.0",
156
- "react-dom": "^19.2.0",
151
+ "@types/node": "^26.6.4",
152
+ "@types/react": "^19.3.0",
153
+ "@types/react-dom": "^19.3.0",
154
+ "next": "^16.4.0",
155
+ "react": "^19.3.0",
156
+ "react-dom": "^19.3.0",
157
157
  "reflect-metadata": "^0.2.2",
158
158
  "rxjs": "^7.8.2",
159
- "tsx": "^4.23.1",
160
- "typescript": "^5.9.3"
159
+ "tsx": "^4.23.15",
160
+ "typescript": "^7.0.2"
161
161
  }
162
162
  }