External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-17 09:46:06 +00:00
Code Issues Packages Projects Releases Wiki Activity
SuperClaude/CHANGELOG.md
Mithun Gowda B fb609c6a06
Fixed Some Bugs (#355) 
* Fix: Install only selected MCP servers and ensure valid empty backups

This commit addresses two separate issues:

1.  **MCP Installation:** The `install` command was installing all MCP servers instead of only the ones selected by the user. The `_install` method in `setup/components/mcp.py` was iterating through all available servers, not the user's selection. This has been fixed to respect the `selected_mcp_servers` configuration. A new test has been added to verify this fix.

2.  **Backup Creation:** The `create_backup` method in `setup/core/installer.py` created an invalid `.tar.gz` file when the backup source was empty. This has been fixed to ensure that a valid, empty tar archive is always created. A test was added for this as well.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Correct installer validation for MCP and MCP Docs components

This commit fixes a validation issue in the installer where it would incorrectly fail after a partial installation of MCP servers.

The `MCPComponent` validation logic was checking for all "required" servers, regardless of whether they were selected by the user. This has been corrected to only validate the servers that were actually installed, by checking against the list of installed servers stored in the metadata. The metadata storage has also been fixed to only record the installed servers.

The `MCPDocsComponent` was failing validation because it was not being registered in the metadata if no documentation files were installed. This has been fixed by ensuring the post-installation hook runs even when no files are copied.

New tests have been added for both components to verify the corrected logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Allow re-installation of components and correct validation logic

This commit fixes a bug that prevented new MCP servers from being installed on subsequent runs of the installer. It also fixes the validation logic that was causing failures after a partial installation.

The key changes are:
1.  A new `is_reinstallable` method has been added to the base `Component` class. This allows certain components (like the `mcp` component) to be re-run even if they are already marked as installed.
2.  The installer logic has been updated to respect this new method.
3.  The `MCPComponent` now correctly stores only the installed servers in the metadata.
4.  The validation logic for `MCPComponent` and `MCPDocsComponent` has been corrected to prevent incorrect failures.

New tests have been added to verify all aspects of the new logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Display authors in UI header and update author info

This commit implements the user's request to display author names and emails in the UI header of the installer.

The key changes are:
1.  The `__email__` field in `SuperClaude/__init__.py` has been updated to include both authors' emails.
2.  The `display_header` function in `setup/utils/ui.py` has been modified to read the author and email information and display it.
3.  A new test has been added to `tests/test_ui.py` to verify the new UI output.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Version bump to 4.1.0 and various fixes

This commit prepares the project for the v4.1.0 release. It includes a version bump across all relevant files and incorporates several bug fixes and feature enhancements from recent tasks.

Key changes in this release:

- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 in all configuration files, documentation, and source code.

- **Installer Fixes**:
  - Components can now be marked as `reinstallable`, allowing them to be re-run on subsequent installations. This fixes a bug where new MCP servers could not be added.
  - The validation logic for `mcp` and `mcp_docs` components has been corrected to avoid incorrect failures.
  - A bug in the backup creation process that created invalid empty archives has been fixed.

- **UI Enhancements**:
  - Author names and emails are now displayed in the installer UI header.

- **Metadata Updates**:
  - Mithun Gowda B has been added as an author.

- **New Tests**:
  - Comprehensive tests have been added for the installer logic, MCP components, and UI changes to ensure correctness and prevent regressions.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Resolve dependencies for partial installs and other fixes

This commit addresses several issues, the main one being a dependency resolution failure during partial installations.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree when a user requests to install a subset of components. This fixes the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run on subsequent installs, enabling the addition of new servers.
- **Validation Logic**: The validation for `mcp` and `mcp_docs` has been corrected to avoid spurious failures.
- **UI and Metadata**: Author information has been added to the UI header and source files.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Tests**: New tests have been added to cover all the above changes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Installer fixes and version bump to 4.1.0

This commit includes a collection of fixes for the installer logic, UI enhancements, and a version bump to 4.1.0.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree for partial installations, fixing the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run to add new servers.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts the user to select servers.
- **Validation Logic**: The post-installation validation logic has been corrected to only validate components from the current session and to use the correct list of installed servers.
- **UI & Metadata**: Author information has been added to the UI and source files.
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 across all files.
- **Tests**: New tests have been added to cover all the bug fixes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Add --authors flag and multiple installer fixes

This commit introduces the `--authors` flag to display author information and includes a collection of fixes for the installer logic.

Key changes:
- **New Feature**: Added an `--authors` flag that displays the names, emails, and GitHub usernames of the project authors.
- **Dependency Resolution**: Fixed a critical bug where partial installations would fail due to unresolved dependencies.
- **Component Re-installation**: Added a mechanism to allow components to be "reinstallable", fixing an issue that prevented adding new MCP servers on subsequent runs.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts for server selection.
- **Validation Logic**: Corrected the post-installation validation to prevent spurious errors.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Metadata**: Author and GitHub information has been added to the source files.
- **UI**: The installer header now displays author information.
- **Tests**: Added new tests for all new features and bug fixes.


Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

---------
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
2025-09-13 17:28:52 +05:30

7.4 KiB
Raw Permalink Blame History

Changelog

All notable changes to SuperClaude will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[4.1.0] - 2025-09-13

Added

  • Display author names and emails in the installer UI header.
  • is_reinstallable flag for components to allow re-running installation.

Fixed

  • Installer now correctly installs only selected MCP servers on subsequent runs.
  • Corrected validation logic for mcp and mcp_docs components to prevent incorrect failures.
  • Ensured empty backup archives are created as valid tar files.
  • Addressed an issue where only selected MCPs were being installed.
  • Added Mithun Gowda B as an author.
  • MCP Installer: Addressed several critical bugs in the MCP installation and update process to improve reliability.
    • Corrected the npm package name for the morphllm server in setup/components/mcp.py.
    • Implemented a custom installation method for the serena server using uv, as it is not an npm package.
    • Resolved a NameError in the update command within setup/cli/commands/install.py.
    • Patched a recurring "Unknown component: core" error by ensuring the component registry is initialized only once.
    • Added the claude CLI as a formal prerequisite for MCP server management, which was previously undocumented.

Changed

  • Version bump to 4.1.0

Technical

  • Prepared package for PyPI distribution
  • Validated package structure and dependencies

[4.0.7] - 2025-01-23

Added

  • Automatic update checking for PyPI and NPM packages
  • --no-update-check flag to skip update checks
  • --auto-update flag for automatic updates without prompting
  • Environment variable SUPERCLAUDE_AUTO_UPDATE support
  • Update notifications with colored banners showing available version
  • Rate limiting to check updates once per 24 hours
  • Smart installation method detection (pip/pipx/npm/yarn)
  • Cache files for update check timestamps (~/.claude/.update_check and .npm_update_check)

Fixed

  • Component validation now correctly uses pipx-installed version instead of source code

Technical

  • Added setup/utils/updater.py for PyPI update checking logic
  • Added bin/checkUpdate.js for NPM update checking logic
  • Integrated update checks into main entry points (SuperClaude/main.py and bin/cli.js)
  • Non-blocking update checks with 2-second timeout to avoid delays

Changed

  • BREAKING: Agent system restructured to 14 specialized agents
  • BREAKING: Commands now use /sc: namespace to avoid conflicts with user custom commands
  • Commands are now installed in ~/.claude/commands/sc/ subdirectory
  • All 21 commands updated: /analyze → /sc:analyze, /build → /sc:build, etc.
  • Automatic migration from old command locations to new sc/ subdirectory
  • BREAKING: Documentation reorganization - Docs/ directory renamed to Guides/

Added

  • NEW AGENTS: 14 specialized domain agents with enhanced capabilities
    • backend-architect.md, devops-architect.md, frontend-architect.md
    • learning-guide.md, performance-engineer.md, python-expert.md
    • quality-engineer.md, refactoring-expert.md, requirements-analyst.md
    • root-cause-analyst.md, security-engineer.md, socratic-mentor.md
  • NEW MODE: MODE_Orchestration.md for intelligent tool selection mindset (5 total behavioral modes)
  • NEW COMMAND: /sc:implement for feature and code implementation (addresses v2 user feedback)
  • NEW FILE: CLAUDE.md for project-specific Claude Code instructions
  • Migration logic to move existing commands to new namespace automatically
  • Enhanced uninstaller to handle both old and new command locations
  • Improved command conflict prevention
  • Better command organization and discoverability
  • Comprehensive PyPI publishing infrastructure
  • API key management during SuperClaude MCP setup

Removed

  • BREAKING: Removed Templates/ directory (legacy templates no longer needed)
  • BREAKING: Removed legacy agents and replaced with enhanced 14-agent system

Improved

  • Refactored Modes and MCP documentation for concise behavioral guidance
  • Enhanced project cleanup and gitignore for PyPI publishing
  • Implemented uninstall and update safety enhancements
  • Better agent specialization and domain expertise focus

Technical Details

  • Commands now accessible as /sc:analyze, /sc:build, /sc:improve, etc.
  • Migration preserves existing functionality while preventing naming conflicts
  • Installation process detects and migrates existing commands automatically
  • Tab completion support for /sc: prefix to discover all SuperClaude commands
  • Guides/ directory replaces Docs/ for improved organization

[4.0.6] - 2025-08-23

Fixed

  • Component validation now correctly checks .superclaude-metadata.json instead of settings.json (#291)
  • Standardized version numbers across all components to 4.0.6
  • Fixed agent validation to check for correct filenames (architect vs specialist/engineer)
  • Fixed package.json version inconsistency (was 4.0.5)

Changed

  • Bumped version from 4.0.4 to 4.0.6 across entire project
  • All component versions now synchronized at 4.0.6
  • Cleaned up metadata file structure for consistency

[4.0.4] - 2025-08-22

Added

  • Agent System: 13 specialized domain experts replacing personas
  • Behavioral Modes: 4 intelligent modes for different workflows (Brainstorming, Introspection, Task Management, Token Efficiency)
  • Session Lifecycle: /sc:load and /sc:save for cross-session persistence with Serena MCP
  • New Commands: /sc:brainstorm, /sc:reflect, /sc:save, /sc:select-tool (21 total commands)
  • Serena MCP: Semantic code analysis and memory management
  • Morphllm MCP: Intelligent file editing with Fast Apply capability
  • Core Components: Python-based framework integration (completely redesigned and implemented)
  • Templates: Comprehensive templates for creating new components
  • Python-Ultimate-Expert Agent: Master Python architect for production-ready code

Changed

  • Commands expanded from 16 to 21 specialized commands
  • Personas replaced with 13 specialized Agents
  • Enhanced MCP integration (6 servers total)
  • Improved token efficiency (30-50% reduction with Token Efficiency Mode)
  • Session management now uses Serena integration for persistence
  • Framework structure reorganized for better modularity

Improved

  • Task management with multi-layer orchestration (TodoWrite, /task, /spawn, /loop)
  • Quality gates with 8-step validation cycle
  • Performance monitoring and optimization
  • Cross-session context preservation
  • Intelligent routing with ORCHESTRATOR.md enhancements

[3.0.0] - 2025-07-14

Added

  • Initial release of SuperClaude v3.0
  • 15 specialized slash commands for development tasks
  • Smart persona auto-activation system
  • MCP server integration (Context7, Sequential, Magic, Playwright)
  • Unified CLI installer with multiple installation profiles
  • Comprehensive documentation and user guides
  • Token optimization framework
  • Task management system

Features

  • Commands: analyze, build, cleanup, design, document, estimate, explain, git, improve, index, load, spawn, task, test, troubleshoot
  • Personas: architect, frontend, backend, analyzer, security, mentor, refactorer, performance, qa, devops, scribe
  • MCP Servers: Official library documentation, complex analysis, UI components, browser automation
  • Installation: Quick, minimal, and developer profiles with component selection