Phase 2: API Unification & Typed Results + Phase 2.1 Fixes

Phase 2 - Breaking Changes (v2.0.0):
- Added typed result interfaces (FileMetadata, DirectoryMetadata, VaultInfo, SearchResult, SearchMatch)
- Unified parameter naming: list_notes now uses 'path' parameter (removed 'folder')
- Enhanced tool responses with structured JSON for all tools
- list_notes: Returns array of FileMetadata/DirectoryMetadata with full metadata
- search_notes: Returns SearchResult with line numbers, snippets, and match ranges
- get_vault_info: Returns VaultInfo with comprehensive statistics
- Updated all tool descriptions to document structured responses
- Version bumped to 2.0.0 (breaking changes)

Phase 2.1 - Post-Testing Fixes:
- Fixed root listing to exclude vault root folder itself (handles path '', '/', and isRoot())
- Fixed alphabetical sorting to be case-insensitive for stable ordering
- Improved directory metadata with better timestamp detection and error handling
- Fixed parent folder validation order (check if file before checking existence)
- Updated documentation with root path examples and leading slash warnings
- Added comprehensive test suite for sorting and root listing behavior
- Fixed test mocks to use proper TFile/TFolder instances

Tests: All 64 tests passing
Build: Successful, no errors

src/tools/note-tools.ts

@@ -91,7 +91,15 @@ export class NoteTools {
 		// Explicit parent folder detection (before write operation)
 		const parentPath = PathUtils.getParentPath(normalizedPath);
 		if (parentPath) {
-			// Check if parent exists
+			// First check if parent path is actually a file (not a folder)
+			if (PathUtils.fileExists(this.app, parentPath)) {
+				return {
+					content: [{ type: "text", text: ErrorMessages.notAFolder(parentPath) }],
+					isError: true
+				};
+			}
+			
+			// Check if parent folder exists
 			if (!PathUtils.pathExists(this.app, parentPath)) {
 				if (createParents) {
 					// Auto-create parent folders recursively
@@ -111,14 +119,6 @@ export class NoteTools {
 					};
 				}
 			}
-			
-			// Check if parent is actually a folder (not a file)
-			if (PathUtils.fileExists(this.app, parentPath)) {
-				return {
-					content: [{ type: "text", text: ErrorMessages.notAFolder(parentPath) }],
-					isError: true
-				};
-			}
 		}
 
 		// Proceed with file creation