From 6c493e3238c649b6ce26850b3ea57f9189db0f1c Mon Sep 17 00:00:00 2001
From: Danny Kim <temeddix@gmail.com>
Date: Wed, 30 Sep 2026 15:40:35 +0900
Subject: [PATCH] Clarify that remote paths carry literal filesystem names

---
 wit/filesystem.wit | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/wit/filesystem.wit b/wit/filesystem.wit
index 4529372..dc8d5c8 100644
--- a/wit/filesystem.wit
+++ b/wit/filesystem.wit
@@ -81,7 +81,8 @@ interface host {
 
 /// Filesystem operations for one connection. Paths are absolute within its
 /// root, starting with `/`; they are never local OS paths or resource URIs.
-/// Dot segments, backslashes, percent escapes, colons, and controls are invalid.
+/// Colons and percent signs are literal; paths must never be URL-decoded.
+/// Dot segments, backslashes, and controls are invalid.
 /// Every invocation is bounded by host fuel, memory, time, and cancellation.
 interface provider {
     use host.{setting};