* feat: add missing install.sh script referenced in README\n\n- Create comprehensive installation script with POSIX compatibility\n- Add interactive and non-interactive installation modes\n- Include prerequisites checking and MCP server setup guidance\n- Replace echo -e with printf for better POSIX compliance
* fix: resolve linting errors in install_mcp.py and clean_command_names.py
Fix multiple ruff linting errors to ensure CI/CD pipeline passes:
- install_mcp.py: Remove unused pathlib.Path import, replace bare except
with specific exception types (ValueError, IndexError), remove
extraneous f-string prefixes on lines without placeholders
- clean_command_names.py: Remove unused os import, convert f-strings
without placeholders to regular strings
- pyproject.toml: Exclude docs/ directory from ruff checks to avoid
N999 module naming violations in documentation templates
All linting checks now pass successfully.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* style: apply ruff format to Python source files
Apply ruff formatting rules to CLI and scripts modules to ensure
consistent code style across the codebase.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* fix(ci): remove incompatible pip cache from quick-check workflow
## Problem
GitHub Actions was failing with error:
"Cache folder path is retrieved for pip but doesn't exist on disk:
/home/runner/.cache/pip. This likely indicates that there are no
dependencies to cache."
## Root Cause
The quick-check.yml workflow specified `cache: 'pip'` in the Python
setup step, but the workflow uses UV (not pip) for package management
via `uv pip install --system -e ".[dev]"`.
UV uses its own cache directory (~/.cache/uv), so the pip cache path
was never created, causing the error.
This was a migration oversight:
- When UV was adopted as the project standard (commit 00706f0), the
CLAUDE.md established "CRITICAL: Never use pip directly" rule
- The test.yml workflow was created correctly without pip cache
- The quick-check.yml workflow incorrectly included pip cache from
initial creation (commit 8c0559c) and was not updated during migration
## Solution
Remove `cache: 'pip'` line to align with:
- Project's UV-first architecture (CLAUDE.md)
- test.yml workflow (which runs successfully without pip cache)
- readme-quality-check.yml workflow (no cache needed)
Note: publish-pypi.yml intentionally uses pip cache as it directly
runs `python -m pip install` commands, which is correct for that workflow.
## Impact
- ✅ Eliminates GitHub Actions cache warning
- ✅ Aligns all UV-based workflows consistently
- ✅ Follows project standards documented in CLAUDE.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
Changed from 'uv run <command>' to direct '<command>' execution
since we're using 'uv pip install --system' which installs to
the system Python environment.
This fixes pytest-cov and other plugin detection issues.
Changes:
- pytest instead of uv run pytest
- ruff instead of uv run ruff
- superclaude instead of uv run superclaude
- Added uv pip list for debugging
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added --system flag to all uv pip install commands to fix
"No virtual environment found" error in GitHub Actions CI/CD.
UV requires either a virtual environment or the --system flag
in CI/CD environments.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed package structure verification paths:
- Changed superclaude/ to src/superclaude/
- Updated Python path for version imports
- Added README-kr.md to quality check workflow
Fixes directory not found errors in CI/CD pipeline.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add toml package to build dependencies in publish-pypi.yml
- Prevents ModuleNotFoundError during version verification
- Fixes root cause of v4.0.8 version skipping issue
- Ensures reliable PyPI release workflow execution
- Add README-zh.md with full Chinese translation
- Add README-ja.md with full Japanese translation
- Update README.md with professional language selector
- Add GitHub Actions workflow for README quality checks
## Version Management & Consistency
- Update to version 4.0.0b1 (proper beta versioning for PyPI)
- Add __version__ attribute to SuperClaude/__init__.py
- Ensure version consistency across pyproject.toml, __main__.py, setup/__init__.py
## Enhanced Package Configuration
- Improve pyproject.toml with comprehensive PyPI classifiers
- Add proper license specification and enhanced metadata
- Configure package discovery with inclusion/exclusion patterns
- Add development and test dependencies
## Publishing Scripts & Tools
- scripts/build_and_upload.py: Advanced Python script for building and uploading
- scripts/publish.sh: User-friendly shell wrapper for common operations
- scripts/validate_pypi_ready.py: Comprehensive validation and readiness checker
- All scripts executable with proper error handling and validation
## GitHub Actions Automation
- .github/workflows/publish-pypi.yml: Complete CI/CD pipeline
- Automatic publishing on GitHub releases
- Manual workflow dispatch for TestPyPI uploads
- Package validation and installation testing
## Documentation & Security
- PUBLISHING.md: Comprehensive PyPI publishing guide
- scripts/README.md: Detailed script usage documentation
- .env.example: Environment variable template
- Secure token handling with both .pypirc and environment variables
## Features
✅ Version consistency validation across all files
✅ Comprehensive PyPI metadata and classifiers
✅ Multi-environment publishing (TestPyPI + PyPI)
✅ Automated GitHub Actions workflow
✅ Security best practices for API token handling
✅ Complete documentation and troubleshooting guides
✅ Enterprise-grade validation and error handling
The SuperClaude Framework is now fully prepared for PyPI publication
with professional-grade automation, validation, and documentation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Restructured core framework components
- Added new Agents, MCP servers, and Modes documentation
- Introduced SuperClaude-Lite minimal implementation
- Enhanced Commands with session management capabilities
- Added comprehensive Hooks system with Python integration
- Removed legacy setup and profile components
- Updated .gitignore to exclude Tests/, ClaudeDocs/, and .serena/
- Consolidated configuration into SuperClaude/Config/
- Added Templates for consistent component creation
This is the initial commit for the V4 Beta branch containing all recent framework improvements and architectural changes.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
