CLI-8: Make ls tool OS-agnostic with improved path handling

[szmania]

Summary

This PR updates the ls tool to be more OS-agnostic and improves path handling for better cross-platform compatibility.

Changes

• Parameter naming: Changed from directory to path for consistency, with backward compatibility support
• OS-agnostic paths: Replaced Unix-style path handling (startswith("/")) with os.path.abspath() and os.path.join() for cross-platform compatibility
• Security enhancement: Added path validation to ensure resolved paths stay within the project root
• Improved error handling: Better error messages for paths outside project root and OS-related errors
• File vs Directory handling: Now properly handles both file and directory paths
• Sorting: Results are now sorted alphabetically for consistent output

Technical Details

• Uses os.path.abspath() and os.path.join() instead of manual path concatenation
• Added security check: abs_path.startswith(os.path.abspath(coder.root))
• Improved error handling with OSError catching for os.scandir() operations
• Maintains backward compatibility by accepting both path and directory parameters

Testing

• Tested on Windows with various path formats
• Verified backward compatibility with existing code using directory parameter
• Confirmed proper handling of both files and directories

Related

Jira: CLI-8