vault-fuse-freshness
Audit and maintain S3->FUSE visibility freshness on Linux hosts that consume the wiki through an rclone mount.
When to use
- New host bring-up after
/vault-sync-install - Investigating stale directory listings on pvelxc/LXC hosts
- Verifying
--dir-cache-timeremains within the cross-device SLA envelope
What it does
- Detects a running
rclone mountprocess. - Audits effective
--dir-cache-timeagainst a threshold (default15m). - Optionally runs
rclone rc vfs/forget dir=<path>for targeted stale directory listings. - Runs bounded
rclone rc vfs/refresh recursive=true dir=/when RC is enabled. - Logs outcomes to
$(platform_log_dir)/wiki-fuse-refresh.log.
Guardrails
- Linux-focused workflow. On non-Linux hosts, it exits with a skip message.
- Does not modify mount unit files; it validates runtime behavior and refreshes the VFS view.
- If
--dir-cache-timeexceeds threshold, returns non-zero so automation can flag drift. vfs/forgetusesdir=<path>orfile=<path>keys. Do not passrecursive=truetovfs/forget; recursive refresh is only forvfs/refresh.- RC calls are wrapped with
timeout; override withVS_FUSE_RC_TIMEOUT_SECONDS=<seconds>when needed.
Execution
# Companion script (interactive)
bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh --check-only
bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh --max-dir-cache 10m
bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh --forget-dir _archive
bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh --dry-run
# Companion script (headless / CI)
VS_FUSE_CHECK_ONLY=1 VS_FUSE_MAX_DIR_CACHE=15m bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh
VS_FUSE_FORGET_DIRS="_archive raw" VS_FUSE_RC_TIMEOUT_SECONDS=60 bash packages/vault-sync/skills/vault-fuse-freshness/fuse-freshness.sh