v0.25: SIGTRAP crash opening Settings — assertionFailure in static NSBundle.module

[h3x89]

Description

After upgrading to v0.25 (build 60, commit 3e2545b2), opening Settings (or About) from the menu bar causes a reproducible EXC_BREAKPOINT / SIGTRAP crash. The app process terminates and the menu bar icon disappears.

Downgrading to v0.23 (build 58) resolves the issue immediately — no other changes needed (config preserved).

Environment

• macOS: 26.4.1 (arm64)
• CodexBar: 0.25 (build 60, 3e2545b2)
• Machine: Apple Silicon (M1)

Stack Trace (top frames)

EXC_BREAKPOINT (SIGTRAP)
_assertionFailure(_:_:file:line:flags:)
closure #1 in variable initialization expression of static NSBundle.module
one-time initialization function for module
_dispatch_once_callout
localizedBundle()
closure #1 in closure #1 in PreferencesView.body.getter
...
PreferencesView.body.getter
...
AppWindowsController.showSettingsWindow(namespace:)
OpenSettingsAction.callAsFunction()
closure #1 in closure #1 in HiddenWindowView.body.getter

Full crash reports (4 .ips files) available on request.

Analysis

The crash happens during lazy initialization of static NSBundle.module, triggered when localizedBundle() is called from PreferencesView.body.getter. This suggests the Swift Package Manager resource bundle accessor (Bundle.module) assertion-fails inside its dispatch_once initializer.

The issue appears related to the new localization additions in v0.25 (#819 — Simplified Chinese + in-app language selector). The localizedBundle() function is new in v0.25 and its first call triggers the Bundle.module initialization which fails.

Attempted Workarounds (unsuccessful)

1. defaults write com.steipete.codexbar AppleLanguages '("en")' — no effect
2. Removing zh-Hans.lproj from the app bundle (requires sudo + re-sign) — not tested fully

Notes

• v0.24 had a different issue (v0.24: Menu bar icon does not appear (process runs but icon is invisible) #861 — menu bar icon invisible)
• v0.23 is stable on the same machine with the same config
• Related: issue v0.25: Menu bar icon does not appear, CLI Operates #890 (menu bar icon reappearing in 0.25 for some users)

[coygeek]

Re-creatable on both of my macs

[h3x89]

Confirmed fixed in v0.25.1 — Settings and About open without crash on macOS 26.4.1 arm64. Thank you @lederniermagicien and @steipete for the quick fix!

[steipete]

Fixed and verified.

The shipped fix is in v0.25.1: Localization.swift now resolves the packaged CodexBar_CodexBar.bundle from the app resources before falling back to SwiftPM Bundle.module, so Settings/About no longer trip the static bundle assertion in a packaged app. Regression coverage is in Tests/CodexBarTests/LocalizationBundleTests.swift.

Proof checked:

• swift test --filter LocalizationBundleTests
• swift test --no-parallel --filter CLIEntryTests
• ./Scripts/lint.sh lint
• CI green on current main: https://github.com/steipete/CodexBar/actions/runs/25656641608

Also hardened the macOS CI shard runner while investigating: the Intel Actions runner hangs before output for the executable-target CLI suite, so that runner-only shard is skipped on macOS CI while the suite remains covered by Linux CI and local runs.

Thanks again for the clear crash report.