v0.83.86 retarget packaged release assets

Author: Autodidac

Changes/changelog.txt

@@ -1,6 +1,13 @@
 # Epoch Changelog
 
 ## [v0.83.86]
+- Switched the active packaged updater contract onto the new named runtime
+  assets `epoch_win10_x64.zip` and `epoch_linux_x64.tar.gz`, with
+  `version_windows.txt` and `version_linux.txt` as the packaged version probes.
+- Kept the updater flow binary-first while preparing the new two-drop release
+  protocol: a tiny bootstrap updater-shell release can move onto the newest
+  packaged runtime release first, then source only if packaged parity is
+  already reached.
 - Reopened `main` above the published `v0.83.85` release so the source tree,
   docs, and version metadata can move forward without pretending the live
   branch is still the shipped snapshot.

Changes/roadmap.md

@@ -419,8 +419,10 @@ These remain support-tier or project-opt-in work, not the default baseline.
 6. Keep multicontext/backend child-window ownership honest across all active
    backends.
 7. Align packaged Windows and Linux releases with the main runtime path by
-   default, keep updater-shell builds explicit/bootstrap-only, and keep all
-   packaged version lines tied to the same bumped source commit.
+   default, keep updater-shell builds explicit/bootstrap-only, keep packaged
+   updates ahead of source fallback, and move the runtime asset contract onto
+   `epoch_win10_x64.zip`, `epoch_linux_x64.tar.gz`, `version_windows.txt`, and
+   `version_linux.txt`.
 8. Keep the six-pane harness useful as an observation/capture tool, but repair
    it around live manual truth whenever synthetic input diverges from a clean
    human validation.
@@ -443,5 +445,8 @@ These remain support-tier or project-opt-in work, not the default baseline.
   report the same bumped version line as the tagged source snapshot, and keep
   updater-shell mode as an explicit bootstrap build instead of the default
   release identity.
+- The bootstrap updater checks the newest packaged runtime release first and
+  only falls through to source when packaged parity is already reached, using
+  the new named runtime assets instead of the older alias set.
 - The docs stay strong enough to steer future automated passes without needing
   to rediscover the architecture from scratch.

Engine/docs/build_scripts.md

@@ -155,16 +155,24 @@ Before publishing a Windows packaged runtime zip:
 - run `ConsoleApplication1.exe --version` from the staged folder before zipping
 - smoke the no-args packaged entry once before publishing so a release does not
   ship a dead startup path
+- name the runtime asset `epoch_win10_x64.zip`
+- publish `version_windows.txt` beside it
+- if the same release family also includes a bootstrap updater-shell drop, keep
+  that as a separate asset such as `epoch_updater_shell_only_win10_x64.zip`
+  instead of overloading the runtime package name
 
 Before publishing a Linux/WSL2 asset:
 
 - rebuild from the same bumped source commit that will be tagged
 - verify the Linux package reports the same version as the tag/source archive
-- keep the packaged `linux_main.tar.gz` and the GitHub source snapshot aligned
-  to the same commit, not just the same version string
+- keep the packaged `epoch_linux_x64.tar.gz` and the GitHub source snapshot
+  aligned to the same commit, not just the same version string
 - verify the packaged Linux artifact starts the main runtime path by default
   instead of accidentally shipping an updater-shell-only bootstrap
 - do not quietly reuse an older Linux artifact after source has changed
+- publish `version_linux.txt` beside the Linux runtime asset
+- keep any Linux bootstrap drop separate, for example
+  `epoch_updater_shell_only_linux_x64.tar.gz`
 
 ## Multicontext regression contract
 

Engine/docs/runtime_operations.md

@@ -20,6 +20,11 @@ the same engine-owned path.
 - packaged Linux releases should follow that same main-runtime rule: the normal
   packaged `epoch` entry is the product path, while updater-shell mode remains
   an explicit bootstrap build instead of the default Linux release identity
+- packaged updates stay binary-first: the updater shell should pull the newest
+  named runtime package first, and only continue to source when the packaged
+  runtime is already version-equal or newer
+- the active packaged asset contract is `epoch_win10_x64.zip`,
+  `epoch_linux_x64.tar.gz`, `version_windows.txt`, and `version_linux.txt`
 
 ## Project-driven runtime direction
 

Engine/modules/updater.config.ixx

@@ -62,6 +62,19 @@ namespace epochnamespace::updater
     export inline const std::string PROJECT_PACKAGED_VERSION =
         epochnamespace::GetPackagedVersionString();
 
+    export inline constexpr std::string_view WINDOWS_RUNTIME_BINARY_ASSET =
+        "epoch_win10_x64.zip";
+    export inline constexpr std::string_view LINUX_RUNTIME_BINARY_ASSET =
+        "epoch_linux_x64.tar.gz";
+    export inline constexpr std::string_view WINDOWS_BOOTSTRAP_BINARY_ASSET =
+        "epoch_updater_shell_only_win10_x64.zip";
+    export inline constexpr std::string_view LINUX_BOOTSTRAP_BINARY_ASSET =
+        "epoch_updater_shell_only_linux_x64.tar.gz";
+    export inline constexpr std::string_view WINDOWS_VERSION_ASSET =
+        "version_windows.txt";
+    export inline constexpr std::string_view LINUX_VERSION_ASSET =
+        "version_linux.txt";
+
     // ─────────────────────────────────────────
     // Runtime / source build metadata
     // ─────────────────────────────────────────
@@ -154,13 +167,13 @@ namespace epochnamespace::updater
         switch (platform::current_platform())
         {
         case platform::RuntimePlatform::Windows:
-            return { "windows_version.txt", "version.txt" };
+            return { std::string{ WINDOWS_VERSION_ASSET } };
         case platform::RuntimePlatform::Linux:
-            return { "linux_version.txt" };
+            return { std::string{ LINUX_VERSION_ASSET } };
         case platform::RuntimePlatform::MacOS:
             return { "macos_version.txt" };
         default:
-            return { "version.txt" };
+            return { std::string{ WINDOWS_VERSION_ASSET } };
         }
     }
 
@@ -169,13 +182,13 @@ namespace epochnamespace::updater
         switch (platform::current_platform())
         {
         case platform::RuntimePlatform::Windows:
-            return { "windows_main.zip", "main.zip" };
+            return { std::string{ WINDOWS_RUNTIME_BINARY_ASSET } };
         case platform::RuntimePlatform::Linux:
-            return { "linux_main.tar.gz" };
+            return { std::string{ LINUX_RUNTIME_BINARY_ASSET } };
         case platform::RuntimePlatform::MacOS:
             return { "macos_main.tar.gz" };
         default:
-            return { "main.zip" };
+            return { std::string{ WINDOWS_RUNTIME_BINARY_ASSET } };
         }
     }
 
@@ -184,13 +197,13 @@ namespace epochnamespace::updater
         switch (platform::current_platform())
         {
         case platform::RuntimePlatform::Windows:
-            return "version.txt";
+            return std::string{ WINDOWS_VERSION_ASSET };
         case platform::RuntimePlatform::Linux:
-            return "linux_version.txt";
+            return std::string{ LINUX_VERSION_ASSET };
         case platform::RuntimePlatform::MacOS:
             return "macos_version.txt";
         default:
-            return "version.txt";
+            return std::string{ WINDOWS_VERSION_ASSET };
         }
     }
 
@@ -199,13 +212,28 @@ namespace epochnamespace::updater
         switch (platform::current_platform())
         {
         case platform::RuntimePlatform::Windows:
-            return "main.zip";
+            return std::string{ WINDOWS_RUNTIME_BINARY_ASSET };
         case platform::RuntimePlatform::Linux:
-            return "linux_main.tar.gz";
+            return std::string{ LINUX_RUNTIME_BINARY_ASSET };
         case platform::RuntimePlatform::MacOS:
             return "macos_main.tar.gz";
         default:
-            return "main.zip";
+            return std::string{ WINDOWS_RUNTIME_BINARY_ASSET };
+        }
+    }
+
+    export inline std::string LATEST_BOOTSTRAP_BINARY_ASSET_NAME()
+    {
+        switch (platform::current_platform())
+        {
+        case platform::RuntimePlatform::Windows:
+            return std::string{ WINDOWS_BOOTSTRAP_BINARY_ASSET };
+        case platform::RuntimePlatform::Linux:
+            return std::string{ LINUX_BOOTSTRAP_BINARY_ASSET };
+        case platform::RuntimePlatform::MacOS:
+            return "epoch_updater_shell_only_macos_x64.tar.gz";
+        default:
+            return std::string{ WINDOWS_BOOTSTRAP_BINARY_ASSET };
         }
     }
 

README.md

@@ -129,6 +129,10 @@ WSL/Linux note:
 - The packaged Linux artifact should behave as the main runtime release by
   default. Updater-shell mode is an explicit bootstrap path, not the normal
   Linux packaged identity.
+- The active packaged-runtime contract is now the explicit named asset pair
+  `epoch_win10_x64.zip` and `epoch_linux_x64.tar.gz`, with
+  `version_windows.txt` and `version_linux.txt` used for packaged version
+  probes.
 
 ---
 
@@ -367,6 +371,10 @@ Highlights:
 - Linux packaged runtime guidance is aligned with the actual build defaults:
   the main packaged `epoch` runtime is the normal Linux product path, and
   updater-shell mode is an explicit bootstrap build only.
+- Release packaging is moving onto a clean two-drop protocol from current
+  source: a tiny bootstrap updater-shell release, then the lean runtime release
+  it updates into, both using the new canonical asset names instead of the old
+  `main.zip` / `linux_main.tar.gz` aliases.
 - The roadmap continues to center single-context editor OpenGL, single-context
   launcher software, deliberate backend switching, and teardown of inactive
   backends instead of leaving hidden renderers running in the background.