forjajs 2.0.0 → 2.0.2
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 +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 +7 -2
- package/dist/apps/server/src/main.js +65 -16
- package/dist/bin/forja.js +208 -0
- package/dist/lib/core/health.js +2 -1
- package/dist/lib/core/registry.d.ts +7 -0
- package/dist/lib/core/registry.js +7 -0
- package/dist/lib/core/release.d.ts +6 -0
- package/dist/packages/adapter-git/src/index.d.ts +12 -0
- package/dist/packages/adapter-git/src/index.js +45 -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/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/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/docs/2x/CLI-CAPABILITIES.md +35 -0
- package/docs/2x/IMPLEMENTATION-AUDIT.md +132 -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-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-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/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/package.json +12 -13
|
@@ -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,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,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`.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# ADR-0061 — MCP dinâmico sobre o Registry e transporte stdio local
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o adapter MCP possuía ferramentas fixas e executava capabilities quando o
|
|
6
|
+
consumidor fornecia um registry, mas não expunha `describe` nem descoberta dinâmica dos aliases.
|
|
7
|
+
- **Decisão**: manter ferramentas operacionais fixas para recursos do Forja e adicionar uma
|
|
8
|
+
ferramenta derivada para cada capability visível (`forja_capability_<id>`), além de
|
|
9
|
+
`forja_capability_describe`. `forja mcp:start` fornece transporte JSON-RPC local por stdio e
|
|
10
|
+
delega todas as chamadas ao `McpServer`.
|
|
11
|
+
- **Consequências**: clientes podem descobrir o catálogo sem documentação humana e executar pelo
|
|
12
|
+
mesmo registry usado pela CLI. O transporte não conhece handlers nem implementa regras de
|
|
13
|
+
autorização; schemas detalhados permanecem nos validadores do registry.
|
|
14
|
+
- **Alternativas rejeitadas**: lista manual de cada capability; handler MCP duplicado; servidor
|
|
15
|
+
remoto obrigatório nesta etapa.
|
|
16
|
+
- **Evidência**: `packages/mcp/src/index.ts`, `bin/forja.ts`, `test/mcp.test.js` e o smoke stdio.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# ADR-0062 — Catálogo oficial compartilhado e persistência de approvals/auditoria
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o server criava `CapabilityRegistry` vazio e approvals/auditoria MCP ficavam em
|
|
6
|
+
memória ou sem sink persistente.
|
|
7
|
+
- **Decisão**: o server constrói o catálogo usando `registerCliCapabilities` e o runner legado
|
|
8
|
+
compartilhado. `ApprovalLedger` recebe a porta `ApprovalStore`, implementada pelo SQLite. MCP
|
|
9
|
+
recebe `McpAuditSink`, adaptado para `SqliteAuditStore`; falha de auditoria não interrompe a
|
|
10
|
+
operação, mas é responsabilidade do sink expor saúde própria.
|
|
11
|
+
- **Consequências**: CLI e server descobrem os mesmos IDs e compartilham handlers; approvals
|
|
12
|
+
sobrevivem a reinício; chamadas MCP deixam trilha persistente. O catálogo ainda é composto em
|
|
13
|
+
memória no boot, enquanto persistência de definições fica adiada.
|
|
14
|
+
- **Alternativas rejeitadas**: catálogo manual separado no server; ledger de approvals duplicado;
|
|
15
|
+
auditoria somente em memória.
|
|
16
|
+
- **Evidência**: `apps/server/src/main.ts`, `packages/policy/src/index.ts`,
|
|
17
|
+
`packages/adapter-sqlite/src/index.ts` e testes Sprint 5.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# ADR-0063 — Event Bus SQLite e prova E2E determinística
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Event Bus tinha append, retries e idempotência apenas em memória;
|
|
6
|
+
o server publicava eventos somente no stream SSE e não havia uma prova integrada
|
|
7
|
+
do ciclo supervisionado.
|
|
8
|
+
- **Decisão**: o `EventBus` hidrata idempotência e sequências a partir de qualquer
|
|
9
|
+
`EventStore` antes do primeiro append/list. O bootstrap NestJS usa
|
|
10
|
+
`SqliteEventStore` no banco local e encaminha publicações do Control Plane para
|
|
11
|
+
SSE e persistência. A prova operacional usa capability, sandbox e validator
|
|
12
|
+
determinísticos, sem LLM.
|
|
13
|
+
- **Consequências**: eventos de domínio sobrevivem ao reinício e não duplicam por
|
|
14
|
+
idempotency key; a entrega SSE continua local e efêmera; subscriptions e dead
|
|
15
|
+
letters ainda não são duráveis entre processos.
|
|
16
|
+
- **Alternativas rejeitadas**: broker externo nesta fase; catálogo paralelo de
|
|
17
|
+
eventos; prova baseada em chamada real de modelo.
|
|
18
|
+
- **Evidência**: `packages/events/src/index.ts`, `apps/server/src/main.ts`,
|
|
19
|
+
`test/events-scheduler.test.js` e `test/autonomy-e2e.test.js`.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# ADR-0064 — GraphLoop com porta de store e SQLite oficial
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o GraphLoop validava evidências, relações e checksums, mas o
|
|
6
|
+
store padrão era composto apenas por `Map`, fazendo nós e arestas desaparecerem
|
|
7
|
+
após reinício.
|
|
8
|
+
- **Decisão**: o domínio define `GraphStore` síncrono. `InMemoryGraphStore`
|
|
9
|
+
permanece para testes e `SqliteGraphStore` implementa a distribuição oficial.
|
|
10
|
+
A migração v4 cria tabelas dedicadas para nós, arestas, evidências, fontes e
|
|
11
|
+
futuras claims/contradições/agenda/extractions. O server compartilha a mesma
|
|
12
|
+
instância persistente entre MCP e Runtime.
|
|
13
|
+
- **Consequências**: consultas e sincronização incremental sobrevivem a reinício;
|
|
14
|
+
a política de “toda aresta tem endpoints e evidência” continua no core. O
|
|
15
|
+
schema das entidades futuras existe, mas seus engines ainda não persistem
|
|
16
|
+
automaticamente.
|
|
17
|
+
- **Alternativas rejeitadas**: importar SQLite no domínio; substituir a API por
|
|
18
|
+
operações assíncronas nesta fase; manter o server em memória.
|
|
19
|
+
- **Evidência**: `packages/graph/src/index.ts`, `packages/adapter-sqlite/src/index.ts`,
|
|
20
|
+
`apps/server/src/main.ts` e testes da Sprint 7.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# ADR-0065 — GraphLoop como fonte determinística do Context Engine
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o Context Engine tinha uma porta genérica de fontes, mas o
|
|
6
|
+
server não a compunha com o GraphLoop persistente; o cache padrão era apenas
|
|
7
|
+
em memória.
|
|
8
|
+
- **Decisão**: `GraphContextSource` adapta uma porta `searchContext` e o
|
|
9
|
+
GraphLoop retorna relações ativas que tenham evidência e coincidam
|
|
10
|
+
deterministicamente com termos do objetivo. `SqliteContextCache` persiste o
|
|
11
|
+
conteúdo por checksum. O bootstrap compartilha o banco entre GraphLoop,
|
|
12
|
+
Context Engine, MCP e Runtime.
|
|
13
|
+
- **Consequências**: contexto mínimo pode ser recuperado offline, com referências
|
|
14
|
+
auditáveis, cache e orçamento. A busca é lexical e compacta; embeddings,
|
|
15
|
+
trechos de arquivos e sumarização ficam para fases posteriores.
|
|
16
|
+
- **Alternativas rejeitadas**: chamar LLM para busca; importar SQLite no pacote
|
|
17
|
+
context; duplicar uma busca de grafo dentro do MCP.
|
|
18
|
+
- **Evidência**: `packages/context/src/index.ts`, `packages/graph/src/index.ts`,
|
|
19
|
+
`packages/adapter-sqlite/src/index.ts`, `apps/server/src/main.ts` e testes da
|
|
20
|
+
Sprint 8.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# ADR-0066 — Extração determinística incremental do GraphLoop
|
|
2
|
+
|
|
3
|
+
- **Status**: accepted
|
|
4
|
+
- **Data**: 2026-08-01
|
|
5
|
+
- **Contexto**: o extractor inicial cobria somente imports e links Markdown,
|
|
6
|
+
deixando specs, ADRs, tarefas, handoffs, testes e manifests fora do grafo.
|
|
7
|
+
- **Decisão**: ampliar o extractor por padrões explícitos e auditáveis: símbolos,
|
|
8
|
+
chamadas, referências ADR, checkboxes, agentes de handoff, testes e dependências
|
|
9
|
+
de manifest. Cada relação usa uma evidência com locator de linha e é aplicada
|
|
10
|
+
pela mesma mutation com checksum.
|
|
11
|
+
- **Consequências**: consultas de impacto e contexto ganham relações offline sem
|
|
12
|
+
custo de LLM. A resolução semântica completa de TypeScript, aliases, commits e
|
|
13
|
+
diffs permanece fora do extractor lexical.
|
|
14
|
+
- **Alternativas rejeitadas**: inferência por LLM para relações determinísticas;
|
|
15
|
+
parser completo obrigatório nesta etapa; aceitar arestas sem evidência.
|
|
16
|
+
- **Evidência**: `packages/graph/src/index.ts` e `test/graph.test.js`.
|