Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 Note di Rilascio *Data di Rilascio: 7 agosto 2025* ## 📑 Indice - [🎉 Principali Nuove Funzionalità](#-principali-nuove-funzionalità) - [🤖 Sistema di Gestione Agenti](#-sistema-di-gestione-agenti) - [🤖 Assegnazione Agenti in Blocco AI](#-assegnazione-agenti-in-blocco-ai) - [📊 Controllo Versione Git per Cronologia Attività](#-controllo-versione-git-per-cronologia-attività) - [📊 Vista Cronologia Progetto](#-vista-cronologia-progetto) - [🎨 Sistema di Gestione Template](#-sistema-di-gestione-template) - [🌍 Supporto Internazionalizzazione (i18n)](#-supporto-internazionalizzazione-i18n) - [🧭 Navigazione e UI Migliorate](#-navigazione-e-ui-migliorate) - [🔄 Miglioramenti Significativi](#-miglioramenti-significativi) - [Navigazione Dettagli Attività](#navigazione-dettagli-attività) - [Miglioramenti Prestazioni](#miglioramenti-prestazioni) - [Esperienza Sviluppatore](#esperienza-sviluppatore) - [Raffinamenti UI/UX](#raffinamenti-uiux) - [🐛 Correzioni Bug](#-correzioni-bug) - [Correzioni Critiche](#correzioni-critiche) - [Correzioni UI](#correzioni-ui) - [Gestione Dati](#gestione-dati) - [🏗️ Aggiornamenti Tecnici](#️-aggiornamenti-tecnici) - [Nuove Dipendenze](#nuove-dipendenze) - [Miglioramenti API](#miglioramenti-api) - [Miglioramenti Architettura](#miglioramenti-architettura) - [📝 Modifiche Incompatibili](#-modifiche-incompatibili) - [Aggiornamenti Configurazione](#aggiornamenti-configurazione) - [Cambiamenti API](#cambiamenti-api) - [🚀 Guida Migrazione](#-guida-migrazione) - [🎯 Riepilogo](#-riepilogo) ## 🎉 Principali Nuove Funzionalità ### 🤖 Sistema di Gestione Agenti **Gestione comprensiva dei sub-agenti per la gestione specializzata delle attività** SHRIMP-TASK-MANAGER ora supporta potenti capacità di gestione agenti, permettendovi di definire e utilizzare agenti AI specializzati per diversi tipi di attività. Gli agenti sono personalità AI specializzate o set di competenze che possono essere assegnate alle attività per un'esecuzione ottimale. Questa funzionalità si integra senza problemi con il sistema di agenti di Claude, permettendovi di sfruttare agenti personalizzati memorizzati nella vostra cartella `.claude/agents`. Le capacità principali includono: - **Vista Elenco Agenti**: Sfoglia tutti gli agenti disponibili dalla tua cartella `.claude/agents` con informazioni dettagliate - **Assegnazione Agenti**: Assegna agenti specifici alle attività tramite dropdown nella tabella attività - **Popup Visualizzatore Agenti**: Clicca l'icona occhio (👁️) nella tabella attività per aprire un popup visualizzatore dove puoi scorrere tra diversi agenti e selezionare quello giusto per ogni attività - **Editor Agenti**: Editor integrato con personalizzazione colori per i metadati degli agenti - **Agenti Globali e di Progetto**: Supporto per definizioni di agenti specifici del progetto e globali - **Istruzioni AI con Un Clic**: Clicca l'emoji robot per copiare istruzioni specifiche dell'agente negli appunti - **Istruzioni AI Elenco Agenti**: Nuova colonna Istruzioni AI nell'elenco agenti con emoji robot (🤖) che copia `use subagent [agent-name] located in [path]:` per uso diretto in Claude - **Modal Informazioni Agenti**: Informazioni dettagliate dell'agente con navigazione tra agenti - **Integrazione Metadati**: Assegnazioni agenti salvate direttamente in tasks.json - **Codifica Colori**: Differenziazione visiva degli agenti usando colori personalizzati #### Flusso di Lavoro Assegnazione Agenti: 1. **Visualizza Agenti Disponibili**: Accedi alla tab Agenti per vedere tutti gli agenti nella tua cartella `.claude/agents` 2. **Assegna alle Attività**: Usa il dropdown nella tabella attività per selezionare un agente per ogni attività 3. **Copia Istruzioni**: Clicca l'emoji robot per copiare: `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. **Modifica Agenti**: Modifica contenuto e metadati dell'agente inclusi colori personalizzati  *La Vista Elenco Agenti mostra tutti gli agenti disponibili con colonna Istruzioni AI - clicca l'emoji robot (🤖) per copiare istruzioni di utilizzo agente come `use subagent debugger.md located in ./claude/agents to perform:` direttamente negli appunti*  *Assegna agenti alle attività usando il selettore dropdown nella tabella attività*  *Clicca l'icona occhio (👁️) per aprire il popup visualizzatore agenti e sfogliare gli agenti disponibili per l'assegnazione attività*  *Modifica contenuto agente e personalizza con colori per organizzazione visiva*  *Clicca l'emoji robot per copiare istruzioni attività specifiche dell'agente*  *Sfoglia gli agenti con informazioni dettagliate e navigazione facile*  *Configura il percorso cartella Claude globale per accedere agli agenti sistema-wide* ### 🤖 Assegnazione Agenti in Blocco AI **Assegna automaticamente gli agenti più appropriati a multiple attività usando OpenAI GPT-4** Task Viewer ora si integra con GPT-4 di OpenAI per assegnare intelligentemente agenti alle attività basandosi sulle loro descrizioni e requisiti. Questa funzionalità riduce drasticamente il tempo necessario per configurare grandi numeri di attività con agenti appropriati. Le funzionalità principali includono: - **Selezione in Blocco**: Seleziona multiple attività usando checkbox nella tabella attività - **Assegnazione con Un Clic**: Clicca "AI Assegna Agenti" per assegnare automaticamente agenti a tutte le attività selezionate - **Abbinamento Intelligente**: GPT-4 analizza descrizioni attività e capacità agenti per fare assegnazioni ottimali - **Integrazione Impostazioni Globali**: Configura la tua chiave API OpenAI nella tab Impostazioni Globali - **Supporto Variabili Ambiente**: Supporta anche variabili ambiente `OPENAI_API_KEY` o `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` - **Guida Errori**: Istruzioni chiare fornite se la chiave API non è configurata #### Istruzioni Configurazione: 1. **Configura Chiave API**: Vai a Impostazioni → Impostazioni Globali e inserisci la tua chiave API OpenAI 2. **Seleziona Attività**: Usa checkbox per selezionare attività che necessitano assegnazione agente 3. **Assegnazione AI**: Clicca il pulsante "🤖 AI Assegna Agenti" nella barra azioni in blocco 4. **Elaborazione Automatica**: GPT-4 analizzerà le attività e assegnerà gli agenti più adatti  *Configura la tua chiave API OpenAI nelle Impostazioni Globali per assegnazione agenti AI-powered*  *Seleziona multiple attività e clicca "🤖 AI Assegna Agenti (5 attività selezionate)" per assegnare automaticamente agenti appropriati usando GPT-4* ### 📊 Controllo Versione Git per Cronologia Attività **I commit Git automatici tracciano ogni cambiamento nelle tue attività** SHRIMP-TASK-MANAGER ora include integrazione Git incorporata che traccia automaticamente tutti i cambiamenti nel tuo file tasks.json. Questo fornisce una traccia di audit completa delle modifiche attività senza intervento manuale. Le funzionalità principali includono: - **Repository Git Automatico**: Inizializza un repository Git nella tua directory dati al primo uso - **Commit con Timestamp**: Ogni operazione attività (crea, aggiorna, elimina) crea un commit con timestamp fuso orario locale - **Messaggi Descrittivi**: I commit includono descrizioni chiare di cosa è cambiato (es: "Aggiungi nuova attività: Implementa autenticazione utente") - **Non-Bloccante**: Le operazioni Git sono avvolte in blocchi try-catch - se Git fallisce, le operazioni attività continuano normalmente - **Repository Isolato**: Il repository Git è solo per cronologia attività, completamente separato dal repository del tuo progetto - **Nessun Conflitto Merge**: Il tracciamento file singolo con cronologia lineare significa che i conflitti sono impossibili #### Benefici: - **Cronologia Completa**: Rivedi l'intera evoluzione delle tue attività usando strumenti Git standard - **Tracciamento Cambiamenti**: Vedi esattamente quando e come le attività sono state modificate - **Opzioni Recupero**: Ripristina stati attività precedenti se necessario - **Visibilità Team**: Condividi cronologia attività con membri del team L'integrazione Git è completamente trasparente e non richiede configurazione. Puoi vedere la cronologia in qualsiasi momento usando: ```bash cd <shrimp-data-directory> git log --oneline ``` #### Come Visualizzare Cronologia Attività 1. **Naviga alla tua directory dati attività** (come configurata nel tuo `.mcp.json`): ```bash cd <shrimp-data-directory> ``` 2. **Visualizza cronologia commit**: ```bash git log --oneline ``` 3. **Vedi cambiamenti specifici**: ```bash git show <commit-hash> ``` 4. **Confronta versioni**: ```bash git diff HEAD~5 # Confronta con 5 commit fa ``` 5. **Ripristina stato precedente** (se necessario): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 Vista Cronologia Progetto **Traccia e analizza la cronologia esecuzione attività del tuo progetto** SHRIMP-TASK-MANAGER salva automaticamente attività completate in file di memoria all'interno del tuo progetto ogni volta che avvii una nuova sessione attività. Precedentemente, questi dati cronologici preziosi erano nascosti in questi file di memoria e inaccessibili tramite UI. La nuova Vista Cronologia Progetto espone questa cronologia attività, permettendoti di esplorare come il tuo progetto è evoluto nel tempo. Questa funzionalità ti permette di: - **Snapshot Attività Cronologiche**: Sfoglia stati passati del tuo progetto salvati da SHRIMP-TASK-MANAGER - **Tracciamento Evoluzione Attività**: Vedi come le attività sono progredite dalla creazione al completamento attraverso diverse sessioni - **Sistema Note**: Aggiungi note personali alle voci cronologiche per riferimento futuro e condivisione conoscenza team - **Vista Dettagliata Attività**: Approfondisci stati attività cronologiche specifiche per comprendere decisioni e implementazioni passate - **Navigazione Basata Tempo**: Naviga attraverso la timeline del tuo progetto per vedere cosa è stato realizzato quando - **Confronto Snapshot**: Confronta stati attività attraverso diversi periodi temporali per tracciare crescita e cambiamenti progetto   ### 🎨 Sistema di Gestione Template **Personalizzazione potente template per esecuzione attività AI** I template sono le istruzioni centrali che guidano SHRIMP-TASK-MANAGER nell'analizzare ed eseguire diversi tipi di operazioni. Definiscono come l'AI dovrebbe approcciarsi a diversi tipi di operazioni, dalla pianificazione e analisi all'implementazione e verifica. MCP-TASK-MANAGER permette template personalizzati che possono sovrascrivere comportamenti predefiniti o aggiungere istruzioni aggiuntive ai template esistenti. Questa nuova interfaccia Gestione Template fornisce un modo intuitivo per: - **Editor Template**: Editor markdown completo con evidenziazione sintassi per creare istruzioni AI personalizzate - **Anteprima Template**: Anteprima live dei template prima dell'attivazione per assicurare che soddisfino i tuoi requisiti - **Duplicazione Template**: Crea facilmente variazioni di template esistenti per diversi casi d'uso - **Tracciamento Stato Template**: Indicatori visuali che mostrano stati Predefinito (originale), Personalizzato (completamente sostituito), e Personalizzato+Aggiungi (aggiunte al predefinito) - **Reset al Predefinito**: Ripristino con un clic dei template originali quando necessario - **Esporta Template**: Esporta i tuoi template personalizzati per backup, condivisione con membri team, o controllo versione - **Dialogo Attivazione**: Conferma chiara quando si attivano template per prevenire cambiamenti accidentali  ### 🌍 Supporto Internazionalizzazione (i18n) **Supporto multi-lingua con cambio lingua senza interruzioni** - **Tre Lingue Supportate**: Inglese (en), Cinese (中文), e Spagnolo (Español) - **Selezione Lingua Persistente**: La tua preferenza lingua è salvata e ricordata - **Traduzione UI Completa**: Tutti gli elementi UI, pulsanti, etichette e messaggi sono completamente tradotti - **Cambio Lingua Dinamico**: Cambia lingue al volo senza ricaricamento pagina - **Provider Contesto Lingua**: Gestione lingua centralizzata per traduzioni consistenti ### 🧭 Navigazione e UI Migliorate **Miglioramenti interfaccia moderni e intuitivi** - **Sistema Tab Annidati**: Navigazione organizzata con tab primari e secondari - **Sincronizzazione Stato URL**: URL browser si aggiorna per riflettere la vista corrente - **Navigazione Dettagli Attività**: I pulsanti Precedente/Successivo permettono revisione sequenziale attività senza tornare alla lista - **Spinner Caricamento**: Feedback visivo durante caricamento dati - **Notifiche Toast**: Messaggi successo/errore non intrusivi - **Design Responsive**: Esperienza mobile e tablet migliorata - **Miglioramenti Modal**: Layout e interazioni modal migliori - **Navigazione Tastiera**: Supporto tasti freccia per navigazione attività più veloce nella vista dettagli ## 🔄 Miglioramenti Significativi ### Navigazione Dettagli Attività **Flusso lavoro revisione attività senza interruzioni** La vista Dettagli Attività ora include pulsanti navigazione Precedente/Successivo che trasformano come rivedi e lavori con le attività: - **Navigazione Sequenziale**: Muoviti attraverso le attività in ordine senza tornare alla lista principale - **Preservazione Contesto**: Rimani nella vista dettagli mentre cambi tra attività - **Indicatori Visuali**: I pulsanti mostrano numeri attività (es: "← Precedente (Attività 3)" e "Successivo (Attività 5) →") - **Confini Intelligenti**: I pulsanti navigazione si disabilitano alla prima e ultima attività - **Scorciatoie Tastiera**: Usa tasti freccia per navigazione ancora più veloce - **Aumento Efficienza**: Rivedi intere liste attività 3-5x più veloce che cliccare avanti e indietro Questa funzionalità è particolarmente preziosa quando: - Si rivedono attività appena create dall'analisi AI - Si lavora attraverso una sequenza di attività dipendenti - Si controllano dettagli implementazione attraverso multiple attività correlate - Si eseguono audit o revisioni attività ### Miglioramenti Prestazioni - **Re-render Ottimizzati**: React hook propriamente memoizzati per migliori prestazioni - **Caricamento Lazy**: I componenti si caricano su richiesta per caricamento pagina iniziale più veloce - **Gestione Stato Efficiente**: Ridotti aggiornamenti stato non necessari - **Aggiornamenti Batch**: Cambiamenti stato multipli raggruppati per UI più fluida ### Esperienza Sviluppatore - **Suite Test Completa**: Aggiunti test integrazione e funzionalità lingua - **Checklist Test**: Documentazione test strutturata - **Migliore Gestione Errori**: Messaggi errore più informativi - **Logging Debug**: Capacità debug migliorate per sviluppo ### Raffinamenti UI/UX - **Tabella Attività Migliorata**: Dimensionamento colonne e avvolgimento testo migliore - **Modal Migliorate**: Styling e comportamento modal consistente - **Tipografia Migliore**: Leggibilità migliorata con dimensioni font aggiornate - **Aggiornamenti Schema Colori**: Contrasti colore più accessibili - **Consistenza Icone**: Uso icone unificato attraverso l'app ## 🐛 Correzioni Bug ### Correzioni Critiche - **Errore useRef Hook**: Corretto import React hook mancante che causava crash app - **Chiavi Traduzione**: Aggiunte chiavi traduzione mancanti per tutte le lingue supportate - **Loop Link Simbolico**: Risolto problema loop infinito directory Screenshots - **Gestione Path Windows**: Corretti problemi URI file:// su Windows 11 - **Link Repository**: Corretti tutti i riferimenti repository ### Correzioni UI - **Z-index Modal**: Corretti problemi layering modal - **Selezione Tab**: Corretta persistenza tab attraverso ricaricamenti pagina - **Selettore Lingua**: Corretti problemi sincronizzazione stato - **Funzionalità Copia**: Migliorata affidabilità operazioni clipboard - **Layout Responsive**: Corretti problemi viewport mobile ### Gestione Dati - **Caricamento Profilo**: Corrette condizioni race quando si cambiano profili - **Aggiornamento Attività**: Migliorata affidabilità auto-refresh - **Caricamento Cronologia**: Corretti problemi paginazione nella vista cronologia - **Salvataggio Template**: Risolti bug persistenza template ## 🏗️ Aggiornamenti Tecnici ### Nuove Dipendenze - `@headlessui/react`: Componenti UI moderni - `@tanstack/react-table`: Funzionalità tabella avanzate - `@uiw/react-md-editor`: Editing Markdown per template - Definizioni tipo aggiuntive per supporto TypeScript ### Miglioramenti API - **GET /api/templates**: Elenca tutti i template disponibili - **PUT /api/templates/:name**: Aggiorna contenuto template - **POST /api/templates/:name/duplicate**: Duplica template - **GET /api/history/:profileId**: Recupera cronologia progetto - **Risposte Errore Migliorate**: Messaggi errore API più dettagliati ### Miglioramenti Architettura - **Modularità Componenti**: Migliore separazione delle responsabilità - **Hook Personalizzati**: Logica riutilizzabile estratta in hook - **Provider Contesto**: Gestione stato centralizzata - **Funzioni Utility**: Utility condivise per operazioni comuni ## 📝 Modifiche Incompatibili ### Aggiornamenti Configurazione - **Impostazioni Lingua**: Nuovo formato storage preferenza lingua - **Storage Template**: Template ora memorizzati nella directory home utente - **Struttura URL**: Pattern URL aggiornati per migliore navigazione ### Cambiamenti API - **Endpoint Profilo**: Formati risposta aggiornati includono più metadati - **Endpoint Attività**: Migliorati con opzioni filtraggio aggiuntive - **Endpoint Template**: Nuova struttura endpoint per gestione template ## 🚀 Guida Migrazione ### Da v2.1 a v3.0 1. **Selezione Lingua**: La tua lingua predefinita sarà inglese; seleziona la lingua preferita dal nuovo selettore 2. **Template**: Template personalizzati esistenti saranno preservati ma potrebbero necessitare ri-attivazione 3. **Cache Browser**: Pulisci cache browser per prestazioni ottimali 4. **Dati Profilo**: Tutti i profili esistenti continueranno a funzionare senza cambiamenti ## 🎯 Riepilogo La versione 3.0 rappresenta un salto importante per Task Viewer, trasformandolo da uno strumento semplice di visualizzazione attività in una piattaforma completa di gestione e personalizzazione attività. Con supporto completo internazionalizzazione, gestione template potente, automazione AI-powered, e capacità tracciamento cronologico basato Git, questo rilascio fornisce ai team controllo senza precedenti sui loro flussi lavoro sviluppo assistiti da AI. I punti salienti principali di questo rilascio includono: - **Assegnazione Agenti AI-Powered**: Sfrutta GPT-4 per assegnare automaticamente gli agenti più appropriati alle attività - **Controllo Versione Git**: Tracciamento automatico di tutti i cambiamenti attività con commit con timestamp - **Supporto Multi-lingua**: Internazionalizzazione completa con inglese, cinese e spagnolo - **Gestione Template**: Personalizzazione profonda comportamento AI attraverso editing template - **Viste Cronologia**: Visibilità completa evoluzione progetto attraverso commit Git e snapshot memoria L'aggiunta del supporto tre lingue (inglese, cinese, spagnolo) rende lo strumento accessibile a un pubblico globale, mentre il sistema gestione template permette personalizzazione profonda del comportamento AI. L'integrazione Git fornisce una traccia audit permanente di tutte le modifiche attività, e la funzionalità assegnazione in blocco AI-powered accelera drammaticamente la configurazione attività. Questo rilascio pone le fondamenta per miglioramenti futuri e posiziona Task Viewer come strumento essenziale nel toolkit moderno di sviluppo assistito da AI.