Enhanced root directory validation with several improvements:

1. **Better Error Messages**: More descriptive error messages with specific
   guidance on how to resolve issues (create directory, check permissions, etc.)

2. **Path Canonicalization**: Resolve symlinks and relative paths to absolute
   canonical paths, ensuring consistent behavior across different path formats

3. **Write Permission Validation**: Proactively check write permissions by
   creating a temporary test file before attempting daemon operations

4. **Comprehensive Edge Case Handling**:
   - Broken symlinks are properly detected as non-existent
   - Regular symlinks to directories are resolved correctly
   - Symlinks to files are rejected appropriately
   - Deep nested non-existent paths are handled gracefully

5. **Enhanced Git Root Handling**: Better error messages for git repository
   detection failures and .demon directory creation issues

6. **Robust Testing**: Added comprehensive test suite covering:
   - All edge cases and error conditions
   - Improved error message validation
   - Write permission validation
   - Path canonicalization behavior
   - Symlink handling (valid, broken, to files, to directories)

The validation now provides clear, actionable feedback to users when
directory issues are encountered, making the tool more user-friendly
and robust in various deployment scenarios.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

This test ensures the README documentation shows the correct -f flag
syntax for the tail command, not =f which is incorrect.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Fixed all 19 failing tests by replacing --root-dir flag with DEMON_ROOT_DIR environment variable
- All 28 tests now pass consistently
- Added cargo test to pre-commit hook for comprehensive quality checks
- Pre-commit hook now runs: cargo fmt, cargo clippy, and cargo test

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Enhanced pre-commit hook to run cargo clippy with -D warnings
- Fixed uninlined_format_args warnings by using variables directly in format strings
- Removed needless borrows in .args() calls
- Fixed print_literal warnings by moving literals out of format placeholders
- Replaced seek_from_current with stream_position for better semantics
- Fixed len_zero warning by using is_empty() instead of len() > 0

All code now passes both cargo fmt and cargo clippy checks

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Clean up project by removing internal planning documents

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Created pre-commit hook that runs cargo fmt --check
- If formatting issues found, runs cargo fmt and asks for re-commit
- Applied cargo fmt to fix existing formatting issues

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Remove "Background Process Manager" subtitle for cleaner title

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Runs tests on push and pull requests to main branch
- Includes formatting check, clippy linting, build, and test steps
- Uses cargo caching for improved performance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Rewrite opening section to be clearer and more direct
- Better explain the tool's purpose for AI agents
- Add root directory discovery details to "How It Works" section
- Simplify content structure while maintaining essential information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

- Modified find_git_root() to create and return <git_root>/.demon instead of <git_root>
- Auto-creates .demon directory if it doesn't exist
- Added proper error handling for edge cases (file vs directory conflicts, permissions)
- Maintains backward compatibility with explicit --root-dir flag
- Added comprehensive test to verify new default behavior
- Fixed test argument ordering for test_list_empty

Files are now organized as:
- Before: /project/daemon.pid, /project/daemon.stdout, /project/daemon.stderr
- After: /project/.demon/daemon.pid, /project/.demon/daemon.stdout, /project/.demon/daemon.stderr

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>