chore(deps): upgrade libpiper (piper1-gpl) to v1.8.0 and fix the musl build

.github/workflows/ci.yml

@@ -121,7 +121,7 @@ jobs:
         path: |
           piper1-gpl/libpiper/build/libpiper.so
           piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/lib/libonnxruntime.so
-          piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/espeak-ng-data
+          piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/share/espeak-ng-data
         retention-days: 7
 
 
@@ -131,12 +131,12 @@ jobs:
     needs: changes
     if: needs.changes.outputs.code == 'true'
     runs-on: ubuntu-latest
-    container: alpine:3.18
+    container: alpine:3.23
 
     steps:
     - name: Install git and build dependencies
       run: |
-        apk add --no-cache cmake build-base git linux-headers pkgconfig
+        apk add --no-cache cmake build-base git linux-headers pkgconfig onnxruntime-dev
 
     - uses: actions/checkout@v7
       with:
@@ -175,7 +175,7 @@ jobs:
         mkdir -p libs
         cp piper1-gpl/libpiper/build/libpiper.so libs/
         cp piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/lib/libonnxruntime.so* libs/
-        cp -r piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/espeak-ng-data libs/
+        cp -r piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/share/espeak-ng-data libs/
 
     - name: Cache voice model
       uses: actions/cache@v6

.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
       run: |
         tar -czf libpiper-linux-x86_64.tar.gz -C piper1-gpl/libpiper/build libpiper.so
         mkdir -p /tmp/onnx && find piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/lib -name "libonnxruntime*.so*" -exec cp -P {} /tmp/onnx/ \; && tar -czf libonnxruntime-linux-x86_64.tar.gz -C /tmp/onnx .
-        tar -czf espeak-ng-data.tar.gz -C piper1-gpl/libpiper/build/piper1-gpl/libpiper/install espeak-ng-data
+        tar -czf espeak-ng-data.tar.gz -C piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/share espeak-ng-data
 
     - name: Upload packaged artifacts
       uses: actions/upload-artifact@v7
@@ -58,12 +58,12 @@ jobs:
 
   build-piper-musl:
     runs-on: ubuntu-latest
-    container: alpine:3.18
+    container: alpine:3.23
 
     steps:
     - name: Install git and build dependencies
       run: |
-        apk add --no-cache cmake build-base git linux-headers pkgconfig
+        apk add --no-cache cmake build-base git linux-headers pkgconfig onnxruntime-dev
 
     - uses: actions/checkout@v7
       with:
@@ -75,20 +75,20 @@ jobs:
     - name: Strip debug symbols
       run: |
         strip --strip-debug piper1-gpl/libpiper/build/libpiper.so
-        find piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/lib -name "libonnxruntime.so.*" -type f -exec strip --strip-debug {} + 2>/dev/null || true
 
     - name: Package build artifacts
       run: |
+        # The prebuilt ONNX Runtime that libpiper downloads is glibc-only, so this job links
+        # the Alpine package (onnxruntime-dev). It is not shipped: Alpine users install it with
+        # `apk add onnxruntime-dev`. The espeak-ng data is the same for glibc and musl.
         tar -czf libpiper-linux-musl-x86_64.tar.gz -C piper1-gpl/libpiper/build libpiper.so
-        mkdir -p /tmp/onnx && find piper1-gpl/libpiper/build/piper1-gpl/libpiper/install/lib -name "libonnxruntime*.so*" -exec cp -P {} /tmp/onnx/ \; && tar -czf libonnxruntime-linux-musl-x86_64.tar.gz -C /tmp/onnx .
 
     - name: Upload packaged artifacts
       uses: actions/upload-artifact@v7
       with:
         name: piper-release-musl
         path: |
           libpiper-linux-musl-x86_64.tar.gz
-          libonnxruntime-linux-musl-x86_64.tar.gz
         retention-days: 7
 
   publish:

AGENTS.md

@@ -73,7 +73,7 @@ are not part of it.
 `test-integration` run only for code changes. `ci-ok` aggregates the results and is the check to require.
 
 Tag pushes (`v*`) run `.github/workflows/release.yml`: it builds libpiper for glibc and musl,
-packages the five archives that `piper-tts install-deps` downloads, and creates the GitHub
+packages the four archives (`piper-tts install-deps` downloads the three glibc ones), and creates the GitHub
 Release from the `CHANGELOG.md` section.
 
 ## License

CHANGELOG.md

@@ -6,6 +6,21 @@ All notable changes to this project are documented here, following
 
 ## [Unreleased]
 
+### Changed
+
+- libpiper (the `piper1-gpl` submodule) is upgraded from v1.4.1 to v1.8.0 (ONNX Runtime stays at
+  1.22.0 for glibc). The `piper.h` changes are additive (`piper_create_with_options`,
+  `piper_version`, `EXPORT_SYMBOL`), so the FFI definitions and the public PHP API are
+  unchanged. Closes #21; replaces Dependabot PR #3.
+- The musl build (CI and release) runs in `alpine:3.23` and links the Alpine `onnxruntime` package
+  (1.23.0) instead of the prebuilt glibc-only ONNX Runtime, which no longer links on musl since
+  libpiper builds the `piper` executable too. Because that package is not ours to redistribute with
+  its dependencies, the release no longer has `libonnxruntime-linux-musl-x86_64.tar.gz` (it held a
+  glibc library that cannot be loaded on musl). On Alpine run `apk add onnxruntime-dev` and use
+  `libpiper-linux-musl-x86_64.tar.gz` with `espeak-ng-data.tar.gz`. The glibc assets are unchanged.
+- libpiper now installs the espeak-ng data to `share/espeak-ng-data` instead of `espeak-ng-data`;
+  `make build-libs`, CI and the release workflow use the new path.
+
 ## [0.2.0] - 2026-10-02
 
 ### Added

Makefile

@@ -31,7 +31,7 @@ build-libs: build-libpiper
 	mkdir -p $(LIBS_DIR)
 	cp $(LIBPIPER_BUILD_DIR)/libpiper.so $(LIBS_DIR)/
 	cp $(LIBPIPER_INSTALL_DIR)/lib/libonnxruntime.so* $(LIBS_DIR)/ 2>/dev/null || cp $(LIBPIPER_INSTALL_DIR)/lib/libonnxruntime*.so* $(LIBS_DIR)/
-	cp -r $(LIBPIPER_INSTALL_DIR)/espeak-ng-data $(LIBS_DIR)/
+	cp -r $(LIBPIPER_INSTALL_DIR)/share/espeak-ng-data $(LIBS_DIR)/
 	@echo "Libraries ready in $(LIBS_DIR)/"
 	@echo "  - libpiper.so"
 	@echo "  - libonnxruntime.so (and versioned files)"

README.md

@@ -52,6 +52,11 @@ tar -xzf libonnxruntime-linux-x86_64.tar.gz
 tar -xzf espeak-ng-data.tar.gz
 ```
 
+On Alpine Linux (musl) use `libpiper-linux-musl-x86_64.tar.gz` instead of the two glibc
+libpiper and ONNX Runtime archives, together with `espeak-ng-data.tar.gz`. Install ONNX Runtime
+from the Alpine package: `apk add onnxruntime-dev` (the musl build of libpiper is linked
+against it).
+
 ### Building from Source
 
 If you prefer to build from source or need a different architecture:

docs/release-workflow.md

@@ -63,15 +63,14 @@ file from the **tagged commit**, so the release PR with the `## [X.Y.Z]` section
 must be **merged before** you tag.
 
 The workflow builds libpiper from the `piper1-gpl` submodule on Linux (glibc on
-`ubuntu-latest`, musl in an `alpine:3.18` container) and packages five archives:
+`ubuntu-latest`, musl in an `alpine:3.23` container) and packages four archives:
 
 | Asset | Content |
 |---|---|
 | `libpiper-linux-x86_64.tar.gz` | `libpiper.so` (glibc) |
 | `libonnxruntime-linux-x86_64.tar.gz` | ONNX Runtime shared libraries (glibc) |
-| `espeak-ng-data.tar.gz` | espeak-ng phoneme data |
+| `espeak-ng-data.tar.gz` | espeak-ng phoneme data (glibc and musl) |
 | `libpiper-linux-musl-x86_64.tar.gz` | `libpiper.so` (musl) |
-| `libonnxruntime-linux-musl-x86_64.tar.gz` | ONNX Runtime shared libraries (musl) |
 
 It then creates the GitHub Release with `gh release create --verify-tag`, using the
 notes from the matching `CHANGELOG.md` section, and attaches the archives. It fails
@@ -116,5 +115,5 @@ Make sure the next milestone `vX.Y.(Z+1)` (or the next minor) exists.
 - [ ] CHANGELOG section `[X.Y.Z] - date` written, `[Unreleased]` is empty
 - [ ] Release PR merged
 - [ ] Annotated tag `vX.Y.Z` pushed
-- [ ] GitHub Release exists with the CHANGELOG notes and the five libpiper/ONNX Runtime/espeak-ng archives
+- [ ] GitHub Release exists with the CHANGELOG notes and the four libpiper/ONNX Runtime/espeak-ng archives
 - [ ] Milestone closed, next milestone exists