fix(install): grant the reaper traverse on the worlds root (#6)

Live drill found this: the reaper pod runs as uid 1000, k3s creates its
storage root /var/lib/rancher/k3s/storage 0700 root:root, so enabling
retention on a stock install made every archive fail
'lstat /worlds/<pvc>: permission denied' and skip the world (fail-closed,
but a silent no-op). bootstrap now grants traverse (setfacl u:1000:x,
else chmod o+x) when FELIS_WORLDS_HOST_PATH is set, the renderer's
precondition note names the requirement, and troubleshooting documents
both it and the multi-node nodeSelector fact.

Verified on the VM after granting the ACL: a 20d-idle world with a marker
file was archived into felis-backups (marker intact), its PVC and host
directory were reclaimed, world_backups got an inactive_15d row, and the
servers row/CR were retained.

deploy/bootstrap.sh

@@ -71,7 +71,9 @@
 #   FELIS_WORLDS_HOST_PATH node directory holding the world volumes (on the k3s this
 #                     installer provisions: /var/lib/rancher/k3s/storage). Setting it
 #                     enables the daily retention reaper, which archives and then deletes
-#                     worlds idle beyond the retention window (default: unset = no reaper)
+#                     worlds idle beyond the retention window, and grants the reaper's
+#                     uid (1000) traverse access to that root — k3s ships it 0700
+#                     root:root (default: unset = no reaper)
 #   PKG_LOCK_TIMEOUT seconds to wait for package-manager locks (default: 900)
 #   APT_LOCK_TIMEOUT legacy alias for PKG_LOCK_TIMEOUT
 set -Eeuo pipefail
@@ -2175,6 +2177,20 @@ deploy_bundle() {
   # always travels with it because it must equal the [archive] local_path written above.
   if [ -n "$FELIS_WORLDS_HOST_PATH" ]; then
     log "retention enabled: the daily reaper will read worlds from ${FELIS_WORLDS_HOST_PATH}"
+    # The reaper pod runs as the tree's non-root uid (1000, platform.workloads.nonRootUID)
+    # and must traverse into the per-volume directories under this root. k3s's own storage
+    # root ships 0700 root:root, so grant traverse — an ACL entry when the host has setfacl,
+    # otherwise the equivalent o+x. Traverse only: no listing either way, and the per-volume
+    # directories themselves are world-accessible (local-path creates them 0777).
+    if [ -d "$FELIS_WORLDS_HOST_PATH" ]; then
+      if command -v setfacl >/dev/null 2>&1; then
+        setfacl -m u:1000:x "$FELIS_WORLDS_HOST_PATH" || chmod o+x "$FELIS_WORLDS_HOST_PATH"
+      else
+        chmod o+x "$FELIS_WORLDS_HOST_PATH"
+      fi
+    else
+      warn "worlds root ${FELIS_WORLDS_HOST_PATH} does not exist yet; the reaper CronJob cannot start until it does (hostPath type Directory)"
+    fi
     manifest_args+=(--worlds-host-path "$FELIS_WORLDS_HOST_PATH" --archive-local-path "$FELIS_ARCHIVE_LOCAL_PATH")
   fi
   "$HOST_BIN" manifests "${manifest_args[@]}" | kube apply -f -

deploy/bootstrap_test.sh

@@ -579,9 +579,9 @@ expect "a failed fetch into an existing checkout names the token" "set FELIS_GIT
 # honest 503), and FELIS_WORLDS_HOST_PATH must turn into the reaper's two flags or an
 # operator's retention enablement silently renders no CronJob. Extracted, not retyped.
 
-mblock="$(awk '/^  local -a manifest_args=\(/,/kube apply -f -/' "$BS")"
+mblock="$(awk '/^  log "rendering \+ applying the control-plane bundle"/,/kube apply -f -/' "$BS")"
 [ -n "$mblock" ] || { echo "FAIL: no manifest_args block found in $BS"; exit 1; }
-[ "$(printf '%s\n' "$mblock" | wc -l)" -lt 30 ] \
+[ "$(printf '%s\n' "$mblock" | wc -l)" -lt 40 ] \
   || { echo "FAIL: the extracted block is not the manifest_args block -- did it move?"; exit 1; }
 
 run_bundle_flags() { # backup-pvc worlds-host-path
@@ -589,8 +589,10 @@ run_bundle_flags() { # backup-pvc worlds-host-path
   FELIS_BACKUP_PVC="$1" FELIS_WORLDS_HOST_PATH="$2" FELIS_ARCHIVE_LOCAL_PATH=/var/lib/felis/archives \
   HOST_BIN=myManifests bash -c '
     log() { :; }
+    warn() { printf "WARN: %s\n" "$*"; }
     kube() { cat; }
     myManifests() { printf "%s\n" "$@"; }
+    setfacl() { printf "SETFACL %s\n" "$*"; }
     run_bundle() {
     '"$mblock"'
     }
@@ -612,6 +614,13 @@ expect "enabling retention passes the worlds root" "--worlds-host-path
 /var/lib/rancher/k3s/storage" "$out"
 expect "enabling retention passes the archive mount that must match felis.toml" "--archive-local-path
 /var/lib/felis/archives" "$out"
+expect "a missing worlds root is warned about, not silently skipped" "WARN: worlds root /var/lib/rancher/k3s/storage does not exist yet" "$out"
+
+# The reaper pod is non-root (uid 1000) and k3s ships the storage root 0700 root:root, so
+# the installer must grant traverse or every archive dies with permission denied.
+wdir="$(mktemp -d)"
+out="$(run_bundle_flags felis-backups "$wdir")"
+expect "enabling retention grants the reaper uid traverse on the worlds root" "SETFACL -m u:1000:x $wdir" "$out"
 
 # ---------------------------------------------------------------------------------------
 if [ "$fails" -eq 0 ]; then