automate releases and fix linux workflow

[rahlk]

Summary

Enhanced CLI error handling, improved system compatibility, and added comprehensive documentation for system requirements. This release focuses on robustness and better user experience across different Python environments and operating systems.

Motivation and Context

Users were experiencing issues when:

• Providing invalid input paths to the CLI (no proper error handling)
• Installing on systems missing required system packages (python3-venv, development tools)
• Running on different Python environments (pyenv, conda, asdf) with inconsistent interpreter detection
• Encountering subprocess execution errors without detailed error information

These improvements ensure the tool works reliably across different environments and provides clear feedback when issues occur.

How Has This Been Tested?

• Tested CLI with invalid input paths to verify proper error handling and exit codes
• Tested virtual environment creation on systems with and without python3-venv package
• Tested Python interpreter detection across different environment managers (pyenv, conda, asdf)
• Tested subprocess command execution with various argument types
• Verified installation instructions on Ubuntu/Debian, Fedora/RHEL/CentOS, and macOS
• Updated and validated test suite with new verbose flag usage

Breaking Changes

• Test configuration change: --quiet flag replaced with -v (verbose) flag in test cases
• CLI now exits with error code 1 for invalid paths (previously continued execution)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the Codellm-Devkit Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional context

Key Improvements:

• Input Validation: Added path existence checks with proper logging before processing
• Cross-Platform Support: Enhanced Python interpreter detection for various environment managers
• Error Handling: Improved subprocess execution with detailed error output logging
• Documentation: Comprehensive system requirements and platform-specific installation guides
• Type Safety: Ensured all subprocess arguments are properly typed as strings

Files Modified:

• CLI main function: Added input path validation
• Command execution helper: Enhanced error reporting
• Base interpreter detection: Improved environment manager support
• README.md: Added detailed system requirements and installation instructions
• Test configuration: Updated test flags and removed unused imports

[Copilot]

Pull Request Overview

This PR automates the release process and fixes compatibility issues on Linux by updating changelog entries, adding a release configuration for changelog generation, and introducing a GitHub Actions workflow for building, testing, and publishing.

• Updated CHANGELOG with new features, fixes, and documentation details.
• Added .github/workflows/release_config.json to categorize changelog entries.
• Introduced .github/workflows/release.yml to automate tagging, testing, and publishing to GitHub and PyPI.

Reviewed Changes

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

File	Description
CHANGELOG.md	Expanded “Added”/“Changed”/“Fixed” sections for new behaviors
.github/workflows/release_config.json	New config for release-changelog-builder-action
.github/workflows/release.yml	New GitHub Actions workflow for end-to-end releases

Comments suppressed due to low confidence (2)

CHANGELOG.md:13

• This entry is duplicated by the 'Updated README.md with detailed prerequisite packages…' under 'Changed'; consider consolidating or clarifying their differences to avoid confusion.

- Comprehensive system package requirements documentation in README.md

.github/workflows/release.yml:1

• [nitpick] For consistency with the tool's branding, consider capitalizing ‘uv’ to ‘UV’ in the workflow name.

name: Python uv Release

[Copilot]

[nitpick] Using Unicode escape sequences in the JSON reduces readability; consider using the actual emoji character (📚) for clarity and easier editing.

Suggested change

	"title": "## \uD83D\uDCDA Documentation",
	"labels": [
	"documentation",
	"doc"
	]
	},
	{
	"title": "## \uD83D\uDEA6 Tests",
	"labels": [
	"test"
	]
	},
	{
	"title": "## \uD83D\uDEE0 Other Updates",
	"title": "## 📚 Documentation",
	"labels": [
	"documentation",
	"doc"
	]
	},
	{
	"title": "## 🚦 Tests",
	"labels": [
	"test"
	]
	},
	{
	"title": "## 🛠 Other Updates",

[Copilot]

Piping a remote script directly into shell can pose a security risk; consider pinning to a known version, verifying a checksum, or downloading the script separately for review before execution.

Suggested change

	curl -LsSf https://astral.sh/uv/install.sh | sh
	curl -LsSf -o install.sh https://astral.sh/uv/install.sh
	echo "Expected checksum: <INSERT_CHECKSUM_HERE>"
	echo "<INSERT_CHECKSUM_HERE> install.sh" | sha256sum --check --status
	if [ $? -ne 0 ]; then
	echo "Checksum verification failed! Exiting..."
	exit 1
	fi
	sh install.sh