2026-5-6 13:36 Code check by Copilot on Github

Author: Tetsuya1126

README.md

@@ -221,6 +221,13 @@ If you find this project elsewhere, treat it as untrusted.
 
 ---
 
+## 📚 Documentation
+
+See Wiki for detailed usage (Keep on update):
+https://github.com/Tetsuya1126/raspi_overlay-auto-update/wiki
+
+---
+
 ## 🤝 Contributing
 
 Issues and Pull Requests are welcome.
@@ -246,3 +253,7 @@ MIT License
 Actively used in real-world deployments and maintained as needed.
 
 Reliable updates for read-only Raspberry Pi systems.
+
+---
+
+Keywords: Raspberry Pi OverlayFS auto update safe upgrade systemd.

libs/overlay_mode_change.sh

@@ -4,13 +4,13 @@
 
 overlay_on() {
   echo "[INFO] Turning overlay ON"
-  sudo "$OVERLAY_CMD" "$OVERLAY_SUBCMD" "$OVERLAY_OP" "$OVERLAY_TURN_ON" || return 1
+  "$OVERLAY_CMD" "$OVERLAY_SUBCMD" "$OVERLAY_OP" "$OVERLAY_TURN_ON" || return 1
   systemctl daemon-reload || return 1
 }
 
 overlay_off() {
   echo "[INFO] Turning overlay OFF"
-  sudo "$OVERLAY_CMD" "$OVERLAY_SUBCMD" "$OVERLAY_OP" "$OVERLAY_TURN_OFF" || return 1
+  "$OVERLAY_CMD" "$OVERLAY_SUBCMD" "$OVERLAY_OP" "$OVERLAY_TURN_OFF" || return 1
   systemctl daemon-reload || return 1
 }
 

modules/actions.sh

@@ -25,7 +25,7 @@ action_raspi_only() {
       done_after_maintenance
       ;;
     IDLE)
-      log_info "Run maintenance tasks. $ACTION"
+      log_info "Initial state detected. Running first maintenance. $ACTION"
       run_maintenance
       done_after_maintenance
       ;;
@@ -45,10 +45,14 @@ action_pc_only() {
   #export DRY=true
 
   case "$ACTION" in
-    DO_MAINTENANCE | MAINTENANCE_CONTINUE | IDLE)
+    DO_MAINTENANCE | MAINTENANCE_CONTINUE)
       log_info "Run maintenance tasks. $ACTION"
       run_maintenance
       ;;
+    IDLE)
+      log_info "Initial state detected. Running first maintenance. $ACTION"
+      run_maintenance
+      ;;
     NEED_OVERLAY_OFF | RESUME_TO_OVERLAY_OFF)
       log_info "Stay, Irregular $ACTION"
       ;;

modules/state_manager.sh

@@ -49,18 +49,23 @@ state_set() {
 }
 
 # --------------------------------------------
-# return 0 = cooldown elapsed (実行可能)
-# return 1 = still cooling down (まだ実行不可)
+# return 0 = still cooling down (まだ実行不可)
+# return 1 = cooldown elapsed (実行可能)
 # --------------------------------------------
-state_is_cooldown_elapsed() {
+is_cooldown_state() {
   local done_at="$1"
 
   # done_at が無い or 0 の場合は即 elapsed 判定
   if [[ -z "$done_at" || "$done_at" -le 0 ]]; then
-    return 0
+    return 1
   fi
 
-  [ -n "$done_at" ] && [ $(( $(date +%s) - done_at )) -lt "$COOLDOWN" ]
+  # クールダウン中ならアクティブ（return 0）
+  if [ $(( $(date +%s) - done_at )) -lt "$COOLDOWN" ]; then
+    return 0
+  else
+    return 1
+  fi
 }
 
 # ---- Decide action ----
@@ -89,7 +94,7 @@ state_decide_action() {
     # shellcheck disable=SC2153
     case "$state" in
       "$STATE_DONE")
-        if state_is_cooldown_elapsed "$done_at"; then
+        if is_cooldown_state "$done_at"; then
           echo "COOL_DOWN"
         else
           echo "NEED_OVERLAY_OFF"
@@ -109,7 +114,7 @@ state_decide_action() {
   else
     case "$state" in
       "$STATE_DONE")
-        if state_is_cooldown_elapsed "$done_at"; then
+        if is_cooldown_state "$done_at"; then
           echo "COOL_DOWN"
         else
           echo "DO_MAINTENANCE"