* fix: fill implementation gaps across core modules
- Replace ConfidenceChecker placeholder methods with real implementations
that search the codebase for duplicates, verify architecture docs exist,
check research references, and validate root cause specificity
- Fix intelligent_execute() error capture: collect actual errors from
failed tasks instead of hardcoded None, format tracebacks as strings,
and fix variable shadowing bug where loop var overwrote task parameter
- Implement ReflexionPattern mindbase integration via HTTP API with
graceful fallback when service is unavailable
- Fix .gitignore: remove duplicate entries, add explicit !-rules for
.claude/settings.json and .claude/skills/, remove Tests/ ignore
- Remove unnecessary sys.path hack in cli/main.py
- Fix FailureEntry.from_dict to not mutate input dict
- Add comprehensive execution module tests: 62 new tests covering
ParallelExecutor, ReflectionEngine, SelfCorrectionEngine, and the
intelligent_execute orchestrator (136 total, all passing)
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* chore: include test-generated reflexion artifacts
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* fix: address 5 open GitHub issues (#536, #537, #531, #517, #534)
Security fixes:
- #536: Remove shell=True and user-controlled $SHELL from _run_command()
to prevent arbitrary code execution. Use direct list-based subprocess.run
without passing full os.environ to child processes.
- #537: Add SHA-256 integrity verification for downloaded docker-compose
and mcp-config files. Downloads are deleted on hash mismatch. Gateway
config supports pinned hashes via docker_compose_sha256/mcp_config_sha256.
Bug fixes:
- #531: Add agent file installation to `superclaude install` and `update`
commands. 20 agent markdown files are now copied to ~/.claude/agents/
alongside command installation.
- #517: Fix MCP env var flag from --env to -e for API key passthrough,
matching the Claude CLI's expected format.
Usability:
- #534: Replace Japanese trigger phrases and report labels in pm-agent.md
and pm.md (both src/ and plugins/) with English equivalents for
international accessibility.
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* docs: align documentation with Claude Code and fix version/count gaps
- Update CLAUDE.md project structure to include agents/ (20 agents),
modes/ (7 modes), commands/ (30 commands), skills/, hooks/, mcp/,
and core/ directories. Add Claude Code integration points section.
- Fix version references: 4.1.5 -> 4.2.0 in installation.md,
quick-start.md, and package.json (was 4.1.7)
- Fix feature counts across all docs:
- Commands: 21 -> 30
- Agents: 14/16 -> 20
- Modes: 6 -> 7
- MCP Servers: 6 -> 8
- Update README.md agent count from 16 to 20
- Add docs/user-guide/claude-code-integration.md explaining how
SuperClaude maps to Claude Code's native features (commands,
agents, hooks, skills, settings, MCP servers, pytest plugin)
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* chore: update test-generated reflexion log
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* docs: comprehensive Claude Code gap analysis and integration guide
- Rewrite docs/user-guide/claude-code-integration.md with full feature
mapping: all 28 hook events, skills system with YAML frontmatter,
5 settings scopes, permission rules, plan mode, extended thinking,
agent teams, voice, desktop features, and session management.
Includes detailed gap table showing where SuperClaude under-uses
Claude Code capabilities (skills migration, hooks integration,
plan mode, settings profiles).
- Add Claude Code native features section to CLAUDE.md with extension
points we use vs should use more (hooks, skills, plan mode, settings)
- Add Claude Code integration gap analysis to KNOWLEDGE.md with
prioritized action items for skills migration, hooks leverage,
plan mode integration, and settings profiles
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* chore: update test-generated reflexion log
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* chore: bump version to 4.3.0
Bump version across all 15 files:
- VERSION, pyproject.toml, package.json
- src/superclaude/__init__.py, src/superclaude/__version__.py
- CLAUDE.md, PLANNING.md, TASK.md, CHANGELOG.md
- README.md, README-zh.md, README-ja.md, README-kr.md
- docs/getting-started/installation.md, quick-start.md
- docs/Development/pm-agent-integration.md
Also fixes __version__.py which was out of sync at 0.4.0.
Adds comprehensive CHANGELOG entry for v4.3.0.
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
* i18n: replace all Japanese/Chinese text with English in source files
Replace CJK text with English across all non-translation files:
- src/superclaude/commands/pm.md: 38 Japanese strings in PDCA cycle,
error handling patterns, anti-patterns, document templates
- src/superclaude/agents/pm-agent.md: 20 Japanese strings in PDCA
phases, self-evaluation, documentation sections
- plugins/superclaude/: synced from src/ copies
- .github/workflows/readme-quality-check.yml: all Chinese comments,
table headers, report strings, and PR comment text
- .github/workflows/pull-sync-framework.yml: Japanese comment
- .github/PULL_REQUEST_TEMPLATE.md: complete rewrite from Japanese
Translation files (README-ja.md, docs/user-guide-jp/, etc.) are
intentionally kept in their respective languages.
https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9
---------
Co-authored-by: Claude <noreply@anthropic.com>
The pull-sync-framework workflow previously pushed directly to main on a
6-hour cron schedule with no human review gate. If the upstream framework
repo were compromised, malicious code would propagate automatically to
all downstream forks.
This change:
- Creates a dated branch (framework-sync/<date>) instead of pushing to main
- Opens a pull request for human review before merge
- Adds pull-requests: write permission for gh pr create
Fixes#535
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* 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>
Mithun Gowda B