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
@@ -15,17 +15,22 @@
15
15
  * Diagnostica e prescreve; não conserta. Rodar `npm rebuild` sem consentimento é a classe de
16
16
  * risco oposta à que este comando existe para fechar.
17
17
  *
18
- * Uso: node scripts/tools-doctor.mjs
18
+ * Uso: forja tools:doctor
19
19
  */
20
20
  import { spawnSync } from 'node:child_process';
21
- import { runChecks, worstStatus, bucketFor, BUCKET_LABEL } from "../lib/core/health.js";
21
+ import fs from 'node:fs';
22
+ import path from 'node:path';
23
+ import { runChecks, worstStatus, bucketFor, BUCKET_LABEL } from '../lib/core/health.js';
24
+ import { COMMANDS } from '../lib/core/registry.js';
25
+ import { checkProjectWiring } from '../lib/project-wiring.js';
26
+ import { isInsideFrameworkRepo } from '../lib/workspace.js';
22
27
  const TOOLS = [
23
28
  {
24
29
  name: 'codegraph',
25
30
  probe: ['codegraph', ['--version']],
26
31
  role: 'Code intelligence: chamadores, blast radius, mapa de impacto (ADR-0017).',
27
32
  install: 'npm i -g @codegraph/cli',
28
- gate: 'npm run code:check / code:impact',
33
+ gate: 'forja code:check / code:impact',
29
34
  },
30
35
  {
31
36
  name: 'gitleaks',
@@ -104,11 +109,28 @@ function printTools() {
104
109
  console.log(`${installed}/${TOOLS.length} ferramentas disponíveis.`);
105
110
  console.log('Ferramentas ausentes apenas desativam seus gates — o fluxo nunca trava por elas.\n');
106
111
  }
112
+ /** Num projeto (fora do repo do framework): a IA, os hooks e o MCP estão ligados a ele? */
113
+ function printProject() {
114
+ const cwd = process.cwd();
115
+ if (isInsideFrameworkRepo(cwd) || !fs.existsSync(path.join(cwd, 'AGENTS.md')))
116
+ return null;
117
+ console.log('Projeto — a IA enxerga o Forja aqui? (forja project:wire --check)\n');
118
+ const checks = checkProjectWiring(cwd, { commands: COMMANDS });
119
+ for (const c of checks)
120
+ console.log(`${TAG[c.status]} ${c.id.padEnd(13)} ${c.detail}`);
121
+ console.log('');
122
+ return checks.some((c) => c.status === 'fail') ? 'fail' : checks.some((c) => c.status === 'warn') ? 'warn' : 'ok';
123
+ }
107
124
  async function main() {
108
125
  console.log('\nForja doctor\n');
109
126
  const core = await runChecks();
110
127
  printCore(core);
128
+ const project = printProject();
111
129
  printTools();
130
+ if (project === 'fail') {
131
+ console.log('Projeto desconectado da IA — corrija com: forja project:wire');
132
+ process.exit(1);
133
+ }
112
134
  // Só o núcleo decide o exit code. Ferramenta ausente nunca reprova — o contrato do ADR-0018
113
135
  // é preservado à risca.
114
136
  const verdict = worstStatus(core);
@@ -18,8 +18,7 @@ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
18
18
  ```bash
19
19
  cd nome-do-projeto/backend
20
20
  npm install
21
- npm run memory:db:init
22
- npm run memory:db:sync
21
+ forja sync:universal
23
22
  npm run start:dev
24
23
  ```
25
24
 
@@ -16,7 +16,7 @@ Implementar com qualidade, manter contexto atualizado e reduzir retrabalho.
16
16
  - Rodar sync da memória operacional:
17
17
  ```bash
18
18
  cd backend
19
- npm run memory:db:sync
19
+ forja sync:universal
20
20
  ```
21
21
 
22
22
  ### Critério de Pronto (DEV)
@@ -99,15 +99,14 @@ Se qualquer item for “não”: refinar step antes da execução.
99
99
  ```bash
100
100
  cd backend
101
101
  npm install
102
- npm run memory:db:init
103
- npm run memory:db:sync
102
+ forja sync:universal
104
103
  ```
105
104
 
106
105
  ### Consulta de contexto
107
106
  ```bash
108
- npm run memory:db:query -- "search" "auth" 10
109
- npm run memory:db:query -- handoffs 10
110
- npm run memory:db:query -- adrs 20
107
+ forja query:universal "auth" 10
108
+ forja agent:route list
109
+ forja adr:list
111
110
  ```
112
111
 
113
112
  ### Registrar handoff
@@ -83,9 +83,8 @@ Checagem esperada:
83
83
  Ainda dentro de `backend/`:
84
84
 
85
85
  ```bash
86
- npm run memory:db:init
87
- npm run memory:db:sync
88
- npm run memory:db:query -- "search" "contexto" 10
86
+ forja sync:universal
87
+ forja query:universal "contexto" 10
89
88
  ```
90
89
 
91
90
  O que isso faz:
@@ -224,12 +223,12 @@ Próximos passos:
224
223
  1. Sincronizar memória:
225
224
  ```bash
226
225
  cd backend
227
- npm run memory:db:sync
226
+ forja sync:universal
228
227
  ```
229
228
 
230
229
  2. Buscar contexto da tarefa:
231
230
  ```bash
232
- npm run memory:db:query -- "search" "tema da tarefa" 10
231
+ forja query:universal "tema da tarefa" 10
233
232
  ```
234
233
 
235
234
  3. Executar step
@@ -242,7 +241,7 @@ npm run memory:db:query -- "search" "tema da tarefa" 10
242
241
  - Evitar: aplicar seção 7 (questionamento obrigatório).
243
242
 
244
243
  - Erro: esquecer atualização de memória.
245
- - Evitar: sempre rodar `memory:db:sync` após mudanças relevantes.
244
+ - Evitar: sempre rodar `forja sync:universal` após mudanças relevantes.
246
245
 
247
246
  - Erro: deploy sem rollback claro.
248
247
  - Evitar: incluir rollback como item obrigatório no DoD.
@@ -259,12 +258,11 @@ npx github:SEU_USUARIO/create-memory-nest-kit nome-do-projeto
259
258
  # setup inicial
260
259
  cd nome-do-projeto/backend
261
260
  npm install
262
- npm run memory:db:init
263
- npm run memory:db:sync
261
+ forja sync:universal
264
262
  npm run start:dev
265
263
 
266
264
  # consultar contexto
267
- npm run memory:db:query -- "search" "auth" 10
265
+ forja query:universal "auth" 10
268
266
 
269
267
  # registrar handoff (na raiz do projeto)
270
268
  cd ..
package/docs/glossary.md CHANGED
@@ -128,7 +128,7 @@ No kit: Busca em memory/ via SQLite
128
128
  CLI que cria novo projeto com toda estrutura. Os projetos vão para o workspace Forja (`~/forja-workspace/projects/<nome>`).
129
129
  ```
130
130
  Comando: npm run project:new meu-projeto
131
- Arquivos: bin/init-project.js, bin/create-memory-nest-kit.js
131
+ Arquivos: bin/init-project.ts, bin/create-memory-nest-kit.ts, lib/project-wiring.ts
132
132
  ```
133
133
 
134
134
  ---
@@ -158,7 +158,7 @@ Esperado: { "status": "ok" }
158
158
  Estrutura que acelera buscas (SQLite FTS5).
159
159
  ```
160
160
  No kit: memory/ → .memory/sqlite/context.db
161
- Sync: npm run memory:db:sync
161
+ Sync: forja sync:universal
162
162
  ```
163
163
 
164
164
  ---
@@ -315,8 +315,8 @@ Gerenciar: npm run sprint:start
315
315
  ### SQLite
316
316
  Banco de dados leve, em-arquivo.
317
317
  ```
318
- No kit: .memory/sqlite/context.db
319
- Schema: backend/scripts/memory-db-schema.sql
318
+ No projeto: memory/sqlite/universal.db (FTS5, fora do git)
319
+ Indexar: forja sync:universal
320
320
  ```
321
321
 
322
322
  ---