forjajs 1.7.3 → 2.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 (125) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +223 -217
  3. package/README.pt-BR.md +323 -0
  4. package/dist/apps/dashboard/app/api/forja/[...path]/route.d.ts +10 -0
  5. package/dist/apps/dashboard/app/api/forja/[...path]/route.js +36 -0
  6. package/dist/apps/dashboard/app/api/forja/approval.d.ts +1 -0
  7. package/dist/apps/dashboard/app/api/forja/approval.js +8 -0
  8. package/dist/apps/dashboard/app/dashboard-client.d.ts +1 -0
  9. package/dist/apps/dashboard/app/dashboard-client.jsx +62 -0
  10. package/dist/apps/dashboard/app/layout.d.ts +9 -0
  11. package/dist/apps/dashboard/app/layout.jsx +7 -0
  12. package/dist/apps/dashboard/app/page.d.ts +1 -0
  13. package/dist/apps/dashboard/app/page.jsx +5 -0
  14. package/dist/apps/dashboard/app/providers.d.ts +4 -0
  15. package/dist/apps/dashboard/app/providers.jsx +7 -0
  16. package/dist/apps/dashboard/next.config.d.mts +6 -0
  17. package/dist/apps/dashboard/next.config.mjs +8 -0
  18. package/dist/apps/dashboard/src/index.d.ts +14 -0
  19. package/dist/apps/dashboard/src/index.js +16 -0
  20. package/dist/apps/server/src/app.module.d.ts +5 -0
  21. package/dist/apps/server/src/app.module.js +16 -0
  22. package/dist/apps/server/src/forja-nest.module.d.ts +59 -0
  23. package/dist/apps/server/src/forja-nest.module.js +316 -0
  24. package/dist/apps/server/src/index.d.ts +15 -0
  25. package/dist/apps/server/src/index.js +7 -0
  26. package/dist/apps/server/src/main.d.ts +12 -0
  27. package/dist/apps/server/src/main.js +105 -0
  28. package/dist/apps/worker/src/main.d.ts +12 -0
  29. package/dist/apps/worker/src/main.js +18 -0
  30. package/dist/lib/core/health.js +1 -1
  31. package/dist/packages/adapter-git/src/index.d.ts +27 -0
  32. package/dist/packages/adapter-git/src/index.js +53 -0
  33. package/dist/packages/adapter-nest/src/index.d.ts +71 -0
  34. package/dist/packages/adapter-nest/src/index.js +142 -0
  35. package/dist/packages/adapter-sqlite/src/index.d.ts +99 -0
  36. package/dist/packages/adapter-sqlite/src/index.js +108 -0
  37. package/dist/packages/context/src/index.d.ts +52 -0
  38. package/dist/packages/context/src/index.js +108 -0
  39. package/dist/packages/contracts/src/index.d.ts +368 -0
  40. package/dist/packages/contracts/src/index.js +27 -0
  41. package/dist/packages/core/src/index.d.ts +68 -0
  42. package/dist/packages/core/src/index.js +141 -0
  43. package/dist/packages/evals/src/index.d.ts +22 -0
  44. package/dist/packages/evals/src/index.js +65 -0
  45. package/dist/packages/events/src/index.d.ts +47 -0
  46. package/dist/packages/events/src/index.js +96 -0
  47. package/dist/packages/graph/src/index.d.ts +80 -0
  48. package/dist/packages/graph/src/index.js +163 -0
  49. package/dist/packages/mcp/src/index.d.ts +119 -0
  50. package/dist/packages/mcp/src/index.js +153 -0
  51. package/dist/packages/observability/src/index.d.ts +132 -0
  52. package/dist/packages/observability/src/index.js +86 -0
  53. package/dist/packages/orchestration/src/index.d.ts +122 -0
  54. package/dist/packages/orchestration/src/index.js +178 -0
  55. package/dist/packages/planner/src/index.d.ts +22 -0
  56. package/dist/packages/planner/src/index.js +70 -0
  57. package/dist/packages/plugin-sdk/src/index.d.ts +56 -0
  58. package/dist/packages/plugin-sdk/src/index.js +55 -0
  59. package/dist/packages/policy/src/index.d.ts +80 -0
  60. package/dist/packages/policy/src/index.js +136 -0
  61. package/dist/packages/runtime/src/index.d.ts +91 -0
  62. package/dist/packages/runtime/src/index.js +217 -0
  63. package/dist/packages/sandbox/src/index.d.ts +64 -0
  64. package/dist/packages/sandbox/src/index.js +108 -0
  65. package/dist/packages/scheduler/src/index.d.ts +56 -0
  66. package/dist/packages/scheduler/src/index.js +123 -0
  67. package/dist/packages/sdk/src/index.d.ts +122 -0
  68. package/dist/packages/sdk/src/index.js +40 -0
  69. package/dist/packages/validator/src/index.d.ts +36 -0
  70. package/dist/packages/validator/src/index.js +60 -0
  71. package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -0
  72. package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -0
  73. package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -0
  74. package/docs/vision/FORJA-2.0-VISION.md +72 -0
  75. package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -0
  76. package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -0
  77. package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -0
  78. package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -0
  79. package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -0
  80. package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -0
  81. package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -0
  82. package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -0
  83. package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -0
  84. package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -0
  85. package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -0
  86. package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -0
  87. package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -0
  88. package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -0
  89. package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -0
  90. package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -0
  91. package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -0
  92. package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -0
  93. package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -0
  94. package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -0
  95. package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -0
  96. package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -0
  97. package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -0
  98. package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -0
  99. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -0
  100. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -0
  101. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -0
  102. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -0
  103. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -0
  104. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -0
  105. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -0
  106. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -0
  107. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -0
  108. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -0
  109. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -0
  110. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -0
  111. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -0
  112. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -0
  113. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -0
  114. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -0
  115. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -0
  116. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -0
  117. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -0
  118. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -0
  119. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -0
  120. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -0
  121. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -0
  122. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -0
  123. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -0
  124. package/package.json +28 -3
  125. package/README.en.md +0 -329
@@ -0,0 +1,323 @@
1
+ <h1 align="center">🔨 Forja</h1>
2
+
3
+ <p align="center">
4
+ <strong>Transforme IA de codificação em uma equipe de engenharia com processo e memória:<br>todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões.</strong>
5
+ </p>
6
+
7
+ <p align="center">
8
+ <a href="https://www.npmjs.com/package/forjajs"><img src="https://img.shields.io/npm/v/forjajs?style=flat-square&color=cb3837&logo=npm" alt="npm"></a>
9
+ <img src="https://github.com/allanpablo/forja/actions/workflows/ci.yml/badge.svg" alt="CI">
10
+ <img src="https://img.shields.io/badge/operação-CLI--first-3553ff?style=flat-square" alt="CLI-first">
11
+ <img src="https://img.shields.io/badge/agentes-6_papéis-orange?style=flat-square" alt="6 agentes">
12
+ <img src="https://img.shields.io/badge/pipeline-SDD_+_GSD-teal?style=flat-square" alt="SDD+GSD">
13
+ <img src="https://img.shields.io/badge/memória-SQLite_FTS5-green?style=flat-square" alt="Memória">
14
+ <img src="https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 20">
15
+ <img src="https://img.shields.io/badge/license-MIT-1a1a1a?style=flat-square" alt="MIT">
16
+ <img src="https://img.shields.io/badge/PRs-welcome-8957e5?style=flat-square" alt="PRs welcome">
17
+ </p>
18
+
19
+ <p align="center"><sub>🌐 <a href="README.md">English</a> · <strong>Português</strong></sub></p>
20
+
21
+ ---
22
+
23
+ ## Por que a Forja existe
24
+
25
+ Agentes de IA são **amnésicos e indisciplinados**: cada sessão recomeça do zero, decisões
26
+ de arquitetura evaporam, o código diverge da intenção — e quem opera vários produtos ao
27
+ mesmo tempo paga esse imposto multiplicado por N.
28
+
29
+ A **Forja** é o estúdio em volta da IA. Ela coordena **6 papéis de agentes** num pipeline
30
+ **Spec-Driven (SDD)** + **Get-Stuff-Done (GSD)**, mantém uma **memória hierárquica**
31
+ indexada em SQLite que sobrevive entre sessões, e amarra tudo num **core CLI único com
32
+ gates e trilha de auditoria** (`forja`, ADR-0020). Multi-IA por design (Claude, Copilot,
33
+ Gemini, Codex). A operação é inteiramente via CLI.
34
+
35
+ **Para quem**: o dev solo ou time pequeno que opera múltiplos produtos com IA como
36
+ principal força de trabalho — e precisa da disciplina de um time grande sem ter esse time.
37
+
38
+ ## Os 3 pilares
39
+
40
+ | Pilar | O que entrega | Prova |
41
+ |---|---|---|
42
+ | **Memória que sobrevive** | contexto hierárquico, buscável, compartilhado entre sessões e IAs | SQLite FTS5, smart-context (ADR-0003) |
43
+ | **Processo que governa** | nada vira código sem spec; nada estrutural sem ADR; comandos auditados | SDD+GSD, handoffs 7 campos (ADR-0005), core `forja` (ADR-0020) |
44
+ | **Fábrica, não projeto único** | workspace multi-produto, times de agentes por projeto | ADR-0019, harness, codegraph (ADR-0017) |
45
+
46
+ > Este repositório é o **motor (framework)** — não hospeda aplicações em produção.
47
+ > Os produtos do usuário vivem no **workspace Forja** (`~/forja-workspace` por padrão), fora deste repo.
48
+ > Veja ADR-0019 para a rationale.
49
+
50
+ ## 60 segundos de Forja
51
+
52
+ ```console
53
+ $ forja spec:new pagamentos-pix
54
+ ✓ Spec criada: specs/pagamentos-pix/spec.md # nada vira código sem isso
55
+
56
+ $ forja gsd:handoff plan pagamentos-pix
57
+ Handoff registrado: product → sdd-architect # 7 campos, auditável (ADR-0005)
58
+
59
+ $ forja code:impact processPayment
60
+ Mapa de impacto: processPayment (profundidade 2) # blast radius ANTES de editar
61
+ --- Chamadores diretos ---
62
+ BillingController.charge · RetryWorker.run
63
+
64
+ $ forja gsd:check pagamentos-pix
65
+ OK GSD runbook OK Spec directory
66
+ OK SDD spec check OK Codegraph
67
+ Resultado: gates básicos prontos. # governança executável, não checklist
68
+ ```
69
+
70
+ E cada comando acima ficou gravado em `.context/forja-runs.jsonl` — quando a governança pergunta "o processo foi seguido?", a resposta é um arquivo, não uma promessa.
71
+
72
+ ## Por que não só…?
73
+
74
+ | Alternativa | Onde ela para | O que a Forja acrescenta |
75
+ |---|---|---|
76
+ | **Claude Code / Copilot puros** | brilhantes na sessão, amnésicos entre sessões | memória FTS5 + processo + auditoria em volta da IA |
77
+ | **LangGraph / CrewAI** | infraestrutura para *construir* agentes | a camada de cima: opera o time de agentes no dia a dia |
78
+ | **Templates & spec kits** | param quando a spec está escrita | pipeline completo até a governança, com gates que executam |
79
+
80
+ ## Capacidades-chave
81
+
82
+ - **Core CLI único** — todo comando de processo passa por `forja <comando>`: registry declarativo, gates transversais (workspace) e auditoria append-only em `.context/forja-runs.jsonl` (ADR-0020).
83
+ - **Orquestração multiagente** — 6 papéis (orchestrator, context-engineer, sdd-architect, product, marketing, governance) com handoffs rastreados (7 campos, ADR-0005).
84
+ - **Memória hierárquica** — global → domínio → tarefa → resumo, com busca FTS5 e *smart-context* em 3 modos (ADR-0003).
85
+ - **Pipeline SDD + GSD** — `spec → plan → tasks → check`, decisões registradas como ADRs.
86
+ - **Auto-verificação (invariantes que rodam)** — o framework prova a si mesmo: uma família de gates guarda cada fronteira (núcleo, tarball, coerência de doc, topologia de agentes, projeto gerado), e `check:all` roda a bateria inteira num veredito só. A governança deixa de depender de disciplina — vira harness.
87
+ - **Economia de token medida, não afirmada** — a memória (`context.md` como mapa) economiza ~60% vs explorar no frio, e `token:economy` **prova** isso nos seus domínios. `code:context` entrega o mapa pronto; `memory:audit` garante que ele não mente sobre o código.
88
+ - **Geração de projetos** — `project:new` cria scaffold completo no workspace (memória, agentes, instruções multi-IA, backend NestJS como boilerplate padrão) e registra a ficha; `project:upgrade` traz peças novas para projetos já gerados sem tocar no código do usuário.
89
+ - **3 capacidades integradas** (ADR-0016): **codegraph** (análise de código via MCP), **harness** (desenho de times de agentes), **ai-engineering** (base de conhecimento).
90
+
91
+ ## ⚡ Quick start
92
+
93
+ ```bash
94
+ # Instalar (o pacote é forjajs; o comando é forja)
95
+ npm install -g forjajs
96
+ forja # help agrupado por domínio
97
+
98
+ # Preparar o workspace de produção (canto fixo dos projetos)
99
+ forja workspace:init
100
+
101
+ # Criar um projeto novo (gera em ~/forja-workspace/projects/<nome>)
102
+ forja project:new meu-projeto --ai claude,copilot
103
+
104
+ # Entrar no ciclo SDD/GSD da primeira feature
105
+ forja spec:new minha-feature
106
+ forja spec:plan minha-feature
107
+ forja spec:tasks minha-feature
108
+ forja spec:check minha-feature
109
+ ```
110
+
111
+ > Clonou o repo em vez de instalar? Os mesmos comandos rodam como
112
+ > `node bin/forja.ts <comando>` — os scripts npm são apenas aliases finos do core.
113
+ > A fonte é TypeScript e roda nativa: **dev exige Node ≥ 22.6** (strip-types). O pacote *publicado*
114
+ > embarca `dist/*.js` e roda em **Node ≥ 20** — o `release-gate` prova isso a cada release (SPEC-012).
115
+
116
+ Passo a passo de **criar vs atualizar** projeto: [`docs/processo-projeto.md`](docs/processo-projeto.md).
117
+
118
+ ## Como funciona — o processo
119
+
120
+ ```
121
+ 💡 Demanda
122
+ ├─ projeto NÃO existe ─► project:new + boilerplate + harness (desenha o time)
123
+ └─ projeto JÁ existe ──► overlay --only-memory + codegraph init (entende o código)
124
+ │
125
+ ▼
126
+ CICLO CLI-first (docs/fluxo.md):
127
+ 1·Entender → 2·Especificar → 3·Arquitetar → 4·Decompor → 5·Implementar → 6·Governar → ✅
128
+ ```
129
+
130
+ | Etapa | Papel | Capacidade |
131
+ |-------|-------|------------|
132
+ | 1 Entender | context-engineer | codegraph · ai-engineering |
133
+ | 2 Especificar | product | — |
134
+ | 3 Arquitetar | sdd-architect | harness · ADR |
135
+ | 4 Decompor | sdd-architect | — |
136
+ | 5 Implementar | orchestrator + worker | codegraph (MCP) |
137
+ | 6 Governar | governance | codegraph (`affected`) |
138
+
139
+ Mapa completo do ciclo: [`docs/fluxo.md`](docs/fluxo.md).
140
+
141
+ ## As 3 capacidades integradas
142
+
143
+ | Capacidade | Papel | Como usar |
144
+ |---|---|---|
145
+ | **codegraph** | análise de código (MCP local) | `forja code:index` · `codegraph explore "<área>"` · ferramentas MCP `codegraph_explore`/`codegraph_node` |
146
+ | **harness** | desenho de times de agentes (plugin) | na sessão Claude Code: _"build a harness for this project"_ → gera `.claude/agents` + `.claude/skills` |
147
+ | **ai-engineering** | base de conhecimento (referência) | ver [`docs/capacidades-externas.md`](docs/capacidades-externas.md) |
148
+
149
+ Detalhes e reinstalação: [`docs/capacidades-externas.md`](docs/capacidades-externas.md) · [ADR-0016](memory/90-decisions/0016-integracao-capacidades-externas.md).
150
+
151
+ ## O core `forja`
152
+
153
+ Todos os comandos de processo passam por um único ponto de entrada (ADR-0020):
154
+
155
+ ```bash
156
+ forja # help agrupado por domínio
157
+ forja <comando> [args] # no repo clonado: node bin/forja.ts <comando>
158
+ ```
159
+
160
+ O core aplica **gates** antes de executar (ex.: comandos de produto falham cedo sem
161
+ workspace) e grava **auditoria** de cada execução (comando, args, exit code, duração)
162
+ em `<workspace>/.context/forja-runs.jsonl` — a trilha que a governança usa no review.
163
+ Os scripts npm do repo são aliases finos que roteiam pelo core.
164
+
165
+ ## Comandos essenciais
166
+
167
+ ```bash
168
+ # Workspace & projetos
169
+ forja workspace:init # cria ~/forja-workspace
170
+ forja project:new <nome> --ai claude,copilot # cria projeto no workspace
171
+ forja project:list # lista projetos do workspace
172
+ forja project:upgrade # traz peças novas de scaffold p/ um projeto (aditivo; --apply)
173
+ forja workspace:project:check <nome> # valida padrões num projeto do workspace
174
+
175
+ # Pipeline SDD
176
+ forja spec:new <slug> # também: spec:plan · spec:tasks · spec:check
177
+
178
+ # Sprint & handoffs (GSD)
179
+ forja sprint:start # também: sprint:status · sprint:complete
180
+ forja gsd:plan <slug> # runbook GSD em .context/
181
+ forja gsd:handoff <intent> <slug> # handoff entre papéis (ADR-0005)
182
+ forja gsd:check <slug> # gates básicos do runbook
183
+ forja orchestrate "<objetivo>" --slug <s> # abre a corrida: a cadeia SDD/GSD como máquina de estados (SPEC-021)
184
+ forja orchestrate:status <slug> # o estado da máquina: etapas, gates, vereditos
185
+ forja orchestrate:advance <slug> # roda o gate da etapa; verde → próxima; vermelho → trava
186
+
187
+ # Análise de código (codegraph)
188
+ forja code:check # índice confiável (worktree + freshness)
189
+ forja code:impact <símbolo> # chamadores + blast radius antes de editar
190
+ forja code:context <domínio> # pacote de contexto mínimo (o mapa; --code p/ o código)
191
+ forja code:query "<termo>" # também: code:index · code:sync · code:status
192
+
193
+ # Memória & contexto (workspace)
194
+ forja sync:universal # reindexa SQLite FTS5 do workspace
195
+ forja query:universal "<query>" # busca FTS5
196
+ forja context:smart # smart-context (3 modos, ADR-0003)
197
+ forja token:economy [--project <path>] # economia de token; --project mede seus domínios reais (ADR-0009)
198
+ forja memory:compress # arquiva runs antigos + VACUUM
199
+ forja memory:extract # extrai conhecimento global da memória
200
+ forja memory:audit # coerência mapa↔código: mapa não mente + módulo sem mapa (SPEC-017)
201
+
202
+ # Qualidade & release
203
+ forja project:check # standards do framework (pre-commit)
204
+ forja tools:doctor # raio-x do núcleo; separa permissão/lock de corrupção; exit 1 se quebrou
205
+ forja release:check --publish # gate do tarball antes de publicar
206
+ forja project:smoke # gate do projeto gerado; --full instala e builda o backend
207
+ forja check:all # a bateria inteira de gates, um veredito; --full inclui os caros (SPEC-020)
208
+ forja project:dashboard # relatório estático de status
209
+
210
+ # Governança & auditoria
211
+ forja audit:sync # projeta a trilha de auditoria numa tabela consultável
212
+ forja audit:query --failed # consulta: --failed, --cmd <x>, --since 7d
213
+ forja governance:dashboard # painel HTML estático (gates, SDD, auditoria) — sem servidor
214
+ ```
215
+
216
+ ## Separação framework × workspace
217
+
218
+ O Forja é dividido em duas partes:
219
+
220
+ 1. **Framework** (este repositório): motor, convenções, scripts e memória do próprio framework.
221
+ 2. **Workspace** (`~/forja-workspace` por padrão): "canto fixo" onde vivem os projetos de produto, a memória universal deles e as specs de produto.
222
+
223
+ O caminho do workspace é resolvido por prioridade:
224
+
225
+ 1. Variável de ambiente `FORJA_WORKSPACE`
226
+ 2. Campo `workspaceRoot` em `~/.forjarc.json`
227
+ 3. Padrão: `~/forja-workspace`
228
+
229
+ Veja ADR-0019 para a decisão arquitetural.
230
+
231
+ ## Estrutura do repositório (framework)
232
+
233
+ ```
234
+ bin/ CLIs (forja — o core; init-project, create-memory-nest-kit)
235
+ lib/ Módulos reutilizáveis; lib/core/ é o motor de invariantes (registry, checks, health, release, doc-graph, gates)
236
+ scripts/ Automação (sprint-manager, agent-router, sync-universal-memory, …)
237
+ specs/ Pipeline SDD do próprio framework (spec → plan → tasks)
238
+ boilerplates/ Templates de stack (api-rest, saas, ecommerce, microservices, monorepo)
239
+ memory/ Memória do framework (00-global … 90-decisions/ADRs)
240
+ docs/ Documentação por persona e por tópico (ver DOC-MAP.md)
241
+ prompts/ Prompts portáteis dos 6 papéis
242
+ .claude/ Sub-agents e settings do Claude Code
243
+ projects/ LEGADO — não usar; projetos vivem no workspace externo
244
+ ```
245
+
246
+ ## Estrutura do workspace
247
+
248
+ ```
249
+ ~/forja-workspace/
250
+ projects/ # produtos gerados
251
+ memory/
252
+ sqlite/universal.db # SQLite FTS5 dos produtos
253
+ 30-projects/ # fichas dos projetos
254
+ specs/ # specs de produto
255
+ .context/ # runbooks GSD de produto
256
+ README.md
257
+ ```
258
+
259
+ ## Documentação
260
+
261
+ - [`DOC-MAP.md`](DOC-MAP.md) — mapa por papel e por tópico (comece aqui)
262
+ - [`docs/processo-projeto.md`](docs/processo-projeto.md) — criar vs atualizar projeto
263
+ - [`docs/fluxo.md`](docs/fluxo.md) — mapa do ciclo CLI-first
264
+ - [`AGENTS.md`](AGENTS.md) — os 6 papéis e a topologia
265
+ - [`memory/90-decisions/`](memory/90-decisions/) — ADRs com rationale
266
+ - [`CHANGELOG.md`](CHANGELOG.md) — histórico
267
+
268
+ ## Convenções
269
+
270
+ - **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
271
+ - **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
272
+ - **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
273
+ - **pt-BR** — comunicação e documentação em português.
274
+
275
+ ## Roadmap
276
+
277
+ O fio condutor: **converter conhecimento que vive em convenção em invariante executável.** Cada
278
+ item abaixo ou fecha uma fronteira do framework por um gate, ou leva esse padrão para os projetos
279
+ gerados.
280
+
281
+ **Entregue** (até v1.6.0)
282
+
283
+ - [x] **Família de gates** — cada fronteira do framework guarda por um invariante que roda: núcleo
284
+ (`tools:doctor`, ADR-0023), tarball (`release:check`, ADR-0024), coerência de doc + ADRs + topologia
285
+ de agentes (ADR-0025, SPEC-019), projeto gerado (`project:smoke`, ADR-0029). E `check:all` reúne a
286
+ bateria num veredito (SPEC-020).
287
+ - [x] **Migração TypeScript completa** — fonte 100% `.ts`, publica `dist/`, `noImplicitAny` ON. Achou
288
+ bugs latentes que nenhum teste pegava (SPEC-012).
289
+ - [x] **Economia de memória como sistema** — **medida** (`token:economy` prova ~60% vs frio),
290
+ **entregue** (`code:context`), **protegida** (`memory:audit`, nas duas direções) e **propagada**: o
291
+ projeto gerado herda o gate dos mapas (ADR-0030).
292
+ - [x] **`project:upgrade`** — atualizar um projeto já gerado sem perder código: aditivo, nunca
293
+ sobrescreve (SPEC-018).
294
+ - [x] **Clean Architecture calibrado** — camadas onde se pagam, enxuto onde não; e a claim de token
295
+ **medida e corrigida** — a economia é da memória, não das camadas (ADR-0027).
296
+
297
+ **Próximos passos** (por dependência, não por desejo)
298
+
299
+ - [x] **`builds` do backend gerado sob toolchain novo** — o template alinhou o `better-sqlite3` ao
300
+ do framework (^12, com prebuilds); o `check:all --full` compila o backend gerado em Node 26.
301
+ - [x] **`release-auditor` consome o gate** — o agente executa e julga `release:check --publish`
302
+ (ADR-0024), incluindo o `consumer-spec-new`; não reimplementa o procedimento.
303
+ - [ ] **Boilerplates além de NestJS** — o processo é agnóstico de stack; os templates vão atrás.
304
+ - [ ] **(visão) o motor de orquestração** — a cadeia de handoffs que **roda**, não só é coerente
305
+ (SPEC-019 deixou como futuro). O namesake executando: candidato ao 2.0.
306
+
307
+ Sugestões? Abra uma issue — feature não-trivial aqui começa por spec, inclusive as suas.
308
+
309
+ ## English
310
+
311
+ Full English version: **[README.md](README.md)**. In short — **Forja** turns coding AI into an
312
+ engineering team with process and memory: every project starts from a spec, every structural
313
+ decision becomes an ADR, and nothing is lost between sessions. Documentation is in Brazilian
314
+ Portuguese — that's part of the project's identity; the CLI and the code are readable regardless.
315
+
316
+ ---
317
+
318
+ <p align="center">
319
+ <strong>A Forja te ajudou a domar seus agentes?</strong><br>
320
+ Uma ⭐ é o que faz o projeto chegar a mais devs que estão pagando o imposto da IA amnésica.
321
+ </p>
322
+
323
+ <p align="center"><sub>Forja (npm: <code>forjajs</code>) · MIT License · <a href="CONTRIBUTING.md">Contribuindo</a></sub></p>
@@ -0,0 +1,10 @@
1
+ export declare function GET(request: Request, context: {
2
+ params: Promise<{
3
+ path: string[];
4
+ }>;
5
+ }): Promise<Response>;
6
+ export declare function POST(request: Request, context: {
7
+ params: Promise<{
8
+ path: string[];
9
+ }>;
10
+ }): Promise<Response>;
@@ -0,0 +1,36 @@
1
+ // @ts-expect-error Next resolves the adjacent TypeScript helper.
2
+ import { buildApprovalDecisionBody } from '../approval';
3
+ const allowedPrefixes = ['/control-plane/metrics', '/observability/observations', '/events/stream', '/executions/', '/graph/query', '/graph/impact', '/approvals'];
4
+ export async function GET(request, context) { return forward(request, await context.params, 'GET'); }
5
+ export async function POST(request, context) { return forward(request, await context.params, 'POST'); }
6
+ async function forward(request, params, method) {
7
+ const path = `/${params.path.join('/')}`;
8
+ if (!allowedPrefixes.some((prefix) => path === prefix || path.startsWith(prefix)))
9
+ return new Response(JSON.stringify({ error: { code: 'FORBIDDEN', message: 'Dashboard route is not allowed' } }), { status: 403, headers: { 'content-type': 'application/json' } });
10
+ const backend = process.env.FORJA_API_URL ?? 'http://localhost:3000';
11
+ const token = process.env.FORJA_API_TOKEN;
12
+ const headers = new Headers({ accept: request.headers.get('accept') ?? 'application/json' });
13
+ if (token !== undefined)
14
+ headers.set('authorization', `Bearer ${token}`);
15
+ if (method === 'POST')
16
+ headers.set('content-type', request.headers.get('content-type') ?? 'application/json');
17
+ let body;
18
+ if (method === 'POST') {
19
+ if (path.endsWith('/decide')) {
20
+ try {
21
+ body = new TextEncoder().encode(JSON.stringify(buildApprovalDecisionBody(await request.json(), process.env.FORJA_APPROVER_ID ?? '', new Date().toISOString()))).buffer;
22
+ }
23
+ catch (error) {
24
+ return new Response(JSON.stringify({ error: { code: 'APPROVAL_CONFIGURATION', message: error instanceof Error ? error.message : 'Approval configuration is invalid' } }), { status: 503, headers: { 'content-type': 'application/json' } });
25
+ }
26
+ }
27
+ else
28
+ body = await request.arrayBuffer();
29
+ }
30
+ const response = await fetch(`${backend}/api${path}${new URL(request.url).search}`, { method, headers, body, cache: 'no-store' });
31
+ const responseHeaders = new Headers({ 'content-type': response.headers.get('content-type') ?? 'application/json' });
32
+ const cacheControl = response.headers.get('cache-control');
33
+ if (cacheControl !== null)
34
+ responseHeaders.set('cache-control', cacheControl);
35
+ return new Response(response.body, { status: response.status, headers: responseHeaders });
36
+ }
@@ -0,0 +1 @@
1
+ export declare function buildApprovalDecisionBody(input: unknown, approverId: string, decidedAt: string): Record<string, unknown>;
@@ -0,0 +1,8 @@
1
+ export function buildApprovalDecisionBody(input, approverId, decidedAt) {
2
+ if (!isRecord(input) || (input.decision !== 'approved' && input.decision !== 'rejected'))
3
+ throw new Error('Approval decision must be approved or rejected');
4
+ if (approverId.trim().length === 0)
5
+ throw new Error('FORJA_APPROVER_ID is required');
6
+ return { decision: input.decision, approverId, decidedAt };
7
+ }
8
+ function isRecord(value) { return typeof value === 'object' && value !== null; }
@@ -0,0 +1 @@
1
+ export default function DashboardClient(): import("react").JSX.Element;
@@ -0,0 +1,62 @@
1
+ 'use client';
2
+ import { useQuery, useQueryClient } from '@tanstack/react-query';
3
+ import { useEffect, useState } from 'react';
4
+ const dashboardApi = '/api/forja';
5
+ export default function DashboardClient() {
6
+ const queryClient = useQueryClient();
7
+ const [error, setError] = useState(undefined);
8
+ const snapshot = useQuery({ queryKey: ['control-plane', 'snapshot'], queryFn: loadSnapshot });
9
+ const [impactOrigin, setImpactOrigin] = useState('');
10
+ const impact = useQuery({ queryKey: ['graph', 'impact', impactOrigin], queryFn: () => loadImpact(impactOrigin), enabled: false });
11
+ useEffect(() => {
12
+ const source = new EventSource(`${dashboardApi}/events/stream`);
13
+ source.onmessage = () => { void queryClient.invalidateQueries({ queryKey: ['control-plane', 'snapshot'] }); };
14
+ source.onerror = () => source.close();
15
+ return () => source.close();
16
+ }, [queryClient]);
17
+ async function execute(path) {
18
+ try {
19
+ const response = await fetch(`${dashboardApi}${path}`, { method: 'POST' });
20
+ if (!response.ok)
21
+ throw new Error('Ação recusada pelo Control Plane');
22
+ await queryClient.invalidateQueries({ queryKey: ['control-plane', 'snapshot'] });
23
+ setError(undefined);
24
+ }
25
+ catch (reason) {
26
+ setError(reason instanceof Error ? reason.message : 'Falha na ação');
27
+ }
28
+ }
29
+ async function decideApproval(id, decision) {
30
+ try {
31
+ const response = await fetch(`${dashboardApi}/approvals/${encodeURIComponent(id)}/decide`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ decision }) });
32
+ if (!response.ok)
33
+ throw new Error('Decisão recusada pelo Control Plane');
34
+ await queryClient.invalidateQueries({ queryKey: ['control-plane', 'snapshot'] });
35
+ setError(undefined);
36
+ }
37
+ catch (reason) {
38
+ setError(reason instanceof Error ? reason.message : 'Falha na decisão');
39
+ }
40
+ }
41
+ const metrics = snapshot.data?.metrics;
42
+ return <>
43
+ <header className="header"><div><p className="eyebrow">FORJAJS 2.0</p><h1>Control Plane</h1><p className="muted">Autonomia supervisionada, evidência e execução auditável.</p></div><button onClick={() => void snapshot.refetch()} disabled={snapshot.isFetching}>{snapshot.isFetching ? 'Atualizando…' : 'Atualizar'}</button></header>
44
+ {(error !== undefined || snapshot.error !== null) && <div className="alert" role="alert">{error ?? 'Control Plane indisponível'}</div>}
45
+ <section className="grid" aria-label="Métricas operacionais"><Metric label="Execuções" value={metrics?.runCount ?? 0}/><Metric label="Taxa de sucesso" value={`${((metrics?.successRate ?? 0) * 100).toFixed(1)}%`}/><Metric label="Tokens de entrada" value={metrics?.totalInputTokens ?? 0}/><Metric label="Observações" value={metrics?.observationCount ?? 0}/></section>
46
+ <section className="panel"><div className="panel-title"><h2>GraphLoop</h2><span className="muted">nós com origem no backend</span></div><div className="graph-controls"><input aria-label="ID do nó de impacto" value={impactOrigin} onChange={(event) => setImpactOrigin(event.target.value)} placeholder="ID do nó para impacto"/><button onClick={() => void impact.refetch()} disabled={impactOrigin.trim().length === 0}>Calcular impacto</button></div><div className="graph-grid">{snapshot.data?.graphNodes.slice(0, 12).map((node) => <span key={node.id} className="node"><strong>{node.label}</strong><small>{node.type} · {node.status}</small></span>)}</div>{impact.data !== undefined && <pre className="impact">{JSON.stringify(impact.data, null, 2)}</pre>}</section>
47
+ <section className="panel"><div className="panel-title"><h2>Approvals</h2><span className="muted">identidade configurada no servidor</span></div>{snapshot.data?.approvals.length === 0 && <p className="muted">Nenhuma aprovação registrada.</p>}<ul className="events">{snapshot.data?.approvals.map((approval) => <li key={approval.id}><span className="dot"/><span><strong>{approval.decision ?? 'pending'}</strong> · {approval.action}<small>{approval.impact}</small></span>{approval.decision === undefined && <span className="actions"><button onClick={() => void decideApproval(approval.id, 'approved')}>Aprovar</button><button onClick={() => void decideApproval(approval.id, 'rejected')}>Rejeitar</button></span>}</li>)}</ul></section>
48
+ <section className="panel"><div className="panel-title"><h2>Atividade recente</h2><span className="muted">{snapshot.isFetching ? 'sincronizando' : 'estado remoto'}</span></div>
49
+ {snapshot.data?.observations.length === 0 && <p className="muted">Nenhuma observação registrada.</p>}
50
+ <ul className="events">{snapshot.data?.observations.slice(-8).reverse().map((observation) => <li key={observation.id}><span className={`dot ${observation.outcome}`}/><span><strong>{observation.outcome}</strong> · {observation.capabilityId ?? 'operação do Control Plane'}<small>{observation.traceId}</small></span>{observation.runId !== undefined && <span className="actions"><button onClick={() => void execute(`/executions/${observation.runId}/pause`)}>Pausar</button><button onClick={() => void execute(`/executions/${observation.runId}/cancel`)}>Cancelar</button></span>}</li>)}</ul>
51
+ </section>
52
+ </>;
53
+ }
54
+ async function loadSnapshot() {
55
+ const [metricsResponse, observationsResponse, graphResponse, approvalsResponse] = await Promise.all([fetch(`${dashboardApi}/control-plane/metrics`), fetch(`${dashboardApi}/observability/observations`), fetch(`${dashboardApi}/graph/query`), fetch(`${dashboardApi}/approvals`)]);
56
+ if (![metricsResponse, observationsResponse, graphResponse, approvalsResponse].every((response) => response.ok))
57
+ throw new Error('Control Plane indisponível');
58
+ return { metrics: await metricsResponse.json(), observations: await observationsResponse.json(), graphNodes: await graphResponse.json(), approvals: await approvalsResponse.json() };
59
+ }
60
+ async function loadImpact(origin) { const response = await fetch(`${dashboardApi}/graph/impact?origin=${encodeURIComponent(origin)}`); if (!response.ok)
61
+ throw new Error('Impacto não disponível'); return response.json(); }
62
+ function Metric({ label, value }) { return <article className="metric"><span>{label}</span><strong>{value}</strong></article>; }
@@ -0,0 +1,9 @@
1
+ import type { ReactNode } from 'react';
2
+ import './globals.css';
3
+ export declare const metadata: {
4
+ title: string;
5
+ description: string;
6
+ };
7
+ export default function RootLayout({ children }: Readonly<{
8
+ children: ReactNode;
9
+ }>): import("react").JSX.Element;
@@ -0,0 +1,7 @@
1
+ import './globals.css';
2
+ // @ts-expect-error Next resolves the adjacent TypeScript client component.
3
+ import Providers from './providers';
4
+ export const metadata = { title: 'ForjaJS Control Plane', description: 'Operação supervisionada de agentes ForjaJS' };
5
+ export default function RootLayout({ children }) {
6
+ return <html lang="pt-BR"><body><Providers>{children}</Providers></body></html>;
7
+ }
@@ -0,0 +1 @@
1
+ export default function Page(): import("react").JSX.Element;
@@ -0,0 +1,5 @@
1
+ // @ts-expect-error Next resolves the adjacent TypeScript client component.
2
+ import DashboardClient from './dashboard-client';
3
+ export default function Page() {
4
+ return <main className="shell"><DashboardClient /></main>;
5
+ }
@@ -0,0 +1,4 @@
1
+ import { type ReactNode } from 'react';
2
+ export default function Providers({ children }: Readonly<{
3
+ children: ReactNode;
4
+ }>): import("react").JSX.Element;
@@ -0,0 +1,7 @@
1
+ 'use client';
2
+ import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
3
+ import { useState } from 'react';
4
+ export default function Providers({ children }) {
5
+ const [queryClient] = useState(() => new QueryClient({ defaultOptions: { queries: { staleTime: 5_000, refetchOnWindowFocus: false } } }));
6
+ return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>;
7
+ }
@@ -0,0 +1,6 @@
1
+ export default nextConfig;
2
+ declare namespace nextConfig {
3
+ let reactStrictMode: boolean;
4
+ let output: string;
5
+ let outputFileTracingRoot: string;
6
+ }
@@ -0,0 +1,8 @@
1
+ /** @type {import('next').NextConfig} */
2
+ import path from 'node:path';
3
+ const nextConfig = {
4
+ reactStrictMode: true,
5
+ output: 'standalone',
6
+ outputFileTracingRoot: path.resolve(process.cwd(), '../..'),
7
+ };
8
+ export default nextConfig;
@@ -0,0 +1,14 @@
1
+ import type { ControlPlaneMetrics, Observation } from '../../../packages/contracts/src/index.ts';
2
+ import type { ControlPlanePort } from '../../../packages/observability/src/index.ts';
3
+ export interface DashboardSnapshot {
4
+ readonly metrics: ControlPlaneMetrics;
5
+ readonly observations: readonly Observation[];
6
+ readonly generatedAt: string;
7
+ }
8
+ export interface DashboardActions {
9
+ readonly pauseRuntime: (runId: string) => Promise<unknown>;
10
+ readonly cancelRuntime: (runId: string) => Promise<unknown>;
11
+ readonly approve: (requestId: string, input: unknown) => Promise<unknown>;
12
+ }
13
+ export declare function loadDashboardSnapshot(controlPlane: ControlPlanePort): Promise<DashboardSnapshot>;
14
+ export declare function dashboardActions(controlPlane: ControlPlanePort): DashboardActions;
@@ -0,0 +1,16 @@
1
+ export async function loadDashboardSnapshot(controlPlane) {
2
+ const [metrics, observations] = await Promise.all([controlPlane.metrics(), controlPlane.observations()]);
3
+ return { metrics, observations, generatedAt: new Date().toISOString() };
4
+ }
5
+ export function dashboardActions(controlPlane) {
6
+ return {
7
+ pauseRuntime: async (runId) => requireService(controlPlane.runtimePause, 'runtimePause')(runId),
8
+ cancelRuntime: async (runId) => requireService(controlPlane.runtimeCancel, 'runtimeCancel')(runId),
9
+ approve: async (requestId, input) => requireService(controlPlane.approvalDecide, 'approvalDecide')(requestId, input),
10
+ };
11
+ }
12
+ function requireService(service, name) {
13
+ if (service === undefined)
14
+ throw new Error(`Dashboard service is not configured: ${name}`);
15
+ return service;
16
+ }
@@ -0,0 +1,5 @@
1
+ import { type DynamicModule } from '@nestjs/common';
2
+ import { type ForjaNestModuleOptions } from './forja-nest.module.ts';
3
+ export declare class AppModule {
4
+ static register(options: ForjaNestModuleOptions): DynamicModule;
5
+ }
@@ -0,0 +1,16 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var AppModule_1;
8
+ import { Module } from '@nestjs/common';
9
+ import { ForjaNestModule } from "./forja-nest.module.js";
10
+ let AppModule = AppModule_1 = class AppModule {
11
+ static register(options) { return { module: AppModule_1, imports: [ForjaNestModule.register(options)] }; }
12
+ };
13
+ AppModule = AppModule_1 = __decorate([
14
+ Module({})
15
+ ], AppModule);
16
+ export { AppModule };
@@ -0,0 +1,59 @@
1
+ import { CanActivate, DynamicModule, ExecutionContext } from '@nestjs/common';
2
+ import type { Request, Response } from 'express';
3
+ import type { Observable } from 'rxjs';
4
+ import { ForjaNestAdapter, type EventStream, type LocalAuthenticator } from '../../../packages/adapter-nest/src/index.ts';
5
+ import type { McpServer } from '../../../packages/mcp/src/index.ts';
6
+ import type { ControlPlanePort } from '../../../packages/observability/src/index.ts';
7
+ export declare const FORJA_MCP: unique symbol;
8
+ export declare const FORJA_EVENT_STREAM: unique symbol;
9
+ export declare const FORJA_AUTHENTICATOR: unique symbol;
10
+ export declare const FORJA_CONTROL_PLANE: unique symbol;
11
+ export interface ForjaNestModuleOptions {
12
+ readonly mcp: McpServer;
13
+ readonly eventStream?: EventStream;
14
+ readonly authenticator?: LocalAuthenticator;
15
+ readonly controlPlane?: ControlPlanePort;
16
+ }
17
+ export declare class ForjaLocalAuthGuard implements CanActivate {
18
+ private readonly authenticator?;
19
+ constructor(authenticator?: LocalAuthenticator);
20
+ canActivate(context: ExecutionContext): Promise<boolean>;
21
+ }
22
+ export declare class ForjaNestController {
23
+ private readonly adapter;
24
+ constructor(adapter: ForjaNestAdapter);
25
+ health(request: Request, response: Response): Promise<unknown>;
26
+ capabilities(request: Request, response: Response): Promise<unknown>;
27
+ execute(request: Request, response: Response): Promise<unknown>;
28
+ context(request: Request, response: Response): Promise<unknown>;
29
+ graphQuery(request: Request, response: Response): Promise<unknown>;
30
+ graphImpact(request: Request, response: Response): Promise<unknown>;
31
+ taskNext(request: Request, response: Response): Promise<unknown>;
32
+ handoff(request: Request, response: Response): Promise<unknown>;
33
+ runtimeStart(request: Request, response: Response): Promise<unknown>;
34
+ runtimeGet(request: Request, response: Response): Promise<unknown>;
35
+ runtimeExecute(request: Request, response: Response): Promise<unknown>;
36
+ runtimePause(request: Request, response: Response): Promise<unknown>;
37
+ runtimeResume(request: Request, response: Response): Promise<unknown>;
38
+ runtimeCancel(request: Request, response: Response): Promise<unknown>;
39
+ sprintCreate(request: Request, response: Response): Promise<unknown>;
40
+ sprintStart(request: Request, response: Response): Promise<unknown>;
41
+ sprintPause(request: Request, response: Response): Promise<unknown>;
42
+ taskCreate(request: Request, response: Response): Promise<unknown>;
43
+ taskStart(request: Request, response: Response): Promise<unknown>;
44
+ taskBlock(request: Request, response: Response): Promise<unknown>;
45
+ approvalGet(request: Request, response: Response): Promise<unknown>;
46
+ approvalDecide(request: Request, response: Response): Promise<unknown>;
47
+ tools(request: Request, response: Response): Promise<unknown>;
48
+ resources(request: Request, response: Response): Promise<unknown>;
49
+ events(): Observable<{
50
+ readonly id: string;
51
+ readonly type: string;
52
+ readonly data: unknown;
53
+ }>;
54
+ private route;
55
+ private correlation;
56
+ }
57
+ export declare class ForjaNestModule {
58
+ static register(options: ForjaNestModuleOptions): DynamicModule;
59
+ }