fix(cli): sanitize SwiftPM prebuilt paths

Metadata

Source

tuist/tuist #11194

Updated

Jun 24, 2026

Domains

Generated projects

Details

Resolves https://github.com/tuist/tuist/issues/YYY

This fixes two SwiftPM prebuilt integration issues that show up with precompiled SwiftSyntax packages:

Sanitizes control characters from paths decoded out of workspace-state.json before converting them to AbsolutePath or RelativePath.
Reuses the existing /private/var normalization through the same path sanitization boundary for dependency, artifact, prebuilt, checkout, and include paths.
Adds the prebuilt library directory to LD_RUNPATH_SEARCH_PATHS so macro executables can locate Swift compatibility dylibs such as libswiftCompatibilitySpan.dylib at runtime.
Covers both the path sanitization and runtime search path behavior in TuistLoaderTests.

How to test locally

tuist generate TuistLoaderTests --no-open
xcodebuild test -workspace Tuist.xcworkspace -scheme TuistUnitTests -only-testing TuistLoaderTests/SwiftPackageManagerGraphLoaderTests/load_whenWorkspaceStateContainsPrebuilts_sanitizesPathsAndPassesPackagePrebuiltsToMapper -only-testing TuistLoaderTests/PackageInfoMapperTests/map_whenMacroTargetDependsOnPrebuiltProduct_usesPrebuiltSettings CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY=""

Flights

Investigate, reproduce, or fix this item in an isolated repository. Each Flight preserves its outcome and agent session.

New Flights are paused Configure model inference, GitHub, and a sandbox provider to start another Flight. Existing results remain available below.

No Flights yet

Start a Flight and preserve its objective, outcome, and session here.

Comments

T

tuist[bot] Jun 9, 2026

🛠️ Tuist Run Report 🛠️

Tests 🧪

Scheme	Status	Cache hit rate	Tests	Skipped	Ran	Commit
TuistAcceptanceTests	❌	91 %	96	0	96	c83b3ab0a
TuistUnitTests	✅	0 %	609	39	570	5c39b00ea

Builds 🔨

Scheme	Status	Duration	Commit
TuistAcceptanceTests	✅	1m 5s	c83b3ab0a
TuistUnitTests	✅	4m 30s	5c39b00ea

TA

tuist-atlas[bot] Jun 21, 2026

SwiftPM prebuilt path sanitization is now available in 4.201.0-canary.19. This fixes issues with control characters and /private/var normalization in paths decoded from workspace-state.json, and adds prebuilt library directories to LD_RUNPATH_SEARCH_PATHS for macro executables. Update to 4.201.0-canary.19 to get this fix.