From 721120a9686f10171c87e485e8ac25ebb36347c2 Mon Sep 17 00:00:00 2001 From: Adam Perry Date: Fri, 10 Jul 2026 01:39:56 +0000 Subject: [PATCH] path-uri: document host path validation --- codex-rs/utils/path-uri/src/api_path_string.rs | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/codex-rs/utils/path-uri/src/api_path_string.rs b/codex-rs/utils/path-uri/src/api_path_string.rs index 84f84a04ca..369d59fb0e 100644 --- a/codex-rs/utils/path-uri/src/api_path_string.rs +++ b/codex-rs/utils/path-uri/src/api_path_string.rs @@ -83,6 +83,10 @@ impl LegacyAppPathString { /// Parses this API string as an absolute path native to the current host. /// + /// Use this for legacy app or wire path text that must be validated as + /// native to the current host. Constructing [`AbsolutePathBuf`] directly + /// can misclassify foreign-platform spelling as a local path. + /// /// Host-specific path namespaces are normalized. Relative and /// foreign-platform paths are rejected. pub fn to_host_abs_path(&self) -> Result {