nself cli v0.4.1

[acamarata]

nself v0.4.1

Patch release focused on fixing cross-platform shell incompatibilities discovered after v0.4.0, primarily affecting macOS (BSD tools, Bash 3.2).

This release removes multiple GNU-only assumptions and hardens nself for consistent behavior across macOS and Linux.

---

Fixed

Shell & Tooling Compatibility

Issue	Impact	Resolution
Bash 4+ array syntax in start.sh	Fails on macOS Bash 3.2	Replaced declare -a with POSIX-compatible syntax
sed -i behavior differences	Config updates fail on macOS	Introduced safe_sed_inline() wrapper
stat command syntax	File checks break across platforms	Added safe_stat_mtime() and safe_stat_perms()
Missing timeout on macOS	Commands hang or fail	Added safe_timeout() with gtimeout fallback
Non-portable echo -e	Output formatting inconsistent	Replaced with printf

---

Files Updated

Bash Array Fix

• src/cli/start.sh

sed Compatibility

• src/cli/admin.sh
• src/cli/deploy.sh
• src/lib/init/wizard/templates.sh
• src/lib/autofix/pre-checks.sh

stat Compatibility

• src/lib/monitoring/alerting.sh

timeout Compatibility

• src/cli/restart.sh
• src/cli/status.sh
• src/services/docker/compose-generate.sh
• src/services/docker/compose-generate-new.sh
• src/lib/autofix/pre-checks.sh
• src/lib/services/routes-display.sh

echo → printf

• src/cli/stop.sh
• install.sh

---

Platform Utilities

All compatibility logic is centralized in:

src/lib/utils/platform-compat.sh

Available helpers:

Function	Purpose
safe_sed_inline()	Cross-platform in-place sed
safe_stat_mtime()	File modification time
safe_stat_perms()	File permission lookup
safe_timeout()	Timeout with macOS fallback
safe_readlink()	Portable symlink resolution

---

Upgrade

nself update

or manually:

git pull origin main

No breaking changes. Fully backward-compatible with v0.4.0.

---

Tested

• Ubuntu 22.04 (Bash 5.1, GNU coreutils)
• macOS (Bash 3.2, BSD tools)
• CI pipeline (12/12 passing)

---

Install

curl -sSL https://install.nself.org | bash

Homebrew:

brew tap acamarata/nself
brew install nself

npm:

npm install -g @nself/cli

---

See CHANGELOG.md for full history.

---

This discussion was created from the release nself cli v0.4.1.