docs: refresh project status notes for release workflow

.continue/rules/project.md

@@ -1,4 +1,4 @@
-# Project status — fullupgrade
+# Project Status — fullupgrade
 
 Last updated: 2026-04-27
 
@@ -31,38 +31,36 @@ Notes:
 
 Recommendations:
 - keep documenting the system impact clearly
-- consider whether `pacman -Sc` is the right cache cleanup level for every use case
 
 ### 2) `makerelease.sh`
 Current behavior:
-- takes `VERSION` and `MESSAGE` as arguments
+- supports explicit versions like `1.2.3`
+- supports version increments with `+0.0.1`, `+0.1`, and `+1`
+- supports `--dry-run` to print the computed release version
 - checks that the current branch is `dev`
+- verifies the working tree is clean
+- checks that the target tag does not already exist
 - checks out `main`
 - merges `dev` into `main`
 - pushes the branch
 - creates an annotated tag
 - pushes tags
-- returns to `dev`
+- attempts to return to the original branch on exit
 
 Notes:
-- the script currently does not use `set -euo pipefail`
+- the script uses `set -euo pipefail`
-- there is no check for a clean working tree
+- the release tag message is now generated automatically as `Release <version>`
-- there is no validation of the release message
+- the script no longer requires a separate release message argument
-- there is no guard against duplicate tags
+- the current increment logic assumes simple dotted numeric tags
-- returning to `dev` is not protected if a command fails
 
 Recommendations:
-- add `set -euo pipefail`
+- consider validating the version format more strictly if release rules grow
-- verify the Git status before releasing
+- keep the dry-run behavior documented and aligned with the script
-- validate `VERSION` and `MESSAGE`
-- prevent duplicate tags
-- use a `trap` to return to the initial branch on failure
-- improve the help output
 
 ### 3) `README.md`
 Current status:
-- the README has a first complete pass in English
+- the README documents both scripts in English
-- it explains both scripts, their requirements, usage, warnings, and an example release command
+- it now includes release increments and dry-run usage for `makerelease.sh`
 
 Recommendations:
 - keep it aligned with the actual script behavior
@@ -75,11 +73,6 @@ This file should be updated whenever:
 - new constraints or design decisions are introduced
 - release workflow rules evolve
 
-## Current priorities
-1. Secure the Bash scripts
-2. Keep documentation aligned with the scripts
-3. Make the release workflow more robust
-
 ## Maintenance notes
 - Always keep the README, the scripts, and this file consistent.
 - If a script changes, update this note immediately.

fullupgrade

@@ -5,20 +5,20 @@ show_help() {
 	cat <<'EOF'
 Usage: fullupgrade
 
-Met à jour Arch Linux et effectue un nettoyage:
+Updates Arch Linux and performs cleanup:
-  - mise à jour de archlinux-keyring
+  - updates archlinux-keyring
-  - synchronisation complète du système
+  - performs a full system synchronization
-  - suppression des paquets orphelins
+  - removes orphaned packages
-  - nettoyage du cache pacman
+  - cleans the pacman cache
 
-Attention: ce script modifie le système et s'exécute sans confirmation.
+Warning: this script modifies the system and runs without confirmation.
 EOF
 }
 
 
 require_root() {
 	if [ "${EUID:-$(id -u)}" -ne 0 ]; then
-		echo "Erreur: ce script doit être exécuté en root." >&2
+		echo "Error: this script must be run as root." >&2
 		exit 1
 	fi
 }
@@ -31,7 +31,7 @@ cleanup_orphans() {
 	if [ "${#orphans[@]}" -gt 0 ]; then
 		pacman -Rns --noconfirm "${orphans[@]}"
 	else
-		echo "Aucun paquet orphelin à supprimer."
+		echo "No orphaned packages to remove."
 	fi
 }
 
@@ -43,19 +43,19 @@ main() {
 
 	require_root
 
-	echo "Mise à jour de archlinux-keyring..."
+	echo "Updating archlinux-keyring..."
 	pacman -Sy --noconfirm archlinux-keyring
 
-	echo "Mise à jour complète du système..."
+	echo "Performing full system update..."
 	pacman -Syu --noconfirm
 
-	echo "Recherche des paquets orphelins..."
+	echo "Searching for orphaned packages..."
 	cleanup_orphans
 
-	echo "Nettoyage du cache pacman..."
+	echo "Cleaning pacman cache..."
 	pacman -Sc --noconfirm
 
-	echo "Mise à jour terminée avec succès."
+	echo "Update completed successfully."
 }
 
 main "$@"

project.md

@@ -1,86 +0,0 @@
-# Project Status — fullupgrade
-
-Last updated: 2026-04-27
-
-## Project goal
-This repository contains two Bash scripts for system administration and Git release management:
-- `fullupgrade`: Arch Linux maintenance script
-- `makerelease.sh`: Git release automation script
-
-The project is intentionally minimal and centered on these two scripts.
-
-## Current structure
-- `fullupgrade`: system update and cleanup
-- `makerelease.sh`: release workflow from `dev` to `main`
-- `README.md`: English documentation with usage, warnings, and examples
-- `LICENSE`: GPLv3
-
-## Current analysis
-
-### 1) `fullupgrade`
-Current behavior:
-- updates `archlinux-keyring`
-- runs `pacman -Syu --noconfirm`
-- removes orphaned packages only when any are found
-- cleans the pacman cache
-
-Notes:
-- the script already uses `set -euo pipefail`
-- it checks for root privileges before running package operations
-- it can have a significant system impact
-
-Recommendations:
-- keep documenting the system impact clearly
-- consider whether `pacman -Sc` is the right cache cleanup level for every use case
-
-### 2) `makerelease.sh`
-Current behavior:
-- supports explicit versions like `1.2.3`
-- supports version increments with `+0.0.1`, `+0.1`, and `+1`
-- supports `--dry-run` to print the computed release version
-- checks that the current branch is `dev`
-- verifies the working tree is clean
-- checks that the target tag does not already exist
-- checks out `main`
-- merges `dev` into `main`
-- pushes the branch
-- creates an annotated tag
-- pushes tags
-- attempts to return to the original branch on exit
-
-Notes:
-- the script uses `set -euo pipefail`
-- the release tag message is now generated automatically as `Release <version>`
-- the script no longer requires a separate release message argument
-- the current increment logic assumes simple dotted numeric tags
-
-Recommendations:
-- consider whether tags may need a `v` prefix in the future
-- consider validating the version format more strictly if release rules grow
-- keep the dry-run behavior documented and aligned with the script
-
-### 3) `README.md`
-Current status:
-- the README documents both scripts in English
-- it now includes release increments and dry-run usage for `makerelease.sh`
-
-Recommendations:
-- keep it aligned with the actual script behavior
-- add more examples only if they improve clarity
-
-## Project tracking rules
-This file should be updated whenever:
-- script behavior changes
-- documentation changes materially
-- new constraints or design decisions are introduced
-- release workflow rules evolve
-
-## Current priorities
-1. Secure the Bash scripts
-2. Keep documentation aligned with the scripts
-3. Make the release workflow more robust
-
-## Maintenance notes
-- Always keep the README, the scripts, and this file consistent.
-- If a script changes, update this note immediately.
-- If a new usage rule appears, document it here.