External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: consolidate PM Agent optimization and pending changes

Browse Source 
PM Agent optimization (already committed separately):
- superclaude/commands/pm.md: 1652→14 lines
- superclaude/agents/pm-agent.md: 735→429 lines
- docs/agents/pm-agent-guide.md: new guide file

Other pending changes:
- setup: framework_docs, mcp, logger, remove ui.py
- superclaude: __main__, cli/app, cli/commands/install
- tests: test_ui updates
- scripts: workflow metrics analysis tools
- docs/memory: session state updates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kazuki
2025-10-17 04:54:31 +09:00
parent d168278879
commit a4ffe52724
13 changed files with 1298 additions and 1247 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
setup/components/framework_docs.py
View File

@@ -1,5 +1,6 @@
"""
Core component for SuperClaude framework files installation
Framework documentation component for SuperClaude
Manages core framework documentation files (CLAUDE.md, FLAGS.md, PRINCIPLES.md, etc.)
"""
from typing import Dict, List, Tuple, Optional, Any
@@ -11,20 +12,20 @@ from ..services.claude_md import CLAUDEMdService
from setup import __version__
class CoreComponent(Component):
"""Core SuperClaude framework files component"""
class FrameworkDocsComponent(Component):
"""SuperClaude framework documentation files component"""
def __init__(self, install_dir: Optional[Path] = None):
"""Initialize core component"""
"""Initialize framework docs component"""
super().__init__(install_dir)
def get_metadata(self) -> Dict[str, str]:
"""Get component metadata"""
return {
"name": "core",
"name": "framework_docs",
"version": __version__,
"description": "SuperClaude framework documentation and core files",
"category": "core",
"description": "SuperClaude framework documentation (CLAUDE.md, FLAGS.md, PRINCIPLES.md, RULES.md, etc.)",
"category": "documentation",
}
def get_metadata_modifications(self) -> Dict[str, Any]:
@@ -35,7 +36,7 @@ class CoreComponent(Component):
"name": "superclaude",
"description": "AI-enhanced development framework for Claude Code",
"installation_type": "global",
"components": ["core"],
"components": ["framework_docs"],
},
"superclaude": {
"enabled": True,
@@ -46,8 +47,8 @@ class CoreComponent(Component):
}
def _install(self, config: Dict[str, Any]) -> bool:
"""Install core component"""
self.logger.info("Installing SuperClaude core framework files...")
"""Install framework docs component"""
self.logger.info("Installing SuperClaude framework documentation...")
return super()._install(config)
@@ -60,15 +61,15 @@ class CoreComponent(Component):
# Add component registration to metadata
self.settings_manager.add_component_registration(
"core",
"framework_docs",
{
"version": __version__,
"category": "core",
"category": "documentation",
"files_count": len(self.component_files),
},
)
self.logger.info("Updated metadata with core component registration")
self.logger.info("Updated metadata with framework docs component registration")
# Migrate any existing SuperClaude data from settings.json
if self.settings_manager.migrate_superclaude_data():
@@ -86,23 +87,23 @@ class CoreComponent(Component):
if not self.file_manager.ensure_directory(dir_path):
self.logger.warning(f"Could not create directory: {dir_path}")
# Update CLAUDE.md with core framework imports
# Update CLAUDE.md with framework documentation imports
try:
manager = CLAUDEMdService(self.install_dir)
manager.add_imports(self.component_files, category="Core Framework")
self.logger.info("Updated CLAUDE.md with core framework imports")
manager.add_imports(self.component_files, category="Framework Documentation")
self.logger.info("Updated CLAUDE.md with framework documentation imports")
except Exception as e:
self.logger.warning(
f"Failed to update CLAUDE.md with core framework imports: {e}"
f"Failed to update CLAUDE.md with framework documentation imports: {e}"
)
# Don't fail the whole installation for this
return True
def uninstall(self) -> bool:
"""Uninstall core component"""
"""Uninstall framework docs component"""
try:
self.logger.info("Uninstalling SuperClaude core component...")
self.logger.info("Uninstalling SuperClaude framework docs component...")
# Remove framework files
removed_count = 0
@@ -114,10 +115,10 @@ class CoreComponent(Component):
else:
self.logger.warning(f"Could not remove {filename}")
# Update metadata to remove core component
# Update metadata to remove framework docs component
try:
if self.settings_manager.is_component_installed("core"):
self.settings_manager.remove_component_registration("core")
if self.settings_manager.is_component_installed("framework_docs"):
self.settings_manager.remove_component_registration("framework_docs")
metadata_mods = self.get_metadata_modifications()
metadata = self.settings_manager.load_metadata()
for key in metadata_mods.keys():
@@ -125,38 +126,38 @@ class CoreComponent(Component):
del metadata[key]
self.settings_manager.save_metadata(metadata)
self.logger.info("Removed core component from metadata")
self.logger.info("Removed framework docs component from metadata")
except Exception as e:
self.logger.warning(f"Could not update metadata: {e}")
self.logger.success(
f"Core component uninstalled ({removed_count} files removed)"
f"Framework docs component uninstalled ({removed_count} files removed)"
)
return True
except Exception as e:
self.logger.exception(f"Unexpected error during core uninstallation: {e}")
self.logger.exception(f"Unexpected error during framework docs uninstallation: {e}")
return False
def get_dependencies(self) -> List[str]:
"""Get component dependencies (core has none)"""
"""Get component dependencies (framework docs has none)"""
return []
def update(self, config: Dict[str, Any]) -> bool:
"""Update core component"""
"""Update framework docs component"""
try:
self.logger.info("Updating SuperClaude core component...")
self.logger.info("Updating SuperClaude framework docs component...")
# Check current version
current_version = self.settings_manager.get_component_version("core")
current_version = self.settings_manager.get_component_version("framework_docs")
target_version = self.get_metadata()["version"]
if current_version == target_version:
self.logger.info(f"Core component already at version {target_version}")
self.logger.info(f"Framework docs component already at version {target_version}")
return True
self.logger.info(
f"Updating core component from {current_version} to {target_version}"
f"Updating framework docs component from {current_version} to {target_version}"
)
# Create backup of existing files
@@ -181,7 +182,7 @@ class CoreComponent(Component):
pass # Ignore cleanup errors
self.logger.success(
f"Core component updated to version {target_version}"
f"Framework docs component updated to version {target_version}"
)
else:
# Restore from backup on failure
@@ -197,11 +198,11 @@ class CoreComponent(Component):
return success
except Exception as e:
self.logger.exception(f"Unexpected error during core update: {e}")
self.logger.exception(f"Unexpected error during framework docs update: {e}")
return False
def validate_installation(self) -> Tuple[bool, List[str]]:
"""Validate core component installation"""
"""Validate framework docs component installation"""
errors = []
# Check if all framework files exist
@@ -213,11 +214,11 @@ class CoreComponent(Component):
errors.append(f"Framework file is not a regular file: {filename}")
# Check metadata registration
if not self.settings_manager.is_component_installed("core"):
errors.append("Core component not registered in metadata")
if not self.settings_manager.is_component_installed("framework_docs"):
errors.append("Framework docs component not registered in metadata")
else:
# Check version matches
installed_version = self.settings_manager.get_component_version("core")
installed_version = self.settings_manager.get_component_version("framework_docs")
expected_version = self.get_metadata()["version"]
if installed_version != expected_version:
errors.append(
@@ -240,9 +241,9 @@ class CoreComponent(Component):
return len(errors) == 0, errors
def _get_source_dir(self):
"""Get source directory for framework files"""
# Assume we're in superclaude/setup/components/core.py
# and framework files are in superclaude/superclaude/Core/
"""Get source directory for framework documentation files"""
# Assume we're in superclaude/setup/components/framework_docs.py
# and framework files are in superclaude/superclaude/core/
project_root = Path(__file__).parent.parent.parent
return project_root / "superclaude" / "core"