fix-bug

Fix Bug

When to Use

• User reports something broken, an error, or unexpected behavior
• Diagnosing why a feature isn't working

Procedure

1. Reproduce

• Get exact steps, error messages, or screenshots
• Check browser DevTools console (frontend errors) and terminal output (Rust panics/errors)
• If the error mentions invoke, it's likely an IPC issue between frontend and backend

2. Isolate the layer

3. Common issues checklist

• Command not registered — new command missing from invoke_handler![] in src-tauri/src/lib.rs
• Param name mismatch — invoke("cmd", { fileName }) vs fn cmd(file_name: String) — names must match exactly (Tauri auto-converts camelCase ↔ snake_case)
• Path validation — validate_path() in file_service.rs rejects paths outside vault root. Check canonicalization and vault root setup
• Stale file tree — forgot to call loadFileTree() after a file mutation (create, rename, delete, move)
• Selector re-render loop — useStore((s) => ({ a: s.a, b: s.b })) creates new object each render. Use separate selectors per field
• Missing error handling — store action without try-catch silently fails. Check for unhandled promise rejections

4. Fix and verify

1. Apply the fix
2. Run npm test and cd src-tauri && cargo test
3. Test in dev mode: npm run tauri dev
4. If the fix touches file operations, verify validate_path() still blocks ../ traversal