mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
328a0a016b
## Changes ### Unified Metadata Location - All components now use `~/.claude/.superclaude-metadata.json` - Previously split between root and superclaude subdirectory - Automatic migration from old location on first load - Eliminates confusion from duplicate metadata files ### Improved Installation Messages - Changed WARNING to INFO for existing installations - Message now clearly states "will be updated" instead of implying problem - Reduces user confusion during reinstalls/updates ### Updated Makefile - `make install`: Development mode (uv, local source, editable) - `make install-release`: Production mode (pipx, from PyPI) - `make dev`: Alias for install - Improved help output with categorized commands ## Technical Details **Metadata Unification** (setup/services/settings.py): - SettingsService now always uses `~/.claude/.superclaude-metadata.json` - Added `_migrate_old_metadata()` for automatic migration - Deep merge strategy preserves existing data - Old file backed up as `.superclaude-metadata.json.migrated` **User File Protection**: - Verified: User-created files preserved during updates - Only SuperClaude-managed files (tracked in metadata) are updated - Obsolete framework files automatically removed ## Migration Path Existing installations automatically migrate on next `make install`: 1. Old metadata detected at `~/.claude/superclaude/.superclaude-metadata.json` 2. Merged into `~/.claude/.superclaude-metadata.json` 3. Old file backed up 4. No user action required 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
94 lines
2.9 KiB
Makefile
94 lines
2.9 KiB
Makefile
.PHONY: install install-release dev test clean lint format uninstall update translate help
|
|
|
|
# Development installation (local source, editable)
|
|
install:
|
|
@echo "Installing SuperClaude Framework (development mode)..."
|
|
uv pip install -e ".[dev]"
|
|
uv run superclaude install
|
|
|
|
# Production installation (from PyPI, recommended for users)
|
|
install-release:
|
|
@echo "Installing SuperClaude Framework (production mode)..."
|
|
@echo "Using pipx for isolated environment..."
|
|
pipx install SuperClaude
|
|
pipx upgrade SuperClaude
|
|
superclaude install
|
|
|
|
# Alias for development installation
|
|
dev: install
|
|
|
|
# Run tests
|
|
test:
|
|
@echo "Running tests..."
|
|
uv run pytest
|
|
|
|
# Linting
|
|
lint:
|
|
@echo "Running linter..."
|
|
uv run ruff check .
|
|
|
|
# Format code
|
|
format:
|
|
@echo "Formatting code..."
|
|
uv run ruff format .
|
|
|
|
# Clean build artifacts
|
|
clean:
|
|
@echo "Cleaning build artifacts..."
|
|
rm -rf build/ dist/ *.egg-info
|
|
find . -type d -name __pycache__ -exec rm -rf {} +
|
|
find . -type d -name .pytest_cache -exec rm -rf {} +
|
|
find . -type d -name .ruff_cache -exec rm -rf {} +
|
|
|
|
# Uninstall SuperClaude components
|
|
uninstall:
|
|
@echo "Uninstalling SuperClaude components..."
|
|
uv run superclaude uninstall
|
|
|
|
# Update SuperClaude components
|
|
update:
|
|
@echo "Updating SuperClaude components..."
|
|
uv run superclaude update
|
|
|
|
# Translate README to multiple languages using Neural CLI
|
|
translate:
|
|
@echo "🌐 Translating README using Neural CLI (Ollama + qwen2.5:3b)..."
|
|
@if [ ! -f ~/.local/bin/neural-cli ]; then \
|
|
echo "📦 Installing neural-cli..."; \
|
|
mkdir -p ~/.local/bin; \
|
|
ln -sf ~/github/neural/src-tauri/target/release/neural-cli ~/.local/bin/neural-cli; \
|
|
echo "✅ neural-cli installed to ~/.local/bin/"; \
|
|
fi
|
|
@echo ""
|
|
@echo "🇨🇳 Translating to Simplified Chinese..."
|
|
@~/.local/bin/neural-cli translate README.md --from English --to "Simplified Chinese" --output README-zh.md
|
|
@echo ""
|
|
@echo "🇯🇵 Translating to Japanese..."
|
|
@~/.local/bin/neural-cli translate README.md --from English --to Japanese --output README-ja.md
|
|
@echo ""
|
|
@echo "✅ Translation complete!"
|
|
@echo "📝 Files updated: README-zh.md, README-ja.md"
|
|
|
|
# Show help
|
|
help:
|
|
@echo "SuperClaude Framework - Available commands:"
|
|
@echo ""
|
|
@echo "Installation:"
|
|
@echo " make install - Development installation (local source, editable with uv)"
|
|
@echo " make install-release - Production installation (from PyPI with pipx)"
|
|
@echo " make dev - Alias for 'make install'"
|
|
@echo ""
|
|
@echo "Development:"
|
|
@echo " make test - Run tests"
|
|
@echo " make lint - Run linter"
|
|
@echo " make format - Format code"
|
|
@echo " make clean - Clean build artifacts"
|
|
@echo ""
|
|
@echo "Maintenance:"
|
|
@echo " make uninstall - Uninstall SuperClaude components"
|
|
@echo " make update - Update SuperClaude components"
|
|
@echo ""
|
|
@echo "Documentation:"
|
|
@echo " make translate - Translate README to Chinese and Japanese (requires Ollama)"
|
|
@echo " make help - Show this help message"
|