From 8f05d306b6e3c41aaeb04862d9b4da72ad787ed8 Mon Sep 17 00:00:00 2001
From: Sunrisepeak <speakshen@163.com>
Date: Sat, 7 Nov 2026 10:50:43 +0900
Subject: [PATCH] mcpplibs.os 0.3.1: a name in the long spelling is the name it
 spells

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
---
 CHANGELOG.md                |  3 +++
 pkgs/o/os.lua               | 21 +++++++++++++++++++++
 tests/examples/os/mcpp.toml |  2 +-
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index daa5db43..3e2f24d6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,9 @@
 
 ### Added
 
+- **mcpplibs.os 0.3.1.** A name in the long spelling (`\\?\C:\...`, `\\?\UNC\...`) is the name it spells: `locate` and
+  every `os::fs` operation through it accept what `fs::extended` produces, which 0.3.0 refused with `errc::invalid`; the
+  kernel layer is a compatible range. The test member `os` consumes 0.3.1 (it stayed on 0.2.9 when 0.3.0 was registered).
 - **The openkal 0.24.2 patch group: a leaf and a platform patch, as one change.** openkal-llvm-runtime 0.19.2 keeps the
   volume of a name it rebuilds part by part (`lexically_normal`, `weakly_canonical`, `D:/a` / `/b`), which 0.19.1 lost
   on Windows (openkal-llvm-runtime#68), and openkal-platform 0.24.2 names it; no other member changes. The test members
diff --git a/pkgs/o/os.lua b/pkgs/o/os.lua
index 992524ee..7f9a2d15 100644
--- a/pkgs/o/os.lua
+++ b/pkgs/o/os.lua
@@ -31,6 +31,13 @@ package = {
 
     xpm = {
         linux = {
+            ["0.3.1"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.1.tar.gz",
+                    CN = "https://gitcode.com/mcpp-res/os/releases/download/0.3.1/os-0.3.1.tar.gz",
+                },
+                sha256 = "26492cf9fe4a5a0ac5d6c0590e6659ff435c0104d636450dbf0f14cef15823b1",
+            },
             ["0.3.0"] = {
                 url    = {
                     GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.0.tar.gz",
@@ -122,6 +129,13 @@ package = {
             },
         },
         macosx = {
+            ["0.3.1"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.1.tar.gz",
+                    CN = "https://gitcode.com/mcpp-res/os/releases/download/0.3.1/os-0.3.1.tar.gz",
+                },
+                sha256 = "26492cf9fe4a5a0ac5d6c0590e6659ff435c0104d636450dbf0f14cef15823b1",
+            },
             ["0.3.0"] = {
                 url    = {
                     GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.0.tar.gz",
@@ -213,6 +227,13 @@ package = {
             },
         },
         windows = {
+            ["0.3.1"] = {
+                url = {
+                    GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.1.tar.gz",
+                    CN = "https://gitcode.com/mcpp-res/os/releases/download/0.3.1/os-0.3.1.tar.gz",
+                },
+                sha256 = "26492cf9fe4a5a0ac5d6c0590e6659ff435c0104d636450dbf0f14cef15823b1",
+            },
             ["0.3.0"] = {
                 url    = {
                     GLOBAL = "https://github.com/mcpplibs/os/archive/refs/tags/0.3.0.tar.gz",
diff --git a/tests/examples/os/mcpp.toml b/tests/examples/os/mcpp.toml
index ede4b284..2a872130 100644
--- a/tests/examples/os/mcpp.toml
+++ b/tests/examples/os/mcpp.toml
@@ -7,7 +7,7 @@ name    = "os-tests"
 version = "0.1.0"
 
 [dependencies.mcpplibs]
-os = "0.2.9"
+os = "0.3.1"
 
 [indices]
 mcpplibs = { path = "../../.." }