Aggiunge una nuova entry al diario di lavoro.

Se il file non esiste, lo crea con la struttura corretta. Il titolo del file segue il formato "Per lo Stand-up {Giorno+1} {Mese} {Anno}".

Parametri:

• progetto (str, required): Nome del progetto (es. "SmarTicket", "MCP Teseo")

• descrizione (str, required): Breve descrizione del lavoro (es. "Fix bug autenticazione")

• paragrafo_intro (str, required): Paragrafo introduttivo che riassume cosa e' stato fatto

• contenuto (str, optional): Contenuto aggiuntivo (sottosezioni, bullet points, codice)

• richiesto_da (str, optional): Nome della persona che ha richiesto il lavoro

• repository (str, optional): Nome del repository

• branch (str, optional): Nome del branch

• jira_ticket (str, optional): Codice ticket Jira (es. "SMART-123")

• jira_url (str, optional): URL del ticket Jira

• gitlab_mr (str, optional): Numero MR GitLab (es. "!456")

• gitlab_mr_url (str, optional): URL della MR GitLab

• data (str, optional): Data del file YYYY-MM-DD (default: oggi)

Restituisce: Conferma dell'operazione con path del file e dettagli.

Legge il contenuto del diario per una data o range di date.

Modalita' di utilizzo (mutualmente esclusive):

1. data: Legge un singolo giorno

2. data_inizio + data_fine: Legge un range di date

3. ultimi_giorni: Legge gli ultimi N giorni

4. Nessun parametro: Legge il diario di oggi

Parametri:

• data (str, optional): Data singola YYYY-MM-DD

• data_inizio (str, optional): Data inizio range YYYY-MM-DD

• data_fine (str, optional): Data fine range YYYY-MM-DD

• ultimi_giorni (int, optional): Numero di giorni da leggere

Restituisce: Contenuto del diario con entries, progetti e bloccanti.

Imposta o aggiorna la sezione Bloccanti del diario.

Il file deve esistere (usa cronos_aggiungi_entry per crearlo).

Parametri:

• bloccanti (str, required): Testo dei bloccanti ("Nessuno" se non ci sono bloccanti)

• data (str, optional): Data del file YYYY-MM-DD (default: oggi)

Restituisce: Conferma dell'operazione con path del file.

Genera un riassunto discorsivo del diario per lo standup.

Restituisce il contenuto completo delle entry del diario insieme a istruzioni di stile per generare un messaggio alto livello, fluido e professionale.

Stile del riassunto:

• Alto livello, niente dettagli implementativi

• Fluido e naturale, frasi discorsive, no elenchi puntati

• Niente numeri di MR, codici Jira, nomi di file o classi

• Niente strumenti interni (MCP, tool CLI, script)

• Dettagli tecnici solo se interessanti per decisioni future

Usa questo tool quando l'utente chiede:

• Un riassunto per lo standup / stand-up

• "Cosa dico allo standup?"

• "Riassumi cosa ho fatto [data]"

• "Fammi un riassunto discorsivo"

Parametri:

• data (str, optional): Data singola YYYY-MM-DD (default: ultimo giorno lavorativo)

• data_inizio (str, optional): Data inizio range YYYY-MM-DD

• data_fine (str, optional): Data fine range YYYY-MM-DD

Restituisce: Contenuto del diario con istruzioni di stile per la generazione del messaggio.

Chiusura di fine giornata: legge le entry del diario e restituisce istruzioni per ristrutturarle.

Usa questo tool quando l'utente dice:

• "Fine giornata" / "Chiudi la giornata"

• "Riscrivi il diario"

• "Genera i riassunti di fine giornata"

• "Fai il wrap-up della giornata"

Il tool restituisce le entry grezze del giorno insieme a istruzioni dettagliate per generare quattro output:

1. Entry riscritte in ordine cronologico e logico

2. Riassunto della giornata (paragrafo narrativo)

3. Riassunto tecnico (denso, con tutti i dettagli implementativi)

4. Messaggio per lo standup (alto livello, discorsivo)

Parametri:

• data (str, optional): Data YYYY-MM-DD (default: oggi)

Restituisce: Entry del diario con istruzioni di stile per la generazione.

Consolida il diario rileggendolo e riscrivendolo in modo coerente.

Utile quando il diario ha entry separate sullo stesso argomento, ripetizioni, o informazioni sparse che andrebbero raggruppate. Il tool rilegge il file, identifica i problemi di struttura, e restituisce istruzioni per riscriverlo.

Usa questo tool quando l'utente dice:

• "Consolida il diario"

• "Riscrivi il diario in modo coerente"

• "Elimina le ripetizioni dal diario"

• "Organizza meglio il diario"

• "Unifica le entry del diario"

Parametri:

• data (str, optional): Data YYYY-MM-DD (default: oggi)

Restituisce: Contenuto del file con analisi e istruzioni per il consolidamento.

Elenca i progetti menzionati nel diario in un periodo.

Utile per avere una panoramica dei progetti su cui si e' lavorato.

Parametri:

• data_inizio (str, optional): Data inizio YYYY-MM-DD

• data_fine (str, optional): Data fine YYYY-MM-DD

• ultimi_giorni (int, optional): Se non specificate le date, usa gli ultimi N giorni (default 30)

Restituisce: Lista progetti con occorrenze e date.

Cerca testo nei file del diario (raw, todo, chiusura).

Ricerca full-text case-insensitive con supporto regex. Per default cerca su tutte e tre le sorgenti (raw, todo, chiusura). Utile per trovare quando si e' lavorato su un progetto, ticket, argomento, o quando una decisione e' stata presa, o cosa c'era da fare.

Usa questo tool quando l'utente chiede:

• "Quando ho lavorato su X?"

• "Cerca nel diario Y"

• "Trova il ticket Z"

• "Quando ho deciso di fare W?" (cerca tipo=["chiusura"])

• "In quali todo e' stato pianificato V?" (cerca tipo=["todo"])

Parametri:

• query (str, required): Testo da cercare (case-insensitive, supporta regex)

• data_inizio (str, optional): Data inizio range YYYY-MM-DD

• data_fine (str, optional): Data fine range YYYY-MM-DD

• ultimi_giorni (int, optional): Giorni da cercare (default 90)

• tipo (list[str], optional): Sorgenti da cercare. Valori: "raw", "todo", "chiusura". Default: tutte e tre.

Restituisce: Lista di match con tipo (raw|todo|chiusura), data, contesto. Per i match in raw include progetto e descrizione; per todo/chiusura include il path del file.

Riassunto settimanale del diario raggruppato per progetto.

Mostra su quanti giorni si e' lavorato per ogni progetto durante la settimana, con riepilogo delle attivita'. Utile per report settimanali o per capire la distribuzione del lavoro.

Usa questo tool quando l'utente chiede:

• "Cosa ho fatto questa settimana?"

• "Riassunto settimanale"

• "Su cosa ho lavorato questa settimana?"

• "Report della settimana"

Parametri:

• data (str, optional): Una data nella settimana da analizzare YYYY-MM-DD (default: settimana corrente)

Restituisce: Riassunto per progetto con giorni, date e attivita'.

Aggiunge contenuto a un'entry di progetto esistente nel diario.

Se nel diario di oggi esiste gia' un'entry per il progetto specificato, aggiunge una sotto-sezione (H4) evitando frammentazione. Se non esiste, crea una nuova entry standard.

Usa questo tool quando:

• L'utente aggiunge lavoro su un progetto gia' presente nel diario di oggi

• "Aggiungi al progetto X che ho fatto anche Y"

• "Ho continuato su X, aggiungi..."

Per una nuova entry su un progetto nuovo, usa cronos_aggiungi_entry.

Parametri:

• progetto (str, required): Nome esatto del progetto (deve corrispondere all'H3 esistente)

• titolo_fase (str, required): Titolo della sotto-sezione (es. "Fix bug login")

• contenuto (str, required): Contenuto della sotto-sezione

• richiesto_da (str, optional): Chi ha richiesto il lavoro

• repository (str, optional): Nome del repository

• branch (str, optional): Nome del branch

• jira_ticket (str, optional): Codice ticket Jira

• jira_url (str, optional): URL del ticket Jira

• gitlab_mr (str, optional): Numero MR GitLab

• gitlab_mr_url (str, optional): URL della MR GitLab

• data (str, optional): Data YYYY-MM-DD (default: oggi)

Restituisce: Conferma con modalita' (aggiunto_a_esistente o nuova_entry).

Scrive il file di fine giornata con il contenuto generato.

Usa questo tool DOPO cronos_fine_giornata: prima generi il contenuto seguendo le istruzioni ricevute, poi chiami questo tool per scriverlo.

Parametri:

• contenuto (str, required): Contenuto markdown completo del file

• data (str, optional): Data YYYY-MM-DD (default: oggi)

Restituisce: Conferma con path del file scritto.

Legge il file todo.md di una data (default oggi).

Restituisce il contenuto markdown del todo, utile per rispondere alla domanda "che dovevo fare oggi?". Se nella stessa cartella esiste un todo.bak.md (creato da una ripianificazione precedente con cronos_prepara_domani), il path del backup viene riportato.

Parametri:

• data (str, optional): Data del todo YYYY-MM-DD (default: oggi)

Restituisce: Contenuto del file todo.md, path, ed eventuale info sul backup.

Lista lo stato del diario per ogni giorno di un mese.

Restituisce una vista mensile con un record per giorno che indica quali artifact sono presenti: legacy single-file (storico), raw.md, todo.md, fine-giornata.md. Per i giorni con file principale leggibile riporta il numero di entry parsate.

Utile come dashboard "a colpo d'occhio" per il mese: dove c'e' chiusura, dove ci sono todo pendenti, quali giorni sono vuoti.

Parametri:

• mese (int, optional): Numero mese 1-12 (default: mese corrente)

• anno (int, optional): Anno YYYY (default: anno corrente)

Restituisce: Riepilogo totali + dettaglio per giorno con flag presenza file.

Prepara la cartella del prossimo giorno lavorativo con todo.md e scheletro raw.md.

Default: il giorno target e' calcolato come prossimo giorno lavorativo da oggi (lun-gio -> +1, ven -> lun, sab -> lun, dom -> lun). In alternativa si puo' specificare una data esplicita per pianificare un giorno futuro qualsiasi.

Comportamento:

• Crea/sovrascrive todo.md con contenuto_todo (un to-do e' l'ultima pianificazione, non un log progressivo).

• Crea raw.md con lo scheletro standard SOLO se non esiste gia', per non sovrascrivere entry aggiunte in anticipo.

Usa questo tool:

• Al termine di cronos_scrivi_fine_giornata, per impostare il todo del giorno successivo a partire dai punti aperti della giornata.

• Manualmente quando vuoi pianificare le cose da fare in un giorno futuro.

Parametri:

• contenuto_todo (str, required): Contenuto markdown completo di todo.md

• data (str, optional): Data target YYYY-MM-DD (default: prossimo giorno lavorativo)

Restituisce: Conferma con path di todo.md e raw.md, e flag se raw e' stato creato.