Causa Raiz da Corrupção do Título da Sessão da Extensão Claude Code do VS Code Identificada

Bug de Corrupção de Título de Sessão na Extensão Claude Code

Um bug persistente na extensão Claude Code do VS Code faz com que os títulos das sessões em Conversas Anteriores se corrompam — mostrando títulos errados, revertendo para o texto do último prompt ou desaparecendo completamente. Um desenvolvedor identificou a causa raiz arquitetônica e coletou mais de 20 problemas relacionados no GitHub que derivam do mesmo problema subjacente.

Análise da Causa Raiz

A lista de sessões da extensão lê os títulos realizando uma busca de string bruta por "customTitle" nos últimos 64KB de cada arquivo de sessão .jsonl. Essa abordagem cria três modos específicos de falha:

• Eliminação de 64KB — Em sessões longas (comuns em fluxos de trabalho agenticos), a entrada de título personalizado é empurrada para fora da janela de 64KB no final, fazendo com que o título seja perdido.
• Contaminação de conteúdo entre sessões — O scanner não distingue entre entradas JSONL reais de título personalizado e a string "customTitle" aparecendo dentro de resultados de ferramentas ou conteúdo da conversa, fazendo com que o título de uma sessão apareça em uma sessão completamente diferente.
• Sobrescrita ao retomar — Quando uma sessão é retomada e novo conteúdo é adicionado, qualquer título personalizado de /rename fica enterrado. A extensão então recorre ao lastPrompt ou pega uma correspondência desatualizada da saída da ferramenta.

Problemas Afetados

O desenvolvedor coletou mais de 20 problemas no GitHub relacionados a esse problema:

• Título perdido: #33165, #32150, #25090, #23610, #26240, #29194
• Título errado: #29801, #9668, #29342, #27751
• Sessões invisíveis: #9898, #31813, #29088, #22215, #18619, #11232
• Solicitações de funcionalidade (soluções alternativas): #11956, #9198, #11694, #7441

Muitos desses problemas foram fechados automaticamente como duplicados pelo bot sem que uma correção fosse implementada. Correções parciais nas versões v2.1.47 e v2.1.47 abordaram sintomas específicos, mas não a arquitetura subjacente.

Solução Proposta e Solução Alternativa

O desenvolvedor propõe armazenar títulos em um índice leve separado (ex: title-registry.json) em vez de escanear o conteúdo da conversa. Essa abordagem sobreviveria ao crescimento da sessão, seria imune à contaminação de conteúdo e permitiria sincronização entre clientes.

Para uma solução alternativa atual, o desenvolvedor tem executado um hook UserPromptSubmit + timer systemd + registro de título persistente que reafirma o título correto a cada prompt e a cada 2 minutos. Detalhes de implementação estão disponíveis no problema #32150.

Esse bug afeta qualquer pessoa usando o Claude Code para fluxos de trabalho baseados em tarefas onde combinar sessões com itens de trabalho é importante. A análise completa da causa raiz com todos os 20 problemas vinculados está disponível na discussão do GitHub.