Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 Notas de Lançamento *Data de Lançamento: 7 de agosto de 2025* ## 📑 Índice - [🎉 Principais Novos Recursos](#-principais-novos-recursos) - [🤖 Sistema de Gerenciamento de Agentes](#-sistema-de-gerenciamento-de-agentes) - [🤖 Atribuição de Agentes em Lote com IA](#-atribuição-de-agentes-em-lote-com-ia) - [📊 Controle de Versão Git para Histórico de Tarefas](#-controle-de-versão-git-para-histórico-de-tarefas) - [📊 Visualização do Histórico do Projeto](#-visualização-do-histórico-do-projeto) - [🎨 Sistema de Gerenciamento de Templates](#-sistema-de-gerenciamento-de-templates) - [🌍 Suporte à Internacionalização (i18n)](#-suporte-à-internacionalização-i18n) - [🧭 Navegação e Interface Aprimoradas](#-navegação-e-interface-aprimoradas) - [🔄 Melhorias Significativas](#-melhorias-significativas) - [Navegação de Detalhes de Tarefas](#navegação-de-detalhes-de-tarefas) - [Melhorias de Performance](#melhorias-de-performance) - [Experiência do Desenvolvedor](#experiência-do-desenvolvedor) - [Refinamentos de UI/UX](#refinamentos-de-uiux) - [🐛 Correções de Bugs](#-correções-de-bugs) - [Correções Críticas](#correções-críticas) - [Correções de Interface](#correções-de-interface) - [Tratamento de Dados](#tratamento-de-dados) - [🏗️ Atualizações Técnicas](#️-atualizações-técnicas) - [Novas Dependências](#novas-dependências) - [Melhorias da API](#melhorias-da-api) - [Melhorias de Arquitetura](#melhorias-de-arquitetura) - [📝 Mudanças Incompatíveis](#-mudanças-incompatíveis) - [Atualizações de Configuração](#atualizações-de-configuração) - [Mudanças da API](#mudanças-da-api) - [🚀 Guia de Migração](#-guia-de-migração) - [🎯 Resumo](#-resumo) ## 🎉 Principais Novos Recursos ### 🤖 Sistema de Gerenciamento de Agentes **Gerenciamento abrangente de subagentes para tratamento especializado de tarefas** O SHRIMP-TASK-MANAGER agora suporta poderosas capacidades de gerenciamento de agentes, permitindo definir e usar agentes IA especializados para diferentes tipos de tarefas. Agentes são personalidades ou conjuntos de habilidades IA especializadas que podem ser atribuídas a tarefas para execução ideal. Este recurso integra-se perfeitamente com o sistema de agentes do Claude, permitindo aproveitar agentes personalizados armazenados na pasta `.claude/agents`. Principais capacidades incluem: - **Visualização de Lista de Agentes**: Navegue por todos os agentes disponíveis da pasta `.claude/agents` com informações detalhadas - **Atribuição de Agentes**: Atribua agentes específicos a tarefas via dropdown na tabela de tarefas - **Popup Visualizador de Agentes**: Clique no ícone de olho (👁️) na tabela de tarefas para abrir um popup visualizador onde você pode navegar por diferentes agentes e selecionar o adequado para cada tarefa - **Editor de Agentes**: Editor integrado com personalização de cores para metadados de agentes - **Agentes Globais e de Projeto**: Suporte para definições de agentes específicos do projeto e globais - **Instruções IA com Um Clique**: Clique no emoji robô para copiar instruções específicas do agente para a área de transferência - **Instruções IA da Lista de Agentes**: Nova coluna de Instruções IA na lista de agentes com emoji robô (🤖) que copia `use subagent [agent-name] located in [path]:` para uso direto no Claude - **Modal de Informações do Agente**: Informações detalhadas do agente com navegação entre agentes - **Integração de Metadados**: Atribuições de agentes salvas diretamente no tasks.json - **Codificação por Cores**: Diferenciação visual de agentes usando cores personalizadas #### Fluxo de Atribuição de Agentes: 1. **Ver Agentes Disponíveis**: Acesse a aba Agentes para ver todos os agentes na pasta `.claude/agents` 2. **Atribuir a Tarefas**: Use o dropdown na tabela de tarefas para selecionar um agente para cada tarefa 3. **Copiar Instruções**: Clique no emoji robô para copiar: `use the built in subagent located in ./claude/agents/[agent-name] to complete this shrimp task: [task-id] please when u start working mark the shrimp task as in progress` 4. **Editar Agentes**: Modifique conteúdo e metadados do agente incluindo cores personalizadas  *A Visualização de Lista de Agentes mostra todos os agentes disponíveis com coluna de Instruções IA - clique no emoji robô (🤖) para copiar instruções de uso do agente como `use subagent debugger.md located in ./claude/agents to perform:` diretamente para a área de transferência*  *Atribua agentes a tarefas usando o seletor dropdown na tabela de tarefas*  *Clique no ícone de olho (👁️) para abrir o popup visualizador de agentes e navegar por agentes disponíveis para atribuição de tarefas*  *Edite conteúdo do agente e personalize com cores para organização visual*  *Clique no emoji robô para copiar instruções de tarefa específicas do agente*  *Navegue pelos agentes com informações detalhadas e navegação fácil*  *Configure o caminho da pasta Claude global para acessar agentes em todo o sistema* ### 🤖 Atribuição de Agentes em Lote com IA **Atribua automaticamente os agentes mais apropriados a múltiplas tarefas usando OpenAI GPT-4** O Task Viewer agora integra com o GPT-4 da OpenAI para atribuir inteligentemente agentes a tarefas baseado nas descrições e requisitos das mesmas. Este recurso reduz drasticamente o tempo necessário para configurar grandes números de tarefas com agentes apropriados. Principais recursos incluem: - **Seleção em Lote**: Selecione múltiplas tarefas usando checkboxes na tabela de tarefas - **Atribuição com Um Clique**: Clique "IA Atribuir Agentes" para atribuir automaticamente agentes a todas as tarefas selecionadas - **Correspondência Inteligente**: GPT-4 analisa descrições de tarefas e capacidades de agentes para fazer atribuições ótimas - **Integração de Configurações Globais**: Configure sua chave API OpenAI na aba Configurações Globais - **Suporte a Variáveis de Ambiente**: Também suporta variáveis de ambiente `OPENAI_API_KEY` ou `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` - **Orientação de Erro**: Instruções claras fornecidas se a chave API não estiver configurada #### Instruções de Configuração: 1. **Configurar Chave API**: Vá para Configurações → Configurações Globais e insira sua chave API OpenAI 2. **Selecionar Tarefas**: Use checkboxes para selecionar tarefas que precisam de atribuição de agente 3. **Atribuição IA**: Clique no botão "🤖 IA Atribuir Agentes" na barra de ações em lote 4. **Processamento Automático**: GPT-4 analisará tarefas e atribuirá os agentes mais adequados  *Configure sua chave API OpenAI nas Configurações Globais para atribuição de agentes impulsionada por IA*  *Selecione múltiplas tarefas e clique "🤖 IA Atribuir Agentes (5 tarefas selecionadas)" para atribuir automaticamente agentes apropriados usando GPT-4* ### 📊 Controle de Versão Git para Histórico de Tarefas **Commits Git automáticos rastreiam cada mudança em suas tarefas** O SHRIMP-TASK-MANAGER agora inclui integração Git incorporada que rastreia automaticamente todas as mudanças no seu arquivo tasks.json. Isso fornece uma trilha de auditoria completa das modificações de tarefas sem intervenção manual. Principais recursos incluem: - **Repositório Git Automático**: Inicializa um repositório Git no seu diretório de dados no primeiro uso - **Commits com Timestamp**: Cada operação de tarefa (criar, atualizar, deletar) cria um commit com timestamps de fuso horário local - **Mensagens Descritivas**: Commits incluem descrições claras do que mudou (ex: "Adicionar nova tarefa: Implementar autenticação de usuário") - **Não-Bloqueante**: Operações Git são envolvidas em blocos try-catch - se Git falhar, operações de tarefa continuam normalmente - **Repositório Isolado**: O repositório Git é apenas para histórico de tarefas, completamente separado do repositório do seu projeto - **Sem Conflitos de Merge**: Rastreamento de arquivo único com histórico linear significa que conflitos são impossíveis #### Benefícios: - **Histórico Completo**: Revise toda a evolução das suas tarefas usando ferramentas Git padrão - **Rastreamento de Mudanças**: Veja exatamente quando e como tarefas foram modificadas - **Opções de Recuperação**: Restaure estados anteriores de tarefas se necessário - **Visibilidade da Equipe**: Compartilhe histórico de tarefas com membros da equipe A integração Git é completamente transparente e não requer configuração. Você pode ver o histórico a qualquer momento usando: ```bash cd <shrimp-data-directory> git log --oneline ``` #### Como Ver Histórico de Tarefas 1. **Navegue para seu diretório de dados de tarefas** (como configurado no seu `.mcp.json`): ```bash cd <shrimp-data-directory> ``` 2. **Ver histórico de commits**: ```bash git log --oneline ``` 3. **Ver mudanças específicas**: ```bash git show <commit-hash> ``` 4. **Comparar versões**: ```bash git diff HEAD~5 # Comparar com 5 commits atrás ``` 5. **Restaurar estado anterior** (se necessário): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 Visualização do Histórico do Projeto **Rastreie e analise o histórico de execução de tarefas do seu projeto** O SHRIMP-TASK-MANAGER automaticamente salva tarefas completadas em arquivos de memória dentro do seu projeto sempre que você inicia uma nova sessão de tarefas. Anteriormente, esses dados históricos valiosos ficavam escondidos nesses arquivos de memória e inacessíveis pela interface. A nova Visualização do Histórico do Projeto expõe esse histórico de tarefas, permitindo explorar como seu projeto evoluiu ao longo do tempo. Este recurso permite: - **Snapshots de Tarefas Históricas**: Navegue por estados passados do seu projeto salvos pelo SHRIMP-TASK-MANAGER - **Rastreamento de Evolução de Tarefas**: Veja como tarefas progrediram da criação à conclusão através de diferentes sessões - **Sistema de Notas**: Adicione notas pessoais a entradas históricas para referência futura e compartilhamento de conhecimento da equipe - **Visualização Detalhada de Tarefas**: Mergulhe profundamente em estados específicos de tarefas históricas para entender decisões e implementações passadas - **Navegação Baseada em Tempo**: Navegue pela linha do tempo do seu projeto para ver o que foi realizado quando - **Comparação de Snapshots**: Compare estados de tarefas através de diferentes períodos de tempo para rastrear crescimento e mudanças do projeto   ### 🎨 Sistema de Gerenciamento de Templates **Personalização poderosa de templates para execução de tarefas IA** Templates são as instruções centrais que guiam o SHRIMP-TASK-MANAGER na análise e execução de diferentes tipos de operações. Eles definem como a IA deve abordar diferentes tipos de operações, desde planejamento e análise até implementação e verificação. O MCP-TASK-MANAGER permite templates personalizados que podem sobrescrever comportamentos padrão ou adicionar instruções adicionais a templates existentes. Esta nova interface de Gerenciamento de Templates fornece uma maneira intuitiva de: - **Editor de Templates**: Editor markdown completo com destaque de sintaxe para criar instruções IA personalizadas - **Prévia de Templates**: Prévia ao vivo de templates antes da ativação para garantir que atendem seus requisitos - **Duplicação de Templates**: Crie variações de templates existentes facilmente para diferentes casos de uso - **Rastreamento de Status de Templates**: Indicadores visuais mostrando estados Padrão (original), Personalizado (completamente substituído), e Personalizado+Anexar (adições ao padrão) - **Resetar para Padrão**: Restauração com um clique de templates originais quando necessário - **Exportar Templates**: Exporte seus templates personalizados para backup, compartilhamento com membros da equipe, ou controle de versão - **Diálogo de Ativação**: Confirmação clara ao ativar templates para prevenir mudanças acidentais  ### 🌍 Suporte à Internacionalização (i18n) **Suporte multi-idioma com mudança de idioma sem interrupções** - **Três Idiomas Suportados**: Inglês (en), Chinês (中文), e Espanhol (Español) - **Seleção de Idioma Persistente**: Sua preferência de idioma é salva e lembrada - **Tradução Completa da Interface**: Todos os elementos da interface, botões, rótulos, e mensagens são totalmente traduzidos - **Mudança Dinâmica de Idioma**: Mude idiomas instantaneamente sem recarregar a página - **Provedor de Contexto de Idioma**: Gerenciamento centralizado de idiomas para traduções consistentes ### 🧭 Navegação e Interface Aprimoradas **Melhorias modernas e intuitivas da interface** - **Sistema de Abas Aninhadas**: Navegação organizada com abas primárias e secundárias - **Sincronização de Estado da URL**: URL do navegador atualiza para refletir a visualização atual - **Navegação de Detalhes de Tarefas**: Botões Anterior/Próximo permitem revisão sequencial de tarefas sem retornar à lista - **Spinners de Carregamento**: Feedback visual durante carregamento de dados - **Notificações Toast**: Mensagens não-intrusivas de sucesso/erro - **Design Responsivo**: Experiência melhorada em celular e tablet - **Melhorias de Modal**: Melhores layouts e interações de modal - **Navegação por Teclado**: Suporte a teclas de seta para navegação mais rápida de tarefas na visualização detalhada ## 🔄 Melhorias Significativas ### Navegação de Detalhes de Tarefas **Fluxo de revisão de tarefas sem interrupções** A visualização de Detalhes de Tarefas agora inclui botões de navegação Anterior/Próximo que transformam como você revisa e trabalha com tarefas: - **Navegação Sequencial**: Mova-se pelas tarefas em ordem sem retornar à lista principal - **Preservação de Contexto**: Permaneça na visualização detalhada ao alternar entre tarefas - **Indicadores Visuais**: Botões mostram números das tarefas (ex: "← Anterior (Tarefa 3)" e "Próxima (Tarefa 5) →") - **Limites Inteligentes**: Botões de navegação desabilitam na primeira e última tarefa - **Atalhos de Teclado**: Use teclas de seta para navegação ainda mais rápida - **Aumento de Eficiência**: Revise listas inteiras de tarefas 3-5x mais rápido que clicar de volta e para frente Este recurso é particularmente valioso ao: - Revisar tarefas recém-criadas da análise IA - Trabalhar através de uma sequência de tarefas dependentes - Verificar detalhes de implementação através de múltiplas tarefas relacionadas - Executar auditorias ou revisões de tarefas ### Melhorias de Performance - **Re-renders Otimizadas**: React hooks adequadamente memoizados para melhor performance - **Carregamento Lazy**: Componentes carregam sob demanda para carregamento inicial de página mais rápido - **Gerenciamento de Estado Eficiente**: Reduziu atualizações de estado desnecessárias - **Atualizações em Lote**: Múltiplas mudanças de estado agrupadas para interface mais suave ### Experiência do Desenvolvedor - **Suite de Testes Abrangente**: Adicionou testes de integração e recursos de idiomas - **Checklists de Teste**: Documentação de teste estruturada - **Melhor Tratamento de Erros**: Mensagens de erro mais informativas - **Logging de Debug**: Capacidades de debug aprimoradas para desenvolvimento ### Refinamentos de UI/UX - **Tabela de Tarefas Melhorada**: Melhor dimensionamento de colunas e quebra de texto - **Modais Aprimorados**: Estilo e comportamento consistente de modais - **Melhor Tipografia**: Legibilidade melhorada com tamanhos de fonte atualizados - **Atualizações de Esquema de Cores**: Contrastes de cores mais acessíveis - **Consistência de Ícones**: Uso unificado de ícones por toda a aplicação ## 🐛 Correções de Bugs ### Correções Críticas - **Erro useRef Hook**: Corrigido import de hook React faltante causando crashes da aplicação - **Chaves de Tradução**: Adicionadas chaves de tradução faltantes para todos os idiomas suportados - **Loop de Link Simbólico**: Resolvido problema de loop infinito do diretório Screenshots - **Tratamento de Caminho Windows**: Corrigidos problemas de URI file:// no Windows 11 - **Links de Repositório**: Corrigidas todas as referências de repositório ### Correções de Interface - **Z-index de Modal**: Corrigidos problemas de camadas de modal - **Seleção de Abas**: Corrigida persistência de abas através de recarregamentos de página - **Seletor de Idioma**: Corrigidos problemas de sincronização de estado - **Funcionalidade de Cópia**: Melhorada confiabilidade de operações da área de transferência - **Layout Responsivo**: Corrigidos problemas de viewport móvel ### Tratamento de Dados - **Carregamento de Perfil**: Corrigidas condições de corrida ao alternar perfis - **Atualização de Tarefas**: Melhorada confiabilidade de auto-atualização - **Carregamento de Histórico**: Corrigidos problemas de paginação na visualização de histórico - **Salvamento de Templates**: Resolvidos bugs de persistência de templates ## 🏗️ Atualizações Técnicas ### Novas Dependências - `@headlessui/react`: Componentes de interface modernos - `@tanstack/react-table`: Funcionalidade avançada de tabela - `@uiw/react-md-editor`: Edição Markdown para templates - Definições de tipo adicionais para suporte TypeScript ### Melhorias da API - **GET /api/templates**: Lista todos os templates disponíveis - **PUT /api/templates/:name**: Atualiza conteúdo do template - **POST /api/templates/:name/duplicate**: Duplica templates - **GET /api/history/:profileId**: Busca histórico do projeto - **Respostas de Erro Melhoradas**: Mensagens de erro da API mais detalhadas ### Melhorias de Arquitetura - **Modularidade de Componentes**: Melhor separação de responsabilidades - **Hooks Personalizados**: Lógica reutilizável extraída em hooks - **Provedores de Contexto**: Gerenciamento de estado centralizado - **Funções Utilitárias**: Utilitários compartilhados para operações comuns ## 📝 Mudanças Incompatíveis ### Atualizações de Configuração - **Configurações de Idioma**: Novo formato de armazenamento de preferência de idioma - **Armazenamento de Templates**: Templates agora armazenados no diretório home do usuário - **Estrutura de URL**: Padrões de URL atualizados para melhor navegação ### Mudanças da API - **Endpoints de Perfil**: Formatos de resposta atualizados incluem mais metadados - **Endpoints de Tarefas**: Aprimorados com opções de filtragem adicionais - **Endpoints de Templates**: Nova estrutura de endpoint para gerenciamento de templates ## 🚀 Guia de Migração ### De v2.1 para v3.0 1. **Seleção de Idioma**: Seu idioma padrão será inglês; selecione o idioma preferido do novo seletor 2. **Templates**: Templates personalizados existentes serão preservados mas podem precisar de re-ativação 3. **Cache do Navegador**: Limpe o cache do navegador para performance ótima 4. **Dados de Perfil**: Todos os perfis existentes continuarão funcionando sem mudanças ## 🎯 Resumo A versão 3.0 representa um salto importante para o Task Viewer, transformando-o de uma ferramenta simples de visualização de tarefas em uma plataforma abrangente de gerenciamento e personalização de tarefas. Com suporte completo à internacionalização, gerenciamento poderoso de templates, automação impulsionada por IA, e capacidades de rastreamento histórico baseado em Git, este lançamento fornece às equipes controle sem precedentes sobre seus fluxos de trabalho de desenvolvimento assistidos por IA. Principais destaques deste lançamento incluem: - **Atribuição de Agentes Impulsionada por IA**: Aproveite o GPT-4 para atribuir automaticamente os agentes mais apropriados às tarefas - **Controle de Versão Git**: Rastreamento automático de todas as mudanças de tarefas com commits timestampados - **Suporte Multi-idioma**: Internacionalização completa com inglês, chinês e espanhol - **Gerenciamento de Templates**: Personalização profunda do comportamento da IA através de edição de templates - **Visualizações de Histórico**: Visibilidade completa da evolução do projeto através de commits Git e snapshots de memória A adição de suporte a três idiomas (inglês, chinês, espanhol) torna a ferramenta acessível a um público global, enquanto o sistema de gerenciamento de templates permite personalização profunda do comportamento da IA. A integração Git fornece uma trilha de auditoria permanente de todas as modificações de tarefas, e o recurso de atribuição em lote impulsionado por IA acelera dramaticamente a configuração de tarefas. Este lançamento estabelece a base para melhorias futuras e posiciona o Task Viewer como uma ferramenta essencial no kit de ferramentas moderno de desenvolvimento assistido por IA.