Merge branch 'SuperClaude-Org:main' into main

Author: nevil06

CLAUDE.md

@@ -375,7 +375,7 @@ SuperGemini --version
 ```
 
 **Version Update Process**:
-1. Update `VERSION` file (e.g., `4.2.1` → `4.2.2`)
+1. Update `VERSION` file (e.g., `4.3.0` → `4.2.2`)
 2. Version automatically propagates to:
    - `pyproject.toml` (dynamic = {file = "VERSION"})
    - `setup.py` (`get_version()` reads VERSION file)

PUBLISHING.md

@@ -408,9 +408,9 @@ git push origin v4.0.1
 ```
 
 **Pre-release Versions:**
-- **Alpha**: 4.2.1a1 (early development, unstable)
-- **Beta**: 4.2.1b1 (feature complete, testing phase)
-- **Release Candidate**: 4.2.1rc1 (production candidate, final testing)
+- **Alpha**: 4.3.0a1 (early development, unstable)
+- **Beta**: 4.3.0b1 (feature complete, testing phase)
+- **Release Candidate**: 4.3.0rc1 (production candidate, final testing)
 **Version Validation Checklist:**
 
 **Pre-Release Validation:**

README.md

@@ -1,4 +1,4 @@
-# SuperGemini v4.2.1 🚀
+# SuperGemini v4.3.0 🚀
 <a href="https://github.com/SuperClaude-Org/SuperClaude_Framework" target="_blank">
   <img src="https://img.shields.io/badge/Try-SuperClaude_Framework-brightgreen" alt="Try SuperClaude Framework"/>
 </a>
@@ -8,7 +8,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PyPI version](https://img.shields.io/pypi/v/SuperGemini.svg)](https://pypi.org/project/SuperGemini/)
-[![Version](https://img.shields.io/badge/version-4.2.1-blue.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework)
+[![Version](https://img.shields.io/badge/version-4.3.0-blue.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework)
 [![GitHub issues](https://img.shields.io/github/issues/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/issues)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/SuperClaude-Org/SuperGemini_Framework/blob/master/CONTRIBUTING.md)
 [![Contributors](https://img.shields.io/github/contributors/SuperClaude-Org/SuperGemini_Framework)](https://github.com/SuperClaude-Org/SuperGemini_Framework/graphs/contributors)

SuperGemini/MCP/MCP_Magic.md

@@ -2,6 +2,18 @@
 
 **Purpose**: Modern UI component generation from 21st.dev patterns with design system integration
 
+## Gemini CLI Compatibility Warning
+
+**Status**: NOT COMPATIBLE with Gemini CLI (as of December 2025)
+
+**Issue**: The `@21st-dev/magic` package exports tool names that start with `21st_` (e.g., `21st_magic_component_builder`). Gemini's API requires function names to start with a letter or underscore, not a number.
+
+**Error**: `[FIELD_INVALID] Invalid function name. Must start with a letter or an underscore.`
+
+**Workaround**: SuperGemini automatically installs this server as DISABLED. You can enable it once the `@21st-dev/magic` package is updated to use compliant tool names.
+
+**Tracking**: This issue affects Gemini CLI only. The magic server works fine with Claude Code and other MCP clients.
+
 ## Triggers
 - UI component requests: button, form, modal, card, table, nav
 - Design system implementation needs

SuperGemini/MCP/configs/magic.json

@@ -7,6 +7,7 @@
     ],
     "env": {
       "TWENTYFIRST_API_KEY": ""
-    }
+    },
+    "_geminiCompatibility": "NOT_COMPATIBLE - Tool names start with '21st_' which violates Gemini function naming rules"
   }
 }

SuperGemini/Modes/__init__.py

@@ -22,9 +22,9 @@
         if version_file.exists():
             __version__ = version_file.read_text().strip()
         else:
-            __version__ = "4.2.1"  # Fallback
+            __version__ = "4.3.0"  # Fallback
     except Exception:
-        __version__ = "4.2.1"  # Final fallback
+        __version__ = "4.3.0"  # Final fallback
 __author__ = "NomenAK, Mithun Gowda B"
 __email__ = "[email protected]"
 __license__ = "MIT"

SuperGemini/__init__.py

@@ -22,9 +22,9 @@
         if version_file.exists():
             __version__ = version_file.read_text().strip()
         else:
-            __version__ = "4.2.1"  # Fallback
+            __version__ = "4.3.0"  # Fallback
     except Exception:
-        __version__ = "4.2.1"  # Final fallback
+        __version__ = "4.3.0"  # Final fallback
 __author__ = "Mithun Gowda B, NomenAK"
 __email__ = "[email protected]"
 __license__ = "MIT"

SuperGemini/__main__.py

@@ -23,7 +23,7 @@
     from .version import __version__
 except ImportError:
     # Fallback if module structure is broken
-    __version__ = "4.2.1"
+    __version__ = "4.3.0"
 
 # Add the 'setup' directory to the Python import path (modern approach)
 

SuperGemini/version.py

@@ -26,6 +26,6 @@ def get_version() -> str:
             continue
 
     # Fallback version - no logging needed since this is expected behavior
-    return "4.2.1"
+    return "4.3.0"
 
 __version__ = get_version()

VERSION

@@ -1 +1 @@
-4.2.1
+4.3.0