Do not prune after a backup that found a configured path empty (closes #388)

snapshot create --prune of a snapshot whose path was an empty
directory, as the mount point of a volume that is not mounted is,
recorded an empty snapshot and then purged the older snapshots that
held the data, with their blobs.

The scan now counts the entries it finds in each configured path.
Under --prune, a run in which a path of a snapshot it made held
nothing skips the prune, keeps every older snapshot, names each such
path with its snapshot, and exits non-zero, as
#382 does for unreadable
files. A configured path that is a symlink whose target is gone fails
the run. Only the current run is looked at. Without --prune nothing
changes.

Model: opus-5-5

README.md

@@ -325,13 +325,13 @@ value where a list belongs or a word where a number belongs), is refused.
   `--skip-errors` skipped a file or directory it could not read or list, the
   prune does not run and every older snapshot is kept, since one of them may
   be the only one that holds what was skipped; the command says so and exits
-  non-zero. When the backup found nothing in a configured path, as in the
+  non-zero. A file removed during the backup does not stop the prune. The
-  mount point of a volume that is not mounted, the prune does not run
+  same holds when the backup found nothing in a configured path, as in the
-  either: every older snapshot is kept, and the command names the path and
+  mount point of a volume that is not mounted: the prune does not run, every
-  exits non-zero, on every run until the path holds something again. Take a
+  older snapshot is kept, and the command names the path and exits non-zero,
-  path that is empty on purpose out of the config, or remove the older
+  on every run until the path holds something again. Take a path that is
-  snapshots by hand with `snapshot purge`. A file removed during the backup
+  empty on purpose out of the config, or remove the older snapshots by hand
-  does not stop the prune.
+  with `snapshot purge`.
 * `--keep-newer-than <duration>`: With `--prune`, keep snapshots newer than
   this duration instead of only the latest (e.g. `4w`, `30d`, `6mo`, `1y`).
   Without `--prune`, or with a value that is not a valid duration, the

TODO.md

@@ -29,8 +29,7 @@ owner's; a `v*` tag runs the release build in
   ([issue #388](https://git.eeqj.de/sneak/vaultik/issues/388)), as in
   the mount point of a volume that is not mounted. Such a prune could
   delete every snapshot still holding that path's files. A configured
-  path that is a symlink whose target is gone, as one into such a
+  path that is a symlink into such a volume now fails the backup.
-  volume, now fails the backup, with or without `--prune`.
 
 - 2026-10-14: Stopped `snapshot create --prune` pruning after a backup
   that skipped files it could not read

internal/snapshot/scanner.go

@@ -169,10 +169,10 @@ type ScanResult struct {
 	// removed after the walk listed them.
 	FilesUnreadable int
 
-	// EntriesFound counts the entries the walk found and could look up
+	// EntriesFound counts the entries the walk found that no exclude
-	// that no exclude pattern matches, leaving out the scanned path
+	// pattern matches, leaving out the scanned path itself when it is a
-	// itself when it is a directory. It is zero for an empty directory,
+	// directory. It is zero for an empty directory, such as the mount
-	// such as the mount point of a volume that is not mounted.
+	// point of a volume that is not mounted.
 	EntriesFound int
 }
 

internal/vaultik/snapshot.go

@@ -48,8 +48,7 @@ var ErrFilesUnreadable = errors.New("file(s) could not be read")
 // prune because the scan found nothing in a configured path of a
 // snapshot, as in the mount point of a volume that is not mounted. The
 // snapshots are complete and kept, so the caller can report it apart
-// from a failed backup. A run that also skipped unreadable files
+// from a failed backup.
-// returns ErrFilesUnreadable instead.
 var ErrSourcePathEmpty = errors.New("source path(s) were empty")
 
 // listRecentLimit caps how many snapshot rows are fetched from the