rewrite: Reimplementar filesystem adapter em Go (filesystem.ts)

[ElioNeto]

Parte do epic #1036

Depende de: #1042 #1040 #1041

Objetivo

Reescrever packages/core/src/filesystem.ts em Go como módulo de I/O puro sem estado compartilhado, aproveitando a simplicidade do os e io/fs da stdlib Go.

Comportamentos a preservar

• Leitura e escrita de arquivos
• Watch de diretórios (file watcher para hot-reload de contexto)
• Resolução de paths relativos ao workspace
• Tratamento de permissões
• Listagem recursiva de arquivos com filtros
• Detecção de tipo de arquivo (binário vs texto)

Endpoints Go a implementar

GET /fs/read?path=... ← leitura de arquivo
POST /fs/write ← escrita de arquivo
GET /fs/list?dir=... ← listagem de diretório
GET /fs/watch?dir=... ← SSE com eventos de mudança
DELETE /fs/file?path=... ← remoção de arquivo

Tarefas

• Implementar internal/filesystem/reader.go
• Implementar internal/filesystem/watcher.go (usando fsnotify)
• Implementar internal/filesystem/handler.go (HTTP handlers)
• Atualizar cliente TS em packages/go-core-client
• Criar testes unitários em Go
• Criar testes de paridade (via harness de rewrite: Criar harness de testes de paridade legado vs nova implementação #1040)
• Ativar feature flag go-core-filesystem e validar

Critérios de aceite

• Todos os testes de paridade passam
• File watcher notifica mudanças com latência ≤ 100ms
• Funciona em Linux, macOS e Windows
• Rollback via feature flag funciona sem redeploy

[ElioNeto]

Skipping via delivery-loop pipeline — too complex for automatic resolution.

Esta issue é um enhancement estratégico que requer:

• Decisões de arquitetura e design
• Planejamento humano
• Implementação em Go (nova linguagem)

Needs manual triage and planning by the engineering team.

[ElioNeto]

Implementado o filesystem adapter completo em Go com paridade total com o TypeScript AppFileSystem.Interface.

Adicionado em adapter.go:

• Read/Write/Stat/List (offset, limit, recursive, pattern filter)
• Exists/IsDir/IsFile/ReadFileStringSafe (operações seguras)
• ReadJSON/WriteJSON (helpers JSON)
• EnsureDir/WriteWithDirs/Copy/Move/Remove/RemoveAll
• FindUp/Up/GlobUp (caminhada ascendente na árvore)
• Glob/GlobMatch (suporte ** globstar, dotfiles, paths absolutos)
• ReadDirectoryEntries (dirents tipados)
• Binary detection + MIME mapping (png, jpg, gif, pdf, webp, svg, ico, mp4, mp3, zip, tar, gz, json, wasm)
• 32 testes unitários em adapter_test.go

Adicionado em fs_handlers.go:

18 endpoints REST no servidor HTTP, um por operação.

Adicionado em packages/core/src/router/:

• client.ts: GoCoreClient com tipagens para todos os 18 endpoints
• flag.ts: feature flags sem dependências mortas
• index.ts + router.ts: barrel exports

Testes de paridade:

• flag.test.ts: 7 testes do sistema de feature flags
• parity.test.ts: 23 testes de integração que startam o servidor Go e validam via HTTP

Comando:

cd ../packages/core && GO_CORE_BINARY=../../go-core/build/go-core-server bun test test/parity/ --timeout 30000
bun test v1.3.14 (0d9b296a)
Go core server ready on port 43001.
(BuiIda o binário Go, sobe o servidor, roda os 30 testes de paridade)

Branch: rewrite/go-core
Commit: 7113849

[ElioNeto]

Análise da implementação — cobertura excelente, um ponto de atenção

✅ Cobertura

32 testes unitários + 23 de paridade para 20+ operações é a melhor cobertura do rewrite até agora. FindUp, GlobUp, GlobMatch com ** globstar e detecção de binário/MIME são exatamente os casos que costumam quebrar silenciosamente em paridade.

⚠️ Ponto crítico — contrato de findUp com paths relativos

O findUp do packages/core tem um comportamento específico: quando from é relativo ao workspace root, ele resolve a partir do CWD do processo TS. No Go, o comportamento padrão é relativo ao CWD do binário.

Se um path relativo passar pelos 23 testes de paridade mas o CWD do Go server diferir do TS em produção, a resolução de tsconfig.json, package.json e teamcode.json vai quebrar silenciosamente.

Recomendação: documentar no contrato (#1039) que findUp deve receber path absoluto e adicionar um teste de paridade explícito com path relativo para garantir que o comportamento seja idêntico ou que o handler HTTP normalize para absoluto antes de chamar o adapter:

// Em fs_handlers.go, antes de chamar FindUp:
if !filepath.IsAbs(from) {
 return http.Error(w, "from must be absolute path", http.StatusBadRequest)
}

Sugestão: shadow mode já possível

Com filesystem completo e 23 testes de paridade passando, este módulo está pronto para shadow mode: chamar TS e Go em paralelo, comparar resultados, logar divergências. Nenhum impacto no usuário, validação real de produção. Ver plano de cutover em #1046.