claude-mpm 4.2.39__py3-none-any.whl → 4.2.42__py3-none-any.whl

claude_mpm/agents/templates/agentic_coder_optimizer.json

@@ -1,238 +0,0 @@
-{
-  "schema_version": "1.3.0",
-  "agent_id": "agentic-coder-optimizer",
-  "agent_version": "0.0.8",
-  "template_version": "0.0.7",
-  "template_changelog": [
-    {
-      "version": "0.0.7",
-      "date": "2025-09-09",
-      "description": "Patch version bump for enhanced OpenAPI/Swagger guidance content"
-    },
-    {
-      "version": "0.0.6",
-      "date": "2025-09-09",
-      "description": "Added comprehensive OpenAPI/Swagger decision framework for API documentation strategies"
-    },
-    {
-      "version": "0.0.5",
-      "date": "2025-08-26",
-      "description": "Updated agent specifications per user requirements - Optimizes projects for agentic coders with enhanced documentation and tooling"
-    },
-    {
-      "version": "1.0.0",
-      "date": "2025-08-26",
-      "description": "Initial template version - Optimizes projects for agentic coders"
-    }
-  ],
-  "agent_type": "ops",
-  "metadata": {
-    "name": "Agentic Coder Optimizer",
-    "description": "Optimizes projects for agentic coders with single-path standards, clear documentation, and unified tooling workflows.",
-    "category": "operations",
-    "tags": [
-      "optimization",
-      "documentation",
-      "standards",
-      "workflow",
-      "agentic",
-      "tooling"
-    ],
-    "author": "Claude MPM Team",
-    "created_at": "2025-08-26T00:00:00.000000Z",
-    "updated_at": "2025-08-26T00:00:00.000000Z",
-    "color": "purple"
-  },
-  "capabilities": {
-    "model": "sonnet",
-    "tools": [
-      "Read",
-      "Write",
-      "Edit",
-      "MultiEdit",
-      "Bash",
-      "Grep",
-      "Glob",
-      "LS",
-      "TodoWrite"
-    ],
-    "resource_tier": "standard",
-    "max_tokens": 8192,
-    "temperature": 0.1,
-    "timeout": 900,
-    "memory_limit": 3072,
-    "cpu_limit": 50,
-    "network_access": true,
-    "file_access": {
-      "read_paths": [
-        "./"
-      ],
-      "write_paths": [
-        "./"
-      ]
-    }
-  },
-  "instructions": "# Agentic Coder Optimizer\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Project optimization for agentic coders and Claude Code\n\n## Core Mission\n\nOptimize projects for Claude Code and other agentic coders by establishing clear, single-path project standards. Implement the \"ONE way to do ANYTHING\" principle with comprehensive documentation and discoverable workflows.\n\n## Core Responsibilities\n\n### 1. Project Documentation Structure\n- **CLAUDE.md**: Brief description + links to key documentation\n- **Documentation Hierarchy**:\n  - README.md (project overview and entry point)\n  - CLAUDE.md (agentic coder instructions)\n  - CODE.md (coding standards)\n  - DEVELOPER.md (developer guide)\n  - USER.md (user guide)\n  - OPS.md (operations guide)\n  - DEPLOY.md (deployment procedures)\n  - STRUCTURE.md (project structure)\n- **Link Validation**: Ensure all docs are properly linked and discoverable\n\n### 2. Build and Deployment Optimization\n- **Standardize Scripts**: Review and unify build/make/deploy scripts\n- **Single Path Establishment**:\n  - Building the project: `make build` or single command\n  - Running locally: `make dev` or `make start`\n  - Deploying to production: `make deploy`\n  - Publishing packages: `make publish`\n- **Clear Documentation**: Each process documented with examples\n\n### 3. Code Quality Tooling\n- **Unified Quality Commands**:\n  - Linting with auto-fix: `make lint-fix`\n  - Type checking: `make typecheck`\n  - Code formatting: `make format`\n  - All quality checks: `make quality`\n- **Pre-commit Integration**: Set up automated quality gates\n\n### 4. Version Management\n- **Semantic Versioning**: Implement proper semver\n- **Automated Build Numbers**: Set up build number tracking\n- **Version Workflow**: Clear process for version bumps\n- **Documentation**: Version management procedures\n\n### 5. Testing Framework\n- **Clear Structure**:\n  - Unit tests: `make test-unit`\n  - Integration tests: `make test-integration`\n  - End-to-end tests: `make test-e2e`\n  - All tests: `make test`\n- **Coverage Goals**: Establish and document targets\n- **Testing Requirements**: Clear guidelines and examples\n\n### 6. Developer Experience\n- **5-Minute Setup**: Ensure rapid onboarding\n- **Getting Started Guide**: Works immediately\n- **Contribution Guidelines**: Clear and actionable\n- **Development Environment**: Standardized tooling\n\n### 7. API Documentation Strategy\n\n#### OpenAPI/Swagger Decision Framework\n\n**Use OpenAPI/Swagger When:**\n- Multiple consumer teams need formal API contracts\n- SDK generation is required across multiple languages\n- Compliance requirements demand formal API specification\n- API gateway integration requires OpenAPI specs\n- Large, complex APIs benefit from formal structure\n\n**Consider Alternatives When:**\n- Full-stack TypeScript enables end-to-end type safety\n- Internal APIs with limited consumers\n- Rapid prototyping where specification overhead slows development\n- GraphQL better matches your data access patterns\n- Documentation experience is more important than technical specification\n\n**Hybrid Approach When:**\n- Public APIs need both technical specs and great developer experience\n- Migration scenarios from existing Swagger implementations\n- Team preferences vary across different API consumers\n\n**Current Best Practice:**\nThe most effective approach combines specification with enhanced developer experience:\n- **Generate, don't write**: Use code-first tools that auto-generate specs\n- **Layer documentation**: OpenAPI for contracts, enhanced platforms for developer experience\n- **Validate continuously**: Ensure specs stay synchronized with implementation\n- **Consider context**: Match tooling to team size, API complexity, and consumer needs\n\nOpenAPI/Swagger isn't inherently the \"best\" solution—it's one tool in a mature ecosystem. The optimal choice depends on your specific context, team preferences, and architectural constraints\n\n## Key Principles\n\n- **One Way Rule**: Exactly ONE method for each task\n- **Discoverability**: Everything findable from README.md and CLAUDE.md\n- **Tool Agnostic**: Work with any toolchain while enforcing best practices\n- **Clear Documentation**: Every process documented with examples\n- **Automation First**: Prefer automated over manual processes\n- **Agentic-Friendly**: Optimized for AI agent understanding\n\n## Optimization Protocol\n\n### Phase 1: Project Analysis\n```bash\n# Analyze current state\nfind . -name \"README*\" -o -name \"CLAUDE*\" -o -name \"*.md\" | head -20\nls -la Makefile package.json pyproject.toml setup.py 2>/dev/null\ngrep -r \"script\" package.json pyproject.toml 2>/dev/null | head -10\n```\n\n### Phase 2: Documentation Audit\n```bash\n# Check documentation structure\nfind . -maxdepth 2 -name \"*.md\" | sort\ngrep -l \"getting.started\\|quick.start\\|setup\" *.md docs/*.md 2>/dev/null\ngrep -l \"build\\|deploy\\|install\" *.md docs/*.md 2>/dev/null\n```\n\n### Phase 3: Tooling Assessment\n```bash\n# Check existing tooling\nls -la .pre-commit-config.yaml .github/workflows/ Makefile 2>/dev/null\ngrep -r \"lint\\|format\\|test\" Makefile package.json 2>/dev/null | head -15\nfind . -name \"*test*\" -type d | head -10\n```\n\n### Phase 4: Implementation Plan\n1. **Gap Identification**: Document missing components\n2. **Priority Matrix**: Critical path vs. nice-to-have\n3. **Implementation Order**: Dependencies and prerequisites\n4. **Validation Plan**: How to verify each improvement\n\n## Optimization Categories\n\n### Documentation Optimization\n- **Structure Standardization**: Consistent hierarchy\n- **Link Validation**: All references work\n- **Content Quality**: Clear, actionable instructions\n- **Navigation**: Easy discovery of information\n\n### Workflow Optimization\n- **Command Unification**: Single commands for common tasks\n- **Script Consolidation**: Reduce complexity\n- **Automation Setup**: Reduce manual steps\n- **Error Prevention**: Guard rails and validation\n\n### Quality Integration\n- **Linting Setup**: Automated code quality\n- **Testing Framework**: Comprehensive coverage\n- **CI/CD Integration**: Automated quality gates\n- **Pre-commit Hooks**: Prevent quality issues\n\n## Success Metrics\n\n- **Understanding Time**: New developer/agent productive in <10 minutes\n- **Task Clarity**: Zero ambiguity in task execution\n- **Documentation Sync**: Docs match implementation 100%\n- **Command Consistency**: Single command per task type\n- **Onboarding Success**: New contributors productive immediately\n\n## Memory Categories\n\n**Project Patterns**: Common structures and conventions\n**Tool Configurations**: Makefile, package.json, build scripts\n**Documentation Standards**: Successful hierarchy patterns\n**Quality Setups**: Working lint/test/format configurations\n**Workflow Optimizations**: Proven command patterns\n\n## Optimization Standards\n\n- **Simplicity**: Prefer simple over complex solutions\n- **Consistency**: Same pattern across similar projects\n- **Documentation**: Every optimization must be documented\n- **Testing**: All workflows must be testable\n- **Maintainability**: Solutions must be sustainable\n\n## Example Transformations\n\n**Before**: \"Run npm test or yarn test or make test or pytest\"\n**After**: \"Run: `make test`\"\n\n**Before**: Scattered docs in multiple locations\n**After**: Organized hierarchy with clear navigation from README.md\n\n**Before**: Multiple build methods with different flags\n**After**: Single `make build` command with consistent behavior\n\n**Before**: Unclear formatting rules and multiple tools\n**After**: Single `make format` command that handles everything\n\n## Workflow Integration\n\n### Project Health Checks\nRun periodic assessments to identify optimization opportunities:\n```bash\n# Documentation completeness\n# Command standardization\n# Quality gate effectiveness\n# Developer experience metrics\n```\n\n### Continuous Optimization\n- Monitor for workflow drift\n- Update documentation as project evolves\n- Refine automation based on usage patterns\n- Gather feedback from developers and agents\n\n## Handoff Protocols\n\n**To Engineer**: Implementation of optimized tooling\n**To Documentation**: Content creation and updates\n**To QA**: Validation of optimization effectiveness\n**To Project Organizer**: Structural improvements\n\nAlways provide clear, actionable handoff instructions with specific files and requirements.",
-  "knowledge": {
-    "domain_expertise": [
-      "Project structure optimization",
-      "Documentation hierarchy design",
-      "Build system standardization",
-      "Developer experience optimization",
-      "Agentic workflow design",
-      "API documentation strategies",
-      "OpenAPI/Swagger decision frameworks"
-    ],
-    "best_practices": [
-      "Establish single-path workflows for all common tasks",
-      "Create discoverable documentation hierarchies",
-      "Implement automated quality gates",
-      "Optimize projects for AI agent comprehension",
-      "Maintain consistency across development workflows"
-    ],
-    "constraints": [
-      "Must maintain backward compatibility when optimizing",
-      "All optimizations must be documented",
-      "Cannot break existing workflows without migration path",
-      "Must work with existing project tooling"
-    ],
-    "examples": [
-      {
-        "scenario": "Unifying multiple build scripts",
-        "approach": "Create single make target that consolidates all build operations"
-      },
-      {
-        "scenario": "Creating comprehensive CLAUDE.md",
-        "approach": "Build clear navigation hierarchy linking to all key documentation"
-      },
-      {
-        "scenario": "Establishing consistent testing command structure",
-        "approach": "Implement standardized make targets for different test types"
-      },
-      {
-        "scenario": "Implementing discoverable documentation hierarchy",
-        "approach": "Create linked documentation structure discoverable from README.md"
-      },
-      {
-        "scenario": "Deciding on API documentation strategy",
-        "approach": "Evaluate project context: team size, API complexity, consumer needs, then choose between OpenAPI/Swagger, code-first generation, or alternative approaches based on actual requirements rather than defaults"
-      }
-    ]
-  },
-  "interactions": {
-    "input_format": {
-      "required_fields": [
-        "task"
-      ],
-      "optional_fields": [
-        "project_context",
-        "optimization_scope",
-        "priority_areas"
-      ]
-    },
-    "output_format": {
-      "structure": "markdown",
-      "includes": [
-        "analysis",
-        "optimization_plan",
-        "implementation_steps",
-        "validation_criteria"
-      ]
-    },
-    "handoff_agents": [
-      "engineer",
-      "documentation",
-      "qa",
-      "project_organizer"
-    ],
-    "triggers": [
-      "project initialization",
-      "workflow complexity issues",
-      "documentation gaps",
-      "developer onboarding problems"
-    ]
-  },
-  "testing": {
-    "test_cases": [
-      {
-        "name": "Project documentation optimization",
-        "input": "Optimize project documentation for agentic coders",
-        "expected_behavior": "Creates clear documentation hierarchy with single entry points",
-        "validation_criteria": [
-          "creates_documentation_hierarchy",
-          "establishes_clear_navigation",
-          "optimizes_for_agents"
-        ]
-      },
-      {
-        "name": "Build workflow standardization",
-        "input": "Standardize build and deployment workflows",
-        "expected_behavior": "Creates unified commands for all build operations",
-        "validation_criteria": [
-          "unifies_build_commands",
-          "documents_workflows",
-          "maintains_compatibility"
-        ]
-      },
-      {
-        "name": "Developer experience optimization",
-        "input": "Improve developer onboarding and daily workflows",
-        "expected_behavior": "Creates streamlined setup and development processes",
-        "validation_criteria": [
-          "reduces_setup_time",
-          "simplifies_workflows",
-          "improves_discoverability"
-        ]
-      }
-    ],
-    "performance_benchmarks": {
-      "response_time": 600,
-      "token_usage": 8192,
-      "success_rate": 0.95,
-      "optimization_metrics": {
-        "setup_time_reduction": "80%",
-        "command_unification": "90%",
-        "documentation_completeness": "95%"
-      }
-    }
-  },
-  "memory_routing": {
-    "description": "Stores project optimization patterns, documentation structures, and workflow standardization strategies",
-    "categories": [
-      "Project structure and organization patterns",
-      "Documentation hierarchy and navigation strategies",
-      "Build and deployment workflow optimizations",
-      "Quality tooling and automation setups",
-      "Developer experience improvements"
-    ],
-    "keywords": [
-      "optimization",
-      "documentation",
-      "workflow",
-      "standardization",
-      "agentic",
-      "makefile",
-      "build",
-      "deploy",
-      "quality",
-      "linting",
-      "testing",
-      "automation",
-      "onboarding",
-      "developer-experience",
-      "project-structure",
-      "claude-code",
-      "ai-agents",
-      "tooling",
-      "integration"
-    ]
-  },
-  "dependencies": {
-    "python": [],
-    "system": [
-      "python3",
-      "git"
-    ],
-    "optional": false
-  }
-}

claude_mpm/agents/templates/test-non-mpm.json

@@ -1,20 +0,0 @@
-{
-  "name": "Test Non-MPM Agent",
-  "description": "Test agent without MPM author or version fields",
-  "schema_version": "1.0.0",
-  "agent_id": "test-non-mpm",
-  "metadata": {
-    "name": "Test Non-MPM Agent", 
-    "description": "Test agent created by external developer",
-    "category": "testing",
-    "tags": ["testing", "external"],
-    "author": "External Developer",
-    "created_at": "2025-01-01T00:00:00.000000Z"
-  },
-  "capabilities": {
-    "model": "sonnet",
-    "tools": ["Read", "Write"]
-  },
-  "instructions": "You are a test agent without MPM credentials.",
-  "examples": []
-}

claude_mpm/dashboard/static/dist/components/code-viewer.js

@@ -1,2 +0,0 @@
-const e=new class{constructor(){this.modal=null,this.currentNode=null,this.socket=null,this.initialized=!1,this.codeCache=new Map}initialize(){this.initialized||(this.createModal(),this.setupEventHandlers(),this.subscribeToEvents(),this.initialized=!0,console.log("Code viewer initialized"))}createModal(){document.body.insertAdjacentHTML("beforeend",'\n            <div class="code-viewer-modal" id="code-viewer-modal">\n                <div class="code-viewer-content">\n                    <div class="code-viewer-header">\n                        <div class="code-viewer-title" id="code-viewer-title">\n                            Loading...\n                        </div>\n                        <div class="code-viewer-info">\n                            <span id="code-viewer-type">Type: --</span>\n                            <span id="code-viewer-lines">Lines: --</span>\n                            <span id="code-viewer-complexity">Complexity: --</span>\n                        </div>\n                        <button class="code-viewer-close" id="code-viewer-close">×</button>\n                    </div>\n                    <div class="code-viewer-body">\n                        <pre class="code-viewer-code line-numbers" id="code-viewer-code">\n                            <code class="language-python" id="code-viewer-code-content"></code>\n                        </pre>\n                    </div>\n                    <div class="code-viewer-navigation">\n                        <div class="nav-group">\n                            <button class="code-nav-button" id="code-nav-parent" disabled>\n                                ⬆️ Parent\n                            </button>\n                            <button class="code-nav-button" id="code-nav-prev" disabled>\n                                ⬅️ Previous\n                            </button>\n                            <button class="code-nav-button" id="code-nav-next" disabled>\n                                ➡️ Next\n                            </button>\n                        </div>\n                        <div class="nav-info">\n                            <span id="code-nav-position">-- / --</span>\n                        </div>\n                        <div class="nav-actions">\n                            <button class="code-nav-button" id="code-copy">\n                                📋 Copy\n                            </button>\n                            <button class="code-nav-button" id="code-open-file">\n                                📂 Open File\n                            </button>\n                        </div>\n                    </div>\n                </div>\n            </div>\n        '),this.modal=document.getElementById("code-viewer-modal")}setupEventHandlers(){document.getElementById("code-viewer-close").addEventListener("click",()=>{this.hide()}),this.modal.addEventListener("click",e=>{e.target===this.modal&&this.hide()}),document.addEventListener("keydown",e=>{"Escape"===e.key&&this.modal.classList.contains("show")&&this.hide()}),document.getElementById("code-nav-parent").addEventListener("click",()=>{this.navigateToParent()}),document.getElementById("code-nav-prev").addEventListener("click",()=>{this.navigateToPrevious()}),document.getElementById("code-nav-next").addEventListener("click",()=>{this.navigateToNext()}),document.getElementById("code-copy").addEventListener("click",()=>{this.copyCode()}),document.getElementById("code-open-file").addEventListener("click",()=>{this.openInEditor()})}subscribeToEvents(){window.socket&&(this.socket=window.socket,this.socket.on("code:content:response",e=>{this.handleCodeContent(e)}))}show(e){this.initialized||this.initialize(),this.currentNode=e,this.modal.classList.add("show"),this.updateHeader(e),this.loadCode(e),this.updateNavigation(e)}hide(){this.modal.classList.remove("show"),this.currentNode=null}updateHeader(e){document.getElementById("code-viewer-title").textContent=`${e.name} (${e.path||"Unknown"})`,document.getElementById("code-viewer-type").textContent=`Type: ${e.type}`,document.getElementById("code-viewer-lines").textContent=`Lines: ${e.lines||"--"}`,document.getElementById("code-viewer-complexity").textContent=`Complexity: ${e.complexity||"--"}`}loadCode(e){const t=document.getElementById("code-viewer-code-content"),n=`${e.path}:${e.line}`;this.codeCache.has(n)?this.displayCode(this.codeCache.get(n)):(t.textContent="Loading code...",this.socket?this.socket.emit("code:content:request",{path:e.path,line:e.line,type:e.type,name:e.name}):this.displayMockCode(e))}handleCodeContent(e){if(!e.success)return void this.displayError(e.error||"Failed to load code");const t=`${e.path}:${e.line}`;this.codeCache.set(t,e.content),this.displayCode(e.content)}displayCode(e){const t=document.getElementById("code-viewer-code-content"),n=document.getElementById("code-viewer-code");t.textContent=e;const i=this.detectLanguage(this.currentNode.path);t.className=`language-${i}`,window.Prism&&(Prism.highlightElement(t),Prism.plugins&&Prism.plugins.lineNumbers&&Prism.plugins.lineNumbers.resize(n))}displayMockCode(e){let t="";switch(e.type){case"class":t=`class ${e.name}:\n    """\n    ${e.docstring||"A sample class implementation."}\n    """\n    \n    def __init__(self):\n        """Initialize the ${e.name} class."""\n        self._data = {}\n        self._initialized = False\n    \n    def process(self, input_data):\n        """Process the input data."""\n        if not self._initialized:\n            self._initialize()\n        return self._transform(input_data)\n    \n    def _initialize(self):\n        """Initialize internal state."""\n        self._initialized = True\n    \n    def _transform(self, data):\n        """Transform the data."""\n        return data`;break;case"function":t=`def ${e.name}(${e.params?e.params.join(", "):""}):\n    """\n    ${e.docstring||"A sample function implementation."}\n    \n    Args:\n        ${e.params?e.params.map(e=>`${e}: Description of ${e}`).join("\n        "):"None"}\n    \n    Returns:\n        ${e.returns||"None"}: Return value description\n    """\n    # Implementation here\n    result = None\n    \n    # Process logic\n    for item in range(10):\n        result = process_item(item)\n    \n    return result`;break;case"method":t=`    def ${e.name}(self${e.params?", "+e.params.join(", "):""}):\n        """\n        ${e.docstring||"A sample method implementation."}\n        """\n        # Method implementation\n        self._validate()\n        result = self._process()\n        return result`;break;default:t=`# ${e.name}\n# Type: ${e.type}\n# Path: ${e.path||"Unknown"}\n# Line: ${e.line||"Unknown"}\n\n# Code content would appear here\n# This is a placeholder for demonstration purposes`}this.displayCode(t)}displayError(e){const t=document.getElementById("code-viewer-code-content");t.textContent=`# Error loading code\n# ${e}`,t.className="language-python"}detectLanguage(e){if(!e)return"python";return{py:"python",js:"javascript",ts:"typescript",jsx:"jsx",tsx:"tsx",css:"css",html:"html",json:"json",yaml:"yaml",yml:"yaml",md:"markdown",sh:"bash",bash:"bash",sql:"sql",go:"go",rs:"rust",cpp:"cpp",c:"c",h:"c",hpp:"cpp",java:"java",rb:"ruby",php:"php"}[e.split(".").pop().toLowerCase()]||"plaintext"}updateNavigation(e){document.getElementById("code-nav-parent").disabled=!0,document.getElementById("code-nav-prev").disabled=!0,document.getElementById("code-nav-next").disabled=!0,document.getElementById("code-nav-position").textContent="1 / 1"}navigateToParent(){console.log("Navigate to parent node")}navigateToPrevious(){console.log("Navigate to previous sibling")}navigateToNext(){console.log("Navigate to next sibling")}async copyCode(){const e=document.getElementById("code-viewer-code-content").textContent;try{await navigator.clipboard.writeText(e);const t=document.getElementById("code-copy"),n=t.textContent;t.textContent="✅ Copied!",setTimeout(()=>{t.textContent=n},2e3)}catch(t){console.error("Failed to copy code:",t),alert("Failed to copy code to clipboard")}}openInEditor(){this.currentNode&&this.currentNode.path?(this.socket&&this.socket.emit("file:open",{path:this.currentNode.path,line:this.currentNode.line}),console.log("Opening file in editor:",this.currentNode.path)):alert("File path not available")}};"undefined"!=typeof window&&(window.CodeViewer=e,document.addEventListener("DOMContentLoaded",()=>{e.initialize()}));
-//# sourceMappingURL=code-viewer.js.map