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.
Files changed (126) hide show
  1. package/CHANGELOG.md +49 -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 +26 -4
  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/0033-doctor-distingue-permissao-de-corrupcao.md +64 -0
  100. package/memory/90-decisions/0034-forja-2-core-e-contratos.md +29 -0
  101. package/memory/90-decisions/0035-forja-2-local-first-e-autonomia.md +23 -0
  102. package/memory/90-decisions/0036-forja-2-capability-registry.md +30 -0
  103. package/memory/90-decisions/0037-forja-2-policy-engine-obrigatorio.md +28 -0
  104. package/memory/90-decisions/0038-forja-2-runtime-controlado.md +28 -0
  105. package/memory/90-decisions/0039-forja-2-event-bus-scheduler-local-first.md +31 -0
  106. package/memory/90-decisions/0040-forja-2-context-engine-budget-cache.md +32 -0
  107. package/memory/90-decisions/0041-forja-2-graphloop-separado-codegraph.md +32 -0
  108. package/memory/90-decisions/0042-forja-2-planner-validator-independentes.md +29 -0
  109. package/memory/90-decisions/0043-forja-2-orchestration-entities.md +16 -0
  110. package/memory/90-decisions/0044-forja-2-sandbox-worktree.md +19 -0
  111. package/memory/90-decisions/0045-forja-2-sqlite-adapter.md +19 -0
  112. package/memory/90-decisions/0046-forja-2-mcp-adapter.md +18 -0
  113. package/memory/90-decisions/0047-forja-2-backend-nest-adapter.md +19 -0
  114. package/memory/90-decisions/0048-forja-2-sdk-transport.md +18 -0
  115. package/memory/90-decisions/0049-forja-2-observability-control-plane.md +18 -0
  116. package/memory/90-decisions/0050-forja-2-control-plane-application-ports.md +18 -0
  117. package/memory/90-decisions/0051-forja-2-runtime-control-plane-composition.md +18 -0
  118. package/memory/90-decisions/0052-forja-2-deterministic-evaluation.md +15 -0
  119. package/memory/90-decisions/0053-forja-2-plugin-sdk-permissionado.md +16 -0
  120. package/memory/90-decisions/0054-forja-2-worker-dashboard-boundary.md +15 -0
  121. package/memory/90-decisions/0055-forja-2-next-dashboard-distribution.md +16 -0
  122. package/memory/90-decisions/0056-forja-2-dashboard-proxy-auth-query.md +16 -0
  123. package/memory/90-decisions/0057-forja-2-graphloop-approvals-dashboard.md +15 -0
  124. package/memory/90-decisions/0058-forja-2-approval-server-identity.md +15 -0
  125. package/package.json +28 -3
  126. 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.