docs: tighten mtm-ddwipe help and project guidance

.continue/rules/project.md

@@ -0,0 +1,25 @@
+---
+description: mtm-ddwipe project conventions
+---
+
+# Project conventions
+- Use English throughout the project.
+- Keep shell scripts Bash-based when Bash is already used by the project.
+- Preserve the current behavior of the main script:
+  - `mtm-ddwipe`: wipe devices.
+- Strengthen destructive-action safety checks in `mtm-ddwipe` when making changes.
+- Keep `mtm-ddwipe` interactive by default unless a change explicitly adds a safe opt-in flag.
+- Keep user-facing messages short, clear, and in English.
+- Prefer minimal, focused changes that do not alter the intent of the existing scripts, unless the script behavior is intentionally updated.
+- Maintain `.continue/rules/project.md` whenever project conventions or script behavior change.
+- `mtm-ddwipe` is a small Bash script with helper functions.
+- Keep the host and line-number removal behavior intact.
+- `mtm-ddwipe` must print a usage line and support `-h`/`--help`.
+- Validate that wipe targets are real block devices before operating on them.
+- Keep short, explicit confirmation prompts before destructive operations.
+- Keep error and help messages short, clear, and in English.
+- Keep help text concise and usage-first.
+
+# Project identity
+- Main script: `mtm-ddwipe`
+- License: GNU GPL v3

makerelease.sh

@@ -1,32 +1,135 @@
 #!/bin/bash
 
-declare -r VERSION=${1}
+set -euo pipefail
-declare -r MESSAGE=${2}
+
 declare -r TAGBRANCH=main
 declare CURRENTBRANCH=""
+declare ORIGBRANCH=""
+declare -r ARG1="${1:-}"
+declare -r ARG2="${2:-}"
+declare is_dry_run=false
+declare release_input=""
 
 showHelp() {
-	echo makerelease version
+	cat <<'EOF'
+Usage:
+  makerelease.sh VERSION
+  makerelease.sh +0.0.1
+  makerelease.sh +0.1
+  makerelease.sh +1
+  makerelease.sh --dry-run VERSION
+  makerelease.sh --dry-run +0.0.1
+  makerelease.sh --dry-run +0.1
+  makerelease.sh --dry-run +1
+
+Creates an annotated Git tag from the current dev branch.
+
+If VERSION starts with +, it is treated as an increment:
+- +0.0.1 increments patch
+- +0.1 increments minor
+- +1 increments major
+
+Use --dry-run to show the computed release version without running Git actions.
+
+Requirements:
+- run from a clean Git working tree
+- current branch must be dev for real releases
+- main branch must exist locally
+EOF
 }
 
-if [ "${VERSION}" == "" ]; then
+cleanup() {
+	if [ -n "${ORIGBRANCH}" ] && [ "${CURRENTBRANCH}" != "${ORIGBRANCH}" ]; then
+		git checkout "${ORIGBRANCH}" >/dev/null 2>&1 || true
+	fi
+}
+
+trap cleanup EXIT
+
+if [ "${ARG1}" = "--dry-run" ] || [ "${ARG1}" = "-n" ]; then
+	is_dry_run=true
+	release_input="${ARG2:-}"
+else
+	release_input="${ARG1}"
+fi
+
+if [ -z "${release_input}" ]; then
 	showHelp
 	echo ""
 	echo "no version provided!"
 	exit 1
 fi
 
-CURRENTBRANCH=$(git rev-parse --abbrev-ref HEAD)
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+	echo "You are not inside a Git repository!"
+	exit 1
+fi
 
-if [ ! "${CURRENTBRANCH}" == "dev" ]; then
+if [ -n "$(git status --porcelain)" ]; then
+	echo "Working tree is not clean!"
+	echo "Commit or stash your changes before creating a release."
+	exit 1
+fi
+
+CURRENTBRANCH=$(git rev-parse --abbrev-ref HEAD)
+ORIGBRANCH="${CURRENTBRANCH}"
+
+if [ "${is_dry_run}" = false ] && [ "${CURRENTBRANCH}" != "dev" ]; then
 	echo "You are not in dev branch!"
 	echo "Use dev branch to make a release!"
 	exit 1
 fi
 
+release_tag="${release_input}"
+if [ "${release_input}" != "${release_input#+}" ]; then
+	current_tag="$(git describe --tags --abbrev=0 2>/dev/null || true)"
+	if [ -z "${current_tag}" ]; then
+		echo "No existing tag found to increment from!"
+		exit 1
+	fi
+	case "${release_input}" in
+		+1)
+			release_tag="$(printf '%s' "${current_tag}" | awk -F. 'BEGIN{OFS="."} { $1+=1; $2=0; $3=0; print }')"
+			;;
+			+0.1)
+			release_tag="$(printf '%s' "${current_tag}" | awk -F. 'BEGIN{OFS="."} { $2+=1; $3=0; print }')"
+			;;
+			+0.0.1)
+			release_tag="$(printf '%s' "${current_tag}" | awk -F. 'BEGIN{OFS="."} { $3+=1; print }')"
+			;;
+		*)
+			echo "Unsupported increment syntax: ${release_input}"
+			exit 1
+			;;
+	esac
+fi
+
+if git rev-parse -q --verify "refs/tags/${release_tag}" >/dev/null; then
+	echo "Tag ${release_tag} already exists!"
+	exit 1
+fi
+
+if [ "${is_dry_run}" = true ]; then
+	echo "Dry run: computed release tag ${release_tag}"
+	exit 0
+fi
+
+echo "Release tag selected: ${release_tag}"
+read -r -p "Proceed with release? [y/N] " confirm
+case "${confirm}" in
+	y|Y)
+		;;
+	*)
+		echo "Release cancelled."
+		exit 1
+		;;
+esac
+
 git checkout "${TAGBRANCH}"
-git merge "${CURRENTBRANCH}"
+CURRENTBRANCH="${TAGBRANCH}"
+git merge "${ORIGBRANCH}"
 git push
-git tag -a "${VERSION}" -m "${MESSAGE}"
+git tag -a "${release_tag}" -m "Release ${release_tag}"
 git push --tags
-git checkout "${CURRENTBRANCH}"
+
+echo "Created release tag ${release_tag}"

mtm-ddwipe

@@ -2,23 +2,38 @@
 
 declare -r DEV="${1}"
 declare STARTDATE=""
+declare STARTDATESTRING=""
 
 show_help() {
-	echo "ddwipe dev (/dev/sdX)"
+	echo "Usage: mtm-ddwipe DEVICE"
 	echo ""
+	echo "Wipe a block device."
 	echo "Version: 0.0.3"
 }
 
 check_args() {
-	if [ "${1}" == "" ]; then
+	case "${1}" in
+		-h|--help)
+			show_help
+			exit 0
+			;;
+		"")
 			show_help
 			exit 1
-	fi
+			;;
+	esac
 }
 
 check_dev_exist() {
 	if [ ! -e "${1}" ]; then
-		echo "${1} is missing."
+		echo "Missing device."
+		exit 1
+	fi
+}
+
+check_dev_block() {
+	if [ ! -b "${1}" ]; then
+		echo "Not a block device."
 		exit 1
 	fi
 }
@@ -37,11 +52,12 @@ confirm_wipe() {
 }
 
 wipe_dev() {
-	STARTDATE="$(date)"
+	STARTDATE=$(date +%s)
+	STARTDATESTRING="$(date)"
 	echo "Begin wiping device ${1}"
 	echo ""
 	echo "Start date :"
-	echo "${STARTDATE}"
+	echo "${STARTDATESTRING}"
 	echo ""
 	echo "blkdiscard secure"
 	if ! blkdiscard -f -p 500M -s -v "${1}"; then
@@ -61,13 +77,13 @@ wipe_dev() {
 		fi
 	fi
 	echo ""
-	echo "Device ${1} wipped !"
+	echo "Device ${1} wiped."
 }
 
 print_time() {
 	echo ""
 	echo "Start date :"
-	echo "${STARTDATE}"
+	echo "${STARTDATESTRING}"
 	
 	ENDDATE=$(date +%s)
 	echo ""
@@ -82,7 +98,7 @@ print_time() {
 
 check_args "${DEV}"
 check_dev_exist "${DEV}"
+check_dev_block "${DEV}"
 confirm_wipe "${DEV}"
-STARTDATE=$(date +%s)
 wipe_dev "${DEV}"
 print_time