Record more path migration guidance for codex. (#28851)

Some common themes pulled out of both human and automated reviews from
the last couple of days' migrations to `PathUri` and
`LegacyAppPathString`.
This commit is contained in:
Adam Perry @ OpenAI
2026-06-17 21:59:42 -07:00
committed by GitHub
Unverified
parent e12dd73b7d
commit 285eff6c3e
+3 -1
View File
@@ -31,7 +31,9 @@ Keep these requirements in mind while migrating code to conform with the above g
* path reasoning must work before the related environment has come online
* URIs cannot explicitly encode the executors path convention or operating system
* users must not configure the environments OS/path convention explicitly
* URIs should not yet be stored in rollouts
* URIs should not yet be stored in rollouts, databases, or other persistent storage
* path conversion errors: fail-closed for security-relevant paths, fail-open for UI/diagnostics
* prefer small focused methods on `PathUri` or `LegacyAppPathString` over local helpers
It is OK if the conversion between paths and URIs is somewhat lossy as long as it will do the right
thing for real users.