forjajs 2.0.1 → 2.0.3
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 +15 -0
- package/README.md +22 -0
- package/README.pt-BR.md +22 -0
- package/dist/apps/cli/src/index.d.ts +44 -0
- package/dist/apps/cli/src/index.js +304 -0
- package/dist/apps/server/src/main.d.ts +9 -3
- package/dist/apps/server/src/main.js +70 -19
- package/dist/bin/forja.js +213 -0
- package/dist/lib/core/health.js +2 -1
- package/dist/lib/core/registry.d.ts +17 -0
- package/dist/lib/core/registry.js +17 -0
- package/dist/lib/core/release.d.ts +16 -0
- package/dist/packages/adapter-git/src/index.d.ts +14 -0
- package/dist/packages/adapter-git/src/index.js +66 -0
- package/dist/packages/adapter-sqlite/src/index.d.ts +59 -2
- package/dist/packages/adapter-sqlite/src/index.js +136 -0
- package/dist/packages/context/src/index.d.ts +8 -0
- package/dist/packages/context/src/index.js +7 -0
- package/dist/packages/contracts/src/index.d.ts +1 -1
- package/dist/packages/events/src/index.d.ts +2 -0
- package/dist/packages/events/src/index.js +16 -0
- package/dist/packages/graph/src/index.d.ts +59 -3
- package/dist/packages/graph/src/index.js +139 -21
- package/dist/packages/mcp/src/index.d.ts +14 -0
- package/dist/packages/mcp/src/index.js +39 -5
- package/dist/packages/plugin-docker/src/index.d.ts +3 -0
- package/dist/packages/plugin-docker/src/index.js +13 -0
- package/dist/packages/plugin-github/src/index.d.ts +3 -0
- package/dist/packages/plugin-github/src/index.js +13 -0
- package/dist/packages/policy/src/index.d.ts +7 -0
- package/dist/packages/policy/src/index.js +17 -1
- package/dist/packages/runtime/src/index.d.ts +20 -1
- package/dist/packages/runtime/src/index.js +34 -1
- package/dist/packages/sandbox/src/index.d.ts +2 -0
- package/dist/packages/sandbox/src/index.js +10 -0
- package/dist/scripts/context-benchmark.d.ts +2 -0
- package/dist/scripts/context-benchmark.js +39 -0
- package/dist/scripts/demo-autonomy.d.ts +15 -0
- package/dist/scripts/demo-autonomy.js +200 -0
- package/dist/scripts/server-persistence-probe.d.mts +1 -0
- package/dist/scripts/server-persistence-probe.d.ts +1 -0
- package/dist/scripts/server-persistence-probe.js +52 -0
- package/dist/scripts/server-persistence-probe.mjs +52 -0
- package/docs/2x/CLI-CAPABILITIES.md +35 -0
- package/docs/2x/IMPLEMENTATION-AUDIT.md +40 -0
- package/docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md +53 -0
- package/docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md +54 -0
- package/docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md +38 -0
- package/docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md +40 -0
- package/docs/2x/SPRINT-13-MCP-STDIO-PLAN.md +26 -0
- package/docs/2x/SPRINT-14-SERVER-RESTART-PLAN.md +28 -0
- package/docs/2x/SPRINT-15-CHAOS-SECURITY-PLAN.md +22 -0
- package/docs/2x/SPRINT-16-LAST-MILE-PLAN.md +25 -0
- package/docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md +39 -0
- package/docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md +42 -0
- package/docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md +35 -0
- package/docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md +31 -0
- package/docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md +55 -0
- package/docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md +60 -0
- package/docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md +64 -0
- package/docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md +51 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-1-cli-capabilities.md +41 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-10-graph-sync.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-11-graph-sync-cli-mcp.md +22 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-12-real-autonomy.md +16 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-2-cli-capabilities.md +30 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-3-runtime-persistence.md +29 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-4-mcp.md +29 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-5-server-approvals-audit.md +22 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-6-events-e2e.md +25 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-7-graphloop.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-8-context-graph.md +23 -0
- package/memory/50-orchestration/handoffs/2026-08-01_sprint-9-extractors.md +21 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-13-mcp-stdio.md +14 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-14-server-restart.md +15 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-15-chaos-security.md +13 -0
- package/memory/50-orchestration/handoffs/2026-08-02_sprint-16-last-mile.md +11 -0
- package/memory/90-decisions/0059-cli-adapter-capability-registry.md +17 -0
- package/memory/90-decisions/0060-runtime-persistence-port.md +17 -0
- package/memory/90-decisions/0061-mcp-dynamic-registry-stdio.md +16 -0
- package/memory/90-decisions/0062-server-catalog-approval-audit.md +17 -0
- package/memory/90-decisions/0063-events-persistent-e2e.md +19 -0
- package/memory/90-decisions/0064-graphloop-sqlite-store.md +20 -0
- package/memory/90-decisions/0065-context-graph-source-cache.md +20 -0
- package/memory/90-decisions/0066-graph-deterministic-extractors.md +16 -0
- package/memory/90-decisions/0067-graph-sync-capability.md +17 -0
- package/memory/90-decisions/0068-graph-sync-cli-mcp.md +17 -0
- package/memory/90-decisions/0069-real-autonomy-demo.md +16 -0
- package/memory/90-decisions/0070-mcp-stdio-real.md +11 -0
- package/memory/90-decisions/0071-server-persistence-composition.md +12 -0
- package/memory/90-decisions/0072-sandbox-security-boundaries.md +9 -0
- package/memory/90-decisions/0073-last-mile-rollback-benchmark-plugins.md +17 -0
- package/package.json +13 -3
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Sprint 6 — Eventos persistentes e prova operacional
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Conectar o Event Bus ao server oficial com log SQLite append-only e comprovar,
|
|
6
|
+
em um cenário determinístico, o fluxo supervisionado approval → sandbox →
|
|
7
|
+
runtime → validator → evento persistido.
|
|
8
|
+
|
|
9
|
+
## Escopo
|
|
10
|
+
|
|
11
|
+
- hidratação do Event Bus a partir do store ao iniciar;
|
|
12
|
+
- idempotência e sequência por aggregate após reinício;
|
|
13
|
+
- persistência de eventos publicados pelo Control Plane no SQLite do workspace;
|
|
14
|
+
- prova E2E sem provedor de LLM, usando capability e sandbox simuladas;
|
|
15
|
+
- teste de aprovação, retomada, validação e registro de `execution.completed`.
|
|
16
|
+
|
|
17
|
+
## Fora do escopo
|
|
18
|
+
|
|
19
|
+
- substituir o stream SSE em memória por broker externo;
|
|
20
|
+
- persistir subscriptions e dead letters entre processos;
|
|
21
|
+
- implementar o backend Git worktree real;
|
|
22
|
+
- integrar GraphLoop SQLite ou dashboard operacional.
|
|
23
|
+
|
|
24
|
+
## Tarefas verificáveis
|
|
25
|
+
|
|
26
|
+
1. Carregar eventos existentes antes de gerar sequência ou aceitar idempotency key.
|
|
27
|
+
2. Instanciar `EventBus(SqliteEventStore)` no bootstrap NestJS.
|
|
28
|
+
3. Encaminhar eventos do Control Plane para SSE e log durável.
|
|
29
|
+
4. Executar a fixture de teste falho com aprovação humana e sandbox isolada.
|
|
30
|
+
5. Validar aceitação independentemente do handler implementador.
|
|
31
|
+
6. Rodar testes, typecheck, build e release gate.
|
|
32
|
+
|
|
33
|
+
## Critérios de aceite
|
|
34
|
+
|
|
35
|
+
- duas instâncias do Event Bus sobre o mesmo SQLite preservam sequência e
|
|
36
|
+
idempotência;
|
|
37
|
+
- server inicializa runtime, approvals, MCP audit e eventos no mesmo banco;
|
|
38
|
+
- a prova E2E termina somente após aprovação e validator `accepted`;
|
|
39
|
+
- a prova registra um evento `execution.completed` persistido;
|
|
40
|
+
- nenhum teste depende de LLM, rede ou estado externo;
|
|
41
|
+
- documentação e ADR registram limites conhecidos.
|
|
42
|
+
|
|
43
|
+
## Evidências esperadas
|
|
44
|
+
|
|
45
|
+
- `test/events-scheduler.test.js`;
|
|
46
|
+
- `test/autonomy-e2e.test.js`;
|
|
47
|
+
- `packages/events/src/index.ts`;
|
|
48
|
+
- `apps/server/src/main.ts`;
|
|
49
|
+
- saída de `npm test`, `tsc --noEmit`, `npm run build` e
|
|
50
|
+
`npm run release:check`.
|
|
51
|
+
|
|
52
|
+
## Próxima dependência
|
|
53
|
+
|
|
54
|
+
A próxima sprint deve persistir o GraphLoop e ligar suas evidências ao mesmo
|
|
55
|
+
fluxo de execução, mantendo o Event Bus como trilha de integração.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Sprint 7 — GraphLoop persistente e evidências de execução
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Substituir o store oficial em memória do GraphLoop por uma porta de domínio com
|
|
6
|
+
adapter SQLite, preservar as invariantes de evidência e checksum e registrar no
|
|
7
|
+
grafo as relações produzidas por execuções do Runtime.
|
|
8
|
+
|
|
9
|
+
## Análise de impacto
|
|
10
|
+
|
|
11
|
+
- `packages/graph`: passa a depender de `GraphStore`, sem conhecer SQLite.
|
|
12
|
+
- `packages/adapter-sqlite`: recebe migração v4 e `SqliteGraphStore`.
|
|
13
|
+
- `apps/server`: compõe MCP e Runtime com o mesmo GraphLoop SQLite.
|
|
14
|
+
- `packages/runtime`: não é alterado conceitualmente; usa a porta existente
|
|
15
|
+
`RuntimeMemory` por meio de um adapter em `packages/graph`.
|
|
16
|
+
- Context Engine permanece consumindo fontes por porta; a seleção semântica
|
|
17
|
+
completa sobre nós e trechos é escopo posterior.
|
|
18
|
+
|
|
19
|
+
## Escopo
|
|
20
|
+
|
|
21
|
+
- nós, arestas, evidências e checksums de origem persistidos;
|
|
22
|
+
- tabelas preparatórias para claims, contradições, agenda e extrações;
|
|
23
|
+
- recuperação após reconstrução do `GraphLoop`;
|
|
24
|
+
- consultas, path e impacto sobre dados SQLite;
|
|
25
|
+
- memória de execução com relação `Execution PRODUCES Capability` auditada.
|
|
26
|
+
|
|
27
|
+
## Fora do escopo
|
|
28
|
+
|
|
29
|
+
- banco externo ou consultas assíncronas;
|
|
30
|
+
- inferência por LLM;
|
|
31
|
+
- detecção avançada de contradições além das regras existentes;
|
|
32
|
+
- indexação automática de todo workspace no bootstrap;
|
|
33
|
+
- dashboard novo.
|
|
34
|
+
|
|
35
|
+
## Critérios de aceite
|
|
36
|
+
|
|
37
|
+
1. Migrações v1–v4 são idempotentes e não destrutivas.
|
|
38
|
+
2. `SqliteGraphStore` satisfaz a porta usada pelo domínio e não importa NestJS.
|
|
39
|
+
3. Nós, evidências, arestas e checksum sobrevivem à recriação do GraphLoop.
|
|
40
|
+
4. A segunda aplicação da mesma fonte é ignorada por checksum.
|
|
41
|
+
5. Nenhuma aresta é salva sem endpoints e evidência existente.
|
|
42
|
+
6. Runtime pode registrar uma execução como relação verificável no grafo.
|
|
43
|
+
7. Server usa o GraphLoop SQLite para MCP e Runtime.
|
|
44
|
+
|
|
45
|
+
## Hipóteses e riscos
|
|
46
|
+
|
|
47
|
+
- A API síncrona atual do GraphLoop é mantida para preservar os consumidores
|
|
48
|
+
existentes e adequar-se ao SQLite local.
|
|
49
|
+
- Tabelas de claims/contradições/agenda/extractions são fundação de schema, não
|
|
50
|
+
significam que seus engines estejam persistentes nesta sprint.
|
|
51
|
+
- A prova de execução registra evidências já produzidas pelo handler; não cria
|
|
52
|
+
evidência artificial para ações sem prova.
|
|
53
|
+
|
|
54
|
+
## Evidências
|
|
55
|
+
|
|
56
|
+
- `packages/graph/src/index.ts`;
|
|
57
|
+
- `packages/adapter-sqlite/src/index.ts`;
|
|
58
|
+
- `apps/server/src/main.ts`;
|
|
59
|
+
- `test/graph.test.js`;
|
|
60
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Sprint 8 — Context Engine sobre GraphLoop
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Usar o GraphLoop persistente como fonte determinística do Context Engine,
|
|
6
|
+
selecionando relações relevantes com evidência, respeitando orçamento e
|
|
7
|
+
reutilizando conteúdo por checksum no SQLite.
|
|
8
|
+
|
|
9
|
+
## Análise de impacto
|
|
10
|
+
|
|
11
|
+
- `packages/graph`: expõe registros de contexto derivados de arestas ativas.
|
|
12
|
+
- `packages/context`: recebe `GraphContextSource`, mantendo a porta
|
|
13
|
+
`ContextSource` e sem depender de SQLite.
|
|
14
|
+
- `packages/adapter-sqlite`: adiciona `SqliteContextCache` e migração v5.
|
|
15
|
+
- `apps/server`: compõe GraphLoop, Context Engine e cache sobre o mesmo banco;
|
|
16
|
+
MCP e Runtime recebem a composição.
|
|
17
|
+
- contratos públicos permanecem inalterados.
|
|
18
|
+
|
|
19
|
+
## Escopo
|
|
20
|
+
|
|
21
|
+
- ranking determinístico por termos do objetivo;
|
|
22
|
+
- exclusão de arestas sem evidência ou fora da validade;
|
|
23
|
+
- referências auditáveis no `ContextPackage`;
|
|
24
|
+
- cache persistente por checksum;
|
|
25
|
+
- aplicação do orçamento existente;
|
|
26
|
+
- expansão de contexto a partir do cache;
|
|
27
|
+
- uso do pacote no bootstrap oficial.
|
|
28
|
+
|
|
29
|
+
## Fora do escopo
|
|
30
|
+
|
|
31
|
+
- embeddings ou busca vetorial;
|
|
32
|
+
- sumarização por LLM;
|
|
33
|
+
- indexação automática do workspace inteiro;
|
|
34
|
+
- alteração de contratos de contexto;
|
|
35
|
+
- compactação de logs ou decisões fora do GraphLoop.
|
|
36
|
+
|
|
37
|
+
## Critérios de aceite
|
|
38
|
+
|
|
39
|
+
1. Context Engine aceita uma fonte GraphLoop por porta, sem importar SQLite.
|
|
40
|
+
2. Apenas relações com evidência e termos relevantes entram como candidatos.
|
|
41
|
+
3. Contexto contradito/obsoleto continua excluído pelo engine.
|
|
42
|
+
4. Cache SQLite preserva conteúdo por checksum.
|
|
43
|
+
5. Orçamento limita seleção e métricas registram tokens/cache.
|
|
44
|
+
6. Server usa GraphLoop, Context Engine e cache no mesmo banco local.
|
|
45
|
+
7. Runtime recebe o pacote de contexto antes do planner sem perder seus passos.
|
|
46
|
+
|
|
47
|
+
## Hipóteses e riscos
|
|
48
|
+
|
|
49
|
+
- A relevância lexical é uma heurística determinística inicial, não uma
|
|
50
|
+
promessa de busca semântica.
|
|
51
|
+
- O conteúdo selecionado é uma relação compacta (`origem TIPO destino`);
|
|
52
|
+
expansão de trechos de arquivos será adicionada quando os extractors fornecerem
|
|
53
|
+
locators e conteúdo segmentado.
|
|
54
|
+
- O runtime mantém `requireEvidence: false` na composição de compatibilidade,
|
|
55
|
+
evitando quebrar tarefas sem relações indexadas; o MCP pode exigir evidência.
|
|
56
|
+
|
|
57
|
+
## Evidências
|
|
58
|
+
|
|
59
|
+
- `packages/context/src/index.ts`;
|
|
60
|
+
- `packages/graph/src/index.ts`;
|
|
61
|
+
- `packages/adapter-sqlite/src/index.ts`;
|
|
62
|
+
- `apps/server/src/main.ts`;
|
|
63
|
+
- `test/context.test.js`;
|
|
64
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Sprint 9 — Extractors determinísticos do GraphLoop
|
|
2
|
+
|
|
3
|
+
## Objetivo
|
|
4
|
+
|
|
5
|
+
Ampliar a indexação incremental do GraphLoop para relações verificáveis em
|
|
6
|
+
fonte, Markdown, specs, ADRs, tarefas, handoffs, testes e manifests, sem LLM.
|
|
7
|
+
|
|
8
|
+
## Análise de impacto
|
|
9
|
+
|
|
10
|
+
- `packages/graph/src/index.ts`: amplia apenas o extractor existente e mantém
|
|
11
|
+
`GraphMutation`, checksum e evidências.
|
|
12
|
+
- contratos não mudam; tipos de entidade e relações já existentes são usados.
|
|
13
|
+
- adapters SQLite não precisam de nova migração: recebem a mesma mutation.
|
|
14
|
+
- consumidores MCP/Context passam a enxergar mais relações após `apply`.
|
|
15
|
+
|
|
16
|
+
## Padrões cobertos
|
|
17
|
+
|
|
18
|
+
| Entrada | Relação | Evidência |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| import/from/import() | `DEPENDS_ON` | linha da declaração |
|
|
21
|
+
| link Markdown | `DERIVED_FROM` | linha do link |
|
|
22
|
+
| export de símbolo | `DEFINES` | linha da declaração |
|
|
23
|
+
| `implements` | `IMPLEMENTS` | linha da declaração |
|
|
24
|
+
| chamada de função | `CALLS` | linha da chamada |
|
|
25
|
+
| `ADR-NNNN` | `DERIVED_FROM` | linha da referência |
|
|
26
|
+
| checkbox Markdown | `CONTAINS` | linha da tarefa |
|
|
27
|
+
| `**to**`/`**next agent**` | `ASSIGNED_TO` | linha do handoff |
|
|
28
|
+
| `describe`/`it`/`test` | `VALIDATES` | linha do teste |
|
|
29
|
+
| dependências do `package.json` | `DEPENDS_ON` | manifest |
|
|
30
|
+
|
|
31
|
+
## Critérios de aceite
|
|
32
|
+
|
|
33
|
+
1. Cada relação gerada possui evidência, origem e checksum da fonte.
|
|
34
|
+
2. Padrões existentes de import/link permanecem compatíveis.
|
|
35
|
+
3. JSON inválido não derruba a indexação; é responsabilidade do validator.
|
|
36
|
+
4. Dependências de manifest são nós `Technology`.
|
|
37
|
+
5. Relações não determinísticas não são inferidas por esta etapa.
|
|
38
|
+
6. Reaplicar a mesma mutation continua idempotente no GraphLoop.
|
|
39
|
+
|
|
40
|
+
## Limites
|
|
41
|
+
|
|
42
|
+
- chamadas são identificadas lexicalmente e podem incluir símbolos locais;
|
|
43
|
+
keywords de controle e wrappers de teste são filtrados.
|
|
44
|
+
- não há resolução completa de escopo, overload ou alias de import.
|
|
45
|
+
- commits e diffs continuam aguardando um extractor Git dedicado.
|
|
46
|
+
|
|
47
|
+
## Evidências
|
|
48
|
+
|
|
49
|
+
- `packages/graph/src/index.ts`;
|
|
50
|
+
- `test/graph.test.js`;
|
|
51
|
+
- suíte de contratos do GraphLoop.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Handoff — Sprint 1: CLI e Capability Registry
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: SDD Architect / Worker
|
|
5
|
+
- **intent**: continuar a migração progressiva dos comandos públicos para o Capability Registry.
|
|
6
|
+
- **context**: a auditoria encontrou dois registries: o declarativo legado em
|
|
7
|
+
`lib/core/registry.ts` e o registry executável em `packages/core`. A ponte foi implementada em
|
|
8
|
+
`apps/cli/src/index.ts` para três comandos de prova.
|
|
9
|
+
- **acceptance**: manter `npm run types:check`, testes da suíte e `tools:doctor` sem falha crítica;
|
|
10
|
+
adicionar a próxima capability com schema, alias, policy, evidência, `ExecutionResult` e teste
|
|
11
|
+
de equivalência antes de alterar o dispatch legado.
|
|
12
|
+
- **constraints**: não integrar MCP, GraphLoop, runtime persistente ou autonomia nesta sprint;
|
|
13
|
+
não duplicar handler; preservar compatibilidade dos comandos não migrados; evitar mudanças
|
|
14
|
+
destrutivas e manter contratos versionados.
|
|
15
|
+
- **return**: entregar mapa atualizado comando→capability, testes determinísticos, documentação,
|
|
16
|
+
ADR se a decisão alterar fronteiras e relatório de auditoria atualizado.
|
|
17
|
+
|
|
18
|
+
## Trabalho concluído
|
|
19
|
+
|
|
20
|
+
- `tools:doctor` → `system.doctor`;
|
|
21
|
+
- `code:impact` → `code.impact`;
|
|
22
|
+
- `context:budget` → `context.budget`;
|
|
23
|
+
- descoberta por `capabilities:list` e `capabilities:describe`;
|
|
24
|
+
- execução por `capability:execute`;
|
|
25
|
+
- validação antes do handler, policy gate, evidência `forja.cli` e normalização de exit code;
|
|
26
|
+
- audit record inclui `capabilityId`, `runId`, `correlationId`, status e duração.
|
|
27
|
+
|
|
28
|
+
## Evidências
|
|
29
|
+
|
|
30
|
+
- `docs/2x/IMPLEMENTATION-AUDIT.md`;
|
|
31
|
+
- `docs/2x/SPRINT-1-CLI-CAPABILITY-PLAN.md`;
|
|
32
|
+
- `docs/2x/CLI-CAPABILITIES.md`;
|
|
33
|
+
- `test/cli-capability-adapter.test.js`;
|
|
34
|
+
- execução real dos três comandos com workspace temporário em 2026-08-01.
|
|
35
|
+
|
|
36
|
+
## Bloqueios e ressalvas
|
|
37
|
+
|
|
38
|
+
- CodeGraph não inicializado no workspace usado na prova; `code:impact` preservou o comportamento
|
|
39
|
+
legado e terminou com saída zero, mas registrou a mensagem diagnóstica no envelope.
|
|
40
|
+
- `tools:doctor` continua reportando apenas avisos conhecidos sobre workspace/memória e ferramentas
|
|
41
|
+
opcionais ausentes; não há falha crítica após a integração.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Handoff — Sprint 10: Graph sync
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Graph / Runtime / Governance
|
|
5
|
+
- **intent**: operar a indexação incremental do GraphLoop sobre workspace Git.
|
|
6
|
+
- **context**: `GitGraphDocumentSource` lista arquivos rastreáveis e indexáveis;
|
|
7
|
+
`GraphIndexer` aplica extractors com checksum; `graph.sync` é capability
|
|
8
|
+
estruturada registrada no server e protegida por permissão de escrita.
|
|
9
|
+
- **acceptance**: manter exclusões de escopo, idempotência, evidência e falha
|
|
10
|
+
aberta para Git inválido; não podar remoções sem evidência de histórico.
|
|
11
|
+
- **constraints**: operação local/offline; limite de 1 MB por arquivo; sem LLM;
|
|
12
|
+
commits e diffs ainda não são indexados.
|
|
13
|
+
- **return**: próxima sprint deve adicionar estado de sincronização/remoção e
|
|
14
|
+
integrar `graph.sync` à CLI/MCP com observabilidade de duração, arquivos e
|
|
15
|
+
contagens.
|
|
16
|
+
|
|
17
|
+
## Evidências
|
|
18
|
+
|
|
19
|
+
- `docs/2x/SPRINT-10-GRAPH-SYNC-PLAN.md`;
|
|
20
|
+
- `memory/90-decisions/0067-graph-sync-capability.md`;
|
|
21
|
+
- `test/adapter-git.test.js`;
|
|
22
|
+
- `test/graph.test.js`;
|
|
23
|
+
- `test/cli-capability-adapter.test.js`.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Handoff — Sprint 11: Graph sync na CLI e MCP
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Graph / MCP / Observability / Governance
|
|
5
|
+
- **intent**: operar e auditar sincronização do GraphLoop nas interfaces locais.
|
|
6
|
+
- **context**: `graph:sync` agora aponta para `graph.sync` no registry; CLI
|
|
7
|
+
standalone e MCP stdio montam GraphLoop SQLite + Git source e usam o mesmo
|
|
8
|
+
registro. Resultado inclui documentos, indexados, ignorados, nós, arestas,
|
|
9
|
+
arquivos e duração.
|
|
10
|
+
- **acceptance**: manter um handler único, policy de escrita, checksum e
|
|
11
|
+
exclusões de escopo; falha de Git não pode virar sucesso vazio.
|
|
12
|
+
- **constraints**: sem poda automática, sem commits/diffs nesta etapa e sem LLM;
|
|
13
|
+
observabilidade de Control Plane detalhada ainda será consolidada.
|
|
14
|
+
- **return**: próxima sprint deve persistir estado de remoção/commit e ligar
|
|
15
|
+
observações de `graph.sync` ao Control Plane.
|
|
16
|
+
|
|
17
|
+
## Evidências
|
|
18
|
+
|
|
19
|
+
- `docs/2x/SPRINT-11-GRAPH-SYNC-CLI-MCP-PLAN.md`;
|
|
20
|
+
- `memory/90-decisions/0068-graph-sync-cli-mcp.md`;
|
|
21
|
+
- `test/cli-capability-adapter.test.js`;
|
|
22
|
+
- smoke real de `capabilities:list --json` e `graph:sync --json`.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Handoff — Sprint 12: autonomia real
|
|
2
|
+
|
|
3
|
+
- **from:** autonomy-integration-engineer
|
|
4
|
+
- **to:** mcp-and-recovery-engineer
|
|
5
|
+
- **intent:** continuar a prova de última milha do ForjaJS 2.x
|
|
6
|
+
- **context:** `scripts/demo-autonomy.ts`, `test/demo-autonomy.test.js`,
|
|
7
|
+
`docs/2x/SPRINT-12-REAL-AUTONOMY-PLAN.md`, ADR-0069
|
|
8
|
+
- **acceptance:** demo cria fixture externa, usa worktree Git real, bloqueia escrita
|
|
9
|
+
até aprovação, edita arquivo, executa npm test, valida, promove diff, persiste
|
|
10
|
+
estado, atualiza GraphLoop e cria handoff
|
|
11
|
+
- **constraints:** sem LLM; sem mocks no caminho principal; escopo limitado ao
|
|
12
|
+
arquivo `tests/math.test.js`; promoção somente após Validator `accepted`
|
|
13
|
+
- **return:** implementar Sprint 13 para transporte MCP stdio real e shutdown limpo;
|
|
14
|
+
depois provar restart do servidor e recuperação de execução/approval/contexto
|
|
15
|
+
- **evidence:** `npm run demo:autonomy` retornou `accepted`, uma alteração promovida,
|
|
16
|
+
18 nós e 14 arestas; teste automatizado repete e limpa a fixture
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Handoff — Sprint 2: capabilities de processo CLI
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: SDD Architect / Worker
|
|
5
|
+
- **intent**: continuar a migração dos comandos públicos para o Capability Registry e preparar a próxima fatia.
|
|
6
|
+
- **context**: as Sprints 1 e 2 conectaram seis comandos ao adapter CLI. O registry valida payload,
|
|
7
|
+
aplica policy e normaliza o envelope antes de delegar aos handlers determinísticos existentes.
|
|
8
|
+
- **acceptance**: preservar os seis aliases migrados, adicionar testes para qualquer novo comando,
|
|
9
|
+
atualizar `IMPLEMENTATION-AUDIT.md` e não iniciar runtime persistente sem plano/ADR próprio.
|
|
10
|
+
- **constraints**: manter os comandos não migrados no fallback legado; não integrar MCP, GraphLoop,
|
|
11
|
+
sandbox ou autonomia nesta etapa; não salvar transcrição em handoff; não usar `any` novo.
|
|
12
|
+
- **return**: próxima sprint deve escolher entre migrar capabilities de contexto/memória ou iniciar
|
|
13
|
+
a persistência do Runtime, após análise de impacto e contratos afetados.
|
|
14
|
+
|
|
15
|
+
## Entregas
|
|
16
|
+
|
|
17
|
+
- `spec:check` → `spec.validate`;
|
|
18
|
+
- `sprint:status` → `sprint.status`;
|
|
19
|
+
- `gsd:handoff` → `handoff.create`;
|
|
20
|
+
- schemas de `feature`, `project`, `phase`, `slug` e `context`;
|
|
21
|
+
- policy explícita para a escrita local de handoff;
|
|
22
|
+
- testes de sucesso, input inválido e equivalência de argumentos.
|
|
23
|
+
|
|
24
|
+
## Evidências
|
|
25
|
+
|
|
26
|
+
- `docs/2x/SPRINT-2-CLI-CAPABILITY-PLAN.md`;
|
|
27
|
+
- `docs/2x/IMPLEMENTATION-AUDIT.md`;
|
|
28
|
+
- `test/cli-capability-adapter.test.js`;
|
|
29
|
+
- `npm run types:check`;
|
|
30
|
+
- execução da suíte completa após a implementação.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Handoff — Sprint 3: Runtime persistente
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Runtime Worker / Governance
|
|
5
|
+
- **intent**: continuar a integração operacional do Runtime sobre estado SQLite durável.
|
|
6
|
+
- **context**: `RuntimeEngine` agora usa a porta `RuntimePersistence`; o adapter SQLite persiste
|
|
7
|
+
runs, planos, resultados e cursor. O bootstrap NestJS oficial aplica migrações e injeta o adapter.
|
|
8
|
+
- **acceptance**: preservar recuperação após reinício, exigir policy ativa na recuperação e manter
|
|
9
|
+
migrações idempotentes. Qualquer mudança de contrato deve incluir ADR, schema e teste de replay.
|
|
10
|
+
- **constraints**: não serializar funções/policies; não acoplar domínio a SQLite; stores em memória
|
|
11
|
+
permanecem para testes; approvals, GraphLoop, sandbox e execução paralela não estão concluídos.
|
|
12
|
+
- **return**: próxima sprint deve integrar persistência de approvals/eventos ou iniciar MCP sobre o
|
|
13
|
+
catálogo compartilhado, após análise de impacto e critérios de recuperação.
|
|
14
|
+
|
|
15
|
+
## Entregas
|
|
16
|
+
|
|
17
|
+
- `RuntimePersistence` no domínio;
|
|
18
|
+
- `SqliteRuntimePersistence` e migração SQLite v2;
|
|
19
|
+
- recuperação de plano, resultados, cursor e policy ativa;
|
|
20
|
+
- server oficial inicializando SQLite no workspace;
|
|
21
|
+
- teste de pausa, fechamento, nova instância e retomada.
|
|
22
|
+
|
|
23
|
+
## Evidências
|
|
24
|
+
|
|
25
|
+
- `docs/2x/SPRINT-3-RUNTIME-PERSISTENCE-PLAN.md`;
|
|
26
|
+
- `memory/90-decisions/0060-runtime-persistence-port.md`;
|
|
27
|
+
- `test/runtime.test.js`;
|
|
28
|
+
- `test/adapter-sqlite.test.js`;
|
|
29
|
+
- `npm run types:check`, `npm test` e `npm run build`.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Handoff — Sprint 4: MCP Registry
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: MCP Adapter / Governance
|
|
5
|
+
- **intent**: continuar a integração do catálogo compartilhado com clientes MCP.
|
|
6
|
+
- **context**: o MCP agora descobre capabilities visíveis no registry, descreve definições e expõe
|
|
7
|
+
transporte local JSON-RPC por stdio via `forja mcp:start`.
|
|
8
|
+
- **acceptance**: manter ferramentas dinâmicas alinhadas ao registry, validar payload no registry,
|
|
9
|
+
preservar identidade/policy e testar clientes que enviam mais de uma mensagem no mesmo chunk.
|
|
10
|
+
- **constraints**: não duplicar handlers; não colocar regra de domínio no transporte; não tratar
|
|
11
|
+
stdio como autenticação remota; GraphLoop persistente e approvals MCP seguem pendentes.
|
|
12
|
+
- **return**: próxima sprint deve integrar catálogo padrão no server/MCP e decidir persistência de
|
|
13
|
+
auditoria MCP, com teste de contrato para SDK/MCP.
|
|
14
|
+
|
|
15
|
+
## Entregas
|
|
16
|
+
|
|
17
|
+
- `forja mcp:start`;
|
|
18
|
+
- `forja_capability_describe`;
|
|
19
|
+
- ferramentas dinâmicas para as seis capabilities migradas;
|
|
20
|
+
- framing por linha e resposta JSON-RPC estruturada;
|
|
21
|
+
- testes MCP atualizados.
|
|
22
|
+
|
|
23
|
+
## Evidências
|
|
24
|
+
|
|
25
|
+
- `docs/2x/SPRINT-4-MCP-REGISTRY-PLAN.md`;
|
|
26
|
+
- `memory/90-decisions/0061-mcp-dynamic-registry-stdio.md`;
|
|
27
|
+
- `test/mcp.test.js`;
|
|
28
|
+
- smoke `tools/list` + `tools/call` executado em workspace temporário;
|
|
29
|
+
- `npm run types:check`.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Handoff — Sprint 5: server, approvals e auditoria MCP
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Runtime / MCP / Governance
|
|
5
|
+
- **intent**: continuar a operação persistente do control plane local-first.
|
|
6
|
+
- **context**: o server oficial agora compõe o mesmo catálogo de seis capabilities da CLI; approvals
|
|
7
|
+
e chamadas MCP são persistidos no SQLite do workspace.
|
|
8
|
+
- **acceptance**: manter migrações v1–v3 idempotentes, testar recuperação de approval e preservar
|
|
9
|
+
falha aberta da auditoria sem ocultar o erro do sink.
|
|
10
|
+
- **constraints**: não criar catálogo manual paralelo; não serializar handlers ou policies; manter
|
|
11
|
+
domínio sem SQLite; GraphLoop persistente e sandbox operacional seguem pendentes.
|
|
12
|
+
- **return**: próxima sprint deve integrar eventos persistentes e/ou iniciar a prova ponta a ponta
|
|
13
|
+
usando server, runtime, approval, sandbox e validator.
|
|
14
|
+
|
|
15
|
+
## Evidências
|
|
16
|
+
|
|
17
|
+
- `docs/2x/SPRINT-5-SERVER-APPROVALS-AUDIT-PLAN.md`;
|
|
18
|
+
- `memory/90-decisions/0062-server-catalog-approval-audit.md`;
|
|
19
|
+
- `test/policy.test.js`;
|
|
20
|
+
- `test/adapter-sqlite.test.js`;
|
|
21
|
+
- `test/mcp.test.js`;
|
|
22
|
+
- `npm test`, `npm run build` e `npm run release:check`.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Handoff — Sprint 6: eventos persistentes e prova E2E
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: GraphLoop / Runtime / Governance
|
|
5
|
+
- **intent**: continuar a integração operacional do ForjaJS 2.x sobre trilha de
|
|
6
|
+
eventos durável.
|
|
7
|
+
- **context**: o Event Bus agora hidrata estado do `EventStore`, preserva
|
|
8
|
+
idempotência e sequência por aggregate em SQLite, e o server registra eventos
|
|
9
|
+
do Control Plane no mesmo banco local. A prova determinística cobre aprovação,
|
|
10
|
+
sandbox, runtime, validator e `execution.completed`.
|
|
11
|
+
- **acceptance**: preservar o contrato do Event Bus, manter migrações idempotentes,
|
|
12
|
+
exigir validator aceito antes de `completed` e manter a prova sem rede/LLM.
|
|
13
|
+
- **constraints**: SSE continua efêmero; não declarar persistência de subscriptions
|
|
14
|
+
ou dead letters; não chamar o GraphLoop persistente de concluído.
|
|
15
|
+
- **return**: próxima sprint deve integrar GraphLoop SQLite, evidências e consultas
|
|
16
|
+
de impacto ao contexto/runtime.
|
|
17
|
+
|
|
18
|
+
## Evidências
|
|
19
|
+
|
|
20
|
+
- `docs/2x/SPRINT-6-EVENTS-E2E-PLAN.md`;
|
|
21
|
+
- `memory/90-decisions/0063-events-persistent-e2e.md`;
|
|
22
|
+
- `test/events-scheduler.test.js`;
|
|
23
|
+
- `test/autonomy-e2e.test.js`;
|
|
24
|
+
- `packages/events/src/index.ts`;
|
|
25
|
+
- `apps/server/src/main.ts`.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Handoff — Sprint 7: GraphLoop persistente
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Context / Runtime / Governance
|
|
5
|
+
- **intent**: continuar a integração do grafo verificável com o fluxo operacional.
|
|
6
|
+
- **context**: `GraphStore` foi extraído como porta do domínio; SQLite v4 persiste
|
|
7
|
+
nós, arestas, evidências e checksums. O server compõe MCP e Runtime sobre o
|
|
8
|
+
mesmo GraphLoop. Resultados de execução com evidência geram `Execution
|
|
9
|
+
PRODUCES Capability`.
|
|
10
|
+
- **acceptance**: manter as invariantes de endpoints, evidência, validade temporal
|
|
11
|
+
e checksum; preservar migração não destrutiva; não declarar persistidos os
|
|
12
|
+
engines de contradição/agenda ainda não ligados ao schema.
|
|
13
|
+
- **constraints**: GraphLoop não importa SQLite/NestJS; não usar LLM para as
|
|
14
|
+
relações determinísticas; não criar evidência artificial.
|
|
15
|
+
- **return**: próxima sprint deve ligar Context Engine ao GraphLoop persistente,
|
|
16
|
+
incluindo seleção por relevância, referências de evidência e orçamento.
|
|
17
|
+
|
|
18
|
+
## Evidências
|
|
19
|
+
|
|
20
|
+
- `docs/2x/SPRINT-7-GRAPHLOOP-PERSISTENCE-PLAN.md`;
|
|
21
|
+
- `memory/90-decisions/0064-graphloop-sqlite-store.md`;
|
|
22
|
+
- `test/graph.test.js`;
|
|
23
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Handoff — Sprint 8: Context Engine e GraphLoop
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Runtime / Context / Governance
|
|
5
|
+
- **intent**: continuar a redução de contexto com fontes persistentes e evidência.
|
|
6
|
+
- **context**: GraphLoop expõe registros de relações relevantes; `GraphContextSource`
|
|
7
|
+
os adapta ao Context Engine; `SqliteContextCache` persiste checksums; server
|
|
8
|
+
compõe tudo no banco local e entrega o pacote ao planner do Runtime.
|
|
9
|
+
- **acceptance**: preservar referências, orçamento, cache e exclusão de conteúdo
|
|
10
|
+
contradito/obsoleto; não usar LLM para ranking lexical; manter compatibilidade
|
|
11
|
+
com fontes de memória existentes.
|
|
12
|
+
- **constraints**: conteúdo atual é relação compacta, não trecho integral de
|
|
13
|
+
arquivo; `requireEvidence: false` é apenas a política de compatibilidade do
|
|
14
|
+
runtime server; MCP e clientes podem exigir evidência.
|
|
15
|
+
- **return**: próxima sprint deve conectar extractors de arquivos/specs e medir
|
|
16
|
+
`context unused`, repetição e cobertura de evidência em runs reais.
|
|
17
|
+
|
|
18
|
+
## Evidências
|
|
19
|
+
|
|
20
|
+
- `docs/2x/SPRINT-8-CONTEXT-GRAPH-PLAN.md`;
|
|
21
|
+
- `memory/90-decisions/0065-context-graph-source-cache.md`;
|
|
22
|
+
- `test/context.test.js`;
|
|
23
|
+
- `test/adapter-sqlite.test.js`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Handoff — Sprint 9: extractors determinísticos
|
|
2
|
+
|
|
3
|
+
- **from**: Orchestrator
|
|
4
|
+
- **to**: Graph / Context / Governance
|
|
5
|
+
- **intent**: continuar a indexação verificável de fontes do projeto.
|
|
6
|
+
- **context**: o extractor GraphLoop agora cobre imports, links, exports,
|
|
7
|
+
chamadas, `implements`, ADRs, tarefas Markdown, agentes de handoff, testes e
|
|
8
|
+
dependências de manifests, sempre com evidência e checksum.
|
|
9
|
+
- **acceptance**: preservar idempotência, não criar arestas sem evidência e não
|
|
10
|
+
tratar JSON inválido como sucesso de validação.
|
|
11
|
+
- **constraints**: extração é lexical/determinística; resolução completa de
|
|
12
|
+
símbolos, commits e diffs não está incluída; nenhuma chamada de LLM.
|
|
13
|
+
- **return**: próxima sprint deve integrar indexação de workspace/Git e expor
|
|
14
|
+
atualização incremental por capability, mantendo o Context Engine limitado ao
|
|
15
|
+
contexto necessário.
|
|
16
|
+
|
|
17
|
+
## Evidências
|
|
18
|
+
|
|
19
|
+
- `docs/2x/SPRINT-9-DETERMINISTIC-EXTRACTORS-PLAN.md`;
|
|
20
|
+
- `memory/90-decisions/0066-graph-deterministic-extractors.md`;
|
|
21
|
+
- `test/graph.test.js`.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Handoff — Sprint 13: MCP stdio real
|
|
2
|
+
|
|
3
|
+
- **from:** autonomy-integration-engineer
|
|
4
|
+
- **to:** persistence-chaos-engineer
|
|
5
|
+
- **intent:** continuar a prova de última milha do ForjaJS 2.x
|
|
6
|
+
- **context:** `bin/forja.ts`, `test/mcp-stdio.test.js`, Sprint 13, ADR-0070
|
|
7
|
+
- **acceptance:** cliente filho inicia MCP real, negocia initialize, lista tools,
|
|
8
|
+
descreve e executa capability, lê resource e encerra por EOF sem ruído em stdout
|
|
9
|
+
- **constraints:** stdio newline-delimited JSON-RPC; notificações não recebem resposta;
|
|
10
|
+
nenhuma regra de negócio nova no transporte
|
|
11
|
+
- **return:** provar restart abrupto do servidor e retomada de runtime/approval/contexto
|
|
12
|
+
com SQLite; adicionar casos de desconexão e payload inválido
|
|
13
|
+
- **evidence:** teste de processo real aprovado; stdout parseável; stderr vazio;
|
|
14
|
+
shutdown exit code 0
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Handoff — Sprint 14: persistência oficial e restart
|
|
2
|
+
|
|
3
|
+
- **from:** persistence-composition-engineer
|
|
4
|
+
- **to:** chaos-and-security-engineer
|
|
5
|
+
- **intent:** continuar o fechamento 10/10 com falhas e recuperação
|
|
6
|
+
- **context:** `apps/server/src/main.ts`, `test/server-persistence.test.js`, Sprint 14,
|
|
7
|
+
ADR-0071
|
|
8
|
+
- **acceptance:** duas composições oficiais compartilham SQLite; runtime e approval
|
|
9
|
+
pendente são recuperados; contexto, grafo, eventos e observações permanecem
|
|
10
|
+
- **constraints:** stores em memória apenas para testes; adapter SQLite permanece fora
|
|
11
|
+
do domínio; probe executa com loader Nest real
|
|
12
|
+
- **return:** adicionar processo morto, approval expirada, SQLite bloqueado,
|
|
13
|
+
checkpoint corrompido, timeout e payload malicioso; registrar rollback e recuperação
|
|
14
|
+
- **evidence:** probe passou com run `awaiting_approval`, approval 1, contexto
|
|
15
|
+
preservado, grafo 1 nó, eventos e observações persistidos
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Handoff — Sprint 15: caos e segurança
|
|
2
|
+
|
|
3
|
+
- **from:** chaos-and-security-engineer
|
|
4
|
+
- **to:** release-hardening-engineer
|
|
5
|
+
- **intent:** fechar os casos de falha restantes antes do próximo release
|
|
6
|
+
- **context:** adapter Git, policy, SQLite, MCP stdio, Sprint 15, ADR-0072
|
|
7
|
+
- **acceptance:** approval expirada, payload corrompido, deny-by-default,
|
|
8
|
+
path traversal e herança de secrets têm comportamento determinístico e testado
|
|
9
|
+
- **constraints:** sem mascarar corrupção; sem secrets no ambiente padrão do sandbox;
|
|
10
|
+
nenhuma leitura fora da raiz; alterações críticas continuam sob Policy Engine
|
|
11
|
+
- **return:** implementar SQLite lock/timeout, processo morto no meio do step,
|
|
12
|
+
checkpoint rollback, fuzz MCP, plugins maliciosos e threat model formal
|
|
13
|
+
- **evidence:** testes de chaos/security e 291+ testes de integração existentes
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Handoff — Sprint 16: última milha
|
|
2
|
+
|
|
3
|
+
- objetivo: fechar lacunas verificáveis para a avaliação 10/10;
|
|
4
|
+
- concluído: rollback explícito de sandbox; reversão Git por patch binário; benchmark JSON determinístico; manifests oficiais GitHub/Docker; testes de isolamento;
|
|
5
|
+
- decisões: `promoted → rolled_back` é terminal; plugins oficiais são boundaries sem rede implícita; benchmark usa checksum e proxy bytes/4;
|
|
6
|
+
- restrições: rollback exige diff da mesma sessão; handlers externos dependem de adapters permissionados;
|
|
7
|
+
- evidências: testes `sandbox`, `adapter-git`, `context-benchmark`, `official-plugins`; `npm test` 300/300; build TypeScript aprovado; benchmark mediu 95,72% de redução nesta árvore;
|
|
8
|
+
- pendências: executar `release:check --publish` em árvore limpa e decidir publicação 2.0.3; integrar handlers externos reais apenas com credenciais e sandbox apropriadas;
|
|
9
|
+
- critérios de aceite: todos os testes e build aprovados;
|
|
10
|
+
- bloqueios: nenhum bloqueio técnico nesta sprint;
|
|
11
|
+
- próximo agente: Governance/Release Auditor.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0059 — CLI como adaptador transitório do Capability Registry
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Forja possuía o registry declarativo de comandos em `lib/core/registry.ts` e o
|
|
6
|
+
`CapabilityRegistry` executável em `packages/core`, sem uma ponte operacional entre ambos.
|
|
7
|
+
- **Decisão**: migrar comandos por fatias para `apps/cli/src/index.ts`. Cada capability declara
|
|
8
|
+
contrato, validação, política, alias legado e handler injetado. O binário da CLI somente adapta
|
|
9
|
+
argumentos, invoca o registry e registra o resultado; comandos não migrados preservam o dispatch
|
|
10
|
+
declarativo durante a transição.
|
|
11
|
+
- **Consequências**: CLI, descoberta e execução passam a compartilhar `ExecutionResult`, validação
|
|
12
|
+
e autorização nos comandos migrados. A auditoria JSONL permanece no core executivo até o
|
|
13
|
+
armazenamento de auditoria persistente ser integrado em sprint posterior.
|
|
14
|
+
- **Fora desta decisão**: persistência do runtime, MCP nativo, GraphLoop, sandbox e migração dos
|
|
15
|
+
demais comandos.
|
|
16
|
+
- **Evidência**: `docs/2x/IMPLEMENTATION-AUDIT.md`, `apps/cli/src/index.ts` e
|
|
17
|
+
`test/cli-capability-adapter.test.js`.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0060 — Persistência do Runtime por porta e recuperação explícita
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: `RuntimeEngine` mantinha runs, planos, resultados e cursor em `Map`s. Checkpoints
|
|
6
|
+
SQLite já existiam, mas não eram suficientes para recriar o engine após reinício.
|
|
7
|
+
- **Decisão**: o domínio expõe `RuntimePersistence` com operações para run, plano, resultados e
|
|
8
|
+
cursor. `SqliteRuntimePersistence` implementa a porta usando migração versionada e payloads JSON
|
|
9
|
+
em tabelas próprias. A recuperação recebe a policy ativa explicitamente; funções e dependências
|
|
10
|
+
executáveis nunca são serializadas.
|
|
11
|
+
- **Consequências**: uma nova instância pode recuperar uma execução pausada e continuar do cursor
|
|
12
|
+
persistido. O Runtime permanece independente de SQLite. A persistência síncrona é adequada para
|
|
13
|
+
o backend local-first inicial e a porta permite adapter assíncrono futuro.
|
|
14
|
+
- **Alternativas rejeitadas**: serializar policy/handlers; depender apenas de checkpoints; acoplar
|
|
15
|
+
`packages/runtime` ao driver SQLite.
|
|
16
|
+
- **Evidência**: `packages/runtime/src/index.ts`, `packages/adapter-sqlite/src/index.ts` e
|
|
17
|
+
`test/runtime.test.js`.
|