Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

fix(website): installers tolerate AppleDouble sidecars in web.tar.gz

Salman Qureshibcdbba24eb3d
diff --git a/docs/install-dev.ps1 b/docs/install-dev.ps1
old mode 100644
new mode 100755
diff --git a/docs/install.ps1 b/docs/install.ps1
old mode 100644
new mode 100755
index 4d8e99f7..e72a353f
--- a/docs/install.ps1
+++ b/docs/install.ps1
@@ -162,7 +162,10 @@ try {
$archiveEntries = @(tar -tzf $webTmp)
if ($LASTEXITCODE -ne 0) { Die 'Failed to inspect web.tar.gz' }
foreach ($entry in $archiveEntries) {
- if ($entry -notmatch '^web(/|$)' -or $entry -match '(^|/)\.\.(/|$)') {
+ # AppleDouble sidecars (._*, macOS tar's xattr artifact — invisible to
+ # bsdtar, listed by GNU tar) are inert; the extraction stage discards
+ # them. Traversal attempts stay fatal.
+ if (($entry -notmatch '^web(/|$)' -and $entry -notmatch '^\._') -or $entry -match '(^|/)\.\.(/|$)') {
Die "web.tar.gz contains an unsafe path: $entry"
}
}
diff --git a/docs/install.sh b/docs/install.sh
old mode 100644
new mode 100755
index 299ac5cd..8a9a0df7
--- a/docs/install.sh
+++ b/docs/install.sh
@@ -216,7 +216,12 @@ Install the supported Node.js package instead:
info "Checksums verified (sha256)"
tar -tzf "$web_tmp" > "$tmp_dir/web-files.txt" || die "Failed to inspect web.tar.gz"
- awk '$0 !~ /^web(\/|$)/ || $0 ~ /(^|\/)\.\.(\/|$)/ { bad=1 } END { exit bad }' \
+ # Safe = the `web/` tree itself. AppleDouble sidecars (`._web` — macOS
+ # tar's xattr artifact, invisible to bsdtar but LISTED by GNU tar) are
+ # ignored, not rejected: they are inert files the extraction stage
+ # discards, and a hard reject bricked every Linux install of tarballs
+ # built before the COPYFILE_DISABLE fix (#122). Traversal stays fatal.
+ awk '$0 ~ /(^|\/)\.\.(\/|$)/ || ($0 !~ /^web(\/|$)/ && $0 !~ /^\._/) { bad=1 } END { exit bad }' \
"$tmp_dir/web-files.txt" || die "web.tar.gz contains an unsafe path"
mkdir -p "$stage_dir"
tar -xzf "$web_tmp" -C "$stage_dir" || die "Failed to extract web dashboard assets"