fix: improve lint-readme.js error handling and messages

[joshjohanning]

• Add check for files tracked in Git but missing from filesystem
• Update error message to distinguish between files and directories
• Prevent crashes when staged files have been deleted locally
• Add fs.existsSync() checks before fs.statSync() calls

[github-actions]

📋 Lint Results

⚡ ./gh-cli scripts

✅ No issues found.

🔧 ./scripts scripts

✅ No issues found.

---

Lint results updated at Thu Oct 2 19:09:55 UTC 2025

[Copilot]

Pull Request Overview

This PR improves the robustness of the lint-readme.js script by adding better error handling for missing files and enhancing error messages to distinguish between files, directories, and items that don't exist.

• Adds filesystem existence checks before attempting to access file stats
• Introduces a helper function to determine item types (file/directory/non-existent)
• Updates error messages to be more specific about whether an item is a file or directory
• Prevents crashes when Git-tracked files have been deleted locally

[Copilot]

Pull Request Overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.