claude-mpm 4.16.3__tar.gz → 4.17.1__tar.gz

claude_mpm-4.17.1/BUILD_NUMBER

@@ -0,0 +1 @@
+483

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/MANIFEST.in

@@ -18,6 +18,12 @@ recursive-include src/claude_mpm/agents *.md *.json
 recursive-include src/claude_mpm/agents/templates *.json
 recursive-include src/claude_mpm/framework *.md *.json
 
+# Include skills (bundled markdown files)
+recursive-include src/claude_mpm/skills/bundled *.md
+
+# Include all command files
+recursive-include src/claude_mpm/commands *.md
+
 # Include scripts
 include scripts/ticket
 include scripts/run_mpm.py

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.16.3
+Version: 4.17.1
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team
@@ -310,7 +310,7 @@ Agents learn project-specific patterns using a simple list format and can update
 
 Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
 
-**20 Bundled Skills** covering essential development workflows:
+**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
 - Git workflow, TDD, code review, systematic debugging
 - API documentation, refactoring patterns, performance profiling
 - Docker containerization, database migrations, security scanning
@@ -323,6 +323,11 @@ Claude MPM includes a powerful skills system that eliminates redundant agent gui
 - **User**: Custom skills in `~/.config/claude-mpm/skills/`
 - **Project**: Project-specific skills in `.claude-mpm/skills/`
 
+**Version Tracking:**
+- All skills support semantic versioning (MAJOR.MINOR.PATCH)
+- Check versions with `/mpm-version` command in Claude Code
+- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
+
 **Quick Access:**
 ```bash
 # Interactive skills management

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/README.md

@@ -162,7 +162,7 @@ Agents learn project-specific patterns using a simple list format and can update
 
 Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
 
-**20 Bundled Skills** covering essential development workflows:
+**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
 - Git workflow, TDD, code review, systematic debugging
 - API documentation, refactoring patterns, performance profiling
 - Docker containerization, database migrations, security scanning
@@ -175,6 +175,11 @@ Claude MPM includes a powerful skills system that eliminates redundant agent gui
 - **User**: Custom skills in `~/.config/claude-mpm/skills/`
 - **Project**: Project-specific skills in `.claude-mpm/skills/`
 
+**Version Tracking:**
+- All skills support semantic versioning (MAJOR.MINOR.PATCH)
+- Check versions with `/mpm-version` command in Claude Code
+- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
+
 **Quick Access:**
 ```bash
 # Interactive skills management

claude_mpm-4.17.1/VERSION

@@ -0,0 +1 @@
+4.17.1

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.16.3"
+version = "4.17.1"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -84,7 +84,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.16.3"
+version = "4.17.1"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true
@@ -97,14 +97,14 @@ changelog_incremental = true
 "src/claude_mpm/skills/skill_manager.py" = [ "PTH123",]
 
 [tool.setuptools.package-data]
-claude_mpm = [ "VERSION", "BUILD_NUMBER", "scripts/*", "scripts/*.sh", "commands/*.md", "dashboard/*.html", "dashboard/templates/*.html", "dashboard/static/*.css", "dashboard/static/*.js", "dashboard/static/css/*.css", "dashboard/static/js/*.js", "dashboard/static/js/components/*.js", "agents/*.md", "agents/*.json", "agents/*.yaml", "agents/templates/*.json", "agents/schema/*.json", "hooks/**/*.py", "hooks/**/*.sh", "hooks/claude_hooks/*", "hooks/claude_hooks/**/*",]
+claude_mpm = [ "VERSION", "BUILD_NUMBER", "scripts/*", "scripts/*.sh", "commands/*.md", "skills/bundled/*.md", "dashboard/*.html", "dashboard/templates/*.html", "dashboard/static/*.css", "dashboard/static/*.js", "dashboard/static/css/*.css", "dashboard/static/js/*.js", "dashboard/static/js/components/*.js", "agents/*.md", "agents/*.json", "agents/*.yaml", "agents/templates/*.json", "agents/schema/*.json", "hooks/**/*.py", "hooks/**/*.sh", "hooks/claude_hooks/*", "hooks/claude_hooks/**/*",]
 
 [tool.pytest.ini_options]
 testpaths = [ "tests",]
 python_files = [ "test_*.py", "*_test.py",]
 python_classes = [ "Test*",]
 python_functions = [ "test_*",]
-addopts = [ "-v", "--tb=short", "--strict-markers", "--disable-warnings", "--asyncio-mode=auto",]
+addopts = [ "--tb=short", "--strict-markers", "--disable-warnings", "--asyncio-mode=auto",]
 markers = [ "unit: Unit tests", "integration: Integration tests", "e2e: End-to-end tests", "regression: Regression tests", "socketio: Socket.IO related tests", "hook: Hook system tests",]
 asyncio_mode = "auto"
 

claude_mpm-4.17.1/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.17.1

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/src/claude_mpm/commands/mpm-help.md

@@ -90,6 +90,9 @@ Available Commands:
 /mpm-monitor [start|stop|restart|status|port]
   Manage Socket.IO monitoring server and dashboard
 
+/mpm-version
+  Display comprehensive version information including project version, all agents with versions, and all skills with versions
+
 Use '/mpm-help <command>' for detailed help on a specific command.
 ```
 

claude_mpm-4.17.1/src/claude_mpm/commands/mpm-version.md

@@ -0,0 +1,113 @@
+# Display Claude MPM Version Information
+
+Show comprehensive version information for Claude MPM project, agents, and skills.
+
+## Usage
+
+```
+/mpm-version
+```
+
+## Description
+
+Display version information including:
+- Project version and build number
+- All deployed agents with their versions (grouped by tier: system/user/project)
+- All available skills with their versions (grouped by source: bundled/user/project)
+- Summary statistics
+
+## Implementation
+
+When you run `/mpm-version`, the PM will:
+
+1. **Collect Version Information**
+   - Use VersionService to gather all version data
+   - Project version from pyproject.toml
+   - Build number from BUILD_NUMBER file
+   - Agent versions from AgentRegistry
+   - Skills versions from SkillRegistry
+
+2. **Format Output**
+   - Hierarchical display: Project → Agents → Skills
+   - Grouped by tier/source for clarity
+   - Sorted alphabetically within groups
+   - Summary statistics at the end
+
+3. **Display Results**
+   - Well-formatted tree structure
+   - Easy to scan and read
+   - Includes totals and counts
+
+## Example Output
+
+```
+Claude MPM Version Information
+==============================
+
+Project Version: 4.16.3
+Build: 481
+
+Agents (35 total)
+-----------------
+
+System Agents (30):
+  ├─ agent-manager (1.0.0)
+  ├─ engineer (3.9.1)
+  ├─ research-agent (4.5.1)
+  ├─ documentation (2.1.0)
+  ├─ qa (2.0.3)
+  └─ ... (25 more)
+
+User Agents (3):
+  ├─ custom-agent (1.0.0)
+  ├─ testing-agent (0.5.0)
+  └─ prototype-agent (0.1.0)
+
+Project Agents (2):
+  ├─ project-specific (2.0.0)
+  └─ domain-expert (1.1.0)
+
+Skills (20 total)
+-----------------
+
+Bundled Skills (20):
+  ├─ test-driven-development (0.1.0)
+  ├─ systematic-debugging (0.1.0)
+  ├─ async-testing (0.1.0)
+  ├─ performance-profiling (0.1.0)
+  ├─ security-scanning (0.1.0)
+  └─ ... (15 more)
+
+User Skills (0):
+  (none)
+
+Project Skills (0):
+  (none)
+
+Summary
+-------
+• Project: v4.16.3 (build 481)
+• Agents: 35 total (30 system, 3 user, 2 project)
+• Skills: 20 total (20 bundled, 0 user, 0 project)
+```
+
+## PM Implementation Instructions
+
+To execute this command, PM should:
+
+1. Import and use VersionService:
+   ```python
+   from claude_mpm.services.version_service import VersionService
+
+   service = VersionService()
+   summary = service.get_version_summary()
+   ```
+
+2. Format output following the example structure above
+3. Handle missing data gracefully (show "unknown" for missing versions)
+4. Include all tiers/sources even if counts are zero
+
+## Related Commands
+
+- `/mpm-help` - Show all available MPM commands
+- `/mpm-status` - Show system status information

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/src/claude_mpm/commands/mpm.md

@@ -8,6 +8,7 @@ Available MPM commands:
 - /mpm-help - Show command help
 - /mpm-status - Show MPM status
 - /mpm-config - Manage configuration
+- /mpm-version - Display version information for project, agents, and skills
 
 Claude MPM extends Claude Code with:
 - Multi-agent orchestration

{claude_mpm-4.16.3 → claude_mpm-4.17.1}/src/claude_mpm/services/version_service.py

@@ -9,7 +9,7 @@ Extracted from ClaudeRunner to follow Single Responsibility Principle.
 """
 
 from pathlib import Path
-from typing import Any, Dict, Optional
+from typing import Any, Dict, List, Optional
 
 from claude_mpm.config.paths import paths
 from claude_mpm.core.base_service import BaseService
@@ -274,3 +274,106 @@ class VersionService(BaseService, VersionServiceInterface):
             "message": "Update checking not implemented",
             "checked_at": None,
         }
+
+    def get_agents_versions(self) -> Dict[str, List[Dict[str, str]]]:
+        """Get all agents grouped by tier with versions.
+
+        Returns:
+            Dict with keys: system, user, project
+            Each value is list of agent dicts with: name, version, id
+        """
+        from claude_mpm.core.unified_agent_registry import get_agent_registry
+
+        agents_by_tier = {"system": [], "user": [], "project": []}
+
+        try:
+            registry = get_agent_registry()
+            all_agents = registry.list_agents()
+
+            for agent in all_agents:
+                agent_info = {
+                    "name": agent.name,
+                    "version": agent.version,
+                    "id": agent.name,  # Use name as ID since agent_id doesn't exist
+                }
+                tier = (
+                    agent.tier.value
+                    if hasattr(agent.tier, "value")
+                    else str(agent.tier)
+                )
+                if tier in agents_by_tier:
+                    agents_by_tier[tier].append(agent_info)
+                else:
+                    agents_by_tier["system"].append(agent_info)
+
+            # Sort each tier alphabetically by name
+            for tier, agents in agents_by_tier.items():
+                agents.sort(key=lambda x: x["name"])
+
+        except Exception as e:
+            self.logger.error(f"Failed to get agent versions: {e}")
+
+        return agents_by_tier
+
+    def get_skills_versions(self) -> Dict[str, List[Dict[str, str]]]:
+        """Get all skills grouped by source with versions.
+
+        Returns:
+            Dict with keys: bundled, user, project
+            Each value is list of skill dicts with: name, version, description
+        """
+        from claude_mpm.skills.registry import get_registry
+
+        skills_by_source = {"bundled": [], "user": [], "project": []}
+
+        try:
+            registry = get_registry()
+
+            for skill in registry.list_skills():
+                skill_info = {
+                    "name": skill.name,
+                    "version": skill.version,
+                    "description": (
+                        skill.description[:60] + "..."
+                        if len(skill.description) > 60
+                        else skill.description
+                    ),
+                }
+                source = skill.source if skill.source in skills_by_source else "bundled"
+                skills_by_source[source].append(skill_info)
+
+            # Sort each source alphabetically by name
+            for source, skills in skills_by_source.items():
+                skills.sort(key=lambda x: x["name"])
+
+        except Exception as e:
+            self.logger.error(f"Failed to get skill versions: {e}")
+
+        return skills_by_source
+
+    def get_version_summary(self) -> Dict:
+        """Get complete version summary.
+
+        Returns:
+            Dict with project_version, build, agents, skills, and counts
+        """
+        agents = self.get_agents_versions()
+        skills = self.get_skills_versions()
+        build = self.get_build_number()
+
+        return {
+            "project_version": self.get_base_version(),
+            "build": build,
+            "agents": agents,
+            "skills": skills,
+            "counts": {
+                "agents_total": sum(len(v) for v in agents.values()),
+                "agents_system": len(agents.get("system", [])),
+                "agents_user": len(agents.get("user", [])),
+                "agents_project": len(agents.get("project", [])),
+                "skills_total": sum(len(v) for v in skills.values()),
+                "skills_bundled": len(skills.get("bundled", [])),
+                "skills_user": len(skills.get("user", [])),
+                "skills_project": len(skills.get("project", [])),
+            },
+        }