#!/bin/bash # backup-to-drive.sh — copy the checklist's nightly backups off the NAS into Google Drive. # # WHY THIS EXISTS # The NAS writes data/backups/checklists-.json every night at 03:30 and keeps 30. # That is a good backup of the data and a poor backup of the building: if the NAS dies, # every one of those 30 files dies with it. The Google Drive folder was meant to be the # off-site copy, but it was hand-made — and on 2026-09-16 it was discovered to have # stopped in July, ten weeks earlier, with nobody noticing. This closes that loop. # # Run by a LaunchAgent at 04:15 daily (after the NAS job). Also safe to run by hand. # # WHAT IT DOES NOT DO # It never writes to the NAS and never deletes anything there. The only thing it removes # is old copies in Drive beyond KEEP, and only ones matching the backup naming pattern. set -uo pipefail ROOT="$(cd "$(dirname "$0")" && pwd)" REMOTE_DIR="/volume2/docker/recurring-checklist/data/backups" NAS_HOST="10.1.1.5" NAS_USER="Christian" LOG="$HOME/Library/Logs/checklist-drive-backup.log" MAX_PER_RUN=10 # so a first run with a big gap can't hang for ages; it catches up next time STALE_DAYS=2 # newest off-site copy older than this => alert, even on a "clean" run mkdir -p "$(dirname "$LOG")" log() { printf '%s %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$*" >> "$LOG"; } say() { log "$*"; echo "$*"; } # Send an email and stop. The log alone was never enough: this script was written in # September 2026 precisely because the Drive copies had gone ten weeks stale unnoticed — # and then it failed silently for another nine days itself, because a wrong path only ever # printed into a logfile. A failure that nobody is told about is the same as no backup. # A failed alert must not mask the original problem, so alert.js's own exit code is ignored. alert() { say "$1" [ -n "${2:-}" ] && say "$2" node "$ROOT/scripts/alert.js" "Checklist off-site backup: $1" "${2:-}$(printf '\n\nLog: %s' "$LOG")" >> "$LOG" 2>&1 || \ log " (could not send the alert email — see above)" } die() { alert "$1" "${2:-}"; exit 1; } say "── run start ──" # Where Drive is mounted is not stable, and getting it wrong is silent: the guard below # just exits, so a stale path looks exactly like a healthy no-op from the outside. Two # things have moved since this was written — the folder lost its "Backups" level, and the # laptop mounts christian@ where the Studio mounts media@ — so probe instead of hard-coding. DRIVE_DIR="" for acct in "$HOME/Library/CloudStorage"/GoogleDrive-*; do [ -d "$acct" ] || continue for sub in \ "Shared drives/Waters Creative/Apps/Checklist Backups" \ "Shared drives/Waters Creative/Apps/Backups/Checklist Backups"; do if [ -d "$acct/$sub" ]; then DRIVE_DIR="$acct/$sub"; break 2; fi done done # The SSH password comes from the login keychain — the same entry build-deploy.sh reads, so # there is still one copy of the credential to rotate, and it is not in the project at all. # Store it with: security add-generic-password -U -s checklist-nas -a Christian -w NAS_PASS="${NAS_PASS:-$(security find-generic-password -s checklist-nas -a Christian -w 2>/dev/null || true)}" if [ -z "$NAS_PASS" ]; then die "no NAS password in the keychain" \ "Store it with: security add-generic-password -U -s checklist-nas -a Christian -w" fi # Google Drive streams files on demand; if the app is signed out or not running the path # simply is not there. Writing to a path Drive is not watching would look like it worked and # sync nothing, so refuse rather than pretend. if [ -z "$DRIVE_DIR" ]; then die "cannot find the Drive backup folder" \ "Looked under every ~/Library/CloudStorage/GoogleDrive-* account for Shared drives/Waters Creative/Apps/Checklist Backups and found none. Is Google Drive for Desktop running and signed in, and does that folder still exist under that name?" fi say "Drive folder: $DRIVE_DIR" run_remote() { # $1 = remote command; prints stdout, strips the pty's CRs local cmd="$1" expect </dev/null | tr -d '\r' set timeout 240 log_user 1 spawn bash -c "ssh -o StrictHostKeyChecking=no -o ConnectTimeout=20 -o PreferredAuthentications=password -o PubkeyAuthentication=no -o NumberOfPasswordPrompts=1 $NAS_USER@$NAS_HOST \"$cmd\"" expect { -nocase "password:" { send "$NAS_PASS\r"; exp_continue } eof } EXP } # 1. What does the NAS have? REMOTE_LIST="$(run_remote "ls -1 $REMOTE_DIR/checklists-*.json 2>/dev/null | xargs -n1 basename" \ | grep -E '^checklists-[0-9]{4}-[0-9]{2}-[0-9]{2}\.json$' | sort)" if [ -z "$REMOTE_LIST" ]; then die "no backups found on the NAS, or SSH failed" \ "Expected $REMOTE_DIR/checklists-.json on $NAS_HOST. Either the NAS's own nightly job has stopped writing them, or this machine can no longer reach the NAS." fi say "NAS has $(echo "$REMOTE_LIST" | wc -l | tr -d ' ') backup(s)" # 2. Which are missing from Drive? MISSING="" while IFS= read -r f; do [ -s "$DRIVE_DIR/$f" ] || MISSING="$MISSING$f"$'\n' done <<< "$REMOTE_LIST" MISSING="$(printf '%s' "$MISSING" | sed '/^$/d')" if [ -z "$MISSING" ]; then say "✓ Drive already has every NAS backup — nothing to do" else FAILED=0 COUNT="$(echo "$MISSING" | wc -l | tr -d ' ')" say "$COUNT missing from Drive; copying up to $MAX_PER_RUN" n=0 while IFS= read -r f; do [ -z "$f" ] && continue n=$((n+1)); [ $n -gt $MAX_PER_RUN ] && { say "· stopping at $MAX_PER_RUN this run"; break; } TMP="$(mktemp -t checklist-backup)"; OUT="$(mktemp -t checklist-backup-json)" run_remote "cat $REMOTE_DIR/$f" > "$TMP" # expect echoes its own `spawn …` banner and the password prompt onto stdout before the # file's contents, so the capture is never pure JSON. Slice from the first { to the last } # and only then validate — a truncated or half-read file that *looks* like a backup is # worse than an obviously missing one. if node -e ' const fs=require("fs"); const t=fs.readFileSync(process.argv[1],"utf8"); const a=t.indexOf("{"), b=t.lastIndexOf("}"); if(a<0||b<=a) process.exit(1); const j=JSON.parse(t.slice(a,b+1)); // throws => exit non-zero if(!Array.isArray(j.lists)) process.exit(1); // shape check, not just valid JSON fs.writeFileSync(process.argv[2], JSON.stringify(j)); ' "$TMP" "$OUT" 2>/dev/null; then mv "$OUT" "$DRIVE_DIR/$f"; rm -f "$TMP" say " ✓ $f ($(du -k "$DRIVE_DIR/$f" | cut -f1) KB)" else rm -f "$TMP" "$OUT" FAILED=$((FAILED+1)) say " ✗ $f — no valid checklist JSON in the response, skipped" fi done <<< "$MISSING" fi # 3. Report only. This script DELIBERATELY DELETES NOTHING in Drive. # # An earlier version trimmed Drive to the newest 30 to mirror the NAS, and promptly destroyed # the June snapshots — which existed ONLY in Drive, because the NAS had already rotated them # out. That is backwards: the whole value of the off-site copy is that it outlives the NAS's # 30-day window. Each file is ~260 KB, so a decade of them is under a gigabyte. If it ever # genuinely needs trimming, do it by hand, and never below what the NAS still holds. cd "$DRIVE_DIR" || die "cannot enter $DRIVE_DIR" TOTAL="$(ls -1 checklists-????-??-??.json 2>/dev/null | wc -l | tr -d ' ')" OLDEST="$(ls -1 checklists-????-??-??.json 2>/dev/null | sort | head -1)" NEWEST="$(ls -1 checklists-????-??-??.json 2>/dev/null | sort | tail -1)" say "✓ done — $TOTAL copies off-site, ${OLDEST:-none} → ${NEWEST:-none}" # Some files were fetched but were not usable. The run "succeeded" in the sense that it did # not crash, which is exactly the kind of success that hides a broken backup. if [ "${FAILED:-0}" -gt 0 ]; then alert "$FAILED backup file(s) could not be copied" \ "The run finished, but $FAILED file(s) came back without valid checklist JSON and were skipped. See the log for which ones." fi # The staleness check is the one that would have caught both of the incidents in the header # comment. Every failure path above assumes this script RAN; if the Mac is asleep, or the # LaunchAgent is unloaded, nothing above ever fires. This at least turns a quietly ageing # off-site copy into mail the next time it does run. if [ -z "$NEWEST" ]; then alert "no off-site copies at all" "$DRIVE_DIR contains no checklists-.json files." else NEWEST_DATE="$(printf '%s' "$NEWEST" | sed -E 's/^checklists-([0-9]{4}-[0-9]{2}-[0-9]{2})\.json$/\1/')" NEWEST_EPOCH="$(date -j -f "%Y-%m-%d" "$NEWEST_DATE" +%s 2>/dev/null || echo 0)" if [ "$NEWEST_EPOCH" -gt 0 ]; then AGE_DAYS=$(( ( $(date +%s) - NEWEST_EPOCH ) / 86400 )) if [ "$AGE_DAYS" -gt "$STALE_DAYS" ]; then alert "off-site copy is $AGE_DAYS days old" \ "Newest file off-site is $NEWEST ($AGE_DAYS days old); anything more than $STALE_DAYS days means the chain from the NAS to Drive is not working, even though this run did not error." else say "freshness OK — newest off-site copy is $AGE_DAYS day(s) old" fi fi fi