$ ./gradlew build
> Building...

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur as dev
participant "Terminale" as term
participant "Gradle\n( processo )" as gradle

dev -> term : ./gradlew build
term -> gradle : Lance le build
gradle -> term : Occupe le terminal\n(pas de prompt)
dev -> term : veut taper une commande
term --> dev : ❌ Terminal bloqué

note right of dev
Lo sviluppatore è
paralizzato per
tutta la durata della build
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "Terminale" as term
participant "Gradle" as gradle
database "Stato\nprocesso" as state

dev -> term : ./gradlew build
term -> gradle : Lance le build
gradle -> state : En cours (FG)
dev -> term : Ctrl+Z
term -> state : Suspendu (job [1])
term --> dev : Prompt libre $

dev -> term : git status
term --> dev : working tree clean

dev -> term : fg
term -> state : Reprend (FG)
gradle --> dev : Build réussi ✓

note right of state
Il processo Gradle
non è mai stato interrotto
Riprende esattamente
da dove si era fermato
end note
@enduml

# Dans vim, en mode commande :
:shell
$ cat /path/to/other/file.txt
$ exit
# Retour dans vim

# Dans vim, n'importe quel moment :
Ctrl+Z
[1]+  Stoppé    vim README.md

$ cat /path/to/other/file.txt
# ... lire le fichier ...

$ fg
vim README.md
# Retour exact là où on en était, curseur en place

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "vim" as vim
participant "Shell" as shell

dev -> vim : édition en cours
dev -> vim : Ctrl+Z
vim -> shell : Suspendu (job [1])
dev -> shell : cat autre_fichier.txt
shell --> dev : contenu du fichier
dev -> shell : fg
shell -> vim : Reprend (job [1])
vim --> dev : Curseur exactement\nà la même position

note right of vim
vim ripristina
integralmente lo stato:
posizione del cursore,
buffer, undo stack
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif
skinparam componentStyle rectangle

actor Développeur as dev
participant "opencode\n(agente LLM)" as agent
participant "Shell" as shell
participant "git" as git

dev -> agent : Session active
agent -> agent : Tour de parole\ndu LLM en cours

note over agent
Ctrl+Z arriva
nel bel mezzo
di un'analisi del codice
end note

dev -> agent : Ctrl+Z
agent -> shell : Suspendu (job [1])
dev -> git : git diff
git --> dev : changements visibles
dev -> shell : fg
shell -> agent : Reprend (job [1])
agent --> dev : Reprend exactement\nl'analyse en cours

note right of agent
Nessuna perdita di contesto
Il LLM riprende la sua risposta
esattamente da dove era rimasto
end note
@enduml

$ opencode
# ... session en cours, LLM analyse le code ...
^Z
[1]+  Stoppé    opencode

$ git diff HEAD~1
# vérifier les changements récents

$ fg
opencode
# Le LLM reprend là où il s'était arrêté

$ vim config.yml
^Z
[1]+  Stoppé    vim config.yml

$ ./gradlew test
^Z
[2]+  Stoppé    ./gradlew test

$ htop
^Z
[3]+  Stoppé    htop

$ jobs
[1]   Stoppé    vim config.yml
[2]-  Stoppé    ./gradlew test
[3]+  Stoppé    htop

$ fg %2
./gradlew test
# Le build reprend en avant-plan

$ bg %3
[3] htop &
# htop reprend en arrière-plan

@startuml
skinparam backgroundColor #FEFEFE

rectangle "Job sospesi" as jobs #LightYellow {
  card "[1] vim config.yml" as j1
  card "[2] ./gradlew test" as j2
  card "[3] htop" as j3
}

rectangle "Azioni" as actions #LightGreen {
  card "fg %2\n→ primo piano" as a1
  card "bg %3\n→ sfondo" as a2
  card "fg %1\n→ primo piano" as a3
}

jobs --> actions : fg/bg + numéro de job
actions --> j2 : Reprend
actions --> j3 : En arrière-plan

note bottom of jobs
Ogni job conserva
il suo stato esatto
tra i suspend/resume
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "**Ctrl+Z**\nSIGTSTP" as ctrlz #LightYellow {
  card "Sospende il processo\n(rimane in memoria)\nUtilizzabile con fg/bg" as c1
}

rectangle "**Ctrl+C**\nSIGINT" as ctrlc #LightCoral {
  card "Uccide il processo\n(non è possibile tornare indietro)\nPerdita di tutto lo stato" as c2
}

rectangle "**& **\n(background)" as ampersand #LightGreen {
  card "Avvia direttamente\nin background\nTerminale libero immediatamente" as c3
}

rectangle "**fg**\n(foreground)" as fg_ #SkyBlue {
  card "Riporta un job\nsospeso in foreground\nTerminale occupato" as c4
}

rectangle "**bg**\n(background)" as bg_ #Lavender {
  card "Riprende un job\nsospeso in background\nTerminale libero" as c5
}

ctrlz -right-> fg_ : fg pour reprendre
ctrlz -right-> bg_ : bg pour continuer\nen arrière-plan
ctrlc -right-> c2 : Pas de retour\nprocessus tué

note bottom of ctrlz
Il processo è **congelato**
ma **non terminato**
end note

note bottom of ampersand
Alternativa: lanciare
`./gradlew build &`
direttamente in background
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

title Ciclo di vita completo di un job shell
state "Inesistente" as none
state "Primo piano\n(occupa il terminale)" as foreground #LightCoral
state "Sospeso\n(Ctrl+Z / SIGTSTP)" as suspended #LightYellow
state "Sfondo\n(bg o &)" as background #LightGreen
state "Terminato\n(exit code 0)" as done #LightGray

[*] --> none
none --> foreground : tape une commande
foreground --> suspended : Ctrl+Z
foreground --> done : fin normale

suspended --> foreground : fg
suspended --> background : bg
suspended --> done : kill %n

background --> foreground : fg
background --> done : fin normale\n(en arrière-plan)
background --> suspended : Ctrl+Z\n(si fg puis Ctrl+Z)

done --> [*]

note right of suspended
Lo stato sospeso è
il perno di tutto il
sistema di job
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif
skinparam ArrowColor #444444

title "fg — Il tip che cambia tutto"

rectangle "**Problema**" as problem #LightCoral {
  card "Terminale bloccato\nda un processo" as p1
  card "Aprire un nuovo\nterminale = soluzione drastica" as p2
}

rectangle "**Soluzione**" as solution #LightGreen {
  card "Ctrl+Z → sospende" as s1
  card "fg → riprende" as s2
  card "bg → in background" as s3
  card "jobs → vedi i sospesi" as s4
}

rectangle "**Vantaggi**" as advantages #SkyBlue {
  card "Nessuna perdita di contesto" as a1
  card "Nessun riavvio" as a2
  card "Un solo terminale è sufficiente" as a3
}

problem -right-> solution : "La soluzione nativa\nUnix da 40 anni"
solution -right-> advantages : "Risultato"

note bottom of advantages
fg non è un tips oscuro
È un meccanismo fondamentale
della shell Unix
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

participant "Utente" as user
participant "Shell" as shell
participant "processo" as proc

user -> shell : Ctrl+Z
shell -> proc : SIGTSTP (signal 18)
note right of proc : Processus figé\nen mémoire

user -> shell : fg
shell -> proc : SIGCONT (signal 19)
note right of proc : Processus reprend\nen avant-plan

user -> shell : bg
shell -> proc : SIGCONT (signal 19)
note right of proc : Processus reprend\nen arrière-plan

user -> shell : Ctrl+C
shell -> proc : SIGINT (signal 2)
note right of proc : Processus terminé\nétat perdu
@enduml