forjajs 1.7.2 → 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.
- package/CHANGELOG.md +49 -0
- package/README.md +223 -217
- package/README.pt-BR.md +323 -0
- package/dist/apps/dashboard/app/api/forja/[...path]/route.d.ts +10 -0
- package/dist/apps/dashboard/app/api/forja/[...path]/route.js +36 -0
- package/dist/apps/dashboard/app/api/forja/approval.d.ts +1 -0
- package/dist/apps/dashboard/app/api/forja/approval.js +8 -0
- package/dist/apps/dashboard/app/dashboard-client.d.ts +1 -0
- package/dist/apps/dashboard/app/dashboard-client.jsx +62 -0
- package/dist/apps/dashboard/app/layout.d.ts +9 -0
- package/dist/apps/dashboard/app/layout.jsx +7 -0
- package/dist/apps/dashboard/app/page.d.ts +1 -0
- package/dist/apps/dashboard/app/page.jsx +5 -0
- package/dist/apps/dashboard/app/providers.d.ts +4 -0
- package/dist/apps/dashboard/app/providers.jsx +7 -0
- package/dist/apps/dashboard/next.config.d.mts +6 -0
- package/dist/apps/dashboard/next.config.mjs +8 -0
- package/dist/apps/dashboard/src/index.d.ts +14 -0
- package/dist/apps/dashboard/src/index.js +16 -0
- package/dist/apps/server/src/app.module.d.ts +5 -0
- package/dist/apps/server/src/app.module.js +16 -0
- package/dist/apps/server/src/forja-nest.module.d.ts +59 -0
- package/dist/apps/server/src/forja-nest.module.js +316 -0
- package/dist/apps/server/src/index.d.ts +15 -0
- package/dist/apps/server/src/index.js +7 -0
- package/dist/apps/server/src/main.d.ts +12 -0
- package/dist/apps/server/src/main.js +105 -0
- package/dist/apps/worker/src/main.d.ts +12 -0
- package/dist/apps/worker/src/main.js +18 -0
- package/dist/lib/core/health.js +26 -4
- package/dist/packages/adapter-git/src/index.d.ts +27 -0
- package/dist/packages/adapter-git/src/index.js +53 -0
- package/dist/packages/adapter-nest/src/index.d.ts +71 -0
- package/dist/packages/adapter-nest/src/index.js +142 -0
- package/dist/packages/adapter-sqlite/src/index.d.ts +99 -0
- package/dist/packages/adapter-sqlite/src/index.js +108 -0
- package/dist/packages/context/src/index.d.ts +52 -0
- package/dist/packages/context/src/index.js +108 -0
- package/dist/packages/contracts/src/index.d.ts +368 -0
- package/dist/packages/contracts/src/index.js +27 -0
- package/dist/packages/core/src/index.d.ts +68 -0
- package/dist/packages/core/src/index.js +141 -0
- package/dist/packages/evals/src/index.d.ts +22 -0
- package/dist/packages/evals/src/index.js +65 -0
- package/dist/packages/events/src/index.d.ts +47 -0
- package/dist/packages/events/src/index.js +96 -0
- package/dist/packages/graph/src/index.d.ts +80 -0
- package/dist/packages/graph/src/index.js +163 -0
- package/dist/packages/mcp/src/index.d.ts +119 -0
- package/dist/packages/mcp/src/index.js +153 -0
- package/dist/packages/observability/src/index.d.ts +132 -0
- package/dist/packages/observability/src/index.js +86 -0
- package/dist/packages/orchestration/src/index.d.ts +122 -0
- package/dist/packages/orchestration/src/index.js +178 -0
- package/dist/packages/planner/src/index.d.ts +22 -0
- package/dist/packages/planner/src/index.js +70 -0
- package/dist/packages/plugin-sdk/src/index.d.ts +56 -0
- package/dist/packages/plugin-sdk/src/index.js +55 -0
- package/dist/packages/policy/src/index.d.ts +80 -0
- package/dist/packages/policy/src/index.js +136 -0
- package/dist/packages/runtime/src/index.d.ts +91 -0
- package/dist/packages/runtime/src/index.js +217 -0
- package/dist/packages/sandbox/src/index.d.ts +64 -0
- package/dist/packages/sandbox/src/index.js +108 -0
- package/dist/packages/scheduler/src/index.d.ts +56 -0
- package/dist/packages/scheduler/src/index.js +123 -0
- package/dist/packages/sdk/src/index.d.ts +122 -0
- package/dist/packages/sdk/src/index.js +40 -0
- package/dist/packages/validator/src/index.d.ts +36 -0
- package/dist/packages/validator/src/index.js +60 -0
- package/docs/architecture/FORJA-2.0-ARCHITECTURE.md +109 -0
- package/docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md +273 -0
- package/docs/security/FORJA-2.0-RELEASE-AUDIT-2026-08-01.md +95 -0
- package/docs/vision/FORJA-2.0-VISION.md +72 -0
- package/memory/50-orchestration/handoffs/2026-07-31_architect_foundation-contracts.md +15 -0
- package/memory/50-orchestration/handoffs/2026-07-31_backend-nest.md +22 -0
- package/memory/50-orchestration/handoffs/2026-07-31_context-engine.md +16 -0
- package/memory/50-orchestration/handoffs/2026-07-31_control-plane.md +28 -0
- package/memory/50-orchestration/handoffs/2026-07-31_core-capability-registry.md +15 -0
- package/memory/50-orchestration/handoffs/2026-07-31_evals-plugin-sdk.md +22 -0
- package/memory/50-orchestration/handoffs/2026-07-31_events-scheduler.md +16 -0
- package/memory/50-orchestration/handoffs/2026-07-31_graphloop.md +16 -0
- package/memory/50-orchestration/handoffs/2026-07-31_mcp.md +21 -0
- package/memory/50-orchestration/handoffs/2026-07-31_nest-bootstrap.md +28 -0
- package/memory/50-orchestration/handoffs/2026-07-31_next-dashboard.md +22 -0
- package/memory/50-orchestration/handoffs/2026-07-31_observability.md +27 -0
- package/memory/50-orchestration/handoffs/2026-07-31_orchestration.md +21 -0
- package/memory/50-orchestration/handoffs/2026-07-31_planner-validator.md +16 -0
- package/memory/50-orchestration/handoffs/2026-07-31_policy-engine.md +14 -0
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-control-plane.md +23 -0
- package/memory/50-orchestration/handoffs/2026-07-31_runtime-controlado.md +15 -0
- package/memory/50-orchestration/handoffs/2026-07-31_sandbox.md +21 -0
- package/memory/50-orchestration/handoffs/2026-07-31_sdk.md +27 -0
- package/memory/50-orchestration/handoffs/2026-07-31_sqlite-adapter.md +21 -0
- package/memory/50-orchestration/handoffs/2026-07-31_worker-dashboard-boundary.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_approval-server-identity.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_dashboard-auth-query.md +24 -0
- package/memory/50-orchestration/handoffs/2026-08-01_graphloop-approvals.md +23 -0
- package/memory/90-decisions/0033-doctor-distingue-permissao-de-corrupcao.md +64 -0
- package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -0
- package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -0
- package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -0
- package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -0
- package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -0
- package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -0
- package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -0
- package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -0
- package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -0
- package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -0
- package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -0
- package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -0
- package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -0
- package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -0
- package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -0
- package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -0
- package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -0
- package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -0
- package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -0
- package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -0
- package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -0
- package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -0
- package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -0
- package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -0
- package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -0
- package/package.json +28 -3
- package/README.en.md +0 -329
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Auditoria de segurança e release — ForjaJS 2.0
|
|
2
|
+
|
|
3
|
+
**Data:** 2026-08-01
|
|
4
|
+
**Escopo:** working tree local de `/home/apk/Documentos/GitHub/forja`
|
|
5
|
+
**Parecer:** **NO-GO condicional**
|
|
6
|
+
|
|
7
|
+
## Objetivo
|
|
8
|
+
|
|
9
|
+
Verificar se a implementação atual atende aos gates mínimos de segurança,
|
|
10
|
+
contratos, testes, empacotamento e publicação sem declarar cobertura maior que
|
|
11
|
+
a efetivamente executada.
|
|
12
|
+
|
|
13
|
+
## Evidências executadas
|
|
14
|
+
|
|
15
|
+
| Verificação | Resultado |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `tsc --noEmit` | passou |
|
|
18
|
+
| `next build` no dashboard | passou |
|
|
19
|
+
| `npm run build` | passou |
|
|
20
|
+
| `npm test -- --test-concurrency=1` | 267 testes passaram |
|
|
21
|
+
| `git diff --check` | passou |
|
|
22
|
+
| `npm audit --offline --omit=dev --audit-level=high` | passou: 0 vulnerabilidades |
|
|
23
|
+
| `gitleaks dir --redact ... .` após limpar `.next` | passou: 0 achados |
|
|
24
|
+
| `FORJA_WORKSPACE=/tmp/forja-workspace npm run release:check -- --publish` | falhou em `tree-clean` |
|
|
25
|
+
|
|
26
|
+
O gate de publicação também confirmou que instalação isolada, os 50 scripts
|
|
27
|
+
registrados, smoke commands, criação de spec no consumidor, `project:check`,
|
|
28
|
+
superfícies consumidoras, imports relativos e dependências declaradas passam.
|
|
29
|
+
|
|
30
|
+
## Bloqueios de release
|
|
31
|
+
|
|
32
|
+
### SEC-001 — dependências de produção vulneráveis — RESOLVIDO
|
|
33
|
+
|
|
34
|
+
`@nestjs/swagger` foi atualizado para `11.4.5`. Next e o dashboard foram
|
|
35
|
+
atualizados para `16.2.12`, com overrides compatíveis para `postcss@8.5.25` e
|
|
36
|
+
`sharp@0.35.3`. Uma instalação limpa (`npm install`) produziu uma árvore
|
|
37
|
+
consistente e `npm audit --offline --omit=dev --audit-level=high` retornou zero
|
|
38
|
+
vulnerabilidades. A atualização de major exige revisão funcional antes do GO
|
|
39
|
+
definitivo.
|
|
40
|
+
|
|
41
|
+
### REL-001 — árvore não limpa — CRITICAL para publicação
|
|
42
|
+
|
|
43
|
+
`release:check --publish` reprovou porque há 54 arquivos não commitados. O
|
|
44
|
+
tarball de publicação não corresponde a um commit revisável. É necessário
|
|
45
|
+
revisar o diff, executar os gates novamente e criar um commit intencional antes
|
|
46
|
+
de qualquer publicação. Nenhum `npm publish` foi executado.
|
|
47
|
+
|
|
48
|
+
### SEC-002 — Gitleaks em artefatos gerados — RESOLVIDO
|
|
49
|
+
|
|
50
|
+
Os 9 achados iniciais estavam em `apps/dashboard/.next/**`, incluindo
|
|
51
|
+
manifests/cache gerados pelo build. O conteúdo não foi exposto neste relatório.
|
|
52
|
+
Após ignorar e remover o diretório, a nova varredura encontrou zero achados.
|
|
53
|
+
|
|
54
|
+
## Cobertura e limitações
|
|
55
|
+
|
|
56
|
+
O preflight da auditoria de segurança marcou a execução como incompleta porque
|
|
57
|
+
não havia workers/delegação disponíveis. Portanto este documento é um parecer
|
|
58
|
+
manual focado nos gates de release, dependências, superfícies de autenticação,
|
|
59
|
+
proxy do dashboard, adapters e testes existentes; não é uma declaração de scan
|
|
60
|
+
exaustivo de cada arquivo nem substitui a varredura delegada completa.
|
|
61
|
+
|
|
62
|
+
O primeiro `release:check` no sandbox também encontrou `EPERM` ao iniciar
|
|
63
|
+
`git` e `EROFS` ao gravar a auditoria externa. A repetição fora do sandbox com
|
|
64
|
+
workspace temporário eliminou essas limitações e produziu o resultado
|
|
65
|
+
reprodutível descrito acima.
|
|
66
|
+
|
|
67
|
+
## Decisão
|
|
68
|
+
|
|
69
|
+
**NO-GO condicional para publicação.** As vulnerabilidades e os achados de
|
|
70
|
+
segredo foram resolvidos, mas a árvore ainda não está limpa e a atualização do
|
|
71
|
+
Next major precisa de revisão final. O gate de publicação continua bloqueado.
|
|
72
|
+
|
|
73
|
+
## Critérios para reabrir o GO
|
|
74
|
+
|
|
75
|
+
1. Revisar a migração do Next 15 para 16 e registrar compatibilidade.
|
|
76
|
+
2. Reexecutar `npm audit --omit=dev --audit-level=high` com acesso ao registry,
|
|
77
|
+
além da confirmação offline já executada.
|
|
78
|
+
3. Limpar e reexecutar Gitleaks, confirmando zero segredo real fora de artefatos
|
|
79
|
+
ignorados.
|
|
80
|
+
4. Executar `tsc --noEmit`, `npm run build`, `next build` no dashboard,
|
|
81
|
+
`npm test -- --test-concurrency=1`, `git diff --check` e
|
|
82
|
+
`npm run release:check -- --publish`.
|
|
83
|
+
5. Revisar o diff, criar commit e repetir a auditoria de segurança com cobertura
|
|
84
|
+
completa/delegada quando os workers estiverem disponíveis.
|
|
85
|
+
|
|
86
|
+
## Handoff compacto
|
|
87
|
+
|
|
88
|
+
- **Objetivo:** decidir prontidão de release do ForjaJS 2.0.
|
|
89
|
+
- **Concluído:** gates funcionais executados; vulnerabilidades e falhas de
|
|
90
|
+
publicação registradas; `.next` excluído do escopo Git.
|
|
91
|
+
- **Bloqueios:** SEC-001, REL-001, SEC-002.
|
|
92
|
+
- **Evidências:** comandos e resultados neste documento; `package-lock.json`;
|
|
93
|
+
`release:check --publish`.
|
|
94
|
+
- **Próximo agente:** executor da correção de dependências, seguido por
|
|
95
|
+
Governance/Release Auditor para repetir todos os gates.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# ForjaJS 2.0 — Visão
|
|
2
|
+
|
|
3
|
+
## Problema
|
|
4
|
+
|
|
5
|
+
Agentes de desenvolvimento conseguem editar código, mas não mantêm memória verificável,
|
|
6
|
+
limites de autonomia, contexto econômico ou uma trilha uniforme de decisão. O ForjaJS 1.x
|
|
7
|
+
resolve parte disso como CLI; a 2.0 transforma essas capacidades em contratos e serviços
|
|
8
|
+
programáveis, preservando a operação CLI-first.
|
|
9
|
+
|
|
10
|
+
## Usuário principal e casos de uso
|
|
11
|
+
|
|
12
|
+
O usuário principal é o desenvolvedor solo ou time pequeno que opera um ou mais repositórios
|
|
13
|
+
com agentes. Casos prioritários:
|
|
14
|
+
|
|
15
|
+
- descobrir e executar uma capability com entrada e saída validadas;
|
|
16
|
+
- executar uma tarefa supervisionada, pausá-la e retomá-la com checkpoint;
|
|
17
|
+
- entregar contexto mínimo baseado em memória, grafo, evidência e orçamento;
|
|
18
|
+
- bloquear escrita, rede ou ações destrutivas por política;
|
|
19
|
+
- revisar um resultado com evidências independentes antes de marcar a tarefa concluída;
|
|
20
|
+
- consumir o mesmo núcleo pela CLI, SDK, MCP, worker e backend.
|
|
21
|
+
|
|
22
|
+
## Proposta de valor verificável
|
|
23
|
+
|
|
24
|
+
ForjaJS 2.0 é uma plataforma local-first para memória, contexto, execução, governança e
|
|
25
|
+
autonomia de agentes de desenvolvimento. A promessa é limitada às seguintes provas:
|
|
26
|
+
|
|
27
|
+
| Promessa | Prova esperada |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| Ações descobríveis | registry versionado e introspectável |
|
|
30
|
+
| Autonomia limitada | decisão de política, aprovação, orçamento e sandbox por execução |
|
|
31
|
+
| Memória confiável | evidência, validade temporal e status de conhecimento |
|
|
32
|
+
| Contexto econômico | refs, checksums, cache e métricas de tokens |
|
|
33
|
+
| Falsa conclusão bloqueada | validator independente com resultado estruturado |
|
|
34
|
+
|
|
35
|
+
## Diferenciação técnica
|
|
36
|
+
|
|
37
|
+
CLIs de agentes normalmente são superfícies de comando; frameworks de agentes normalmente
|
|
38
|
+
orquestram loops; ferramentas de memória normalmente não governam execução. O Forja combina
|
|
39
|
+
essas três preocupações em um núcleo de domínio independente de framework, com adapters para
|
|
40
|
+
CLI, MCP, REST, SQLite e NestJS. GraphLoop é o grafo verificável de trabalho e contexto; não
|
|
41
|
+
é apenas um índice de símbolos.
|
|
42
|
+
|
|
43
|
+
## Princípios
|
|
44
|
+
|
|
45
|
+
1. local-first e offline por padrão;
|
|
46
|
+
2. domínio independente de NestJS, Next.js, transporte e persistência;
|
|
47
|
+
3. contratos versionados, validação na entrada e resultados auditáveis;
|
|
48
|
+
4. determinismo antes de LLM;
|
|
49
|
+
5. autonomia supervisionada por padrão;
|
|
50
|
+
6. contexto mínimo suficiente e orçamento explícito;
|
|
51
|
+
7. migração 1.x aditiva e não destrutiva;
|
|
52
|
+
8. evidência separada de afirmação e hipótese.
|
|
53
|
+
|
|
54
|
+
## Fora do escopo da 2.0 inicial
|
|
55
|
+
|
|
56
|
+
Hospedagem multi-tenant, execução remota obrigatória, dependência de um provedor de LLM,
|
|
57
|
+
treinamento de modelos, substituição de Git, IDE própria, sincronização em nuvem obrigatória
|
|
58
|
+
e dashboard como requisito para operar o produto.
|
|
59
|
+
|
|
60
|
+
## Sucesso e métricas
|
|
61
|
+
|
|
62
|
+
O release candidate deve demonstrar: uma IA descobre uma capability sem documentação humana,
|
|
63
|
+
executa uma tarefa supervisionada, pausa/retoma, é bloqueada por política e não conclui sem
|
|
64
|
+
validação. Métricas mínimas: taxa de execuções auditadas, taxa de bloqueios corretos, taxa de
|
|
65
|
+
retomada, tokens por tarefa, cache hit rate, retrabalho, afirmações sem evidência e falhas de
|
|
66
|
+
validator.
|
|
67
|
+
|
|
68
|
+
## Estratégia de entrega
|
|
69
|
+
|
|
70
|
+
A 2.0 será incremental: primeiro contratos e registry; depois runtime controlado, policy,
|
|
71
|
+
sprint/task/handoff, MCP/Nest, GraphLoop/contexto, autonomia, multiagente, dashboard e plugins.
|
|
72
|
+
O ForjaJS 1.x continua sendo a superfície CLI compatível durante a migração.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Handoff — foundation contracts
|
|
2
|
+
|
|
3
|
+
- **from**: architect
|
|
4
|
+
- **to**: worker
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `docs/vision/FORJA-2.0-VISION.md`; `docs/architecture/FORJA-2.0-ARCHITECTURE.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0034-forja-2-core-e-contratos.md`; `memory/90-decisions/0035-forja-2-local-first-e-autonomia.md`; `packages/contracts/src/index.ts`
|
|
7
|
+
- **acceptance**: criar `packages/core` sem imports de framework; registrar capabilities versionadas; rejeitar input inválido antes do handler; retornar `ExecutionResult`; cobrir descoberta, descrição, alias e execução com testes determinísticos.
|
|
8
|
+
- **constraints**: manter TypeScript estrito; não alterar CLI 1.x; não usar `any`; não introduzir SQLite/Nest/MCP; usar apenas contratos existentes ou abrir ADR para mudança.
|
|
9
|
+
- **return**: devolver arquivos alterados, testes, evidências, riscos e próximo handoff em `memory/50-orchestration/handoffs/`.
|
|
10
|
+
|
|
11
|
+
## Resultado da etapa anterior
|
|
12
|
+
|
|
13
|
+
Visão, arquitetura, impacto e contratos foram criados. `npm run types:check` passa e `npm test`
|
|
14
|
+
passa com 196 testes. GraphLoop e memória consolidada 2.0 ainda não existem; atualização fica
|
|
15
|
+
explicitamente pendente da implementação desses módulos.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Handoff — backend Nest adapter
|
|
2
|
+
|
|
3
|
+
- **from**: backend-application-engineer
|
|
4
|
+
- **to**: nest-bootstrap-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/adapter-nest/src/index.ts`; `apps/server/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: fronteira REST/SSE possui correlation IDs, autenticação local, OpenAPI e erros normalizados; `apps/server` compõe módulos oficiais; nenhuma regra crítica vive no frontend/controller.
|
|
8
|
+
- **constraints**: manter core sem NestJS; usar Policy/Registry/MCP como fontes de autorização/execução; REST + SSE inicialmente; não adicionar WebSocket sem requisito; não inventar dados de recursos.
|
|
9
|
+
- **return**: instalar/configurar NestJS oficialmente, criar bootstrap `main`, módulos/controllers/guards/swagger que deleguem ao adapter, health check, autenticação local e teste e2e determinístico.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/adapter-nest.test.js`: passou.
|
|
15
|
+
- `git diff --check`: passou.
|
|
16
|
+
- Dependência NestJS ainda ausente; bootstrap real permanece pendente.
|
|
17
|
+
|
|
18
|
+
## Métricas de tokens
|
|
19
|
+
|
|
20
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
21
|
+
- consumo de LLM: não aplicável; roteamento HTTP, autenticação e OpenAPI foram determinísticos;
|
|
22
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Handoff — context engine
|
|
2
|
+
|
|
3
|
+
- **from**: context-engineer
|
|
4
|
+
- **to**: graph-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0040-forja-2-context-engine-budget-cache.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`; `memory/90-decisions/0017-codegraph-no-harness-gsd.md`
|
|
7
|
+
- **acceptance**: GraphLoop deve persistir nós/arestas/evidências com status e validade; extrair imports, links Markdown, specs, ADRs, commits, diffs, tarefas, handoffs e testes deterministicamente; consultar caminho, impacto, contradições e lacunas; nenhuma aresta sem origem.
|
|
8
|
+
- **constraints**: separar GraphLoop de CodeGraph; não importar NestJS/Next/SQLite no domínio; LLM apenas para relação semiestruturada com confiança/evidência/status; manter Context Engine consumível por porta.
|
|
9
|
+
- **return**: devolver entidades, consultas, extractors, invariantes, testes de consistência e próximo handoff.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- Testes combinados: 7 arquivos passaram.
|
|
15
|
+
- Cenários: seleção por relevância, deduplicação, obsoletos, contraditos, orçamento, cache,
|
|
16
|
+
expansão e ausência de evidência.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Handoff — Control Plane operacional
|
|
2
|
+
|
|
3
|
+
- **from**: control-plane-observability-engineer
|
|
4
|
+
- **to**: runtime-application-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `memory/90-decisions/0050-forja-2-control-plane-application-ports.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: rotas Runtime existem; Control Plane delega operações; Sprint/Task/Handoff/Approvals usam engines reais; observações publicam SSE; ausência de composição falha explicitamente.
|
|
8
|
+
- **constraints**: não usar planner vazio; Runtime só inicia com budget, agent, policy, planner e validator; nenhuma conclusão sem validator; preservar Policy e checkpoints.
|
|
9
|
+
- **return**: compor `RuntimeEngine` com planner determinístico ou request planner explícito, validator independente, checkpoint store SQLite, PolicyEngine e recorder de observações; implementar start/execute/pause/resume/cancel/get no bootstrap.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- 17 arquivos de testes passaram.
|
|
16
|
+
- smoke test Nest/Control Plane: `control-plane-bootstrap-ok true`.
|
|
17
|
+
- `git diff --check`: passou.
|
|
18
|
+
|
|
19
|
+
## Pendência crítica
|
|
20
|
+
|
|
21
|
+
Runtime ainda não é habilitado por padrão até existir composição verificável de planner, validator
|
|
22
|
+
e policy. Isso é bloqueio de segurança/validade, não falha de transporte.
|
|
23
|
+
|
|
24
|
+
## Métricas de tokens
|
|
25
|
+
|
|
26
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
27
|
+
- consumo de LLM: não aplicável; composição, rotas e eventos foram determinísticos;
|
|
28
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Handoff — capability registry
|
|
2
|
+
|
|
3
|
+
- **from**: worker
|
|
4
|
+
- **to**: architect
|
|
5
|
+
- **intent**: review
|
|
6
|
+
- **context**: `packages/core/src/index.ts`; `packages/core/package.json`; `test/capability-registry.test.js`; `memory/90-decisions/0036-forja-2-capability-registry.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: registry registra definições versionadas; descobre por id e alias; filtra por permissões; valida entrada antes do handler; aplica Policy; suporta handler síncrono/assíncrono; retorna `ExecutionResult`; não importa framework ou persistência.
|
|
8
|
+
- **constraints**: não alterar CLI 1.x; manter contratos existentes; nenhum `any`; não adicionar dependência de runtime.
|
|
9
|
+
- **return**: revisar tipagem, política de depreciação, semântica de `ALLOW_WITH_LIMITS` e compatibilidade dos adapters antes de abrir a próxima tarefa.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- Testes focados de contracts + registry: passaram.
|
|
15
|
+
- `npm test`: 18 arquivos passaram; 5 arquivos legados falharam por `spawnSync ... EPERM` no ambiente sandbox, sem erro de assertion no núcleo novo.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Handoff — Evaluation Engine e Plugin SDK
|
|
2
|
+
|
|
3
|
+
- **from**: evals-plugin-engineer
|
|
4
|
+
- **to**: dashboard-worker-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/evals/src/index.ts`; `packages/plugin-sdk/src/index.ts`; `packages/contracts/src/index.ts`; ADR-0052; ADR-0053; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: `EvaluationEngine` produz relatório determinístico referenciado por observações; `PluginRegistry` valida manifesto, rejeita duplicidade e nega operações sem permissão; typecheck/build/testes focados passam.
|
|
8
|
+
- **constraints**: não usar LLM para métricas; não dar acesso direto a recursos do host; não tratar metadados de assinatura/migration/dashboard como execução autorizada; preservar contratos versionados.
|
|
9
|
+
- **return**: integrar avaliações e métricas no Control Plane/dashboard, preparar worker/scheduler para avaliação e avançar a validação final.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- `node --import tsx --test test/evals.test.js test/plugin-sdk.test.js`: 2 arquivos, 5 testes, passou.
|
|
16
|
+
- `git diff --check`: pendente nesta unidade.
|
|
17
|
+
|
|
18
|
+
## Métricas de tokens
|
|
19
|
+
|
|
20
|
+
- consumo de LLM: não aplicável; avaliação e autorização são determinísticas;
|
|
21
|
+
- orçamento de execução: não aplicável; unidade sem execução de agente;
|
|
22
|
+
- observações consumidas pelos testes: 3 na avaliação principal.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Handoff — events and scheduler
|
|
2
|
+
|
|
3
|
+
- **from**: worker
|
|
4
|
+
- **to**: context-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Context Engine deve selecionar referências por checksums e orçamento; cachear sem reenviar conteúdo inalterado; consumir memória/GraphLoop por portas; produzir `ContextPackage` auditável; não chamar LLM para busca/diff/imports/SQL.
|
|
8
|
+
- **constraints**: domínio sem NestJS/Next/SQLite; não remover semântica append-only/idempotente; preservar retries/dead-letter; manter CLI 1.x intacta.
|
|
9
|
+
- **return**: devolver implementação, testes de cache/budget, evidências de tokens, riscos e próximo handoff.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node test/events-scheduler.test.js`: 7 testes passaram.
|
|
15
|
+
- Cenários: sequência/idempotência, retry, dead-letter, one-shot, cron, condição, evento,
|
|
16
|
+
cancelamento e concorrência.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Handoff — GraphLoop
|
|
2
|
+
|
|
3
|
+
- **from**: graph-engineer
|
|
4
|
+
- **to**: planner-validator
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/graph/src/index.ts`; `packages/context/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Planner consulta GraphLoop e Context Engine, cria etapas pequenas com dependências, risco, orçamento e critérios objetivos; Validator verifica build, testes, lint, typecheck, escopo, critérios, contradições e segurança básica; resultado tem status e evidências.
|
|
8
|
+
- **constraints**: domínio sem NestJS/Next/SQLite; não atravessar arestas sem evidência; não tratar hipótese como fato; determinismo antes de LLM; manter CodeGraph como adapter/fonte opcional.
|
|
9
|
+
- **return**: devolver Planner/Validator, testes de falsa conclusão e próximo handoff para Sprint/Task/Handoff.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node test/graph.test.js`: 5 testes passaram.
|
|
15
|
+
- Cenários: endpoints/evidências obrigatórios, path, impacto, validade temporal, contradição,
|
|
16
|
+
agenda, sync incremental e imports/links determinísticos.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Handoff — MCP adapter
|
|
2
|
+
|
|
3
|
+
- **from**: mcp-application-engineer
|
|
4
|
+
- **to**: backend-application-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/mcp/src/index.ts`; `packages/core/src/index.ts`; `packages/context/src/index.ts`; `packages/graph/src/index.ts`; `packages/orchestration/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `memory/90-decisions/0046-forja-2-mcp-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: tools e recursos oficiais são descobríveis; chamadas delegam aos engines; inputs inválidos e dependências ausentes geram erros estruturados; identidade e Policy são transportadas; MCP não duplica domínio.
|
|
8
|
+
- **constraints**: sem lógica de negócio no adapter; Registry é a única execução de capability; dados de recursos devem vir de providers; nenhuma ação mutável ignora Policy; manter operação local/offline.
|
|
9
|
+
- **return**: integrar `packages/adapter-nest` e `apps/server` com REST + SSE, OpenAPI, correlation IDs, autenticação local e composição dos adapters sem contaminar o domínio.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/mcp.test.js`: passou.
|
|
15
|
+
- `git diff --check`: passou.
|
|
16
|
+
|
|
17
|
+
## Métricas de tokens
|
|
18
|
+
|
|
19
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
20
|
+
- consumo de LLM: não aplicável; dispatch, validação e normalização foram determinísticos;
|
|
21
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Handoff — Nest bootstrap
|
|
2
|
+
|
|
3
|
+
- **from**: nest-bootstrap-engineer
|
|
4
|
+
- **to**: sdk-control-plane-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `apps/server/src/main.ts`; `apps/server/src/app.module.ts`; `apps/server/src/forja-nest.module.ts`; `packages/adapter-nest/src/index.ts`; `packages/mcp/src/index.ts`; `memory/90-decisions/0047-forja-2-backend-nest-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: NestJS instalado; módulo dinâmico, controller REST/SSE, guard de autenticação local, Swagger e correlation IDs delegam ao adapter; bootstrap compilado inicializa com sucesso.
|
|
8
|
+
- **constraints**: core sem NestJS; controller sem regra de domínio; Policy/Registry/MCP são fontes de autorização e execução; WebSocket não entra; `npm audit fix --force` não foi executado.
|
|
9
|
+
- **return**: implementar `packages/sdk` e interfaces do Control Plane para consumir REST/SSE, descobrir capabilities, iniciar/acompanhar runtime, responder approvals e expor métricas auditáveis.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- smoke test compilado: `nest-bootstrap-ok true`.
|
|
16
|
+
- `node --test test/adapter-nest.test.js`: passou.
|
|
17
|
+
- `git diff --check`: passou.
|
|
18
|
+
|
|
19
|
+
## Riscos
|
|
20
|
+
|
|
21
|
+
- npm reportou duas vulnerabilidades high no conjunto de dependências; a correção automática foi adiada para revisão própria.
|
|
22
|
+
- Testes com decorators devem usar build prévio; o runner Node strip-only não executa decorators TypeScript.
|
|
23
|
+
|
|
24
|
+
## Métricas de tokens
|
|
25
|
+
|
|
26
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
27
|
+
- consumo de LLM: não aplicável; bootstrap, compilação e smoke test foram determinísticos;
|
|
28
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Handoff — Distribuição Next.js inicial
|
|
2
|
+
|
|
3
|
+
- **from**: next-distribution-engineer
|
|
4
|
+
- **to**: control-plane-ui-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `apps/dashboard/app/page.tsx`; `apps/dashboard/app/dashboard-client.tsx`; `apps/dashboard/app/globals.css`; `apps/dashboard/next.config.mjs`; ADR-0055; `apps/dashboard/src/index.ts`
|
|
7
|
+
- **acceptance**: dashboard Next compila em produção, carrega métricas/observações via REST, reage a SSE e não contém regra crítica ou acesso direto à persistência.
|
|
8
|
+
- **constraints**: manter Next em versão corrigida; não autorizar no cliente; não usar `audit fix --force`; preservar boundary do Control Plane.
|
|
9
|
+
- **return**: implementar autenticação local, TanStack Query, ações de aprovação/pausa/cancelamento, áreas de Sprints/Tasks/Agents/GraphLoop e testes de UI/contrato.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run dashboard:build`: passou com Next 15.5.9.
|
|
15
|
+
- `npm test`: pendente após esta unidade.
|
|
16
|
+
- `git diff --check`: pendente após esta unidade.
|
|
17
|
+
|
|
18
|
+
## Métricas de tokens
|
|
19
|
+
|
|
20
|
+
- consumo de LLM: não aplicável;
|
|
21
|
+
- página inicial: métricas e observações carregadas deterministicamente;
|
|
22
|
+
- eventos: atualização por SSE, sem reprocessamento de histórico no cliente.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Handoff — observability e Control Plane
|
|
2
|
+
|
|
3
|
+
- **from**: control-plane-observability-engineer
|
|
4
|
+
- **to**: runtime-application-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/observability/src/index.ts`; `packages/adapter-sqlite/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0049-forja-2-observability-control-plane.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Observations auditáveis são persistidas; métricas por run/agent/task/sprint/capability incluem tokens, custo, duração, outcome e evidência; endpoints de métricas/observações delegam ao Control Plane.
|
|
8
|
+
- **constraints**: sem agregação no controller/dashboard; sem LLM para métricas; preservar append-only/idempotência; não declarar runtime/approvals/Sprint/Task concluídos sem application service real.
|
|
9
|
+
- **return**: integrar Runtime, Policy approvals e Orchestration ao Control Plane, implementar rotas `/api/executions`, `/api/approvals`, `/api/sprints` e `/api/tasks`, publicar observações e eventos SSE.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- testes focados de observabilidade, Nest e SDK passaram.
|
|
16
|
+
- `git diff --check`: passou.
|
|
17
|
+
|
|
18
|
+
## Riscos
|
|
19
|
+
|
|
20
|
+
- npm mantém duas vulnerabilidades high pendentes de revisão.
|
|
21
|
+
- Rotas de runtime, approvals e CRUD ainda são pendência do próximo application service.
|
|
22
|
+
|
|
23
|
+
## Métricas de tokens
|
|
24
|
+
|
|
25
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
26
|
+
- consumo de LLM: não aplicável; registro e agregação foram determinísticos;
|
|
27
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Handoff — orchestration engine
|
|
2
|
+
|
|
3
|
+
- **from**: orchestration-engineer
|
|
4
|
+
- **to**: sandbox-adapter-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/orchestration/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0043-forja-2-orchestration-entities.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Sprint, Task e Handoff usam persistência por porta; dependências e retomada funcionam; conclusões exigem validator aceito; handoff incompleto é rejeitado e compactado; registros do GraphLoop recebem evidências.
|
|
8
|
+
- **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa; não permitir conclusão declarativa do executor; manter contratos versionados e trilha auditável.
|
|
9
|
+
- **return**: implementar `packages/sandbox` e adapters iniciais por portas, com fluxo create → prepare → execute → validate → diff → promote/reject → destroy e testes de isolamento/limpeza.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/orchestration.test.js`: 1 arquivo, 3 cenários, passou.
|
|
15
|
+
- `git diff --check`: passou.
|
|
16
|
+
|
|
17
|
+
## Métricas de tokens
|
|
18
|
+
|
|
19
|
+
- orçamento explícito desta unidade: 150 tokens de entrada e 50 de saída nos fixtures de teste;
|
|
20
|
+
- consumo de LLM: não aplicável; implementação e validação foram determinísticas;
|
|
21
|
+
- cache de contexto: não aplicável nesta unidade.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Handoff — planner and validator
|
|
2
|
+
|
|
3
|
+
- **from**: planner-validator
|
|
4
|
+
- **to**: orchestration-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/planner/src/index.ts`; `packages/validator/src/index.ts`; `packages/contracts/src/index.ts`; `packages/graph/src/index.ts`; `memory/90-decisions/0042-forja-2-planner-validator-independentes.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Sprint, Task e Handoff devem ser entidades persistidas por porta; ter estados, orçamento, critérios, dependências, retomada e compactação; rejeitar handoff incompleto; atualizar GraphLoop com evidência.
|
|
8
|
+
- **constraints**: domínio sem NestJS/Next/SQLite; não usar transcrição completa como handoff; não concluir sprint/task sem Validator; preservar contratos versionados e trilha auditável.
|
|
9
|
+
- **return**: devolver engines, portas de persistência, testes de retomada/compactação/escopo e próximo handoff para Policy/Sandbox ou adapters.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node test/planner-validator.test.js`: 6 testes passaram.
|
|
15
|
+
- Cenários: orçamento dividido, dependências do grafo, checks ausentes, escopo, contradições,
|
|
16
|
+
critérios incompletos, blockers e segurança grave.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Handoff — policy engine
|
|
2
|
+
|
|
3
|
+
- **from**: worker
|
|
4
|
+
- **to**: runtime-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/policy/src/index.ts`; `packages/core/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: runtime deve consumir PolicyDecision; bloquear `DENY`/aprovação; impor limites de tokens, arquivos, tempo, retries e paralelismo; criar estado, checkpoint, pausa e retomada; retornar RuntimeRun auditável.
|
|
8
|
+
- **constraints**: domínio sem NestJS/Next/SQLite; não ignorar `ALLOW_WITH_LIMITS`; nenhuma execução crítica sem Policy Engine; persistência fica atrás de porta; manter CLI 1.x intacta.
|
|
9
|
+
- **return**: devolver estados, invariantes, testes de falha/retomada, evidências e próximo handoff.
|
|
10
|
+
|
|
11
|
+
## Resultado da etapa anterior
|
|
12
|
+
|
|
13
|
+
Policy Engine implementado com default deny, regras determinísticas, limites, aprovação para risco
|
|
14
|
+
crítico e ledger de aprovação em memória. Registry → Policy foi validado por teste de integração.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Handoff — Runtime Control Plane
|
|
2
|
+
|
|
3
|
+
- **from**: runtime-application-engineer
|
|
4
|
+
- **to**: evals-plugin-dashboard-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `apps/server/src/main.ts`; `packages/runtime/src/index.ts`; `packages/observability/src/index.ts`; `packages/adapter-nest/src/index.ts`; `packages/sdk/src/index.ts`; `memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Runtime start/execute/pause/resume/cancel/get delegado pelo Control Plane; etapas explícitas e budget validados; Policy read-only local; validator independente exige evidência; observações e SSE são publicados.
|
|
8
|
+
- **constraints**: não habilitar escrita sem Policy/approval; não usar planner vazio; não concluir sem validator; manter checkpoint e limites do Runtime; não usar LLM para planejamento determinístico.
|
|
9
|
+
- **return**: implementar Evaluation Engine, Plugin SDK permissionado e dashboard/control plane operacional para métricas, avaliações, custos, runs, approvals e GraphLoop.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- 17 arquivos de testes passaram.
|
|
16
|
+
- smoke `runtime-control-plane-ok completed accepted 2`.
|
|
17
|
+
- `git diff --check`: passou.
|
|
18
|
+
|
|
19
|
+
## Métricas de tokens
|
|
20
|
+
|
|
21
|
+
- orçamento explícito no smoke: 10 tokens de entrada, 0 de saída, 1 token estimado usado;
|
|
22
|
+
- consumo de LLM: não aplicável; planner, validator e Policy foram determinísticos;
|
|
23
|
+
- observações geradas: 2.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Handoff — runtime controlado
|
|
2
|
+
|
|
3
|
+
- **from**: runtime-engineer
|
|
4
|
+
- **to**: architect
|
|
5
|
+
- **intent**: review
|
|
6
|
+
- **context**: `packages/runtime/src/index.ts`; `packages/contracts/src/index.ts`; `packages/core/src/index.ts`; `packages/policy/src/index.ts`; `memory/90-decisions/0038-forja-2-runtime-controlado.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: run tem estado, orçamento, métricas, erros e evidências; planner e validator são portas; Policy é consumida por capability; limites bloqueiam; checkpoint ocorre em boundaries; pausa/retomada/cancelamento funcionam; validator rejeita falsa conclusão.
|
|
8
|
+
- **constraints**: sem NestJS/Next/SQLite; execução inicial sequencial; nenhum bypass de Policy; persistência fica atrás de `CheckpointStore`/`RuntimeMemory`; manter CLI 1.x intacta.
|
|
9
|
+
- **return**: revisar invariantes de transição, persistência dos checkpoints, semântica de aprovação na retomada e seguir para Scheduler/Event Bus.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/runtime.test.js`: 6 testes passaram.
|
|
15
|
+
- Cenários cobertos: sucesso, checkpoint, pausa/retomada, default deny, orçamento, retry e validator rejeitando conclusão.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Handoff — sandbox e adapter Git
|
|
2
|
+
|
|
3
|
+
- **from**: sandbox-adapter-engineer
|
|
4
|
+
- **to**: persistence-adapter-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/sandbox/src/index.ts`; `packages/adapter-git/src/index.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0044-forja-2-sandbox-worktree.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: Sandbox controla ciclo isolado, validação aceita, diff obrigatório, promoção explícita, rejeição e destruição; adapter Git traduz operações por portas e não contém regra de domínio.
|
|
8
|
+
- **constraints**: domínio sem Git/filesystem/subprocessos; promoção e destruição crítica devem ser autorizadas pela camada de Policy; não executar comandos reais nos testes determinísticos; manter auditoria e contratos versionados.
|
|
9
|
+
- **return**: implementar `packages/adapter-sqlite` para persistir contratos, sessões, eventos, checkpoints, sprints, tasks, handoffs e auditoria, com migração não destrutiva e testes de idempotência/retomada.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/sandbox.test.js test/adapter-git.test.js`: 2 arquivos passaram.
|
|
15
|
+
- `git diff --check`: passou.
|
|
16
|
+
|
|
17
|
+
## Métricas de tokens
|
|
18
|
+
|
|
19
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
20
|
+
- consumo de LLM: não aplicável; implementação, parsing e validação foram determinísticos;
|
|
21
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Handoff — SDK e transporte
|
|
2
|
+
|
|
3
|
+
- **from**: sdk-control-plane-engineer
|
|
4
|
+
- **to**: control-plane-observability-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/sdk/src/index.ts`; `packages/adapter-nest/src/index.ts`; `apps/server/src/forja-nest.module.ts`; `packages/contracts/src/index.ts`; `memory/90-decisions/0048-forja-2-sdk-transport.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: SDK consome transporte substituível; capabilities/contexto/grafo/orquestração/runtime/approvals/métricas/eventos possuem métodos tipados; headers e erros são preservados; eventos suportam unsubscribe.
|
|
8
|
+
- **constraints**: sem NestJS/Express no SDK; não considerar rota apenas declarada como implementada; não esconder erros HTTP; manter Policy e execução no núcleo.
|
|
9
|
+
- **return**: implementar Control Plane e Observabilidade: rotas de runtime, approvals, Sprint/Task, métricas por run/agent/task/sprint/capability, auditoria e eventos SSE consumíveis pelo SDK.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- `node --test ... test/sdk.test.js`: 16 arquivos passaram.
|
|
16
|
+
- `git diff --check`: passou.
|
|
17
|
+
|
|
18
|
+
## Riscos
|
|
19
|
+
|
|
20
|
+
- Rotas de runtime, approvals, métricas e criação de Sprint/Task ainda são superfície declarada no SDK e pendem do Control Plane.
|
|
21
|
+
- Vulnerabilidades high reportadas pelo npm permanecem sob revisão separada.
|
|
22
|
+
|
|
23
|
+
## Métricas de tokens
|
|
24
|
+
|
|
25
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
26
|
+
- consumo de LLM: não aplicável; transporte, serialização e erros foram determinísticos;
|
|
27
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Handoff — adapter SQLite
|
|
2
|
+
|
|
3
|
+
- **from**: persistence-adapter-engineer
|
|
4
|
+
- **to**: mcp-application-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `packages/adapter-sqlite/src/index.ts`; `packages/contracts/src/index.ts`; `packages/events/src/index.ts`; `packages/runtime/src/index.ts`; `packages/orchestration/src/index.ts`; `memory/90-decisions/0045-forja-2-sqlite-adapter.md`; `docs/architecture/FORJA-2.0-IMPACT-FOUNDATION.md`
|
|
7
|
+
- **acceptance**: migrações versionadas e idempotentes; persistência de Sprint, Task, Handoff, Sandbox, Checkpoint, Runtime Run, Event e Auditoria; eventos deduplicados por idempotência; retomada recupera checkpoint.
|
|
8
|
+
- **constraints**: domínio sem SQLite/driver; nenhuma migração destrutiva; JSON e SQL confinados ao adapter; manter contratos versionados e resultados auditáveis.
|
|
9
|
+
- **return**: implementar `packages/mcp` como adaptador sobre Capability Registry, Context, GraphLoop e orchestration, com schemas derivados dos contratos, policy aplicada, identidade registrada e erros normalizados.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `node --test test/adapter-sqlite.test.js`: passou.
|
|
15
|
+
- `git diff --check`: passou.
|
|
16
|
+
|
|
17
|
+
## Métricas de tokens
|
|
18
|
+
|
|
19
|
+
- orçamento explícito nos fixtures: 150 tokens de entrada e 50 de saída quando aplicável;
|
|
20
|
+
- consumo de LLM: não aplicável; migração, serialização e idempotência foram determinísticas;
|
|
21
|
+
- cache: não aplicável nesta unidade.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Handoff — Worker e Dashboard boundary
|
|
2
|
+
|
|
3
|
+
- **from**: dashboard-worker-engineer
|
|
4
|
+
- **to**: next-distribution-engineer
|
|
5
|
+
- **intent**: implement
|
|
6
|
+
- **context**: `apps/worker/src/main.ts`; `apps/dashboard/src/index.ts`; `packages/observability/src/index.ts`; `packages/events/src/index.ts`; `packages/scheduler/src/index.ts`; ADR-0054
|
|
7
|
+
- **acceptance**: worker compõe Event Bus/Scheduler/Evaluation; dashboard lê Control Plane e delega ações críticas; nenhuma regra crítica está no view model; testes e build passam.
|
|
8
|
+
- **constraints**: não conectar dashboard diretamente a SQLite; não autorizar no cliente; preservar backend offline e contratos existentes; Next/React deve ser adaptador de distribuição.
|
|
9
|
+
- **return**: ligar a distribuição Next.js/React, TanStack Query, SSE e telas operacionais sobre esse boundary; depois validar release/packaging.
|
|
10
|
+
|
|
11
|
+
## Evidências
|
|
12
|
+
|
|
13
|
+
- `npm run types:check`: passou.
|
|
14
|
+
- `npm run build`: passou.
|
|
15
|
+
- `node --import tsx --test test/dashboard-worker.test.js`: passou.
|
|
16
|
+
- `npm test`: pendente após esta unidade.
|
|
17
|
+
- `git diff --check`: pendente após esta unidade.
|
|
18
|
+
|
|
19
|
+
## Métricas de tokens
|
|
20
|
+
|
|
21
|
+
- consumo de LLM: não aplicável;
|
|
22
|
+
- worker sem execução de agente no teste;
|
|
23
|
+
- dashboard usa somente métricas/observações fornecidas pelo Control Plane.
|