diff --git a/docs/platform-portability.md b/docs/platform-portability.md index 0e717bd..ca323a0 100644 --- a/docs/platform-portability.md +++ b/docs/platform-portability.md @@ -221,10 +221,12 @@ VM op 0x236 (non-modal) / op 0x20f (modal) / op 0x24d (green-mask transition) Everything before and after the selected decoder is portable. The replacement decision is an in-process FFmpeg backend behind a project-owned C ABI, not raw FFmpeg structs in Godot/C# and not a subprocess. FFmpeg -`n8.1.2-44-g7c533d0f86` is pinned by dated release URL, exact byte size, and SHA-256 in each target manifest under -`native/age_movie_ffmpeg/`. BtbN prunes older dated autobuild releases, so upstream availability is not permanent: -the current paired pin restores hosted builds, while a durable project-owned mirror remains necessary to prevent -future 404-driven repins. Changing either pin requires rerunning the full installed-movie gate. The shim +`n8.1.2-44-g7c533d0f86` is pinned by immutable project-mirror URL, exact byte size, and SHA-256 in each target +manifest under `native/age_movie_ffmpeg/`. The anonymously readable `conco/ome-ffmpeg-sdk` generic package on the +project Gitea server holds both platform archives under version `btbn-autobuild-2026-08-17-13-05`; each manifest +also retains the original BtbN release URL as provenance. This removes hosted builds from BtbN's dated-autobuild +retention window. Changing either pin requires a new immutable mirror version and a rerun of the complete +installed-movie gate. The shim dynamically links an LGPL build made without GPL or nonfree components and uses `libavformat`, `libavcodec`, `libavutil`, `libswscale`, and `libswresample`. Release artifacts must carry the matching FFmpeg source/configuration and notices required by FFmpeg's diff --git a/docs/tools-reference.md b/docs/tools-reference.md index 5f6b10d..e227c13 100644 --- a/docs/tools-reference.md +++ b/docs/tools-reference.md @@ -292,12 +292,14 @@ send either the `step-limit` console block or the generated JSON. ## Native FFmpeg movie shim (Windows and Linux x64) The target-specific dependency manifests pin dated LGPL shared FFmpeg archives by exact byte size and SHA-256. -BtbN prunes older dated autobuild releases, so the bytes are immutable while retained but their upstream URLs -are not permanent; a failed 404 requires a paired manifest repin and full native/movie validation, while a -project-owned durable mirror remains the long-term fix. Bootstrap downloads remove partial files on HTTP failure -before validating the complete archive. Windows development can use PowerShell/MSVC. Linux-hosted builds use Bash -with Python 3, curl, MinGW-w64/binutils for the Windows target, a native C compiler/binutils for Linux, and the -ordinary archive/core utilities available. +Their primary URLs use the anonymously readable, immutable `conco/ome-ffmpeg-sdk` generic package on the project +Gitea server; `upstream_url` records the original BtbN release location for provenance. BtbN prunes older dated +autobuild releases, so bootstraps do not depend on those upstream URLs remaining live. Uploading a different file +under an existing Gitea package version is forbidden; a dependency change requires a new version plus a paired +manifest update and full native/movie validation. Bootstrap downloads remove partial files on HTTP failure before +validating the complete archive. Windows development can use PowerShell/MSVC. Linux-hosted builds use Bash with +Python 3, curl, MinGW-w64/binutils for the Windows target, a native C compiler/binutils for Linux, and the ordinary +archive/core utilities available. | Tool | Purpose | Run | Reads → Writes | |---|---|---|---| diff --git a/native/age_movie_ffmpeg/dependency-linux-x64.json b/native/age_movie_ffmpeg/dependency-linux-x64.json index 6d13fb4..0720a23 100644 --- a/native/age_movie_ffmpeg/dependency-linux-x64.json +++ b/native/age_movie_ffmpeg/dependency-linux-x64.json @@ -1,8 +1,10 @@ { "provider": "BtbN/FFmpeg-Builds", "release_tag": "autobuild-2026-08-17-13-05", + "mirror_version": "btbn-autobuild-2026-08-17-13-05", "archive": "ffmpeg-n8.1.2-44-g7c533d0f86-linux64-lgpl-shared-8.1.tar.xz", - "url": "https://github.com/BtbN/FFmpeg-Builds/releases/download/autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-linux64-lgpl-shared-8.1.tar.xz", + "url": "https://git.orfl.xyz/api/packages/conco/generic/ome-ffmpeg-sdk/btbn-autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-linux64-lgpl-shared-8.1.tar.xz", + "upstream_url": "https://github.com/BtbN/FFmpeg-Builds/releases/download/autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-linux64-lgpl-shared-8.1.tar.xz", "size": 56931952, "sha256": "194dc8d525ac8cea5a5ff2e6fd44754747e69af5a766e7a6727cce363bd65de6", "ffmpeg_version": "n8.1.2-44-g7c533d0f86-20260817", diff --git a/native/age_movie_ffmpeg/dependency-win64.json b/native/age_movie_ffmpeg/dependency-win64.json index 0d4dbba..42301da 100644 --- a/native/age_movie_ffmpeg/dependency-win64.json +++ b/native/age_movie_ffmpeg/dependency-win64.json @@ -1,8 +1,10 @@ { "provider": "BtbN/FFmpeg-Builds", "release_tag": "autobuild-2026-08-17-13-05", + "mirror_version": "btbn-autobuild-2026-08-17-13-05", "archive": "ffmpeg-n8.1.2-44-g7c533d0f86-win64-lgpl-shared-8.1.zip", - "url": "https://github.com/BtbN/FFmpeg-Builds/releases/download/autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-win64-lgpl-shared-8.1.zip", + "url": "https://git.orfl.xyz/api/packages/conco/generic/ome-ffmpeg-sdk/btbn-autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-win64-lgpl-shared-8.1.zip", + "upstream_url": "https://github.com/BtbN/FFmpeg-Builds/releases/download/autobuild-2026-08-17-13-05/ffmpeg-n8.1.2-44-g7c533d0f86-win64-lgpl-shared-8.1.zip", "size": 70837934, "sha256": "681b9ca6d8f9be1e01d8873ad16f8a632f8a22b9653f1044837de6d5979b0fd6", "ffmpeg_version": "n8.1.2-44-g7c533d0f86-20260817", diff --git a/tools/test_release_workflow.py b/tools/test_release_workflow.py index 6de595c..433279f 100755 --- a/tools/test_release_workflow.py +++ b/tools/test_release_workflow.py @@ -49,11 +49,25 @@ class ReleaseWorkflowTests(unittest.TestCase): json.loads(WINDOWS_FFMPEG_MANIFEST.read_text(encoding="utf-8")), ] self.assertEqual(1, len({manifest["release_tag"] for manifest in manifests})) + self.assertEqual(1, len({manifest["mirror_version"] for manifest in manifests})) for manifest in manifests: self.assertRegex(manifest["release_tag"], r"^autobuild-\d{4}-\d{2}-\d{2}-\d{2}-\d{2}$") self.assertNotEqual("latest", manifest["release_tag"]) - self.assertIn(f"/{manifest['release_tag']}/", manifest["url"]) + self.assertEqual(f"btbn-{manifest['release_tag']}", manifest["mirror_version"]) + self.assertTrue( + manifest["url"].startswith( + "https://git.orfl.xyz/api/packages/conco/generic/ome-ffmpeg-sdk/" + ) + ) + self.assertIn(f"/{manifest['mirror_version']}/", manifest["url"]) self.assertTrue(manifest["url"].endswith("/" + manifest["archive"])) + self.assertTrue( + manifest["upstream_url"].startswith( + "https://github.com/BtbN/FFmpeg-Builds/releases/download/" + ) + ) + self.assertIn(f"/{manifest['release_tag']}/", manifest["upstream_url"]) + self.assertTrue(manifest["upstream_url"].endswith("/" + manifest["archive"])) self.assertIn(manifest["ffmpeg_commit"], manifest["archive"]) self.assertGreater(manifest["size"], 50_000_000) self.assertRegex(manifest["sha256"], r"^[0-9a-f]{64}$")