fix: instalação no Windows não morre mais nos symlinks do harness

[elberrd]

Problema

Teste real no Windows (log do Elber, 16/ago): o passo Harness abortava com "The downloaded harness file arrived corrupted" — e repetir nunca resolvia. O tarball estava íntegro; o que falhava era o tar.exe do Windows (bsdtar) com Can't create '…': Invalid argument em exatamente 55 entradas: os espelhos symlink do harness (.agents/agents/*, .agents/commands/*, .agents/skills/*, .cursor/agents/* → .claude/ e .cursor/).

Causa: o tarball do GitHub preserva symlinks, e o Windows só cria symlink com privilégio (shell admin ou Developer Mode) — que aluno típico não tem. Sem este fix, a instalação no Windows está quebrada para praticamente todo aluno.

Investigação das outras superfícies

Superfície	Situação
fetchTemplateToDir (harness, live1/live2, re-download do imp fix)	ponto único — corrigido aqui
imp fix restore de link: do manifest	mesmo buraco (symlink() → EPERM) — corrigido aqui
Skills CLI (vercel-labs/skills)	auditado: já é seguro (junction no win32 + cópia quando o link falha) — sem mudança
fia-templates/pi-templates (stamp local)	zero symlinks — sem risco
merge do harness (cp verbatimSymlinks)	copia o que o clone tiver (cópias no Windows, links onde o OS permite) — sem mudança

Correção

• src/lib/tar-extract.js (novo): extrator .tar.gz em JS puro (formato pax do git archive, zero dependência nova). Tenta symlink real; na primeira recusa materializa todos os links como cópia do alvo resolvido — confinado ao destino, com passes para cadeias de link, suporte a pax x/g, GNU L/K, hardlink e rejeição de path traversal.
• template-fetch.js: tenta o tar do sistema primeiro (rápido, preserva links onde o OS deixa); se faltar ou falhar, limpa o destino e re-extrai com o extrator próprio. tar_missing deixou de existir (não é mais beco sem saída) e extract_failed agora só dispara quando os DOIS extratores recusam os bytes (corrupção real — a mensagem "corrupted, run again" volta a ser verdadeira).
• fix.js: restore de entradas link: ganha fallback de cópia quando symlink() é negado.
• DOCS.md: §8 ganhou "Extraction and the Windows symlink fallback"; notas nos pontos que citam symlinks.

Validação

• git archive real do harness (362 arquivos + 55 links): modo normal preserva os 55 links e tem paridade byte a byte com a saída do tar do sistema (diff -r limpo); modo Windows-simulado materializa os 55 com conteúdo idêntico ao canônico, zero pulados.
• test/tar-extract.test.js constrói os bytes do tar à mão — roda em qualquer OS sem exigir privilégio de symlink no runner do CI.
• Suite completa verde (759 testes) + lint limpo.

🤖 Generated with Claude Code