fix: remove binary detection, fix non-ASCII git paths, add FAQ

[molon]

Summary

• Remove binary detection from collectUntrackedFiles: Was inconsistent with onDiskCreate which accepts binary files — caused .xlsx/.msg files dragged from Finder to disappear after refresh. Baseline tracking is the single source of truth, not file content.
• Fix non-ASCII git paths: git ls-tree quotes non-ASCII paths by default (e.g. \343\203\241...), causing path mismatches with filesystem paths. Added -c core.quotepath=false globally to all git calls so paths are always raw UTF-8.
• Revert onWillCreateFiles approach: onWillCreateFiles also fires for Finder drag-into-explorer, making it unreliable. Restored openDoc&&bufferMatch heuristic.
• Docs: Updated CLAUDE.md with baseline-as-source-of-truth principle. Added FAQ for known Finder drag-in timing heuristic.

Test plan

• Unit test: non-ASCII paths in listTrackedFiles and getBaseline
• Integration test: refresh preserves binary files detected by FileWatcher
• Integration test: refresh preserves new files (null baseline)
• All 71 unit tests pass
• All 67 integration tests pass

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR updates hunkwise’s refresh + git baseline plumbing to better support externally created files (including binary) and to correctly handle non-ASCII paths in the internal git repo, alongside documentation updates clarifying baseline semantics and known VS Code/Finder timing behavior.

Changes:

• Remove binary-content heuristics from StateManager.collectUntrackedFiles() so refresh treats all on-disk untracked files consistently (baseline remains the source of truth).
• Force raw UTF-8 path output from git by adding -c core.quotepath=false to all HunkwiseGit subprocess calls.
• Add/adjust tests covering non-ASCII paths and refresh behavior for binary “new” files; add FAQ + update CLAUDE.md guidance.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/test/integration/filewatch.test.ts	Updates integration coverage to ensure refresh preserves binary new files in reviewing state.
src/test/hunkwiseGit.test.ts	Adds a unit test ensuring listTrackedFiles() / getBaseline() work with non-ASCII paths.
src/stateManager.ts	Removes binary/unreadable detection from untracked-file collection during load/rebuild.
src/hunkwiseGit.ts	Forces core.quotepath=false on all git calls to prevent escaped path output.
package.json	Bumps extension version.
FAQ.md	Adds documentation for Finder drag-in timing behavior.
CLAUDE.md	Clarifies “baseline as single source of truth” and null/empty baseline semantics.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

collectUntrackedFiles() now unconditionally adds any Dirent.isFile() not in trackedSet. This also changes the previous behavior of skipping unreadable files (EACCES/EPERM): those files will now enter reviewing with baseline:null, but later code paths (e.g. accept/discard flows that read the file as UTF-8) can throw or behave incorrectly when the file can’t be read. Consider restoring a minimal readability/access check (without binary detection) so only readable files are treated as new, or ensure downstream consumers gracefully handle unreadable files.

Suggested change

	results.push(full);
	try {
	await fs.promises.access(full, fs.constants.R_OK);
	results.push(full);
	} catch (err: any) {
	// Skip unreadable files (e.g., permission errors) to avoid issues later
	if (err && (err.code === 'EACCES' || err.code === 'EPERM')) {
	continue;
	}
	// For other unexpected errors, also skip to be conservative
	continue;
	}