Cannot build from fresh clone — missing frameworks not available for download

[leonardschneider]

Problem

A fresh clone following the README build instructions fails because several frameworks are not included in downloadFrameworks.sh and are not available on any public GitHub release.

Steps to Reproduce

git clone --recursive https://github.com/holzschu/a-shell.git
cd a-shell
./downloadFrameworks.sh
# Open in Xcode, build any target → fails

Missing Frameworks

Not published anywhere

These are referenced in project.pbxproj but not defined in xcfs/Package.swift and not available on any GitHub release:

Framework	Expected path	Notes
pico.framework	xcfs/.build/artifacts/xcfs/pico.framework	Added in commit 0c85d84d (Oct 2022)
openrsync.framework	xcfs/.build/artifacts/xcfs/openrsync.framework	Added recently
openrsyncA.framework	xcfs/.build/artifacts/xcfs/openrsyncA.framework	Added recently
blink.xcframework	xcfs/.build/artifacts/xcfs/blink.xcframework	Deleted from repo in 853b6229 (Nov 2023) but still referenced in project

Not in download script

These exist on GitHub releases but aren't included in downloadFrameworks.sh or xcfs/Package.swift:

Framework	Available at	Expected path
ssh_cmdA	ios_system v3.0.5	xcfs/.build/artifacts/xcfs/ssh_cmdA/
ssh_agent	ios_system v3.0.5	xcfs/.build/artifacts/xcfs/ssh_agent/
libpng	Python-aux 1.0	cpython/Python-aux/libpng.xcframework

Path mismatch

freetype.xcframework and harfbuzz.xcframework are downloaded by SPM to xcfs/.build/artifacts/xcfs/ but the project expects them at cpython/Python-aux/.

Checksum mismatch

OpenSSL fails to download via SPM:

error: checksum of downloaded artifact of binary target 'openssl' (329e8317...)
does not match checksum specified by the manifest (421712e7...)

Python frameworks

pythonA.framework (at Resources_mini/Frameworks/) requires running the full CPython build (cpython/downloadAndCompile.sh) followed by updatePythonFiles.sh. This is documented but takes several hours.

Environment

• macOS 15, Apple Silicon
• Xcode 26.2
• Commit 9013425d on master

Suggestion

Would it be possible to either publish the missing frameworks (pico, openrsync) as GitHub release assets, or add them to xcfs/Package.swift so downloadFrameworks.sh fetches everything needed?

[holzschu]

Most of these missing frameworks have been fixed in the SwiftTerm2 branch (where the active development is ongoing). It will be fixed when the SwiftTerm2 branch is merged with the main branch.

The Python frameworks are a separate issue. Making them available for download would require a bandwidth of several GB. I'm not saying I won't do it, but it's not a small thing.