fix(path): do not decode percent-encoding in raw filesystem paths

[ernestodeoliveira]

Summary

Fixes #18285.

When a project path contains a literal percent-encoded sequence in the directory name (e.g. D:\First%20Second), opencode was silently decoding %20 to a space, resolving the path as D:\First Second — a different, non-existent directory.

Root Cause

In packages/app/src/context/file/path.ts, the normalize() function always called decodeFilePath() (which runs decodeURIComponent()) on the raw input:

// Before: unconditional decode — breaks literal % in folder names
let path = unquoteGitPath(decodeFilePath(stripQueryAndHash(stripFileProtocol(input))))

decodeFilePath is only needed when the input is a file:// URL (to convert file:///home/user/My%20Docs → /home/user/My Docs). Raw filesystem paths — Windows or Unix — may contain literal %20 or other %XX sequences as part of the actual folder/file name. Decoding those is incorrect.

Fix

Guard decodeFilePath behind an isUrl check:

// Only decode percent-encoding for file:// URLs — raw filesystem paths may
// contain literal % characters (e.g. D:\First%20Second) that must be preserved.
const isUrl = input.startsWith("file://") || input.startsWith("file:\\")
let path = unquoteGitPath(
  isUrl
    ? decodeFilePath(stripQueryAndHash(stripFileProtocol(input)))
    : stripQueryAndHash(stripFileProtocol(input)),
)

Testing

Added 2 regression tests to path.test.ts:

1. Literal %20 in raw Windows path is preserved — D:\First%20Second\file.txt normalizes correctly without decoding
2. %20 in file:// URL is still decoded — file:///home/user/My%20Documents/file.txt continues to work as before

All 39 existing tests pass.

Notes

The typecheck pre-push hook fails on @opencode-ai/enterprise (src/custom-elements.d.ts) — this error exists on dev before this change and is unrelated to this fix.

[github-actions]

This PR doesn't fully meet our contributing guidelines and PR template.

What needs to be fixed:

• PR description is missing required template sections. Please use the PR template.

Please edit this PR description to address the above within 2 hours, or it will be automatically closed.

If you believe this was flagged incorrectly, please let a maintainer know.

[github-actions]

This pull request has been automatically closed because it was not updated to meet our contributing guidelines within the 2-hour window.

Feel free to open a new pull request that follows our guidelines.