نصائح فائقة لأمر fg: عندما يحفظ Ctrl+Z جلستك في الطرفية

$ ./gradlew build
> Building...

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 6) ]

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur as dev
participant "النهاية" as term
participant "Gradle
^^^^^
 Syntax Error? (Assumed diagram type: sequence)

@startuml
skinparam backgroundColor #FEFEFE

actor Développeur as dev
participant "النهاية" as term
participant "Gradle
( عملية )" 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
  Le développeur est
  paralysé pendant
  toute la durée du build
end note
@enduml

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 8) ]

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "طرفية" as term
participant "Gradle" as gradle
database "الحالة
^^^^^
 Syntax Error? (Assumed diagram type: sequence)

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor Développeur as dev
participant "طرفية" as term
participant "Gradle" as gradle
database "الحالة
العملية" 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
  Le processus Gradle
  n'a jamais été tué
  Il reprend exactement
  où il s'était arrêté
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

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 7) ]

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

actor Développeur as dev
participant "opencode
^^^^^
 Syntax Error? (Assumed diagram type: sequence)

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

actor Développeur as dev
participant "opencode
(وكيل نموذج لغوي كبير)" as agent
participant "قشرة" as shell
participant "جيت" as git

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

note over agent
  Ctrl+Z arrive
  en plein milieu
  d'une analyse de code
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
  Aucune perte de contexte
  Le LLM reprend sa réponse
  exactement où il en était
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

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 6) ]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "**Ctrl+Z**
SIGTSTP" as ctrlz #LightYellow {
^^^^^
 Syntax Error? (Assumed diagram type: activity)

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "**Ctrl+Z**
SIGTSTP" as ctrlz #LightYellow {
  card "علق العملية
(is لا يزال في الذاكرة)
يمكن استخدامه مع fg/bg" as c1
}

rectangle "**Ctrl+C**\nSIGINT" as ctrlc #LightCoral {
  card "اقتل العملية
(لا يمكن العودة)
فقدان كل الحالة" as c2
}

rectangle "** & **\n(الخلفية)" as ampersand #LightGreen {
  card "ابدأ مباشرة
في الخلفية
طرفية حرة فورًا" as c3
}

rectangle "**fg**
(الواجهة الأمامية)" as fg_ #SkyBlue {
  card "جلب مهمة
معلقة في المقدمة
الطرفية مشغولة" as c4
}

rectangle "**الخلفية**
(الخلفية)" as bg_ #Lavender {
  card "استأنف مهمة معلقة في الخلفية\nطرفية حرة" 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
  Le processus est **figé**
  mais **pas tué**
end note

note bottom of ampersand
  Alternative : lancer
  ./gradlew build &
  directement en arrière-plan
end note
@enduml

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 8) ]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

title دورة حياة كاملة لوظيفة شل
state "غير موجود" as none
state "الواجهة الأمامية\n(يشغل الطرفي)" as foreground #LightCoral
state "معلق
^^^^^
 Syntax Error? (Assumed diagram type: state)

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

title دورة حياة كاملة لوظيفة شل
state "غير موجود" as none
state "الواجهة الأمامية\n(يشغل الطرفي)" as foreground #LightCoral
state "معلق
(Ctrl+Z / SIGTSTP)" as suspended #LightYellow
state "الخلفية
(bg أو &)" as background #LightGreen
state "مكتمل\n(كود الخروج 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
  L'état suspendu est
  le pivot de tout le
  système de jobs
end note
@enduml

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 27) ]

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

title "fg — النصيحة التي تغير كل شيء"

rectangle "**مشكلة**" as problem #LightCoral {
  card "محطة مغلقة\nبعملية" as p1
  card "فتح محطّة جديدة\nالمحطة = حلّ ثقيل" as p2
}

rectangle "**الحل**" as solution #LightGreen {
  card "Ctrl+Z → تعليق" as s1
  card "fg → يستأنف" as s2
  card "bg → في الخلفية" as s3
  card "الوظائف → عرض المعلقين" as s4
}

rectangle "**المزايا**" as advantages #SkyBlue {
  card "لا فقدان للسياق" as a1
  card "لا إعادة تشغيل" as a2
  card "يكفي محطة واحدة" as a3
}

problem -right-> solution : "الحل الأصلي
Unix منذ 40 سنة"
^^^^^
 Syntax Error? (Assumed diagram type: component)

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

title "fg — النصيحة التي تغير كل شيء"

rectangle "**مشكلة**" as problem #LightCoral {
  card "محطة مغلقة\nبعملية" as p1
  card "فتح محطّة جديدة\nالمحطة = حلّ ثقيل" as p2
}

rectangle "**الحل**" as solution #LightGreen {
  card "Ctrl+Z → تعليق" as s1
  card "fg → يستأنف" as s2
  card "bg → في الخلفية" as s3
  card "الوظائف → عرض المعلقين" as s4
}

rectangle "**المزايا**" as advantages #SkyBlue {
  card "لا فقدان للسياق" as a1
  card "لا إعادة تشغيل" as a2
  card "يكفي محطة واحدة" as a3
}

problem -right-> solution : "الحل الأصلي
Unix منذ 40 سنة"
solution -right-> advantages : "نتيجة"

note bottom of advantages
  fg n'est pas un tips obscur
  C'est un mécanisme fondamental
  du shell Unix
end note
@enduml

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 6) ]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "لماذا fg هو
قليل التقدير ?" as why #LightCoral {
^^^^^
 Syntax Error? (Assumed diagram type: activity)

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontName sans-serif

rectangle "لماذا fg هو
قليل التقدير ?" as why #LightCoral {
  card "بيئة تطوير متكاملة مع الطرفية
علامات تبويب متعددة" as w1
  card "أدوات رسومية
التي تستبدل واجهة سطر الأوامر" as w2
  card "tmux/screen\nحلّ المشكلة\nبشكل آخر" as w3
}

rectangle "لماذا fg هو
أعلى؟" as superior #LightGreen {
  card "عام : bash,\nzsh, fish, sh..." as s1
  card "بدون تبعية:
لا تثبيت" as s2
  card "ضربتان:\nCtrl+Z ثم fg" as s3
  card "السياق محفوظ :\nصفر فقدان الحالة" as s4
}

why -right-> superior : "البساطة
تفوز دائمًا"
@enduml